Kun v0.3.7 Release Notes

本版本聚焦于运行时稳定性与会话体验修复：新增 OpenCore Free 免密钥提供方、用量费用估算与深色主题自定义，并系统性地加固了启动恢复、线程切换、SSE 事件流与更新通道等关键路径。

✨ 新功能

• 新增 OpenCore Free 提供方：无需 API Key 即可使用的免费模型接入，以匿名方式发送请求；在免费分组中展示且不再弹出密钥提示；同步清理种子数据中的遗留凭证 (#61b3306, #de714f5, #bcd9123, #b7fbdce, [#3]f7075f, [#2]f94726)
• 用量费用估算：基于 models.dev 目录价格估算各提供方及订阅制模型的使用成本；历史 GLM Coding Plan 用量按零成本计价；历史用量按每轮实际使用的提供方归属 (#45a1ed7, [#7]e92d35, [#14584]af, [#7]ebd75c)
• 深色 UI 颜色自定义：支持自定义深色主题 UI 颜色，提供默认值、归一化与合并逻辑，并改进 live projection 处理 (#6ff0762)
• 语音听写与提示词优化内联错误：内联错误提示可关闭并自动过期，不再持续占用输入区域 (#a5e2803)
• 计划面板复制路径：活动计划的路径可一键复制，并更新多语言文案 (#a04a7d4)
• 创建计划工具增强：改进计划标题处理，会话 ID 缺失时使用回退值 (#9a81597)
• 线程执行租约续期：新增 ManagerThreadExecutionLeaseClient，支持执行租约续期逻辑并配套测试 (#237d0ad)
• 任务档案摘要组件：新增设计档案摘要组件与布局解析器，档案水合失败时降级为摘要展示 (#530cac4)
• 工作台启动状态管理：新增 boot 状态机，启动失败时提供明确的错误提示与重试机制 (#7288bae)
• 待处理输入可见性：user_input 支持超时后由模型自主决策；侧边栏新增 awaiting-input 提示，并在聊天 UI 中完整呈现等待输入状态 (#d847a5c, #ea91214)
• 批量线程状态获取：批量拉取线程状态，改进用户输入处理，并增强线程状态的错误处理与诊断信息 (#f72d5e0, [#2186721])
• 侧边栏预热：改进侧边栏行焦点处理，线程详情支持 prewarm，切换更流畅 (#8000b03)
• 画布会话布局：增强画布会话的布局与缩放逻辑，改进线程快照处理 (#9c1d675)
• 服务管理器替换：实现管理器优雅/强制替换能力，启动失败窗口支持恢复操作与详细的交接错误展示 (#b8e56c2)
• 长会话上下文弹性：恢复长会话上下文弹性，支持上下文压缩（squash）、快照裁剪与会话守护，长会话不再中途截断 (#eb08f25)
• Fast Context 正式化：Fast Context 从实验室升级为正式能力，支持运行时配置并配套测试 (#fa911c4, [#198]f667)
• 实时助手流式上下文：新增实时助手流式上下文，并增强消息时间线动画 (#c0a740d)
• 线程水合与回放处理：线程详情支持水合加载与回放处理，live projection 与水合加载增强 (#ad6d1e2, [#77]ac3bf)
• 画布结果处理：画布 turn 结果正确处理并抑制不必要的延续 (#aa5a60b, [#82600]b1)
• 共享提供方处理增强：共享提供方支持本地元数据与 flush 能力 (#a751260)
• 模型解析与预设：antigravity-cli 模型解析兼容空白格式；智谱 Coding Plan 新增 GLM-5.3-Flash (#fd62146, [#6787099])
• 数据互斥与续租：增强数据互斥与线程续租机制，补充租约过期处理及配套测试 (#c394abd, #fbb5ba1)
• 历史压缩与体验优化：新增历史记录压缩测试，优化消息时间线与内存查找组件 (#b3723af)
• 启动加载体验：新增 Kun 吉祥物加载动画，启动等待更友好 (#9676323)
• 背景 Shell 浮动面板：后台 shell 会话支持浮动面板查看 (#161fdef)
• 受治理的图表可视化：聊天中支持结构化数据的可信图表渲染 (#cb294c2)
• HTML 优先图表设计：集成图表设计能力，复杂流程图与架构图优先以 HTML 呈现 (#d380deb)
• 项目线程折叠：展开的项目线程支持常驻折叠按钮 (#8999e7d)

🐛 修复

启动与运行时恢复

• 启动时增加运行时交接门禁，加固恢复窗口 (#e0616e3)
• 支持多目录场景下的强制交接恢复 (#15fff3f)
• 恢复路径保持可重试，运行时升级时 fail-closed，避免半初始化状态 (#65b6806)
• 修复大线程日志导致的 SSE 404 死胡同与事件循环停滞 (#c47208f)
• 加固状态游标与用户输入竞态 (#2b40a19)
• 修复 channel 与线程维护流程 (#ba8d089)
• 修复 route-pool 能力探测在计时装饰器中丢失的问题 (#23dd2c4)
• 模型流被中断或断开时优雅处理，不再留下错误状态或卡顿 (#2b7e8fe)
• 启动时先显示窗口，再启动运行时服务，避免窗口空白等待 (#8852045)
• 管理配置原子化持久化，热应用期间提供方注册表保持只读 (#dfaa783, [#5]e46df8)
• 提供方身份锁定与原子写入，退出前等待变更落盘 (#119ee97, #e5fc788)
• 工具发现并行化，缩短启动耗时 (#1d707f9)
• 校验失效端口属主身份，安全替换无端口陈旧运行时 (#d9cbf37, [#65591]fc)
• 迁移历史校验增加重试限界 (#1c767dd)
• 隔离委托会话清理与共享数据变更 (#a817214, [#1594]a5d)
• 修复首次启动失败后的恢复路径 (#34368de)
• 更新发布说明的测试覆盖拆分 (#2d01ac1)
• 恢复文件体积门槛与 web typecheck 基线 (#dad2ea6)
• 完成工作台准备交接的最终化，启动阶段状态更完整 (#30e83f0)
• 启动时保留 Fast Context 模型配置 (#075f3c1)
• 热应用请求体正确处理 Fast Context 与本地模型网关 (#bc3c8d9)

提供方与配置

• 编辑后的凭证与端点正确应用，异步凭证排空在 rebase 后保留 (#164da0c, [#8]b7a74a)
• 关闭提供方变更屏障竞态 (#40652a8)
• 迁移过期的重试退出配置 (#9a22d68)
• 提供方变更落定后再探测，更新源在首个可达源上解析 (#3e89b0d)
• 待处理凭证同步失败后自动重试 (#0a9ec7b)
• 统一 antigravity CLI 目录与安装逻辑 (#f2b9f74)

本地网关与安全

• 本地模型网关要求独立 API 凭证 (#e352e96)
• 及时关闭网关流式资源，避免句柄泄漏 (#1e1d4d3)
• 渲染进程桥不可用时优雅降级 (#5bc2665)
• 修复安装器兼容性回归 (#7ba9547)

渲染与状态一致性

• 整个应用生命周期改为单一 React root 渲染，消除挂载竞态 (#e2f95c2)
• 限制快照体积并保留水合状态 (#7403e9c)
• turn_failed 投影保留 turn 身份并增加过期守卫；并发完成时保护 turn 身份 (#2b59f92, [#5]f08c4b)
• selectThread 中 promise 落定后重新校验 prewarm 句柄 (#bfd5964)
• 运行中的会话行在侧边栏中保持位置冻结，不再跳动 (#f634a98)
• 侧边栏线程列表强制分页加载，避免一次拉取全量 (#5a90e81)
• 线程状态经批量运行时端点协调一致 (#6f63524)
• 强化 i18n 资源契约，避免多语言文案缺失 (#dfc5df9)
• 目标已用时间跨线程切换锚定到运行中的 turn，不再错乱 (#b82c615)

聊天与会话

• 按线程恢复输入框（composer）状态 (#655387b)
• 切换线程时保留用户选择的模型 (#c7a6c26)
• 修复引导中的排队消息在切换线程后"复活"的问题 (#c11bc64)
• 媒体瓦片按图片宽高比自适应，不再裁剪 (#54e86fb)
• 修复 rehype-harden 的 [blocked] 标记泄漏到文件链接 (#b7d33ba)
• 重新打开已结束线程时不再重放 live-progress UI (#3e08fb1)
• 修复条件渲染路径中 busyUnconfirmed hooks 的悬挂问题 (#9d4ee42)
• 用户消息操作按钮在 hover 时更清晰 (#20e7256)
• 用户直接提问时不再被误判为重复内容而强制延续目标；目标保持激活，等待用户回复 (#b427054)
• 运行中也可加载更早的历史消息，长会话回溯更平滑 (#e0f5f37)
• 用户输入工具别名规范化，避免别名差异导致误判 (#980fb63)
• 启用计划图像引导 (#80398c7)
• 档案行避开用户消息悬停操作，不再互相遮挡 (#7c86194)

更新与发布通道

• 更新通道切换操作串行化，避免并发变更互相冲突 (#66bed86)
• 加固更新通道交接逻辑，通道切换更可靠 (#12c90b1)
• 更新健康探测隔离，后台检查失败后退避重试 (#8b5ebf2, #abf1da7)
• 更新源发现限界，并与预发布版本比较 (#c633238)
• Windows 更新恢复状态收敛，安装与首次启动失败可恢复 (#f0645ad, [#6]ebb432, [#31969]cb)
• 安装后恢复备份路径校验，恢复备份限界 (#52ddbf9, [#492]e680)
• 更新范围不明确时中止安装 (#a6113cf)

构建与发布流水线

• 解除 Windows 事务测试、Linux 沙箱冒烟与 0.3.7 产物的流水线阻塞 (#2766fae)
• 加固安装器与 Linux 交接门禁 (#16c5d93)
• Chromium 沙箱回退增加门禁 (#3806242)
• 保留发布冒烟诊断信息 (#158d10b)
• 为运行时关闭增加进程级截止时间，避免 Linux 更新交接被未落定的清理步骤无限阻塞
• Windows 更新事务将空快捷方式快照稳定序列化为空数组，恢复流程兼容旧的空对象快照

存储与保留

• 线程列表可从异常中恢复，历史查询增加限界，避免无界扫描 (#3865074)
• 保留策略（prune）不再覆盖既有 turns (#0d0a65b)
• 用量索引按字节偏移分段，每线程增量索引，范围查询不再回放全量历史 (#6730bd5, [#11]fc28e)
• 用量索引追加哈希限界到尾部段，累积高水位保留 (#ae82e1f, #df06b30)
• 损坏的用量文件索引自动重建，失败回填可恢复 (#a29a2ab, #e6787a8)
• JSONL 读取与用量回填不再隐藏 I/O 失败 (#c38e276)
• 暂存快照强制执行磁盘配额 (#758f7e8)

委托与检索

• Fast Context 卡片不再错误渲染为失败状态，并收紧误报失败的守卫 (#71a73a1, [#8]a610e7)
• 委托子 turn 纳入画布流程 (#53afeae)
• Fast Context 队列按会话隔离，避免会话间串扰 (#5d4c272)
• 限制 Fast Context 队列等待时长 (#6aa5511)
• 恢复子代理权威状态 (#3d06de4)
• 线程时间线覆盖已落定的分离子代理状态 (#d0fa8b9)
• agent-sdk 下载校验与原子激活 (#ff1c656)

界面与其他

• 修复 macOS 下会话面板位置，为窗口控制按钮留出空间 (#42c58b5)
• 提供方配额超时隔离测试与请求超时时间调整 (#6fcfa92)
• 终端新标签页菜单改为 portal 渲染，并新增剪贴板快捷键 (#227d393)
• 补充 DeepSeek V4 按时计费费率 (#1db761b)
• 活动技能上下文令牌正确分类，上下文估算更准确 (#5c9fc72)
• TUI 新会话立即可用，并自动生成会话标题 (#318350f, [#89]b93ca)
• 已查看的已完成线程在侧边栏排序中降级，不再长时间占据顶部 (#e3aa2f6)
• 侧边栏用量历史在负载下保持可读：延长聚合超时、缓存线程记录、失败时降级展示 (#fd26f4c)
• 保护媒体 API 凭证，避免敏感信息泄露 (#b9fd913)
• 用量成本指标体现订阅参考价估算 (#ef5e62a)
• 资源租约心跳串行化，保留最早互斥截止期限 (#05eab27, [#3]e02ae5)
• 恢复 typecheck 与注册表覆盖率基线 (#1d546af)
• 展开的项目线程自动加载全部会话 (#2e4bdfd)
• 稳定线程分页与刷新时序 (#73716ee)
• 分页前先展开已加载线程，避免状态丢失 (#4f92a84)

---

完整变更：https://github.com/KunAgent/Kun/compare/v0.3.6...v0.3.7

---

构建信息

• Release version: 0.3.7
• Release channel: stable
• Branch: master
• Commit: 2994a34
• macOS: Developer ID signed and notarized
• Platforms: macOS arm64/x64, Windows x64, Linux arm64/x64 AppImage/deb
• Standalone TUI: macOS arm64/x64, Windows x64, Linux arm64/x64