用途
本技能用于在智能体环境中集成腾讯云对象存储（COS）和数据万象（CI），让用户可以通过自然语言指令完成云存储文件管理及配套的图片、文档、视频处理任务。
主要能力
根据资料，技能能力分为三类，按优先级降级使用：
方式一：cos-mcp MCP 工具（优先） 功能最全，支持：
- 存储操作：上传本地文件、上传字符串内容、通过 URL 上传、列出文件、下载文件、获取签名下载链接
- 图片处理：图片质量评估、AI 超分辨率、AI 智能抠图、二维码识别、添加文字水印、获取图片元信息
- 智能搜索：以图搜图、文本搜图（需预建数据集）
- 文档媒体：文档转 PDF、视频智能封面（均为异步任务，需通过 jobId 轮询结果）
方式二：Node.js SDK 脚本 当 cos-mcp 不可用时，通过 scripts/cos_node.mjs 执行存储操作，支持上传文件、上传字符串、下载、列出、获取签名 URL、查看文件信息、删除文件。仅支持存储操作，不支持图片处理、智能搜索、文档转换。
方式三：COSCMD 命令行 当方式一和方式二均不可用时使用，配置持久化在 ~/.cos.conf，支持上传、下载、列出、删除、签名 URL、文件信息、复制/移动，以及递归上传/下载目录。仅支持存储操作，不支持图片处理、智能搜索、文档转换。
使用方式
首次使用需检查环境并配置腾讯云凭证（SecretId、SecretKey、Region、Bucket，可选 DatasetName、Domain、ServiceDomain、Protocol）。推荐通过环境变量方式运行 setup.sh --from-env，避免凭证出现在 shell 历史中。setup.sh 会自动在项目本地安装 cos-mcp、cos-nodejs-sdk-v5、mcporter，并创建/更新 ~/.mcporter/mcporter.json（权限 600），如 coscmd 已安装则配置 ~/.cos.conf（权限 600）。脚本不会写入 shell 启动文件，不执行全局安装，不自动安装系统包。
执行时通过 mcporter 命令行调用 cos-mcp 工具，格式为：npx mcporter call cos-mcp.<tool_name> --config ~/.mcporter/mcporter.json --output json --args '<JSON>'。也可在客户端直接调用 MCP 工具。
适用场景
- 需要上传、下载、管理腾讯云 COS 存储桶中的文件
- 需要对图片进行质量评估、超分辨率、抠图、二维码识别、添加水印等处理
- 需要进行以图搜图或文本搜图（需预先建立数据集）
- 需要将文档转换为 PDF 或为视频生成智能封面
限制与安全注意事项
- 图片处理、智能搜索、文档转换、视频封面仅方式一（cos-mcp）支持，方式二和方式三不可用。
- 异步任务需通过 jobId 轮询结果。
- 首次使用前需运行 setup.sh --check-only 检查环境。
- 强烈建议使用子账号最小权限密钥（如 QcloudCOSDataReadOnlyAccess、QcloudCOSDataFullControl，CI 功能需额外 QcloudCIFullAccess），严禁使用主账号密钥。
- 凭证会持久化写入 ~/.mcporter/mcporter.json 和 ~/.cos.conf（权限 600），存在暴露风险；不再使用时可用 rm -f 清理。
- npm 包来自公共 registry，存在供应链风险，建议安装前核实包信息。
- 自定义域名支持有限：COSCMD 不支持 CDN 自定义域名。