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 输出预算与缓存感知上下文投影 — 支持的模型输出预算提升至 128K。历史管理采用缓存感知上下文投影，保持完整记录不变，仅根据 token 压力和缓存状态调整模型可见前缀。 (#7839)
• 通过工作实践策略加固 Agent — 新增工作实践策略，附加到每个系统提示中，确保 Agent 严格按指定方法实施、不将临时文件留在仓库中，并在声明完成前检查最终差异。 (#7779)
• 流式性能提升：合并增量与块级解析 — 流式增量现在在 Go 后端合并，并在前端每帧合并为一次 reducer 处理。Markdown 解析仅在完整块上推进，大幅减少小回答的解析频率。 (#7889, #7890, #7892)
• 文件工具通过 FileOverlay 路由并原子写入 — 所有文件编辑工具现在遵循主机的 FileOverlay，防止覆盖未保存的编辑器缓冲区。文件写入为原子操作，避免中断时损坏。 (#7872)
• 自愈卡住的更新与放弃选项 — 卡住的待更新事务在安装证据完整时 24 小时后自动提交。新增“放弃上次更新”按钮，允许用户手动清除卡住的事务。 (#7820)
• macOS 沙箱检测现在探测可用性 — 在 macOS 上，沙箱可用性现在通过实际探测 sandbox-exec 确定，而非仅检查 PATH，防止在受限主机上静默失败。 (#7807)
• Windows 钩子 POSIX 脚本规范化 — 钩子中的 POSIX shebang 脚本现在在 Windows 上被检测并通过 Git Bash 执行，并进行路径规范化以确保兼容性。 (#7863)

新功能

• 运行轨迹记录 — CLI 运行现在可通过 --trajectory 记录完整事件轨迹，支持离线分析工具选择、时序和决策。 (#7886)
• 基准测试轨迹与时间归因 — 端到端基准测试套件可记录每个任务的轨迹，并将实际耗时归因于工具执行与模型思考。 (#7885)

改进

• 现代 Go 惯用法与全平台代码检查 — 代码库更新至现代 Go 惯用法（如 range over int、slices.Contains 等），代码检查现在覆盖所有构建标签，而非仅 linux/amd64。 (#7831, #7837)
• 错误处理标准化 — 错误比较现在统一使用 errors.Is/As，自定义解包辅助函数替换为标准库函数。 (#7834)
• 函数大小与复杂度门禁 — 函数大小和圈复杂度现在作为 CI 门禁强制执行，防止已大型函数继续增长。 (#7862)
• 文件大小上限扩展至 TypeScript — 800 行文件大小上限现在适用于 TypeScript 文件，本地化表格除外。 (#7879)

修复

• 防止仅推理停止后的过时结果 — 内部消费者现在要求可见的最终回答，对仅推理停止进行有限重试，防止使用过时文本。 (#7817)
• CLI 指标接收器重复转发 — 修复了指标接收器重复转发每个事件导致输出和通知翻倍的错误。 (#7883)
• 会话并发测试预算 — 缩减会话并发测试规模，以保持在竞态检测器的时间预算内。 (#7821)
• CLI 与 SSH 测试隔离 — CLI 和 SSH 测试不再进行真实网络调用，确保结果确定性。 (#7856)

升级提醒

本版本无需手动迁移。

风险提示

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

致谢

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

下载与安装

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