名称： supernote
描述： 通过自托管的 Supernote 私有云实例浏览文件和文件夹、上传文档（PDF、EPUB）和笔记、将网页文章转换为 EPUB/PDF 并发送到设备、检查存储容量以及导航目录树。当用户提到 Supernote、电子墨水设备文件、想要在 Supernote 云上上传/浏览文档，或想要将文章/URL 发送到其电子阅读器时使用。

Supernote 私有云

通过逆向工程的 REST API，在自托管的 Supernote 私有云上浏览、上传和管理文件。包含文章转电子书功能，可将网页内容发送到设备。

设置

export SUPERNOTE_URL="http://192.168.50.168:8080"
export SUPERNOTE_USER="your@email.com"
export SUPERNOTE_PASSWORD="your_password"

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

命令

将网页文章发送到设备

{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 "Custom Title" --dir-path Document

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

列出目录内容

{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

目录树

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

通过路径查找目录 ID

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

上传文件

{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 "Renamed.pdf"

检查存储容量

{baseDir}/scripts/supernote.sh capacity

手动登录

{baseDir}/scripts/supernote.sh login

默认文件夹

注意事项

• 对于文章，推荐使用 EPUB 格式——在电子墨水设备上渲染清晰，文本可重排。
• 此 API 为逆向工程实现，非官方版本——固件更新可能导致接口变更。
• 目录参数接受路径（例如 "Document/Books"）或数字 ID。
• 部分网站可能阻止抓取——如果获取失败，请尝试其他 URL 或使用缓存/保存的页面。