Files
Agent-Workbench/docs/PLAN-1.23.md
T
2026-11-02 11:58:42 +08:00

56 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.23 计划:发行效率与更新进度
最终状态:A–E已本地交付,实际结果见[验收](QA-1.23.md)和[回顾](RETROSPECTIVE-1.23.md)。下方原调研/阶段文字保留其当时含义,不代表当前尚未实现;下一为PLAN-1.24。
1.22冻结载荷`20261101225201840`的只读清单盘点:20,961文件、1,968,516,148字节,其中docs为10,174文件、1,320,028,962字节。清单SHA-256为`02737d1e0fac80334f0ff28a42868066b9ac5b339ca3a3fc443cecc915a36265`。这是同载荷独立源码、便携与实际安装通过后的候选体积,盘点时正式推广仍在进行;最终状态另见1.22发行身份。下一阶段先建立必需运行/帮助清单及引用闭包,将完整历史证据按来源和SHA单独分发;当前未实施拆分,也不能把文件体积直接换算成时间收益。
本阶段已经启动;下方原调研文字保留当时含义,实际实现/验收进度见文末。[1.22 内置浏览器验收](QA-1.22.md)、正式升级及回顾现已完成;本阶段在该固定来源和原测量基础上开始实施,每个切片独立验证、回顾和本地Git提交。
实际问题是安装、启动与激活核对越来越慢,用户难以判断等待是否正常。1.21 不可变载荷为 19,965 文件、1,844,462,298 字节,其中 docs 为 9,178 文件、1,196,144,080 字节;stage 1095.822 秒、activate 751.765 秒。这些是历史原始测量,不能直接归因为某个目录,也不能先承诺优化比例。
目标是减少运行所需的分发和重复工作,同时让用户明确看到当前阶段、已核对范围、停止边界与失败后的下一步。保留安装包、当前版本指针、全部原数据、原 Provider、回退和完整性验证契约。
| 切片 | 实现方向 | 验收门槛 |
| --- | --- | --- |
| A 实测与范围 | 固定同一载荷和自有数据,记录解压、完整文件校验、宿主身份、数据快照与指针操作各阶段墙钟时间;调查 docs 与运行文件的实际读取关系 | 原测量与执行输入可复核;不把总耗时推断为单目录耗时;不触碰正式凭据 |
| B 分发拆分 | 便携与安装仅带必要运行文件、帮助与许可证;完整历史证据单独保存并绑定原 SHA/来源;源码交付继续完整 | 离线安装、启动、REA/浏览器/手机/工程等真实能力通过;所有原证据可核对,删除或修改必要文件仍拒绝 |
| C 更新状态 | 安装器与桌面显示实际阶段、当前核对范围、原始错误与失败收据;分清可取消的准备和不可打断的指针发布 | 用户可判断当前进展;超时/失败有原日志;没有虚构百分比或假完成;390px 与中文长路径可用 |
| D 核对复用 | 调查同一次安装中重复验证的位置,只在输入身份、作用域和有效期明确时复用;路径/文件/清单改变立即失效 | 全字节门槛保持;并发变化、替换、链接和进程变化拒绝;无缓存时完整回退;有原对照测量 |
| E 发行与回顾 | 独立源码、便携、同载荷安装/升级/卸载、原状态保留、实际窗口与 Git 封存 | 所有必要检查通过后上线;报告实际耗时与限制;失败不改写 |
实施入口已经按当前源码核对:`scripts/package.mjs`定义运行与证据分发清单;`src/core/desktop/app-installation.mjs`提供完整性校验的实际计数;`src/core/desktop/install-manager.mjs`记录所属更新操作、阶段和终态;`src/desktop/install-cli.mjs`向所属安装器传递状态;`src/desktop/installer.iss`读取并呈现真实状态。先证明同一操作ID/候选SHA/阶段顺序和终态可靠,再接用户界面,不让计时器或子进程退出码代替实际结果。当前仍仅规划,未修改以上冻结运行入口。
首轮验收集中在四个实际用户问题:旧版预检长时间无反馈、已写入文件却尚未完成激活、失败后不知道保留了哪个版本、取消后不清楚是否已经发布。状态必须区分准备、核对旧版、解压/写入、核对候选、保持宿主、发布指针及完成/失败;可计算范围时显示原文件数/字节数,不跨阶段拼凑总百分比。取消只在已实现可靠撤销的边界开放,发布指针与回退时必须显示正在完成核对,禁止把关闭窗口当作更新已取消。
针对性门槛包括:删除/修改必需文件仍拒绝;帮助/研究报告真实原字节可读;进度所属和序号不串操作;子进程退出、日志中断、候选/原指针并发变化都保留原失败;新安装、原宿主保留更新、冷启动及卸载分别验收;桌面和390px只显示真实阶段、当前版本及下一步。沿用已有输入绑定和原失败保存方法,只有实施变化才重验受影响能力,完整发行仍执行必要门槛。
真实模型自主工程、新 iPhone 浏览观察、Purge 收益和其他引擎适配继续单列,以实际接通和工程交付判定。优化安装不替代这些产品能力,也不以通过本地固定回答验证推断模型效果。
回顾登记的体验细节:代理页面动作已经保存浏览标签、原观察、具体输入及审批身份,审批正文与执行方式显示浏览动作;主窗口标题仍复用「确认这次终端执行」。下一轮按真实工具类别区分标题、范围说明和拒绝反馈,并核对桌面/手机显示。该文案问题不改变本轮的审批绑定与单次派发结果,不改写原记录。
## 冻结期间的只读预研
50bcdbd来源代码显示,`scripts/package.mjs`把整个docs目录复制到便携/安装和源码两个载荷。已拒绝候选A的不可变清单仅作静态盘点:20,376文件/1,904,856,603字节,其中docs为9,589文件/1,256,369,417字节。该清单SHA为`f66b28dee28dcce79243ed21d1c3c20d65b2690a8a9c49a13b6c5c32a73d0711`,不能把它当作候选B已验收或性能优化证明。
当前`src/server/app.mjs`实际通过固定研究目录读取4份报告:`RESEARCH.md`及`research/`下Cursor机制、上下文恢复、工具循环;初始化另读取`examples/starter-project`。这些只证明直接入口,下一步还须核对报告链接、使用指南、REA/浏览运行时、示例构建和许可证的完整引用关系,不能简单删去其它文件。研究页需断言实际报告原字节,防止缺文件时的“报告正在整理”占位也被算成通过。
分发拆分拟先形成明确的运行清单、帮助/报告清单和独立历史证据清单;原证据保留原路径映射、SHA及来源,提供单独归档。源码仍保留完整来源与回归工具。现有安装器遍历清单并逐文件核对的门槛必须覆盖拆分后的全部运行载荷,禁止用减少检测或空占位来换速度。冻结1.22期间只进行了此项只读调查,尚未实施分发或验证复用。
代码回顾还确认`InstallationManager.current()`和`candidate()`都会进入`validateInstalledVersion()`,激活前、发布指针前再次调用,完整清单核对后又读取实际宿主输入身份。它们分别保护不同的时间边界;不能仅因重复就删去。首轮优先B分发拆分与C真实进度,D在测得实际收益并证明并发变化仍可拒绝后再采纳;无法证明时继续完整核对。读取时一次Windows通配路径错误已改为目录配合`-g`,不影响上述代码定位或冻结产品。
## 1.22 候选C验收期间的接续细化(仅计划)
源码读取确认:`src/desktop/installer.iss` 的 `RunManager()` 使用隐藏子进程及同步等待,`src/core/desktop/install-manager.mjs` 的完整文件校验也采用同步逐文件读取。因此进度需要来自实际执行进程,而不能由前端计时器补造。先确定所属安装操作ID/候选SHA/阶段事件及终态收据,再接桌面和安装界面的进度;固定间隔抽样报告已核对文件数、字节数和当前相对路径,未确认总范围时只显示阶段。具体分母随当前真实阶段,不把解压完成显示成更新完成。
拆分前建立明确的运行必需文件及帮助链接闭包,特别保留4份直接研究报告、初始示例、REA/浏览器/桌面运行时、第三方许可证与使用说明。将历史原件另存不可变归档并记录原路径映射/SHA/来源;源码交付仍包含完整来源与验收工具。先实测相同输入下的收益,再决定是否复用校验;任何复用必须证明候选替换、并发写入、链接及原指针变化仍会拒绝。
1.22 的两次候选拒绝说明验收工具也要保留来源:桌面preload入口按版本严格核对;异步工程准备应等待真实操作结束并立即断言终态;生成器应同时检查语法和原收据读写归属。后续继续沿用这些修复,保留原失败,不通过扩大测试期限或沿用局部成功来重新判定失败轮。此处未实施1.23,也未修改冻结中的1.22运行代码。
## 本轮 A–D 实施及门槛(接续397099b)
同一原1.22.1载荷的一次validateInstalledVersion实测176075.2562ms,20962文件/1968554008字节,manifest为be8bf7d15907d9fea79b64ab1bbdc3f2cf29221105f660f934e800393fe5a6c6。这是单次完整核对,不是总安装/激活时间;不能和历史722.096秒直接算收益。原测量位于.qa/release-efficiency-baseline.json。
B已实现运行帮助/四份研究报告与独立完整证据分发,完整源码仍保留全部docs;原件清单绑定冻结commit/原路径/字节/SHA。C已实现所属操作ID、候选原清单、阶段/文件/字节及终态,Inno从原进程stdout读取,桌面/网页从原进度文件读取。未知进程结果明确待核对,不自动续跑;准备取消不发布版本。审批标题与拒绝反馈按原工具类别派生,手机只增加类别,原审批指纹保持。
D审查后保留发布前所有完整复验。当前没有可证明覆盖并发写入的完整性缓存,不引入跳过校验的复用。分发减少后再实测,不能先承诺收益。E尚待最终冻结来源、独立源码/归档/真实安装/用户基础流程及保留状态部署,开发轮通过不替代这些门槛。