wandering1/STM32F4-Base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects 1 Releases Wiki Activity

fix(gates): doc-links 全库扫描排除 .agents 插件工作树

Browse Source 
主树根跑 --all 时 rglob 会把仓内 .agents/worktrees/* 的整份仓库
副本一并索引，裸文件名解析出 3~4 份导致章节引用假红（本次合并
后复核实测 2 处失效引用 + 4 处芯片手册命名问题）。SKIP_PARTS
已排除同类 .dsh-worktrees，补上 .agents 一项即对齐。

只改 scripts/check_doc_links.py 一行；不改 pre-commit 的 exclude
（该处只喂 git tracked 文件，.agents 已被 .gitignore 挡住）。
修后 --all-files 48 钩子全绿、doc-links --all --sections-strict
全库 214 篇文档 rc=0。
This commit is contained in:
Wanderingss
2026-11-11 12:15:35 +08:00
parent 206dcf7f01
commit 18c087500a
1 changed files with 1 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
scripts/check_doc_links.py
+1
View File
@@ -53,6 +53,7 @@ SKIP_PARTS = ("node_modules", ".venv", ".git", "build", "obj", "__pycache__",
"ci-artifacts", # 本地临时/草稿目录，已 .gitignore，不是项目文档 "ci-artifacts", # 本地临时/草稿目录，已 .gitignore，不是项目文档
".dsh-worktrees", # DSH worktree 插件在**仓库内**建的任务树（整份仓库的副本， ".dsh-worktrees", # DSH worktree 插件在**仓库内**建的任务树（整份仓库的副本，
# 扫它等于把同一篇文档按别人的任务状态判一遍——假红 + 白跑） # 扫它等于把同一篇文档按别人的任务状态判一遍——假红 + 白跑）
".agents", # 同上：DSH 会话插件的工作树落在 .agents/worktrees/，也是整份仓库副本
"docs/芯片手册") # 外部数据手册转录，非项目自有文档，链接形态不受控 "docs/芯片手册") # 外部数据手册转录，非项目自有文档，链接形态不受控
# Markdown 链接：[text](target)。目标须以「非空白、非右括号」构成， # Markdown 链接：[text](target)。目标须以「非空白、非右括号」构成，