Skip to content

model-add-remove.md

Latest commit

 

History

History
56 lines (38 loc) · 2.61 KB

model-add-remove.md

File metadata and controls

56 lines (38 loc) · 2.61 KB
Raw

模型上下架

触发条件

  • 上线新的 Qwen / Wan / CosyVoice / 等模型
  • 切换某命令的默认模型(如 bl text chat 默认从 qwen3.7-max 切到 qwen3.7-plus)
  • 废弃旧模型

模型本身是阿里云后端在管,本仓库要做的是让 CLI 能正确调用 + 文档/AI 入口准确反映可用模型清单。

必查清单

A. 命令实现

  • packages/commands/src/commands/<group>/<action>.ts:
    • --model flag 的 description 里"default:"反映新默认值
    • 命令内部 const model = flags.model || settings.defaultXxxModel || "<default>" 的 fallback 字符串
    • 如果命令维护一个 supported-models 列表(如 speech/synthesize.ts:MODEL_VOICES),增删条目
    • 如果不同模型有不同 endpoint / 请求体形状,确保 if (model.startsWith("xxx")) 分支覆盖
  • 模型如有特殊 endpoint,看 packages/core/src/client/endpoints.ts
  • 如果新增的是某产品入口专属能力,确认 packages/cli/src/commands.ts 或其它入口 map 是否需要暴露/隐藏

B. 类型层

  • packages/core/src/types/api.ts 的 request/response 类型如果跟模型相关,同步字段

C. 命令手册

  • 若 --model 的 description 含 default,改命令后跑 pnpm --filter bailian-cli run generate:reference 更新对应 skills/<skill>/reference/<group>.md 并提交
  • 同步拥有该命令的领域 skill「When to use which command」表中的 Default model(现主要是 bailian-gen;精调相关看 bailian-finetune 正文示例)。hub bailian-cli 已瘦身,一般不必再写领域默认模型(见 skill-change.md)

D. 用户面文档

  • README.md / README.zh.md:
    • Quick Start 示例如使用了具体型号,确认仍可用
    • 顶部 introduction 段落如提到"Qwen-Omni"等品牌名,无需变(模型代号变化不算品牌变)

E. 测试层

  • 按 cli-e2e-tests.md 维护 e2e：断言不硬编码废弃模型 ID；新模型至少一条 happy-path 集成

完成后自查

# 默认模型走通
pnpm -F bailian-cli exec tsx src/main.ts <command> --message "test"
# 显式指定新模型
pnpm -F bailian-cli exec tsx src/main.ts <command> --model <new-model> --message "test"

常见漏点

  • ✗ 改了命令默认模型,但 SKILL.md frontmatter 或领域路由表 Default model 仍写老型号 → AI agent 调用时仍按老型号宣传
  • ✗ 只改了 reference/ / flag description,忘改 bailian-gen(等) SKILL 路由表
  • ✗ 废弃模型时只删了代码,e2e 测试还在跑,CI 红
  • ✗ 新模型 endpoint 不一致,但只改了 default,没加 endpoint 分支判断