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

67 lines
10 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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设备或证书迁入。当时原件见[中间清单](project-cache-f-interim-evidence/manifest.json)和[中间身份](project-cache-pending-native-identity.json),其中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身份保持历史原件。完整证据见[清单](project-cache-f-release-evidence/manifest.json)和[发行身份](project-cache-release-identity.json)。最后逐表/会话导出/模型中心/工件核对保持;完整F与独立ACCEPTANCE在原不可变安装器/ZIP之外绑定最终Git。