56 lines
1.7 KiB
Python
56 lines
1.7 KiB
Python
"""检查仓库 Markdown 相对链接；忽略远程 URL、页内锚点与示例占位。"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import re
|
|
from pathlib import Path
|
|
from urllib.parse import unquote
|
|
|
|
ROOT = Path(__file__).resolve().parents[1]
|
|
LINK = re.compile(r"(?<!!)\[[^\]]*\]\(([^)]+)\)")
|
|
|
|
|
|
def main() -> int:
|
|
failures: list[str] = []
|
|
for document in ROOT.rglob("*.md"):
|
|
if any(
|
|
part
|
|
in {
|
|
".build",
|
|
".local-plans",
|
|
".pnpm-store",
|
|
".qa-pytest-tmp",
|
|
".qa-uv-cache",
|
|
".venv",
|
|
".venv-models",
|
|
".venv-models-cuda",
|
|
"node_modules",
|
|
"target",
|
|
}
|
|
for part in document.parts
|
|
):
|
|
continue
|
|
source = document.read_text(encoding="utf-8")
|
|
for raw in LINK.findall(source):
|
|
target = raw.strip().strip("<>").split()[0]
|
|
if not target or target.startswith(("#", "http://", "https://", "mailto:")):
|
|
continue
|
|
path = unquote(target.split("#", 1)[0])
|
|
resolved = (document.parent / path).resolve()
|
|
try:
|
|
resolved.relative_to(ROOT)
|
|
except ValueError:
|
|
failures.append(f"{document.relative_to(ROOT)}: 链接越出仓库: {target}")
|
|
continue
|
|
if not resolved.exists():
|
|
failures.append(f"{document.relative_to(ROOT)}: 不存在: {target}")
|
|
if failures:
|
|
print("\n".join(failures))
|
|
return 1
|
|
print("Markdown 相对链接检查通过")
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
raise SystemExit(main())
|