用途:针对用户个人 Readwise 阅读库的查询与操作,例如搜索高亮、查找某主题的划线、获取引文、按标签列出文档等。
主要能力:官方 CLI(readwise)支持高亮语义搜索、文档混合搜索、按标签列文档、获取文档全文(markdown)、列出标签、保存 URL、移动文档、批量编辑元数据、导出库、每日回顾;自定义 CLI(readwise-custom)支持基于高亮的 RAG 对话、关键词高亮搜索、清理陈旧文档、上传 PDF/EPUB、Ghostreader 摘要、获取文档 HTML。多数命令加 --json 可得机器可读输出。
使用方式:所有 Readwise 操作必须经由 librarian 子代理,主对话禁止直接运行 readwise 或 readwise-custom 命令,也不得“顺手查一下”高亮。正确做法是派发 librarian 子代理并同步等待结果。涉及标签或 NLM 内容时,先检查 NLM(nlm list、nlm chat),不在 NLM 再用 readwise reader-list-documents --tag "X" 按标签查询,而非搜索。批量加入 NLM 可用脚本 readwise_to_nlm.py,支持 --tag、--notebook、--dry-run、--verbose。
限制:文档全文应直接从 Readwise 获取(reader-get-document-details --document-id <id>),不要回源 URL 抓取,付费墙内容会失败。子技能包括 readwise-search、readwise-docs、readwise-chat、readwise-prune。具体安装与配置步骤资料未提供。