技能介绍

解决 IMA 知识库文件入库的工程痛点

直接通过 IMA MCP 上传大文件或批量文件时，常面临几个工程痛点：原生接口不支持新建知识库与移动/删除文件，COS 官方 SDK 依赖安装缓慢，且临时凭证的签名与生命周期管理容易出错。本技能通过封装底层的 COS 签名直传逻辑，补齐了这些原生能力缺失，让文件入库流程具备确定性和可脚本化能力。

核心能力与关键步骤

技能将上传拆解为三个严谨的步骤，确保数据一致性与安全性：

前置校验与目标定位：首先确认 ima-mcp 连接器已连接。由于无法新建知识库，需通过 get_addable_knowledge_base_list 获取可写库列表。同时，利用 get_knowledge_list 排查用户口中的“知识库”是否实为文件夹（media_type: 99），避免错传。
零依赖 COS 直传：调用 create_media 获取临时凭证（需严格传入精确字节数与 content_type）。随后，利用内置的零依赖脚本 scripts/cos_put.py 执行 PUT 请求。脚本实现了 COS Signature v5 签名算法，串行处理 tasks.json 中的上传任务，大幅省去了安装 cos-python-sdk-v5 的时间。
入库与目录归置：调用 add_knowledge 完成最终入库。若需将文件移入特定文件夹，可直接复用 media_id 并传入目标 folder_id，配合 DUPLICATE_NAME_STRATEGY_REPLACE 策略，即可实现“移动”效果（原生无 move 工具）。

适用边界与安全注意点

该方案不适用于新建知识库场景，且无法删除已入库文件。在处理扫描版 PDF 时，需注意单文件体积上限，建议先用 Pillow 将每页缩放至 1240px 宽并采用 JPEG q72 压缩，控制在 30MB 以内。此外，tasks.json 中包含明文临时密钥，上传完成后必须立即从工作区删除，以防凭证泄露。入库后可通过 get_knowledge_list 轮询 media_state 与 parse_progress 验证解析状态。