ima-knowledge-base

1# IMA Knowledge Base
2 
3入口：
4 
5```bash
6python skills/ima-knowledge-base/scripts/ima_kb_tool.py <command> ...
7```
8 
9## 执行规则
10 
11- 用户说“搜、查、找、看看有没有”时，先 `search-kb`
12- 默认直接返回命中片段，不堆字段
13- `search-kb` 搜的是内容，不是知识库列表
14- 用户给了 `kb-id` 或 `kb-name` 时，加定向参数
15- 默认优先 `--keyword`，只有明确要把多个词合成一次搜索串时才用 `--query`
16- 宽搜建议加 `--show 5 --limit 10`；知识库很大再加 `--search-pages 2` 或更高
17 
18## 查看单条结果
19 
20- 默认先 `show-kb-hit`
21- 只有命中像图片、截图、OCR 文档、菜单图，或 `show-kb-hit` 太短时，才用 `inspect-kb-hit`
22- 一条 `--keyword "推荐 菜单 餐厅 美食"` 会拆成多次搜索，同一标题可能重复出现
23- 宽搜后稳定定位优先级：更窄关键词 > `--title` > `--media-id` > `--pick`
24 
25## 常用命令
26 
27```bash
28python skills/ima-knowledge-base/scripts/ima_kb_tool.py search-kb --keyword "orslow"
29python skills/ima-knowledge-base/scripts/ima_kb_tool.py search-kb --keyword "推荐 菜单 餐厅 美食" --show 5 --limit 10
30python skills/ima-knowledge-base/scripts/ima_kb_tool.py search-kb --kb-name "个人知识库" --keyword "菜单"
31python skills/ima-knowledge-base/scripts/ima_kb_tool.py show-kb-hit --keyword "orslow" --pick 1
32python skills/ima-knowledge-base/scripts/ima_kb_tool.py inspect-kb-hit --keyword "orslow" --pick 1
33python skills/ima-knowledge-base/scripts/ima_kb_tool.py list-kb
34python skills/ima-knowledge-base/scripts/ima_kb_tool.py list-kb-items --kb-name "个人知识库" --limit 20
35python skills/ima-knowledge-base/scripts/ima_kb_tool.py upload-file --kb-name "个人知识库" --file "/path/to/report.pdf"
36python skills/ima-knowledge-base/scripts/ima_kb_tool.py import-url --kb-name "个人知识库" --url "https://example.com"
37```
38 
39## 推荐类问题
40 
41用户问“知识库里有什么推荐”时：
42…