本次发布聚焦会话持久化与恢复，新增持久化 bash 会话和 CDP 浏览器后端，并改进文件导航与对话导航。
发布渠道：稳定版 · v1.38.9
使用攻略
- 桌面会话 v5 — 了解桌面会话全新的仅 SessionID 持久化架构。
- CDP 浏览器后端 — 面向 CLI、Serve 和无头会话的全新 CDP 浏览器后端文档。
- Dock 文件导航 — 命令驱动的文件导航所有权模型详情。
- 资源治理升级 — 桌面会话资源如何受限与管理。
- 对话大纲导航 — 完整轮次导航器的设计与验收记录。
- 持久化轮次分叉报告 — 从持久化会话日志分叉已完成轮次的报告。
- 会话快速恢复 — 快速恢复与独立历史的工作原理。
概览
Reasonix v1.38.9 — Reasonix v1.38.9：会话可靠性、持久化 Bash 与 CDP 浏览器
本次发布聚焦会话持久化与恢复，新增持久化 bash 会话和 CDP 浏览器后端，并改进文件导航与对话导航。
发布日期：2026-09-15
Desktop 22 · CLI 8
桌面端更新
重点内容
- [Desktop] 仅 SessionID 的桌面持久化 — 桌面会话现采用基于单一 SessionID 的持久化架构，防止会话丢失并提升重启后的可靠性。 (#10326)
- [Desktop · CLI] 持久化 bash 会话 — 前台 bash 调用现共享会话级 PTY，因此 cd、导出变量和 shell 函数可在多次调用间保持。 (#10327)
- [Desktop · CLI] CDP 浏览器后端 — CLI、Serve 和无头会话现可通过新的 CDP 后端使用与 Electron 外壳相同的浏览器工具。 (#10328)
- [Desktop] 完整轮次导航器 — 轮次导航器现在索引对话中的每个轮次，而不仅是已加载的轮次，并带有绝对序号和预览。 (#10276)
- [Desktop] 命令驱动的 Dock 文件导航 — 打开文件现在是由运行实例持有的命令，消除了渲染循环和过时的导航竞态。 (#10280, #10268)
- [Desktop] 模型启动失败时恢复会话历史 — 即使保存的模型连接不再存在且控制器启动失败，持久会话历史仍保持可见。 (#10287)
新增
- [Desktop] 仅 SessionID 的桌面持久化 — 桌面会话现采用基于单一 SessionID 的持久化架构，防止会话丢失并提升重启后的可靠性。 (#10326)
- [Desktop · CLI] 持久化 bash 会话 — 前台 bash 调用现共享会话级 PTY，因此 cd、导出变量和 shell 函数可在多次调用间保持。 (#10327)
- [Desktop · CLI] CDP 浏览器后端 — CLI、Serve 和无头会话现可通过新的 CDP 后端使用与 Electron 外壳相同的浏览器工具。 (#10328)
改进
- [Desktop] 完整轮次导航器 — 轮次导航器现在索引对话中的每个轮次，而不仅是已加载的轮次，并带有绝对序号和预览。 (#10276)
- [Desktop] 命令驱动的 Dock 文件导航 — 打开文件现在是由运行实例持有的命令，消除了渲染循环和过时的导航竞态。 (#10280, #10268)
- [Desktop] 识别并预览回答中提到的文件 — 回答中提到的文件现在可以被识别和预览，包括以图片形式渲染的 SVG 代码块。 (#10277)
- [Desktop] 从持久化会话日志分叉已结束轮次 — 分叉已结束轮次现在使用不可变锚点，即使有更新的轮次正在运行，分支按钮也可用。 (#10284)
- [Desktop] 限制桌面会话资源占用 — 转录驻留和昂贵资源现在通过明确的预算和所有权进行限制。 (#10295)
- [Desktop] 修复锚定弹层生命周期 — 模型选择器等传送门弹层现在在其触发器失效时正确关闭。 (#10275)
修复
- [Desktop] 模型启动失败时恢复会话历史 — 即使保存的模型连接不再存在且控制器启动失败，持久会话历史仍保持可见。 (#10287)
- [Desktop] 在删除会话存储根目录前先关闭会话服务 — 修复了仅 Windows 上会话服务在清理期间持有恢复数据库句柄的测试失败。 (#10354)
- [Desktop · CLI] 释放冷启动阶段的会话写者租约 — 修复了仅 Windows 上冷启动会话写者租约未释放导致的测试失败。 (#10325)
- [Desktop] 修复 Windows 测试任务 — 修复了 Windows CI 测试任务失败的多个根本原因，包括写者租约和监听 helper 入口。 (#10321)
- [Desktop · CLI] 修复编辑块文件系统竞态 — 通过单一 fd 作用域流程关闭了编辑块中的存在→写入和读取→写入竞态。 (#301)
CLI 端更新
重点内容
- [Desktop · CLI] 持久化 bash 会话 — 前台 bash 调用现共享会话级 PTY，因此 cd、导出变量和 shell 函数可在多次调用间保持。 (#10327)
- [Desktop · CLI] CDP 浏览器后端 — CLI、Serve 和无头会话现可通过新的 CDP 后端使用与 Electron 外壳相同的浏览器工具。 (#10328)
- [CLI] 恢复 CLI YOLO 权限快捷键 — Ctrl+Y 使用规范的 danger-full-access 预设切换 YOLO 模式，Shift+Tab 循环切换全部四种权限状态。 (#10356)
新增
- [Desktop · CLI] 持久化 bash 会话 — 前台 bash 调用现共享会话级 PTY，因此 cd、导出变量和 shell 函数可在多次调用间保持。 (#10327)
- [Desktop · CLI] CDP 浏览器后端 — CLI、Serve 和无头会话现可通过新的 CDP 后端使用与 Electron 外壳相同的浏览器工具。 (#10328)
改进
- [CLI] 恢复 CLI YOLO 权限快捷键 — Ctrl+Y 使用规范的 danger-full-access 预设切换 YOLO 模式，Shift+Tab 循环切换全部四种权限状态。 (#10356)
修复
- [Desktop · CLI] 释放冷启动阶段的会话写者租约 — 修复了仅 Windows 上冷启动会话写者租约未释放导致的测试失败。 (#10325)
- [Desktop · CLI] 修复编辑块文件系统竞态 — 通过单一 fd 作用域流程关闭了编辑块中的存在→写入和读取→写入竞态。 (#301)
其他项目更新
- [Site] 探测全部已授权手动下载标签 — 下载页面现在探测所有已授权的手动标签，防止在较新标签尚未发布时降级。 (#10353)
升级提醒
- [Desktop] 本次桌面版需要手动下载安装 — 由于代码签名服务暂不可用，本次桌面版所有平台均以手动下载方式发布，自动更新保留在上一版本。Windows 安装包不含 Reasonix Authenticode 签名，系统可能提示未知发布者；每个产物仍提供 minisign 签名和 SHA-256 校验值。CLI 和 npm 发布不受影响。 (#10352)
- [Desktop] 桌面会话 v5 与降级说明 — 桌面会话改为仅按 SessionID 存储。迁移器只读取而不修改既有 v4 与旧版历史，因此降级后原有会话仍在；但仅在 v5 下新建的会话，旧版本无法看到。Protocol 9 是桌面外壳与宿主的硬边界，请同步更新桌面端与 CLI。 (#10326)
风险提示
当前没有需要额外操作的已知风险。
致谢
感谢本版本的贡献者：@SivanCola、@github-actions[bot]、@esengine、@Yizking
下载与安装
Manual desktop downloads / 桌面版手动下载
This vv1.38.9 desktop release is manual-download only on every platform. Windows packages do not carry Reasonix Authenticode signatures because SignPath signing is unavailable; Windows may show an unknown-publisher warning. Detached minisign signatures and SHA-256 checksums remain available. Desktop automatic-update channels are unchanged by this release and keep serving their previous version. CLI and npm distribution are unaffected.
本次 vv1.38.9 桌面版所有平台均需手动下载安装。因 SignPath 签名服务暂不可用，Windows 包不含 Reasonix Authenticode 签名，系统可能显示未知发布者提示；仍提供 minisign 签名和 SHA-256 校验。本次发布不改变桌面自动更新通道，其仍指向此前版本；CLI 和 npm 正常发布。