Reasonix / v1.19.6
Versioned docs, transactional rewind, and safer recovery版本化文档、事务性回滚与更安全的恢复
This release brings embedded version-matched documentation, transactional rewind, safer subagent cleanup, and numerous desktop and CLI fixes.此版本带来内置版本匹配文档、事务性回滚、更安全的子代理清理以及大量桌面和 CLI 修复。
Start here使用攻略
Highlights重点内容
Embedded version-matched documentation内置版本匹配文档
Access official product docs and release history directly in Reasonix with the /docs command. The built-in docs tool retrieves version-matched evidence before the AI composes an answer.使用 /docs 命令直接在 Reasonix 中访问官方产品文档和发布历史。内置文档工具在 AI 撰写答案前检索版本匹配的证据。
Transactional rewind and single-file revert事务性回滚与单文件还原
Rewind operations now use durable transactions with SHA-256-verified blobs, crash recovery, and conflict detection. Undo is available for both code rewind and single-file session revert.回滚操作现在使用持久事务，具有 SHA-256 验证的 blob、崩溃恢复和冲突检测。代码回滚和单文件会话还原均支持撤销。
Safer subagent cleanup and startup更安全的子代理清理与启动
Subagent cleanup no longer causes false startup errors or blocks on corrupt metadata. Stale subagents are cleaned up on every controller build with a parent-session liveness probe.子代理清理不再导致误启动错误或因损坏的元数据而阻塞。每次控制器构建时都会通过父会话活跃探测清理过时的子代理。
New新增
Embedded version-matched documentation内置版本匹配文档
Access official product docs and release history directly in Reasonix with the /docs command.使用 /docs 命令直接在 Reasonix 中访问官方产品文档和发布历史。
Transactional rewind and single-file revert事务性回滚与单文件还原
Rewind operations now use durable transactions with SHA-256-verified blobs, crash recovery, and conflict detection.回滚操作现在使用持久事务，具有 SHA-256 验证的 blob、崩溃恢复和冲突检测。
Middle-click tab close中键关闭标签页
Close desktop tabs with a middle click, matching common browser behavior.用中键点击标签页即可关闭，符合常见浏览器行为。
Unified token display format统一的 token 显示格式
Token counts now use consistent K/M abbreviations across the composer and context panel.token 计数现在在作曲器和上下文面板中使用一致的 K/M 缩写。
Streamlined creation welcome page精简的创作欢迎页
The empty session welcome page now shows a centered hero input with model selection only.空会话欢迎页现在显示居中的 hero 输入框，仅保留模型选择。
Improved改进
Safer subagent cleanup更安全的子代理清理
Subagent cleanup no longer causes false startup errors or blocks on corrupt metadata.子代理清理不再导致误启动错误或因损坏的元数据而阻塞。
Workspace config override warning工作区配置覆盖警告
The settings panel now warns when a workspace reasonix.toml overrides the user config.设置面板现在会在工作区 reasonix.toml 覆盖用户配置时发出警告。
Responsive settings layout响应式设置布局
Settings pages now wrap correctly on narrow windows, preventing overflow and misalignment.设置页面现在在窄窗口下正确换行，防止溢出和错位。
Destructive git command classification破坏性 git 命令分类
Commands like git restore and git stash drop now show danger warnings and require re-approval each time.git restore 和 git stash drop 等命令现在显示危险警告，并每次都需要重新批准。
CLI /status shows active config fileCLI /status 显示活动配置文件
The /status command now reports which config file is in effect./status 命令现在报告当前生效的配置文件。
CLI word motion with Ctrl+arrowsCLI 中使用 Ctrl+箭头移动单词
Ctrl+Left/Right now move by word in the composer on Windows and Linux.在 Windows 和 Linux 上，Ctrl+左/右箭头现在可在作曲器中按单词移动。
Windows console ANSI supportWindows 控制台 ANSI 支持
Legacy Windows consoles now display colored output correctly in setup and config commands.旧版 Windows 控制台现在可在 setup 和 config 命令中正确显示彩色输出。
Recovery notices kept out of IM chats恢复通知不再发送到 IM 聊天
Internal recovery notices are no longer forwarded to WeChat, QQ, or Feishu conversations.内部恢复通知不再转发到微信、QQ 或飞书对话。
Subagent list shows start time子代理列表显示开始时间
Subagent CreatedAt now reflects the actual spawn time instead of completion time.子代理的 CreatedAt 现在反映实际生成时间而非完成时间。
CLI recovery session groupingCLI 恢复会话分组
Conflict-recovery copies are now grouped with their source session and labeled with a short parent ID.冲突恢复副本现在与其源会话分组，并标有简短的父 ID。
Build outputs excluded from @ completion构建输出从 @ 补全中排除
Generated directories like target, __pycache__, and venv no longer appear in file completion.target、__pycache__、venv 等生成目录不再出现在文件补全中。
Project provider_access no longer hides user providers项目 provider_access 不再隐藏用户提供者
A project-only provider_access list no longer hides account-level providers in the model switcher.仅项目级别的 provider_access 列表不再在模型切换器中隐藏账户级提供者。
Planner model degradation on unresolvable provider无法解析提供者时规划器模型降级
When planner_model names an unknown provider, the desktop now warns and continues with the executor alone.当 planner_model 指定未知提供者时，桌面现在会发出警告并仅使用执行器继续运行。
Deleted workspace folder no longer recreated已删除的工作区文件夹不再重新创建
Deleting a workspace folder in Explorer no longer causes Reasonix to recreate it on startup.在资源管理器中删除工作区文件夹不再导致 Reasonix 在启动时重新创建它。
Global hooks migration全局钩子迁移
Global hooks in settings.json are now migrated to the new config home.settings.json 中的全局钩子现在迁移到新的配置目录。
TUI long approval command displayTUI 长批准命令显示
Long commands awaiting approval now wrap in the TUI instead of being clipped.等待批准的长命令现在在 TUI 中换行显示，而不是被截断。
Bounded recursive glob walks递归 Glob 遍历支持超时
Recursive glob searches now default to a 30-second timeout and return clearly marked partial results instead of holding a turn open indefinitely.递归 Glob 搜索现在默认 30 秒超时，并返回明确标记的不完整结果，避免长时间占用当前对话轮次。
Fixed修复
Orphaned macOS updater backup recovery孤立的 macOS 更新器备份恢复
Interrupted updates no longer leave a permanent backup that blocks future updates.中断的更新不再留下永久备份阻塞后续更新。
Pending update debris recovery待处理更新残留恢复
Invalid pending update markers are now cleaned up instead of forcing safe mode.无效的待处理更新标记现在会被清理，而不是强制安全模式。
npm dependency security advisories resolvednpm 依赖安全告警已解决
All 24 open Dependabot alerts across desktop and worker dependencies have been resolved.桌面和 worker 依赖中所有 24 个开放的 Dependabot 告警已解决。
CLI upgrade GitHub authenticationCLI 升级 GitHub 认证
reasonix upgrade now uses GITHUB_TOKEN for authenticated GitHub API requests, avoiding rate limits.reasonix upgrade 现在使用 GITHUB_TOKEN 进行认证的 GitHub API 请求，避免速率限制。
Provider stream errors identify invalid payloads提供者流错误可定位异常载荷
When a gateway sends invalid SSE data, decode errors now identify the provider and include a bounded excerpt of the offending payload.当网关发送无效 SSE 数据时，解码错误现在会标明提供者，并附带长度受限的异常载荷片段。
Longer Retry-After windows are honored遵循更长的 Retry-After 等待时间
Rate-limit responses can now delay retries for up to 60 seconds, including HTTP-date Retry-After values, instead of exhausting attempts against a closed window.限流响应现在可将重试延迟到最长 60 秒，并支持 HTTP-date 格式的 Retry-After，避免在限流窗口内耗尽重试次数。
Transcript elements follow text-size settings对话元素跟随文字大小设置
Thinking headers, tool cards, attachments, memory citations, and inline editing now scale with the configured transcript text size.思考标题、工具卡片、附件、记忆引用和行内编辑现在会随对话文字大小设置同步缩放。
Windows detects malformed subagent storageWindows 可识别异常子代理存储
A file occupying the subagent storage path is now reported as an error on Windows instead of being mistaken for an absent store.当文件占用子代理存储路径时，Windows 现在会正确报告错误，而不会将其误判为存储目录不存在。
Session previews prioritize the request会话预览优先显示实际请求
Prompts that begin with file references now use the following request text for the session preview and sidebar title instead of showing only paths.以文件引用开头的提示词现在会使用后续请求文本生成会话预览和侧边栏标题，而不再只显示文件路径。
Workspace toggle aligns with its panel edge工作区切换按钮与面板边缘对齐
The workspace collapse and expand control now sits at the end of the topic-bar actions in both Workbench and Creation layouts.工作区折叠与展开按钮现在在 Workbench 和 Creation 布局中都位于主题栏操作区末端。
Changes panel uses readable Git status labels改动面板显示易读的 Git 状态
Changed files now show localized labels such as Modified, Untracked, and Conflict instead of raw porcelain codes like MM and ??.改动文件现在显示“已修改”“未跟踪”“冲突”等本地化标签，而不再直接展示 MM、?? 等原始状态码。
ACP session/set_config_option documentationACP session/set_config_option 文档
The ACP documentation now correctly documents the configId parameter.ACP 文档现在正确记录了 configId 参数。
Thanks致谢
This release was shaped by:感谢本版本的贡献者：
Ready when you are准备好即可升级