@sinm/kai 1.11.2 → 1.11.10

package/RELEASE_NOTES.md

@@ -1,5 +1,237 @@
 # Release Notes
 
+## v1.11.10
+发布日期：`2026-06-16`
+> 对比 `v1.11.9` → `v1.11.10`，共 `56` 个提交
+
+### ✨ 你会直接感受到的升级
+
+- **PTY 终端更稳**：终端面板、标题栏和回放渲染的同步问题被修正，长时间使用和重连后的显示更可靠
+- **定时消息更适合“先清空再发送”**：现在可以在发送前清理当前上下文，适合日报、提醒和巡检这类不依赖历史对话的任务
+- **思考模式内容不再轻易丢失**：模型在压缩、重试和切换时更能保住需要回传的推理内容，减少上游报错
+- **Session 标题和弹窗更顺手**：标题更新、快捷回复和终端确认弹窗的交互细节更一致，少打断操作
+
+### 🐛 重要修复
+
+- **空上游流不再误报为不可重试故障**：模型返回空流时会按可重试的流读取错误处理，恢复兜底更及时
+- **IM 渠道错误提示更像人话**：发送失败时会显示更明确的重试提示，不再暴露内部错误口吻
+- **会话切换和顶部提示更稳定**：修复切换 Session 时的闪烁和 tooltip 延迟问题，阅读和切换更平滑
+- **长对话里的滚动和输入不再互相干扰**：虚拟列表、消息输入和状态更新的竞态收敛后，连续操作更可靠
+
+### 📐 内部整理
+
+- 主进程职责边界进一步收口，RPC 注册路径更集中
+- 终端、会话标题、上下文压缩和调度执行的测试覆盖补齐
+- 一些弹窗和设置面板抽象统一，后续维护成本更低
+
+### 🧪 质量门禁
+
+- TypeScript 类型检查、全量单元测试已通过
+
+## v1.11.9
+发布日期：`2026-06-15`
+> 对比 `v1.11.8` → `v1.11.9`，共 `56` 个提交
+
+### ✨ 你会直接感受到的升级
+
+- **内置终端面板**：Agent 创建的终端会话现在直接嵌入聊天界面，无需切换窗口即可查看运行输出；终端列表移入上下文检查面板，支持历史回放和浮动窗口
+- **消息文字可直接选择**：长按消息弹出菜单后选择"选择文字"进入原生选中模式，跨消息气泡也可选中并引用回复；移动端体验更接近原生
+- **新增 glm-5.2 模型**：支持 100 万 token 上下文窗口，可处理超长对话和大型代码库
+- **终端读取支持等待静默**：ptyRead 工具新增 idleTimeout 参数，在输出停止后再返回结果，避免频繁轮询获取不完整内容
+
+### 🐛 重要修复
+
+- **WebSocket 断线重连不再丢失消息**：断线期间的状态在重连后正确恢复，乐观消息不再因断线被错误标记为失败；连接状态监听修复后应用启动不再报错
+- **切换会话不再闪烁**：虚拟列表 key 属性调整后切换会话时的 diff 闪烁问题消除，滚动位置更稳定
+- **AI 推理块不再被意外丢弃**：匿名 block 和 ID 引用的推理块在新消息到达时正确收束，不再出现内容丢失或过早收束
+- **高频流式事件不再卡顿**：事件缓冲区排序修复防止 seq 跳变导致事件被跳过，跨 block 合并的 seq 空洞不再造成死锁
+- **拖拽监听不再泄漏**：拖拽事件监听器在组件卸载后正确移除，避免内存泄漏和潜在的异常行为
+- **会话标题不再被 AI 回复误覆盖**：标题生成在 debounce 前锁定历史状态，AI 首条回复不再干扰已有标题
+- **Session 标签统一显示序号**：所有 Session 标签现在都按渲染顺序显示 #1 #2 #3 序号，替代之前只有默认 Session 显示的 Hash 图标；切换顺序时序号自动跟随重排
+- **模型输出长度回退到厂商上限**：当用户未设置 maxTokens 时会回退到模型厂商声明的上限，而不是省略参数；此前部分模型（如 MiniMax-M3）会因默认值超过自身限制而报 `does not support max tokens > 524288` 错误
+
+### 📐 内部整理
+
+- 消息输入框的斜杠命令逻辑（过滤、排序、前缀构建）提取为独立模块，减少主组件体积
+- 内存增长设置面板从 1241 行单文件拆分为配置区/执行历史/文件浏览三区独立组件，降低维护成本
+- 消息 store 中重复的嵌套 Map 不可变操作收敛为通用工具函数，消除 6 处重复代码
+- 聊天组件选取器抽取为可复用的 selector 工厂 hook
+
+### 🧪 质量门禁
+
+- TypeScript 类型检查、全量单元测试（2794）和 Playwright E2E 已通过
+
+## v1.11.8
+发布日期：`2026-06-12`
+> 对比 `v1.11.7` → `v1.11.8`，共 `11` 个提交
+
+### ✨ 你会直接感受到的升级
+
+- **广播回复可独立折叠展开**：广播中每个 Agent 的回复现在都有自己的折叠开关，方便并排对比多条回复，不再互相影响
+- **会话标题在更多场景自动更新**：清除对话后或输入长文本（超过 30 字）时，标题会自动重新评估，历史会话列表更容易找到对应话题
+
+### 🐛 重要修复
+
+- **模型出错重试时不再清空已显示内容**：AI 回复在模型降级或重试时，已生成的部分不会被清空，不再出现已写内容突然消失变成加载动画的问题
+- **IPC 高频事件不再导致渲染卡顿**：流式输出时大量 block 更新事件通过精确合并和错误防护，避免渲染进程因消息洪峰出现卡顿或崩溃
+
+### 📐 内部整理
+
+- 消息切片渲染器按职责拆分为独立模块（header / footer / 容器 / 内容），外部契约不变，维护边界更清晰
+- IPC 事件反压机制从消息级精化为 block-id 级合并，流式更新的事件传输更高效、更精确
+- 标题生成时禁用思考模式（thinking），节省 API token 消耗
+
+### 🧪 质量门禁
+
+- TypeScript 类型检查、全量单元测试和 Playwright E2E 已通过
+
+## v1.11.7
+发布日期：`2026-06-12`
+> 对比 `v1.11.6` → `v1.11.7`，共 `88` 个提交
+
+### ✨ 你会直接感受到的升级
+
+- **应用数据目录可自由迁移**：设置中新增数据目录配置，可将聊天记录、Agent 数据等整体迁移到其他磁盘或目录，迁移过程有进度提示，完成后一键重启生效
+- **收藏入口移至对话标题栏**：收藏消息的入口从消息操作区移到更醒目的标题栏位置，快速收藏和查看收藏更顺手
+- **Agent 可自动为对话命名**：试验功能中新增自动更新 Session 标题开关，开启后 Agent 会在话题变化时自动调整对话标题，历史会话更容易辨识
+- **广播回复查看更简洁**：广播回复改为手风琴折叠布局，单条摘要始终可见，展开查看详情时不同回复之间互不干扰
+- **新增 qwen3.7-plus 模型**：支持通义千问 qwen3.7-plus 模型，支持图片理解能力
+
+### 🐛 重要修复
+
+- **数据库断连后自动恢复**：修复数据库连接意外丢失后发送消息持续报错的问题，现在会自动重建连接并重试，不再需要重启应用
+- **虚拟列表消息操作回归修复**：长按、引用选中和用户换行显示在虚拟列表路径下恢复正常，不会再出现操作无响应或样式异常
+- **流式输出不再闪烁**：正在生成的消息中已完成部分不再反复重渲染，阅读长回复时更稳定
+- **加载历史消息不再闪白**：向上翻页加载更多历史时，当前阅读位置被钉住，不再出现短暂白屏或跳动
+- **展开折叠不再导致视口跳动**：消息内容展开和收起时不会把阅读位置推走
+- **手动压缩不再多余重放用户消息**：手动整理上下文时跳过已展示的用户消息重放，整理后对话更干净
+- **Goal 任务耗尽后不再无限循环重入**：任务执行次数耗尽时正确标记为阻塞状态，避免反复触发空转
+- **群聊 Session 标题工具正常工作**：群聊场景下 Agent 能正确使用自动标题更新能力
+- **协作头部悬停不再位移**：群聊协作头部区域鼠标悬停时视觉稳定
+- **设置中重复选择同一目录会提示**：数据目录迁移时如果选择了当前目录，会给出提示而不是静默忽略
+- **长按菜单不再闪退**：消息长按打开操作菜单时不会再因为菜单定位异常导致界面崩溃
+
+### 📐 内部整理
+
+- 消息列表渲染路径统一为虚拟列表单一路径，移除旧的非虚拟化渲染分支和试验开关
+- 滚动行为按事务化边界重构：Session 重置、本地发送、尾部校正和前置保位各自独立收口
+- 上下文压缩策略重构：压缩尾部只保留助手和工具消息，人类消息按需重放；旧推理块在每次压缩时自动裁剪
+- 工具路径参数描述精简，绝对路径下 workdir 不再强制要求
+- 进度指标统一从运行态映射读取，移除旧的双写路径
+
+### 🧪 质量门禁
+
+- TypeScript 类型检查、全量单元测试和 Playwright E2E 已通过
+
+## v1.11.6
+发布日期：`2026-06-10`
+> 对比 `v1.11.5` → `v1.11.6`，共 `44` 个提交
+
+### ✨ 你会直接感受到的升级
+
+- **长对话切换更稳**：正在输出时切换 Session，消息区不再反复闪白或淡入，阅读位置也更少被打断
+- **常用表达更容易复用**：用户消息可以保存为快捷回复，适合沉淀常用提示、流程口径和团队协作模板
+- **更多偏好可按需配置**：可以决定关闭窗口时退出还是留在后台，也可以为 MCP Streamable HTTP 服务配置自定义请求头
+- **发现新版本后更好读**：检查到新版本时，更新信息会显示在身份卡下方，不再挤在右侧
+
+### 🐛 重要修复
+
+- **发送后不再轻易丢底部位置**：本地发送、流式输出和跨 Session 切换时，长消息列表会更可靠地保持在正确位置
+- **长对话摘要后仍保留最近指令**：自动整理上下文后，保存的上下文不再只剩摘要，会保留最近一轮用户消息，避免续聊时丢掉刚刚的要求
+- **广播回复查看更稳定**：广播回复的标签栏保持固定，切换查看不同回复时不容易迷失当前位置
+- **引导和快捷回复状态更干净**：已消费的引导状态不再刷新后重新出现，排队中的快捷回复草稿也会及时清理
+- **MCP Header 配置更安全**：移除容易误导的敏感 Header 选项，减少误填鉴权信息的风险
+
+### 📐 内部整理
+
+- 收口长消息列表的滚动语义、意图识别和历史加载锚定逻辑，降低后续滚动回归风险
+- 补齐 Session 切换、轻微滚动后切换和消息搜索滚动的回归覆盖
+- 更新仓库 Agent 工作准则，让协作和发版边界更清楚
+
+### 🧪 质量门禁
+
+- TypeScript 类型检查、全量单元测试和 Playwright E2E 已通过
+
+## v1.11.5
+发布日期：`2026-06-10`
+> 对比 `v1.11.4` → `v1.11.5`，共 `34` 个提交
+
+### ✨ 你会直接感受到的升级
+
+- **长消息性能优化默认开启**：超长回复和大量工具输出默认使用更顺滑的渲染路径；如果遇到滚动、搜索或选区异常，仍可在实验功能里关闭回退
+- **长对话终于更稳了**：在很长的对话、空 Session 和多个 Session 来回切换时，消息列表会更可靠地停在该停的位置，不再让你反复手动拉到底
+- **重要消息可以收起来再找回**：新增收藏消息能力，并优化从收藏页回到原会话的跳转体验，临时记下的关键信息不必再靠复制粘贴保存
+- **消息上的操作更顺手**：右键菜单补齐常用消息动作，并收紧触发范围，想操作消息时更直接，不想操作时少打扰
+- **复杂任务的先后关系更清楚**：Goal 的待办可以显示依赖说明，哪些事要先做、哪些事要等结果，会更容易看懂
+
+### 🐛 重要修复
+
+- **长消息列表减少白屏和跳动**：修复巨型任务块、顶部跳转、加载历史以及切换会话后偶发的空白、回跳和不到底问题
+- **异常模型响应不再轻易打断对话**：对无效响应的识别和恢复更准确，遇到上游返回异常时更少直接中断
+- **Goal 进度不再因模型切换倒退**：切换模型后，任务进度消息更稳定地保持当前状态
+- **每日更新提示不再反复冒出来**：自动更新提示按天出现，减少重复提醒
+- **品牌标识显示更一致**：关于页、应用图标和托盘图标的品牌视觉更统一
+
+### 📐 内部整理
+
+- 收口消息列表的底部锚定和滚动恢复逻辑，并用更接近真实长会话的 E2E 覆盖回归
+- 整理协作内容块间距和虚拟列表分割细节，让长对话阅读噪音更少
+- 补齐运行进度快照契约，降低长任务状态展示回退风险
+
+### 🧪 质量门禁
+
+- TypeScript 类型检查、全量单元测试和 Playwright E2E 已通过
+
+## v1.11.4
+发布日期：`2026-06-08`
+> 对比 `v1.11.3` → `v1.11.4`，共 `75` 个提交
+
+### ✨ 你会直接感受到的升级
+
+- **长对话滚动更稳**：切换 Session、加载历史和页签来回切换时，消息列表更少闪烁、跳动或短暂空白
+- **协作内容更清爽**：任务、广播和生成内容的展开层级更克制，减少内部执行痕迹对阅读的打扰
+- **移动端浮层更顺手**：系统返回键可以关闭当前浮层，移动端操作更符合直觉
+- **设置调整更即时**：实验设置和群模型设置保存后会更快反映到界面状态，减少保存后还像没生效的错觉
+
+### 🐛 重要修复
+
+- **虚拟消息列表不再容易丢位置**：修复贴底判断、加载更多、会话切换和流式输出中的多处滚动锚定问题
+- **移动端界面残影减少**：修复侧边栏关闭残影和触摸滚动时的流式闪烁，窄屏使用更稳定
+- **单聊归档确认更可靠**：单聊 Session 归档时确认流程更准确，降低误操作风险
+- **群聊交接显示更及时**：handoff 后当前发言人状态会实时更新，减少协作状态和实际执行不一致
+
+### 📐 内部整理
+
+- 运行诊断上下文继续收口，执行 trace 能更稳定关联到一次具体运行
+- 消息列表虚拟渲染补充切换场景 E2E，降低长对话和页签切换回退风险
+- 关于页和聊天头部视觉层级清理，界面信息密度更接近实际使用场景
+
+### 🧪 质量门禁
+
+- TypeScript 类型检查、全量单元测试和 Playwright E2E 已通过
+
+## v1.11.3
+发布日期：`2026-06-05`
+> 对比 `v1.11.2` → `v1.11.3`，共 `7` 个提交
+
+### ✨ 你会直接感受到的升级
+
+- **群成员列表更直观**：群成员管理里直接显示头像，成员识别更快，界面也更干净
+- **右侧运行面板更整齐**：面板标签栏的对齐细节修正，查看运行信息时视觉层级更稳
+
+### 🐛 重要修复
+
+- **群聊交接接棒更准确**：Agent 交接后能更可靠识别前一个发言人和目标接棒者，减少交接后答非所托或空转
+
+### 📐 内部整理
+
+- Agent workspace 注入结构按职责收口，长期上下文边界更清楚
+- 文件 diff 完整展开语义命名更明确，降低后续预览逻辑回退风险
+
+### 🧪 质量门禁
+
+- TypeScript 类型检查、全量单元测试和 Playwright E2E 已通过
+
 ## v1.11.2
 发布日期：`2026-06-05`
 > 对比 `v1.11.1` → `v1.11.2`，共 `5` 个提交