前言¶

整理资料时常见的场景：手头有一批 PDF、Word、PPT 和图片，需要逐个拖进知识库。文件少的时候还好，几十上百个之后，手动上传既耗时又容易漏。

下面介绍的这个 Skill 就是把这件事交给 Agent：用户说一句「传到 IMA」「放进 IMA 知识库」，它按固定流程把本地文件批量写入腾讯 IMA 知识库，中间不需要人工逐个操作。

这是什么¶

一句话定位：一个把本地文件批量上传到腾讯 IMA 知识库的 Skill，覆盖 create_media → COS 上传 → add_knowledge 全流程。

• 名称：IMA 知识库上传
• 坐标：@user_af179082/ima-file-upload
• 发布者：user_af179082
• 来源：community（社区发布，非官方出品）
• 分类：knowledge-management
• 版本：1.0.0
• 标签：requires_api_key=false

它解决的是「本地文件 → IMA 知识库」这一段链路。触发方式是自然语言，包括「传到 IMA」「放进 IMA 知识库」「导入 ima」「上传到知识库」等说法。

核心能力¶

三段式上传流程，顺序固定：

1、create_media：先在 IMA 侧创建媒体条目，拿到后续上传所需的标识。
2、COS 上传：通过腾讯云 COS 把文件字节放到目标存储位置。这一步的签名实现是零依赖的，不需要额外安装 SDK，签名逻辑由 Skill 自己完成。
3、add_knowledge：把已经上传好的媒体关联进知识库，使其进入可检索状态。

两个配套技巧：

• 零依赖 COS 签名：减少环境准备成本，在缺依赖的机器上也能跑。
• 文件夹归置：同一批次的文件归到同一目录，避免上传后散落，后续按目录管理更清楚。

安装与启用¶

官方地址：

https://api.skillhub.cn/user_af179082/ima-file-upload
SkillHub 页面：https://www.skillhub.cn/skills/user_af179082/ima-file-upload
坐标：@user_af179082/ima-file-upload

需要说明：本次写作时上述两个地址都抓取失败，未能拿到官方给出的安装命令、Skills 目录路径和配置项。因此这里不贴未经核实的安装命令。

已经核实到的一点：页面标签为 requires_api_key=false，即按现有资料，启用该 Skill 不需要额外配置 API key。

这类 Skill 基于通用 SKILL.md 格式。具体怎么加载，以你使用的客户端（Cursor、Codex CLI、Claude Code 等）对 Skill 目录的支持方式为准；在拿到官方命令之前，不建议照搬其他 Skill 的安装路径。

典型用法¶

下面是依据官方简介整理的流程示例。因为页面未能抓取，完整参数和命令行未核实，这里只描述执行顺序：

1、准备一个本地目录，里面放待入库的文件（PDF、Word、PPT、图片等）。
2、对 Agent 说「把这些文件传到 IMA」或「导入 ima」。
3、Agent 先为每个文件调用 create_media，拿到上传标识。
4、走 COS 上传把文件字节写入，签名由 Skill 内部完成。
5、调用 add_knowledge，把文件关联进目标知识库。
6、同批次文件归置到同一文件夹，便于后续按目录检索。

适用场景与注意¶

适合：本地积累了大量文档和图片，需要一次性入库；或者你已经清楚自己要走 create_media → COS → add_knowledge 这条标准链路，不想自己手写上传脚本。

注意：

• 页面在本次抓取时无法访问，安装命令、配置字段和完整参数都未经核实，使用前请先到官方地址确认。
• 来源标注为 community，发布者是个人开发者 user_af179082，不是腾讯官方出品。涉及账号和存储的权限操作，自行评估风险。
• SkillHub 页面显示累计下载 1955 次、安装 0 次（抓取时数据）。评分字段返回 100000，疑似页面默认值，参考意义有限。
• 支持的文件类型以 IMA 知识库侧的实际限制为准。
• COS 上传环节依赖腾讯云 COS 的存储配置，具体凭据字段以官方文档为准。

结尾¶

这个 Skill 的价值在于把「本地文件进 IMA 知识库」这条链路固化成三步，用户只需要用自然语言提出要求，不需要逐个拖拽，也不需要自己处理 COS 签名。

官方地址：https://api.skillhub.cn/user_af179082/ima-file-upload
SkillHub 页面：https://www.skillhub.cn/skills/user_af179082/ima-file-upload