docs(release): 准备 v1.21.2 中英更新日志

[github-actions]

此版本将输出预算提升至 128K，引入缓存感知上下文投影以更高效管理历史，通过工作实践策略加固 Agent 行为，并修复了文件工具、沙箱检测、钩子和更新等方面的诸多问题。

发布渠道：稳定版 · v1.21.2

English → · 网页版完整更新日志 →

使用攻略

• ACP 指南 — 了解如何使用 Agent 通信协议进行编辑器集成。
• ACP 指南（中文） — ACP 指南的中文版本。
• 桌面钩子（中文） — 配置和使用桌面钩子的指南。
• 用户指南 — 使用 Reasonix 的综合指南。
• 用户指南（中文） — 用户指南的中文版本。
• 插件包 — 创建和管理插件包的文档。
• 插件包（中文） — 插件包文档的中文版本。
• 恢复指南 — 从卡住的更新和其他问题中恢复的步骤。
• 恢复指南（中文） — 恢复指南的中文版本。
• 规范 — Reasonix 的技术规范。
• 缓存感知压缩设计 — 关于缓存感知上下文投影的研究文档。

概览

Reasonix v1.21.2 — Reasonix v1.21.2：输出预算提升、缓存感知上下文与 Agent 加固

此版本将输出预算提升至 128K，引入缓存感知上下文投影以更高效管理历史，通过工作实践策略加固 Agent 行为，并修复了文件工具、沙箱检测、钩子和更新等方面的诸多问题。

发布日期：2026-08-07

重点内容

• 128K 输出预算与缓存感知上下文投影 — Provider 范围的输出预算现在支持 128K 级别的推理上限。会话将持久历史与模型可见请求分离，具有确定性的投影顺序和故障关闭的前缀有效性。 (#7839)
• 系统提示中的工作实践策略 — 新的工作实践策略附加到每个系统提示中，强制要求精确实现所请求的方法，将临时文件排除在仓库之外，并根据变更规模进行验证。 (#7779)
• 文件工具现在通过 FileOverlay 路由，写入操作原子化 — 所有文件工具（edit_file、multi_edit、delete_range、delete_symbol、notebook_edit）现在通过主机 FileOverlay 路由，防止在未保存的编辑器缓冲区上进行过时的磁盘写入。文件写入是原子化的，使用临时文件并重命名以避免部分写入。 (#7872)
• Agent 加固：防止过时结果并改进交付 — 内部消费者现在需要可见的最终答案，防止在仅推理停止后出现过时结果。重试清理考虑了压缩和重写，Guardian 审查在有限的空最终结果后故障关闭。 (#7817)
• 自愈卡住的待更新事务 — 卡住的应用内更新现在可以自愈：版本比较已归一化，过期的试用更新在 24 小时后自动提交，并在设置中提供“放弃上次更新”按钮。 (#7820)
• 沙箱检测现在探测可用性，而不仅仅是 PATH 存在 — 在 macOS 上，现在使用最小配置文件探测 sandbox-exec 的可用性，防止在 sandbox_apply 不被允许的受限主机上静默失败。 (#7807)
• 跨来源的 Windows POSIX 钩子脚本归一化 — Windows 上来自插件、项目和全局钩子的 POSIX shebang 脚本现在被检测并通过 Git Bash 路由，并对 Claude 隐式 shell 插件进行路径归一化。 (#7863)
• 指标接收器不再重复转发事件 — 之前重构中引入的一个错误导致 --metrics 运行中的每个事件被转发两次，导致输出和通知膨胀。此问题已修复。 (#7883)

新功能

• 基准测试中的每任务轨迹记录 — E2E 基准测试套件现在可以为每个任务记录一个轨迹文件，并在报告中显示时间归因（工具 vs. 模型）。 (#7885)
• 使用 --trajectory 记录运行事件轨迹 — 现在可以通过 --trajectory 选择加入每运行一次的完整类型化事件流的 JSONL 日志，支持离线重放和分析。 (#7886)

改进

• 工具结果现在带有绝对开始/结束时间戳 — 工具调用结果现在包含 StartedAt/EndedAt（Unix 毫秒），允许重建工具执行与模型思考所花费的时间。 (#7882)
• 采用现代 Go 惯用法并加以约束 — 代码库已更新为现代标准库惯用法（range over int、slices.Contains、min/max 内置函数等），减少 549 行代码，并启用 linter 以防止回归。 (#7831)
• 错误比较现在全面使用 errors.Is/As — 所有错误比较已转换为使用 errors.Is 和 errors.As，并设置 linter 约束以防止未来的直接比较。 (#7834)

修复

• CLI 和 SSH 测试不再访问外部网络 — 无意中进行真实 API 调用或调用主机 ssh 的测试已修复为使用离线桩。 (#7856)
• 会话并发测试保持在 -race 预算内 — 会话并发测试已优化，以在竞争检测器的时间预算内完成，防止 CI 超时。 (#7821)

升级提醒

本版本无需手动迁移。

风险提示

当前没有需要额外操作的已知风险。

致谢

感谢本版本的贡献者：@esengine、@github-actions[bot]、@clearnature、@chuiwenwei、@SivanCola、@Nath-Vikky

下载与安装

• 官网按平台下载
• 查看完整差异