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 级别，并为其他 provider 保留保守默认值。 (#7839)
• 缓存感知上下文投影 — 历史压缩改为缓存感知上下文投影，完整 canonical transcript 永久保留，缓存状态仅用于成本策略。 (#7839)
• Agent 工作实践策略 — 新增工作实践策略，附加到每个系统提示中，强制实施请求的方法、避免在仓库中留下临时文件并扩展验证。 (#7779)
• 文件工具通过 FileOverlay 路由且写入原子化 — 所有文件工具现在遵循主机 FileOverlay，防止覆盖未保存的编辑器缓冲区，并且文件写入原子化以避免损坏。 (#7872)
• macOS 沙箱检测探测可用性 — 沙箱可用性现在探测实际可用性，而不仅仅是检查 PATH，防止在受限 macOS 主机上静默失败。 (#7807)
• Windows POSIX 钩子脚本规范化 — Windows 上来自插件、项目和全局钩子的 POSIX shebang 脚本现在被检测并通过 Git Bash 路由，并进行路径规范化。 (#7863)
• 防止仅推理停止后的过时结果 — 内部消费者现在要求可见的最终答案，防止仅推理停止后出现陈旧或空结果，并带有有限重试。 (#7817)
• 卡住的应用内更新自愈 — 卡住的待更新事务现在超时后自动提交，用户可以通过新按钮放弃，并修复了版本号规范化问题。 (#7820)

新功能

• 工具结果时间戳 — 工具结果现在包含绝对开始/结束时间，用于轨迹记录。 (#7882)

改进

• 代码现代化和 lint 检查 — 采用现代 Go 惯用法，为所有构建标签启用 lint 检查，并将文件大小检查扩展到 TypeScript。 (#7831, #7837, #7879)
• 错误比较安全性 — 所有错误比较现在使用 errors.Is/As，防止错误包装时静默中断。 (#7834)
• 注释风格清理 — 移除注释中的章节横幅装饰，保持一致性。 (#7840)

修复

• 会话并发测试超时 — 减少测试量以保持在竞态检测器预算内。 (#7821)
• CLI 和 SSH 测试隔离 — 防止测试进行真实的网络调用或调用主机命令。 (#7856)

升级提醒

本版本无需手动迁移。

风险提示

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

致谢

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

下载与安装

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

[SivanCola]

Reviewed refreshed bilingual v1.21.2 notes against current main-v2 (includes post-#7881 changes such as #7882). Record status=reviewed and differs from main-v2 so the candidate can rebind. Approved for merge after required checks.