开通环境能力

[binggg]

✨ 功能需求

请简要描述你希望实现的功能或改进：

（在这里填写你的需求描述）

补充说明或附件（可选）：

（可上传截图或相关文件）

[github-actions]

🤖 AI Analysis

问题 #375 分析：开通环境能力

分类

功能请求 — 将环境开通（创建/销毁/修改）功能作为一流的 MCP 工具进行暴露。

可能涉及领域

• mcp/src/tools/env.ts — 现有的环境工具（auth, envQuery, envDomainManagement）
• mcp/src/tools/capi.ts — 当前环境生命周期操作仅可通过通用的 callCloudApi 工具使用
• mcp/src/tools/env-setup.ts — 自动免费环境创建流程（仅限内部，不可用户直接访问）

当前状态与不足

操作	当前路径	问题
创建付费环境	callCloudApi(service="tcb", action="CreateEnv")	通用接口 — AI 必须知道确切的参数，没有软件包查询功能
创建免费环境	通过 env-setup.ts 自动进行	硬编码别名 "ai-native"，不可独立触发
销毁环境	callCloudApi(action="DestroyEnv")	无安全防护，通用接口
修改环境	callCloudApi(action="ModifyEnv")	无专用工具
查询软件包	完全不暴露	CreateEnv 需要 PackageId，但 DescribeBaasPackageList 不可访问

建议的下一步

1. 设计一个专用的 manageEnv MCP 工具，包含以下操作：

   • create — 创建环境（免费和付费），并自动查询 DescribeBaasPackageList 以获取 PackageId
   • destroy — 带有确认防护的销毁环境（需要 confirm=true，类似于现有的 manageCloudRun 模式）
   • modify — 修改环境（别名、默认标志等）
   • listPackages — 查询可用的 BaaS 套餐（免费环境创建的前提条件）

2. 遵循现有模式 — 模仿 manageCloudRun/manageStorage 的设计：单一工具，基于 action，对破坏性操作使用 confirm=true

3. 将免费环境创建流程 从 env-setup.ts 内部逻辑重构到新工具中，使其可显式调用

4. 查阅云 API 文档，获取 CreateEnv、DescribeBaasPackageList、DestroyEnv、ModifyEnv 参数，然后再进行实现（根据 cloud_api_backend_rules）

待解决问题

• 免费环境（CreateFreeEnvByActivity）是否应可独立触发，还是仍保留为自动设置流程的一部分？
• manageEnv 应该自动绑定到新创建的环境（在创建后设置 envId），还是由用户/AI 手动通过 auth(set_env) 处理？
• DestroyEnv 是否应默认要求 BypassCheck: true 和 IsForce: true，还是让 AI 在提示中指定这些参数？
• 应该采用完整的 spec 流程（跨模块，涉及环境生命周期 + 设置 + 交互流程）还是简化处理（只需添加工具封装）？

---

Generated automatically by CodeBuddy CLI headless mode.