@sinm/kai 1.10.12 → 1.11.9

package/RELEASE_NOTES.md

@@ -1,5 +1,347 @@
 # Release Notes
 
+## 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` 个提交
+
+### ✨ 你会直接感受到的升级
+
+- **文件变更预览更完整**：查看文件 diff 时会展开未变更内容，前后文不用再靠折叠区猜
+- **单聊上下文更轻**：Agent 单聊会按需读取长期记忆，减少无关内容占用上下文
+
+### 🐛 重要修复
+
+- **Prompt 缓存标识更稳定**：缓存 key 会转换为安全格式，减少上游接口因标识格式导致的请求失败
+
+### 📐 内部整理
+
+- 测试环境禁用遥测上报，避免测试过程产生无意义数据
+- 补齐 Prompt 缓存和 diff 预览的回归测试，减少相邻能力回退
+
+### 🧪 质量门禁
+
+- TypeScript 类型检查、全量单元测试和 Playwright E2E 已通过
+
+## v1.11.1
+发布日期：`2026-06-05`
+> 对比 `v1.11.0` → `v1.11.1`，共 `48` 个提交
+
+### ✨ 你会直接感受到的升级
+
+- **使用统计面板全新改版**：Token 用量按日历热力图展示，一年的使用趋势一眼可读；面板整体更紧凑清晰
+- **运行过程可以直接预览文件变更**：侧边栏支持查看文件 diff，不用离开当前对话就能确认代码改动
+- **长任务执行中可以补充要求**：任务跑到一半发现需要调整，直接输入补充说明，Agent 会结合新要求继续推进
+- **文件预览默认使用代码高亮模式**：查看代码文件时直接看到语法高亮，不再默认以原始文本展示
+
+### 🐛 重要修复
+
+- **群聊交接不再出现空回复**：Agent 之间交接任务时，偶发的无内容回复已修复，对话流不再中断
+- **触摸屏滚动不再被流式更新拉回底部**：平板或触屏设备上，向上滚动时不会被正在生成的消息强制拉回
+- **长对话压缩不再丢失当前工作目录**：上下文压缩后，Agent 对当前工作路径的记忆不会丢失
+- **底部新消息提示不再误触发**：没有新消息时不再显示"新消息"提示
+- **Goal 命令补全不再重复**：输入 `/goal` 时 tab 补全结果更准确
+- **群成员编辑入口位置修正**：侧边栏的群成员管理入口显示在正确位置
+- **空推理输出自动重试**：模型返回空推理内容时不再静默失败，会自动重试一次
+
+### 📐 内部整理
+
+- Markdown 渲染组件配置静态化，减少重复创建开销
+- 附件存储文件名结构重构，为后续功能扩展做准备
+- 错误诊断上报流程增加脱敏和大小裁剪，遥测数据更安全
+- Session 运行态判断统一收口，减少状态不一致
+
+### 🧪 质量门禁
+
+- TypeScript 类型检查、全量单元测试（226 个测试文件，2354 个用例）已通过
+
+## v1.11.0
+发布日期：`2026-06-04`
+
+### ✨ 更清楚地看见一次运行
+
+- **新增更完整的运行面板**：本次运行、生成内容、任务进展和管理入口集中到右侧展示，聊天流不再被状态和产物挤满
+- **生成内容更容易找到**：文件、补丁和附件会按工作区结构展示，目录可直接打开，路径也更容易复制
+- **长任务进展更透明**：运行中的任务进度可以按步骤查看，当前做到哪里、还有什么没完成，一眼能扫到
+
+### 🤝 群聊协作更稳
+
+- **群聊模型策略可以统一配置**：群可以设置主模型和备用模型，同时保留各 Agent 自身配置作为回退，协作时更稳定
+- **交接动作更克制**：群聊中的任务分派、广播和交接边界更清楚，减少不必要的来回转交
+
+### 🐛 修复与稳定性提升
+
+- **运行中补充的用户引导不再丢失依据**：执行过程中的补充要求会被更可靠地记录和追踪
+- **运行结束后不再闪回进度**：任务完成或停止后，进度刷新不会再污染最终状态
+- **手动停止更符合预期**：用户主动停止后会按取消状态收口，不再误报“模型没有返回内容”
+- **模型失败后的恢复更稳**：上游请求失败、并发限流等场景下，会更准确地进入重试或备用模型链路
+- **长上下文模型识别更准确**：部分大上下文模型会使用更合理的窗口预算，长对话更少被过早压缩
+- **文件与图片工具更安全**：图片分析增加大小边界，文件访问追踪在写入后再编辑的场景下更准确
+
+### 🧪 质量门禁
+
+- TypeScript 类型检查、全量单元测试和 Playwright E2E 已通过
+
+## v1.10.14
+发布日期：`2026-06-02`
+> 对比 `v1.10.13` → `v1.10.14`，共 `15` 个非合并提交
+
+### ✨ 你会直接感受到的升级
+
+- **默认 Goal 设置跟随当前 Session**：每个 Session 可以保留自己的默认 Goal 开关，切换任务时不再互相干扰
+- **Goal 模式可以默认开启**：需要持续目标检查的任务可以更自然地进入 Goal 流程，减少手动切换
+- **斜杠命令补全更可靠**：命令过滤、排序和替换更贴近输入预期，补全后不再留下多余内容
+- **文件图片预览更直观**：文件预览里的图片可以直接查看，围绕图片继续讨论更顺手
+- **项目 Hook 能在发送前介入**：用户消息发送前可以接入项目规则，为后续更精确的运行前检查打基础
+
+### 🐛 重要修复
+
+- **手动压缩不再丢用户消息**：整理上下文后仍能保留关键用户输入，减少长对话继续执行时的信息断层
+- **引导消息状态更准确**：待发送提示和空消息占位更稳定，界面不再显得突兀或误导
+- **更新安装退出不再误报崩溃**：正常安装更新导致的退出会被过滤，减少无意义的崩溃噪音
+- **Goal 提示更少误导**：移除不适用的文件工具不可用提示，规划失败后的重试提示也更清楚
+
+### 📐 内部整理
+
+- **Goal 与斜杠命令测试补齐**：默认 Goal、斜杠参数和规划重试路径增加覆盖，减少相邻能力回退
+- **Hook 使用说明补齐**：项目 Hook 的接入方式和使用边界有了更明确的文档
+
+### 🧪 质量门禁
+
+- **发版门禁通过**：TypeScript 类型检查、单元测试和 Playwright E2E 均已通过
+
+## v1.10.13
+发布日期：`2026-06-01`
+> 对比 `v1.10.12` → `v1.10.13`，共 `25` 个非合并提交
+
+### ✨ 你会直接感受到的升级
+
+- **私聊也能使用 Goal 模式**：单个 Agent 对话可以进入带目标检查的执行流程，复杂任务不用必须切到群聊
+- **项目 Hook 能参与运行前检查**：项目级规则可以在关键动作前给出阻断或提示，让执行更贴近项目约束
+- **底部新消息提示更安静**：已经在底部时不再额外弹出新消息提示，滚动到底部按钮也减少闪烁
+- **文件图片可直接预览**：侧边文件预览抽屉打开图片时会直接显示图片，点击即可进入内置图片查看器
+
+### 🐛 重要修复
+
+- **任务引导位置回到真实时间线**：运行中追加的引导会出现在当前最后一个内容块之后，不再插到已有回答前面造成顺序错觉
+- **已应用引导刷新后仍可追溯**：已经进入当前任务的引导块会保留在目标消息中，刷新后不再丢失关键线索
+- **上下文预算估算更准确**：工具定义占用会计入上下文整理预算，减少长任务里压缩后仍超窗的情况
+- **Skill 重复加载更少打扰**：同一轮中已加载的 Skill 不再反复注入，减少上下文噪音
+- **附件标题不再撑破消息**：超长文件名会稳定省略，图片和普通附件在窄容器里更少溢出
+
+### 📐 内部整理
+
+- **任务引导链路继续收口**：引导块顺序、状态初始化、最后一轮继续执行和文档语义保持一致
+- **运行前 Hook 边界成型**：Hook 的阻断、提示和运行时指导边界更清楚，后续项目规则接入更可控
+- **Goal Review 私聊路径补齐**：私聊 Goal 的规划、检查和最终回复链路完成基础闭环
+
+### 🧪 质量门禁
+
+- **发版门禁通过**：TypeScript 类型检查、单元测试和 Playwright E2E 均已通过
+
 ## v1.10.12
 发布日期：`2026-06-01`
 > 对比 `v1.10.11` → `v1.10.12`，共 `58` 个非合并提交