model-update

name	model-update
description	新增或更新 CCX 项目中的 Claude 模型注册。当用户提到新模型发布、添加模型、更新模型元数据、model registry、模型注册时触发。覆盖上游能力表、AgentModelProfile、优先级排序和代码生成。
version	1.0.0
author	https://github.com/BenedictKing/ccx/
allowed-tools	Bash, Read, Write, Edit, Agent
context	fork

CCX 模型注册更新技能

当用户输入包含以下关键词时触发：

• "新模型"、"添加模型"、"model registry"、"模型注册"、"添加 claude"、"新 claude"、"model update"

执行流程

0. 收集模型信息

向用户确认以下信息（可从发布文档或 skill 上下文提取）：

字段	示例
模型 ID	claude-sonnet-5
显示名	Claude Sonnet 5
上下文窗口	1000000
最大输出 tokens	128000
Thinking 模式	adaptive_only / adaptive_always_on / adaptive / extended
Reasoning efforts	["low", "medium", "high", "xhigh", "max"]
Provider	anthropic
是否更新 "sonnet"/"opus" 等 bare alias	需要用户确认

1. 更新上游能力源（single source of truth）

文件： shared/model-registry/ccx_model_registry.json

在 upstreamCapabilities 数组中插入新条目，位置按家族分组（同家族内新版本在前）：

{
  "patterns": ["(?:^|[-/])claude-<MODEL_ID>(?:-\\d{4}-\\d{2}-\\d{2}|-\\d{6,8})?(?=$|@)"],
  "provider": "anthropic",
  "displayName": "Claude <Display Name>",
  "contextWindowTokens": <N>,
  "maxOutputTokens": <N>,
  "thinkingMode": "<mode>",
  "reasoningEfforts": ["low", "medium", "high", "xhigh", "max"]
}

注意： 如果该模型存在 -thinking 变体（如 claude-sonnet-4-6-thinking），使用合并 pattern：claude-<ID>(?:-thinking)?(?:-...)?。4.6 系列以后的新模型通常不需要单独的 thinking 条目。

2. 更新后端 AgentModelProfile

文件： backend-go/internal/config/model_registry.go → BuiltinAgentModelProfiles()

添加 glob pattern 条目：

"claude-<MODEL_ID>*": {
    DisplayName:         "Claude <Display Name>",
    ContextWindowTokens: <N>,
    MaxOutputTokens:     <N>,
    ReasoningEfforts:    []string{"low", "medium", "high", "xhigh", "max"},
},

如果需要更新 bare alias（如 sonnet → sonnet-5），同步更新：

"sonnet": {
    DisplayName:         "Claude Sonnet alias",
    ContextWindowTokens: 1000000,
    MaxOutputTokens:     128000,  // 从 64000 更新到 128000
},

3. 更新模型优先级排序

文件： shared/model-priority/model-priority.ts

在 modelPriorityPatterns 数组中按正确位置插入 regex：

/sonnet-5/i,   // 新 Sonnet 5 放在 opus-4-7 之后、sonnet-4-7 之前

定位规则： Claude 家族优先级从高到低为 fable > opus > sonnet > haiku，版本号大的在前。

4. 运行代码生成

node scripts/generate-model-registry.mjs

自动更新以下三个生成文件（DO NOT EDIT）：

• backend-go/internal/config/generated_model_registry.go
• frontend/src/generated/modelRegistry.ts
• desktop/frontend/src/generated/model-registry.ts

5. 验证

1. 确认生成文件包含新模型 ID：

   grep -r "claude-<MODEL_ID>" backend-go/internal/config/generated_model_registry.go frontend/src/generated/modelRegistry.ts desktop/frontend/src/generated/model-registry.ts
   

2. 编译检查（可选）：

   cd backend-go && go build ./...
   

3. 前端类型检查（可选）：

   cd frontend && bun run type-check
   

检查清单

完成更新后逐项核对：

• ccx_model_registry.json 中新增条目且 pattern 正确
• model_registry.go 中新增 AgentModelProfile
• model-priority.ts 中正确位置插入优先级模式
• bare alias 是否需要更新（向用户确认）
• generate-model-registry.mjs 已运行，三端生成文件已更新
• 验证 grep 确认新模型 ID 出现在生成文件中