From 47b78d0fcba529ad677b8d208da4b5f1b2ccc971 Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Mon, 17 Aug 2026 11:21:18 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=98=8E=E7=A1=AE=20Home=20=E5=9C=A8?=
 =?UTF-8?q?=E7=BA=BF=E5=88=9B=E5=BB=BA=E4=B8=8E=E5=9B=9E=E8=AF=BB=E9=A1=BA?=
 =?UTF-8?q?=E5=BA=8F=20(#20)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 New-Project-Documentation-Setup.-.md | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/New-Project-Documentation-Setup.-.md b/New-Project-Documentation-Setup.-.md
index 5c7f8b9..11b1a7e 100644
--- a/New-Project-Documentation-Setup.-.md
+++ b/New-Project-Documentation-Setup.-.md
@@ -94,7 +94,9 @@
 
 ### 4. 建立 Gitea
 
-创建远端仓库并完成允许的初始引导提交。开启工单和 Wiki。任何产品功能开发在引导提交后都必须先有单元任务工单。
+创建远端仓库并完成允许的初始引导提交，开启工单和 Wiki；必须先有远端仓库，才能填写该仓库的线上 Wiki。配置项目已有的 Gitea MCP 和安全凭据；优先使用 MCP，MCP 不可用或不支持所需写操作时才回退到 Gitea API，并在初始化工单记录原因。凭据只通过环境或 MCP 安全配置提供。
+
+任何产品功能开发在引导提交后都必须先有单元任务工单，并且必须通过第 8 步的线上 Wiki 初始化门禁。
 
 ### 5. 修改镜像配置
 
@@ -131,6 +133,13 @@ Agent 只读检查：
 
 ### 8. 先创建线上 Wiki
 
+#### 在线创建与回读门禁
+
+1. 使用配置好的 Gitea MCP 查询目标仓库的 Wiki 页面列表；MCP 不可用时使用 Gitea API，并记录回退原因。
+2. 如果 `Home` 不存在，先创建 `Home`。创建后立即在线回读正文并记录 revision；`Home` 可读取后才能继续。
+3. 依照 `wiki-docs.json` 逐页创建或更新其他核心页面。每页写入后在线回读正文，记录页面名和 revision。
+4. 本地 `docs/` 是模板或 Wiki 镜像；本地文件存在、标题完整或 `check_harness.py --strict` 通过，都不能单独证明线上 Wiki 已初始化。
+5. 页面缺失、回读失败或没有 revision 时停止初始化，不得开始产品代码；Gitea 恢复后从首个失败页面继续。
 至少创建或填写：
 
 1. Home；
@@ -170,6 +179,8 @@ python -m unittest discover -s tests -v
 
 只有线上 Wiki 确认后才导出核心 `docs/`。任务归档默认不导出；用户明确要求时再运行 `python dev_scripts/export_task_archives.py` 或加 `--all`。旧项目的任务归档快照不能带入新项目历史。
 
+`sync_wiki_docs.py --check` 会在线读取全部显式映射页面；任一页面不存在、无法读取或 revision 与镜像不一致时，初始化不通过。只有上述命令全部成功后才允许开始产品代码。
+
 ## 完成标准
 
 初级程序员应能仅依靠 Home 和链接页面回答：