From fb52a69363b53f3bce6d5f2bdc016aead0c19f90 Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Wed, 2 Sep 2026 09:35:53 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AF=B4=E6=98=8E=20Wiki=20=E5=A2=9E?=
 =?UTF-8?q?=E9=87=8F=E5=90=8C=E6=AD=A5=E4=B8=8E=E6=B7=B1=E5=BA=A6=E6=A3=80?=
 =?UTF-8?q?=E6=9F=A5=20(#29)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 Development-Workflow.-.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/Development-Workflow.-.md b/Development-Workflow.-.md
index e9b9844..a85b3ac 100644
--- a/Development-Workflow.-.md
+++ b/Development-Workflow.-.md
@@ -185,7 +185,10 @@ python dev_scripts/harness.py export --all  # 全量导出已有归档
 - 所有同步和导出只实现 Wiki → `docs/`，不提供反向同步。
 - 镜像头必须记录页面名、页面地址、revision 和同步时间。
 - 已跟踪镜像存在未提交改动时，同步必须停止；确认改动来源后再处理。
-- 核心同步的 `--check` 只检查核心镜像，不要求线上任务归档全部存在于本地。
+- `sync` 和 `sync --check` 先读取一次页面列表，并用远端 revision 与本地镜像头比较；revision 未变化时不下载正文，只有页面新增、变化、元数据缺失或本地镜像元数据无效时才读取正文。
+- `sync --check` 是核心镜像的日常快速检查，不要求线上任务归档全部存在于本地；它验证 revision 和镜像元数据，不替代正文审计。
+- `sync --deep-check` 显式下载全部映射页面正文并逐页比较，用于疑似镜像损坏、同步算法审计或人工要求的完整核对。
+- `sync --verify` 用于新项目 Wiki 初始化门禁，完整读取并写入核心镜像后执行严格结构检查；同一次运行复用读取结果，不重复下载正文。
 - 已经导出的任务镜像仍必须具有来源页面、revision 和同步时间，并通过 Harness 格式检查。
 - 页面删除和重命名不会自动传播，必须先更新工单并人工确认映射变化。
 - Wiki 更新成功而导出失败时，在工单记录部分完成状态，不得把任务标为完成。