Files
Agent-Workbench/docs/QA-1.19.md
T
2026-11-01 09:31:00 +08:00

10 KiB
Raw Blame History

1.19 验收记录:项目上下文缓存

基线606b5ec;阶段方案见PLAN-1.19.md。本文持续记录实际结果,未运行项目不记为通过。

切片 状态 原证据/结论
A 测量 已完成 project-cache-a-evidence/baseline.json;3种样本各冷/热3轮/新实例/同大小mtime修改,共18次
B 有界缓存 已实现/专项通过 8项目、内存/磁盘各32MiB、单项目8MiB;目录/文件/结构/摘要核对,失败回退
C 严格失效 已实现/专项通过 22/22含旧索引;配置/分支、同大小mtime、权限/链接、不完整扫描、并发变化及清除竞态
D 产品入口 已实现/7组通过 实际Edge1440/390px:核对/复用、同大小mtime失效、开关保存/刷新、清除重建、错误重试、诊断、键盘/触控/对比度
E 同题工程 已通过 9节点、Node8/8、React9/9、Python10/10,原失败/审批、构建/编译、两视口实际页面、Git/原修改保护
F 完整发行 已完成 独立590/590、27类203组UI、随包/同载荷安装7组、保留全状态升级、正式24页/全部工件及升级后原生回看通过;原Esc中断和中间封存保持

QA使用独立目录和端口。本地解析命中、上游prompt缓存、实际计费分别记录;固定响应不作为真实模型推理收益。真实视觉工程、Purge收益及新增iPhone流程继续单列待验。

A 测量与范围

固定Node24.22.1;每种工程72份源码、每份36个声明,附一份包/工程声明。原输入SHA及同大小mtime变更前后SHA分别保存。读计数仅统计所选工程源码/声明,不含派生缓存读写。Node冷148.7ms、热中位84.0ms、新实例169.0ms;React冷315.3ms、热中位75.1ms、新实例189.6ms;Python冷100.7ms、热中位74.6ms、新实例98.0ms。首次解析读取146/146/147次,热74/74/75次;同大小mtime变化只更新1份,来源指纹变化。单次耗时受Git/调度影响,不宣称全任务倍数收益。

现有缓存对同进程足够;跨实例仍全部重解析,AST样本存在可复用收益。B仅增加有界持久解析材料,不缓存请求/工具副作用或跳过源码SHA。Python收益较小,后续比较照实记录。项目记忆已有来源/过期核对;请求验证缓存局限原次验证,不扩为跨请求权限依据。审查发现旧内存复用只绑定文件SHA,缺少解析配置、Git分支和不完整扫描的显式隔离;C补齐来源闭合检查及相关测试。

B/C 实现与专项

单一ProjectIndex复用流程增加持久派生材料,绑定projectWorkspaceIdentity、解析器/格式修订/预算及Git HEAD/branch;逐文件核对本次SHA、字节数、文件访问身份。当前源码扫描不完整时不用旧材料且不保存新缓存。建立后再做一次有界完整快照,源码、路径集、访问范围和分支变化以409拒绝;清除/关闭期间的pending不能重新填入缓存。

仅保存声明/导入和派生签名,没有源码正文、模型Key、请求、审批或工具结果。内存与磁盘各最多8项目/32MiB,单项目8MiB;超限仍返回当前索引。损坏摘要/JSON/字段重建,外链目录、软/硬链接缓存文件拒绝。settings仅保存enabled;清除仅删除当前项目摘要命名的派生文件。原工件和冻结请求不改写。

新增11项加原11项共22/22通过,原日志project-cache-bc-evidence/fixed.tap。第一次8/9暴露损坏symbols含null的验证器异常,修正结构检查后重建通过,失败原件first-failure.tap保留。实际chmod只证明文件mode变化;拒绝读取通过EACCES注入验证,不把注入称为Windows ACL实机。性能与完整工程结果待E。

D 产品与闭合复核优化

沿用工程索引的检索布局;新增折叠「解析缓存」,显示上次检索核对、实际复用/重新解析、失效原因、耗时及存储状态。开关明确为全机,清除仅本项目;清除后保持上次检索并说明下次重建,避免伪造新核对时间。诊断只读取缓存状态,不运行检索。1440/390px实际Edge7组通过,已目视回看desktop-warm.png/narrow-cache.png;44px关键操作、键盘和实际指标文字4.5:1以上通过。入口初步验证版本仍为1.18开发构建,正式1.19会在F独立包重新验证。

API2/2通过,包括桌面token、精确字段、项目归属、清除后完整会话导出/配置/源码保持和真实宿主重启后持久开关/解析复用;伴随端真实TLS观察设备访问/配置缓存各端点均404,1/1通过。没有新增手机管理权限或iPhone实机结论。

初次比较显示两次完整工程检查/每次重写磁盘使热检索回退,原计时保留project-cache-d-evidence/comparison-first.json。优化仅将第二次声明/Git status/filter配置等无关复查替换为文件句柄两轮SHA闭合、文件集/Git身份核对,未变化派生文件只更新淘汰时间。优化22/22通过,原日志closure.tap;最终同题统计仍待E。UI/接口首轮失败为导出即时exportedAt比较及Playwright同步uncheck,与产品数据损坏无关;仅验证并剔除导出时间,其他完整字段保留比较,切换改为click并等待服务端保存,原件封存。

E 同题与性能边界

1.19实际Runtime中执行9节点:每种工程在同一原输入上冷建、跨实例磁盘载入、进程内复用、变更及恢复原源码后失效重建;核对原源码/索引指纹、完整声明/导入及查询语义相同。之后固定HTTP算法调用index_project/query_code,并封存原模型请求;每个请求通过原工件/预算/工具对核验。保留原失败检查和显式文件/命令审查,Node8/8、React9/9、Python10/10及构建/编译通过;React1280/390px各12步实际Edge检查通过,Git只含已审查文件,原暂存/工作区/未跟踪字节保持。固定响应证明执行链,不能作为模型自主推理收益。原报告/请求等见project-cache-e-evidence/manifest.json。

三对串行交替旧索引/新缓存进程,共108次查询;每份固定输入原SHA相同。旧索引代码取自606b5ec,只重定位两条导入到共享的当前默认I/O接口;原A的实际旧版记录另外保留。以下为中位毫秒,热每组9次,其余每组3次:

样本 冷建 旧→新 热复用 旧→新 新实例 旧→新 同大小mtime变更 旧→新
Node 144.2→164.6 77.8→83.7 115.3→86.1 74.8→89.1
React 170.0→195.7 74.2→84.6 136.3→103.7 76.9→89.3
Python 100.8→156.8 120.6→125.7 135.5→131.1 76.4→134.2

跨实例Node/React分别减少约25%/24%的本地观察耗时且72份源码从重新解析变为0;Python波动大,没有稳定收益结论。增加第二轮来源SHA核对后,热/失效和冷建有开销;旧热读取74/74/75次,新热147/147/148次。不能宣称全面加速或token节省。保留完整范围/最慢值,见performance-corrected.json;原汇总对旧版解析数误用updatedFiles-1,只有该派生计数在新报告中修正,原耗时、读次数、行记录和错误原件performance-original.json均保留。

F 验证、中间封存及后续完成

1.19.0完整本地交付:有界持久解析缓存、逐次两轮来源SHA核对、严格失效、开关/清除及索引/诊断入口。独立源码590/590、27类203组历史UI、新缓存7组及9节点工程、原生窗口7项/受控流程9组/桌面工程16节点、Responses13节点、截图7节点及Node8/8、React9/9、Python10/10通过。随包缓存/伴随端/协议/视觉、同载荷安装7组、正式24页和升级后原生回看通过。原PID36552/Provider、17项目/30全部会话/2614记录/4701事件、全部表每行/导出/模型中心/工件原字节保持,1466工件记录/1376去重文件核对,9229关闭。本轮真实模型请求0;真实视觉工程/Purge收益及新增iPhone实机继续单列待验。

冻结405输入/22构建/40原基准,来源c685546f9acfb496977d9744700d62ab1f5c2865;不可变Agent-Workbench-1.19.0-win-x64-20261031184556353。源码归档15,515文件同卷移动短路径后SHA保持,独立离线安装/重建和590项整轮通过,所有历史原生/工程及新缓存7组/9节点再次通过。378输入与原Git严格相同,22仅声明CRLF/LF规范化,5个示例生成文件按已提交生成器逐字节对应;133份依赖许可及136文件/notice与两包保持。

正式升级重新采集17项目/30会话/2614记录/4701事件的全状态及私有备份;原安装器stage、一次热升级、指针activate和最终verify分别通过。正式24页只读检查零页面/请求/HTTP错误或写请求;1466工件记录、1376物理文件全核对,原模型中心/行/导出/字节保持。正式手机网关关闭、无QA设备或证书迁入。当时原件见中间清单和中间身份,其中success=false记录原生及最终封版尚未闭合;后续完成结果见文末。

首轮历史UI在源码/打包并行时,真实命令批准后5秒仍显示执行中而超时;原独立账本显示4工具/5步骤完成,5.64秒到待审查,无页面异常。原日志、DOM、截图及前9类结果保留;未改产品/放宽断言,随后串行整轮27类203组通过。可能延迟关闭的卸载日志仅接受原SHA精确前缀及固定199字节终结四行,前缀与最终日志分别封存。

升级前1.18原生窗口已实际观察封存。首次打开升级后正式原生窗口时,Computer Use报告用户按物理Esc停止;立即停止全部原生输入,不绕过换通道,不把升级前截图或自动原生测试当作升级后人工观察。当时保留升级后回看、完整F封存及最终ACCEPTANCE待验状态;后续完成见下一节,安装器/ZIP不改写。

F 续验完成

用户继续后重新列举实际窗口,通过现有正式启动器打开1.19;原任务、原高性能模型选择、工程索引缓存和诊断均已实际观察,原截图及可访问树按SHA保存。启动器完整清单核对期间暂未暴露窗口,未重放启动/安装/升级;仅等待原进程完成后选取真实窗口。原Esc中断、867份中间封存及pending身份保持历史原件。完整证据见清单和发行身份。最后逐表/会话导出/模型中心/工件核对保持;完整F与独立ACCEPTANCE在原不可变安装器/ZIP之外绑定最终Git。