wandering1
842d711ed6
用户裁定「我不想看到编号」。测试验证层级这一族的整族清退分三道并行：本笔是**代码与 CI 道** （CI 步骤与门禁输出面），代码注释面另走、文档面由文档道走。 口径（旧 → 语义名 → ASCII 段名，段名只进日志/旗标/job id/文件名）： L0 静态门禁 static ｜ L0a 钩子解释器预检 preflight ｜ L0b 提交信息门禁 commitmsg L0c 体积门禁 size ｜ L0.5 主机侧纯逻辑单测 host-unit ｜ L0.5c 覆盖率 coverage - scripts/ci_local.py 43 站点：段标题与 [SUMMARY] 标签改 ASCII 段名（static: / host-unit:），函数 run_l0/run_l05 → run_static_gates/run_host_unit_tests， 收尾「已跑：」列表用段名。旗标改 --static-only / --host-unit-only，**旧旗标 --l0-only / --l05-only 保留为 argparse 别名**（肌肉记忆与既有脚本片段不断档， 实测 --help 两名列出）。 - .gitea/workflows/ci.yml 42 站点：job id l0-gates → static-gates、 l05-host-unit-tests → host-unit-tests；步骤名与 step-summary 标题改语义名； 日志名 l0-pre-commit.log → static-pre-commit.log、l05-<模块>.log → host-unit-<模块>.log；::error::/::notice:: 文案同步。yaml.safe_load 核过 两个 job id 与步骤名。 host-unit-tests；步骤名与 step-summary 标题改语义名；日志名 l0-pre-commit.log → static-pre-commit.log、l05-<模块>.log → host-unit-<模块>.log；::error::/::notice:: 文案同步。yaml.safe_load 核过两个 job id 与步骤名。 - 门禁脚本 18 站点：check_registration（登记簿理由串 7）、check_test_coverage 5、 README 8、check_generated_fresh 2、ram_baseline 2、check_size_gate 1、 ci_find_python.ps1 2、ci_runner_bootstrap.ps1 2、.pre-commit-config.yaml 2、 requirements.txt 1（保持纯 ASCII）。 - skills 7 站点：task-worktree（含 [SUMMARY] 样例两行）、mem-budget、ui-verify、 task_worktree.py 的实跑标签。 - AGENTS.md 3 站点：CI 段「只跑静态门禁 + 主机侧纯逻辑单测」、自查命令段、 「2026-10-11 静态门禁全灭」事件名。 - 归档：编号治理历史.md 新增 §10 换算表 + **撞族警示**（同形 L0/L1/L2/L3 还属 UI 设计 令牌层 / UI 菜单层级 / 采集链 / 链路时延段 / CubeMX 三层 / 硬件位号与 FTP 应答字面量 等六个族，其中 6 处在字符串字面量里，改了就是改行为——故全程只按行内置换、先判族）。 - docs/产品需求 §7.4 测试分层表：去号 + 顺带修掉上一批**错族替换疤**（该表 L1/L2 行曾被 采集链层名「语义取数与有效性 / 全周傅氏相量」「保护判据」顶替，现按内容改写为板端测试 套件 / 主机侧回归两行）。同文档 §1.5 G5 判据行同步。 门禁：ci_local --help 两面旗标并列；py_compile 7 个 .py 全过；yaml 解析通过； check_ids_new --worktree rc=0；git diff --check 干净；17 个改动文件 FFFD=0、无 CR、 BOM 与原文件一致（含 requirements.txt 纯 ASCII）。本族无机器识别面（单字母+数字是 新增行门禁的自述盲区），口径来自自建逐行扫描器，复扫本族形态归零。 - 交接说明：文档道 teammate 在改 CI 指南时中断，剩余 9 处双写疤与 29 处 CI 标识 （job id / 日志名 / 汇总行字面量）由 Lead 接手改完，逐处仍走断言式行内置换。
8.2 KiB
8.2 KiB
远程 CI（Gitea Actions）—— 本目录是唯一入口
适用范围（先读这句，可以省下很多时间） 本仓库的远程 CI 只跑在本机这一台 runner 上：runner 名
win-stm32-ci，装在D:\Docker\act_runner，连的是本机原生 Giteahttp://127.0.0.1:3001。 其他机器、其他项目都不涉及，也不需要配这套东西。日常改代码不需要读本目录：提交前的等价自查是本地门禁，runner 在不在线都照样跑——
& '.venv\Scripts\python.exe' scripts/ci_local.py # 静态门禁 + 提交信息门禁 + 主机侧纯逻辑单测只有在这三种情况下才需要进来：① 换机/重装后要重新部署 runner；② CI 不出任务或莫名 取消；③ 改
.gitea/workflows/ci.yml本身。
索引
全部内容是一篇文档：远程CI完整指南.md（2026-10-12 由原「环境与部署」
目录下的两篇指南 CI配置指南.md 与 Gitea_Runner部署指南.md 合并而来，两篇均已删除，
去重后为单一来源）。
| 想干什么 | 去看 |
|---|---|
| 先搞清 CI 需要哪三样东西就位、本机拓扑、部署前置清单 | §0 / §0.1 / §0.2 |
| CI 体积门禁现在怎么守（同码凭证强制，「只声明不执行」那处盲区已关闭；gitlint 空转仍在） | §0.0 + §7 排障表"钩子条数对不上"行 |
服务端开启 Actions、DEFAULT_ACTIONS_URL 到底管什么 |
§1（含 §1.2.1，这条最容易搞反） |
下载 / 注册 runner（--instance 用回环、labels 必须精确匹配 runs-on） |
§2.2 |
config.yaml 各字段语义（capacity / timeout / labels / 日志目录…） |
§2.3 |
| 常驻：为什么必须看门狗、不能只起 daemon、也不能做成 Windows 服务 | §2.4 + §3.0 |
runner 装什么软件、为什么变量必须对 SYSTEM 可见、机器级 DTU_* |
§4（§4.1.1~§4.1.3 是三个真坑） |
workflow 位置 / 触发 / 内网拉不到 actions/checkout 的三种处置 |
§5（§5.3 零依赖写法） |
| 两个 job 各自跑哪些步骤、两条 Python 探测链要同序同步 | §5.5 |
| 端到端验证清单、无网页登录时直查 MySQL 核验 | §6 / §6.1 |
出问题了按症状查表（含 0x41301、1053、72h 被杀、.ps1 无 BOM 乱码…） |
§7 |
| 日常维护（改钩子集 / 改 workflow 后要不要动 runner） | §8 |
| 一键自检脚本、最小操作清单 TL;DR | §9 / §10 |
常用命令速查
# 本地等价门禁（不依赖 runner，日常用这个）
& '.venv\Scripts\python.exe' scripts/ci_local.py
# runner 体检（四项：计划任务 / 进程 / Gitea 可达 / 机器级变量）—— 须管理员
& '.\scripts\ci_runner_bootstrap.ps1' -Status
# 干跑：只打印将要写入的启动器与任务对象，不落盘不注册（免管理员）
& '.\scripts\ci_runner_bootstrap.ps1' -DryRun
# 部署 / 修复：写机器级 DTU_* + 生成看门狗启动器 + 注册开机计划任务 + 立即启动（须管理员）
& '.\scripts\ci_runner_bootstrap.ps1' -SetEnv -StartNow
⚠️ 上面三条
ci_runner_bootstrap.ps1是本机运维动作，会改系统计划任务与机器级环境 变量；返回码0x41301是"任务正在运行"、next run为空是开机触发器的正常表现， 都不是故障（详见指南 §3.4）。
✅ 机器侧遗留已清理（2026-10-12）：旧方案的
deploy_runner_task.ps1与run_runner.cmd已从D:\Docker\act_runner\删除（它们跑单次 daemon，首次 Declare 失败就永久停摆， 机理见指南 §3.2；check_env.ps1里指向它们的提示也已改指 bootstrap）。 现行部署只有ci_runner_bootstrap.ps1这一条路。
🔴 重跑部署前先知道这条（2026-10-12 实测）：
Unregister-ScheduledTask不会带走旧实例 启动的进程。旧看门狗会作为孤儿继续养着它的 daemon，而那个 daemon 占着.runner.lock， 于是新看门狗每 10 秒失败一次（runner file is already locked by another process）—— 而 runner 在网页上照样显示 online，CI 看着正常，任务其实谁也没管。 现在-StartNow会先清掉这些残留进程再启动（约离线几秒），-Status也会报出重复实例。 2026-10-12 已实测收敛：清掉 3 个残留后daemon up: pid … (single instance)， 监管链svchost(任务) → 看门狗 → daemon恢复，runner 回 online。
相关文档
- 测试分层与门禁决策（静态门禁~人工目检各层由谁把关）：
../测试说明/测试开发标准流程.md - workflow 本体：
../../.gitea/workflows/ci.yml - 本地等价脚本：
../../scripts/ci_local.py - runner 机器的工具链环境要求：
../环境与部署/项目部署环境要求.md DTU_*工具路径变量机制：../环境与部署/本地工具路径环境变量方案.md
变更记录
| 日期 | 变更 |
|---|---|
| 2026-10-12 | 🐛 首次真跑出 run：主机侧纯逻辑单测 成功（10 runner(s), 647/647, fail=0，与本地逐字一致）；静态门禁 假失败——gitlint 因 runner 无 git 身份而 exit 254（Missing git configuration: please set user.name），旧文案把它说成"提交信息违规"，且该步 exit 1 连带让 26 个钩子全部没跑。已在 ci_gitlint_range.ps1 用 GIT_CONFIG_* 注入一次性身份（不写文件）并区分 254/1 退出码。另记：新建分支的首次 push 不触发 run，需 workflow_dispatch 或再推一个非文档提交。详见指南 §7 |
| 2026-10-12 | 🔀 本轮 CI 修复随 master 合入 v2-on-ui（该分支另有 21 个功能提交；冲突仅 AGENTS.md 与 docs/README.md 两处，解法是"保留其新版结构 + 把 CI 指针搬进对应位置"）。因该分支门禁更多（26 钩子 / 10 单测套件 vs master 的 18 / 3），指南里写死的数字已改为规则 + 分分支快照，见指南 §6 / §7 / §10 |
| 2026-10-12 | ✅ 双看门狗缺陷实测收敛（管理员 -StartNow 清掉 3 个残留 → 单实例、链路恢复、runner online）。另修两处：daemon 日志走 stderr 被 PS 5.1 2>&1 包成 ErrorRecord（2 行真日志写成 8 行，每 4 行 3 行噪声）→ 启动器改 ForEach-Object { "$_" }；-Status 诚实化（非管理员读不到 SYSTEM 进程命令行 → 明说需提权而非谎报"无看门狗"；重启循环判据改看进程存活时长，不再靠不轮转日志的尾部字符串报假警）。详见指南 §7.3 |
| 2026-10-12 | 🔴 修复"双看门狗抢 .runner.lock"缺陷：Unregister-ScheduledTask 不停旧实例进程 → 孤儿看门狗养着旧 daemon 占锁，新看门狗每 10 秒失败一次，而 runner 网页照样 online、-Status 也说"在跑"。现 -StartNow 先清残留进程再启动、-Status 报重复实例与锁冲突。同日清理机器侧：config.yaml 头部错误指引（"改用 sc.exe / New-Service"）改为看门狗口径，删除已废弃的 deploy_runner_task.ps1 与 run_runner.cmd，check_env.ps1 提示同步改指 bootstrap |
| 2026-10-12 | 单一口径清理：合并稿初版对 4 处分歧"两说并存"，现统一为本机实测现状——注册口径（gitea-runner v4.0.1 / D:\Docker\act_runner / 127.0.0.1:3001，旧 act_runner v0.2.11 + C:\act_runner 段删去可复制命令只留警示）、config.yaml（fetch_timeout: 1m0s、timeout: 30m0s）、常驻方式（只认看门狗，deploy_runner_task.ps1 标废弃）、验收数字（主机侧纯逻辑单测 288/288，历史数字标注为快照）。并补"机器侧遗留脚本勿误用"警示 |
| 2026-10-12 | 新建本目录：远程 CI 内容原先散在 docs/环境与部署/（两篇互相重叠的指南）、docs/测试说明/测试开发标准流程.md §9、AGENTS.md 提交门禁节共 4 处，约 2000 行；现合并为单一指南并把 AGENTS.md 压成一行指针。动因：远程 CI 只涉及本机一台 runner，与日常开发规范混在一起每次会话都被读，造成困惑 |