 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 |
|