From d7b9204245607e3ebd15fb9a68fc80e9702d5896 Mon Sep 17 00:00:00 2001
From: Wanderingss <1624155937@qq.com>
Date: Mon, 12 Oct 2026 18:04:00 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=20ci.yml=20=E5=A4=B4=E9=83=A8?=
 =?UTF-8?q?=E6=8C=87=E5=90=91=E5=B7=B2=E5=88=A0=E6=96=87=E6=A1=A3=E7=9A=84?=
 =?UTF-8?q?=E5=A4=B1=E6=95=88=E5=BC=95=E7=94=A8=EF=BC=88doc-links=20?=
 =?UTF-8?q?=E5=8F=AA=E6=89=AB=20md=20=E7=9A=84=E7=9B=B2=E5=8C=BA=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

ba40cc0 把两篇 CI 指南合并为 docs/CI/远程CI完整指南.md 并删除原文件，但
ci.yml 第 24 行那句"（见 CI配置指南 §4.3）"没跟着改——它指向一篇已经不存在的
文档，且章节号也变了（旧 §4.3 内网 action → 合并稿 §5.3）。

为什么漏掉：scripts/check_doc_links.py 只遍历 .md 文档，.gitea/workflows/*.yml
里的纯文本引用（非 markdown 链接、非带扩展名的反引号路径）不在它的规则覆盖内。
已全仓扫描确认：非 md 文件里这类失效引用仅此 1 处，现已修；md 里余下 9 处均为
"两篇均已删除"的状态说明或变更记录历史行（按仓库惯例历史行不改写）。

本提交同时充当远程 CI 的端到端触发：workflow 的 paths-ignore 挡掉 docs/** 与
**/*.md，所以前几轮的纯文档提交不会触发运行；改 .gitea/workflows/ci.yml 本身
落在忽略集之外，可用来验证 runner 恢复后 run 能否真正执行（此前 run 16~21 因
runner 停摆全部 cancelled，尚无一次成功运行）。

验证：check_doc_links.py --all 125 篇 0 问题；pre-commit run --all-files 17 项
全 Passed（含 check-yaml）。
---
 .gitea/workflows/ci.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.gitea/workflows/ci.yml b/.gitea/workflows/ci.yml
index 9c58b7d7..458e8d8a 100644
--- a/.gitea/workflows/ci.yml
+++ b/.gitea/workflows/ci.yml
@@ -21,7 +21,7 @@
 #
 # 产物存档（S3，2026-10-02）：两个 job 把关键输出 `Tee-Object` 到 `ci-artifacts/*.log`，
 #   并写 $GITHUB_STEP_SUMMARY（Gitea UI 直接可见）+ `::notice::` 汇总行。
-#   **刻意不用 `actions/upload-artifact`**——内网可能拉不到外层 action（见 CI配置指南 §4.3）；
+#   **刻意不用 `actions/upload-artifact`**——内网可能拉不到外层 action（见 docs/CI/远程CI完整指南.md §5.3）；
 #   零依赖方案下日志留在 runner 工作区，UI 通过 step-summary 即可排障。
 #   ⚠️ `ci-artifacts/` 已 gitignore（运行时产物）。
 #