v3.5.4

新增

• 外部账户新增阶跃星辰 StepFun
• 标题行右侧数据位可自选口径（今日消耗 / 输入 / 输出 / 缓存命中 / 速度 / 余额）
• 加油包余额功能修复：数字左侧一枚小刷新图标，点一下重新取数（网页端自动刷新，桌面端手动刷新）

修复

• 桌面端加油包余额一直显示「--」
• 技能的三个脚本（provider 探测 / doctor）连不上客户端
• ≡ 菜单每打开一次宽一点
• 外部账户的长名称把「API余额」挤掉

其他

• 运维技能 v11：更新流程补两条软指令（更新前简要说明改动、更新后汇报版本与要点）；供应商清单同步 StepFun

v3.5.3

Kimi Code Monitor v3.5.3

修复

• 桌面补丁余额窗口恢复实时更新
• 子代理总览支持同模型合并
• 外部账户状态的时间注入贯穿到底

v3.5.2

修复：options 标签页活跃热力图溢出卡片、盖住指标下拉框（issue #10，感谢 @Vte2 的详尽报告）

• 热力图格子边长原本只按图表区宽度计算；options 标签页（右键扩展图标 →「选项」，宽版式约 670px）下格子被算到约 32px，7 行约 227px 高，从固定 76px 高的图表区向上下溢出，盖住指标下拉框导致无法再切换——热力图是默认指标且持久化，每次打开选项页都停在这个状态。修复后格子边长同时受图表区高度限制，宽版式下热力图保持 76px 高、居中显示；弹窗版式不受影响
• 图表区补 overflow: hidden 兜底：尺寸计算再出任何偏差，格子也不可能溢出遮挡其他控件

变更：桌面端宠物菜单移除「侧栏改造」死开关

独立面板（桌面客户端注入）本就不做侧栏改造（改造样式按网页端侧栏结构假设），≡ 菜单里的开关切换无任何效果；桌面端不再显示该项，网页端行为不变。

其他

• 桌面补丁安装器完成时补充提示：客户端大版本更新会清除面板文件（属预期），重跑安装即可恢复，历史统计自动重新扫描补齐
• 运维技能 v9：首装引导补充同一预告；技能触发描述补「面板消失不见」场景

v3.5.1

v3.5.1（2026-09-21）

修复：重启客户端后面板误报「思考中」

• 桌面端重启后重新订阅会话时，服务端会用游标 0 重放整段事件历史；直连模式的活跃度模型在识别重放之前就把这些历史事件记成了工作证据，空闲会话被抬成「思考中」并从 0 计时（约 20 秒后自行回落）。修复后活跃度只认订阅应答之后的实时事件，与渲染层丢弃重放状态、work_changed 的滞留守卫同一口径
• 补充回归测试：假 WebSocket 扮演服务端重放整段历史，断言状态灯保持空闲、实时事件照常点亮

v3.5.0 — 支持桌面端（macOS / Windows 双平台）

v3.5.0（2026-09-21）

首个完整支持桌面客户端的大版本：用量面板以补丁形式装进 Kimi Code 桌面客户端（macOS 与 Windows 双平台），并配套运维技能；新增加油包余额显示；修正客户端消耗统计口径；并入此前未单独发版的 v3.4.2 / v3.4.3 两项修复，清理两条已停用通路。

新增：桌面客户端补丁（主要更新）

把侧栏用量面板以补丁形式装进 Kimi Code 桌面客户端——不改客户端程序逻辑，只往 desktop-dist/ 放置静态资源并注入一行 script 标签：

• 安装 / 卸载：零前提——bash install.sh（macOS）/ install.cmd（Windows，可双击）幂等安装，自动备份原始 index.html；--uninstall 完整还原（逐字节）。安装器优先借客户端自带的 Node 运行时（Electron 的 ELECTRON_RUN_AS_NODE），系统 Node 兜底，不需要安装 Node；安装逻辑只有 install.mjs 一份跨双平台。客户端自动更新整体替换 desktop-dist 后补丁会消失（属预期），重跑同一命令即可重装
• 实时数据：面板直连客户端内嵌本地服务（kap-server）——WS 事件流 + REST 轮询，全部本机回环，无任何外发
• 历史统计：安装时全量扫描 ~/.kimi-code/sessions 预填（与扩展同一套解析口径）；此后页内按天积累，与预填按天取大合并，客户端更新不清数据
• 运维技能：配套 kimi-code-monitor 技能（Release 技能包固定名分发，安装入口见 README 头部提示词 / docs/SKILL-INSTALL.md）——安装 / 重装 / 卸载、更新检查（只告知不自动更新）、外部自检、供应商余额排查；首装自动探测客户端里已配的供应商并分类报告
• 面板功能与侧栏版一致：模块化面板、额度 / 消耗 / 缓存 / 速度、Rive 吉祥物、中英文

新增：Windows 支持

桌面补丁同一脚本跨 macOS / Windows：安装器与自检脚本 node 化（install.mjs / doctor.mjs），平台差异只收敛在应用发现、路径推导、版本读取三个纯函数（双平台路径发现 + --app 覆盖 + KIMI_CODE_APP_DIR 环境变量），测试对两个平台的路径逻辑分别注入验证；面板运行时代码零平台假设。

新增：加油包余额显示

• 网页端：额度接口字段 boosterWallet → booster_wallet 改名后双读兼容，余额恢复显示
• 桌面端：安装时与技能代查生成余额快照（token 只进请求头、不回显不落盘），面板经 60s 轮询点亮余额位；失效时提示打开一次客户端自动续期

变更：命名统一

• 运维技能改名 kcm-panel → kimi-code-monitor（安装目录同步变更，旧目录装上新版后删除）
• 补丁运行时命名空间 vibepal → kcm（载荷目录 / 加载路径 / 全局变量 / 就绪事件全部更名）

优化：缓存命中渐进降级

消耗量图表的「缓存命中」改按图表头行实际宽度连续降级：放得下显示全称，放不下只留百分比，极窄整体隐藏——不再出现半截省略号，也不再按模块跨度一刀切。

修复：侧栏底部折叠阴影错位

面板插入侧栏后，底部折叠阴影跟随到会话列表底缘：全宽贯穿侧栏列（不再只到面板宽），下缘贴折叠处并向上探入列表 13px，面板 12px 外边距区域留空；显隐继续由原生滚动逻辑驱动。Web 扩展与桌面补丁同源修复。

修复：RC 环境侧栏顶部元素重叠（issue #8）

「侧栏改造」压平头部后，RC 环境（code-rc.kimi.com）的设备选择器与绝对定位的收起按钮重叠。两层修复：设备选择器行与按钮同行同高（26px）对齐、右侧让位、超长省略；安全闸兜底——头部出现 logo 与收起按钮之外的可见元素时，自动跳过侧栏改造回退原生布局，随路由轮询持续评估。

修复：客户端消耗统计口径（缓存命中率虚高）

桌面补丁的页内按天积累曾只把非缓存输入记进 input（缓存读/创建另算），与文件扫描侧「记全部输入」的口径不一致——「按天取大」合并时两种口径互相压制，缓存命中率会被算成远超 100% 的虚值。现在桶口径单点定义在 src/metrics.js（emptyUsageBucket / addUsageToBucket），扫描侧与积累侧共用，tests/bucket-parity.test.js 守着两侧产出同一个桶；存量积累数据一次性搬迁到新口径（旧键搬迁后删除）。本地会话目录的布局规则同样收成单一真源 src/session-files.js（扩展侧与安装器侧共用）。

新增：客户端面板的会话切换恢复与代理明细

• 切会话不再清零：切走时把当前会话的面板状态存档（数值 / 折线 / 上轮耗时 / 按代理拆分 / 宠物计时），切回瞬时恢复；空闲会话由本地汇总做底——安装预填的按会话（代理 × 模型）统计，覆盖「从没打开过的对话」与「客户端重启后」两类空白；kap 快照恒返回全零（实测），只在真给出非零值时采信；重放的历史事件不进计数器、断线补发按序号去重（与扩展侧同一口径）
• 子代理明细按「代理 × 模型」分行：主代理中途换过模型各占一行；同一模型的多个子代理各占一行（带「子1 / 子2」序号），不再合并成一行 ×N；子代理记录的 __secondary__ 占位符归一成该代理配置里的真实模型名。网页版与客户端共用同一份渲染
• 刷新本地统计：补丁载荷自带 kcm/scan.mjs（无参原地重写统计文件）、技能新增 refresh-stats.mjs 入口——聊天后不用重装补丁，刷新一次面板 30 秒内跟上

变更：外部账户自动跟随客户端供应商配置

客户端版外部账户不再代查、不再需要用户提供 key：面板每 60 秒读取客户端自己的供应商配置（key 只在内存里用一次，不落盘、不进日志），按 base_url 域名匹配适配表后直连厂商余额端点。识别只认域名（供应商名字是用户自己起的）；未适配 / 没配 key 的供应商不进常规列表，只在模块设置里标注原因；接口失败沿用上次成功的数值并标注数据时间（如「3 分钟前 ¥6.70」，失败原因在悬停里），扩展侧同一语义。原「技能代查快照」通路与 fetch-external.mjs 删除。两家接口故障时的表现：单家失败该行保留旧数字，下一轮成功自动恢复；客户端没开则旧数字保留、退避重试。

内部

• CI 新增 windows job：用 electron 包的真二进制验证 ELECTRON_RUN_AS_NODE 分支 + install.cmd 双分支与卸载全流程；壳测试覆盖 mac/linux
• 技能脚本用 esbuild 打成零依赖单文件（技能包不含 src/，修复已装技能 ERR_MODULE_NOT_FOUND）
• metrics.js 双份导出收敛为单一导出；docs/HANDOFF.md 撤出公开仓库（本地交接备忘，.gitignore 排除）

优化：补丁数据文件轮询

loader.js 的数据文件轮询（usage-daily / wallet）合并为一个带指数退避的 poller：文件长期缺席时不再每 30s 往控制台刷一条 404，加载成功立即恢复基础节奏；「无历史」（文件缺席）与「加载失败」（文件在读但读不了）的状态区分修正——全新环境首次加载失败不再误报异常。

内部

• panel-app 构建目标：侧栏面板脱离 chrome.* 环境的独立页面版，桌面补丁复用同一份面板代码；扩展行为无变化
• 桌面补丁默认布局重定义（Mini=宠物+两条额度；完整区=外部账户+四项指标；标题行/上轮耗时/子代理/图表入隐藏区可拖出）；独立面板不做侧栏改造（双层保险）
• 外部账户空态文案按端分流：扩展指向弹窗配置，客户端指向 kimi-code-monitor 技能
• 运维技能改以 Release 技能包分发（固定名 kimi-code-monitor-skill.zip 直链，安装入口 docs/SKILL-INSTALL.md），桌面补丁同样改固定名 kcm-desktop-patch.zip
• 移除两条已停用通路：会话自动命名旧模型管线（session-rename/、background/rename.js——命名已由官方 auto_session_title 实验覆盖）与 Swift 伴侣 App 桥接（popup-app/——桌面补丁保留注入模式，panel-app/bridge.js 转为注入模式的 push 总线）
• 构建脚本迁入 scripts/；新增 GitHub Actions CI（lint + 全量测试 + 三个发行产物可构建性检查）
• 新增发版守卫测试：manifest / package / skill MAINTENANCE 三处版本与 CHANGELOG 顶部条目自动核对，漏改即测试失败；安装器测试覆盖双平台路径逻辑、载荷哈希黄金值与装/卸/幂等全流程

v3.4.1

v3.4.1（2026-09-06）

消耗统计口径修正：宠物面板「今日消耗」按本地时区自然日；消耗量图表新增 24h 滚动窗口，按小时分柱。

新增：消耗量图表 24h 统计范围

统计范围在 7d / 30d 之外新增 24h：滚动 24 小时窗口，当前小时钉在最右、按小时分柱，跨零点自动带上昨天的小时；顶部总数与缓存命中率按该窗口合计。CLI 扫描新增按小时聚合（保留最近 2 天），升级后首次扫描会全量重扫一次补齐。

变更：宠物面板 24h消耗 → 今日消耗

原「24h消耗」实际按 UTC 自然日统计，东八区用户清晨用量会被算进昨天。现按本地时区自然日（0–24 点）统计并更名「今日消耗」。按天分桶整体切换为本地时区口径，热力图、7d/30d 图表、分享卡片、额度快照的「天」统一以本地午夜为界；存量历史桶可能有最多一天的归属偏移，随 90 天修剪自然淘汰，无数据丢失。

文案

• 编辑模式区域引导调整：隐藏区「隐藏区 · 拖到下方启用」、固定区「固定区 · 始终显示」（中英文同步）

v3.4.0

v3.4.0（2026-09-05）

popup 新增「扩展功能」卡片：AI 回复收藏开关、自动归档不活跃对话、新会话自动命名引导。

新增：自动归档不活跃对话（实验性）

按静默天数把不活跃的对话自动移入侧栏「已完成」，三档规则独立可调、可单独启停：

• 单日对话：创建后不到 2 天的短会话（当天一次性任务），默认静默 3 天归档
• 多日对话：跨 2 天以上持续使用的会话（隔几天回来一次），默认静默 14 天归档
• 所有对话：不论活跃跨度，静默达 30 天一律归档（兜底）

正在工作、等待交互、子会话、创建不满 24 小时与空会话绝不归档。首次开启会先列出符合条件的会话清单，确认后才解锁自动归档；此后每 24 小时在后台执行一次，归档结果桌面通知。归档完全可逆，可在 Kimi Web 的「已归档会话」页随时恢复。开启时自动打开 Kimi Web 实验性「多标签页侧栏」（页面刷新生效）。

变更：新会话自动命名交由官方实验

会话标题自动生成改由 Kimi CLI 官方实验「AI session titles」承担，扩展不再自行调用模型（不再需要配置 API Key）。未开启官方实验时，「扩展功能」卡片提供「复制提示词」：粘贴到 kimi web 对话框发送，由 kimi 自动修改配置开启；官方实验已开启时该入口自动隐藏。

变更：popup「扩展功能」卡片

「AI 回复收藏」新增总开关（默认开，关闭后星标与收藏页隐藏、数据保留）；与自动归档、自动命名合并为一张卡片，各自独立开关。弹窗打开时开关直接以存储状态显示，无跳变动画。

安全（v3.3.1 延续）

• 消息来源守卫白名单同步收敛：rename.model 随旧管线移出白名单

v3.3.0

面板支持 kimi web --host 对外暴露的非本机地址。

新增：动态站点授权

此前面板只在 127.0.0.1 / localhost 注入，用 kimi web --host 暴露到局域网后（如 http://192.168.x.x:端口）无法显示。现在在非本机的 http(s) 页面打开 popup，用量卡片中会出现与「本地记录已授权」同款的状态行：点击「在此站点启用」后按 Chrome 标准流程申请当前站点的可选主机权限，后台随即动态注册内容脚本、补充 CSP 放行规则，并自动刷新已打开的页面使两者生效。

• 授权按 origin 粒度生效，可随时在 popup 点「取消」撤销，或在浏览器站点设置中移除（扩展会同步清理）
• 授权记录与内容脚本注册跨浏览器重启保持
• 会话命名、授权状态、CLI 扫描等广播/中转现在同时覆盖本机与已授权站点

新增：Remote Control（kimi rc）适配

面板在 kimi rc 的云端中继页面（code-rc.kimi.com/devices//）下可用：会话 ID 解析、REST 快照与 WebSocket 连接自动带上 /devices/<id>/ 前缀；RC 由云端鉴权、回源注入本机 token，页面侧无凭据时省略 Authorization 头与 WS 子协议（与中继自带 web UI 行为一致）。在此页面同样通过 popup「在此站点启用」授权。

v3.2.2

v3.2.2（2026-08-25）

收藏页体验打磨与 popup 布局微调。

新增：收藏页快速目录

列表视图右侧新增快速目录（与会话页目录同款交互）：垂直居中贴内容列、hover 展开标题、滚动跟随高亮、点击平滑跳转。按会话分组时目录中插入灰色的会话标题条目（收藏条目为橙色），无滚动条。

改进：收藏页

• 列表条目卡片化（与卡片视图同款边框圆角），组间改用空白分隔
• 分组标题加大，计数保持朴素灰字
• hover 统一为边框加深并带过渡动画

改进：popup 与分享卡

• footer 新增「分享用量」入口（替换「重置布局」）
• 消耗量默认日期范围改为近一月
• 分享卡：范围汇总行距加大、标签与数值顶部对齐、「每日消耗」头部不再重复显示缓存命中

v3.2.1

v3.2.1（2026-08-25）

本轮以收藏功能的修复与打磨为主。

修复

• 点击收藏图标无反应：消毒渲染 HTML 时依赖了 NodeIterator.currentNode（不同环境行为不一致），点击链路静默抛错；已改为 childNodes 递归删除注释节点
• 收藏页会话标题混入侧栏时间徽标（如「历史上的今天 5m」）：只取会话行标题元素；旧数据载入时自动剥离

改进：收藏

• 列表与卡片视图也按 Markdown 渲染（此前只有详情弹层支持）；旧收藏在当前会话可自动回填升级
• 渲染 HTML 存储上限 8K → 150K（此前大量收藏因超限只能显示纯文本）
• 批量管理：勾选/删除不再弹回顶部；管理条去掉「完成」，工具条按钮在管理模式直接变为「完成」
• 卡片 hover 改为整面灰底（与列表一致），hover 时右上角显示单条删除按钮
• 列表行左右间距统一并加宽
• 打开收藏页时，侧边栏聚焦自动跳回工作区（与新建会话的表现一致）