v2.34.8

本次为小幅更新：云函数两段式部署补上上传目标校验，公开评测演练改为直接给出得分。

🎉 新功能

评测能力

• 公开演练改为指向一个评分任务，跑完可直接看到得分（#1113）

🐛 问题修复

• 云函数两段式部署校验上传目标：只接受本次会话铸造的那份上传地址，不再接受任意代码包位置（#1114）
• DSH 插件描述补齐数据库、云存储、身份认证与部署四类能力（#1117）

🔧 维护与工程改进（可选阅读）

• 支持通过环境变量把云 API 调用指向本地 endpoint（仅允许本机回环地址），便于本地联调（#1116）

贡献者

@binggg

感谢 @gzr123166 对 DSH 插件 stdio 通信问题的复现与修复，相关改动已随 v2.34.7 一并交付。

完整变更: v2.34.7...v2.34.8

v2.34.7

本次更新集中打磨云函数部署与可观测性，并首次搭起评测（Evals）能力与内置反馈插件。

🎉 新功能

云函数

• 部署支持「两段式 ZIP 上传」：先取预签名地址直传代码包，再提交部署，代码包体积不再受单次请求限制（#1084）

日志与可观测性

• 新增 createLogService 工具，并支持查询 MySQL 慢日志与错误日志（#1076）

评测能力（新）

• 新增 CloudBase Evals 脚手架与首批评测场景（#1093）
• 公开场景运行器与基准任务集，评估结果可复现（#1110）

反馈与协作

• 内置会话草稿反馈插件：把使用过程中记录的问题草稿与本机登录态、issue 表单打通（#1109）

DSH 插件

• 注册 all-in-one skill，并让插件直接连接 MCP（#1111）

🐛 问题修复

• 项目根目录解析更严格：宿主的配置目录不再被当作项目根（#1115）
• 云函数层（layer）列表中的环境变量值统一脱敏展示（#1104）
• 未登录时 getEnvId 明确返回 AUTH_REQUIRED，不再给出含糊结果（#1085）
• CloudRun 路径校验接受工作目录之外的绝对路径，修复部分部署被误拒（#1077）
• 反馈草稿与登录态、issue 表单保持一致，未登录时不再丢失上下文（#1112）
• 修正若干 skill 文档中的操作名、前置条件与措辞（#1092、#1096、#1099、#1100、#1086）

📚 文档更新

• CloudBase CloudAPI 参考页与官网文档保持同步
• 应用市场清单与报告更新（#1091、#1106）
• FAQ 拆分「产品问题」与「工具问题」（#1081）
• README 活动卡片改为自托管（#1089）
• skill 侧补充多项交付经验（#1088、#1090、#1094、#1102）

🔧 维护与工程改进（可选阅读）

• skill 版本与兼容基线纳入同一条检查链，避免版本号与派生产物漂移（#1078、#1080）
• PR 元信息（标题 / 正文 / 提交信息）纳入内部引用检查（#1087、#1098）

贡献者

@binggg @gzr123166

完整变更: v2.34.6...v2.34.7

v2.34.6

CloudBase MCP v2.34.6

🎉 新功能

云函数

• 支持发布函数版本、查询别名、更新别名路由配置：可以把新版本发出来，再按别名把流量切过去，灰度与回滚都不用改调用方代码。

开发者工具（CloudAPI）

• callCloudApi 新增备案（ICP）service；cloud-api-operations 技能同步补上「备案提交前自查与等待期查询」流程：从环境是否支持备案、当前能否提交、预计等待时长到域名/主体状态，逐步列出用哪个接口查、每个接口属于哪个 service。

🐛 问题修复

• 文档读取（searchKnowledgeBase 的 readDoc）收紧了入参校验：只接受 CloudBase 官方文档站（docs.cloudbase.net）的地址，其他主机一律拒绝；传官方地址时只取其中的路径部分。如果你之前传过第三方地址，请改用官方文档站地址。findByName / searchDocs 返回的地址仍可直接喂回读取，不受影响。
• 云端模式下 manageHosting 的部署指引补齐，不再出现「云端模式还引导本地部署」的错位（#1075）。
• 消息推送技能文档去掉了维护者本机路径，外部用户照抄示例不再踩空。

📚 文档更新

• 新增「首次使用站点选址」说明：什么时候要选（首次接入）、什么时候该跳过（项目里已有记录），以及 CLI 与 MCP 两个开关作用域不同、冲突时怎么判。
• 连接方式文档补上 CLI 与 MCP 的开关对照表，并标注一个容易误判的现象：tcb login 成功但 tcb env list 为空，多半是站点选错了。

🔧 工程与发布

• Release 页面开始附带 Claude Code 与 Agent Plugins 两种格式的归档包（#1072）。
• CloudAPI 参考页、connector 与 plugin 产物随 skills 同步。

v2.34.5

CloudBase MCP v2.34.5

🎉 新功能

云存储 / 环境

• manageEnv(action="create") 支持指定共享 COS 桶（externalStorage：桶名 / 地域 / 路径前缀）。同一账号下创建大量环境时，可让多个环境共用一个桶、按前缀隔离文件
• 共享桶环境现在能被正确识别：此前 Bucket 为空会让工具认为「没有云存储 / 静态托管」，导致 manageHosting(action="upload") 失败、managePermissions 拒绝授权；现在桶名为空但 ExternalStorage 已启用时按有效配置处理，并回执真实桶名

云托管

• queryCloudRun 新增 action="getManageTask"：可以查询发布任务是什么、什么时候开始、是否卡住。此前 7 个 action 里没有一个能查任务状态，遇到「已有发布任务运行中」只能盲等或盲重试
• 发布相关的 force 文案与等待语义修正，不再给出误导性提示

专家包

• 主专家 cloudbase-webdev-expert 覆盖面从「业务系统」拓宽到 CloudBase 主要能力：网站 / 落地页、数据库 + 登录、云函数、文件存储、AI 大模型、部署上线，快捷指令按场景给出
• 专家展示名改为大众化命名并带品牌关键词，便于检索；全部专家声明 CloudBase 连接器依赖

连接器

• 新增国际站 WorkBuddy 连接器 cloudbase-intl：远程 streamableHttp + 标准 MCP OAuth（国内连接器是本地 stdio + tcb CLI）。它与国内连接器共用同一份 config/source/** 内容源、不做分叉，构建时把中国站域名改写为国际站并内置国际站参考说明

🐛 问题修复

• Windows 启动崩溃：~/.npm/_npx 没有缓存时，spawn npx 抛出的 ENOENT 会终结宿主进程（issue #1061）。两处 spawn 现已补上 error 兜底
• PostgreSQL：移除 managePgDatabase(action="rollbackMigration")。它调用的云 API action 并未实现，任何参数组合都必然失败；移除后工具文档与 skill 不再引导 agent 去调一个不可能成功的接口
• 云托管 / 云存储 / PostgreSQL：会落进本地路径的参数（如 serverName）现在按各自描述里写明的命名规则校验，拒绝路径形态的名字；initEnv 可按文档直接调用
• AI 自动处理流程：修复模型原始输出会被写进公开 PR 正文与 issue 评论的问题

📚 文档更新

• MCP 连接文档改为「远程优先 + 双站」：远程模式作为推荐默认，中国站与国际站作为两套独立账号体系（凭据、控制台、登录态各自独立）说明；站点定义收敛到 doc/components/connectionMatrix.ts，避免各处表格漂移
• 修正一处扩散到 6 个文件的错误说明：远程连接地址不接受 site 参数，站点由端点域名决定
• 小程序专家补充「试用账号不支持 CloudBase」说明

⚠️ 兼容性提示

• 已废弃的 envQuery 工具别名移除，请改用 queryEnv
• managePgDatabase 不再提供 rollbackMigration

🔧 其他改进

• 工具文案按实例语言（lang）返回；queryPgDatabase / managePgDatabase 在未开通 PostgreSQL 的环境先做门禁，直接返回 PG_NOT_PROVISIONED
• 工具调用与生命周期事件新增 login_uin（环境所属账号），用于把用量归因到账号而非只归因到环境；如需关闭，设置 CLOUDBASE_MCP_TELEMETRY_DISABLED=true

🔧 维护与工程改进（可选阅读）

• 插件与技能镜像按上游同步，专家包版本自动 bump
• 内部同步脚本不再把原子写入的临时文件带进归档

v2.34.4

CloudBase MCP v2.34.4

🎉 新功能

Skills

• 新增 PostgreSQL 访问模式最佳实践 skill：批量读写、索引与 EXPLAIN、RLS 角色门禁、上线容量规划

上下文占用

• searchKnowledgeBase 内联的 skill / OpenAPI 清单改为按需返回，43 个工具的常驻 schema 由 139,627 字符降到 126,880 字符（-9.1%）；技能自身的触发描述改成一次调用取回，不再随工具面增长被截断

文档

• 文档站新增 WorkBuddy AI 工作台视频教程（BV1jDtx6GE7E）

🐛 问题修复

• 云托管：修正 Function 模式下不得监听 PORT 的规则。此前按 skill 字面写代码会在函数框架自身绑定之上再调一次 app.listen()，进程以 EADDRINUSE 退出；现强制规则、模式选择表与 manageCloudRun 的 Port 描述三者一致。同时补上「计算资源访问 CloudBase 的凭证决策门」，明确官方凭证变量为 CLOUDBASE_APIKEY，并禁止从本地客户端登录态（auth.json、.cloudbase/）取 key —— 那样拿到的凭证没有 keyName、没有轮换记录、也没有可吊销的 keyId
• 静态托管：queryHosting(findFiles) 与 manageHosting(delete) 统一归一化前导斜杠。COS 侧走的是严格字节前缀匹配，/dir/ 匹配不到 dir/f.txt，此前会被误读成「目录是空的」，删除自检也会用未归一化的路径回查而给出「已验证」的误判；自检命令现在使用归一化后的路径
• 工具注解：绑定当前环境的工具改为 openWorldHint=false，仅保留 searchKnowledgeBase / downloadTemplate 为开放世界；只读工具补 destructiveHint=false，域名删除标记为 destructive

📚 文档更新

• 视频教程收录流程补充文档站同步步骤

🔧 维护与工程改进（可选阅读）

• 插件与技能镜像按上游同步；面向 agent 的文档统一改用规范工具名 queryEnv，不再使用已废弃别名

v2.34.3

CloudBase MCP v2.34.3

🐛 问题修复

• deployApp 的 cosTimestamp 不再只接受数字。getUploadUrl 返回的是字符串时间戳，而 schema 声明为整数并做强制转换 —— 「先取上传地址、再按该地址创建应用」这条云端上传通道自己拒收自己的返回值，走到一半就断。现在字符串与数字都接受，统一归一为非空十进制字符串
• getBuildLog 的 buildId 不再只接受字符串。部署返回的 BuildId 是数字、云 API 侧要的也是整数，而 schema 此前只收字符串 —— 刚部署完拿到的构建 ID 直接查不了日志。现在两种形态都接受，非数字会给出明确报错，而不是被 schema 静默拒收
• 创建网关路由前会先校验上游资源（云函数 / 云托管服务）是否真实存在，避免写入悬空路由：此前这类路由会落库成功，只在真正请求时才报错。上游确实不存在时不写入任何配置，返回近似名称候选与只读的下一步建议；探测不确定时保守放行并记录日志
• 删除云存储文件后的回查改用精确 Key 比对，修掉两个方向的误判：删除 /a/b.txt 时，同前缀的 /a/b.txt.bak 会造成假阴性（明明删掉了却报「仍存在」）；COS 风格的 {Contents: [...]} 响应结构此前根本不被识别，导致校验恒为通过
• 「环境未开通」的判断不再被中文文案绕过：该守卫此前只匹配英文 ResourceNotFound，中文「资源不存在」会漏过，后续调用于是拿到难以理解的报错。现在同时看错误码（code / Code / original.code）与文案，三处重复实现收敛为同一个判断
• 环境相关工具的纯文本失败回执现在会正确标记为失败。结构化载荷有统一处理，但纯文本回执此前被上层当成成功 —— AI 侧感知不到出错，还可能在错误状态上继续下一步
• 报错回执里的 MCP 版本号不再显示宿主应用版本。托管场景下进程属于宿主（实测报出 0.0.1），与工具自身版本自相矛盾；现在优先取构建期注入的版本
• queryPermissions / managePermissions 明确说明：PostgreSQL 类型环境下平台会拒绝角色类 action（createRole / deleteRoles / updateRole），这是平台能力边界而非配置问题，并给出 RLS 与控制台两条替代路径
• callCloudApi 的工具描述不再把 {controlPlaneUrl} / {dependencyUrl} 占位符原样暴露给客户端，改为填入真实文档地址

影响面：只放宽入参类型、增加前置校验与修正文案，不改变既有合法调用的语义；{layerName} / {region} 仍是有意的格式占位符。

🔧 维护与工程改进（可选阅读）

• 修复 plugin skills 回填与 skills 仓库推送之间的竞态：两者监听同一目录、同秒启动时，回填会在推送落地前完成比对，判「无漂移」后退出，导致 plugin/ 目录落后一个版本（#1038）

v2.34.2

CloudBase MCP v2.34.2

🐛 问题修复

• auth(action="login_by_api_key") 的缺参提示不再指向工具读不到的字段名。提示文案与 next_step.suggested_args 此前写的是 envId，而 schema 与实现只读 apiKeyEnvId —— 照着提示原样重试会被 schema 收下、却不被实现读取，于是再次返回 INVALID_ARGS 且提示一字不变，形成重试无法自愈的死循环。现在提示与建议参数统一为 apiKeyEnvId（该功能引入时的原始命名），参数语义不变，envId 仍只用于 set_env
• 新增一条回归测试：把 next_step.suggested_args 原样回放，断言结果码不再是 INVALID_ARGS —— 让「提示与实现必须对得上」成为可执行契约，而不只是一条文案断言

影响面：只改提示文案与建议参数，不动 schema 与参数语义，无兼容性影响。

v2.34.1

CloudBase MCP v2.34.1

🎉 新功能

交付后分享

• 专家包（工作台 / 收集表单 / 业务系统 / 小程序）与部署 skill（CloudBase Sites、小程序开发）在部署验证通过后，会至多一次询问是否生成分享素材 —— 把这次做出来的东西整理成可直接发出去的图文卡片与文案
• 素材只取脱敏内容，且明确要求剔除真实业务数据、填写者信息、AppID / 支付密钥等；不想分享直接拒绝即可，之后不会再提

🐛 问题修复

• 生成产物的顺序不再漂移：searchKnowledgeBase 描述里内联的 OpenAPI 文档清单此前依赖 8 个文档的并发抓取完成先后，每次构建都可能换序；现改为跟随源码声明顺序，文档与工具清单的对比不再出现纯顺序的无意义差异

🔧 维护与工程改进（可选阅读）

• 部署分享协议从「入口」补挂到「出口」：此前只有 cloudbase-platform 总览提过它，专家包与部署 skill 全文未提，因此该能力实际很少被触发

v2.34.0

CloudBase MCP v2.34.0

🎉 新功能

多语言与 IDE 支持

• 工具文案全量国际化：新增实例级 lang 参数，英文 IDE 下工具描述直接呈现英文，不再中英混杂
• auth 工具新增 site / region 参数，国际站登录与地域路由解析更准确
• 修复参数级文案的求值时机问题（此前英文实例下会静默返回中文），并给参数描述加上字数上限

云 API

• callCloudApi 支持的服务扩至 57 个产品，并内置官方接口版本映射；tke / mongodb / teo / vod / sms / monitor 等有多个版本的服务需显式指定 version

部署与环境

• 新增 appBuild 工具，并支持云托管构建中和，避免本地已构建产物被二次构建
• queryEnv 如实回执 region 的生效情况；domains 尊重传入的 envId
• skill 兜底读取改指官方分发仓，并返回该技能的 references 地址清单，可直接抓取

Skills

• cloudrun-development 新增「SDK 优先」的数据库访问决策闸门
• 部署验证通过后可选执行「部署分享」流程
• 新增 workbench、collect-form 两个专家包

🐛 问题修复

• 适配官网文档新的 Markdown 寻址规则，readDoc 与 skill 内的文档链接同步更新
• 小程序消息推送与权限相关修复
• skill 同步改为差集清理并加集合断言，清除模板仓中的僵尸 skill
• 修正部分文档入口与版本固定值

📚 文档更新

• 云 API 参考页持续自动同步
• skill 文档补充：PostgreSQL 环境路由、owner 表模板、公开读 bucket 的 RLS 配置、迁移重试语义、publishable key 自动供给约定

🔧 维护与工程改进（可选阅读）

• prompts 同步检查现在能区分「待合并后可见」与真正的死链；i18n 守卫新增工具级描述检查
• STS 资源级 E2E 的超时预算放宽，减少偶发红点
• 发布产物与兼容面基线定期对齐

v2.33.2

CloudBase MCP v2.33.2

🎉 新功能

部署

• 新增声明式部署工具 deployPlan / deployApply：先规划变更、确认后应用，配套完整测试保障
• 新增 cloudbase-declarative-deploy skill，覆盖配置 schema、多环境与 plan/apply 流程引导

云 API

• callCloudApi 服务白名单新增 monitor（云监控 / 告警策略）与 postgres（云数据库 PostgreSQL），可直接创建告警策略、查询 PG 实例
• 工具描述内置每日同步的 CloudAPI 索引，AI 可先查 Action 再调用

专家包

• cloudbase-webdev-expert 新增连接器与 skill 前置检查，环境缺失时给出明确引导

📚 文档更新

• 新增 cloud-api-operations skill：云 API 调用方式 + PG 存储告警等实战 recipe

🔧 维护与工程改进（可选阅读）

• 依赖升级：@cloudbase/manager-node → 5.8.4
• 插件工程：cloud-api-operations 补齐 skill-metadata、同步 qoder 插件规范