feat: 引入 Wiki 文档镜像流程 (#1)

scripts/sync_wiki_docs.py

@@ -0,0 +1,33 @@
+"""从 Gitea Wiki 单向导出本地 docs 镜像。"""
+
+from __future__ import annotations
+
+import argparse
+from pathlib import Path
+
+from wiki_docs import DEFAULT_CONFIG, WikiClient, WikiDocsError, load_config, sync_all
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="从 Gitea Wiki 单向同步 docs 镜像")
+    parser.add_argument(
+        "--check", action="store_true", help="只检查 Wiki 与镜像是否一致，不写文件"
+    )
+    parser.add_argument(
+        "--config", default=str(DEFAULT_CONFIG), help="Wiki 页面映射 JSON 文件"
+    )
+    args = parser.parse_args()
+    try:
+        config = load_config(Path(args.config).resolve())
+        messages = sync_all(config, WikiClient(config), check=args.check)
+    except WikiDocsError as exc:
+        print(f"错误：{exc}")
+        return 1
+    for message in messages:
+        print(message)
+    print("Wiki 镜像检查通过" if args.check else "Wiki 镜像同步完成")
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())