{"id":"5774bb34-bb6d-4867-a24e-11eb17fc7c51","entityType":"agent","slug":"clawhub-shawnminh-tencent-cloud-cos","name":"腾讯云COS存储","canonicalUrl":"https://www.xpersona.co/agent/clawhub-shawnminh-tencent-cloud-cos","canonicalPath":"/agent/clawhub-shawnminh-tencent-cloud-cos","generatedAt":"2026-10-09T20:43:04.031Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"description":"腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件， 或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、 文档转PDF、视频智能封面生成等操作时使用此技能。 Skill: 腾讯云COS存储 Owner: ShawnMinh Summary: 腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件， 或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、 文档转PDF、视频智能封面生成等操作时使用此技能。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-02-28T11:24:15.760Z | user Version 1.0.5 - Added scripts/setup.sh for automated environment and credential setup. - SKILL.md updated with step-by-step first-time setup instructions using setup.sh. - Setup process no","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 4/15/2026.","installCommand":"clawhub skill install kn75r0rammt45k8qe5we0sh63580c5y0:tencent-cloud-cos","sourceUrl":"https://clawhub.ai/ShawnMinh/tencent-cloud-cos","homepage":"https://clawhub.ai/ShawnMinh/tencent-cloud-cos","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/ShawnMinh/tencent-cloud-cos","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":61,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件， 或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、 文档转PDF、视频智能封面生成等操作时使用此技能。 Skill: 腾讯云COS存储 Owner: ShawnMinh Summary: 腾讯云对象"},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"stars":null,"forks":null,"downloads":1109,"packageName":null,"latestVersion":"1.0.5","tractionLabel":"1.1K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-03-01T00:22:01.856Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-03-01T00:22:01.856Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-02T00:22:01.856Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.5","createdAt":"2026-02-28T11:24:15.760Z","changelog":"Version 1.0.5 - Added scripts/setup.sh for automated environment and credential setup. - SKILL.md updated with step-by-step first-time setup instructions using setup.sh. - Setup process now checks, installs dependencies, and persists credentials for all supported tools. - Enhanced metadata with install hints for cos-mcp, mcporter, and Node.js SDK. - Clarified usage workflow and tool invocation guidelines for all integration methods. - No breaking changes to existing usage; setup is now streamlined and documented.","fileCount":6,"zipByteSize":13785},{"version":"1.0.3","createdAt":"2026-02-28T09:58:11.108Z","changelog":"**tencent-cloud-cos v1.0.3 – Major Simplification and Refactor** - Unified and clarified execution strategy: now supports three fallback approaches—cos-mcp, Node.js SDK, and coscmd CLI. - All legacy docs, scripts, config samples, and tests were removed; replaced by concise, up-to-date skill documentation. - Added: Modern, structured SKILL.md describing features, execution order, configuration needs, workflow, and tool parity. - Added: Reference files for API and config templates; new Node.js script for storage operations. - Now supports only well-documented storage and media tasks; all tool availability and configuration handling is explained centrally. - Documentation is vastly condensed—quick start, troubleshooting, and extended examples were removed or integrated into main doc.","fileCount":5,"zipByteSize":10630},{"version":"1.0.0","createdAt":"2026-02-05T07:13:38.274Z","changelog":"Initial release of tencentcloud-cos-skill (v1.0.0): - Integrates Tencent Cloud Object Storage (COS) and Data Vison (CI) with Clawdbot via the official MCP server. - Supports cloud storage operations: upload, download, list, manage files. - Adds advanced image processing: quality assessment, super-resolution, background removal, QR code recognition, watermarking. - Enables smart search features: search by image and by text. - Provides document processing: format conversion to PDF, video cover generation. - Includes detailed installation, configuration, usage instructions, and troubleshooting tips.","fileCount":null,"zipByteSize":null}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install kn75r0rammt45k8qe5we0sh63580c5y0:tencent-cloud-cos","setupComplexity":"low","setupSteps":["Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cloud-cos/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cloud-cos/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cloud-cos/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cloud-cos/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cloud-cos/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cloud-cos/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T20:43:04.030Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cloud-cos/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cloud-cos/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cloud-cos/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-shawnminh-tencent-cloud-cos/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"Skill: 腾讯云COS存储\n\nOwner: ShawnMinh\n\nSummary: 腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件， 或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、 文档转PDF、视频智能封面生成等操作时使用此技能。\n\nTags: latest:1.0.5\n\nVersion history:\n\nv1.0.5 | 2026-02-28T11:24:15.760Z | user\n\nVersion 1.0.5\n\n- Added scripts/setup.sh for automated environment and credential setup.\n- SKILL.md updated with step-by-step first-time setup instructions using setup.sh.\n- Setup process now checks, installs dependencies, and persists credentials for all supported tools.\n- Enhanced metadata with install hints for cos-mcp, mcporter, and Node.js SDK.\n- Clarified usage workflow and tool invocation guidelines for all integration methods.\n- No breaking changes to existing usage; setup is now streamlined and documented.\n\nv1.0.3 | 2026-02-28T09:58:11.108Z | auto\n\n**tencent-cloud-cos v1.0.3 – Major Simplification and Refactor**\n\n- Unified and clarified execution strategy: now supports three fallback approaches—cos-mcp, Node.js SDK, and coscmd CLI.\n- All legacy docs, scripts, config samples, and tests were removed; replaced by concise, up-to-date skill documentation.\n- Added: Modern, structured SKILL.md describing features, execution order, configuration needs, workflow, and tool parity.\n- Added: Reference files for API and config templates; new Node.js script for storage operations.\n- Now supports only well-documented storage and media tasks; all tool availability and configuration handling is explained centrally.\n- Documentation is vastly condensed—quick start, troubleshooting, and extended examples were removed or integrated into main doc.\n\nv1.0.0 | 2026-02-05T07:13:38.274Z | user\n\nInitial release of tencentcloud-cos-skill (v1.0.0):\n\n- Integrates Tencent Cloud Object Storage (COS) and Data Vison (CI) with Clawdbot via the official MCP server.\n- Supports cloud storage operations: upload, download, list, manage files.\n- Adds advanced image processing: quality assessment, super-resolution, background removal, QR code recognition, watermarking.\n- Enables smart search features: search by image and by text.\n- Provides document processing: format conversion to PDF, video cover generation.\n- Includes detailed installation, configuration, usage instructions, and troubleshooting tips.\n\nArchive index:\n\nArchive v1.0.5: 6 files, 13785 bytes\n\nFiles: references/api_reference.md (6778b), references/config_template.json (2403b), scripts/cos_node.mjs (6526b), scripts/setup.sh (9963b), SKILL.md (10981b), _meta.json (136b)\n\nFile v1.0.5:SKILL.md\n\n---\nname: tencent-cloud-cos\ndescription: >\n  腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件，\n  或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、\n  文档转PDF、视频智能封面生成等操作时使用此技能。\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"☁️\",\n        \"requires\": {},\n        \"install\":\n          [\n            {\n              \"id\": \"node-mcporter\",\n              \"kind\": \"node\",\n              \"package\": \"mcporter\",\n              \"bins\": [\"mcporter\"],\n              \"label\": \"Install mcporter (MCP CLI)\",\n            },\n            {\n              \"id\": \"node-cos-mcp\",\n              \"kind\": \"node\",\n              \"package\": \"cos-mcp\",\n              \"bins\": [\"cos-mcp\"],\n              \"label\": \"Install cos-mcp (COS MCP Server)\",\n            },\n            {\n              \"id\": \"node-cos-sdk\",\n              \"kind\": \"node\",\n              \"package\": \"cos-nodejs-sdk-v5\",\n              \"label\": \"Install COS Node.js SDK\",\n            },\n          ],\n      },\n  }\n---\n\n# 腾讯云 COS 技能\n\n通过 cos-mcp MCP 工具 + Node.js SDK 脚本 + COSCMD 管理腾讯云对象存储和数据万象。\n\n## 首次使用 — 自动设置\n\n当用户首次要求操作 COS 时，按以下流程操作：\n\n### 步骤 1：检查当前状态\n\n```bash\n{baseDir}/scripts/setup.sh --check-only\n```\n\n如果输出显示一切 OK（cos-mcp 已安装、凭证已配置），跳到「执行策略」。\n\n### 步骤 2：如果未配置，引导用户提供凭证\n\n告诉用户：\n> 我需要你的腾讯云凭证来连接 COS 存储服务。请提供：\n> 1. **SecretId** — 腾讯云 API 密钥 ID\n> 2. **SecretKey** — 腾讯云 API 密钥 Key\n> 3. **Region** — 存储桶区域（如 ap-guangzhou）\n> 4. **Bucket** — 存储桶名称（格式 name-appid，如 mybucket-1250000000）\n> 5. **DatasetName**（可选） — 数据万象数据集名称（仅智能搜索需要）\n>\n> 你可以在 [腾讯云控制台 > 访问管理 > API密钥管理](https://console.cloud.tencent.com/cam/capi) 获取密钥，\n> 在 [COS 控制台](https://console.cloud.tencent.com/cos/bucket) 查看存储桶信息。\n\n### 步骤 3：用户提供凭证后，运行自动设置\n\n```bash\n{baseDir}/scripts/setup.sh --secret-id \"<SecretId>\" --secret-key \"<SecretKey>\" --region \"<Region>\" --bucket \"<Bucket>\"\n```\n\n如有 DatasetName：\n```bash\n{baseDir}/scripts/setup.sh --secret-id \"<SecretId>\" --secret-key \"<SecretKey>\" --region \"<Region>\" --bucket \"<Bucket>\" --dataset \"<DatasetName>\"\n```\n\n脚本会自动：\n- 检查并安装 mcporter（MCP 命令行工具）\n- 检查并安装 cos-mcp 和 cos-nodejs-sdk-v5\n- 创建/更新 `~/.mcporter/mcporter.json`，写入 cos-mcp 服务器配置\n- 将凭证写入 shell 配置文件（`~/.zshrc` 或 `~/.bashrc`），重启后仍可用\n- 配置 coscmd（如有 Python 环境）\n- 验证 COS 连接\n\n设置完成后即可开始使用。\n\n## 执行策略\n\n三种方式按优先级降级，确保操作始终可完成：\n\n1. **方式一：cos-mcp MCP 工具**（优先） — 功能最全，支持存储 + 图片处理 + 智能搜索 + 文档媒体处理\n2. **方式二：Node.js SDK 脚本** — 通过 `scripts/cos_node.mjs` 执行存储操作\n3. **方式三：COSCMD 命令行** — 通过 shell 命令执行存储操作\n\n```\nmcporter + cos-mcp 可用？（which mcporter && 配置存在）\n  ├─ 是 → 使用方式一 mcporter 调用（全部功能）\n  └─ 否 → cos-mcp MCP 工具可直接调用？（getCosConfig 返回结果）\n              ├─ 是 → 使用方式一直接调用（全部功能）\n              └─ 否 → Node.js + cos-nodejs-sdk-v5 可用？\n                        ├─ 是 → 使用方式二（存储操作）\n                        └─ 否 → coscmd 可用？（which coscmd）\n                                  ├─ 是 → 使用方式三（存储操作）\n                                  └─ 否 → 运行 setup.sh 安装\n```\n\n**判断方式一(mcporter)**：`which mcporter` 且 `cat ~/.mcporter/mcporter.json | grep cos-mcp` 有输出。\n**判断方式一(直接)**：尝试调用 `getCosConfig` MCP 工具，若返回结果则可用。\n**判断方式二**：`node -e \"require('cos-nodejs-sdk-v5')\"` 成功则可用。\n**判断方式三**：`which coscmd` 有输出则可用。\n\n---\n\n## 方式一：cos-mcp MCP 工具（优先）\n\n> GitHub: https://github.com/Tencent/cos-mcp\n\nMCP 配置模板见 `references/config_template.json`。\n\n### 调用格式\n\n通过 mcporter 命令行调用 cos-mcp MCP 工具：\n\n```\nmcporter call cos-mcp.<tool_name> --config ~/.mcporter/mcporter.json --output json [--args '<JSON>']\n```\n\n列出所有可用工具：\n```\nmcporter list cos-mcp --config ~/.mcporter/mcporter.json --schema\n```\n\n**判断 mcporter 是否可用**：`which mcporter` 且 `~/.mcporter/mcporter.json` 包含 cos-mcp 配置。\n如果 mcporter 不可用，可回退到客户端直接调用 MCP 工具（`getCosConfig` 等）。\n\n### 工具总览\n\n| 类别 | 说明 |\n|------|------|\n| 存储操作 | 上传、下载、列出、获取签名URL |\n| 图片处理 | 质量评估、超分辨率、抠图、二维码识别、水印 |\n| 智能搜索 | 以图搜图、文本搜图（需预建数据集） |\n| 文档媒体 | 文档转PDF、视频智能封面（异步任务） |\n\n### 常用操作\n\n> 以下示例同时展示两种调用格式。mcporter 格式省略公共前缀 `mcporter call cos-mcp.` 和 `--config ~/.mcporter/mcporter.json --output json`。\n> 完整 mcporter 命令：`mcporter call cos-mcp.<tool> --config ~/.mcporter/mcporter.json --output json --args '<JSON>'`\n\n#### 存储\n\n```bash\n# 上传本地文件（mcporter 格式）\nmcporter call cos-mcp.putObject --config ~/.mcporter/mcporter.json --output json --args '{\"filePath\":\"/path/to/file.jpg\",\"targetDir\":\"images\"}'\n\n# 上传本地文件（客户端直接调用格式）\nputObject  filePath=\"/path/to/file.jpg\"  targetDir=\"images\"\n\n# 上传字符串内容\nputString  content=\"hello world\"  fileName=\"test.txt\"  targetDir=\"docs\"\n\n# 通过 URL 上传\nputObjectSourceUrl  sourceUrl=\"https://example.com/image.png\"  targetDir=\"images\"\n\n# 列出文件\ngetBucket  Prefix=\"images/\"\n\n# 下载文件\ngetObject  objectKey=\"images/photo.jpg\"\n\n# 获取签名下载链接\ngetObjectUrl  objectKey=\"images/photo.jpg\"\n```\n\n#### 图片处理\n\n```\n# 图片质量评估\nassessQuality  objectKey=\"images/photo.jpg\"\n\n# AI 超分辨率\naiSuperResolution  objectKey=\"images/photo.jpg\"\n\n# AI 智能抠图\naiPicMatting  objectKey=\"images/photo.jpg\"\n\n# 二维码识别\naiQrcode  objectKey=\"images/qrcode.jpg\"\n\n# 添加文字水印\nwaterMarkFont  objectKey=\"images/photo.jpg\"  text=\"版权所有\"\n\n# 获取图片元信息\nimageInfo  objectKey=\"images/photo.jpg\"\n```\n\n#### 智能搜索（需预建数据集）\n\n```\n# 以图搜图\nimageSearchPic  uri=\"https://example.com/query.jpg\"\n\n# 文本搜图\nimageSearchText  text=\"蓝天白云\"\n```\n\n#### 文档与媒体处理（异步任务）\n\n```\n# 文档转 PDF\ncreateDocToPdfJob  objectKey=\"docs/report.docx\"\n# 查询任务结果\ndescribeDocProcessJob  jobId=\"<jobId>\"\n\n# 视频智能封面\ncreateMediaSmartCoverJob  objectKey=\"videos/demo.mp4\"\n# 查询任务结果\ndescribeMediaJob  jobId=\"<jobId>\"\n```\n\n工具详细参数定义见 `references/api_reference.md`。\n\n---\n\n## 方式二：Node.js SDK 脚本\n\n> 官方文档: https://www.tencentcloud.com/zh/document/product/436/8629\n\n当 cos-mcp 不可用时，通过 `scripts/cos_node.mjs` 执行存储操作。凭证从环境变量读取。\n\n### 常用命令\n\n> 以下省略 `node {baseDir}/scripts/cos_node.mjs` 前缀。完整格式：`node {baseDir}/scripts/cos_node.mjs <action> [options]`\n\n```bash\n# 上传文件\nupload --file /path/to/file.jpg --key remote/path/file.jpg\n\n# 上传字符串\nput-string --content \"文本内容\" --key remote/file.txt --content-type \"text/plain\"\n\n# 下载文件\ndownload --key remote/path/file.jpg --output /path/to/save/file.jpg\n\n# 列出文件\nlist --prefix \"images/\"\n\n# 获取签名 URL\nsign-url --key remote/path/file.jpg --expires 3600\n\n# 查看文件信息\nhead --key remote/path/file.jpg\n\n# 删除文件\ndelete --key remote/path/file.jpg\n```\n\n所有命令输出 JSON 格式，`success: true` 表示成功，退出码 0。\n\n### 限制\n\n仅支持存储操作，**不支持**图片处理、智能搜索、文档转换。\n\n---\n\n## 方式三：COSCMD 命令行\n\n> 官方文档: https://www.tencentcloud.com/zh/document/product/436/10976\n\n当方式一和方式二均不可用时使用。配置持久化在 `~/.cos.conf`。\n\n### 常用命令\n\n```bash\n# 上传\ncoscmd upload /path/to/file.jpg remote/path/file.jpg\ncoscmd upload -r /path/to/folder/ remote/folder/\n\n# 下载\ncoscmd download remote/path/file.jpg /path/to/save/file.jpg\ncoscmd download -r remote/folder/ /path/to/save/\n\n# 列出文件\ncoscmd list images/\n\n# 删除\ncoscmd delete remote/path/file.jpg\ncoscmd delete -r remote/folder/ -f\n\n# 签名 URL\ncoscmd signurl remote/path/file.jpg -t 3600\n\n# 文件信息\ncoscmd info remote/path/file.jpg\n\n# 复制/移动\ncoscmd copy <BucketName-APPID>.cos.<Region>.myqcloud.com/source.jpg dest.jpg\ncoscmd move <BucketName-APPID>.cos.<Region>.myqcloud.com/source.jpg dest.jpg\n```\n\n### 限制\n\n仅支持存储操作，**不支持**图片处理、智能搜索、文档转换。\n\n---\n\n## 功能对照表\n\n| 功能 | 方式一 cos-mcp | 方式二 Node SDK | 方式三 COSCMD |\n|------|:-:|:-:|:-:|\n| 上传文件 | ✅ | ✅ | ✅ |\n| 上传字符串/Base64 | ✅ | ✅ | ❌ |\n| 通过 URL 上传 | ✅ | ❌ | ❌ |\n| 下载文件 | ✅ | ✅ | ✅ |\n| 列出文件 | ✅ | ✅ | ✅ |\n| 获取签名 URL | ✅ | ✅ | ✅ |\n| 删除文件 | ❌ | ✅ | ✅ |\n| 查看文件信息 | ❌ | ✅ | ✅ |\n| 递归上传/下载目录 | ❌ | ❌ | ✅ |\n| 图片处理（CI） | ✅ | ❌ | ❌ |\n| 智能搜索 | ✅ | ❌ | ❌ |\n| 文档转 PDF | ✅ | ❌ | ❌ |\n| 视频智能封面 | ✅ | ❌ | ❌ |\n\n## 使用规范\n\n1. **首次使用先运行** `{baseDir}/scripts/setup.sh --check-only` 检查环境\n2. **mcporter 调用必须带** `--config ~/.mcporter/mcporter.json` 和 `--output json`\n3. **凭证不明文展示**：引导用户自行通过 setup.sh 或编辑配置文件设置\n4. **所有文件路径**（`objectKey`/`cospath`/`--key`）为存储桶内的相对路径，如 `images/photo.jpg`\n5. **图片处理/智能搜索/文档转换仅方式一可用**，不可用时明确告知用户\n6. **异步任务**（文档转换、视频封面）需通过 `jobId` 轮询结果\n7. **上传后主动获取链接**：上传完成后调用 `getObjectUrl` 或 `sign-url` 返回访问链接\n8. **错误处理**：调用失败时先用 `setup.sh --check-only` 诊断环境问题\n9. **方式二脚本源码**见 `scripts/cos_node.mjs`\n10. **MCP 工具详细参数**见 `references/api_reference.md`\n11. **MCP 配置模板**见 `references/config_template.json`\n\nFile v1.0.5:_meta.json\n\n{\n  \"ownerId\": \"kn75r0rammt45k8qe5we0sh63580c5y0\",\n  \"slug\": \"tencent-cloud-cos\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1772277855760\n}\n\nFile v1.0.5:references/api_reference.md\n\n# 腾讯云 COS 操作参考\n\n本文档记录三种操作方式的详细参数定义，供执行操作时查阅。\n\n**环境设置**：首次使用请运行 `scripts/setup.sh`，详见 `SKILL.md` 首次使用章节。\n\n**官方文档链接：**\n- cos-mcp GitHub: https://github.com/Tencent/cos-mcp\n- COS Node.js SDK: https://www.tencentcloud.com/zh/document/product/436/8629\n- COSCMD 工具: https://www.tencentcloud.com/zh/document/product/436/10976\n\n---\n\n## 方式一：cos-mcp MCP 工具参数参考\n\n## 存储操作工具\n\n### getCosConfig\n获取当前 COS 配置信息。\n- 参数：无\n\n### putObject\n上传本地文件到存储桶。\n- `filePath` (string, **必需**): 本地文件路径（包含文件名）\n- `fileName` (string, 可选): 存储桶中的文件名\n- `targetDir` (string, 可选): 存储桶中的目标目录\n\n### putString\n上传字符串内容到存储桶。\n- `content` (string, **必需**): 要上传的字符串内容\n- `fileName` (string, **必需**): 存储桶中的文件名\n- `targetDir` (string, 可选): 目标目录\n- `contentType` (string, 可选): MIME 类型，默认 `text/plain`\n\n### putBase64\n上传 base64 编码内容到存储桶。\n- `base64Content` (string, **必需**): base64 编码的内容\n- `fileName` (string, **必需**): 存储桶中的文件名\n- `targetDir` (string, 可选): 目标目录\n- `contentType` (string, 可选): MIME 类型，如 `image/png`、`application/pdf`\n\n### putBuffer\n上传 buffer 内容到存储桶。\n- `content` (string, **必需**): buffer 内容字符串\n- `fileName` (string, **必需**): 存储桶中的文件名\n- `targetDir` (string, 可选): 目标目录\n- `contentType` (string, 可选): MIME 类型，默认 `application/octet-stream`\n- `encoding` (string, 可选): 编码格式，枚举值: `hex` | `base64` | `utf8` | `ascii` | `binary`，默认 `utf8`\n\n### putObjectSourceUrl\n通过 URL 下载文件并上传到存储桶。\n- `sourceUrl` (string, **必需**): 可下载的文件 URL\n- `fileName` (string, 可选): 存储桶中的文件名\n- `targetDir` (string, 可选): 目标目录\n\n### getObject\n下载存储桶内的文件。\n- `objectKey` (string, **必需**): 文件在存储桶中的路径\n\n### getBucket\n查询存储桶内的文件列表。\n- `Prefix` (string, 可选): 路径前缀过滤，默认根路径\n\n### getObjectUrl\n获取文件的带签名下载链接。\n- `objectKey` (string, **必需**): 文件在存储桶中的路径\n\n## 图片处理工具\n\n### imageInfo\n获取图片元数据信息。\n- `objectKey` (string, **必需**): 图片在存储桶中的路径\n\n### assessQuality\n评估图片质量分数。\n- `objectKey` (string, **必需**): 图片在存储桶中的路径\n\n### aiSuperResolution\nAI 超分辨率，提升图片分辨率。\n- `objectKey` (string, **必需**): 图片在存储桶中的路径\n\n### aiPicMatting\nAI 智能抠图，去除图片背景。\n- `objectKey` (string, **必需**): 图片在存储桶中的路径\n- `width` (string, 可选): 输出宽度\n- `height` (string, 可选): 输出高度\n\n### aiQrcode\n识别存储桶内图片中的二维码内容。\n- `objectKey` (string, **必需**): COS 对象键完整路径，如 `images/qrcode.jpg`\n\n### waterMarkFont\n生成带文字水印的图片。\n- `objectKey` (string, **必需**): COS 对象键完整路径，如 `images/photo.jpg`\n- `text` (string, 可选): 水印文字内容（支持中文），默认 `test`\n\n## 智能搜索工具\n\n### imageSearchPic\n以图搜图，从数据集中检索相似图片。\n- `uri` (string, **必需**): 图片地址\n\n### imageSearchText\n文本搜图，根据文字描述检索匹配图片。\n- `text` (string, **必需**): 检索文本\n\n## 文档与媒体处理工具\n\n### createDocToPdfJob\n创建文档转 PDF 处理任务。\n- `objectKey` (string, **必需**): 文档在存储桶中的路径\n\n### describeDocProcessJob\n查询文档转码任务结果。\n- `jobId` (string, **必需**): 任务 ID（通过提交文档任务的响应获取）\n\n### createMediaSmartCoverJob\n创建视频智能封面任务。\n- `objectKey` (string, **必需**): 视频在存储桶中的路径\n\n### describeMediaJob\n查询智能封面任务结果。\n- `jobId` (string, **必需**): 任务 ID（通过提交智能封面任务的响应获取）\n\n---\n\n## 方式二：scripts/cos_node.mjs 命令参考\n\n脚本位于 `scripts/cos_node.mjs`，依赖 `cos-nodejs-sdk-v5`（`npm install cos-nodejs-sdk-v5`）。\n所有凭证通过环境变量读取。输出 JSON 格式。\n\n### 可用操作\n\n| 操作 | 命令 | 说明 |\n|------|------|------|\n| upload | `node scripts/cos_node.mjs upload --file <path> --key <key>` | 上传本地文件 |\n| put-string | `node scripts/cos_node.mjs put-string --content <text> --key <key> [--content-type <mime>]` | 上传字符串内容 |\n| download | `node scripts/cos_node.mjs download --key <key> --output <path>` | 下载文件到本地 |\n| list | `node scripts/cos_node.mjs list [--prefix <prefix>] [--max-keys <n>]` | 列出文件 |\n| sign-url | `node scripts/cos_node.mjs sign-url --key <key> [--expires <seconds>]` | 获取签名下载链接 |\n| delete | `node scripts/cos_node.mjs delete --key <key>` | 删除文件 |\n| head | `node scripts/cos_node.mjs head --key <key>` | 查看文件元信息 |\n\n### 返回格式\n\n成功时 `success: true`，退出码 0；失败时 `success: false`，退出码 1。\n\n---\n\n## 方式三：COSCMD 命令参考\n\n依赖 Python，通过 `pip install coscmd` 安装。首次使用需配置（写入 `~/.cos.conf`，后续无需重复）：\n\n```bash\ncoscmd config -a $TENCENT_COS_SECRET_ID -s $TENCENT_COS_SECRET_KEY -b $TENCENT_COS_BUCKET -r $TENCENT_COS_REGION\n```\n\n### 常用命令\n\n| 操作 | 命令 | 说明 |\n|------|------|------|\n| 上传文件 | `coscmd upload <localpath> <cospath>` | 上传单个文件 |\n| 递归上传目录 | `coscmd upload -r <localdir> <cosdir>` | 上传整个目录 |\n| 下载文件 | `coscmd download <cospath> <localpath>` | 下载单个文件 |\n| 递归下载目录 | `coscmd download -r <cosdir> <localdir>` | 下载整个目录 |\n| 列出文件 | `coscmd list [cospath]` | 列出文件，加 `-r` 递归 |\n| 删除文件 | `coscmd delete <cospath>` | 删除单个文件 |\n| 递归删除 | `coscmd delete -r <cosdir> -f` | 强制递归删除 |\n| 签名 URL | `coscmd signurl <cospath> [-t <seconds>]` | 获取带签名的下载链接 |\n| 文件信息 | `coscmd info <cospath>` | 查看文件元信息 |\n| 复制 | `coscmd copy <source> <dest>` | 桶内/跨桶复制 |\n| 移动 | `coscmd move <source> <dest>` | 移动文件（复制+删除源） |\n\n### 全局参数\n\n- `-c <CONFIG_PATH>`：指定配置文件路径（默认 `~/.cos.conf`）\n- `-b <BucketName-APPID>`：指定存储桶（覆盖配置文件）\n- `-r <Region>`：指定区域\n- `-d`：调试模式，输出详细日志\n\nFile v1.0.5:references/config_template.json\n\n{\n  \"_description\": \"cos-mcp MCP 服务器配置模板，添加到客户端的 MCP 配置文件中\",\n\n  \"mcpServers\": {\n    \"cos-mcp\": {\n      \"_comment\": \"方式一：参数直接传入 args\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"cos-mcp\",\n        \"--Region=<替换为存储桶区域，如 ap-guangzhou>\",\n        \"--Bucket=<替换为存储桶名称，格式 name-appid>\",\n        \"--SecretId=<替换为腾讯云 API 密钥 ID>\",\n        \"--SecretKey=<替换为腾讯云 API 密钥 Key>\",\n        \"--DatasetName=<替换为数据万象数据集名称，无则删除此行>\",\n        \"--connectType=stdio\"\n      ]\n    },\n\n    \"cos-mcp-env\": {\n      \"_comment\": \"方式二：通过 env 传递敏感参数（推荐）\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"cos-mcp\",\n        \"--connectType=stdio\"\n      ],\n      \"env\": {\n        \"TENCENT_COS_SECRET_ID\": \"<替换为腾讯云 API 密钥 ID>\",\n        \"TENCENT_COS_SECRET_KEY\": \"<替换为腾讯云 API 密钥 Key>\",\n        \"TENCENT_COS_REGION\": \"<替换为存储桶区域，如 ap-guangzhou>\",\n        \"TENCENT_COS_BUCKET\": \"<替换为存储桶名称，格式 name-appid>\",\n        \"TENCENT_COS_DATASET_NAME\": \"<替换为数据万象数据集名称，无则删除此行>\"\n      }\n    },\n\n    \"cos-mcp-sse\": {\n      \"_comment\": \"方式三：SSE 模式（适合高频调用场景）\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"cos-mcp\",\n        \"--connectType=sse\",\n        \"--port=3001\"\n      ],\n      \"env\": {\n        \"TENCENT_COS_SECRET_ID\": \"<替换为腾讯云 API 密钥 ID>\",\n        \"TENCENT_COS_SECRET_KEY\": \"<替换为腾讯云 API 密钥 Key>\",\n        \"TENCENT_COS_REGION\": \"<替换为存储桶区域，如 ap-guangzhou>\",\n        \"TENCENT_COS_BUCKET\": \"<替换为存储桶名称，格式 name-appid>\"\n      }\n    }\n  },\n\n  \"_参数说明\": {\n    \"Region\": \"存储桶区域，如 ap-guangzhou、ap-shanghai、ap-beijing 等\",\n    \"Bucket\": \"存储桶名称，格式为 name-appid，如 mybucket-1250000000\",\n    \"SecretId\": \"腾讯云 API 密钥 ID，在 访问管理 > API密钥管理 中创建\",\n    \"SecretKey\": \"腾讯云 API 密钥 Key，与 SecretId 配对使用\",\n    \"DatasetName\": \"数据万象数据集名称（仅图片搜索等智能功能需要，无则不填）\",\n    \"connectType\": \"连接模式：stdio（默认，推荐）或 sse\",\n    \"port\": \"SSE 模式下的监听端口（默认 3001）\"\n  }\n}\n\nArchive v1.0.3: 5 files, 10630 bytes\n\nFiles: references/api_reference.md (6675b), references/config_template.json (2403b), scripts/cos_node.mjs (6526b), SKILL.md (12045b), _meta.json (136b)\n\nFile v1.0.3:SKILL.md\n\n---\nname: tencent-cloud-cos\ndescription: >\n  腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件，\n  或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、\n  文档转PDF、视频智能封面生成等操作时使用此技能。\n---\n\n# 腾讯云 COS 技能\n\n集成腾讯云对象存储(COS)和数据万象(CI)的完整能力。提供三种执行方式按优先级降级，确保操作始终可完成：\n\n1. **方式一：cos-mcp MCP 工具**（优先） — 功能最全，支持存储操作 + 图片处理 + 智能搜索 + 文档媒体处理\n2. **方式二：COS Node.js SDK 脚本** — 通过 `scripts/cos_node.mjs` 执行存储操作\n3. **方式三：COSCMD 命令行工具** — 通过 shell 命令执行存储操作\n\n## 执行策略\n\n按以下顺序尝试，遇到失败自动降级到下一种方式：\n\n```\ncos-mcp MCP 工具可用？（先安装再检测）\n  ├─ 是 → 使用方式一（全部功能）\n  └─ 否 → Node.js 可用？（node --version）\n              ├─ 是 → 安装 cos-nodejs-sdk-v5（若未安装）→ 使用方式二（存储操作）\n              └─ 否 → coscmd 命令可用？（which coscmd）\n                        ├─ 是 → 使用方式三（存储操作）\n                        └─ 否 → 提示用户安装任一工具\n```\n\n**判断方式一是否可用**：\n1. 先在当前项目安装 cos-mcp：`npm install cos-mcp`（若无 `package.json` 先 `npm init -y`）\n2. 尝试调用 `getCosConfig` MCP 工具，若工具存在且返回结果则可用\n3. 若 MCP 工具仍不可用（客户端未配置 MCP 服务器），则降级到方式二\n\n**判断方式二是否可用**：执行 `node --version` 确认 Node.js 可用，然后检查 `cos-nodejs-sdk-v5` 是否已安装（`node -e \"require('cos-nodejs-sdk-v5')\"`），若未安装则先执行 `npm install cos-nodejs-sdk-v5` 安装后再使用。\n**判断方式三是否可用**：执行 `which coscmd` 或 `coscmd --version` 有输出则可用。\n\n## 环境配置\n\n三种方式均需要以下腾讯云凭证：\n\n| 参数 | 说明 | 示例 |\n|------|------|------|\n| SecretId | API 密钥 ID | `AKIDxxxxxxxx` |\n| SecretKey | API 密钥 Key | `xxxxxxxx` |\n| Region | 存储桶区域 | `ap-guangzhou` |\n| Bucket | 存储桶名称 | `mybucket-1250000000` |\n| DatasetName | 数据万象数据集名称（仅智能搜索需要） | `my-dataset` |\n\n### 凭证持久化\n\n各方式的凭证存储位置不同，**配置一次后重启会话无需重新设置**：\n\n| 方式 | 持久化位置 | 说明 |\n|------|-----------|------|\n| 方式一 cos-mcp | 客户端 MCP 配置文件 | 写入后由客户端自动加载，无需重复配置 |\n| 方式二 Node SDK | shell 配置文件（`~/.zshrc` 或 `~/.bashrc`） | 需将环境变量写入 shell 配置文件 |\n| 方式三 COSCMD | `~/.cos.conf` | `coscmd config` 自动写入，后续直接可用 |\n\n**方式二环境变量持久化**：首次配置时将凭证写入 shell 配置文件：\n\n```bash\ncat >> ~/.zshrc << 'EOF'\nexport TENCENT_COS_SECRET_ID=\"<替换为 API 密钥 ID>\"\nexport TENCENT_COS_SECRET_KEY=\"<替换为 API 密钥 Key>\"\nexport TENCENT_COS_REGION=\"<替换为存储桶区域>\"\nexport TENCENT_COS_BUCKET=\"<替换为存储桶名称>\"\nEOF\nsource ~/.zshrc\n```\n\n若使用 bash，将 `~/.zshrc` 替换为 `~/.bashrc`。\n\n> 密钥信息不要在对话中明文展示，引导用户自行编辑配置文件设置。\n\n---\n\n## 方式一：cos-mcp MCP 工具（优先）\n\n> GitHub: https://github.com/Tencent/cos-mcp\n\n### 安装配置\n\n#### 1. 安装 cos-mcp 到当前项目\n\n```bash\nnpm install cos-mcp\n```\n\n若当前目录无 `package.json`，先执行 `npm init -y`。\n\n#### 2. 在客户端 MCP 配置中注册\n\n在客户端（Claude Desktop、CodeBuddy 等）的 MCP 配置文件中注册：\n\n```json\n{\n  \"mcpServers\": {\n    \"cos-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"cos-mcp\", \"--connectType=stdio\"],\n      \"env\": {\n        \"TENCENT_COS_SECRET_ID\": \"<SecretId>\",\n        \"TENCENT_COS_SECRET_KEY\": \"<SecretKey>\",\n        \"TENCENT_COS_REGION\": \"<Region>\",\n        \"TENCENT_COS_BUCKET\": \"<Bucket>\"\n      }\n    }\n  }\n}\n```\n\n完整配置模板见 `references/config_template.json`。\n\n### 存储操作工具\n\n| 工具 | 用途 | 必需参数 | 可选参数 |\n|------|------|----------|----------|\n| `getCosConfig` | 获取当前配置信息 | 无 | 无 |\n| `putObject` | 上传本地文件 | `filePath` | `fileName`, `targetDir` |\n| `putString` | 上传字符串内容 | `content`, `fileName` | `targetDir`, `contentType` |\n| `putBase64` | 上传 base64 内容 | `base64Content`, `fileName` | `targetDir`, `contentType` |\n| `putBuffer` | 上传 buffer 内容 | `content`, `fileName` | `targetDir`, `contentType`, `encoding` |\n| `putObjectSourceUrl` | 通过 URL 上传 | `sourceUrl` | `fileName`, `targetDir` |\n| `getObject` | 下载文件 | `objectKey` | 无 |\n| `getBucket` | 列出文件 | 无 | `Prefix` |\n| `getObjectUrl` | 获取签名下载链接 | `objectKey` | 无 |\n\n### 图片处理工具（数据万象 CI）\n\n| 工具 | 用途 | 必需参数 | 可选参数 |\n|------|------|----------|----------|\n| `imageInfo` | 获取图片元信息 | `objectKey` | 无 |\n| `assessQuality` | 图片质量评估 | `objectKey` | 无 |\n| `aiSuperResolution` | AI 超分辨率 | `objectKey` | 无 |\n| `aiPicMatting` | AI 智能抠图 | `objectKey` | `width`, `height` |\n| `aiQrcode` | 二维码识别 | `objectKey` | 无 |\n| `waterMarkFont` | 添加文字水印 | `objectKey` | `text` |\n\n### 智能搜索工具\n\n需要预先在数据万象控制台创建数据集。\n\n| 工具 | 用途 | 必需参数 |\n|------|------|----------|\n| `imageSearchPic` | 以图搜图 | `uri` |\n| `imageSearchText` | 文本搜图 | `text` |\n\n### 文档与媒体处理工具\n\n| 工具 | 用途 | 必需参数 |\n|------|------|----------|\n| `createDocToPdfJob` | 文档转 PDF | `objectKey` |\n| `describeDocProcessJob` | 查询文档任务结果 | `jobId` |\n| `createMediaSmartCoverJob` | 视频智能封面 | `objectKey` |\n| `describeMediaJob` | 查询媒体任务结果 | `jobId` |\n\n---\n\n## 方式二：COS Node.js SDK 脚本\n\n> 官方文档: https://www.tencentcloud.com/zh/document/product/436/8629\n\n当 cos-mcp MCP 工具不可用时，使用 `scripts/cos_node.mjs` 脚本通过 `cos-nodejs-sdk-v5` SDK 执行存储操作。\n\n### 安装依赖\n\n使用方式二前需确保 `cos-nodejs-sdk-v5` 已安装。执行检查和安装：\n\n```bash\n# 检查是否已安装\nnode -e \"require('cos-nodejs-sdk-v5')\" 2>/dev/null || npm install cos-nodejs-sdk-v5\n```\n\n若在用户项目中操作，建议安装到项目目录；若无 `package.json`，先 `npm init -y` 再安装。\n\n### 使用方式\n\n通过 `node scripts/cos_node.mjs <action> [参数]` 执行，脚本从环境变量读取凭证。\n\n#### 上传文件\n\n```bash\nnode scripts/cos_node.mjs upload --file /path/to/local/file.jpg --key remote/path/file.jpg\n```\n\n#### 上传字符串内容\n\n```bash\nnode scripts/cos_node.mjs put-string --content \"文本内容\" --key remote/path/file.txt --content-type \"text/plain\"\n```\n\n#### 下载文件\n\n```bash\nnode scripts/cos_node.mjs download --key remote/path/file.jpg --output /path/to/save/file.jpg\n```\n\n#### 列出文件\n\n```bash\nnode scripts/cos_node.mjs list --prefix \"images/\"\n```\n\n#### 获取签名 URL\n\n```bash\nnode scripts/cos_node.mjs sign-url --key remote/path/file.jpg --expires 3600\n```\n\n#### 删除文件\n\n```bash\nnode scripts/cos_node.mjs delete --key remote/path/file.jpg\n```\n\n#### 查看文件信息\n\n```bash\nnode scripts/cos_node.mjs head --key remote/path/file.jpg\n```\n\n所有命令输出 JSON 格式结果，可通过 `$?` 判断成功（0）或失败（非0）。\n\n### 限制\n\n方式二仅支持存储操作（上传、下载、列表、删除、签名URL），**不支持**图片处理、智能搜索、文档转换等数据万象功能。\n\n---\n\n## 方式三：COSCMD 命令行工具\n\n> 官方文档: https://www.tencentcloud.com/zh/document/product/436/10976\n\n当方式一和方式二均不可用时，使用 COSCMD Python 命令行工具。\n\n### 安装配置\n\n```bash\npip install coscmd\ncoscmd config -a $TENCENT_COS_SECRET_ID -s $TENCENT_COS_SECRET_KEY -b $TENCENT_COS_BUCKET -r $TENCENT_COS_REGION\n```\n\n配置写入 `~/.cos.conf`，后续使用无需重复配置。\n\n### 常用命令\n\n#### 上传\n\n```bash\n# 上传单个文件\ncoscmd upload /path/to/file.jpg remote/path/file.jpg\n\n# 递归上传目录\ncoscmd upload -r /path/to/folder/ remote/folder/\n```\n\n#### 下载\n\n```bash\n# 下载单个文件\ncoscmd download remote/path/file.jpg /path/to/save/file.jpg\n\n# 递归下载目录\ncoscmd download -r remote/folder/ /path/to/save/\n```\n\n#### 列出文件\n\n```bash\n# 列出指定前缀下的文件\ncoscmd list images/\n\n# 递归列出并统计\ncoscmd list -r images/\n```\n\n#### 删除\n\n```bash\n# 删除单个文件\ncoscmd delete remote/path/file.jpg\n\n# 递归删除目录\ncoscmd delete -r remote/folder/ -f\n```\n\n#### 获取签名 URL\n\n```bash\n# 获取有效期 3600 秒的下载链接\ncoscmd signurl remote/path/file.jpg -t 3600\n```\n\n#### 查看文件信息\n\n```bash\ncoscmd info remote/path/file.jpg\n```\n\n#### 复制/移动\n\n```bash\n# 桶内复制\ncoscmd copy <BucketName-APPID>.cos.<Region>.myqcloud.com/source.jpg dest.jpg\n\n# 移动（复制后删除源文件）\ncoscmd move <BucketName-APPID>.cos.<Region>.myqcloud.com/source.jpg dest.jpg\n```\n\n### 限制\n\n方式三仅支持存储操作，**不支持**图片处理、智能搜索、文档转换等数据万象功能。\n\n---\n\n## 功能对照表\n\n| 功能 | 方式一 cos-mcp | 方式二 Node SDK | 方式三 COSCMD |\n|------|:-:|:-:|:-:|\n| 上传文件 | ✅ | ✅ | ✅ |\n| 上传字符串/Base64 | ✅ | ✅ | ❌ |\n| 通过 URL 上传 | ✅ | ❌ | ❌ |\n| 下载文件 | ✅ | ✅ | ✅ |\n| 列出文件 | ✅ | ✅ | ✅ |\n| 获取签名 URL | ✅ | ✅ | ✅ |\n| 删除文件 | ❌ | ✅ | ✅ |\n| 查看文件信息 | ❌ | ✅ | ✅ |\n| 递归上传/下载目录 | ❌ | ❌ | ✅ |\n| 图片处理（CI） | ✅ | ❌ | ❌ |\n| 智能搜索 | ✅ | ❌ | ❌ |\n| 文档转 PDF | ✅ | ❌ | ❌ |\n| 视频智能封面 | ✅ | ❌ | ❌ |\n\n## 工作流程\n\n### 文件上传\n\n1. 按执行策略确定可用方式\n2. 确认本地文件路径存在\n3. 执行上传：\n   - 方式一：调用 `putObject`，上传后调用 `getObjectUrl` 获取链接\n   - 方式二：`node scripts/cos_node.mjs upload --file <path> --key <key>`，再 `sign-url` 获取链接\n   - 方式三：`coscmd upload <localpath> <cospath>`，再 `coscmd signurl <cospath>` 获取链接\n4. 返回访问链接给用户\n\n### 文件下载\n\n1. 按执行策略确定可用方式\n2. 执行下载：\n   - 方式一：调用 `getObject`\n   - 方式二：`node scripts/cos_node.mjs download --key <key> --output <path>`\n   - 方式三：`coscmd download <cospath> <localpath>`\n3. 返回本地文件路径\n\n### 图片处理（仅方式一）\n\n1. 确认目标图片已在存储桶中（必要时先上传）\n2. 调用对应图片处理工具\n3. 若方式一不可用，提示用户：图片处理功能需要 cos-mcp MCP 工具支持\n\n### 文档转换（仅方式一）\n\n1. 确认文档已在存储桶中\n2. 调用 `createDocToPdfJob` 创建任务\n3. 使用 `describeDocProcessJob` 轮询结果\n4. 若方式一不可用，提示用户：文档转换功能需要 cos-mcp MCP 工具支持\n\n## 注意事项\n\n- 所有文件路径（`objectKey`/`cospath`/`--key`）均为存储桶内的相对路径，如 `images/photo.jpg`\n- 图片处理、智能搜索、文档转换等数据万象功能**仅方式一可用**，方式二和方式三仅覆盖基础存储操作\n- 智能搜索需预先创建数据集并建立索引\n- 文档转换和视频封面为异步任务，需通过 `jobId` 轮询结果\n- 上传时如未指定目标文件名，默认使用原始文件名\n- 方式二脚本源码见 `scripts/cos_node.mjs`\n- MCP 工具详细参数参考见 `references/api_reference.md`\n- MCP 配置模板见 `references/config_template.json`\n\nFile v1.0.3:_meta.json\n\n{\n  \"ownerId\": \"kn75r0rammt45k8qe5we0sh63580c5y0\",\n  \"slug\": \"tencent-cloud-cos\",\n  \"version\": \"1.0.3\",\n  \"publishedAt\": 1772272691108\n}\n\nFile v1.0.3:references/api_reference.md\n\n# 腾讯云 COS 操作参考\n\n本文档记录三种操作方式的详细参数定义，供执行操作时查阅。\n\n**官方文档链接：**\n- cos-mcp GitHub: https://github.com/Tencent/cos-mcp\n- COS Node.js SDK: https://www.tencentcloud.com/zh/document/product/436/8629\n- COSCMD 工具: https://www.tencentcloud.com/zh/document/product/436/10976\n\n---\n\n## 方式一：cos-mcp MCP 工具参数参考\n\n## 存储操作工具\n\n### getCosConfig\n获取当前 COS 配置信息。\n- 参数：无\n\n### putObject\n上传本地文件到存储桶。\n- `filePath` (string, **必需**): 本地文件路径（包含文件名）\n- `fileName` (string, 可选): 存储桶中的文件名\n- `targetDir` (string, 可选): 存储桶中的目标目录\n\n### putString\n上传字符串内容到存储桶。\n- `content` (string, **必需**): 要上传的字符串内容\n- `fileName` (string, **必需**): 存储桶中的文件名\n- `targetDir` (string, 可选): 目标目录\n- `contentType` (string, 可选): MIME 类型，默认 `text/plain`\n\n### putBase64\n上传 base64 编码内容到存储桶。\n- `base64Content` (string, **必需**): base64 编码的内容\n- `fileName` (string, **必需**): 存储桶中的文件名\n- `targetDir` (string, 可选): 目标目录\n- `contentType` (string, 可选): MIME 类型，如 `image/png`、`application/pdf`\n\n### putBuffer\n上传 buffer 内容到存储桶。\n- `content` (string, **必需**): buffer 内容字符串\n- `fileName` (string, **必需**): 存储桶中的文件名\n- `targetDir` (string, 可选): 目标目录\n- `contentType` (string, 可选): MIME 类型，默认 `application/octet-stream`\n- `encoding` (string, 可选): 编码格式，枚举值: `hex` | `base64` | `utf8` | `ascii` | `binary`，默认 `utf8`\n\n### putObjectSourceUrl\n通过 URL 下载文件并上传到存储桶。\n- `sourceUrl` (string, **必需**): 可下载的文件 URL\n- `fileName` (string, 可选): 存储桶中的文件名\n- `targetDir` (string, 可选): 目标目录\n\n### getObject\n下载存储桶内的文件。\n- `objectKey` (string, **必需**): 文件在存储桶中的路径\n\n### getBucket\n查询存储桶内的文件列表。\n- `Prefix` (string, 可选): 路径前缀过滤，默认根路径\n\n### getObjectUrl\n获取文件的带签名下载链接。\n- `objectKey` (string, **必需**): 文件在存储桶中的路径\n\n## 图片处理工具\n\n### imageInfo\n获取图片元数据信息。\n- `objectKey` (string, **必需**): 图片在存储桶中的路径\n\n### assessQuality\n评估图片质量分数。\n- `objectKey` (string, **必需**): 图片在存储桶中的路径\n\n### aiSuperResolution\nAI 超分辨率，提升图片分辨率。\n- `objectKey` (string, **必需**): 图片在存储桶中的路径\n\n### aiPicMatting\nAI 智能抠图，去除图片背景。\n- `objectKey` (string, **必需**): 图片在存储桶中的路径\n- `width` (string, 可选): 输出宽度\n- `height` (string, 可选): 输出高度\n\n### aiQrcode\n识别存储桶内图片中的二维码内容。\n- `objectKey` (string, **必需**): COS 对象键完整路径，如 `images/qrcode.jpg`\n\n### waterMarkFont\n生成带文字水印的图片。\n- `objectKey` (string, **必需**): COS 对象键完整路径，如 `images/photo.jpg`\n- `text` (string, 可选): 水印文字内容（支持中文），默认 `test`\n\n## 智能搜索工具\n\n### imageSearchPic\n以图搜图，从数据集中检索相似图片。\n- `uri` (string, **必需**): 图片地址\n\n### imageSearchText\n文本搜图，根据文字描述检索匹配图片。\n- `text` (string, **必需**): 检索文本\n\n## 文档与媒体处理工具\n\n### createDocToPdfJob\n创建文档转 PDF 处理任务。\n- `objectKey` (string, **必需**): 文档在存储桶中的路径\n\n### describeDocProcessJob\n查询文档转码任务结果。\n- `jobId` (string, **必需**): 任务 ID（通过提交文档任务的响应获取）\n\n### createMediaSmartCoverJob\n创建视频智能封面任务。\n- `objectKey` (string, **必需**): 视频在存储桶中的路径\n\n### describeMediaJob\n查询智能封面任务结果。\n- `jobId` (string, **必需**): 任务 ID（通过提交智能封面任务的响应获取）\n\n---\n\n## 方式二：scripts/cos_node.mjs 命令参考\n\n脚本位于 `scripts/cos_node.mjs`，依赖 `cos-nodejs-sdk-v5`（`npm install cos-nodejs-sdk-v5`）。\n所有凭证通过环境变量读取。输出 JSON 格式。\n\n### 可用操作\n\n| 操作 | 命令 | 说明 |\n|------|------|------|\n| upload | `node scripts/cos_node.mjs upload --file <path> --key <key>` | 上传本地文件 |\n| put-string | `node scripts/cos_node.mjs put-string --content <text> --key <key> [--content-type <mime>]` | 上传字符串内容 |\n| download | `node scripts/cos_node.mjs download --key <key> --output <path>` | 下载文件到本地 |\n| list | `node scripts/cos_node.mjs list [--prefix <prefix>] [--max-keys <n>]` | 列出文件 |\n| sign-url | `node scripts/cos_node.mjs sign-url --key <key> [--expires <seconds>]` | 获取签名下载链接 |\n| delete | `node scripts/cos_node.mjs delete --key <key>` | 删除文件 |\n| head | `node scripts/cos_node.mjs head --key <key>` | 查看文件元信息 |\n\n### 返回格式\n\n成功时 `success: true`，退出码 0；失败时 `success: false`，退出码 1。\n\n---\n\n## 方式三：COSCMD 命令参考\n\n依赖 Python，通过 `pip install coscmd` 安装。首次使用需配置（写入 `~/.cos.conf`，后续无需重复）：\n\n```bash\ncoscmd config -a $TENCENT_COS_SECRET_ID -s $TENCENT_COS_SECRET_KEY -b $TENCENT_COS_BUCKET -r $TENCENT_COS_REGION\n```\n\n### 常用命令\n\n| 操作 | 命令 | 说明 |\n|------|------|------|\n| 上传文件 | `coscmd upload <localpath> <cospath>` | 上传单个文件 |\n| 递归上传目录 | `coscmd upload -r <localdir> <cosdir>` | 上传整个目录 |\n| 下载文件 | `coscmd download <cospath> <localpath>` | 下载单个文件 |\n| 递归下载目录 | `coscmd download -r <cosdir> <localdir>` | 下载整个目录 |\n| 列出文件 | `coscmd list [cospath]` | 列出文件，加 `-r` 递归 |\n| 删除文件 | `coscmd delete <cospath>` | 删除单个文件 |\n| 递归删除 | `coscmd delete -r <cosdir> -f` | 强制递归删除 |\n| 签名 URL | `coscmd signurl <cospath> [-t <seconds>]` | 获取带签名的下载链接 |\n| 文件信息 | `coscmd info <cospath>` | 查看文件元信息 |\n| 复制 | `coscmd copy <source> <dest>` | 桶内/跨桶复制 |\n| 移动 | `coscmd move <source> <dest>` | 移动文件（复制+删除源） |\n\n### 全局参数\n\n- `-c <CONFIG_PATH>`：指定配置文件路径（默认 `~/.cos.conf`）\n- `-b <BucketName-APPID>`：指定存储桶（覆盖配置文件）\n- `-r <Region>`：指定区域\n- `-d`：调试模式，输出详细日志\n\nFile v1.0.3:references/config_template.json\n\n{\n  \"_description\": \"cos-mcp MCP 服务器配置模板，添加到客户端的 MCP 配置文件中\",\n\n  \"mcpServers\": {\n    \"cos-mcp\": {\n      \"_comment\": \"方式一：参数直接传入 args\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"cos-mcp\",\n        \"--Region=<替换为存储桶区域，如 ap-guangzhou>\",\n        \"--Bucket=<替换为存储桶名称，格式 name-appid>\",\n        \"--SecretId=<替换为腾讯云 API 密钥 ID>\",\n        \"--SecretKey=<替换为腾讯云 API 密钥 Key>\",\n        \"--DatasetName=<替换为数据万象数据集名称，无则删除此行>\",\n        \"--connectType=stdio\"\n      ]\n    },\n\n    \"cos-mcp-env\": {\n      \"_comment\": \"方式二：通过 env 传递敏感参数（推荐）\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"cos-mcp\",\n        \"--connectType=stdio\"\n      ],\n      \"env\": {\n        \"TENCENT_COS_SECRET_ID\": \"<替换为腾讯云 API 密钥 ID>\",\n        \"TENCENT_COS_SECRET_KEY\": \"<替换为腾讯云 API 密钥 Key>\",\n        \"TENCENT_COS_REGION\": \"<替换为存储桶区域，如 ap-guangzhou>\",\n        \"TENCENT_COS_BUCKET\": \"<替换为存储桶名称，格式 name-appid>\",\n        \"TENCENT_COS_DATASET_NAME\": \"<替换为数据万象数据集名称，无则删除此行>\"\n      }\n    },\n\n    \"cos-mcp-sse\": {\n      \"_comment\": \"方式三：SSE 模式（适合高频调用场景）\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"cos-mcp\",\n        \"--connectType=sse\",\n        \"--port=3001\"\n      ],\n      \"env\": {\n        \"TENCENT_COS_SECRET_ID\": \"<替换为腾讯云 API 密钥 ID>\",\n        \"TENCENT_COS_SECRET_KEY\": \"<替换为腾讯云 API 密钥 Key>\",\n        \"TENCENT_COS_REGION\": \"<替换为存储桶区域，如 ap-guangzhou>\",\n        \"TENCENT_COS_BUCKET\": \"<替换为存储桶名称，格式 name-appid>\"\n      }\n    }\n  },\n\n  \"_参数说明\": {\n    \"Region\": \"存储桶区域，如 ap-guangzhou、ap-shanghai、ap-beijing 等\",\n    \"Bucket\": \"存储桶名称，格式为 name-appid，如 mybucket-1250000000\",\n    \"SecretId\": \"腾讯云 API 密钥 ID，在 访问管理 > API密钥管理 中创建\",\n    \"SecretKey\": \"腾讯云 API 密钥 Key，与 SecretId 配对使用\",\n    \"DatasetName\": \"数据万象数据集名称（仅图片搜索等智能功能需要，无则不填）\",\n    \"connectType\": \"连接模式：stdio（默认，推荐）或 sse\",\n    \"port\": \"SSE 模式下的监听端口（默认 3001）\"\n  }\n}","readmeExcerpt":"Skill: 腾讯云COS存储 Owner: ShawnMinh Summary: 腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件， 或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、 文档转PDF、视频智能封面生成等操作时使用此技能。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-02-28T11:24:15.760Z | user Version 1.0.5 - Added scripts/setup.sh for automated environment and credential setup. - SKILL.md updated with step-by-step first-time setup instructions using setup.sh. - Setup process no","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"{baseDir}/scripts/setup.sh --check-only"},{"language":"bash","snippet":"{baseDir}/scripts/setup.sh --secret-id \"<SecretId>\" --secret-key \"<SecretKey>\" --region \"<Region>\" --bucket \"<Bucket>\""},{"language":"bash","snippet":"{baseDir}/scripts/setup.sh --secret-id \"<SecretId>\" --secret-key \"<SecretKey>\" --region \"<Region>\" --bucket \"<Bucket>\" --dataset \"<DatasetName>\""},{"language":"text","snippet":"mcporter + cos-mcp 可用？（which mcporter && 配置存在）\n  ├─ 是 → 使用方式一 mcporter 调用（全部功能）\n  └─ 否 → cos-mcp MCP 工具可直接调用？（getCosConfig 返回结果）\n              ├─ 是 → 使用方式一直接调用（全部功能）\n              └─ 否 → Node.js + cos-nodejs-sdk-v5 可用？\n                        ├─ 是 → 使用方式二（存储操作）\n                        └─ 否 → coscmd 可用？（which coscmd）\n                                  ├─ 是 → 使用方式三（存储操作）\n                                  └─ 否 → 运行 setup.sh 安装"},{"language":"text","snippet":"mcporter call cos-mcp.<tool_name> --config ~/.mcporter/mcporter.json --output json [--args '<JSON>']"},{"language":"text","snippet":"mcporter list cos-mcp --config ~/.mcporter/mcporter.json --schema"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: tencent-cloud-cos\ndescription: >\n  腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件，\n  或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、\n  文档转PDF、视频智能封面生成等操作时使用此技能。\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"☁️\",\n        \"requires\": {},\n        \"install\":\n          [\n            {\n              \"id\": \"node-mcporter\",\n              \"kind\": \"node\",\n              \"package\": \"mcporter\",\n              \"bins\": [\"mcporter\"],\n              \"label\": \"Install mcporter (MCP CLI)\",\n            },\n            {\n              \"id\": \"node-cos-mcp\",\n              \"kind\": \"node\",\n              \"package\": \"cos-mcp\",\n              \"bins\": [\"cos-mcp\"],\n              \"label\": \"Install cos-mcp (COS MCP Server)\",\n            },\n            {\n              \"id\": \"node-cos-sdk\",\n              \"kind\": \"node\",\n              \"package\": \"cos-nodejs-sdk-v5\",\n              \"label\": \"Install COS Node.js SDK\",\n            },\n          ],\n      },\n  }\n---\n\n# 腾讯云 COS 技能\n\n通过 cos-mcp MCP 工具 + Node.js SDK 脚本 + COSCMD 管理腾讯云对象存储和数据万象。\n\n## 首次使用 — 自动设置\n\n当用户首次要求操作 COS 时，按以下流程操作：\n\n### 步骤 1：检查当前状态\n\n```bash\n{baseDir}/scripts/setup.sh --check-only\n```\n\n如果输出显示一切 OK（cos-mcp 已安装、凭证已配置），跳到「执行策略」。\n\n### 步骤 2：如果未配置，引导用户提供凭证\n\n告诉用户：\n> 我需要你的腾讯云凭证来连接 COS 存储服务。请提供：\n> 1. **SecretId** — 腾讯云 API 密钥 ID\n> 2. **SecretKey** — 腾讯云 API 密钥 Key\n> 3. **Region** — 存储桶区域（如 ap-guangzhou）\n> 4. **Bucket** — 存储桶名称（格式 name-appid，如 mybucket-1250000000）\n> 5. **DatasetName**（可选） — 数据万象数据集名称（仅智能搜索需要）\n>\n> 你可以在 [腾讯云控制台 > 访问管理 > API密钥管理](https://console.cloud.tencent.com/cam/capi) 获取密钥，\n> 在 [COS 控制台](https://console.cloud.tencent.com/cos/bucket) 查看存储桶信息。\n\n### 步骤 3：用户提供凭证后，运行自动设置\n\n```bash\n{baseDir}/scripts/setup.sh --secret-id \"<SecretId>\" --secret-key \"<SecretKey>\" --region \"<Region>\" --bucket \"<Bucket>\"\n```\n\n如有 DatasetName：\n```bash\n{baseDir}/scripts/setup.sh --secret-id \"<SecretId>\" --secret-key \"<SecretKey>\" --region \"<Region>\" --bucket \"<Bucket>\" --dataset \"<DatasetName>\"\n```\n\n脚本会自动：\n- 检查并安装 mcporter（MCP 命令行工具）\n- 检查并安装 cos-mcp 和 cos-nodejs-sdk-v5\n- 创建/更新 `~/.mcporter/mcporter.json`，写入 cos-mcp 服务器配置\n- 将凭证写入 shell 配置文件（`~/.zshrc` 或 `~/.bashrc`），重启后仍可用\n- 配置 coscmd（如有 Python 环境）\n- 验证 COS 连接\n\n设置完成后即可开始使用。\n\n## 执行策略\n\n三种方式按优先级降级，确保操作始终可完成：\n\n1. **方式一：cos-mcp MCP 工具**（优先） — 功能最全，支持存储 + 图片处理 + 智能搜索 + 文档媒体处理\n2. **方式二：Node.js SDK 脚本** — 通过 `scripts/cos_node.mjs` 执行存储操作\n3. **方式三：COSCMD 命令行** — 通过 shell 命令执行存储操作\n\n```\nmcporter + cos-mcp 可用？（which mcporter && 配置存在）\n  ├─ 是 → 使用方式一 mcporter 调用（全部功能）\n  └─ 否 → cos-mcp MCP 工具可直接调用？（getCosConfig 返回结果）\n              ├─ 是 → 使用方式一直接调用（全部功能）\n              └─ 否 → Node.js + cos-nodejs-sdk-v5 可用？\n                        ├─ 是 → 使用方式二（存储操作）\n                        └─ 否 → coscmd 可用？（which coscmd）\n                                  ├─ 是 → 使用方式三（存储操作）\n                                  └─ 否 → 运行 setup.sh 安装\n```\n\n**判断方式一(mcporter)**：`which mcporter` 且 `cat ~/.mcporter/mcporter.json | grep cos-mcp` 有输出。\n**判断方式一(直接)**：尝试调用 `getCosConfig` MCP 工具，若返回结果则可用。\n**判断方式二**：`node -e \"require('cos-nodejs-sdk-v5')\"` 成"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn75r0rammt45k8qe5we0sh63580c5y0\",\n  \"slug\": \"tencent-cloud-cos\",\n  \"version\": \"1.0.5\",\n  \"publishedAt\": 1772277855760\n}"},{"path":"references/api_reference.md","content":"# 腾讯云 COS 操作参考\n\n本文档记录三种操作方式的详细参数定义，供执行操作时查阅。\n\n**环境设置**：首次使用请运行 `scripts/setup.sh`，详见 `SKILL.md` 首次使用章节。\n\n**官方文档链接：**\n- cos-mcp GitHub: https://github.com/Tencent/cos-mcp\n- COS Node.js SDK: https://www.tencentcloud.com/zh/document/product/436/8629\n- COSCMD 工具: https://www.tencentcloud.com/zh/document/product/436/10976\n\n---\n\n## 方式一：cos-mcp MCP 工具参数参考\n\n## 存储操作工具\n\n### getCosConfig\n获取当前 COS 配置信息。\n- 参数：无\n\n### putObject\n上传本地文件到存储桶。\n- `filePath` (string, **必需**): 本地文件路径（包含文件名）\n- `fileName` (string, 可选): 存储桶中的文件名\n- `targetDir` (string, 可选): 存储桶中的目标目录\n\n### putString\n上传字符串内容到存储桶。\n- `content` (string, **必需**): 要上传的字符串内容\n- `fileName` (string, **必需**): 存储桶中的文件名\n- `targetDir` (string, 可选): 目标目录\n- `contentType` (string, 可选): MIME 类型，默认 `text/plain`\n\n### putBase64\n上传 base64 编码内容到存储桶。\n- `base64Content` (string, **必需**): base64 编码的内容\n- `fileName` (string, **必需**): 存储桶中的文件名\n- `targetDir` (string, 可选): 目标目录\n- `contentType` (string, 可选): MIME 类型，如 `image/png`、`application/pdf`\n\n### putBuffer\n上传 buffer 内容到存储桶。\n- `content` (string, **必需**): buffer 内容字符串\n- `fileName` (string, **必需**): 存储桶中的文件名\n- `targetDir` (string, 可选): 目标目录\n- `contentType` (string, 可选): MIME 类型，默认 `application/octet-stream`\n- `encoding` (string, 可选): 编码格式，枚举值: `hex` | `base64` | `utf8` | `ascii` | `binary`，默认 `utf8`\n\n### putObjectSourceUrl\n通过 URL 下载文件并上传到存储桶。\n- `sourceUrl` (string, **必需**): 可下载的文件 URL\n- `fileName` (string, 可选): 存储桶中的文件名\n- `targetDir` (string, 可选): 目标目录\n\n### getObject\n下载存储桶内的文件。\n- `objectKey` (string, **必需**): 文件在存储桶中的路径\n\n### getBucket\n查询存储桶内的文件列表。\n- `Prefix` (string, 可选): 路径前缀过滤，默认根路径\n\n### getObjectUrl\n获取文件的带签名下载链接。\n- `objectKey` (string, **必需**): 文件在存储桶中的路径\n\n## 图片处理工具\n\n### imageInfo\n获取图片元数据信息。\n- `objectKey` (string, **必需**): 图片在存储桶中的路径\n\n### assessQuality\n评估图片质量分数。\n- `objectKey` (string, **必需**): 图片在存储桶中的路径\n\n### aiSuperResolution\nAI 超分辨率，提升图片分辨率。\n- `objectKey` (string, **必需**): 图片在存储桶中的路径\n\n### aiPicMatting\nAI 智能抠图，去除图片背景。\n- `objectKey` (string, **必需**): 图片在存储桶中的路径\n- `width` (string, 可选): 输出宽度\n- `height` (string, 可选): 输出高度\n\n### aiQrcode\n识别存储桶内图片中的二维码内容。\n- `objectKey` (string, **必需**): COS 对象键完整路径，如 `images/qrcode.jpg`\n\n### waterMarkFont\n生成带文字水印的图片。\n- `objectKey` (string, **必需**): COS 对象键完整路径，如 `images/photo.jpg`\n- `text` (string, 可选): 水印文字内容（支持中文），默认 `test`\n\n## 智能搜索工具\n\n### imageSearchPic\n以图搜图，从数据集中检索相似图片。\n- `uri` (string, **必需**): 图片地址\n\n### imageSearchText\n文本搜图，根据文字描述检索匹配图片。\n- `text` (string, **必需**): 检索文本\n\n## 文档与媒体处理工具\n\n### createDocToPdfJob\n创建文档转 PDF 处理任务。\n- `objectKey` (string, **必需**): 文档在存储桶中的路径\n\n### describeDocProcessJob\n查询文档转码任务结果。\n- `jobId` (string, **必需**): 任务 ID（通过提交文档任务的响应获取）\n\n### createMediaSmartCoverJob\n创建视频智能封面任务。\n- `objectKey` (string, **必需**): 视频在存储桶中的路径\n\n### describeMediaJob\n查询智能封面任务结果。\n- `jobId` (string, **必需**): 任务 ID（通过提交智能封面任务的响应获取）\n\n---\n\n## 方式二：scripts/cos_node.mjs 命令参考\n\n脚本位于 `scripts/cos_node.mjs`，依赖 `cos-nodejs-sdk-v5`（`npm install cos-nodejs-sdk-v5`）。\n所有凭证通过环境变量读取。输出 JSON 格式。\n\n### 可用操作\n\n| 操作 | 命令 | 说明 |\n|------|------|------|\n| upload | `node scripts/cos_node.mj"},{"path":"references/config_template.json","content":"{\n  \"_description\": \"cos-mcp MCP 服务器配置模板，添加到客户端的 MCP 配置文件中\",\n\n  \"mcpServers\": {\n    \"cos-mcp\": {\n      \"_comment\": \"方式一：参数直接传入 args\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"cos-mcp\",\n        \"--Region=<替换为存储桶区域，如 ap-guangzhou>\",\n        \"--Bucket=<替换为存储桶名称，格式 name-appid>\",\n        \"--SecretId=<替换为腾讯云 API 密钥 ID>\",\n        \"--SecretKey=<替换为腾讯云 API 密钥 Key>\",\n        \"--DatasetName=<替换为数据万象数据集名称，无则删除此行>\",\n        \"--connectType=stdio\"\n      ]\n    },\n\n    \"cos-mcp-env\": {\n      \"_comment\": \"方式二：通过 env 传递敏感参数（推荐）\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"cos-mcp\",\n        \"--connectType=stdio\"\n      ],\n      \"env\": {\n        \"TENCENT_COS_SECRET_ID\": \"<替换为腾讯云 API 密钥 ID>\",\n        \"TENCENT_COS_SECRET_KEY\": \"<替换为腾讯云 API 密钥 Key>\",\n        \"TENCENT_COS_REGION\": \"<替换为存储桶区域，如 ap-guangzhou>\",\n        \"TENCENT_COS_BUCKET\": \"<替换为存储桶名称，格式 name-appid>\",\n        \"TENCENT_COS_DATASET_NAME\": \"<替换为数据万象数据集名称，无则删除此行>\"\n      }\n    },\n\n    \"cos-mcp-sse\": {\n      \"_comment\": \"方式三：SSE 模式（适合高频调用场景）\",\n      \"command\": \"npx\",\n      \"args\": [\n        \"cos-mcp\",\n        \"--connectType=sse\",\n        \"--port=3001\"\n      ],\n      \"env\": {\n        \"TENCENT_COS_SECRET_ID\": \"<替换为腾讯云 API 密钥 ID>\",\n        \"TENCENT_COS_SECRET_KEY\": \"<替换为腾讯云 API 密钥 Key>\",\n        \"TENCENT_COS_REGION\": \"<替换为存储桶区域，如 ap-guangzhou>\",\n        \"TENCENT_COS_BUCKET\": \"<替换为存储桶名称，格式 name-appid>\"\n      }\n    }\n  },\n\n  \"_参数说明\": {\n    \"Region\": \"存储桶区域，如 ap-guangzhou、ap-shanghai、ap-beijing 等\",\n    \"Bucket\": \"存储桶名称，格式为 name-appid，如 mybucket-1250000000\",\n    \"SecretId\": \"腾讯云 API 密钥 ID，在 访问管理 > API密钥管理 中创建\",\n    \"SecretKey\": \"腾讯云 API 密钥 Key，与 SecretId 配对使用\",\n    \"DatasetName\": \"数据万象数据集名称（仅图片搜索等智能功能需要，无则不填）\",\n    \"connectType\": \"连接模式：stdio（默认，推荐）或 sse\",\n    \"port\": \"SSE 模式下的监听端口（默认 3001）\"\n  }\n}"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件， 或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、 文档转PDF、视频智能封面生成等操作时使用此技能。 Skill: 腾讯云COS存储 Owner: ShawnMinh Summary: 腾讯云对象存储(COS)和数据万象(CI)集成技能。当用户需要上传、下载、管理云存储文件， 或需要进行图片处理（质量评估、超分辨率、抠图、二维码识别、水印）、智能图片搜索、 文档转PDF、视频智能封面生成等操作时使用此技能。 Tags: latest:1.0.5 Version history: v1.0.5 | 2026-02-28T11:24:15.760Z | user Version 1.0.5 - Added scripts/setup.sh for automated environment and credential setup. - SKILL.md updated with step-by-step first-time setup instructions using setup.sh. - Setup process no","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1088,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T20:43:04.031Z","emptyReason":null},"items":[{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-10-09T19:11:12.944Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}