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

34 lines
4.4 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.
# 可重复的源码与官方契约 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 固定。缺环境、版本不同、依赖安装或实际测试失败均非零退出。
```powershell
& '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、错误与所属关闭状态另存。
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` 只冻结,不能当作通过。命令:
```text
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 迁移增量和新处理器产出后的回退仍另验,正式发行尚未发生。