核心功能
Readwise CLI 是 Readwise 官方提供的命令行工具，用于访问用户的 Readwise 高亮笔记和 Reader 稍后读文档。支持两大产品线：
- Readwise：书籍、文章、播客等的高亮聚合，含每日回顾与间隔重复功能
- Reader：稍后读应用，支持文章、PDF、EPUB、RSS、邮件、推文、视频等格式
显著优点
1. 语义搜索能力：支持向量语义搜索高亮和文档，超越关键词匹配的精准度
2. 完整的阅读工作流：从保存、阅读、标注、分类到归档的全链路支持
3. 高效的批量操作：支持文档批量移动、标签管理、元数据编辑
4. 灵活的导出机制：支持全量或增量导出为 Markdown ZIP 格式
5. spaced repetition 集成：每日回顾功能直接对接 Readwise 的记忆强化系统
6. 机器可读输出：所有命令支持 --json 输出，便于自动化脚本集成
潜在局限
- API 依赖性强：功能完全依赖 Readwise 云服务，离线场景受限
- 认证门槛：需要用户主动获取 access token，对非技术用户不够友好
- 缓存策略：数据缓存可能导致信息延迟，需手动
--refresh强制同步 - 标注精确性限制：创建高亮时要求 HTML 内容与原文完全匹配，操作门槛较高
- 批量操作限制：单次最多处理 50 个文档，大规模管理需分批执行
适合人群
- 重度 Readwise/Reader 用户，追求命令行效率
- 知识管理爱好者，需要自动化阅读工作流
- 研究人员和写作者，需要跨文档检索和引用管理
- 开发者，希望将阅读数据集成到个人知识库系统
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据隐私 | 需提交个人 access token，存在令牌泄露风险 |
| 服务可用性 | 依赖 Readwise 云服务，API 变更可能影响功能 |
| 误操作风险 | 批量删除、移动操作不可逆，需谨慎确认 |
| 同步延迟 | 缓存机制可能导致多端数据不一致 |
使用建议
建议将 access token 存储在环境变量或密钥管理工具中，避免硬编码；定期导出数据备份；关键操作前先使用 --json 预览结果。