From 52e9a6f8fe4fe03db8c65792ef500cc9a5084384 Mon Sep 17 00:00:00 2001 From: ila Date: Sun, 16 Aug 2026 19:15:47 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=98=8E=E7=A1=AE=E6=A0=B8=E5=BF=83?= =?UTF-8?q?=E9=95=9C=E5=83=8F=E4=B8=8E=E4=BB=BB=E5=8A=A1=E5=BF=AB=E7=85=A7?= =?UTF-8?q?=E8=BE=B9=E7=95=8C=20(#14)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Home.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/Home.md b/Home.md index bfe4ab4..3be5b82 100644 --- a/Home.md +++ b/Home.md @@ -57,7 +57,8 @@ python dev_scripts/sync_wiki_docs.py --check | 任务状态、讨论、阻塞、验收过程 | Gitea 工单 | | 架构、业务规则、开发规范、操作手册、交付文档、任务归档 | Gitea Wiki | | 源码和与特定代码版本强绑定的文档 | Git 仓库 | -| 离线浏览副本 | Git 仓库中的 `docs/` Wiki 镜像 | +| 核心长期文档的离线浏览副本 | Git 仓库中的 `docs/` Wiki 镜像 | +| 完整任务归档 | Gitea Wiki；`docs/task/` 仅是人工按需导出的快照 | 本地 `docs/` 不是编辑入口。长期文档必须先修改 Wiki，读取确认后再导出镜像。 @@ -76,9 +77,10 @@ python dev_scripts/sync_wiki_docs.py --check 修改 Wiki → 读取确认 → 导出 docs → 校验差异 → 提交镜像 ``` -- 页面和本地路径通过仓库中的 `wiki-docs.json` 显式映射。 +- 核心页面和本地路径通过仓库中的 `wiki-docs.json` 显式映射；普通同步不处理任务归档。 +- 任务归档默认只保存在 Wiki，只有用户明确提出时才增量或全量导出到 `docs/task/`。 - 镜像头记录来源页面、Wiki revision 和同步时间。 - 已映射镜像存在未提交修改时同步必须停止。 - 页面删除、重命名和映射变更必须人工确认。 -- Wiki 或导出失败时，相关任务不能标记为完成。 +- 核心 Wiki 或必要同步失败时，相关任务不能标记为完成；未请求任务归档导出不阻止任务完成。 - 凭据、个人数据和生产数据不得进入 Wiki 或镜像。