SuperAPI AI 工具集

getnote-search

办公与效率

查看项目

更新于 10-15 22:38

技能介绍

用途:通过官方 getnote CLI 在得到大脑中查找真实笔记,支持按书名、课程名、文稿标题、作者、评论或模糊记忆定位来源,并返回真实笔记与链接。不要自行拼 OpenAPI 请求、笔记 ID 或访问链接;机器调用统一使用 -o json,只有退出码为 0 且 JSON 的 success=true 才算业务成功。

主要能力与用法:只有主题或模糊记忆时用语义搜索:getnote search <query> --limit <1-10> -o json,默认上限 10,不能自行放大。指定知识库时先执行 getnote kbs --scope <scope> -o json(DEFAULT、BOOKSPACE、CUSTOMER、TEAMSPACE),再用真实 topic_id 执行 getnote search <query> --kb <topic_id> --limit <1-10> -o json。明确书籍时用 kbs --scope BOOKSPACE --query 定位;已知作者可用 --author;已知课程文稿可列出来源:getnote notes --source dedao --note-type ref --reference-type course_article --page-size 20 -o json,必要时用返回的 pagination.next_cursor 继续。搜索结果是 Top-K 召回,不是完整清单,零命中不代表全库没有。结果需按字符串 note_id 去重;只有非空 note_url 才提供“打开笔记”,缺失笔记 ID 的非笔记结果不得伪造链接。成功时按相关性列编号、标题、简短片段和真实链接;命中摘要不能冒充全文。

限制:search 没有时间或来源筛选参数,时间条件需另行核对;同名课程或文稿无法区分时应列候选让用户选择。检索可能含私密正文,共享会话默认只展示标题、必要摘要和真实链接。success=false 或退出码非 0 时说明失败步骤、错误信息、是否可重试;提示搜索服务响应超时属于检索未完成,不等于没有结果。用户选中后再用字符串 note_id 读取 getnote note <note_id> -o json,不要从 URL 截取或转换。