核心用法
tencent-cloud-cos 是腾讯云对象存储（COS）与数据万象（CI）的深度集成技能，通过单一 Node.js SDK 脚本覆盖三大核心场景：
1. 文件存储管理
支持上传/下载/删除/批量操作、签名 URL 生成、存储桶 ACL/跨域/标签/生命周期管理。所有路径为存储桶内相对路径，支持 --bucket / --region 参数动态切换目标存储桶。
2. AI 数据处理
- 图片处理：缩放、裁剪、旋转、格式转换（webp/avif/heif）、文字水印、AI 超分辨率、智能裁剪、质量评估、二维码识别
- 内容识别：OCR 文字识别、图片标签识别
- 文档处理：Office 转 PDF、文档预览（图片/HTML）
- 媒体处理：视频智能封面、转码、截帧、媒体信息提取
- 内容审核：图片/视频/音频/文本/文档违规检测
- 智能语音：语音识别、语音合成、音频降噪、人声分离
- 文件处理：哈希计算、压缩/解压
3. 智能检索与知识库（MetaInsight）
- 多模态检索：以图搜图、以文搜图、人脸搜索、元数据检索、多模态文档检索
- 一键知识库：
create-knowledge-base自动完成「创建存储桶 → 创建 DocSearch 数据集 → 绑定」全流程，后续通过自然语言指令（"上传到知识库"/"从知识库搜一下"）完成文档上传与语义检索
凭证安全机制
| 模式 | 安全性 | 特点 |
|------|--------|------|
| 默认模式 | ⭐⭐⭐ | 凭证仅存 shell 会话，关闭终端即消失 |
| 持久化模式 | ⭐⭐ | 写入 `.env`（权限 600），下次自动读取 |
| **加密持久化（推荐）** | ⭐⭐⭐ | AES-256-GCM 加密，密钥绑定机器+用户，拷贝失效 |
支持 STS 临时凭证（SecretId/SecretKey/Token 三元组），过期自动失效，最安全。
显著优点
- 官方 SDK 集成：基于
cos-nodejs-sdk-v5腾讯云官方 Node.js SDK，API 覆盖完整 - 单一脚本架构：所有功能通过
cos_node.mjs统一入口，学习成本低 - 知识库零配置：口语化指令触发，自动完成底层资源创建与绑定
- 企业级安全：AES-256 加密、STS 临时凭证、最小权限子账号策略、凭证永不在对话回显
- 异步任务自动轮询：文档转换、视频封面等长时任务自动等待结果
潜在缺点与局限性
- 腾讯云生态锁定：仅支持腾讯云 COS，无法迁移至 AWS S3/阿里云 OSS 等其他对象存储
- 网络依赖：所有操作需连接腾讯云 API，离线不可用
- 异步任务延迟：文档索引建立需「几秒到几分钟」，非实时检索
- 数据集模板限制：图片检索/人脸搜索/元数据检索需预先创建对应模板的数据集
- Node.js 环境依赖：需本地安装 Node.js 运行时
适合人群
- 已使用或计划使用腾讯云基础设施的开发者与企业
- 需要快速搭建文档知识库、实现语义检索的内容团队
- 有批量图片/视频/文档 AI 处理需求的媒体、电商、教育行业用户
- 对数据安全有要求、能接受云端存储方案的组织
常规风险
| 风险类型 | 说明 | 缓解措施 |
|----------|------|----------|
| **凭证泄露** | 永久密钥若泄露可导致存储桶数据被窃取/篡改 | 强制使用子账号最小权限 + STS 临时凭证 + 加密持久化 |
| **误操作数据丢失** | 本技能**禁止删除/清空存储桶**，但文件删除不可逆 | 启用存储桶版本控制，定期配置生命周期策略 |
| **成本失控** | AI 处理、流量、存储均按量计费，高频调用可能产生高额费用 | 设置账单告警，监控 API 调用频率 |
| **内容审核误判** | 自动审核可能误杀正常内容或漏过违规内容 | 关键场景保留人工复核流程 |
| **索引延迟** | 知识库上传后索引非实时，立即查询可能无结果 | 告知用户等待时间，或主动轮询索引状态 |