Files
Agent-Workbench/docs/PLAN-1.21.md
T

5.4 KiB

1.21 后续方案:工程依赖与可复现环境

本阶段A–F已完成本地交付,实际范围及来源见1.21验收。正式服务已保留原PID/Provider升级至1.21.0,原记录和失败保持。真实模型工程与Purge收益继续按原选择单独验收。

前置修复已完成:react-source真实案例按1.20.1验收完成系统修复及保留状态本地升级,原案例事实和失败历史保持;1.20.2/1.20.3也已交付。安装性能与界面可读性作为独立待办;每切片独立验收、回顾和本地Git。真实模型工程复验单列,不续跑原无需测试任务或改写其历史消费。

历史审查见完整报告和证据摘要。报告A–F修复已作为本阶段前置完成;本轮继续保留这些行为,并增加工程环境诊断和所属依赖准备。

要解决的具体缺口

目前Node/React/Python工程已有真实检查、隔离候选、原版对照和父交付,但React等工程仍需QA或用户显式准备依赖。一个刚克隆的项目若缺少依赖,模型容易把环境失败误当代码失败,也无法证明更改在相同环境中通过。下一阶段优先将环境核对与依赖准备变成可审查、可停止、可复现的所属工程操作。

实施切片与验收

2026-11-01开始实施(分支feat/reproducible-env-1.21)。具体契约:沿用现有managed-worktree,不在父工程自动安装;首版支持npm package-lock v2/v3,固定Node/npm、独立配置/缓存和显式注册源,默认跳过生命周期脚本,可单独确认允许。Python先提供不执行项目代码的解释器/pytest与声明诊断,继续沿用已有Python检查器,不自动pip安装。准备计划、用户审批、所属进程、原日志与依赖字节身份独立持久化;中断置unknown并要求核对,原计划不重放。工程检查绑定实际依赖快照,原版/候选对照绑定相同声明和运行时输入,准备成功不能代替工程通过。

切片 实现 完成门槛
A 只读环境诊断 识别实际Node/npm或Python/pytest、声明/lockfile、依赖缺失与现有环境来源 缺失/不支持明确分类,诊断不安装或改配置;路径与真实二进制SHA绑定
B 固定依赖准备计划 在所属隔离工作区创建不可变计划,展示实际命令、来源仓库、锁文件、目标和可能生命周期脚本 不执行任意模型拼接命令;锁文件/解释器/目录变化失效;不默认修改全局环境
C 审批与所属执行 复用现有审批/命令账本/预算/停止,保存网络失败、退出码和原日志 超时与停止只结束所属进程树;未知结果不自动重试;不把安装成功当工程通过
D 检查与评测衔接 原版/候选绑定同一依赖输入和实际准备记录,后续测试/构建报告引用环境身份 无依赖的工程、已有依赖的工程和依赖变化各有真实结果,失败分母保持
E 中文桌面/窄屏流程 环境诊断 → 核对准备计划 → 审批 → 原日志 → 实际检查 保存/刷新/停止/具体错误恢复能走通,关键依赖状态和人工操作可见
F 独立发行与回顾 全历史门槛、固定Node/React/Python、断网/损坏/变化/重启、独立源码/便携/安装与保留状态升级 原用户数据/连接/工件保持,原失败封存,本地Git、明确限制和下一计划

保持的边界

优先npm固定lockfile和已有受支持Python检查,不同时加入所有包管理器。依赖生命周期脚本按实际风险和来源展示、按既有权限审批,不能把模型选择等同授权。下载与本地缓存分开记账;缓存只作派生材料,不保存密钥。网络或可信源缺失时保留明确失败,不静默切换注册源或降低校验。

后续真实多模型复核、其它引擎、语音和更大工程范围,仍按实际问题、契约与可复现实测分别排期;不因一项接入成功宣称全部能力完成。

1.20发行回顾还记录正式stage总计约870.6秒及安装进度不够可见。作为后续独立维护项,先分段测量安装预检、载荷读取、完整性和数据快照,再安排进度显示与最小运行载荷/历史证据分发分离;不跳过原字节检查、不覆盖原证据,也不将此问题宣称已在1.21实现。

正式指针激活另耗时约726.6秒并通过原门槛;后续性能验收须分别记录stage、升级、activate及最后验证,避免用一个总时长推断瓶颈。

1.20.1修复收尾新增测量:本次正式stage含外层独立复核953.437秒;新运行载荷清单18,922份、1,719,235,877字节,其中docs历史文档/证据8,135份、1,071,109,469字节。原1.20清单17,737份、1,557,296,581字节,docs为909,229,145字节。后续维护优先评估最小运行包与完整研究/验收证据独立分发,并保持来源身份、全部必要资源、迁移/回退、数据与工件完整性核对。清单体积不能直接等同逐目录耗时归因;尚未实施拆包、缓存或进度改动,不计入本轮系统修复结果。

本轮其余分段:升级前核对及单次保留状态切换168.666秒、activate798.480秒、最后独立verify170.688秒。各阶段完整收据保留;这些是阶段墙钟时间,不能冒充处理器切换本身的耗时或模型推理测量。