getnote-search 技能
跨全部笔记或指定知识库进行语义搜索。
使用前先读 ../getnote-shared/SKILL.md(认证、字段语义)。
命令
搜索笔记
getnote search <query> [--kb <topic_id>] [--limit <n>]
| 参数 | 默认 | 说明 |
|---|---|---|
--kb |
— | 限定在指定知识库(topic_id)内搜索 |
--limit |
10 | 最大结果数(上限 10) |
结果按语义相关度从高到低排序。每条结果含:note_id、title、content(摘要)、score、created_at、note_type。
注意:仅
NOTE类型结果填充note_id。其他类型(FILE、BLOGGER、LIVE等)的note_id为空。
# 全局搜索
getnote search "大模型 API"
# 限定知识库搜索
getnote search "RAG" --kb qnNX75j0
# 限制结果数 + JSON 输出
getnote search "机器学习" --limit 5 -o json
Agent 使用注意事项
- 优先用
-o json解析结果 - JSON 响应:
{"success":true,"results":[{"note_id":"...","title":"...","content":"...","score":0.95,"created_at":"...","note_type":"..."}]} - 注意:
results在顶层,不在data下 --kb的topic_id从 ../getnote-kb/SKILL.md (getnote kbs -o json→data.topics[].topic_id) 获取NOTE类型结果用getnote note <note_id>获取完整内容(见 ../getnote-note/SKILL.md)- 最大
--limit为 10;无关键词浏览用getnote notes - 退出码
0= 成功,非零 = 错误,stderr 输出错误详情