CodeBuddy 支持 API 版本隔离与灰度流量控制：一、通过结构化 Prompt 生成多版本路由代码并手动挂载；二、利用环境变量动态选择后端模型；三、生成 OpenAPI 3.0 YAML 配置网关按 Header 分流；四、通过 ACP 协议 URL 参数实现会话级版本隔离。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 CodeBuddy 进行 API 开发时需要实现版本隔离与灰度流量控制，则可能面临路由冲突、模型调用错配或环境变量未区分等问题。以下是针对 API 版本管理与灰度发布的具体操作路径：
一、通过配置文件实现 v1/v2 路由共存
CodeBuddy 本身不直接生成 Web 框架的路由代码，但可通过其 CLI 工具结合结构化 Prompt，驱动生成兼容多版本的 REST API 路由配置。该方式依赖用户明确声明路径前缀、请求体结构及响应契约。
1、准备包含版本语义的 Prompt，例如：“生成 Express.js 路由代码，支持 /api/v1/users 和 /api/v2/users 共存：v1 返回 {id, name}，v2 新增 {id, name, email, created_at_iso}，且 v2 需校验请求头 x-api-version=2”
2、在终端执行命令：codebuddy "生成 Express.js 多版本路由代码" < prompt.txt
3、将生成的代码保存为 routes/versioned-users.js，并手动挂载至主应用入口（如 app.use('/api', require('./routes/versioned-users'))）
二、利用环境变量区分灰度模型实例
当需对同一 API 接口启用不同后端模型（如 v1 调用 hunyuan-2.0-instruct，v2 调用 hunyuan-turbos），可通过 CodeBuddy 的运行时环境变量机制实现动态路由分发，无需修改业务代码逻辑。
1、在系统中设置灰度标识环境变量：export CODEBUDDY_API_VERSION=v2
2、编辑 ~/.codebuddy/models.json，确保两个模型均注册且 URL 端点一致，仅 apiKey 与 id 不同
3、在调用代码中读取环境变量，并选择对应模型 ID：const modelId = process.env.CODEBUDDY_API_VERSION === 'v2' ? 'hunyuan-turbos' : 'hunyuan-2.0-instruct'
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
三、基于 HTTP Header 实现灰度路由转发
适用于已部署网关（如腾讯云 API 网关、Nginx 或自建 Kong）的场景。CodeBuddy 可生成符合 OpenAPI 3.0 规范的 YAML 描述文件，供网关自动解析并配置分流规则，实现 header 匹配型灰度发布。
1、编写 Prompt 明确灰度策略：“输出 OpenAPI 3.0 YAML，定义 /api/v1/analyze 接口，要求支持根据请求头 x-deployment-tag: canary 分流至 backend-v2，其余走 backend-v1”
2、运行：codebuddy --output openapi.yaml "生成带灰度 header 分流的 OpenAPI 描述"
3、将生成的 openapi.yaml 导入腾讯云 API 网关控制台，启用“按请求头路由”插件
四、使用 ACP 协议流式通道隔离版本会话
CodeBuddy 提供的 ACP（/api/v1/acp）是有状态流式协议，天然支持会话级上下文绑定。通过在初始化 SSE 连接时携带 version 参数，可在服务端维持独立的模型推理上下文，实现逻辑层版本隔离。
1、构造 ACP 初始化请求 URL：https://api.lkeap.cloud.tencent.com/coding/v3/api/v1/acp?version=v2&model=hunyuan-turbos
2、在前端 JS 中建立连接：const eventSource = new EventSource(url)
3、服务端接收 version 查询参数后，从 models.json 中匹配对应模型配置，并复用 apiKey 与 url 字段发起下游调用
