核心功能
Supernote技能是一款面向自托管用户的电纸书文件管理工具，通过反编译Supernote官方私有云API实现。核心能力包括：文件目录浏览（ls、tree）、指定路径上传PDF/EPUB文档、查询存储容量，以及独特的网页文章转换功能——可将任意URL抓取并提取正文内容，自动转换为适合电子墨水屏阅读的EPUB或PDF格式推送到设备。
显著优点
1. 闭环阅读体验：打破电纸书内容孤岛，一键将网络长文转换为优化排版的电子书，EPUB格式支持重排文字以适应不同屏幕尺寸
2. 自托管隐私性：完全私有部署，用户数据不经过第三方云服务
3. 自动化工作流：支持命令行批量操作，便于整合到个人自动化流程（如配合RSS阅读器）
潜在局限与风险
| 风险类型 | 具体说明 |
|---------|---------|
| API稳定性 | 基于反编译的非官方API，固件更新可能导致接口失效 |
| 网络抓取限制 | 部分网站设有反爬虫机制，可能导致文章获取失败 |
| 安全认证薄弱 | 采用明文HTTP传输（示例配置）及基础邮箱密码认证，建议部署于可信内网 |
| 依赖维护成本 | 文章转换依赖`readability-lxml`等Python库，需持续跟踪上游更新 |
适合人群
- 已购买Supernote电纸书且启用私有云功能的用户
- 偏好命令行工作流的技术爱好者
- 需要将网络阅读材料同步至护眼设备的重度阅读者
使用建议
建议在内网环境部署并通过HTTPS反代增强传输安全；重要文档建议本地备份；网页转换功能遇到失败时可尝试手动保存HTML后离线转换。