IMA 知识库自动归档

解决本地文件与知识库的断层

在工程团队的日常协作中，随着工艺分析、合同扫描件和设备手册不断产生，本地磁盘往往堆积了大量离散文档。IMA 知识库虽然提供了优秀的云端存储，但在缺乏统一入口的情况下，跨系统管理文件十分繁琐。本技能的目标是消除本地环境与云端知识库之间的断层，把繁琐的归档动作封装为可靠的命令行管道。

核心工作流解析

技能的核心在于将 IMA OpenAPI 与 COS 对象存储的底层调用串联起来，底层依赖 ima-skills 提供的 ima_api.cjs、preflight-check.cjs 和 cos-upload.cjs。一键执行时，脚本按以下顺序工作：

• 解析与预检：按名称解析出目标文件夹 ID，同时校验文件扩展名与体积（preflight-check.cjs 拦截不支持的格式）。
• 重名拦截：调用 check_repeated_names 接口检查是否已存在同名文件，默认命中即停以避免产生冗余副本。
• 云端落库：创建媒体占位符获取临时凭证，通过 COS 直传文件本体，最后调用 add_knowledge 完成入库闭环。

适用边界与硬约束

• 仅负责填充：IMA OpenAPI 不支持创建知识库或文件夹，必须先在客户端手动建好目录结构，脚本只负责把文件投递进去。
• 无法覆盖替换：如果遇到重名文件，IMA 机制只会“保留两者”并添加时间戳。除非明确知道后果并使用 --force，否则脚本默认遇重名即中止。
• 格式与大小限制：PDF 或 Word 等文档上限为 200MB，Excel 或 Markdown 等文本类上限为 10MB，不支持 CAD 图纸（.dwg）和视频格式。
• 真实性要求：如果归档的内容引用了外部网络资料，必须核对并标注真实来源，禁止产生虚构信息。