用途:当用户想从自己的 Readwise 阅读库中取回内容时使用,例如“我关于 X 划了哪些高亮”“搜索我的高亮”“在 Readwise 里找”。
主要能力与用法:
- 高亮语义搜索(官方 CLI):readwise readwise-search-highlights --vector-search-term "查询词"。可叠加全文过滤:--full-text-queries '[{"field_name": "document_author", "search_term": "Jackson"}]',支持字段 document_author、document_title、highlight_note、highlight_plaintext、highlight_tags。加 --json 输出结构化结果。
- 文档混合搜索(官方 CLI):readwise reader-search-documents --query "词",可加 --author-search、--category-in、--tags-in、--location-in 等过滤。
- 按标签或分类列出文档:readwise reader-list-documents --tag "X"、--category article --location archive、--updated-after 2026-01-01T00:00:00Z --limit 20。
- 关键词精确匹配高亮(自定义 CLI,v2 API):readwise-custom highlights --search "词" --limit 20 --json。
- 查看单篇文档:readwise reader-get-document-details --document-id <id>。
选择逻辑:已知确切文档或作者时用全文过滤,否则用向量语义搜索;需要文档级结果用 reader-search-documents 或 reader-list-documents,需要高亮级结果用 readwise-search-highlights;需要关键词精确匹配用 readwise-custom highlights。
输出:加 --json 获得结构化结果,搜索结果含 score 字段,数值越高越相关,通常大于 0.01 才有意义。
限制:依赖 Readwise 账号与相应 CLI 工具;技能目录中的 references 与 scripts 需通过 skill-toc 列出,若不可用则需安装 plugin-utils 插件或重开会话。其余细节暂未提供。