Files
group_fqcd_jr/tools/check_authoritative_docs.py
T

17 lines
661 B
Python

from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
docs = ROOT / "docs"
canonical = docs / "05-接口文档.md"
deprecated = docs / "05-公共Agent平台接口规范.md"
if deprecated.exists():
text = deprecated.read_text(encoding="utf-8")
if not any(marker in text for marker in ("历史稿", "已废弃", "废弃声明")):
raise SystemExit("废弃接口文档没有明确历史标记")
for path in docs.glob("*.md"):
if path == canonical or path == deprecated:
continue
if "05-接口文档.md" in path.read_text(encoding="utf-8"):
continue
print(f"authoritative interface document: {canonical.name}")