# Changelog

**Kimi Switch** — Windows 桌面端的 Kimi Code CLI 配置管理器，统一管理多家 LLM 供应商、模型、图标、连通性、用量统计与版本更新。

本文件汇总各版本要点，按版本倒序排列；每个版本的**完整 release notes**（含安装说明、平台产物、已知问题）见 [`docs/release-notes/`](./docs/release-notes/)。

---

## v0.8.0 (2026-10-03)

- **模型映射新增「最大输出 Token」列**：逐模型设置 `max_output_size`（写入 config.toml，留空用上游默认），models.dev 有 output 上限时显示可点击参考值一键填入；获取模型列表时自动预填
- **models.dev 快照新增 output 上限字段**：同步至 2026-10-03（8,385 模型 / 226 供应商，output 覆盖 97.4%）；应用内同步（Rust 侧）同步支持，避免同步后字段丢失
- **移除无效的「声明支持 1M」复选框**：该控件读时由上下文长度派生、写时不持久化，勾选从不生效，由「最大输出 Token」列取代

## v0.7.23 (2026-09-30)

- **思考等级五档 + 能力感知**：全局配置的思考等级扩展为低 / 中 / 高 / Max / XHigh，按当前默认模型声明的 `support_efforts` 自动置灰不支持档位并提示原因；models.dev 标记不支持思考的模型整体禁用思考区；未声明档位的模型保留可选并提示"上游可能拒绝"
- **修正过时适配**：删除 max→high 读取迁移（kimi-code 2.1.1 中 max 为合法档位），存储的 max 与任意手写档位值原样保留显示；子代理页继承档位显示同步修正

## v0.7.22 (2026-09-24)

- **修复 Sub2API / NewAPI 模板查询不显示**：为无预设识别类型的自定义供应商配置 Sub2API（或 NewAPI）模板后，弹窗测试可查但供应商列表始终不显示——前端列表的查询/显示门槛只看预设 `usageKinds`，显式模板被漏掉；现在与后端口径对齐（模板查询绕过 usage_kinds），列表正常显示余额 / 配额

## v0.7.21 (2026-09-24)

- **models.dev 在线同步**：高级设置新增「模型参考数据」卡片——一键在线拉取 models.dev 最新快照（上下文长度 / 能力标记 / 单价），前端与仪表盘计价即时生效，无需等待新版本；支持一键恢复随版本内置数据；显示当前数据来源与版本（同步 / 内置 + 日期 + 模型/供应商数）
- **修复构建链路数据漂移**：`fetch-models-dev.mjs` 现在同时写入 `src/lib/models-dev.json`（Rust 计价内嵌）与 `public/models-dev.json`（前端静态资源）——此前 public 副本需手工拷贝，已两次滞后于 src/lib
- **kimi-code 2.1.0 已适配确认**：实验 flag 注册表（5 个）、config 模式、用量/quota 格式均无变化；上游 `[watch]` 默认关闭与现有开关行为一致；新增 `tui_mode`（tui.toml）不涉及配置管理面
- models-dev 快照同步至 2026-09-23（8,126 模型 / 223 供应商）

## v0.7.20 (2026-09-20)

- **套餐用量阈值预警**：用量配置新增「预警阈值 %」（0-100，0/空为关闭），任一用量窗口达到阈值即红色高亮 + ⚠ 标记，低于阈值自动消除
- **Kimi For Coding 加力钱包**：0.43.1 起解析 `boosterWallet` 并展示为独立余额行（💰 月度用量 / 总额 / 余额，含币种）
- **供应商凭证环境变量化（`api_key_env`）**：适配 kimi-code 2.0.0 #3762，凭证来源可切换「直接填写 / 环境变量」，密钥不写入 `config.toml`，与 `api_key` 互斥；SQLite 新增列含自动迁移
- **Kimi Code 版本跟踪器**：设置页新增版本卡片——本机已装版本、上游最新版本、适配状态徽标（绿已适配 / 黄建议升级 / 橙部分兼容 / 灰未安装），可一键打开上游 Releases
- **供应商一键体检**：并发探活所有启用供应商的推理端点（`GET /v1/models`）并顺带重查账单，三态判定避免误报（端点不支持模型列表计中性）
- 新增 `loop_control.compaction_max_attempts`（上游 0.43.0 #3750，默认 5）与 `[watch] enabled` 开关（上游 2.0.1 #3892）；已确认适配 kimi-code 2.0.2

## v0.7.19 (2026-09-14)

- **适配 kimi-code 0.43.0 实验 flag 镜像（7→5）**：移除已转正的 `auto_session_title`（上游 #3749），上游注册表现剩 `wait_for` / `tool-select` / `notify_user` / `tower` / `subagent_fork`
- 兼容性核查：0.43.0 的 wire 持久化重建（#3737）不影响用量统计，相关记录全部保留；`loop_control.compaction_max_attempts`（#3750）保存不丢失
- 残留的 `auto_session_title` 旧键会被上游静默忽略，无需手动清理

## v0.7.18 (2026-09-14)

- **会话管理「一键归档」**：支持按 1 个月前 / 半个月前 / 1 星期前 / 指定日期批量归档，替代逐个选择，并反馈已归档 / 跳过数量
- **归档用量快照落库**：归档瞬间按「天 × 模型」粒度把 token 用量与费用写入 SQLite `archived_sessions` 表
- 删除已归档会话释放磁盘后不再损失历史统计——趋势图、热力图、模型统计、区间合计自动合并快照
- 快照与现存文件实时统计严格去重（只合并文件已删除的归档会话，绝不双计）
- models-dev 快照同步至 2026-09-14（7784 模型 / 213 供应商），pricing 断言跟随 DeepSeek 官方调价（deepseek-v4-flash input 0.14→0.15 / output 0.28→0.60）

## v0.7.17 (2026-09-13)

- **账单查询适配 Sub2API 中转站（`balance:sub2api`）**：支持 Wei-Shaw/sub2api 面板余额查询（`GET {base}/v1/usage`），自动复用推理 `sk-` API Key，无需网页后台 Access Token
- 解析三种模式：单 Key 总额度（quota）、5 小时 / 每日 / 7 天速率窗口（含重置倒计时）、订阅组日/周/月额度与钱包余额（USD）
- `detect_provider` 家族规则拆分：`codingplan.site` 主域识别为 Sub2API，`ai.codingplan.site` 识别为 NewAPI，修正主域被误判导致查询 404 的问题
- 用量配置面板新增「Sub2API 中转站」模板，可选覆盖查询地址（Base URL）
- **模型映射「获取模型列表」新增批量选择**：全选 / 取消全选 / 反选，配合已添加标记批量接入中转站模型

## v0.7.16 (2026-09-10)

- **适配 kimi-code 0.42.0 实验 flag 镜像（9→6）**：移除 4 个已转正/删除的开关（子代理次主力模型、MiniDB 读模型、远程控制、搜索 Worker），新增 `notify_user`（实验性 Updates 面板，默认关闭）
- 用量统计「模型用量统计」图表固定最大高度 360px 并支持滚动，与右侧模型用量表一致
- models-dev 快照同步至 2026-09-10（7615 模型 / 213 供应商），`public/` 静态目录同步

## v0.7.15 (2026-09-09)

- **用量统计新增「昨天」选项卡**：时间范围为 今天 / 昨天 / 7 天 / 30 天 / 全部，「昨天」按本地时区严格统计昨日 0 点至今日 0 点，概览卡扩展为 5 张
- **新增「模型用量统计」趋势选项卡**：跨供应商按模型名汇总（同一模型合并为一行），横向条形图按 Token 降序，悬停显示请求数 / Token / 缓存命中 / 费用
- **修复 opencode Go 套餐子代理请求 400**：Go 网关强制要求 `x-opencode-session` 头，导出时凡指向 Go 端点的供应商自动补写（已有自定义值保留），按量计费的 `zen/v1` 不受影响
- models-dev 快照同步至 2026-09-09（7583 模型 / 213 供应商）；`kimi/k2.5` 官方条目下架后暂解析到 302ai 转售价（0.66 / 3.3）

## v0.7.14 (2026-09-06)

- **修复关闭「启用用量查询」后仍残留查询行为**：此前关闭后前端仍发起查询并持续显示「查询失败 · 用量查询已关闭」红色错误行，现在关闭即停止查询并隐藏整行用量信息，重开后自动恢复
- 在途查询结果在开关切换瞬间作废且不再写入共享缓存，避免过期失败状态在 5 分钟内复活

## v0.7.13 (2026-09-05)

- **适配 kimi-code 0.41.0**：上游移除 `file_history` flag（轮级文件历史转为恒开），镜像全链路同步删除；Auto（永不询问）模式不再拦截危险命令，设置页文案（中英）同步修正
- **账单查询改进**：`codingplan.site` 系供应商自动识别为 NewAPI 余额查询；凭据缺失不再误报「网络异常」而给出本地化配置提示；金额显示统一为两位小数并去掉 `¤` 占位符
- 新增 usage 错误本地化单元测试

## v0.7.12 (2026-09-03)

- **适配 kimi-code 0.40.1（flag 9→10）**：新增 `file_history` / `search_worker`；`secondary-model` 默认开启并显示徽章；新增危险命令守卫开关 `[permission] dangerous_command_guard`（默认开启）
- **flag 优先级语义修正**：单 flag 环境变量 > `[experimental]` 显式配置 > 总开关环境变量 > 默认值，总开关不再锁定全部开关
- **修复 WebUI 打开竞态**：并发调用串行化 + 后到点击自动聚焦已有窗口，失败路径不再误杀正在使用的 server，前端增加「打开中...」防重入态
- models-dev 快照更新至 7495 模型 / 212 供应商

## v0.7.11 (2026-08-29)

- **适配 kimi-code 0.39.1**：`[thinking]` 保留开关改写 `keep = "off"`（修复布尔值导致整个节被 v2 校验丢弃）；`loop_control` 默认只写新键 `max_attempts_per_step` 并清理旧键；思考强度移除 `max` 档（上游迁移为 `high`）
- **会话归档与上游 v2 对齐**：不再搬动文件，改为在 `state.json` 写入 `archived` / `archivedAt` 元数据，CLI 侧与 Kimi Switch 侧归档状态互通；旧 `.kcd-archive/` 物理归档仍可识别恢复
- **修复子代理模型池无法添加第二个条目**：默认模型自动物化进池，不再被校验拦截
- models.dev 快照刷新至 7482 个模型 / 207 个供应商

## v0.7.10 (2026-08-29)

- **修复保存配置时误删 CLI 新增的顶层配置节**：以导入时顶层键为基线，CLI 后加的 `[task]` / `[swarm]` / `[cron]` / `[tools]` / `[identity]` / `[token_counting]` 等节原样保留，界面中显式删除的节仍会移除
- **修复未知供应商类型被改写**：`config.toml` 中新增的供应商 `type` 往返读写后原样保留（此前会被改成 `kimi`），下拉框标注「未知类型」，SQLite 快照恢复路径同步修复
- 新增 3 个配置往返回归测试，Rust 测试 106 项全绿，前端 tsc / vitest 通过

## v0.7.9 (2026-08-27)

- 模型库刷新至 **7343 个模型 / 203 个供应商**，内置快照与官网静态资源同步更新
- **新增 GLM-5.3 / GLM-5.3-Flash 全线接入**：智谱官方、OpenRouter、Cloudflare Workers AI、DeepInfra、HuggingFace、火山引擎等约 20 条渠道，GLM-5.3-Flash 定价 $0.075/$0.25（每百万 token）
- 新增 Qwen3.8 系列、豆包 Seed 2.x 全系、DeepSeek-V4 GA、MiniMax-M2.7/M3 等共 74 个模型条目；价格更新 58 处、能力信息修正 56 处

## v0.7.8 (2026-08-25)

- **修复模型用量上下显示不同步**：上方用量摘要刷新后下方进度条仍停留旧数据（如 24% vs 8%），用量查询状态提升至卡片层统一持有，两处同帧更新
- **实验功能开关同步 kimi-code 上游 7 项旗标**：新增 Tower 模式、子代理 Fork 上下文、WaitFor 工具、自动会话标题；移除已废弃的 ACP v2 开关（手写配置仍完整保留）
- 自动刷新间隔改为每卡片恰好一份定时器，行为不变

## v0.7.7 (2026-08-22)

- **双区域 OAuth 支持（适配 kimi-code 0.38.0）**：适配 mainland-cn `auth.kimi.com` / global `auth.kimi.ai`（#2862），按 provider 的 oauth ref 推导凭据文件与刷新端点，global 账号（`credentials/kimi-code-env-<sha256>.json`）可正常查询用量
- **内置登录区域选择**：应用内 Kimi 登录对话框新增「中国大陆 / 国际版 (kimi.ai)」，登录成功后按官方 CLI 行为 provision `[providers."managed:kimi-code"]`（global 写 `oauthHost`，cn 不写）
- **修复**：手动添加模型后别名自动跟随为 `<provider>/<model-id>`；managed（OAuth）供应商自填 `api_key` 保存时不再被清空
- models.dev 快照刷新至 **7246 模型 / 193 供应商**，新增 DeepSeek V4 Flash Vision Exp、Ox Alpha Free（opencode-go，免费）

## v0.7.6 (2026-08-18)

- **新增 OpenCode Go 套餐用量查询**：卡片用量页脚显示 **5 小时滚动 / 7 天 / 30 天** 三窗口的已用百分比与重置时间（数据源 `GET https://opencode.ai/zen/go/v1/usage`）
- 已配置 OpenCode Go API Key 的老用户无需手动设置，程序按 `base_url` 自动识别并启用；已适配 opencode.ai 的 Cloudflare 拦截（携带浏览器 User-Agent）
- 插件目录被运行中进程占用时的错误提示给出明确指引

## v0.7.5 (2026-08-15)

- **子代理模型池适配 kimi-code 0.36.0 新引擎**：适配 `[secondary_model]` 的 `default_model` + `[secondary_model.models]` 表 + `force`；写入时 `model` 与 `default_model` 双写同值，v1 legacy 与 v2 引擎均可识别
- **高级设置页新增模型池管理**：升级旧配置、增删池条目、编辑路由描述（渲染进主代理 Agent/AgentSwarm 工具描述）；支持 force 强制默认模型（带二次确认）；保存前 6 类错误前置拦截
- 新增 32 个单元测试覆盖池读写与校验逻辑（vitest）
- **热力图详情改为按需加载**：双击方块调用后端 `get_day_detail` 聚合，不再受 7d / 30d 范围限制
- models.dev 快照刷新至 2026-08-15（6583 模型 / 185 供应商），新增 GLM-5.3 等

## v0.7.4 (2026-08-09)

- **热力图方块双击弹窗**：查看当日模型用量分布，每种模型独立展示 Token 用量 / 请求次数 / 费用 / 缓存命中率（此前仅有 token 数）
- 后端 `[dashboard] by_model` 从纯 token 数升级为结构化对象（含 requests / cost / cacheHitRate），弹窗与柱状图双击均展示全量指标
- 范围外日期（不在当前 7d / 30d / all 内）不可双击；Escape / 遮罩 / 关闭按钮均可关闭弹窗

## v0.7.3 (2026-08-07)

- **Kimi Code WebUI 应用内嵌窗口**：新版 Web 界面以独立顶层窗口打开（1100×750、可缩放、居中），不再跳转外部浏览器
- **单例 + 服务器自动管理**：窗口最多一个，重复点击自动聚焦；复用已运行的 `kimi web` 服务，自启动的服务器在窗口关闭或应用退出时自动清理
- 「在应用内打开」与「在浏览器打开」两个入口并存（后者复用本地服务器，直接打开 `http://127.0.0.1:58627`）

## v0.7.2 (2026-08-07)

- 「子代理设置」升级为「**高级设置**」：聚合子代理模型指定、实验功能开关与 WebUI 快捷入口
- **新增 Kimi Code WebUI 快捷打开**：高级设置页可将新版 Web 界面以独立窗口在应用内打开，也可在系统浏览器打开（需 kimi-code 0.33+，kimi 命令在 PATH 中）
- **子代理模型指定**：为子代理选择次主力模型后默认绑定该模型，不再继承主模型；实验开关改为滑动开关并修复开启态不可见问题
- 兼容 kimi-code 0.33+（v2 引擎）：`loop_control` 改用新键名 `max_attempts_per_step`（旧配置自动迁移，保留旧键兼容 legacy 引擎）；Release 附带 `install-macos.sh` 一键安装脚本

## v0.7.1 (2026-08-06)

- **新增「子代理模型（次主力模型）」设置**：选择后子代理默认绑定该模型，不再继承主模型，仅保存模型引用即可继承上下文长度与思考模式
- **仪表盘用量统计**：识别子代理请求（`__secondary__`）归为「子代理模型（估算）」独立展示，并缓存次主力模型定价，删除配置后历史记录仍稳定估算
- 自定义网关模型（未收录 models.dev）按官方同名模型跨 provider 匹配价格，不再落入兜底估算