Reasonix / v1.21.0
Reasonix 1.21.0: Shell Execution Contract, Cache Accuracy, and CLI PolishReasonix 1.21.0：Shell 执行契约、缓存精度与 CLI 打磨
This release introduces a structured shell execution contract with phase-aware error reporting, improves prompt-cache hit rates and cost accounting, and delivers a wave of CLI and desktop refinements — including stream recovery, session temp persistence, and a refreshed website.此版本引入了结构化的 Shell 执行契约与分阶段错误报告，提升了提示缓存命中率与成本核算精度，并带来一系列 CLI 与桌面端改进——包括流恢复、会话临时文件持久化以及焕新的官网。
Start here使用攻略
Shell Execution ContractShell 执行契约
Learn how Reasonix now reports shell identity, exit phase, and verification status for every command.了解 Reasonix 如何为每条命令报告 Shell 身份、退出阶段与验证状态。
↗Session Temporary Files会话临时文件
Bash temporary files now persist across commands within a session, with automatic cleanup.Bash 临时文件现在在会话内的多条命令间持久保留，并自动清理。
↗CLI Usage ReceiptsCLI 用量回执
You can now hide per-turn token/cost receipts in the TUI while keeping usage accounting active.现在可以在 TUI 中隐藏每轮 token/费用回执，同时保持用量统计活跃。
Highlights重点内容
Structured Shell Execution with Phase-Aware Errors结构化 Shell 执行与分阶段错误报告
Shell commands now carry internal metadata (shell identity, platform, exit code, failure phase, mutation risk, verification status) for accurate error presentation across Desktop, CLI, and ACP. The provider-visible tool schema remains unchanged.Shell 命令现在携带内部元数据（Shell 身份、平台、退出码、失败阶段、变更风险、验证状态），在桌面端、CLI 和 ACP 中准确呈现错误。Provider 可见的工具 schema 保持不变。
Prompt-Cache Hit Rate and Cost Accuracy提示缓存命中率与成本精度提升
Adaptive Anthropic cache TTL extends the cache window after idle periods, reducing unnecessary rewrites. Cache diagnostics now correctly attribute changes, and cost accounting includes cache-write premiums for accurate billing.自适应 Anthropic 缓存 TTL 在空闲后延长缓存窗口，减少不必要的重写。缓存诊断现在正确归因变更，成本核算包含缓存写入溢价以实现准确计费。
Stream Interruption Recovery流中断恢复
Interrupted provider streams are now replayed atomically up to five times, preventing partial tool execution. Desktop, CLI, and ACP surfaces roll back speculative output until a clean terminal event is received.中断的 Provider 流现在可原子重放最多五次，防止部分工具执行。桌面端、CLI 和 ACP 界面会回滚推测性输出，直到收到干净的终止事件。
Session-Wide Bash Temporary Files会话级 Bash 临时文件持久化
Bash temporary files now persist across commands within a session via a private session directory, while per-command sandboxing is preserved. Automatic rotation and cleanup prevent leaks.Bash 临时文件现在通过私有会话目录在会话内的多条命令间持久保留，同时保持每条命令的沙箱隔离。自动轮换与清理防止泄漏。
CLI Polish: Scrolling, Completions, and KeyboardCLI 打磨：滚动、补全与键盘操作
Transcript scrolling now follows output correctly, slash-command completions are cached for responsiveness, and keyboard shortcuts are refined: Ctrl+Backspace deletes words, while Ctrl+Insert/Shift+Insert handle clipboard operations.对话滚动现在正确跟随输出，斜杠命令补全被缓存以提升响应速度，键盘快捷键得到优化：Ctrl+Backspace 删除单词，Ctrl+Insert/Shift+Insert 处理剪贴板操作。
Desktop: Blank Session Provider, Todo Panel, and Windows Shortcuts桌面端：空白会话 Provider、待办面板与 Windows 快捷方式修复
Reused blank sessions now respect the default provider. The todo panel updates live from todo_write events. Windows shortcuts broken by versioned upgrades are automatically repaired.复用的空白会话现在遵循默认 Provider。待办面板根据 todo_write 事件实时更新。因版本化升级而损坏的 Windows 快捷方式会被自动修复。
Goal Token Limits Removed移除 Goal token 硬上限
Per-Goal token hard limits and request-admission middleware have been removed, preventing premature work pauses. Turn quotas and no-progress protection remain active.移除了每个 Goal 的 token 硬上限与请求准入中间件，防止工作提前暂停。轮次配额与无进展保护仍然有效。
SWE-bench Verified Evaluation ModeSWE-bench Verified 评估模式
e2ebench now supports SWE-bench Verified, running the agent inside official evaluation images with restricted egress for honest, auditable scores.e2ebench 现在支持 SWE-bench Verified，在官方评估镜像内运行 Agent 并限制网络出口，以获得诚实、可审计的分数。
Website Refreshed with Agent-First Messaging官网焕新：以 Agent 能力为先
The landing page now leads with what the agent can do, featuring a real task replay, updated feature cards, and a new Surfaces section showing all four front ends.着陆页现在以 Agent 的能力为先，展示真实任务回放、更新的功能卡片以及展示全部四种前端界面的新 Surfaces 区块。
New新增
CLI: Hide per-turn usage receiptsCLI：隐藏每轮用量回执
Added `[ui].show_turn_usage` config to hide token/cost receipts in the TUI while keeping accounting active.新增 `[ui].show_turn_usage` 配置，可在 TUI 中隐藏 token/费用回执，同时保持用量统计活跃。
CLI: Version metadata and shell completionCLI：版本元信息与 Shell 补全
`reasonix version --verbose/--json` shows commit and build time. Shell completion registry aligned with real parsers.`reasonix version --verbose/--json` 显示提交与构建时间。Shell 补全注册表与实际解析器对齐。
CLI: Ctrl+Insert copy and Shift+Insert pasteCLI：Ctrl+Insert 复制与 Shift+Insert 粘贴
Added classic terminal clipboard keys: Ctrl+Insert copies selection, Shift+Insert pastes via native clipboard.新增经典终端剪贴板快捷键：Ctrl+Insert 复制选中内容，Shift+Insert 通过原生剪贴板粘贴。
Improved改进
CLI: Rewind picker shows real user prompts and scrollsCLI：回退选择器显示真实用户提示并可滚动
The rewind picker now displays the user's original input instead of composed provider prompts, and scrolls within a viewport for long sessions.回退选择器现在显示用户的原始输入而非组合后的 Provider 提示，并在长会话中于视口内滚动。
CLI: `run --resume` accepts machine session IDsCLI：`run --resume` 接受机器会话 ID
One-shot `run --resume` now resolves opaque machine session IDs in addition to filesystem paths.一次性 `run --resume` 现在除了文件系统路径外，还能解析不透明的机器会话 ID。
CLI: `--profile` flag routes to interactive sessionCLI：`--profile` 标志路由至交互式会话
Bare `reasonix --profile …` now correctly dispatches to the interactive session path as documented.无子命令的 `reasonix --profile …` 现在按文档正确路由至交互式会话路径。
CLI: Diagnostics, keyring migration, and Reasonix-home hardeningCLI：诊断、密钥环迁移与 Reasonix-home 加固
Startup diagnostics now expose progress and bounded recovery signals, keyring migration fails closed under timeout or error, and CLI tooling consistently uses the exact Reasonix home while redacting paths in reports.启动诊断现在提供进度与有界恢复信号；密钥环迁移在超时或错误时安全停止；CLI 工具统一使用准确的 Reasonix home，并在报告中隐藏路径。
Desktop: macOS workbench sidebar titlebar zoom桌面端：macOS 工作台侧边栏标题栏缩放
Double-clicking the empty titlebar strip above the workbench sidebar on macOS now triggers native window zoom.在 macOS 上双击工作台侧边栏上方的空白标题栏区域现在会触发原生窗口缩放。
Serve: Replay pending prompts for late SSE clientsServe：为迟到的 SSE 客户端重放待处理提示
When a browser attaches to `reasonix serve` after a confirm-gated tool is queued, the pending approval prompt is now replayed.当浏览器在确认门控工具排队后连接到 `reasonix serve` 时，现在会重放待处理的批准提示。
Documentation and i18n consolidation文档与国际化整合
Consolidated documentation updates including Simplified Chinese reasoning-provider reference, removed unused i18n keys, and completed locale translations.整合文档更新，包括简体中文推理 Provider 参考、移除未使用的 i18n 键以及完成语言环境翻译。
Fixed修复
Desktop: Repair Windows uninstall registration桌面端：修复 Windows 卸载注册项
Upgrades from legacy Tauri installs no longer leave stale uninstall entries that could remove the current installation.从旧版 Tauri 安装升级不再留下可能删除当前安装的过期卸载条目。
Release: Tolerate npm registry visibility lag发布：容忍 npm 注册表可见性延迟
Extended the npm registry visibility window to 5 minutes to prevent publication stalls.将 npm 注册表可见性窗口延长至 5 分钟，防止发布停滞。
Upgrade notes升级提醒
Thanks致谢
This release was shaped by:感谢本版本的贡献者：
Ready when you are准备好即可升级