前言¶
对象存储和数据万象的能力面很广：上传下载、桶配置、图片与媒体处理、内容审核、智能检索、知识库，各自对应控制台、SDK 或 REST API。若要在 Cursor、Claude Code 等 Agent 里用自然语言完成这些操作，往往要反复查文档、拼参数。下面介绍 SkillHub 上的 Tencent COS（@tencent-adm/tencent-cos-skill），由腾讯云对象存储发布，把 COS 与 CI 能力收敛到同一套 Node.js 脚本，供 Agent 按技能说明调用。
这是什么¶
Tencent COS 是一站式管理腾讯云对象存储（COS）和数据万象（CI）的 Agent Skill。当前 SkillHub 版本为 1.2.2，来源标注为 enterprise，分类为 it-ops-security。Skill 标签 requires_api_key=true，使用前需具备可用的腾讯云 API 凭证。官方入口：SkillHub 页面，包坐标 @tencent-adm/tencent-cos-skill。
核心功能¶
以下能力均来自 Skill 官方简介，按场景归纳。
文件存储与桶管理¶
- 上传、下载、列出、删除文件，获取签名下载链接，批量操作与复制。
- 列出或创建存储桶；查询数据万象及各子服务开通状态。
- 读写 ACL、跨域、标签；查询版本控制、生命周期、Policy、防盗链、默认加密、静态网站、日志等 COS 配置。
图片、文档与媒体¶
- 图片处理：缩放、裁剪、旋转、格式转换、文字水印、质量评估、超分辨率、智能裁剪、二维码识别。
- 内容识别：描述单张图片或视频内容、图片标签、OCR；视频 ASR/OCR 与粗分类。
- 文档处理：办公文档转 PDF、文档预览（图片/HTML）。
- 媒体处理：视频智能封面、转码、截帧、媒体信息。
审核、语音与本地文件工具¶
- 内容审核：图片、视频、音频、文本、文档违规检测。
- 智能语音：语音识别、语音合成、音频降噪、人声分离。
- 文件处理：哈希计算、压缩、解压。
智能检索、数据集与知识库¶
- MetaInsight 智能检索：数据集与索引管理；以图搜图、文本搜图、以文搜视频片段、人脸搜索、元数据与多模态检索（文档/图片/视频）。
- 数据集分析：自然语言条件筛选、聚合统计、桶反查数据集、图片理解；EXIF 与 AI 媒资详情（见下文示例命令）。
- 结果预览：为图片、视频和文档检索结果生成可交互 HTML 预览。
- 知识库：一键创建知识库（自动创建桶、数据集并绑定），上传文档到知识库，语义检索知识库内容。
安装与启用¶
SkillHub 推荐两种方式：用 CLI 安装，或让 Agent 按安装文档执行。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已安装：
command -v skillhub && skillhub --version
未安装时可执行完整安装（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、安装 Tencent COS 技能¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/，Agent 可能无法识别：
skillhub install @tencent-adm/tencent-cos-skill --dir <skills 目录>
也可将下列说明交给 Agent，由其按 SkillHub 安装与优先源配置 完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 @tencent-adm/tencent-cos-skill。
3、各客户端 skills 目录（节选）¶
安装路径因客户端而异，常见位置如下（完整列表见官方安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装后按所用 Agent 的要求重启或刷新技能列表。API 密钥配置的具体字段名以 Skill 包内说明为准；官方仅标明需要 API Key（requires_api_key=true）。
典型用法¶
Skill 通过统一的 Node.js SDK 脚本暴露能力。除在对话中描述目标（例如「上传文件到某桶」「为图片加水印」）外，官方简介中给出了一条可对照的子命令示例。
按 URI 拉取已入库图片或视频的 AI 标签、ASR、OCR、粗分类等信息：
ci_api.mjs get-ai-media-info
具体参数（如 URI、桶名、地域）需结合 Skill 内脚本帮助或 Agent 读取的技能文档填写；执行前需在本机具备 Node.js 运行环境，且已完成腾讯云鉴权配置。
知识库相关流程在简介中概括为：一键创建知识库 → 上传文档 → 语义检索，适合把 COS/CI 上的文档管线与 RAG 类任务放在同一技能内完成。
适用场景与注意¶
适合谁：已在用或计划用腾讯云 COS/CI 的开发者、运维与数据分析相关角色；希望在 Agent 会话中完成存储、媒资 AI 处理、MetaInsight 检索或知识库操作，而不每次手写 SDK 调用。
使用注意：
- 依赖腾讯云账号与 API 凭证，部分 CI 能力需桶或账号侧已开通对应子服务；Skill 支持查询数据万象及各子服务开通状态。
- 能力覆盖面大，实际可用子集仍受账号权限、地域与计费策略约束，以腾讯云控制台与 API 行为为准。
- 安装路径必须对齐当前 Agent 的 skills 目录，避免装错位置导致技能不生效。
SkillHub 页面显示的参考数据（以页面为准）：评分 100000，下载 34653，安装 865。
结尾¶
Tencent COS 把 COS 存储管理、数据万象 AI/媒资能力以及 MetaInsight、知识库等场景收进一个 Skill，适合在支持 Skill 的 Agent 里用对话驱动云侧操作。安装与坐标以 SkillHub 为准：@tencent-adm/tencent-cos-skill，https://www.skillhub.cn/skills/tencent-adm/tencent-cos-skill。
