release: v2.0.10 工具结果摘要与动态上下文余量

[wicm84266964]

Ant Code v2.0.10：工具结果摘要与动态上下文余量

发布日期：2026-09-10

这是面向长编程和数据分析任务的小版本更新。主会话达到配置的请求预算后，较旧工具结果改用模型批量摘要，替代固定字符裁剪；同时区分工具摘要和历史对话摘要，减少连续“聊天内容已压缩”提示造成的误解。本说明为发布候选记录，线上 CI、标签和 Release 状态以实际发布记录为准。

对用户工作流的直接变化

• TUI、Dashboard 和 CLI 主会话仍按包含工具定义和结果的完整请求预算触发压缩；预算充足时保留工具原文。触发后，按近期十次正向请求增长的第 75 百分位估算后续三轮用量，加上可识别的输出预算或 8,192 token 默认值，将目标剩余空间限制在窗口的 10%–20%。token 与字节预算分别检查。
• 每次预算处理最多调用三批工具摘要，单批原文最多 256,000 字节，并受当前窗口约束。最近四条工具结果、错误诊断、图像、短结果和已取回证据不参与此批量摘要。摘要必须成功且节省至少约 20% 文本空间才替换；失败、取消、原文无法归档或收益不足时保留原文。
• 新增 tool_result_read：主智能体可凭会话内的证据引用分页取回摘要前的工具文本。恢复会话后引用仍可使用；不同会话不能通过猜测引用直接读取彼此的证据。
• Dashboard 显示“正在生成工具摘要”“工具结果已摘要”，不再为工具摘要插入聊天压缩分界线；历史对话摘要继续保留自己的状态和分界线。TUI 也单独标识工具摘要。
• 同一运行会话内，未变化的历史不会在每次请求前反复调用历史摘要。若受保护内容或其他载荷仍使请求超窗，仍在本地停止发送。
• 配置原子保存遇到短暂文件占用时有限重试，每次重新检查配置版本；持续失败仍报错，等待期间的外部配置修改不会被重试覆盖。

配置、数据与安全边界

• 不要求手动迁移配置。新增归档位于 .lab-agent/sessions/<session-id>.tool-evidence/，复用会话存储的加密、脱敏、保留期和删除机制；引用及最近 100 条摘要/预算诊断保存在会话元数据的 transcript.toolSummaries。
• 归档保存的是“摘要前模型可见的工具文本”，不是工具已经截断之前的完整文件或终端输出。精确数据仍应以工作区文件及保存的分析产物为准。
• 单会话工具证据上限为 32 MiB；关闭会话留存、保留期为零或超过归档上限时跳过工具摘要。不会为了压缩而偷偷创建不受会话策略约束的明文缓存。
• 摘要沿用当前会话网关和取消信号，不给摘要请求执行工具的能力；新增模型调用会产生额外时间和费用。摘要仍可能遗漏信息，不能替代关键结果复核；原文取回遵守本地留存和脱敏边界。
• 本次不更新其他产品的内嵌运行时，不同步真实会话、凭据或研究数据。自动化测试不等于所有供应商与私人研究工作流均已验证。

升级与产物位置

需要 Node.js 22.18+。源码安装更新后执行 npm ci、npm run verify:install；使用全局链接的用户可执行 npm link。ant-code --version 应显示 2.0.10。完整重启 TUI/Dashboard，浏览器刷新以加载当前资源。

已有配置和会话继续使用；历史上已裁剪或摘要丢失的内容不会自动恢复。新建的工具证据归档随对应会话清理，无需手动搬迁。审计产物仍由发布检查写入既有审计目录。

验证、限制与待完成门禁

• 开发阶段已覆盖动态余量、预算触发、摘要无收益/失败/取消、原文恢复、加密、分页边界、会话删除和界面事件区分；用户已完成本地验收。
• 开发仓完整单元/集成套件通过；发布门禁发现配置重命名偶发占用和 MCP 测试初始化超时后，修复并通过 27 项定向回归及类型检查。正式仓最终完整 verify:release 通过：单元/集成 1,312 项、浏览器 37 项，均无失败或跳过；安装、网关兼容、资源一致性、发布封印和审计检查通过，额外跨进程持久化/后台任务套件通过。定向测试与完整套件存在重叠，不累计为独立覆盖。
• 跨仓一致性检查覆盖所有本轮功能及测试文件，公开包元数据和内部文档排除差异单独审查。候选提交后仍须 GitHub PR 和 main CI 通过，随后创建标签与 Release；实际完成状态记录在公开 CHANGELOG。
• 10%–20% 是有界目标而非每次必达保证：受保护结果、批次数限制和历史摘要策略可能使实际剩余空间少于目标。短结果仍保留原文，不额外调用模型合并；历史对话摘要的原有本地降级策略保持不变。
• 关闭留存或用尽证据空间时，不会以机械裁剪代替失败的工具摘要。需要更大窗口、结束当前轮次或按现有流程处理历史上下文。