SuperAPI AI 工具集

cloudbase

部署与运维

查看项目

更新于 10-15 21:51

技能介绍

用途:在开发、设计、构建、部署、调试、迁移或排查 CloudBase(腾讯云开发、TCB、微信云开发)项目时使用,覆盖 Web、微信小程序、uni-app、原生 App 等场景。

主要能力与流程: 1)先区分国内站(cloud.tencent.com)与国际站(tencentcloud.com),两套账号体系的环境、控制台、API Key 与登录态互不相通;可从控制台域名、envId 或报错推断,否则向用户确认一次,不要猜测。国际站可直接连接远程 MCP 端点 https://tcb-api.tencentcloud.com/mcp/v1;国内站为 https://tcb-api.cloud.tencent.com/mcp/v1。CLI 用 TCB_IS_INTL,MCP 用 TCB_SITE,变量名不同,设错会静默无效。 2)工作流分三步:探索(先用 searchKnowledgeBase(mode="skill") 搜索,再完整阅读匹配的 SKILL.md);实现(2a 先备好后端资源,2b 再写前端代码、装依赖、起服务、测试);收尾(运行 cloudbase-code-review,修复后声明完成)。第 2a 步必须先于前端代码,第 3 步为强制步骤。 3)优先使用 MCP 或 mcporter 做管理与部署,执行前检查工具 schema;本会话缺失 MCP 时先配置供下次使用,当前改用 tcb CLI(见 references/tooling-fallback.md)。安装可用 npx plugins add TencentCloudBase/cloudbase-plugin -y --scope user。

必要用法:始终显式指定 EnvId,不要依赖 CLI 隐式环境;别把别名/昵称直接传给 auth.set_env、SDK 初始化或控制台 URL,先用 queryEnv(action=list, alias=..., aliasExact=true) 解析为完整 EnvId,多个匹配或无精确别名时应停下向用户澄清。写工具结果到文件时传 JSON.stringify(result, null, 2) 序列化文本,而非原始对象。首次前端部署用 manageApps(action="deployApp"),无 createApp/updateApp;manageHosting 仅用于增量更新原本经 hosting 部署的项目。

适用场景与路由:含 Web BaaS 快速演示、Web 登录认证、微信小程序、原生 App/Flutter/React Native、NoSQL 数据库、CloudBase PostgreSQL、MySQL、云函数、CloudRun、AI Agent、大模型调用、UI 生成、资源巡检与规格工作流等,各自对应不同优先技能。

限制与注意:同一路径失败 2–3 次应先停止并改道;不要用 any 绕过类型错误;不要用空 try/catch 或删除失败测试来伪绿;AI 建模中 ai.createModel 传 GroupName 而非厂商模型 id;CloudBase PG 场景不要回退到 NoSQL/MySQL;AI 模型调用先做资格检查(DescribeActivityInfo、DescribeEnvPostpayPackage);小程序勿按 Web auth/SDK 处理。更多细节见 references 下的 mcp-setup.md、site-onboarding.md、deployment-workflow.md、tooling-fallback.md 等。