腾讯云COS存储

核心用法

腾讯云COS技能通过三层降级策略确保可用性：优先使用官方cos-mcp MCP工具（功能最全），其次回退到Node.js SDK脚本，最后使用COSCMD命令行。

存储操作：支持文件上传（本地/URL/字符串）、下载、列出、删除，以及签名URL生成。首次使用需运行setup.sh配置SecretId/SecretKey/Region/Bucket等凭证。

数据万象(CI)图片处理：集成质量评估、AI超分辨率、智能抠图、二维码识别、文字/图片水印等能力，直接操作存储桶内图片无需下载。

智能搜索：支持以图搜图和文本搜图，需预先创建数据集并关联DatasetName。

文档媒体处理：异步任务模式支持文档转PDF、视频智能封面生成，通过jobId轮询结果。

显著优点

• 官方背书：cos-mcp为腾讯云官方GitHub仓库维护，非第三方封装
• 功能纵深：区别于普通云存储工具，深度集成AI图像处理与内容理解能力
• 企业级可用：支持自定义域名、HTTPS协议、签名URL等生产环境需求
• 渐进降级：三层执行策略确保环境差异下始终可用

潜在局限性

• Node SDK/COSCMD不支持CI功能：图片处理、智能搜索、文档转换仅方式一可用，环境不满足时能力降级明显
• 异步任务需轮询：文档/视频处理非实时，需二次查询job状态
• 凭证配置门槛：需用户主动提供云API密钥，对非开发者不够友好
• 删除操作缺失：cos-mcp未实现delete，需回退到方式二/三

适合人群

• 开发者：需要程序化管理云存储+AI处理流水线
• 内容运营：批量图片优化、智能封面生成、素材库管理
• 企业IT：构建基于腾讯云的内容中台

常规风险

• 密钥泄露：SecretKey需本地存储，多用户环境需关注~/.zshrc等配置文件权限
• 计费失控：AI处理（超分、抠图）和数据万象检索按调用量计费，高频操作需成本预估
• 数据覆盖：上传同名文件默认覆盖，关键操作建议先head检查存在性

核心功能与用法

该技能是腾讯云对象存储（COS）的官方集成工具，通过 MCP 协议、Node.js SDK 和 COSCMD 三层执行策略，提供完整的云存储管理能力。核心功能分为四大类：

1. 存储基础操作：文件上传（本地/URL/字符串）、下载、列出、签名 URL 生成、删除
2. 数据万象图片处理：AI 质量评估、超分辨率、智能抠图、二维码识别、文字水印
3. 智能搜索：以图搜图、文本搜图（需预建数据集）
4. 文档媒体处理：文档转 PDF、视频智能封面生成（异步任务）

首次使用需通过 setup.sh 配置腾讯云凭证（SecretId/SecretKey/Region/Bucket），支持自动安装依赖并持久化配置。

显著优点

• 来源权威：腾讯云官方生态项目（cos-mcp、cos-nodejs-sdk-v5），T1 级可信来源
• 功能全面：唯一同时覆盖存储+AI 图片处理+智能搜索+文档转换的 COS 工具
• 执行可靠：三层降级策略（MCP → Node SDK → COSCMD）确保操作始终可完成
• 配置友好：自动检测环境、引导式凭证收集、支持自定义域名和协议
• 安全规范：无危险函数、无硬编码密钥、凭证由用户主动提供并存储于本地 shell 配置

局限性与缺点

• 功能分布不均：图片处理、智能搜索、文档转换仅方式一（cos-mcp）可用，Node SDK 和 COSCMD 仅限基础存储
• 配置持久化：凭证写入 ~/.bashrc 或 ~/.zshrc，共享机器需注意文件权限
• 异步任务复杂度：文档转换和视频封面需手动轮询 jobId 获取结果
• 全局 npm 依赖：mcporter 需全局安装，可能遇到权限问题（已内置失败回退）

适合人群

• 需要频繁操作腾讯云 COS 的开发者和运维人员
• 有 AI 图片处理需求（超分、抠图、水印）的内容创作者
• 需要文档转 PDF、视频封面生成的多媒体处理场景
• 追求官方 SDK 稳定性、不愿使用第三方工具的企业用户

常规风险

• 凭证泄露风险：配置持久化到 shell 文件，多用户环境需检查 ~/.bashrc 权限
• 区域与桶名混淆：Bucket 需完整格式 name-appid，Region 需使用腾讯云区域代码（如 ap-guangzhou）
• 异步任务超时：文档/视频处理任务可能耗时较长，需合理设置轮询间隔
• 自定义域名限制：COSCMD 不支持 CDN 自定义域名，复杂网络环境建议优先使用 MCP 方式