前言¶
在云上跑应用时，对象存储和媒资处理往往要分开对接：COS 管上传下载与桶配置，数据万象（CI）管图片处理、内容识别、审核和检索。控制台能完成这些事，但在编码 Agent 对话里，你更希望用自然语言描述意图，由 Skill 调用统一脚本完成操作，而不是每次查文档拼 SDK。
下面介绍 SkillHub 上的 Tencent Cloud COS（坐标 @tencent-adm/tencentcloud-cos，当前版本 1.2.2）。它由腾讯云对象存储发布，来源为 enterprise，标签标明 requires_api_key=true，使用前需准备腾讯云 API 凭证。
这是什么¶
Tencent Cloud COS 是一站式 Skill，把腾讯云对象存储（COS）与数据万象（CI）能力收敛到同一套 Node.js SDK 脚本里，供 Cursor、Claude Code、Codex 等支持 Skills 的 Agent 读取 SKILL.md 后按场景调用。
它解决的是：在 Agent 会话中完成存储、媒资处理、审核、检索和知识库相关操作，而不必在对话里手写多份 SDK 示例或反复切换控制台。
核心功能¶
以下能力均来自 SkillHub 官方简介，按场景归纳。
文件存储与存储桶¶
- 文件：上传、下载、列出、删除、复制、批量操作，获取签名下载链接。
- 存储桶：列出/创建桶；查询数据万象及各子服务开通状态；读写 ACL、跨域、标签；查询版本控制、生命周期、Policy、防盗链、默认加密、静态网站、日志等 COS 配置。
图片与内容理解¶
- 图片处理：缩放、裁剪、旋转、格式转换、文字水印、质量评估、超分辨率、智能裁剪、二维码识别。
- 内容识别：描述单张图片或视频内容、图片标签、OCR；视频 ASR/OCR 与粗分类。
文档、媒体与审核¶
- 文档：办公文档转 PDF、文档预览（图片/HTML）。
- 媒体：视频智能封面、转码、截帧、媒体信息。
- 内容审核：图片/视频/音频/文本/文档违规检测。
语音与本地文件工具¶
- 智能语音：语音识别、语音合成、音频降噪、人声分离。
- 文件处理：哈希计算、压缩、解压。
智能检索与数据集¶
- MetaInsight：数据集与索引管理；以图搜图、文本搜图、以文搜视频片段、人脸搜索、元数据与多模态检索（文档/图片/视频）。
- 数据集分析：自然语言条件筛选、聚合统计、桶反查数据集、图片理解、EXIF；按 URI 拉取已入库图片或视频的 AI 标签、ASR、OCR、粗分类（官方示例命令见下文）。
- 结果预览：为图片、视频和文档检索结果生成可交互 HTML 预览。
知识库¶
一键创建知识库（自动创建桶、数据集并绑定），上传文档到知识库，并对知识库内容做语义检索。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
skillhub install @tencent-adm/tencentcloud-cos --dir <skills 目录>
常见 Agent 的 skills 路径（来自 SkillHub 安装说明）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将下面提示词发给 AI，让其按 SkillHub 安装文档 安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@tencent-adm/tencentcloud-cos`。
3、凭证与启用¶
Skill 标记为需要 API Key。实际密钥字段与环境变量命名以安装包内 SKILL.md 为准；在 Agent 中启用后，由模型根据 Skill 说明调用 cos_api.mjs、ci_api.mjs 等脚本，你只需在对话中说明桶名、对象路径或处理需求。
典型用法¶
官方页面未展开完整命令手册，下列为简介中明确写出的可核对示例。
拉取已入库媒资的 AI 详情（标签、ASR、OCR、粗分类等）：
ci_api.mjs get-ai-media-info
按 Skill 文档传入对应 URI 等参数；具体子命令与参数以技能包内脚本说明为准。
知识库流程（能力描述层面）：通过 Skill 触发「创建知识库 → 上传文档 → 语义检索」，底层会自动处理桶、数据集与绑定关系，无需在对话里分步拼控制台操作。
日常存储类任务（上传、签名链接、列出对象）和图片处理类任务，同样在 Agent 中用自然语言描述目标即可，由 Skill 路由到 COS/CI 脚本；安装完成后建议先让 Agent 阅读本 Skill 的 SKILL.md 再执行复杂链路（如 MetaInsight 索引或多模态检索）。
适用场景与注意¶
适合谁
- 已在用或计划用腾讯云 COS/CI 的团队，希望把存储、媒资、审核、检索和知识库能力接到编码 Agent 工作流。
- 需要在对话中批量管桶配置、生成临时下载链接、做图片/视频 AI 处理或内容审核的运维与后端开发。
限制与注意
- 依赖 Node.js 脚本与腾讯云账号；
requires_api_key=true，未配置凭证时调用会失败。 - 数据万象部分能力需在对应地域开通子服务；Skill 支持查询开通状态，但仍以控制台与计费规则为准。
- SkillHub 分类为 it-ops-security；页面展示评分与下载量会随商店更新变化，选用时以 SkillHub 实时数据为准。
- 涉及审核、合规与费用的操作，建议在 Agent 执行前确认桶、对象路径与处理参数，避免误删或重复转码。
结尾¶
Tencent Cloud COS Skill 把 COS 与数据万象的长清单能力压进一个 Agent 可读的 Skill，适合把「存文件、处理媒资、建知识库」从分散 SDK 调用收成对话内的一次性任务。需要安装或查看更新说明时，可访问 SkillHub 页面：
- https://www.skillhub.cn/skills/tencent-adm/tencentcloud-cos
- https://api.skillhub.cn/tencent-adm/tencentcloud-cos
