腾讯云对象存储与数据万象管理

管理腾讯云存储与处理服务的挑战

当开发者使用腾讯云对象存储 (COS) 和数据万象 (CI) 时，常遇到多服务分散管理的问题。COS 提供基础存储，但结合 CI 的图片处理、内容识别、媒体转码等能力时，需要分别调用不同 API、处理认证配置，并关注服务开通状态。此外，严格的安全策略（如删除操作限制）和地域约束（如 MetaInsight 仅支持特定区域）增加了操作复杂度。传统方式下，开发者需编写重复代码来整合这些服务，且容易忽略 CI 服务是否已启用。

技能的工作原理与核心能力

该技能通过统一的 Node.js SDK 脚本解决上述问题。它封装了 COS 和 CI 的主要 API，提供三个脚本入口：

• scripts/cos_node.mjs：处理存储操作（如 upload、download）和写操作（如 create-ci-bucket）。
• scripts/ci_api.mjs：专注于只读检索，如数据集筛选 (simple-query) 和语义搜索 (hybrid-search)。
• scripts/preview_gen.mjs：生成检索结果的交互式 HTML 预览。

核心能力包括：

• 文件与桶管理：支持上传、下载、列出文件，以及创建和配置存储桶（通过 list-buckets、head-bucket 等 action）。
• CI 服务集成：自动检查服务状态（如 describe-ci-bucket-status），并在未开通时引导用户确认后执行开通（如 create-doc-process-bucket 用于文档处理）。
• 模式控制：通过环境变量 KIKI 切换公开模式和严格模式。严格模式下，所有删除操作（如 delete、delete-multiple）被隐藏和拒绝，并防止通过其他入口绕行。
• 数据集与智能检索：支持创建和管理 MetaInsight 数据集（需指定地域如 ap-beijing），并提供增量/存量索引选择。检索时使用 find-datasets-by-bucket 确认绑定。

关键步骤与运行机制

首次使用时，技能执行自动设置流程：运行 setup.sh --check-only 检查模式，公开模式下引导用户配置凭证（支持 STS 临时凭证或永久密钥），并可选持久化到 .env 文件（权限 600）。凭证优先使用运行时 TENCENTCLOUD_* 环境变量。

操作中，脚本按以下逻辑工作：

1. 服务状态预检：在调用 CI 功能前，使用 get-bucket-ci-status 查询总开关和子服务（如 documentProcessing），避免未开通时报错。
2. 请求层拦截：在 cosRequest 和 cosRequestPromise 中双重拒绝 DELETE 请求，确保严格模式安全。
3. 知识库快捷流程：通过口语化意图（如“创建知识库”）自动执行 create-knowledge-base，创建桶、数据集并绑定，简化用户操作。

所有输出均为 JSON 格式，便于脚本集成。参数如 --bucket 和 --region 可覆盖默认配置。

适用边界与注意事项

• 费用与服务依赖：COS 和 CI 均为付费服务，使用技能即表示知悉相关费用。部分能力（如 MetaInsight）需要单独开通。
• 地域限制：MetaInsight 数据集仅支持 ap-chengdu、ap-beijing、ap-shanghai，绑定前必须验证桶地域。
• 模式差异：严格模式下，删除操作全面禁止（包括 CI 解绑），但其他只读能力不受影响。公开模式支持完整功能，但凭证管理需谨慎。
• 数据集索引模式：绑定数据集时必须选择增量 (Mode=0) 或存量 (Mode=1) 索引，一旦绑定不可修改。
• 错误处理：查询 CI 状态时，若返回 noAuth，表示密钥缺少 ci:DescribeCIBuckets 权限，应避免尝试开通。

总体而言，该技能适用于需要集中管理 COS 和 CI 的开发者，尤其在自动化工作流或智能检索场景中，但需注意服务开通状态和操作限制。