前言¶
對象存儲和數據萬象的能力面很廣：上傳下載、桶配置、圖片與媒體處理、內容審覈、智能檢索、知識庫，各自對應控制台、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。
