wandering1/STM32F4-Base
1
0
Fork 0
Code Issues 29 Pull Requests 1 Actions Packages Projects 2 Releases Wiki Activity
761 Commits 4 Branches 0 Tags
842d711ed611f064fb0b8b64e8c0024aac10b04e
Commit Graph

12 Commits

Author SHA1 Message Date
wandering1 842d711ed6 refactor(编号): 测试验证层级去号——CI job / 门禁输出 / 命令行旗标换语义名 + ASCII 段名 
用户裁定「我不想看到编号」。测试验证层级这一族的整族清退分三道并行：本笔是**代码与 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 接手改完，逐处仍走断言式行内置换。
 2026-10-28 17:46:52 +08:00
wandering1 599f05be22 refactor(编号): 测试验证层级 L0/L0.5/L1/L2/L3 → 语义名（批次 3d·文档层） 
这族是验证层级：静态门禁 / 主机侧纯逻辑单测 / 板端测试套件 / 主机侧回归 / 人工目检。
实测它出现在 **97 个文件**（40+ 个 test/host 的 run_unit_test.py、.gitea workflow、
ci_local.py 的阶段标签、以及十来篇文档）。本批只做**文档层**，代码层单列一批（见下）。

改动：10 篇文档 110 行 + 三处收尾——
  测试开发标准流程 / 实机测试实施指南 / 主机单测覆盖率口径 / 门禁说明 README 与
  host-unit-tests / CI README 与远程CI完整指南 / docs README / 测试与架构专项 /
  pre-commit 使用说明。
映射：L0 → 静态门禁、L0.5 → 主机侧纯逻辑单测、L1 → 板端测试套件、L2 → 主机侧回归、
L3 → 人工目检；`L0b`（ci_local 的内部阶段标签）在文档里写成「提交信息门禁」。
测试层级那张表的「层级」列被删掉（名称列已承载同一信息，留着就是两列重复）。

**未做（代码层，单列批次 3d-2）**：`scripts/ci_local.py` 的阶段标签、`.gitea` workflow、
`test/host/*/run_unit_test.py` 的输出前缀、以及代码头注释里的 L0/L0.5 —— 那些是**程序标识**，
改名要连带 CI 日志格式与文档里对 `[SUMMARY] L0: ...` 的引用，属跨端改动，需单独验证。

验证：三篇主文档的层号残留 = 0；doc-links 通过；mojibake / git diff --check 干净；
表格列数已收敛为 3 列（名称 / 载体 / 抓住什么）。
 2026-10-28 13:20:28 +08:00
wandering1 0f7b5a87fb chore(编号): 存量编号全量转语义短语，门禁识别面与语料同批重打 
登记簿、文档与代码注释里的存量字母加数字编号（N-x / S-x / T-x / E-x / A-x / 卡号）
一律改写为语义短语，净删 2,028 处引用；删除基线与待确认、并行分道方案、排期详述、
采集保护收尾 4 篇（内容已并入 docs/任务规划/README 与登记簿）。

门禁机器与三张账同批重打：check_ids.py 新增变更记录行豁免与第二根护栏
undecidable_total_ceiling；check_test_traceability.py 只加 stdout/stderr UTF-8
reconfigure（TC_RE 未动）；check_cubemx_survival.py 的 --write 固定 newline=LF；
id_registry / id_aliases（+19 条 retired-to-phrase）/ id_known_backlog 重打。

test/ 56 个文件同步 TC 标签语义化，其中 18 个 TU 改了 CHECK / printf 里的标签文字，
是本批唯一改变构建产物的文件集合。

为什么合成一笔、不拆四笔（实测撞闸，非偏好）：pre-commit 跑钩子前会 stash 未 staged
部分，拆开后中间提交必然是「新规则 + 旧语料」——实跑可判定 85.15% < 基线 86.00%、
不可判定 1,453 > 上限 1,166，编号门禁直接拦下。编号识别面与它描述的语料只能同码移动。

实跑基线（工作区全量）：754 文件 / 8,230 处编号字面量 / 可判定 7,079 = 86.01%
（基线 86.0%，容差 0.1pp）/ 不可判定绝对数 1,151（上限 1,166）/ 校验 1-6 错误级 0 /
告警 = 悬空 2（App/algo/freq.c 的 S2，属 §4.4 同号不同义）+ 孤儿 50。

基线从 84.0 抬到 86.0 的理由见 docs/门禁说明/id-check.md §7.6：本批真删了 2,028 处
引用，可判定面随真实内容上升，不是把分母做小。同批新增排除 docs/硬件平台/ 语料，使
识别面少 264 处——芯片手册位号与网表料号不属编号空间（registry 有 excluded_paths_note）。

⚠ 余量只剩 0.11pp（约 10 处）与绝对数 15 处：把「可判定的引用」改成散文会立刻撞第二
根护栏。另遗留一项：id_aliases 里 retired 的 N / S / T / A 别名没有 scope（U1~U5 有），
今后有人新写一个 A-4，校验 3 不会响，只能靠人，建议下批补 scope。

固件不变证据：115 个 .c/.h 剥注释并归一字符串后与 HEAD 逐字节全等，残留代码差异 0；
App / Src / Drivers 的字符串字面量零改动。@build 0 错误 0 警告；40/40 主机套件、2,889
断言全通过；覆盖率 line 89.2% / func 92.6%；pre-commit 48 钩子 --all-files 全绿；
check_doc_links --all 通过（176 文档，章节引用无法判定 0）；逐字节卫生核过：14 个带
BOM 文件与 HEAD 一致、0 个 CR、0 个 U+FFFD，字符串字面量纯 ASCII。

.cubemx_survival_baseline.json 的 watchdog-module 哈希 56bf27 变 2bb051 属合法：
Src/freertos.c 的 USER CODE 区内只有注释文字随编号改写，代码未变。

同批带上体积同码凭证与 RAM 台账行（@build 之后盖戳）：RW_IRAM1 79,008 B / 60.3%，
RW_CCM 57,376 B / 87.9%，阈值 92%。
 2026-10-26 12:28:14 +08:00
wandering1 13ef0715bb docs(销项): 批 1 登记簿收口 + A-5 口径联动到三处门禁文档 
销项（登记簿删行 + 结论沉淀指针）：
- 数据可信.md：卡 1~7 行删除，表下补销项记录（merge 231dc81/d39e5c9/
  59da40b）；§2.1 口径冲突注改 ✅ 已定死；§6 顺序图与失效预警改写为
  "批1 已销项 + 批2 在途"现状；卡 0/0b/12 与 M4①⑤台架面保留待跑
- 测试与架构专项.md：未闭环一览删 S12 / A-5 两行；§1 标题 1 项→0 项，
  P1-10 剩余两条改已销项记录（5 档构建 + f3 PASS，数字正文在
  test/board/ch395f_test.h）；§2.1 S12、§2.3 A-5 标题 ⬜→✅ 带落点
- README.md：一览删 P1 收步行；网络/结构/UI 行加 🟦批2 在途标记；
  测试基础设施 5→3；数据可信行改"在途 7 卡"；验证常态两处删
  P1-10/S12/A-5
口径联动（A-5 已落地，文档追平）：
- CI 远程CI完整指南.md §0.0 整节重写（盲区→同码凭证强制 + 三项仍
  守不住 + 变更记录行）；CI README 索引行同步
- 门禁说明/mem-numbers.md §1/§6、mem-budget.md §6 第 4 条：远端缺口
  已由 check_size_gate.py 关闭，唯一正文 = 其 docstring
 2026-10-25 08:36:44 +08:00
wandering1 7048e9cb9a docs(任务规划): 瘦身为只留待办，波次条目改用语义名 
任务规划目录只保留将来要做的事：删掉已完成的证据链与已作废的历史快照，
并把波内条目的 C/D 短码全部换成语义名。

为什么删 C/D 短码：它们同字母不同义——C 组在 UI_界面制作流程.md 里是
UI 设计约束（屏幕/字符集/文本/编码），D 组在控制台单写者日志设计说明.md
与配置文件设计说明.md 里是决策记录。同一串短码在三处指三件事，读的人
只能猜，所以条目一律改用一行短语作标识。

- 排期详述.md 重写为「结构债与验证常态」，条目全语义名，出处列留冻结号
- README.md 删修订记录块（本文件自述不留变更记录），波次行改语义描述
- W1-采集保护收尾.md 67→30 行，只留 M3 送检与 B10 卡
- 基线与待确认.md 73→15 行，删已作废的旧栈表与旧余量数字
- 登记簿.md 逐行收缩到未闭环残余，N-29 的 .git 订正为实测 233 MB
- 测试与架构专项.md 删 S1-c（106 例已落地，且被覆盖率总闸覆盖）
- 并行分道方案.md 删批 0，修两处会返回 rc=3 的 new 命令形态
- 覆盖率口径：套件 16→33、未挂钩子 12→17、墙钟 25s→67s（实测）
- 同步 10 处跨文档引用，指向合并或删除后的新位置
 2026-10-25 01:35:21 +08:00
wandering1 c077e9a481 merge: 远程 CI 分支 v2-on-ui-ci 合入 v2-on-ui
CI / L0.5 主机侧单测 (MSVC) (push) Has been cancelled
Details
CI / L0 静态门禁 (pre-commit) (push) Has been cancelled
Details 
将 origin/v2-on-ui-ci（13 个提交：远程 CI 文档独立成 docs/CI/、
runner 保活/日志编码/gitlint 空转修复、ci_local L0b 等）合入开发主线。

冲突 5 处，按「两侧意图取并集」解决：
- AGENTS.md / docs/README.md：保留主线 待处理内容.md→任务规划/ 重构，
  并入 CI 分支的 docs/CI/ 索引行与更新日志
- 测试开发标准流程.md §9.1：取 CI 分支，引用改指
  ../CI/远程CI完整指南.md 对应小节
- docs/待处理内容.md：接受主线删除，已重构为 docs/任务规划/
- docs/环境与部署/CI配置指南.md：接受 CI 分支删除，已并入 docs/CI/

合并引入的 doc-links 失效已修（doc-links 合并态走 --sections-strict，
自引用解析失败即硬错误）：
- CI 指南 §0.0 标题把 ⚠️ 移到编号后（编号须打头才解析得出）
- CI 指南对 待处理内容.md 的引用改指 docs/任务规划/登记簿.md T-7 条
- CI 指南并入来源《测试开发标准流程》§9.4 / §9.2 改为全路径限定
- 测试开发标准流程 §9.4：§0.2/§2/§2.4/§4.1.3 原与 CI 文档路径间隔
  超过链式继承上限 40 字符，改为紧跟路径并拆分明细句
- 测试开发标准流程 §9.1：步骤级细节引用同样全路径限定到 CI 指南
 2026-10-12 19:42:24 +08:00
wandering1 ea10dbae53 修 gitlint 门禁在 CI 空转：runner 无 git 身份致 254 被误报成信息违规
CI / L0 静态门禁 (pre-commit) (push) Successful in 3m41s
Details
CI / L0.5 主机侧单测 (MSVC) (push) Successful in 33s
Details 
task 31（首次真跑出的 L0）失败与提交信息无关：actions/checkout 把 HOME
指向每次任务的临时目录，SYSTEM 账号没有全局 git 身份，gitlint 在读到任何
规则之前就以 Missing git configuration: please set user.name 退出——254
是配置错误，不是规则违规。旧脚本还把失败原因写死成"标题超 100 字符"，加
上该步 exit 1，后面 26 个钩子一个都没跑。

改三处：① 先探测身份，缺失则用 GIT_CONFIG_COUNT/KEY/VALUE 注入一次性身
份，只进子进程环境、不写任何文件，开发者机器不受影响；② 254 与真实违规
分开报（2 = 门禁没跑起来，1 = 信息确实违规），不再替 gitlint 猜规则；
③ 钩子输出改走 ForEach-Object { "$_" }，避免 PS 5.1 把原生 stderr 包成
ErrorRecord 污染日志。

实测：空 HOME 下同一条命令改前 254、改后 0 failed；正常环境 10 条提交全
过；脚本纯 ASCII、解析 0 错。同批文档：§7 排障表新增本坑与"新建分支首
次 push 不触发 run"，两份变更记录各加一行。
 2026-10-12 19:17:11 +08:00
wandering1 4bad54b607 merge: master 的远程 CI 修复带入 v2-on-ui（门禁数字改为分支中立） 
把 master 上本轮 10 个 CI 相关提交合入 v2-on-ui，使该分支同样具备可用的
runner 保活与本地门禁自查能力。合并只涉及文档与脚本，零 C 代码改动。

冲突两处，均按"保留 v2-on-ui 新版结构 + 搬入语义"解决：
- AGENTS.md：丢弃 master 侧已被瘦身版取代的旧门禁 bullet，保留其分层边界
  行；把"CI 资料集中在 docs/CI/README.md、只跑本机一台 runner"这条指针
  并入新版 CI bullet 与文末索引表。
- docs/README.md：两侧都是变更记录历史行，按日期先后并列保留。

数字口径改为分支中立：本分支 26 个钩子 / 10 个主机单测套件，master 是
18 / 3，写死任一数字都会让同一篇文档在另一分支上失真。指南 §6 验收第
8 行、§7 排障表、§10 验收标准改为讲规则（报告数 = 定义数 − 1；runner 数
= test/host 下 run_unit_test.py 个数）+ 分分支实测快照。

验证：@build 0 错误 0 警告；ci_local.py 全绿（L0 25 钩子 + L0.5 10 runner
/ 647 断言，fail=0）。首轮 mem-numbers 失败系 master 构建遗留的 .map 所
致，本分支重新构建后即一致。
 2026-10-12 18:28:02 +08:00
wandering1 3557b60ceb CI runner 修日志噪声与 -Status 假警：PS5.1 把原生 stderr 包成 ErrorRecord 
双看门狗缺陷已实测收敛：管理员 -StartNow 清掉 3 个残留（孤儿看门狗 26900/19716 +
占锁 daemon 53848）→ "daemon up: pid 40360 (single instance)"，监管链恢复为
svchost(任务) → 看门狗 → daemon，看门狗日志 25 秒零增长，runner 回 online。
切换瞬间新看门狗先失败 1~2 次（旧 daemon 刚死、锁未释放）后自愈，属预期。

顺带查出并修掉两个由验证动作暴露的问题：

1) 日志噪声：daemon 把日志写到 stderr，PS 5.1 的 2>&1 会把每行原生 stderr 包成
   ErrorRecord，Out-File 渲染出 "gitea-runner.exe : " 前缀 + 4 行 CategoryInfo 块。
   实测对比（用无效子命令产生真实 stderr）：& exe 2>&1 | Out-File 把 2 行真日志写成
   8 行——每 4 行有 3 行是 PowerShell 噪声，而且就在文档让大家第一个打开的文件里。
   改为 2>&1 | ForEach-Object { "$_" } | Out-File -Encoding utf8：实测与 cmd 包装等价
   但不用操心 cmd 对含空格路径的引号剥离，ErrorRecord.ToString() 即原始行，
   $LASTEXITCODE 不受影响（看门狗靠它打印退出码）。§7.2 方式 B 的示例原本正是
   "> log 2>&1"（UTF-16LE + ErrorRecord 双坑），已改；新增 §7.3 汇总这两条陷阱。

2) -Status 两处不诚实：① 非管理员读不到 SYSTEM 进程的 CommandLine（返回 null），
   过滤器静默匹配 0 个 → 会谎报"没有看门狗"（今天两次被这个假象误导），改为明说
   "需提权"；② 重启循环判据原本靠"日志尾部 40 行里有没有 lock 字样"，而日志不轮转，
   修好之后旧失败仍留在尾部 → 对健康 runner 报假警。改看 daemon 进程存活时长
   （活过 10 秒重拉间隔就不可能在循环里）；用 CIM CreationDate，因为
   Process.StartTime 对 SYSTEM 进程不可读。

验证：bootstrap parse 0 错 / 纯 ASCII / -Status 与 -DryRun 均正常；
check_doc_links.py --all 125 篇 0 问题；pre-commit run --all-files 17 项全 Passed。

注：磁盘上的 run_runner_watchdog.ps1 仍是旧模板，噪声修复要下次管理员 -StartNow
（或开机自启）时才生效，纯观感问题，不必专门再重启一次 runner。
 2026-10-12 17:59:45 +08:00
wandering1 49f3e2dac5 CI runner 修"双看门狗抢 .runner.lock"：-StartNow 先清残留进程再启动 
实测发现（比文档问题更要紧）：runner 网页 online、-Status 说 daemon 在跑，
但 runner-watchdog.log 每 10 秒刷 "starting daemon → daemon exited, exit code 1"，
daemon 日志写 "another gitea-runner process is already using .runner" /
"runner file is already locked by another process"。

根因：Unregister-ScheduledTask 不会带走旧实例启动的进程。13:22 重跑 bootstrap 时，
12:53 起的旧看门狗成为孤儿并继续养着旧 daemon，旧 daemon 占住 .runner.lock，
新注册任务启动的看门狗永远抢不到锁。online 是旧 daemon 在硬撑——任务实际谁也没管，
日志还在以约 20 MB/天 增长。

- ci_runner_bootstrap.ps1：-StartNow 新增 Stop-StaleRunnerInstances，先停孤儿看门狗
  再停残留 daemon（顺序不能反：只杀 daemon 会被活着的看门狗 10 秒内重拉），启动后
  等 12 秒回显单实例确认；-Status 新增重复实例计数 + daemon 日志锁冲突检测
- 指南 §3.4 补注销不停进程的说明与"纯注释改动不需重启任务"；§7 排障表加
  "online 却每 10 秒重启"一行（含手工应急命令）
- §3.2 / README：deploy_runner_task.ps1 与 run_runner.cmd 状态由"仍在磁盘、建议删除"
  改为"已删除"；README 补重跑部署前的锁冲突警示

机器侧同步（不在版本库）：config.yaml 头部"常驻改用 sc.exe / New-Service"是 §3.0
已证伪的错误指引，改为看门狗口径并指向本文——改后 YAML 可解析且所有配置值逐项与
改前一致（只动注释）；删除两个废弃脚本前核实计划任务动作目标是
run_runner_watchdog.ps1，删除不影响在跑 runner；check_env.ps1 指向废弃脚本的提示
改指 bootstrap（带 BOM 文件，改后 BOM 完好、语法 0 错）。

验证：pre-commit run --all-files 17 项全 Passed；bootstrap parse 0 错、纯 ASCII、
-DryRun 正常。当前 runner 仍 online（旧 daemon 硬撑），彻底归一需管理员跑一次
-StartNow 清残留。
 2026-10-12 17:37:19 +08:00
wandering1 8b35769a5c CI 文档单一口径清理：以本机实测现状为准，旧方案降级为"勿照抄"警示 
合并稿初版对 4 处分歧采取"两说并存 + 衔接注"，长期看是隐患（读者可能照抄失效方案）。
本次先实测取现状，再统一口径：gitea-runner v4.0.1 / D:\Docker\act_runner /
--instance http://127.0.0.1:3001 / labels windows:host / config.yaml 实际值。

- 注册口径：删掉 act_runner v0.2.11 + C:\act_runner + 公网域名的可复制命令块，只留
  "勿照抄"警示——核实 C:\act_runner 至今不存在，且 v0.2.x 与 v4 命令集不兼容，
  照抄会装出连不上 Gitea 的 runner
- config.yaml：示例 fetch_timeout 由 5m0s 改为磁盘实际值 1m0s（超 RPC timeout 1m 会被
  截断并刷告警）、timeout 统一 30m0s，两处示例块对齐真实文件
- 常驻口径：§3.2 deploy_runner_task.ps1 标为已废弃并写清失效机理（单次 daemon 是
  "正常退出"，计划任务失败重启永不触发）；§3.3 手动等价命令重写为看门狗版任务对象
  （旧版会教人手搓出坏配置）；§10 TL;DR 第 4 步改指 ci_runner_bootstrap.ps1
- 数字口径：L0.5 期望值更新为 288/288（2026-10-12 实测），run#8 的 39/39 与 278/278
  标注为历史快照——判定只看 fail=0 与 A==B，不拿历史数字当基准

顺带同步到现状：健康三查与排障表改用现行日志名（runner-daemon.log /
runner-watchdog.log；runner-stdout.log 标为遗留并说明其 ASCII+UTF-16LE 混编码）；
BOM 示例对象换成 check_env.ps1 并注明看门狗是纯 ASCII 无需 BOM；配套脚本表补
run_runner_watchdog.ps1，并警示磁盘上仍存的 deploy_runner_task.ps1 / run_runner.cmd
误执行会把看门狗任务覆盖回单次任务；补"Next Run Time 为空属开机触发器正常表现"。

保留不动：机器级 DTU_* 为正式通道、全局 site-packages 为兜底——这是设计的降级链，
不是文档分歧。

验证：check_doc_links.py --all 125 篇 0 问题；pre-commit run --all-files 17 项全 Passed。
 2026-10-12 17:06:29 +08:00
wandering1 ba40cc0d20 远程 CI 文档独立成 docs/CI/：两篇重叠指南合并为一篇，AGENTS.md 压成一行指针 
动因：远程 CI 只跑在本机一台 runner（win-stm32-ci）上，其他机器与项目都不涉及，
但内容散在 4 处约 2000 行——两篇高度重叠的指南躺在「环境与部署」里与换机核对清单
并列，AGENTS.md 提交门禁节还塞了 4 条 runner 运维经验，导致每次会话都被这些机器
专属细节干扰。

结构：新建 docs/CI/，README.md 作唯一入口（适用范围 + 章节速查 + 常用命令），
远程CI完整指南.md 为合并稿。

- 合并：CI配置指南 477 行 + Gitea_Runner部署指南 917 行 → 一篇 1300 行；骨架内容
  逐行比对核实无丢失（仅章节重编号与相对链接按新位置改写），重复段按"留新版"去重，
  独有内容全部搬入（下载/config.yaml 字段语义/不能用 Windows 服务的根因/内网 action
  三种处置/check_env 自检/TL;DR/排障表 13 条独有行/MySQL 直查核验）
- 再分配：测试流程 §9.2 两个 job 的步骤细节并入指南 §5.5、§9.4 部署前置表并入 §0.2；
  测试流程 §9 只留测试分层视角（覆盖哪些层、触发与 paths-ignore、本地等价、
  "CI 不替代本地门禁"）
- AGENTS.md：4 条 CI 经验（看门狗 / gitlint stage / UTF-16LE / CI 概览）压成 1 行指针
- 引用同步 6 个文件：docs/README 目录树与索引、项目部署环境要求 3 处、本地工具路径
  环境变量方案、待处理内容、scripts/README（补登 3 个 CI 脚本并标注为本机专属）

验证：check_doc_links.py --all 125 篇 0 问题；pre-commit run --all-files 17 项全 Passed。
两篇旧文档以 git rm 删除（历史仍在 git 中）；各文档变更记录的历史行按仓库惯例不改写，
只新增 2026-10-12 行。
 2026-10-12 14:03:44 +08:00