腾讯云 COS 智能管理与处理技能

解决的问题

在直接调用腾讯云 API 管理 COS 和 CI 时，开发者需要面对多个服务入口、复杂的认证流程以及分散的 SDK。例如，管理文件存储、执行图片处理、运行内容审核、构建基于语义检索的知识库，往往需要编写和维护多套独立的脚本或集成不同的工具链，这增加了开发与运维的复杂度。

技能如何工作

该技能提供了一套基于 Node.js 的统一脚本入口，将分散的 COS 与 CI 能力整合为结构化的 action。

核心能力与执行流程

1. 统一入口与凭证管理：技能通过 scripts/cos_node.mjs、scripts/ci_api.mjs 和 scripts/preview_gen.mjs 三个脚本提供服务。它会自动处理 cos-nodejs-sdk-v5 的安装，并支持通过环境变量（如 TENCENTCLOUD_*）或 .env 文件管理临时（STS）或永久密钥。
2. 全面的操作与处理能力：

- 存储与桶管理：执行文件的上传、下载、签名链接生成以及存储桶的配置查询（如 ACL、生命周期、加密策略）。
- CI 处理能力：在绑定数据万象后，可调用图片处理（缩放、AI 增强）、内容识别（OCR、标签）、媒体转码、内容审核等服务。
- 智能检索与分析：通过 ci_api.mjs 对已绑定的数据集（MetaInsight）进行结构化查询、聚合分析和语义检索。
- 知识库快捷操作：提供自然语言映射的快捷流程，如 create-knowledge-base 可一键创建存储桶、DocSearch 数据集并建立绑定。

1. 运行模式与安全控制：技能通过环境变量 KIKI 区分公开模式和严格模式。严格模式 (KIKI=1) 会禁用所有删除操作（包括 COS 对象删除和 CI 解绑），并隐藏本地凭证管理功能，以提供更安全的只读或非破坏性操作环境。

关键使用步骤

1. 首次使用与认证：首次操作会引导完成环境检测与凭证配置。推荐使用 STS 临时凭证以增强安全性。
2. 操作前的CI状态检查：在使用图片处理、文档处理等 CI 功能前，必须先查询存储桶的 CI 绑定及具体子服务开通状态，确认后再执行操作，避免因服务未开通导致失败。
3. 数据集与检索的前置条件：进行智能检索（如以图搜图、知识库查询）前，需确保存储桶已绑定对应模板的数据集，并已完成索引。若无合适数据集，技能会引导创建。

适用边界与注意点

• 费用与合规：COS 和 CI 均为付费服务。调用处理 API（尤其是 AI 功能）会产生计费。
• 模式限制：严格模式 (KIKI=1) 下禁止任何删除语义的操作，此限制无法通过其他入口（如直接 HTTP 调用）绕过。
• 地域限制：MetaInsight 数据集仅支持 ap-beijing、ap-shanghai、ap-chengdu 三个地域。创建数据集或绑定时必须显式指定地域。
• 异步服务开通：同步的图片/内容识别在 CI 绑定后可用，但异步任务、媒体处理等需要单独开通对应子服务。
• 功能入口差异：cos_node.mjs 处理写操作和基础处理；ci_api.mjs 专注于数据集的只读检索与分析。请根据需求选择正确入口。