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)
• 通过工作实践策略加固 Agent 运行 — 新的工作实践策略附加到每个系统提示中，确保 Agent 准确实施所请求的方法，将临时文件排除在仓库之外，并根据变更规模调整验证。 (#7779)
• 修复文件工具通过 FileOverlay 路由及原子写入 — 所有文件工具现在通过主机 FileOverlay 路由，防止在未保存的编辑器缓冲区上进行过时的磁盘写入。文件写入现在是原子的，避免崩溃时出现部分内容。 (#7872)
• 修复 macOS 上的沙箱检测 — 沙箱可用性现在探测 sandbox-exec 的可用性，而不仅仅是检查 PATH 是否存在，从而在受限的 macOS 主机上正确报告不可用。 (#7807)
• 修复 Windows 多来源 Hook 的 POSIX 脚本执行 — Windows 上来自插件、项目和全局钩子的 POSIX shebang 脚本现在被检测并通过 Git Bash 路由，路径已规范化以确保兼容性。 (#7863)
• 自愈卡住的待更新事务 — 卡住的应用内更新现在通过自动提交过期的试用更新并提供“放弃上次更新”按钮来自愈。版本比较已规范化以处理前导 'v' 前缀。 (#7820)
• 合并流式增量以提升性能 — 流式增量现在在 Go 端和前端合并，减少每帧的 reducer 调用和通知，使 UI 更新更流畅。 (#7889, #7890)

新功能

• 运行轨迹记录 — 可选的每次运行 JSONL 事件轨迹记录，用于离线分析工具选择、时间和决策点。 (#7886, #7885)
• 工具结果时间戳 — 工具结果现在包含绝对开始和结束时间，可以重建工具执行与模型思考所花费的时间。 (#7882)

改进

• 现代化 Go 代码库 — 采用现代标准库惯用法（range over int、slices.Contains、min/max 等），并启用 linter 以防止回退。 (#7831)
• 通过解包链进行错误比较 — 所有错误比较现在使用 errors.Is/As，并启用 errorlint 以捕获未来的问题。 (#7834)
• 跨所有构建标签的 lint 检查 — Lint 检查现在覆盖 Windows 和 macOS 特定代码，修复了以前不可见的问题。 (#7837)
• 函数大小和复杂度门控 — 函数大小和圈复杂度现在作为 CI 门控强制执行，防止大型函数增长。 (#7862)
• 文件大小上限扩展到 TypeScript — 800 行文件大小上限现在适用于 TypeScript 文件，语言环境表除外。 (#7879)
• 从注释中去除章节横幅装饰 — 从注释中删除了 312 个章节横幅分隔符，repolint 上限降至零。 (#7840)

修复

• 修复 metricsSink 双重转发事件 — 删除了 record() 内部的过时转发，该转发导致在 --metrics 运行时每个事件被转发两次。 (#7883)
• 修复仅推理停止后的过时结果 — 内部消费者现在需要可见的最终答案，对仅推理停止进行有限重试，防止早期轮次的过时文本。 (#7817)
• 修复竞争检测器下会话并发测试超时 — 减少测试量以保持在竞争检测器的预算内，同时保持重叠以进行竞争检测。 (#7821)
• 阻止 CLI 和 SSH 测试访问外部网络 — CLI 测试现在使用离线 provider，SSH 测试 stub 外部命令，确保测试运行确定性。 (#7856)
• 更正 PR 元数据门控文档 — 记录了 Documentation-impact 门控，并更正了 Cache-impact 的拒绝值行。 (#7876)

升级提醒

本版本无需手动迁移。

风险提示

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

致谢

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

下载与安装

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