Reasonix v1.32.0
Remote SSH workspaces, durable ordered turns, smoother transcript navigation, and stronger Windows and state-recovery reliability.远程 SSH 工作区、持久有序的回合、更流畅的对话导航，以及更可靠的 Windows 与状态恢复体验。
Start here使用攻略
Remote SSH Workspace Guide远程 SSH 工作区指南
Learn how to connect to remote SSH workspaces, manage sessions, and use background turns.了解如何连接远程 SSH 工作区、管理会话并使用后台回合。
↗CLI ReferenceCLI 参考
Command-line interface documentation and configuration options.命令行界面文档和配置选项。
↗Configuration Paths配置路径
Where Reasonix stores configuration and state files.Reasonix 存储配置和状态文件的位置。
↗Migration Guide迁移指南
How to migrate existing workspaces and data to the latest version.如何将现有工作区和数据迁移到最新版本。
↗Tool Contract工具契约
Details on tool schemas and provider interactions.工具模式和提供程序交互的详细信息。
Desktop updates桌面端更新
25 updates relevant to Desktop. 与桌面端相关的更新共 25 项。
Highlights重点内容
Durable, ordered turns持久化、有序的回合
Ordered turn events now persist across interruptions and restarts, with accepted side effects fenced from replay.有序的回合事件现在可跨中断与重启持久保存，并防止已接受的副作用被重复执行。
Topic metadata migration主题元数据迁移
Moved topic metadata to SQLite for reliability and recovery.将主题元数据迁移到 SQLite 以提高可靠性和恢复能力。
New新增
Remote SSH workspaces远程 SSH 工作区
Connect remote SSH workspaces, resume exact sessions, and let busy turns continue in the background while you switch sessions.连接远程 SSH 工作区、精确恢复会话，并在切换会话时让繁忙回合继续在后台运行。
Durable, ordered turns持久化、有序的回合
Ordered turn events now persist across interruptions and restarts, with accepted side effects fenced from replay.有序的回合事件现在可跨中断与重启持久保存，并防止已接受的副作用被重复执行。
Individual session archiving单个会话归档
Archive individual sessions safely from their project-tree group.现在可以在项目树分组中安全归档单个会话。
Improved改进
Smoother transcript scrolling and navigation更流畅的对话滚动与导航
Stabilized scroll-surface ownership and commit navigation only after the destination has painted.稳定滚动表面所有权，并在目标完成绘制后再提交会话导航。
Compact MCP capability discovery精简 MCP 能力发现
Capability listing now summarizes each MCP server and keeps full tool catalogs available on demand through inspection.能力列表现在只摘要展示各 MCP 服务器，完整工具目录仍可按需检查。
Compact ratio range压缩比例范围
Lowered the minimum compact_ratio to 0.30 for earlier compaction.将最小 compact_ratio 降低到 0.30，以便更早进行压缩。
Clearer memory capability guidance更清晰的记忆能力指引
The capability description now explains when and how to use Reasonix memory tools.能力说明现在会解释何时以及如何使用 Reasonix 记忆工具。
Client-specific release notes按客户端拆分的更新日志
Release notes now separate Desktop and CLI changes for clearer upgrade decisions.更新日志现在分别展示桌面端与 CLI 变更，便于判断升级影响。
Fixed修复
Windows taskbar icon and selection renderingWindows 任务栏图标和选区渲染
Restored the taskbar icon and stabilized transcript selection rendering on Windows.恢复了任务栏图标并稳定了 Windows 上的对话选区渲染。
MCP session reliabilityMCP 会话可靠性
Moved supervised MCP sessions to the official Go SDK and correctly dispatch ACP-supplied host-session servers.将受管 MCP 会话迁移到官方 Go SDK，并正确调度通过 ACP 提供的宿主会话服务器。
Atomic recovered-session publication原子发布恢复会话
Recovered session projections now publish atomically, avoiding partially updated catalog state.恢复后的会话投影现在会原子发布，避免目录出现部分更新状态。
Readable operational overlays清晰可读的操作弹层
Operational dialogs and menus now use opaque theme surfaces so their content remains readable.操作对话框和菜单现在使用不透明主题表面，确保内容始终清晰可读。
macOS self-update on exFATmacOS 在 exFAT 上的自动更新
Fixed self-update on exFAT filesystems.修复了 exFAT 文件系统上的自动更新。
Standard todo stallsStandard 待办停滞
Fixed stalled Standard todos by adding a bounded continuation prompt.通过添加有界的继续提示修复了 Standard 待办停滞。
Reliable session archiving可靠的会话归档
Session archiving now tolerates brief local lock handoffs without reporting that the session is still in use.会话归档现在可容忍短暂的本地锁交接，不会误报会话仍在使用中。
Topic metadata migration主题元数据迁移
Moved topic metadata to SQLite for reliability and recovery.将主题元数据迁移到 SQLite 以提高可靠性和恢复能力。
WebSocket dependency updateWebSocket 依赖更新
Updated gorilla/websocket to 1.5.3.将 gorilla/websocket 更新到 1.5.3。
CLI updatesCLI 端更新
11 updates relevant to CLI. 与 CLI相关的更新共 11 项。
Highlights重点内容
Durable, ordered turns持久化、有序的回合
Ordered turn events now persist across interruptions and restarts, with accepted side effects fenced from replay.有序的回合事件现在可跨中断与重启持久保存，并防止已接受的副作用被重复执行。
New新增
Remote SSH workspaces远程 SSH 工作区
Connect remote SSH workspaces, resume exact sessions, and let busy turns continue in the background while you switch sessions.连接远程 SSH 工作区、精确恢复会话，并在切换会话时让繁忙回合继续在后台运行。
Durable, ordered turns持久化、有序的回合
Ordered turn events now persist across interruptions and restarts, with accepted side effects fenced from replay.有序的回合事件现在可跨中断与重启持久保存，并防止已接受的副作用被重复执行。
Improved改进
Compact MCP capability discovery精简 MCP 能力发现
Capability listing now summarizes each MCP server and keeps full tool catalogs available on demand through inspection.能力列表现在只摘要展示各 MCP 服务器，完整工具目录仍可按需检查。
Compact ratio range压缩比例范围
Lowered the minimum compact_ratio to 0.30 for earlier compaction.将最小 compact_ratio 降低到 0.30，以便更早进行压缩。
Clearer memory capability guidance更清晰的记忆能力指引
The capability description now explains when and how to use Reasonix memory tools.能力说明现在会解释何时以及如何使用 Reasonix 记忆工具。
Client-specific release notes按客户端拆分的更新日志
Release notes now separate Desktop and CLI changes for clearer upgrade decisions.更新日志现在分别展示桌面端与 CLI 变更，便于判断升级影响。
Fixed修复
MCP session reliabilityMCP 会话可靠性
Moved supervised MCP sessions to the official Go SDK and correctly dispatch ACP-supplied host-session servers.将受管 MCP 会话迁移到官方 Go SDK，并正确调度通过 ACP 提供的宿主会话服务器。
WebSocket dependency updateWebSocket 依赖更新
Updated gorilla/websocket to 1.5.3.将 gorilla/websocket 更新到 1.5.3。
Other project updates其他项目更新
Website and service changes that do not require a Desktop or CLI update.不要求更新桌面端或 CLI 的网站与服务端变更。
Upgrade notes升级提醒
Existing topic metadata migrates automatically现有主题元数据会自动迁移
Existing workspaces migrate on first access and retain legacy JSON mirrors for sequential downgrade and re-upgrade; no manual action is required.现有工作区会在首次访问时迁移，并保留旧版 JSON 镜像以支持顺序降级与再次升级；无需手动操作。
Risk notes风险提示
Fresh-workspace downgrade boundary新工作区的降级边界
Workspaces first created in v1.32.0 keep topic metadata only in SQLite. A direct downgrade may recover titles from session metadata but cannot guarantee creation timestamps or auto-title stages. Do not run old and new Reasonix versions against the same workspace concurrently.在 v1.32.0 中首次创建的工作区仅在 SQLite 中保存主题元数据。直接降级时可从会话元数据恢复标题，但无法保证创建时间或自动标题阶段完整恢复。请勿让新旧 Reasonix 版本同时写入同一工作区。
Thanks致谢
This release was shaped by:感谢本版本的贡献者：
Ready when you are准备好即可升级