| name | ima-knowledge-collab |
| description | IMA 与本地知识库协作方案 — IMA copilot 预整理知识为笔记，Hermes 对接笔记做深度检索。
当用户提到 IMA 知识库、IMA 笔记、从 IMA 搜索、IMA 同步、知识库协作时触发此 skill。
|
| trigger | IMA知识库 / IMA笔记 / 知识库协作 / 从IMA搜索 |
IMA 与本地知识库协作方案
核心架构：三层分工
IMA copilot（预处理器） → IMA 笔记（结构化知识） → Hermes（检索+应用） → 本地知识库（深度引擎）
一句话：IMA copilot 管"整理"，IMA 笔记管"存"，Hermes 管"用"，本地知识库管"沉淀"。
第一层：IMA copilot 预整理知识库
IMA 内置智能助手 copilot 负责将知识库内容整理为结构化笔记：
- 浏览所有知识库，把知识完整沉淀为笔记（是完整知识，不是摘要）
- 同话题合并：相同或类似话题的笔记合并为一条，不建立多条重复笔记
- 清理标记：不需要的笔记名称前加"删除"前缀，由用户手动筛选删除
- copilot 有固化为 skill 的工作流，用户通知他时手动执行（不支持定时任务）
Hermes 不直接爬 IMA 知识库页面，这是 copilot 的工作。
第二层：IMA 笔记作为对接接口
copilot 整理后的笔记是 Hermes 与 IMA 的唯一对接接口：
- 笔记内容完整（非摘要），包含知识库原文的全部信息
- 笔记结构化，便于搜索和读取
- Hermes 只需调 notes API 读取笔记，不需要反爬知识库内的网页链接
第三层：本地知识库做深度引擎
- 写文章、做分析时，优先搜本地知识库
- 本地知识库是精心维护的，质量高于 IMA 原始素材
- 路径：/opt/data/workspace/设计虱-知识库/
- 向量检索：FTS5 + wiki_embeddings（68页，herald/dmeta 768维）
第四层：Hermes 按需跨库检索
- 本地知识库搜不到 → 去 IMA 笔记搜索
- 用 ima-skill 的
search_note 接口实时查
- 不需要提前同步，用到的时候再去拿
搜索优先级
用户提问 → ① 本地知识库（FTS5 + 向量）→ 命中则用
↓ 未命中
② IMA 笔记（search_note）→ 命中则用
↓ 未命中
③ 互联网搜索
注意：不再直接搜索 IMA 知识库（search_knowledge），因为知识已被 copilot 整理进笔记。如果 search_note 搜不到，可能说明 copilot 还未整理该话题，可以建议用户让 copilot 补充整理。
IMA 凭证位置
- Client ID: ~/.config/ima/client_id
- API Key: ~/.config/ima/api_key
- 也可通过环境变量：IMA_OPENAPI_CLIENTID / IMA_OPENAPI_APIKEY
IMA API 调用方式
SKILL_DIR="/opt/data/skills/ima-skill"
node "$SKILL_DIR/ima_api.cjs" "<apiPath>" '<body>' '<options>'
copilot 整理工作流（用户触发，非自动）
用户通知 IMA copilot 执行整理工作流时，copilot 的操作：
- 浏览所有知识库
- 把知识完整沉淀为笔记（非摘要，保留完整内容）
- 相同/类似话题合并，避免重复
- 不需要的笔记标题前加"删除"前缀
- 用户手动删除带"删除"前缀的笔记
Hermes 侧无需操作，等 copilot 整理完后直接读取笔记即可。
冲突处理规则
- 建筑规范类（规范解读、抬板建筑）内容有时效性，IMA 中如有冲突，以最新发表的为准
- 建筑专业内容（产品设计、规范解读、抬板建筑）全部入库
- 游戏类（最强蜗牛等）：IMA 已有专门知识库管理，本地不重复入库
- 图片/文件夹/PDF/PPT：跳过
- 工具推荐类：和我们工作直接相关的入库，关联不大的跳过
注意事项
- IMA 不需要和本地保持实时同步，按需查询即可
- 本地知识库是"精编版"，IMA 笔记是"结构化中间层"
- 如果发现 copilot 漏整理了某个话题，提醒用户让 copilot 补充
- 周报/数据分析类内容只存本地，不存 IMA
- 每周扫描仍在运行：
ima_weekly_scan.py 每周三 6:00 扫描 copilot 整理后的笔记（不扫知识库页面），推荐值得入库的内容
- 已废弃的旧流程：Hermes 不再直接爬 IMA 知识库页面链接（search_knowledge），不再全量对比知识库条目发现新增
变更记录
- v1.0：初版，Hermes 自己扫描 IMA 知识库+笔记
- v2.0：架构重构——IMA copilot 预整理知识为笔记，Hermes 只对接笔记接口。废弃直接爬取知识库网页链接，保留每周笔记扫描
