SuperAPI AI 工具集

readwise-search

通用与其它

查看项目

更新于 10-15 21:37

技能介绍

用途:当用户想从自己的 Readwise 阅读库中取回内容时使用,例如“我关于 X 划了哪些高亮”“搜索我的高亮”“在 Readwise 里找”。

主要能力与用法:

  1. 高亮语义搜索(官方 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 输出结构化结果。
  2. 文档混合搜索(官方 CLI):readwise reader-search-documents --query "词",可加 --author-search、--category-in、--tags-in、--location-in 等过滤。
  3. 按标签或分类列出文档:readwise reader-list-documents --tag "X"、--category article --location archive、--updated-after 2026-01-01T00:00:00Z --limit 20。
  4. 关键词精确匹配高亮(自定义 CLI,v2 API):readwise-custom highlights --search "词" --limit 20 --json。
  5. 查看单篇文档: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 插件或重开会话。其余细节暂未提供。