KimiCodeSwitch/CHANGELOG.md

Changelog

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

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

---

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 匹配价格，不再落入兜底估算