diff --git a/开发文档/8、部署/04-Gitea门户/gitea/publish_wiki.py b/开发文档/8、部署/04-Gitea门户/gitea/publish_wiki.py
index 4b46d4c1b9..d73c41e2f0 100755
--- a/开发文档/8、部署/04-Gitea门户/gitea/publish_wiki.py
+++ b/开发文档/8、部署/04-Gitea门户/gitea/publish_wiki.py
@@ -1,5 +1,9 @@
 #!/usr/bin/env python3
-"""将 docs/wiki-gitea/*.md 同步到 Gitea 百科。
+"""将 开发文档/8、部署/04-Gitea门户/wiki-gitea/*.md 同步到 Gitea 百科。
+
+用法：
+  python3 publish_wiki.py              # 推送到 Gitea（需 TOKEN 或 NAS 在线）
+  python3 publish_wiki.py --check-only # 仅校验本地源文件，不联网
 
 认证顺序：
 1) 环境变量 GITEA_TOKEN（推荐）或 GITEA_USER + GITEA_PASS
@@ -58,6 +62,13 @@ def main() -> int:
         print("缺少目录:", wiki, file=sys.stderr)
         return 1
 
+    pages = sorted(wiki.glob("*.md"))
+    if "--check-only" in sys.argv:
+        for path in pages:
+            print("ok:", path.name, len(path.read_text(encoding="utf-8")), "chars")
+        print("check-only 通过，共", len(pages), "页")
+        return 0
+
     base = os.environ.get("GITEA_BASE", "http://192.168.1.201:3000").rstrip("/")
     owner = os.environ.get("GITEA_OWNER", "fnvtk")
     repo = os.environ.get("GITEA_REPO", "workphone-sdk")
diff --git a/开发文档/8、部署/04-Gitea门户/wiki-gitea/Home.md b/开发文档/8、部署/04-Gitea门户/wiki-gitea/Home.md
index ba90adedbc..fb0e32b2dc 100644
--- a/开发文档/8、部署/04-Gitea门户/wiki-gitea/Home.md
+++ b/开发文档/8、部署/04-Gitea门户/wiki-gitea/Home.md
@@ -7,6 +7,7 @@
 - **产品 / 运营**：读 [[完整整合手册]]、[[快速开始]]、[[更新动态]]
 - **后端 / 设备**：读 [[完整整合手册]]、[[架构一览]]、[[Hook与Frida]]、[[下载中心]]
 - **部署运维**：[[完整整合手册]] §八 无线 Frida + 仓库 `开发文档/8、部署/`
+- **目录结构**：仓库 `开发文档/00-项目总览/`（含项目架构总览图）
 
 ## 核心链接
 
diff --git a/开发文档/8、部署/04-Gitea门户/wiki-gitea/更新动态.md b/开发文档/8、部署/04-Gitea门户/wiki-gitea/更新动态.md
index 669757ca6f..b89713b304 100644
--- a/开发文档/8、部署/04-Gitea门户/wiki-gitea/更新动态.md
+++ b/开发文档/8、部署/04-Gitea门户/wiki-gitea/更新动态.md
@@ -7,7 +7,8 @@
 - **Hook / Frida**：Root + frida-server **16.5.6** 全链路打通；`wechat_hook_v2.js` 适配 WCDB、多 RPC；`FridaManager` 死锁修复。
 - **服务端**：`hook/probe`、`hook/data` 等接口；Hub **Hook 数据** 面板（拉取联系人/群/标签/消息等）。
 - **文档**：`设备端Hook安装部署.md`、`快速入机部署_Root_Frida_Hook.md`、机擎 SKILL 更新。
-- **Gitea 门户**：根 `README.md`、`.gitea/workflows`、百科源 `docs/wiki-gitea/`、发行与软件包说明 `docs/gitea/`。
+- **Gitea 门户**：`开发文档/8、部署/04-Gitea门户/`（百科源 `wiki-gitea/`、脚本 `gitea/publish_wiki.py`）。
+- **项目目录总览**：仓库 `开发文档/00-项目总览/README.md`（Obsidian + 架构 PNG）。
 
 ## 如何跟进最新进度