@kikkimo/claude-launcher 3.1.0 → 3.2.0

package/docs/superpowers/plans/2026-06-14-provider-model-upgrade.md

@@ -0,0 +1,949 @@
+# Provider 模型升级 Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 将 5 个 provider（anthropic、deepseek、minimax、moonshot、zhipu/zai）的模型定义升级到各家官方最新口径，新增 GLM 固定 tier template，并为已保存的旧 API 配置增加 template 漂移自动迁移。
+
+**Architecture:** 改动集中在 `lib/presets/providers.js`（provider 定义 + 新增 `makeGlmTierTemplate` factory）与 `lib/api-manager.js`（`_normalizeApiFields` 内新增漂移检测块）。漂移检测复用 `updateApiField()` 已验证的「保留用户手动覆盖」模式，改写的 3 个字段（`modelEnvVars`/`_autoModelEnvVars`/`smallFastModel`）已被 `_migrateApiEntry` 的 before/after 比较覆盖，自动触发构造函数 `saveConfig()`，无需新增保存点。
+
+**Tech Stack:** Node.js ≥20，CommonJS，原生 `assert` 测试框架（每个 test 文件是独立 `node` 脚本，`npm test` 用 `&&` 串联 14 个文件）。无外部依赖。
+
+**Spec:** `docs/superpowers/specs/2026-06-14-provider-model-upgrade-design.md`（经 Codex gpt-5.5/xhigh 评审 3 轮通过）
+
+---
+
+## File Structure
+
+| 文件 | 职责 | 本次改动 |
+|------|------|---------|
+| `lib/presets/providers.js` | 9 个 provider 预设、template factory、`getLatestModel` | 新增 `makeGlmTierTemplate`；改 anthropic/deepseek/minimax/moonshot/zhipu/zai 六个 provider 定义 |
+| `lib/api-manager.js` | API 配置增删改查、加载迁移、加密持久化 | `_normalizeApiFields`（约 :165-169 之后）新增 template 漂移检测块 |
+| `test/providers.test.js` | provider 模型列表 / versionAliases / 旗舰豁免不变量 | 更新 5 个 provider 的断言期望值 |
+| `test/env-vars-providers.test.js` | modelEnvTemplate.getValues / env vars 断言 | 更新断言 + 新增 GLM tier template 测试 + 新增 moonshot 覆盖优先级测试 |
+| `test/api-manager.test.js` | ApiManager 方法测试 | 新增 3 个漂移迁移测试 |
+| `package.json` | 版本号 | `3.1.0` → `3.2.0` |
+| `CHANGELOG.md` | 变更日志 | 新增 `[3.2.0]` 段 |
+
+**不变量（被现有测试自动守护，改动后必须仍成立）：**
+- `providers[<id>].models[0]`（旗舰）不得出现在该 provider 的 `versionAliases` key 中（`test/providers.test.js:192-202` 的 `invariant` 测试）
+- `zai` 与 `zhipu`、`minimax_global` 与 `minimax_cn` 的 `models`/`versionAliases` 必须镜像一致
+
+**测试运行约定：**
+- 单文件跑：`node test/providers.test.js`（TDD 红绿循环用）
+- 全量跑：`npm test`（14 个文件 `&&` 链，最后一个 task 前必须全绿）
+
+**Git 提交约定：**
+- 每个 Task 末尾提交一次，commit message 用 `feat:`/`fix:`/`refactor:`/`docs:` 前缀
+- **不加** `Co-Authored-By`（项目约定）
+
+---
+
+## Task 1: anthropic — 升级 opus 到 claude-opus-4-8
+
+**Files:**
+- Modify: `lib/presets/providers.js:43-65`（`anthropicModels` + `anthropic.versionAliases`）
+- Modify: `test/providers.test.js:162-174`
+- Modify: `test/env-vars-providers.test.js:11-34, 105-113`
+
+- [ ] **Step 1: 更新 `test/providers.test.js` 的 anthropic 断言（先红）**
+
+用 Edit 把这段（约 :162-174）：
+```js
+test('anthropic: models include new and legacy models', () => {
+    const p = getProvider('anthropic');
+    assert.ok(p.models.includes('claude-opus-4-7'));
+    assert.ok(p.models.includes('claude-sonnet-4-6'));
+    assert.ok(p.models.includes('claude-haiku-4-5-20251001'));
+    assert.ok(p.models.includes('claude-opus-4-6'));
+    assert.ok(p.models.includes('claude-sonnet-4-5'));
+});
+
+test('anthropic: versionAliases map opus series to opus-4-7', () => {
+    assert.strictEqual(getLatestModel('claude-opus-4', 'anthropic'), 'claude-opus-4-7');
+    assert.strictEqual(getLatestModel('claude-opus-4-6', 'anthropic'), 'claude-opus-4-7');
+});
+```
+替换为：
+```js
+test('anthropic: models include new and legacy models', () => {
+    const p = getProvider('anthropic');
+    assert.ok(p.models.includes('claude-opus-4-8'));
+    assert.ok(p.models.includes('claude-opus-4-7'));
+    assert.ok(p.models.includes('claude-sonnet-4-6'));
+    assert.ok(p.models.includes('claude-haiku-4-5-20251001'));
+    assert.ok(p.models.includes('claude-opus-4-6'));
+    assert.ok(p.models.includes('claude-sonnet-4-5'));
+});
+
+test('anthropic: versionAliases map opus series to opus-4-8', () => {
+    assert.strictEqual(getLatestModel('claude-opus-4', 'anthropic'), 'claude-opus-4-8');
+    assert.strictEqual(getLatestModel('claude-opus-4-6', 'anthropic'), 'claude-opus-4-8');
+    assert.strictEqual(getLatestModel('claude-opus-4-7', 'anthropic'), 'claude-opus-4-8');
+});
+```
+
+- [ ] **Step 2: 更新 `test/env-vars-providers.test.js` 的 anthropic 断言（先红）**
+
+把 `anthropic model list trimmed to current generation`（约 :20-25）的 `assert.strictEqual(m.length, 6)` 改为 `7`。
+
+把 `anthropic versionAlias opus-4-6 → opus-4-7`（约 :29-31）整体替换为：
+```js
+test('anthropic versionAlias opus-4-6 → opus-4-8', () => {
+    assert.strictEqual(getLatestModel('claude-opus-4-6', 'anthropic'), 'claude-opus-4-8');
+});
+```
+
+把 `anthropic template: tier-based assignment (sonnet selected)`（约 :105-113）里的 `assert.strictEqual(v.ANTHROPIC_DEFAULT_OPUS_MODEL, 'claude-opus-4-7');` 改为 `'claude-opus-4-8'`。
+
+- [ ] **Step 3: 跑测试确认失败**
+
+Run: `node test/providers.test.js && node test/env-vars-providers.test.js`
+Expected: 两个文件均有 anthropic 相关 `✗` 失败（`claude-opus-4-8` 不存在、opus-4-7 无 alias）
+
+- [ ] **Step 4: 改 `lib/presets/providers.js` 的 `anthropicModels`**
+
+把 `const anthropicModels = [...]`（:43-50）整体替换为（`claude-opus-4-8` 置顶，保证 `find('opus')` 命中最新）：
+```js
+const anthropicModels = [
+    'claude-opus-4-8',
+    'claude-opus-4-7',
+    'claude-sonnet-4-6',
+    'claude-haiku-4-5-20251001',
+    'claude-sonnet-4-5',
+    'claude-opus-4-6',
+    'claude-opus-4-5',
+];
+```
+
+- [ ] **Step 5: 改 `lib/presets/providers.js` 的 `anthropic.versionAliases`**
+
+把 `anthropic.versionAliases`（:57-65）整体替换为：
+```js
+        versionAliases: {
+            'claude-opus-4': 'claude-opus-4-8',
+            'claude-opus-4-1': 'claude-opus-4-8',
+            'claude-opus-4-5': 'claude-opus-4-8',
+            'claude-opus-4-6': 'claude-opus-4-8',
+            'claude-opus-4-7': 'claude-opus-4-8',
+            'claude-sonnet-4': 'claude-sonnet-4-6',
+            'claude-sonnet-4-5': 'claude-sonnet-4-6',
+            'claude-3-7-sonnet': 'claude-sonnet-4-6',
+        },
+```
+
+- [ ] **Step 6: 跑测试确认通过**
+
+Run: `node test/providers.test.js && node test/env-vars-providers.test.js`
+Expected: 全部 `✓`，0 failed
+
+- [ ] **Step 7: Commit**
+
+```bash
+git add lib/presets/providers.js test/providers.test.js test/env-vars-providers.test.js
+git commit -m "feat(providers): upgrade anthropic opus to claude-opus-4-8"
+```
+
+---
+
+## Task 2: deepseek — Haiku 档去掉 [1m] 后缀
+
+**Files:**
+- Modify: `lib/presets/providers.js:202-229`（`deepseek` provider）
+- Modify: `test/providers.test.js:176-183`
+- Modify: `test/env-vars-providers.test.js:37-41, 50-52, 93-104`
+
+- [ ] **Step 1: 更新 `test/providers.test.js` 的 deepseek 断言（先红）**
+
+把 `deepseek: models include v4-pro and v4-flash`（:176-183）整体替换为：
+```js
+test('deepseek: models include v4-pro[1m] and v4-flash', () => {
+    const p = getProvider('deepseek');
+    assert.ok(p.models.includes('deepseek-v4-pro[1m]'));
+    assert.ok(p.models.includes('deepseek-v4-flash'));
+    assert.ok(p.models.includes('deepseek-chat'));
+    assert.ok(p.models.includes('deepseek-reasoner'));
+    assert.strictEqual(p.models.length, 4);
+});
+```
+
+- [ ] **Step 2: 更新 `test/env-vars-providers.test.js` 的 deepseek 断言（先红）**
+
+把 `deepseek models include v4-pro[1m] and v4-flash[1m]`（:37-41）的 `assert.ok(m.includes('deepseek-v4-flash[1m]'));` 改为 `assert.ok(m.includes('deepseek-v4-flash'));`。
+
+把 `deepseek alias chat → v4-flash`（:50-52）整体替换为：
+```js
+test('deepseek alias chat → v4-flash', () => {
+    assert.strictEqual(getLatestModel('deepseek-chat', 'deepseek'), 'deepseek-v4-flash');
+});
+test('deepseek alias v4-flash[1m] → v4-flash (legacy compat)', () => {
+    assert.strictEqual(getLatestModel('deepseek-v4-flash[1m]', 'deepseek'), 'deepseek-v4-flash');
+});
+```
+
+把 `deepseek template: pro model → flash`（:93-99）整体替换为：
+```js
+test('deepseek template: pro model → flash for haiku/subagent/smallFast', () => {
+    const v = getProvider('deepseek').modelEnvTemplate.getValues('deepseek-v4-pro[1m]');
+    assert.strictEqual(v.ANTHROPIC_DEFAULT_HAIKU_MODEL, 'deepseek-v4-flash');
+    assert.strictEqual(v.CLAUDE_CODE_SUBAGENT_MODEL, 'deepseek-v4-flash');
+    assert.strictEqual(v.smallFastModel, 'deepseek-v4-flash');
+    assert.strictEqual(v.ANTHROPIC_DEFAULT_OPUS_MODEL, 'deepseek-v4-pro[1m]');
+});
+```
+
+把 `deepseek template: flash model → all flash`（:100-104）整体替换为：
+```js
+test('deepseek template: flash model → all flash', () => {
+    const v = getProvider('deepseek').modelEnvTemplate.getValues('deepseek-v4-flash');
+    assert.strictEqual(v.ANTHROPIC_DEFAULT_HAIKU_MODEL, 'deepseek-v4-flash');
+    assert.strictEqual(v.ANTHROPIC_DEFAULT_OPUS_MODEL, 'deepseek-v4-flash');
+});
+```
+
+- [ ] **Step 3: 跑测试确认失败**
+
+Run: `node test/providers.test.js && node test/env-vars-providers.test.js`
+Expected: deepseek 相关 `✗` 失败
+
+- [ ] **Step 4: 改 `lib/presets/providers.js` 的 `deepseek`**
+
+把整个 `deepseek:` provider 块（:202-229）的三个字段改为（仅列改动行，其余字段 `baseUrl`/`authTokenFormat`/`envVars`/`note` 不变）：
+
+models（:205-210）：
+```js
+        models: [
+            'deepseek-v4-pro[1m]',
+            'deepseek-v4-flash',
+            'deepseek-chat',
+            'deepseek-reasoner',
+        ],
+```
+
+versionAliases（:211-214）：
+```js
+        versionAliases: {
+            'deepseek-chat': 'deepseek-v4-flash',
+            'deepseek-reasoner': 'deepseek-v4-pro[1m]',
+            'deepseek-v4-flash[1m]': 'deepseek-v4-flash',
+        },
+```
+
+modelEnvTemplate（:227）：
+```js
+        modelEnvTemplate: makeFastMapTemplate({"deepseek-v4-pro[1m]":"deepseek-v4-flash"}),
+```
+
+- [ ] **Step 5: 跑测试确认通过**
+
+Run: `node test/providers.test.js && node test/env-vars-providers.test.js`
+Expected: 全部 `✓`
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add lib/presets/providers.js test/providers.test.js test/env-vars-providers.test.js
+git commit -m "fix(providers): align deepseek haiku tier to deepseek-v4-flash (drop [1m])"
+```
+
+---
+
+## Task 3: minimax — 新增 MiniMax-M3 旗舰
+
+**Files:**
+- Modify: `lib/presets/providers.js:142-201`（`minimax_cn` + `minimax_global`）
+- Modify: `test/providers.test.js:122-158`
+- Modify: `test/env-vars-providers.test.js:72-87`
+
+- [ ] **Step 1: 更新 `test/providers.test.js` 的 minimax 断言（先红）**
+
+把 `minimax_cn: models list includes highspeed variants and M2`（:122-132）整体替换为：
+```js
+test('minimax_cn: models list includes M3, highspeed variants and M2', () => {
+    const p = getProvider('minimax_cn');
+    assert.ok(p.models.includes('MiniMax-M3'));
+    assert.ok(p.models.includes('MiniMax-M2.7'));
+    assert.ok(p.models.includes('MiniMax-M2.7-highspeed'));
+    assert.ok(p.models.includes('MiniMax-M2.5'));
+    assert.ok(p.models.includes('MiniMax-M2.5-highspeed'));
+    assert.ok(p.models.includes('MiniMax-M2.1'));
+    assert.ok(p.models.includes('MiniMax-M2.1-highspeed'));
+    assert.ok(p.models.includes('MiniMax-M2'));
+    assert.strictEqual(p.models.length, 8);
+});
+```
+
+把 `minimax_cn: MiniMax-M2.1 aliases to MiniMax-M2.7`（:134-138）整体替换为：
+```js
+test('minimax_cn: MiniMax-M2.1 aliases to MiniMax-M3', () => {
+    assert.strictEqual(getLatestModel('MiniMax-M2.1', 'minimax_cn'), 'MiniMax-M3');
+});
+```
+
+把 `minimax_cn: MiniMax-M2.5 aliases to MiniMax-M2.7`（:140-142）整体替换为：
+```js
+test('minimax_cn: MiniMax-M2.5 aliases to MiniMax-M3', () => {
+    assert.strictEqual(getLatestModel('MiniMax-M2.5', 'minimax_cn'), 'MiniMax-M3');
+});
+test('minimax_cn: MiniMax-M2.7 aliases to MiniMax-M3', () => {
+    assert.strictEqual(getLatestModel('MiniMax-M2.7', 'minimax_cn'), 'MiniMax-M3');
+});
+```
+
+把 `minimax_cn: latest MiniMax-M2.7 has no alias`（:144-146）整体替换为：
+```js
+test('minimax_cn: latest MiniMax-M3 has no alias', () => {
+    assert.strictEqual(getLatestModel('MiniMax-M3', 'minimax_cn'), null);
+});
+```
+
+- [ ] **Step 2: 更新 `test/env-vars-providers.test.js` 的 minimax 断言（先红）**
+
+在 `minimax_cn models include highspeed variants and M2`（:72-78）的断言块末尾，`assert.ok(m.includes('MiniMax-M2'));` 之后加一行：
+```js
+    assert.ok(m.includes('MiniMax-M3'));
+```
+
+- [ ] **Step 3: 跑测试确认失败**
+
+Run: `node test/providers.test.js && node test/env-vars-providers.test.js`
+Expected: minimax 相关 `✗` 失败
+
+- [ ] **Step 4: 改 `lib/presets/providers.js` 的 `minimax_cn`**
+
+把 `minimax_cn` 的 models（:145-153）首元素前加 `'MiniMax-M3',`：
+```js
+        models: [
+            'MiniMax-M3',
+            'MiniMax-M2.7',
+            'MiniMax-M2.7-highspeed',
+            'MiniMax-M2.5',
+            'MiniMax-M2.5-highspeed',
+            'MiniMax-M2.1',
+            'MiniMax-M2.1-highspeed',
+            'MiniMax-M2',
+        ],
+```
+
+把 `minimax_cn` 的 versionAliases（:154-157）整体替换为：
+```js
+        versionAliases: {
+            'MiniMax-M2': 'MiniMax-M3',
+            'MiniMax-M2.1': 'MiniMax-M3',
+            'MiniMax-M2.5': 'MiniMax-M3',
+            'MiniMax-M2.7': 'MiniMax-M3'
+        },
+```
+
+> `modelEnvTemplate`（:169 `makeFastMapTemplate({M2.x→M2.x-highspeed})`）**不改**：M3 不在 fastMap 中，`fastMap[model] || model` 回退到 M3 自身，所有 tier 均映射 M3。
+
+- [ ] **Step 5: 改 `lib/presets/providers.js` 的 `minimax_global`（与 cn 镜像一致）**
+
+对 `minimax_global`（:172-201）做与 `minimax_cn` 完全相同的两处改动（models 加 `'MiniMax-M3'`、versionAliases 四个目标全改 `MiniMax-M3`）。
+
+- [ ] **Step 6: 跑测试确认通过**
+
+Run: `node test/providers.test.js && node test/env-vars-providers.test.js`
+Expected: 全部 `✓`（含 `minimax_global: versionAliases matches minimax_cn` 镜像断言）
+
+- [ ] **Step 7: Commit**
+
+```bash
+git add lib/presets/providers.js test/providers.test.js test/env-vars-providers.test.js
+git commit -m "feat(providers): add MiniMax-M3 as minimax flagship"
+```
+
+---
+
+## Task 4: moonshot — 收敛为单一旗舰 kimi-k2.7-code + env vars
+
+**Files:**
+- Modify: `lib/presets/providers.js:91-121`（`moonshot` provider）
+- Modify: `test/providers.test.js:83-118`
+- Modify: `test/env-vars-providers.test.js:60-69`
+
+- [ ] **Step 1: 更新 `test/providers.test.js` 的 moonshot 断言（先红）**
+
+把 `moonshot: models list includes kimi-k2.6`（:83-90）整体替换为：
+```js
+test('moonshot: models list is single flagship kimi-k2.7-code', () => {
+    const p = getProvider('moonshot');
+    assert.ok(p.models.includes('kimi-k2.7-code'));
+    assert.strictEqual(p.models.length, 1);
+});
+```
+
+把 :92-118 的所有 moonshot alias 测试（`kimi-k2-0711-preview`、`kimi-k2-0905-preview`、`kimi-k2-turbo-preview`、`kimi-k2-thinking`、`kimi-k2-thinking-turbo`、`kimi-k2.5` → `kimi-k2.6`，以及 `kimi-k2.6 has no alias`）整体替换为：
+```js
+test('moonshot: kimi-k2.6 aliases to kimi-k2.7-code', () => {
+    assert.strictEqual(getLatestModel('kimi-k2.6', 'moonshot'), 'kimi-k2.7-code');
+});
+
+test('moonshot: kimi-k2.5 aliases to kimi-k2.7-code', () => {
+    assert.strictEqual(getLatestModel('kimi-k2.5', 'moonshot'), 'kimi-k2.7-code');
+});
+
+test('moonshot: kimi-k2-thinking aliases to kimi-k2.7-code', () => {
+    assert.strictEqual(getLatestModel('kimi-k2-thinking', 'moonshot'), 'kimi-k2.7-code');
+});
+
+test('moonshot: kimi-k2-thinking-turbo aliases to kimi-k2.7-code', () => {
+    assert.strictEqual(getLatestModel('kimi-k2-thinking-turbo', 'moonshot'), 'kimi-k2.7-code');
+});
+
+test('moonshot: kimi-k2-0711-preview aliases to kimi-k2.7-code', () => {
+    assert.strictEqual(getLatestModel('kimi-k2-0711-preview', 'moonshot'), 'kimi-k2.7-code');
+});
+
+test('moonshot: kimi-k2-0905-preview aliases to kimi-k2.7-code', () => {
+    assert.strictEqual(getLatestModel('kimi-k2-0905-preview', 'moonshot'), 'kimi-k2.7-code');
+});
+
+test('moonshot: kimi-k2-turbo-preview aliases to kimi-k2.7-code', () => {
+    assert.strictEqual(getLatestModel('kimi-k2-turbo-preview', 'moonshot'), 'kimi-k2.7-code');
+});
+
+test('moonshot: latest kimi-k2.7-code has no alias', () => {
+    assert.strictEqual(getLatestModel('kimi-k2.7-code', 'moonshot'), null);
+});
+```
+
+- [ ] **Step 2: 更新 `test/env-vars-providers.test.js` 的 moonshot 断言（先红）**
+
+把 `moonshot models include kimi-k2.6`（:61-63）替换为：
+```js
+test('moonshot models include kimi-k2.7-code', () => {
+    assert.ok(getProvider('moonshot').models.includes('kimi-k2.7-code'));
+});
+```
+
+把 `moonshot alias k2-thinking → k2.6`（:64-66）替换为：
+```js
+test('moonshot alias k2-thinking → k2.7-code', () => {
+    assert.strictEqual(getLatestModel('kimi-k2-thinking', 'moonshot'), 'kimi-k2.7-code');
+});
+```
+
+- [ ] **Step 3: 跑测试确认失败**
+
+Run: `node test/providers.test.js && node test/env-vars-providers.test.js`
+Expected: moonshot 相关 `✗` 失败
+
+- [ ] **Step 4: 改 `lib/presets/providers.js` 的 `moonshot`**
+
+把整个 `moonshot:` provider 块（:91-121）的对应字段改为：
+
+name（:92）：
+```js
+        name: 'Moonshot AI (Kimi-K2.7-Code)',
+```
+
+models（:94-99）：
+```js
+        models: [
+            'kimi-k2.7-code',
+        ],
+```
+
+versionAliases（:100-107）：
+```js
+        versionAliases: {
+            'kimi-k2.6': 'kimi-k2.7-code',
+            'kimi-k2.5': 'kimi-k2.7-code',
+            'kimi-k2-thinking': 'kimi-k2.7-code',
+            'kimi-k2-thinking-turbo': 'kimi-k2.7-code',
+            'kimi-k2-0711-preview': 'kimi-k2.7-code',
+            'kimi-k2-0905-preview': 'kimi-k2.7-code',
+            'kimi-k2-turbo-preview': 'kimi-k2.7-code',
+        },
+```
+
+envVars（:112-118，在末尾 `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK: '1'` 之后加两行）：
+```js
+        envVars: {
+            API_TIMEOUT_MS: '3000000',
+            CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '1',
+            CLAUDE_CODE_ATTRIBUTION_HEADER: '0',
+            CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: '1',
+            CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK: '1',
+            ENABLE_TOOL_SEARCH: 'false',
+            CLAUDE_CODE_AUTO_COMPACT_WINDOW: '262144',
+        },
+```
+
+modelEnvTemplate（:119）：
+```js
+        modelEnvTemplate: makeSingleTemplate(),
+```
+
+- [ ] **Step 5: 跑测试确认通过**
+
+Run: `node test/providers.test.js && node test/env-vars-providers.test.js`
+Expected: 全部 `✓`
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add lib/presets/providers.js test/providers.test.js test/env-vars-providers.test.js
+git commit -m "feat(providers): converge moonshot to single flagship kimi-k2.7-code"
+```
+
+---
+
+## Task 5: zhipu/zai — 升级到 glm-5.2[1m] + 新增 makeGlmTierTemplate
+
+**Files:**
+- Modify: `lib/presets/providers.js`（新增 factory 在 :40 之后；改 `zhipu` :230-259、`zai` :260-289）
+- Modify: `test/providers.test.js:30-79`
+- Modify: `test/env-vars-providers.test.js`（新增 GLM tier template 测试）
+
+- [ ] **Step 1: 更新 `test/providers.test.js` 的 zhipu/zai 断言（先红）**
+
+把 `zhipu: models list is correct`（:32-35）替换为：
+```js
+test('zhipu: models list is correct', () => {
+    const p = getProvider('zhipu');
+    assert.deepStrictEqual(p.models, ['glm-5.2[1m]', 'glm-5.1', 'glm-5-turbo', 'glm-5']);
+});
+```
+
+把 `zhipu: name includes all current model families`（:37-41）替换为：
+```js
+test('zhipu: name includes all current model families', () => {
+    const p = getProvider('zhipu');
+    assert.ok(p.name.includes('GLM-5.2'));
+    assert.ok(p.name.includes('5-Turbo'));
+});
+```
+
+把 :43-65 的整段 zhipu alias 测试（`glm-4.5`/`glm-4.6`/`glm-4.7`/`glm-5`/`glm-5-turbo` aliases to glm-5.1，及 `glm-5.1 has no alias`）整体替换为：
+```js
+test('zhipu: glm-4.5 aliases to glm-5.2[1m]', () => {
+    assert.strictEqual(getLatestModel('glm-4.5', 'zhipu'), 'glm-5.2[1m]');
+});
+
+test('zhipu: glm-4.6 aliases to glm-5.2[1m]', () => {
+    assert.strictEqual(getLatestModel('glm-4.6', 'zhipu'), 'glm-5.2[1m]');
+});
+
+test('zhipu: glm-4.7 aliases to glm-5.2[1m]', () => {
+    assert.strictEqual(getLatestModel('glm-4.7', 'zhipu'), 'glm-5.2[1m]');
+});
+
+test('zhipu: glm-5 (tier role) has no alias', () => {
+    assert.strictEqual(getLatestModel('glm-5', 'zhipu'), null);
+});
+
+test('zhipu: glm-5-turbo (haiku tier) has no alias', () => {
+    assert.strictEqual(getLatestModel('glm-5-turbo', 'zhipu'), null);
+});
+
+test('zhipu: glm-5.1 (optional retained) has no alias', () => {
+    assert.strictEqual(getLatestModel('glm-5.1', 'zhipu'), null);
+});
+
+test('zhipu: latest glm-5.2[1m] has no alias', () => {
+    assert.strictEqual(getLatestModel('glm-5.2[1m]', 'zhipu'), null);
+});
+```
+
+> `zai` 镜像断言（:67-79，`models list matches zhipu` / `versionAliases matches zhipu`）**不改**——它们自动验证 zai 与 zhipu 一致。
+
+- [ ] **Step 2: 新增 `test/env-vars-providers.test.js` 的 GLM tier template 测试（先红）**
+
+在该文件末尾 `console.log(...)` 汇总行**之前**插入：
+```js
+// --- GLM tier template (fixed tiers regardless of selected model) ---
+test('glm tier template: opus=sonnet=glm-5.2[1m], haiku=glm-5-turbo when flagship selected', () => {
+    const v = getProvider('zhipu').modelEnvTemplate.getValues('glm-5.2[1m]');
+    assert.strictEqual(v.ANTHROPIC_CUSTOM_MODEL_OPTION, 'glm-5.2[1m]');
+    assert.strictEqual(v.ANTHROPIC_DEFAULT_OPUS_MODEL, 'glm-5.2[1m]');
+    assert.strictEqual(v.ANTHROPIC_DEFAULT_SONNET_MODEL, 'glm-5.2[1m]');
+    assert.strictEqual(v.ANTHROPIC_DEFAULT_HAIKU_MODEL, 'glm-5-turbo');
+    assert.strictEqual(v.CLAUDE_CODE_SUBAGENT_MODEL, 'glm-5-turbo');
+    assert.strictEqual(v.smallFastModel, 'glm-5-turbo');
+});
+test('glm tier template: tiers stay fixed when non-flagship model selected', () => {
+    const v = getProvider('zhipu').modelEnvTemplate.getValues('glm-5');
+    assert.strictEqual(v.ANTHROPIC_CUSTOM_MODEL_OPTION, 'glm-5');
+    assert.strictEqual(v.ANTHROPIC_DEFAULT_OPUS_MODEL, 'glm-5.2[1m]');
+    assert.strictEqual(v.ANTHROPIC_DEFAULT_SONNET_MODEL, 'glm-5.2[1m]');
+    assert.strictEqual(v.ANTHROPIC_DEFAULT_HAIKU_MODEL, 'glm-5-turbo');
+});
+test('glm tier template: zai uses same factory as zhipu', () => {
+    const vz = getProvider('zhipu').modelEnvTemplate.getValues('glm-5.1');
+    const va = getProvider('zai').modelEnvTemplate.getValues('glm-5.1');
+    assert.deepStrictEqual(va, vz);
+});
+```
+
+- [ ] **Step 3: 跑测试确认失败**
+
+Run: `node test/providers.test.js && node test/env-vars-providers.test.js`
+Expected: zhipu 相关 `✗` 失败（models/alias/template 均不符）
+
+- [ ] **Step 4: 在 `lib/presets/providers.js` 新增 `makeGlmTierTemplate` factory**
+
+在 `makeSingleTemplate()` 函数闭合（:40 的 `}`）之后、`const anthropicModels`（:42）之前插入：
+```js
+// Template factory: GLM — fixed tier standards (Opus=Sonnet=flagship, Haiku=turbo),
+// regardless of which model the user picked as CUSTOM. Matches Claude Code's
+// "tier standards are fixed, CUSTOM is the current selection" semantics.
+function makeGlmTierTemplate() {
+    return {
+        getValues(model) {
+            return {
+                ANTHROPIC_CUSTOM_MODEL_OPTION: model,
+                ANTHROPIC_CUSTOM_MODEL_OPTION_NAME: model,
+                ANTHROPIC_DEFAULT_OPUS_MODEL:   'glm-5.2[1m]',
+                ANTHROPIC_DEFAULT_SONNET_MODEL: 'glm-5.2[1m]',
+                ANTHROPIC_DEFAULT_HAIKU_MODEL:  'glm-5-turbo',
+                CLAUDE_CODE_SUBAGENT_MODEL:     'glm-5-turbo',
+                smallFastModel:                 'glm-5-turbo',
+            };
+        },
+    };
+}
+
+```
+
+- [ ] **Step 5: 改 `lib/presets/providers.js` 的 `zhipu`**
+
+把 `zhipu` 的 name（:231）改为：
+```js
+        name: 'ZhiPu AI (GLM-5.2/5-Turbo) - 智谱清言',
+```
+
+把 models（:233-238）改为：
+```js
+        models: [
+            'glm-5.2[1m]',
+            'glm-5.1',
+            'glm-5-turbo',
+            'glm-5'
+        ],
+```
+
+把 versionAliases（:239-245）改为：
+```js
+        versionAliases: {
+            'glm-4.5': 'glm-5.2[1m]',
+            'glm-4.6': 'glm-5.2[1m]',
+            'glm-4.7': 'glm-5.2[1m]',
+        },
+```
+
+把 envVars（:250-256，在末尾 `CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK: '1'` 之后加一行）：
+```js
+        envVars: {
+            API_TIMEOUT_MS: '3000000',
+            CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: '1',
+            CLAUDE_CODE_ATTRIBUTION_HEADER: '0',
+            CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS: '1',
+            CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK: '1',
+            CLAUDE_CODE_AUTO_COMPACT_WINDOW: '1000000',
+        },
+```
+
+把 modelEnvTemplate（:257）改为：
+```js
+                modelEnvTemplate: makeGlmTierTemplate(),
+```
+
+- [ ] **Step 6: 改 `lib/presets/providers.js` 的 `zai`（与 zhipu 镜像一致）**
+
+把 `zai` 的 name（:261）改为：
+```js
+        name: 'Z.ai (GLM-5.2/5-Turbo) - ZhiPu Global',
+```
+
+对 `zai` 的 models（:263-268）、versionAliases（:269-275）、envVars（:280-286，末尾加 `CLAUDE_CODE_AUTO_COMPACT_WINDOW: '1000000',`）、modelEnvTemplate（:287）做与 `zhipu` 完全相同的改动。
+
+- [ ] **Step 7: 跑测试确认通过**
+
+Run: `node test/providers.test.js && node test/env-vars-providers.test.js`
+Expected: 全部 `✓`
+
+- [ ] **Step 8: Commit**
+
+```bash
+git add lib/presets/providers.js test/providers.test.js test/env-vars-providers.test.js
+git commit -m "feat(providers): upgrade zhipu/zai to glm-5.2[1m] with fixed tier template"
+```
+
+---
+
+## Task 6: api-manager — template 漂移检测
+
+**Files:**
+- Modify: `lib/api-manager.js:165-169`（`_normalizeApiFields` 的 smallFastModel sync 之后插入漂移检测块）
+- Modify: `test/api-manager.test.js`（末尾汇总行之前新增 3 个测试）
+
+**背景：** 当 provider template 升级（如本次 GLM 从 fastMap 改为固定 tier），已保存的旧 API 配置的 `_autoModelEnvVars` 仍是旧快照。`_normalizeApiFields` 现有逻辑只在 `_autoModelEnvVars` 缺失时重建、否则仅补缺失 key，不会刷新已存在但过时的字段。漂移检测在「快照已存在」时比较快照与当前 template，发现不一致则刷新仍等于旧快照的字段（保留用户手动覆盖）。
+
+- [ ] **Step 1: 在 `test/api-manager.test.js` 新增 3 个漂移测试（先红）**
+
+在文件末尾 `console.log(\`\n  ${passed} passed, ${failed} failed\n\`);`（:185）**之前**插入：
+```js
+// --- template drift migration (_migrateApiEntry / _normalizeApiFields) ---
+
+console.log('\ntemplate drift migration:');
+
+function makeOldGlmFastMapSnapshot() {
+    // 升级前 makeFastMapTemplate({"glm-5.1":"glm-5-turbo"}) 对 glm-5.1 生成的快照
+    return {
+        ANTHROPIC_CUSTOM_MODEL_OPTION: 'glm-5.1',
+        ANTHROPIC_CUSTOM_MODEL_OPTION_NAME: 'glm-5.1',
+        ANTHROPIC_DEFAULT_SONNET_MODEL: 'glm-5.1',
+        ANTHROPIC_DEFAULT_OPUS_MODEL: 'glm-5.1',
+        ANTHROPIC_DEFAULT_HAIKU_MODEL: 'glm-5-turbo',
+        CLAUDE_CODE_SUBAGENT_MODEL: 'glm-5-turbo',
+        smallFastModel: 'glm-5-turbo',
+    };
+}
+
+test('_migrateApiEntry drifts zhipu glm-5.1: tier refreshed to glm-5.2[1m], migrated=true', () => {
+    const { PREDEFINED_MODEL_ENV_KEYS, PREDEFINED_RUNTIME_KEYS } = require('../lib/validators');
+    const mgr = new ApiManager();
+    mgr.saveConfig = () => {};
+    const oldAuto = makeOldGlmFastMapSnapshot();
+    const api = {
+        provider: 'zhipu', model: 'glm-5.1',
+        modelEnvVars: { ...oldAuto },
+        _autoModelEnvVars: { ...oldAuto },
+        smallFastModel: 'glm-5-turbo',
+        runtimeEnvVars: {}, _runtimeEnvSources: {}, customEnvVars: {},
+    };
+    const migrated = mgr._migrateApiEntry(api, PREDEFINED_MODEL_ENV_KEYS, PREDEFINED_RUNTIME_KEYS);
+    assert.strictEqual(migrated, true);
+    assert.strictEqual(api.modelEnvVars.ANTHROPIC_DEFAULT_OPUS_MODEL, 'glm-5.2[1m]');
+    assert.strictEqual(api.modelEnvVars.ANTHROPIC_DEFAULT_SONNET_MODEL, 'glm-5.2[1m]');
+    assert.strictEqual(api.modelEnvVars.ANTHROPIC_DEFAULT_HAIKU_MODEL, 'glm-5-turbo');
+    assert.strictEqual(api._autoModelEnvVars.ANTHROPIC_DEFAULT_OPUS_MODEL, 'glm-5.2[1m]');
+    assert.strictEqual(api.smallFastModel, 'glm-5-turbo');
+});
+
+test('_migrateApiEntry drifts: preserves user manual HAIKU override', () => {
+    const { PREDEFINED_MODEL_ENV_KEYS, PREDEFINED_RUNTIME_KEYS } = require('../lib/validators');
+    const mgr = new ApiManager();
+    mgr.saveConfig = () => {};
+    const oldAuto = makeOldGlmFastMapSnapshot();
+    // 用户手动把 HAIKU 设为 glm-5.1（≠ 旧 auto 的 glm-5-turbo）→ 漂移后应保留
+    const overridden = { ...oldAuto, ANTHROPIC_DEFAULT_HAIKU_MODEL: 'glm-5.1' };
+    const api = {
+        provider: 'zhipu', model: 'glm-5.1',
+        modelEnvVars: overridden,
+        _autoModelEnvVars: { ...oldAuto },
+        smallFastModel: 'glm-5-turbo',
+        runtimeEnvVars: {}, _runtimeEnvSources: {}, customEnvVars: {},
+    };
+    mgr._migrateApiEntry(api, PREDEFINED_MODEL_ENV_KEYS, PREDEFINED_RUNTIME_KEYS);
+    assert.strictEqual(api.modelEnvVars.ANTHROPIC_DEFAULT_HAIKU_MODEL, 'glm-5.1');
+    // 未被覆盖的 OPUS 仍刷新
+    assert.strictEqual(api.modelEnvVars.ANTHROPIC_DEFAULT_OPUS_MODEL, 'glm-5.2[1m]');
+});
+
+test('_normalizeApiFields no drift: tier values unchanged when snapshot matches template', () => {
+    const { getProvider } = require('../lib/presets/providers');
+    const mgr = new ApiManager();
+    mgr.saveConfig = () => {};
+    const currentTemplate = getProvider('zhipu').modelEnvTemplate.getValues('glm-5.2[1m]');
+    const api = {
+        provider: 'zhipu', model: 'glm-5.2[1m]',
+        modelEnvVars: { ...currentTemplate },
+        _autoModelEnvVars: { ...currentTemplate },
+        smallFastModel: currentTemplate.smallFastModel,
+        runtimeEnvVars: {}, _runtimeEnvSources: {}, customEnvVars: {},
+    };
+    mgr._normalizeApiFields(api);
+    assert.strictEqual(api.modelEnvVars.ANTHROPIC_DEFAULT_OPUS_MODEL, 'glm-5.2[1m]');
+    assert.strictEqual(api.modelEnvVars.ANTHROPIC_DEFAULT_SONNET_MODEL, 'glm-5.2[1m]');
+    assert.strictEqual(api.modelEnvVars.ANTHROPIC_DEFAULT_HAIKU_MODEL, 'glm-5-turbo');
+    assert.strictEqual(api._autoModelEnvVars.ANTHROPIC_DEFAULT_OPUS_MODEL, 'glm-5.2[1m]');
+});
+```
+
+> 注：第 3 个测试直接调 `_normalizeApiFields` 而非 `_migrateApiEntry`，因为 `_migrateApiEntry` 的 before/after 还会捕获 runtime 字段规范化（空对象 → 填充 6 key）导致 `migrated=true`，无法纯粹反映「无漂移」。核心验证目标是「快照与 template 一致时 tier 值不被改写」，用 `_normalizeApiFields` 直接断言最稳健。
+
+- [ ] **Step 2: 跑测试确认失败**
+
+Run: `node test/api-manager.test.js`
+Expected: 前两个 `✗` 失败（OPUS 仍是 `glm-5.1`，漂移未触发）；第三个 `✓`（当前 template 快照本就不变）
+
+- [ ] **Step 3: 在 `lib/api-manager.js` 的 `_normalizeApiFields` 插入漂移检测块**
+
+找到 smallFastModel sync 段（:165-169）：
+```js
+        // smallFastModel — sync with template
+        if (!api.smallFastModel || typeof api.smallFastModel !== 'string'
+            || !hadAutoModelEnvVars || smallFastWasFixed) {
+            api.smallFastModel = template.smallFastModel;
+        }
+```
+在其**之后**（即 `}` 闭合后的空行处，:170 位置，runtime 段 `// runtimeEnvVars` 之前）插入：
+```js
+
+        // template 漂移检测：provider template 升级后首次加载旧配置时，_autoModelEnvVars
+        // 仍是旧快照。检测到漂移则刷新仍等于旧快照的 tier 字段（保留用户手动覆盖），
+        // 复用 updateApiField() 的保留覆盖模式。_migrateApiEntry 的 before/after 比较
+        // 已覆盖 modelEnvVars/_autoModelEnvVars/smallFastModel，会据此返回 migrated=true
+        // 并由构造函数统一 saveConfig()。
+        if (hadAutoModelEnvVars) {
+            let drifted = false;
+            for (const k of PREDEFINED_MODEL_ENV_KEYS) {
+                if (api._autoModelEnvVars[k] !== template[k]) { drifted = true; break; }
+            }
+            if (!drifted && api._autoModelEnvVars.smallFastModel !== template.smallFastModel) {
+                drifted = true;
+            }
+            if (drifted) {
+                for (const k of PREDEFINED_MODEL_ENV_KEYS) {
+                    if (api.modelEnvVars[k] === api._autoModelEnvVars[k]) {
+                        api.modelEnvVars[k] = template[k] || '';
+                    }
+                }
+                if (api.smallFastModel === api._autoModelEnvVars.smallFastModel) {
+                    api.smallFastModel = template.smallFastModel;
+                }
+                api._autoModelEnvVars = { ...template };
+            }
+        }
+```
+
+> 实现要点：`PREDEFINED_MODEL_ENV_KEYS` 已在函数顶部 :112 解构，直接复用。守卫 `hadAutoModelEnvVars`（:116）确保仅对「已存在旧快照」的配置生效；`_autoModelEnvVars` 缺失的配置走 :131 重建分支，天然等于当前 template，不触发漂移。
+
+- [ ] **Step 4: 跑测试确认通过**
+
+Run: `node test/api-manager.test.js`
+Expected: 全部 `✓`（含 3 个新漂移测试）
+
+- [ ] **Step 5: 跑全量回归确认无副作用**
+
+Run: `npm test`
+Expected: 14 个文件全部 0 failed
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add lib/api-manager.js test/api-manager.test.js
+git commit -m "feat(api-manager): auto-refresh tier defaults on provider template drift"
+```
+
+---
+
+## Task 7: moonshot env vars 覆盖优先级测试
+
+**Files:**
+- Modify: `test/env-vars-providers.test.js`（新增 2 个 `getProviderEnvVars` 测试）
+
+**背景：** moonshot 新增的 `ENABLE_TOOL_SEARCH` / `CLAUDE_CODE_AUTO_COMPACT_WINDOW` 是 provider-only 默认（不在 `PREDEFINED_RUNTIME_KEYS` 白名单，Runtime UI 不暴露）。用户若需覆盖走 Custom Vars（`launcher.js:260-265` 的 customEnvVars 合并在 provider envVars 之后，且这两个 key 不在 `allPredefined` 集合，可覆盖）。本测试固化该优先级，防回归。
+
+- [ ] **Step 1: 在 `test/env-vars-providers.test.js` 顶部加 require**
+
+在现有 `const { getProvider, getLatestModel } = require('../lib/presets/providers');`（:8）之后加：
+```js
+const { getProviderEnvVars } = require('../lib/launcher');
+const { encrypt } = require('../lib/crypto');
+
+function makeMoonshotApi(customEnvVars = {}) {
+    return {
+        provider: 'moonshot',
+        baseUrl: 'https://api.moonshot.cn/anthropic',
+        authToken: encrypt('test-token').value,
+        model: 'kimi-k2.7-code',
+        smallFastModel: 'kimi-k2.7-code',
+        modelEnvVars: {},
+        runtimeEnvVars: {},
+        customEnvVars,
+    };
+}
+```
+
+> 若 `require('../lib/launcher')` 在该测试环境触发 UI 初始化副作用导致报错，则把这两个测试连同 require 移到 `test/launcher.test.js` 末尾汇总行之前（该文件已 require launcher，无此风险）。优先尝试放 `env-vars-providers.test.js`（与其它 provider 行为测试同文件更内聚）。
+
+- [ ] **Step 2: 在该文件末尾汇总行之前新增 2 个测试**
+
+在 `console.log(...)` 汇总行**之前**插入：
+```js
+// --- moonshot provider-default env vars vs Custom Vars override priority ---
+
+test('moonshot getProviderEnvVars: emits provider defaults ENABLE_TOOL_SEARCH / AUTO_COMPACT_WINDOW', () => {
+    const env = getProviderEnvVars(makeMoonshotApi());
+    assert.strictEqual(env.ENABLE_TOOL_SEARCH, 'false');
+    assert.strictEqual(env.CLAUDE_CODE_AUTO_COMPACT_WINDOW, '262144');
+});
+
+test('moonshot getProviderEnvVars: customEnvVars overrides provider default', () => {
+    const env = getProviderEnvVars(makeMoonshotApi({ ENABLE_TOOL_SEARCH: 'true' }));
+    assert.strictEqual(env.ENABLE_TOOL_SEARCH, 'true');
+});
+```
+
+- [ ] **Step 3: 跑测试确认通过**
+
+Run: `node test/env-vars-providers.test.js`
+Expected: 全部 `✓`（launcher.js 的合并优先级已是现有行为，测试应直接通过——这是回归保护测试）
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add test/env-vars-providers.test.js
+git commit -m "test(providers): cover moonshot provider-default vs custom override priority"
+```
+
+---
+
+## Task 8: 版本号 + CHANGELOG
+
+**Files:**
+- Modify: `package.json:3`
+- Modify: `CHANGELOG.md`（顶部 [3.1.0] 之前插入 [3.2.0] 段）
+
+- [ ] **Step 1: 更新 `package.json` 版本**
+
+把 `"version": "3.1.0",`（:3）改为 `"version": "3.2.0",`。
+
+- [ ] **Step 2: 在 `CHANGELOG.md` 顶部插入 [3.2.0] 段**
+
+在 `## [3.1.0] - 2026-05-09`（:8）**之前**插入：
+```markdown
+## [3.2.0] - 2026-06-14
+
+### Added
+- **New Flagship Models**: `claude-opus-4-8` (anthropic), `kimi-k2.7-code` (moonshot), `MiniMax-M3` (minimax), `glm-5.2[1m]` (zhipu/zai).
+- **Provider Template Drift Migration**: On first load after a provider template upgrade, saved API configs now auto-refresh tier defaults (`ANTHROPIC_DEFAULT_OPUS_MODEL` etc.) while preserving user manual overrides. Backed by `_normalizeApiFields` drift detection; persistence flows through the existing `_migrateApiEntry` → constructor `saveConfig()` lifecycle.
+
+### Changed
+- **GLM Fixed Tier Template**: zhipu/zai now use a fixed tier template (`Opus = Sonnet = glm-5.2[1m]`, `Haiku = glm-5-turbo`) regardless of selected model, replacing the old `glm-5.1 → glm-5-turbo` fast map. `glm-5.1` retained as an optional model (no upgrade alias).
+- **DeepSeek Haiku Alignment**: Haiku tier standardized to `deepseek-v4-flash` (dropped `[1m]`); legacy `deepseek-v4-flash[1m]` configs auto-upgrade via alias.
+- **Moonshot Single Flagship**: Converged to `kimi-k2.7-code` as the sole model; legacy `kimi-k2.6`/`k2.5`/`k2-thinking`/`k2-thinking-turbo`/preview variants now upgrade aliases. Added `ENABLE_TOOL_SEARCH: 'false'` and `CLAUDE_CODE_AUTO_COMPACT_WINDOW: '262144'` (provider-only defaults; override via Custom Vars).
+- **GLM Context Window**: zhipu/zai added `CLAUDE_CODE_AUTO_COMPACT_WINDOW: '1000000'` to match the 1M context of `glm-5.2[1m]`.
+
+### Removed
+- **Moonshot Main List**: Removed `kimi-k2.5`/`kimi-k2-thinking`/`kimi-k2-thinking-turbo` from the model list (retained as upgrade aliases).
+
+```
+
+- [ ] **Step 3: 跑全量测试最终验证**
+
+Run: `npm test`
+Expected: 14 个文件全部 0 failed
+
+- [ ] **Step 4: Commit**
+
+```bash
+git add package.json CHANGELOG.md
+git commit -m "chore: bump version to 3.2.0 and update changelog"
+```
+
+---
+
+## 验收清单（全部 Task 完成后核对）
+
+- [ ] `npm test` 14 个文件全部 0 failed
+- [ ] `getLatestModel('claude-opus-4-7','anthropic') === 'claude-opus-4-8'`
+- [ ] `getLatestModel('glm-4.7','zhipu') === 'glm-5.2[1m]'`，且 `getLatestModel('glm-5','zhipu') === null`
+- [ ] `getLatestModel('kimi-k2.6','moonshot') === 'kimi-k2.7-code'`，且 `getLatestModel('kimi-k2.7-code','moonshot') === null`
+- [ ] `getLatestModel('MiniMax-M2.7','minimax_cn') === 'MiniMax-M3'`
+- [ ] `getLatestModel('deepseek-v4-flash[1m]','deepseek') === 'deepseek-v4-flash'`
+- [ ] 每个 provider 的 `models[0]` 不在该 provider 的 `versionAliases` key 中（`invariant` 测试守护）
+- [ ] 加载一个升级前保存的旧配置（`provider=zhipu, model=glm-5.1`），`_migrateApiEntry` 返回 `migrated=true`，`modelEnvVars.ANTHROPIC_DEFAULT_OPUS_MODEL === 'glm-5.2[1m]'`