Files
Agent-Workbench/docs/CI.md
T
2026-11-07 22:50:39 +08:00

4.8 KiB
Raw Blame History

可重复的源码与官方契约 CI

当前入口从已提交 Git HEAD 导出新的源码 ZIP,逐源文件核 SHA,展开到唯一目录后实际 npm ci。不复用工作区 node_modules 或 junction,不读取用户项目、运行服务、模型 Key/配置或旧实验。可审查源码改动应先提交;文档/其他非编译改动会在报告记录,不参与程序构建。

环境固定于 scripts/ci-environment.json:Node 24.22.1、随包 npm 11.19.1;Windows 全套另需 Python 3.11.15。pytest 8.4.2、pip 与全部框架依赖通过 scripts/ci-python-requirements.txt 精确 wheel SHA 安装到本次新 venv。Playwright 1.64.1、Electron 45.2.0 和其余 npm 输入由 lock 固定。缺环境、版本不同、依赖安装或实际测试失败均非零退出。

& 'D:/Ai-project/REA逆向/tools/node-v24.22.1-win-x64/node.exe' scripts/ci.mjs --profile contract
& 'D:/Ai-project/REA逆向/tools/node-v24.22.1-win-x64/node.exe' scripts/ci.mjs --profile windows --python '绝对路径/python.exe'

其他开发机使用自身已核对的相同版本 Node 路径。npm 入口为 npm run ci:contract / npm run ci:windows -- --python ...。默认输出 .qa/ci/run-.../evidence/report.json,可用 --output-root 指定;每次新建目录,旧失败/日志不覆盖。数据/依赖/缓存位于同 run 的独立目录,不作为发布源码或 CI 证据上传。

默认 Electron 从官方 GitHub 发行地址下载。环境访问异常时可显式加 --electron-mirror https://npmmirror.com/mirrors/electron/,报告记录该公共镜像和官方锁定 electron/checksums.json 的 SHA;不继承电脑的镜像/代理/凭据配置,也不关闭校验。原官方失败仍单独保留。Python 命令明确 UTF-8,中文路径的原日志可直接核对。

范围 实际执行与判定
contract 四来源清单原字节、注册表及请求默认版本/字段/弃用快照、14指定行为回归和 CI/源码包专项;完整应用构建。可在支持 Node 的平台执行,当前其他平台实测状态另列。
windows 上述来源/构建与全部 .test.mjs,实际产品 Edge 必需;固定 Playwright 使用实际 Edge 及隐藏 Electron 执行 1280/390 冒烟。安装/回退相关回归使用自有隔离 fixture,不接触正式服务。

Node TAP 的失败、取消、跳过、todo、缺完整统计或零测试均不能判定通过,不能通过删 Python/浏览器测试掩盖环境缺项。每条命令保存所属 PID、完整 argv、真实 exit/signal、原 stdout/stderr 字节及 SHA;源码和全部编译工件在结束后再次核对。网页/Electron 原截图、DOM、错误与所属关闭状态另存。

三个历史回归套件使用 最小回放夹具,不在独立源码包中寻找包外历史档案。CI 导出后先逐 SHA 核其 65 份输入,原来源和解析字段均在 INDEX 中记录;JSON子树与60份公开锁定Purge源码分别标明,原完整档案仍单独保留。缺失或变化直接失败,原失败/请求/回执的断言不删除,也不将回放当真实模型或收益验收。

GitAtlas 工作流为 .gitea/workflows/ci.yml,push / pull_request / 手工触发。Gitea 1.26.2 与仓库 Actions 已公开核实;运行/runner API 匿名 401,可用执行器及远端运行尚未确认。工作流要求独立 Windows x64 runner 标签 awb-windows-x64:host、PowerShell、Git、Edge及 action 所需 Node 16/20 执行能力,随后 action 安装固定 Node/Python。不会在正式电脑自动安装持久 runner。Action 均固定完整 commit,Checkout 同 commit 使用 Gitea 官方镜像;原 GitHub 网络失败完整保留。证据上传使用 Gitea actions v3 固定契约,明确包含 .qa 的隐藏证据路径,仅上传 evidence 白名单;实际上传与远端执行需要真实 job 回执。

官方更新先保留原响应/失败/SHA,修改注册表和对应行为回归,再生成新快照、审查差异并追加 tests/fixtures/official-contracts/INDEX.json 的 history;旧快照保留。--freeze 只冻结,不能当作通过。命令:

node scripts/verify-official-contracts.mjs --freeze NEW_SNAPSHOT.json
node scripts/verify-official-contracts.mjs --diff OLD_SNAPSHOT.json NEW_SNAPSHOT.json --output NEW_DIFF.json
node scripts/verify-official-contracts.mjs --output NEW_VERIFICATION.json

同型号的协议/API版本分别成键,字段来源、缓存/状态、弃用/别名、认证及新旧默认的差异会出现在报告;实际事实或请求默认变更不增加相应版本会失败。所有检查离线使用已固定官方原件,本机 HTTP/源码结果不等同真实官方/代理兼容、模型自主工程、缓存或 Purge 收益。M3 实际 schema2 迁移增量和新处理器产出后的回退仍另验,正式发行尚未发生。