Supernote 私有云

通过逆向工程实现的 REST API，浏览、上传和管理自托管的 Supernote 私有云中的文件。支持将网页文章转换为电子书格式并发送至设备。

设置

bash
export SUPERNOTE_URL=http://192.168.50.168:8080
export SUPERNOTE_USER=your@email.com
export SUPERNOTEPASSWORD=yourpassword

Python 依赖（用于文章转换）：readability-lxml、ebooklib、requests、beautifulsoup4、lxml。

命令

发送网页文章至设备

bash
{baseDir}/scripts/supernote.sh send-article --url https://example.com/article --format epub --dir-path Document
{baseDir}/scripts/supernote.sh send-article --url https://example.com/article --format pdf --dir-path Document/Articles
{baseDir}/scripts/supernote.sh send-article --url https://example.com/article --title 自定义标题 --dir-path Document

获取文章内容，提取包含图片的可读文本，转换为干净的 EPUB 或 PDF 格式，然后上传至指定文件夹。默认格式：epub。默认文件夹：Document。

列出目录内容

bash
{baseDir}/scripts/supernote.sh ls
{baseDir}/scripts/supernote.sh ls --path Document
{baseDir}/scripts/supernote.sh ls --path Note/Journal
{baseDir}/scripts/supernote.sh ls --dir 778507258886619136

目录树

bash
{baseDir}/scripts/supernote.sh tree --depth 2

通过路径查找目录 ID

bash
{baseDir}/scripts/supernote.sh find-dir --path Document/Books

上传文件

bash
{baseDir}/scripts/supernote.sh upload --file /path/to/file.pdf --dir-path Document
{baseDir}/scripts/supernote.sh upload --file /path/to/book.epub --dir-path Document/Books
{baseDir}/scripts/supernote.sh upload --file /path/to/file.pdf --dir 778507258773372928 --name 重命名.pdf

查看存储容量

bash
{baseDir}/scripts/supernote.sh capacity

登录（手动）

bash
{baseDir}/scripts/supernote.sh login

默认文件夹

说明

• - 建议文章使用 EPUB 格式——在电子墨水屏上渲染清晰，支持文字重排
• 该 API 为逆向工程所得，非官方接口——固件更新后端点可能发生变化
• 目录参数支持路径（如 Document/Books）或数字 ID
• 部分网站会阻止抓取——若获取失败，请尝试其他 URL 或使用缓存/已保存页面