ima 知识库自动整理

问题从哪来

ima 知识库（ima.qq.com）里常见状态是：根目录堆满 PDF、网页和笔记，文件夹要么没有、要么命名像「新建文档」「未命名」；同一主题的文件散落在不同层级，重复副本还挂着 (1)、-副本 后缀。OpenAPI 并不提供建文件夹、移动、重命名已有条目——若技能假装能「一键全自动整理」，只会反复报错或制造重复上传。

技能怎么跑

本技能依赖已安装的 ima-skill（ima_api.cjs 与凭证），链路是：扫描结构 → 诊断打分 → 整理蓝图 → 分级落地。

• 扫描：递归浏览目录（有深度/条数/翻页上限），统计 media_type、根目录散落项，并对标题做关键词聚类判断领域（如安全生产里的法规、预案、隐患、作业许可等）。
• 诊断：按规则检查无文件夹、根目录过散、命名不规范、同名/相似文件、层级过深、类型混杂等，输出不含内部 kb_id 的报告；仅「体检」可在诊断后停止。
• 蓝图：完整模式给出 2～3 套文件夹结构方案供选择；归位模式把散文件映射到已有文件夹；同时生成归位映射表与重命名建议表（遵循命名规范文档）。
• 落地：执行前对照 ima-skill 的 api.md 做能力自检。若已有建夹/移动/重命名接口则用户确认后自动执行；当前默认路径是把「知识地图/整理索引」Markdown 上传回库（走 check_repeated_names → COS → add_knowledge），对新链接用 import_urls 导入已存在文件夹，建夹/移动/重命名/删除则生成客户端手动清单。

默认只读诊断；任何写回知识库的操作都必须经你明确确认。

边界与分工

• 不负责库内全文搜索阅读（用 ima-skill）；不负责三级标签体系与关联图谱（用 ima-kb-tagging）。
• 不删除、不用重复上传「覆盖」旧文件；错误知识库 ID 必须先让用户选定，不对用户暴露内部 ID。