reMarkable 平板集成（rmapi）

通过 Cloud API 从 reMarkable 平板获取手写笔记、草图与绘图。后续可对其进行处理——例如利用 AI 图像生成技术优化画作、提取文字并存入 memory/日记文件，或作为其他工作流的输入源。

典型使用场景

1. 日记条目 — 用户在 reMarkable 上书写思考内容 → 获取 → OCR/语义解析 → 追加至 memory/YYYY-MM-DD.md 或专用日记文件
2. 草图优化 — 用户绘制粗略图形 → 获取 → 使用 nano-banana-pro（AI 图像编辑）增强 → 返回精修后的版本
3. 头脑风暴 / 笔记整理 — 用户快速记录想法、列表、图表等 → 获取 → 提取结构化信息 → 补充至项目文档或 memory
4. 插图创作 — 用户手绘艺术作品 → 获取 → 可选进行风格化处理 → 用于博客文章、社交媒体等内容发布

处理流程

reMarkable 平板 → 云端同步 → rmapi 获取 → PDF/PNG
                                                  ↓
                                    ┌─────────────┴─────────────┐
                                    │                           │
                              是否为文本内容？           是否为视觉/草图内容？
                                    │                           │
                              OCR / 语义解析             nano-banana-pro
                                    │                     （AI 增强）
                                    │                           │
                              写入 memory/日记/项目文档     向用户返回优化后的图像

配置说明

• 工具：rmapi（ddvk 分支）v0.0.32
• 可执行文件路径：~/bin/rmapi
• 配置文件：~/.rmapi（认证后保存设备 token）
• 同步目录：~/clawd/remarkable-sync/

认证流程（仅需一次）

1. 用户访问 https://my.remarkable.com/connect/desktop
2. 登录账户，获取 8 位字符验证码
3. 运行 rmapi 并输入该验证码
4. token 将被保存至 ~/.rmapi，后续调用自动完成认证

常用命令

# 列出文件/文件夹
rmapi ls
rmapi ls --json

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

# 按标签 / 星标 / 正则表达式查找
rmapi find --tag="share-with-gandalf" /
rmapi find --starred /
rmapi find / ".*sketch.*"

# 下载（PDF 格式）
rmapi get "文件名"

# 下载并渲染批注（手写内容推荐使用）
rmapi geta "文件名"

# 批量下载整个文件夹
rmapi mget -o ~/clawd/remarkable-sync/ "/Shared with Gandalf"

共享工作流方案

方案 A：专用文件夹

用户在 reMarkable 上创建名为 "Shared with Gandalf" 的文件夹 → 将待处理内容移入其中 → Agent 调用 rmapi mget 获取

方案 B：基于标签

用户为文档打上 share-with-gandalf 标签 → Agent 使用 rmapi find --tag 发现并获取

方案 C：星标项

用户对目标内容添加星标 → Agent 使用 rmapi find --starred 获取

获取脚本

# 从共享文件夹获取
~/clawd/scripts/remarkable-fetch.sh

# 获取星标项
~/clawd/scripts/remarkable-fetch.sh --starred

# 按标签获取
~/clawd/scripts/remarkable-fetch.sh --tag="share-with-gandalf"

注意事项

• 平板需先完成云端同步，文件才可在 API 中访问
• geta 命令会将批注渲染进 PDF（手写内容首选）
• 如需图像处理，可使用 convert（ImageMagick）将 PDF 转为 PNG
• 文字提取建议采用视觉模型（vision model）对手写内容进行语义理解，而非传统 OCR