ima 知识库同步工具

解决什么问题

ima 知识库与本地文件夹经常不一致：本地有新增、修改，云端有遗漏；上传前不知道哪些文件不支持或超限。手动逐个核对成本高，也缺少可复核的差异结果。ima 知识库同步工具把本地目录、ima 知识库、同步状态放到同一流程里对比，适合把本地资料持续整理进知识库，而不只是临时上传几个文件。

如何工作

工具围绕 差异状态 展开：

• 通过 ima OpenAPI 或 Bearer Token 获取知识库文件列表
• 递归扫描本地目录，按文件名（含扩展名）与知识库标题匹配
• 使用 sync_state.json 记录已上传文件的 大小 和 修改时间，实现增量判断
• 对文件做预检：.pdf、.docx、.md、.png 等支持格式与大小限制，视频等不支持类型自动标记
• 生成 HTML 报告，标注 missing、new、modified、same
• 上传时走 create_media、COS 直传、add_knowledge 三步流程

它提供可视化界面、Python 脚本和 WorkBuddy 定时检查三种形态。普通用户可以在浏览器中打开前端完成对比和上传；自动化场景更适合命令行与 --dry-run 只看差异。

边界与注意点

该工具适合 本地目录 vs ima 知识库 的同步和报告；纯搜索、新建笔记、编辑知识库内容更宜使用 ima 其他能力。文件名必须与 ima 标题一致；OpenAPI 凭证应保存在环境变量或可信界面中；sync_state.json 是增量关键，删除后可能重复上传。