Reasonix v1.38.8
Desktop reliability and usability improvements, including unified session persistence, Goal lifecycle fixes, and installer updates.桌面端可靠性与易用性改进，包括统一会话持久化、目标生命周期修复和安装程序更新。
Start here使用攻略
Desktop updates桌面端更新
21 updates relevant to Desktop. 与桌面端相关的更新共 21 项。
Highlights重点内容
Unified session persistence with bounded large-history recovery统一会话持久化并支持大会话恢复
Sessions now use a canonical storage service with a new v4 format, enabling large history recovery without the previous 128 MiB replay ceiling.会话现在使用规范存储服务和新的 v4 格式，支持大会话恢复，不再受之前 128 MiB 重放上限限制。
Goal lifecycle recovery and host controls修复目标生命周期恢复与宿主控制
Recovered Goals retain their objectives across continuation rounds, while stale actions are rejected to preserve user pauses.恢复后的目标会在续跑轮次中保留原有任务内容，并拒绝过期操作以保留用户暂停状态。
Desktop model and workspace navigation优化桌面端模型与工作区导航
The model picker now offers provider filters, favorites, and catalog-wide search, and the workspace dock opens Overview when empty.模型选择器现在提供提供商筛选、收藏和全目录搜索，工作区停靠栏为空时自动打开概览。
Desktop updates and slimmer native packages修复桌面更新并精简原生安装包
macOS updates now resolve the app bundle correctly, and native packages are significantly smaller.macOS 更新现在能正确解析应用包，原生安装包体积显著减小。
New新增
Unified session persistence统一会话持久化
Sessions now use a canonical storage service with a new v4 format, enabling large history recovery without the previous 128 MiB replay ceiling.会话现在使用规范存储服务和新的 v4 格式，支持大会话恢复，不再受之前 128 MiB 重放上限限制。
Model picker redesign模型选择器重新设计
The model picker now offers provider filters, favorites, and catalog-wide search.模型选择器现在提供提供商筛选、收藏和全目录搜索。
Improved改进
Simpler file editing and recovery简化文件编辑与错误恢复
File edits check the version observed by a read, while ordinary tool errors no longer block unrelated work behind proof or recovery-confirmation gates. Permission policy, sandboxing and Plan approval remain enforced. Unknown external effects are recorded without automatically replaying them.文件编辑会核对读取时观察到的版本；普通工具错误不再通过证据或恢复确认门禁阻塞后续工作。权限策略、沙箱和计划批准仍然生效。结果未知的外部操作会保留记录，不会自动重放。
Goal lifecycle alignment目标生命周期对齐
Goal state changes now reject stale actions, helping preserve user pauses and prevent overlapping continuation rounds.目标状态变更现在会拒绝过期操作，保留用户暂停状态，并防止多个续跑轮次重叠。
Startup hint for slow launches慢启动时显示启动提示
Fast launches open directly; slower launches show a lightweight startup hint.快速启动直接打开应用；较慢的启动会显示轻量级启动提示。
Fixed修复
Session shutdown and Windows recovery修复会话关闭与 Windows 恢复
Session shutdown no longer races background state reads. Windows path case changes reuse the same session writer, and failed session switches release their previous file handles.修复会话关闭与后台状态读取之间的数据竞争。Windows 路径大小写变化会复用同一个会话写入器，会话切换失败后也会正确释放此前的文件句柄。
Portable package first launch修复便携包首次启动
The first-run migrator now finds the CLI under its portable-package filename.首次启动迁移程序现在能按便携包内的正确文件名找到 CLI。
Goal lifecycle recovery目标生命周期恢复
Recovered Goals retain their objectives across continuation rounds, while stale actions are rejected to preserve user pauses.恢复后的目标会在续跑轮次中保留原有任务内容，并拒绝过期操作以保留用户暂停状态。
Desktop updates and slimmer packages桌面更新和更小的安装包
macOS updates now resolve the app bundle correctly, and native packages are significantly smaller.macOS 更新现在能正确解析应用包，原生安装包体积显著减小。
Installer retries scanner-locked files安装程序重试扫描器锁定的文件
Windows installer now retries transient file locks and offers a Retry option.Windows 安装程序现在会重试瞬态文件锁，并提供重试选项。
Direct launch finds service直接启动可找到服务
Launching Reasonix.exe directly now correctly locates the desktop service.直接启动 Reasonix.exe 现在能正确定位桌面服务。
Linux package permissionsLinux 包权限
Linux packages now let normal users read and enter the application directory.修复 Linux 安装包的应用目录权限，普通用户可以正常读取并进入该目录。
Transcript no-drag fix修复对话区拖动问题
Transcript no-drag no longer punches through the Electron titlebar.对话区 no-drag 不再穿透 Electron 标题栏。
CLI updatesCLI 端更新
10 updates relevant to CLI. 与 CLI相关的更新共 10 项。
Highlights重点内容
Unified session persistence with bounded large-history recovery统一会话持久化并支持大会话恢复
Sessions now use a canonical storage service with a new v4 format, enabling large history recovery without the previous 128 MiB replay ceiling.会话现在使用规范存储服务和新的 v4 格式，支持大会话恢复，不再受之前 128 MiB 重放上限限制。
Goal lifecycle recovery and host controls修复目标生命周期恢复与宿主控制
Recovered Goals retain their objectives across continuation rounds, while stale actions are rejected to preserve user pauses.恢复后的目标会在续跑轮次中保留原有任务内容，并拒绝过期操作以保留用户暂停状态。
New新增
Unified session persistence统一会话持久化
Sessions now use a canonical storage service with a new v4 format, enabling large history recovery without the previous 128 MiB replay ceiling.会话现在使用规范存储服务和新的 v4 格式，支持大会话恢复，不再受之前 128 MiB 重放上限限制。
Improved改进
Simpler file editing and recovery简化文件编辑与错误恢复
File edits check the version observed by a read, while ordinary tool errors no longer block unrelated work behind proof or recovery-confirmation gates. Permission policy, sandboxing and Plan approval remain enforced. Unknown external effects are recorded without automatically replaying them.文件编辑会核对读取时观察到的版本；普通工具错误不再通过证据或恢复确认门禁阻塞后续工作。权限策略、沙箱和计划批准仍然生效。结果未知的外部操作会保留记录，不会自动重放。
Goal lifecycle alignment目标生命周期对齐
Goal state changes now reject stale actions, helping preserve user pauses and prevent overlapping continuation rounds.目标状态变更现在会拒绝过期操作，保留用户暂停状态，并防止多个续跑轮次重叠。
Fixed修复
Session shutdown and Windows recovery修复会话关闭与 Windows 恢复
Session shutdown no longer races background state reads. Windows path case changes reuse the same session writer, and failed session switches release their previous file handles.修复会话关闭与后台状态读取之间的数据竞争。Windows 路径大小写变化会复用同一个会话写入器，会话切换失败后也会正确释放此前的文件句柄。
Goal lifecycle recovery目标生命周期恢复
Recovered Goals retain their objectives across continuation rounds, while stale actions are rejected to preserve user pauses.恢复后的目标会在续跑轮次中保留原有任务内容，并拒绝过期操作以保留用户暂停状态。
Upgrade notes升级提醒
Tool changes may reset the prompt cache once工具变更可能使提示缓存首次失效
Retired proof tools and updated tool schemas change the request prefix after upgrading. A one-time cache miss is expected; subsequent turns retain stable tool ordering and prefixes.旧证据工具的移除和工具描述变更会改变升级后的请求前缀，首次请求可能无法复用原有缓存；后续轮次保持稳定的工具顺序和前缀。
Session migration and downgrades会话迁移与降级说明
Existing sessions migrate into a separate v4 directory when continued; their original files remain unchanged. Older versions cannot read new v4 history, so update Desktop and CLI together. Browsing or migrating a session does not automatically resume its Goal or restore approvals.继续旧会话时会迁移到独立的 v4 目录，原始文件保持不变。旧版本无法读取新增的 v4 历史，请同步更新桌面端和 CLI。浏览或迁移会话不会自动续跑目标，也不会恢复执行批准。
Manual update required for pre-1.38.4 clients1.38.4 之前的客户端需要手动更新
Desktops on v1.38.3 or older cannot update in-app and must install the full package manually.v1.38.3 或更早版本的桌面端无法在应用内更新，必须手动安装完整包。
Risk notes风险提示
First index build for very large sessions超大会话首次建立索引需要时间
The reference 1 GiB history test took about 115 seconds to build its first index. Index construction is cancellable; this measurement is not a session size limit.参考测试中，1 GiB 历史的首次索引构建耗时约 115 秒。构建可以取消，该测量值不代表会话容量上限。
Thanks致谢
This release was shaped by:感谢本版本的贡献者：
Ready when you are准备好即可升级