核心用法
Readwise CLI 是 Readwise 官方提供的命令行工具，打通 Readwise 高亮系统与 Reader 稍后读服务。核心工作流围绕四个维度展开：
检索：通过 reader-search-documents 和 readwise-search-highlights 支持语义向量搜索，可基于概念关联而非关键词匹配定位内容。Reader 侧支持按位置筛选（new/later/shortlist/archive/feed）。
阅读与导出：列出文档详情、获取高亮批注、提取全文，支持 --json 输出以便与其他工具链整合。
捕获与标注：可将任意 URL 保存至 Reader 收件箱，或对现有文档追加高亮批注，实现命令行端的快速输入。
组织管理：批量移动文档位置（单次上限 50 条）、添加标签、归档整理，配合脚本可实现自动化工作流。
每日复习：调用 readwise-get-daily-review 获取当日复习卡片，支持本地化 spaced repetition 场景。
显著优点
- 官方原生：Readwise 团队直接维护，API 兼容性与功能更新有保障
- 语义搜索：向量检索能力超越传统关键词匹配，适合模糊查询
- 双系统整合：同时覆盖 Readwise（高亮复习）与 Reader（稍后读）两大产品
- JSON 管道：所有命令支持结构化输出，易于与 Obsidian、Notion 等工具联动
- 批量操作：50 条/次的批量处理能力，适合大规模归档与标签管理
局限与风险
- Token 依赖：需用户自行获取 access token，存在泄露后数据被拉取的风险
- 无离线能力：完全依赖 Readwise 云服务，网络中断即不可用
- 频率限制：未明确标注 API 限流策略，高频脚本可能触发限制
- 功能边界：不支持直接修改高亮内容，仅可追加新批注
- NPM 生态：依赖 Node.js 环境，相比原生二进制存在供应链攻击面
适合人群
- 使用 Readwise/Reader 作为核心知识库的重度阅读者
- 需要将阅读数据与本地笔记系统（Obsidian、Logseq）自动同步的自动化爱好者
- 偏好命令行效率、追求批量操作与脚本化工作流的开发者与研究员
常规风险提示
- 妥善保管 access token，避免写入公共仓库或日志明文
- 建议通过环境变量注入 token，而非命令行参数传递
- 定期检查已授权应用列表，及时回收不再使用的 token
- 批量操作具备破坏性（如归档），建议先小范围验证