Files
Agent-Workbench/docs/ENVIRONMENT-PREPARATION.md

3.3 KiB

工程环境与依赖准备

在任务记录中打开「工程环境与依赖」,先诊断,再创建并核对准备计划。诊断不会安装软件、运行项目脚本或导入pytest。Node/npm来自工作台实际宿主;Python沿用已有解释器识别和审批后检查机制。实际二进制、声明、锁文件和依赖文件的SHA-256保存在原工件中。

npm准备流程

  1. 在任务记录创建并打开工作台管理的独立Git工作区。来源只取已提交版本,原项目已有修改保留。
  2. 诊断声明与现有依赖。首版准备器支持npm package-lock v2/v3、固定HTTPS包下载及sha512校验;生产只接受无凭据的HTTPS注册源。pnpm/yarn/bun、workspace/file/git依赖、shrinkwrap、项目或父目录.npmrc、没有完整锁文件的工程需要先人工处理。
  3. 核对实际Node/npm、固定npm ci参数、工作区、下载注册源与300秒时限。默认跳过生命周期脚本;允许脚本需要明确选择并审批。根工程脚本会显示;锁文件标记的依赖脚本仅能在下载后取得正文,允许脚本代表允许这些安装脚本以本机账户执行。
  4. 审批后执行一次。配置和下载缓存位于工作台数据目录,使用独立空user/global配置;不继承未知宿主环境变量,不切换下载源或自动重放失败。离线模式只使用该工作区的缓存,缓存缺失保留真实错误。
  5. 查看退出码、原日志和实际依赖身份,再识别、确认并执行工程检查。安装成功不表示测试、类型检查或构建通过。

锁文件、声明、运行时、工作区、源码或原依赖变化后,旧准备计划失效。停止保留部分依赖和日志;再次尝试需要新计划。宿主中断记为unknown,原结果保持,先通过「核对中断现场」只读核对原进程和当前环境;仍有所属进程或无法核对时继续阻塞,不按历史PID杀进程。

检查和评测证据

新npm检查封存实际依赖文件快照,执行前后核对环境,交付前再次验证。空的构建缓存目录不影响文件身份;所有目录仍检查链接、替换、层数和条目上限,新增缓存文件或依赖内容变化会使旧结果失效。已准备环境引用原计划、审批、日志和结果工件;已有环境明确没有所属安装凭据。依赖字节变化不能继续复用原通过结果。

固定评测可分别打开原版和候选任务准备环境。两侧声明与Node/npm输入一致,开始候选前对照原版检查的实际依赖字节;报告缺少相同输入或原工件时保留不可比较原因和全部失败,不把模型回答算工程成功。历史记录不补造新环境证据。

Python本阶段提供解释器/pytest元数据与声明诊断,继续使用已有unittest/pytest结构化检查,不自动pip安装。未执行项目解释器时不声称已核对其版本。Node依赖快照上限为40,000项、512MiB、100层;超过上限或含外部链接明确显示无法完整核验。直接依赖存在和版本诊断不替代实际模块加载及项目检查。npm缓存是派生下载材料,所有安装仍需锁文件完整性核验。

这些操作以本机账户执行,不是操作系统沙箱。移动伴随端仍沿用原任务审批范围;通用内置浏览器属于1.22计划。