reMarkable 平板集成（rmapi）

通过 Cloud API 与 reMarkable 平板实现双向同步。拉取手绘草图与笔记，进行处理（AI 增强、文本提取），再将内容推送回平板。

典型使用场景

1. 草图 → AI → 平板闭环 — 拉取原始草图 → 使用 AI 增强 → 将优化后的版本推回平板
2. 日记记录 — 拉取手写思考内容 → 解析理解 → 追加至记忆库/日记
3. 头脑风暴 — 拉取图表/列表 → 提取结构信息 → 补充至项目文档
4. 推送阅读材料 — 将 PDF/文档推送到平板，供离线阅读
5. AI 绘图推送至平板 — 生成图像 → 转换为 PDF → 推送至电子墨水屏查看

双向数据流

┌─────────────────────────────────────────────────────────────────┐
│                        拉取（平板 → agent）                       │
├─────────────────────────────────────────────────────────────────┤
│  reMarkable → 云同步 → rmapi get → .rmdoc                       │
│                                           ↓                      │
│                              解压 → .rm 文件 → rmc → SVG         │
│                                                      ↓           │
│                                          cairosvg → PNG          │
│                                                      ↓           │
│                               ┌──────────┴──────────┐            │
│                          是否含文本内容？       是否为视觉/草图？   │
│                               ↓                      ↓           │
│                        OCR/语义解析           AI 图像编辑          │
│                               ↓                      ↓           │
│                        写入记忆库           增强后的图像            │
└─────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────┐
│                        推送（agent → 平板）                       │
├─────────────────────────────────────────────────────────────────┤
│  图像/文档 → （如需）转为 PDF → rmapi put                       │
│                                                      ↓           │
│                                           云同步 → 平板           │
└─────────────────────────────────────────────────────────────────┘

前提条件

1. 安装 rmapi

从 juruen/rmapi 下载最新发布版（推荐使用 ddvk 的 fork 版本）：

# Linux amd64 示例
curl -L https://github.com/ddvk/rmapi/releases/latest/download/rmapi-linux-amd64 -o ~/bin/rmapi
chmod +x ~/bin/rmapi

2. 安装转换工具

pip install --user rmc cairosvg pillow

• rmc — 将 .rm 笔迹文件转换为 SVG
• cairosvg — 将 SVG 转换为 PNG
• pillow — 将 PNG 转换为 PDF，用于推送回平板

3. 认证（仅需一次）

1. 访问 https://my.remarkable.com/connect/desktop
2. 登录后复制 8 位验证码
3. 运行 rmapi，并在提示时粘贴该验证码
4. 令牌将保存至 ~/.rmapi — 后续运行自动完成认证

命令

拉取（从平板下载）

# 列出文件/文件夹
rmapi ls
rmapi ls -l -t              # 长格式，按时间排序

# 从云端刷新元数据
rmapi refresh

# 切换目录
rmapi cd "文件夹名称"

# 查找文件
rmapi find --starred /              # 星标项
rmapi find --tag="my-tag" /         # 按标签查找
rmapi find / ".*sketch.*"           # 正则匹配

# 下载单个文件
rmapi get "文件名"
rmapi get "文件夹/笔记本"

# 下载带标注的文件（最适合手写内容）
rmapi geta "文件名"

# 批量下载整个文件夹
rmapi mget -o ./sync-folder/ "/我的文件夹"

推送（上传至平板）

# 上传单个文件（仅支持 PDF 或 EPUB）
rmapi put document.pdf
rmapi put document.pdf "目标文件夹/"

# 批量上传
rmapi mput ./本地文件夹/ "远程文件夹/"

# 在平板上创建文件夹
rmapi mkdir "新文件夹"

支持的格式：PDF、EPUB

转换工作流

拉取：.rmdoc → PNG

reMarkable 笔记本以 .rmdoc 格式下载（本质是包含笔迹数据的 ZIP 归档）：

# 1. 下载笔记本
rmapi get "文件夹/我的笔记本"

# 2. 解压（它是一个 ZIP 包）
unzip "我的笔记本.rmdoc" -d extracted/

# 3. 查找 .rm 笔迹文件
# 目录结构示例：extracted//.rm
find extracted -name "*.rm"

# 4. 将 .rm 转换为 SVG
rmc -t svg -o page.svg "extracted//.rm"

# 5. 将 SVG 转换为 PNG（reMarkable 屏幕尺寸：1404×1872）
python3 -c "
import cairosvg
cairosvg.svg2png(url='page.svg', write_to='page.png', output_width=1404, output_height=1872)
"

推送：图像 → PDF

reMarkable 仅接受 PDF/EPUB，因此需先将图像转换：

from PIL import Image

img = Image.open('image.png')
rgb = img.convert('RGB')
rgb.save('image.pdf', 'PDF', resolution=150)

然后推送：

rmapi put image.pdf "我的文件夹/"

完整工作流示例

草图增强闭环：

# 1. 从平板拉取草图
rmapi get "草图/我的绘图"

# 2. 解压并转换为 PNG
unzip 我的绘图.rmdoc -d 我的绘图_extracted/
RM_FILE=$(find 我的绘图_extracted -name "*.rm" | head -1)
rmc -t svg -o 草图.svg "$RM_FILE"
python3 -c "import cairosvg; cairosvg.svg2png(url='草图.svg', write_to='草图.png', output_width=1404, output_height=1872)"

# 3. 【此处插入你的 AI 增强步骤】
# 示例：使用任意图像到图像 AI 工具处理 sketch.png → enhanced.png

# 4. 转换为 PDF 并推回平板
python3 -c "from PIL import Image; Image.open('enhanced.png').convert('RGB').save('enhanced.pdf', 'PDF', resolution=150)"
rmapi put enhanced.pdf "草图/"

共享策略

可在平板上创建专用同步文件夹，或采用以下方式：

• 标签（Tags） — 使用 rmapi find --tag 标记内容便于检索
• 星标（Stars） — 使用 rmapi find --starred 标记高频访问项

注意事项

• 依赖云同步 — 平板必须完成云同步，文件才可在 rmapi 中获取（在平板上下拉刷新）
• 格式说明 — .rmdoc 是一个 ZIP 包，内含 JSON 元数据和 .rm 二进制笔迹文件
• 警告提示 — rmc 可能对新版格式发出警告，但通常仍可正常工作
• 屏幕尺寸 — reMarkable 屏幕分辨率为 1404×1872 像素（竖屏）
• 文本提取 — 对于手写文本，请使用视觉大模型进行图像级语义理解，而非传统 OCR

故障排查