reMarkable云同步

技能简介

该技能通过 reMarkable Cloud API 将本地文件或网络文章推送到 reMarkable 电子墨水平板，支持 PDF、EPUB 格式上传，以及网页文章的自动抓取与格式转换。

能做什么

• 将网页文章转换为 EPUB 或 PDF 并推送至设备
• 上传本地 PDF、EPUB 文件到云端指定目录
• 浏览、搜索设备上的文件与文件夹
• 创建新的文件夹结构

使用说明

1. 安装依赖

需先安装 rmapi（Go 环境必需）：

cd /tmp && git clone --depth 1 https://github.com/ddvk/rmapi.git
cd rmapi && go build -o /usr/local/bin/rmapi .

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

2. 首次认证

运行任意命令后，按提示访问 https://my.remarkable.com/device/browser?showOtp=true 获取一次性验证码完成授权。令牌缓存在 ~/.rmapi。

3. 常用操作

发送网页文章（默认 EPUB）：

{baseDir}/scripts/remarkable.sh send-article --url "https://example.com/article" --dir /Articles

指定 PDF 格式或自定义标题：

{baseDir}/scripts/remarkable.sh send-article --url "..." --format pdf --title "标题" --dir /

上传本地文件：

{baseDir}/scripts/remarkable.sh upload --file /path/to/doc.pdf --dir /Books

列出文件：[f] 表示文件，[d] 表示目录：

{baseDir}/scripts/remarkable.sh ls /Articles

创建文件夹：

{baseDir}/scripts/remarkable.sh mkdir --path /NewFolder

搜索文件：

{baseDir}/scripts/remarkable.sh find --name "关键词"

输入与输出

见下方输入与输出表格。

项目	内容
输入	本地文件路径（PDF/EPUB）、网页 URL、目标目录路径、可选自定义标题、可选输出格式（epub/pdf）
输出	云端文件列表、上传确认状态、转换后的电子书文件
适用人群	reMarkable 平板用户、需要离线阅读网页内容的用户、电子墨水设备文档管理者
不包含	USB 直连传输、手写笔记编辑、DRM 文件处理、实时协作

 

风险提示

• 部分网站禁止爬虫抓取，文章获取可能失败
• 设备需连接 WiFi 才能自动同步云端内容
• 认证令牌存储在本地，注意文件权限安全
• Go 编译环境为必需前置条件

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/nickian/remarkable/SKILL.md
来源类型：GitHub 开源仓库