前言¶
在雲上跑應用時，對象存儲和媒資處理往往要分開對接：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
