From 4f5f2282034c784d0cc23fe3eb37f28815139612 Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Mon, 24 Aug 2026 16:44:52 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E7=B2=BE=E7=AE=80=E4=BB=BB=E5=8A=A1?= =?UTF-8?q?=E4=BA=8B=E5=AE=9E=E6=9D=A5=E6=BA=90=E4=B8=8E=E5=B7=A5=E7=A8=8B?= =?UTF-8?q?=E5=9F=BA=E7=BA=BF=20(#25)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Home.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/Home.md b/Home.md index ca9b560..feb7b4f 100644 --- a/Home.md +++ b/Home.md @@ -58,10 +58,10 @@ python dev_scripts/harness.py sync --check |---|---| | 任务状态、讨论、阻塞、验收过程 | Gitea 工单 | | 长期产品需求的统一导航和状态 | Gitea Wiki 的 Product-Requirements-Overview | -| 架构、业务规则、开发规范、操作手册、交付文档、任务归档 | Gitea Wiki | +| 架构、业务规则、开发规范、操作手册和交付文档 | Gitea Wiki | | 源码和与特定代码版本强绑定的文档 | Git 仓库 | | 核心长期文档的离线浏览副本 | Git 仓库中的 `docs/` Wiki 镜像 | -| 完整任务归档 | Gitea Wiki;`docs/task/` 仅是人工按需导出的快照 | +| 单次任务需求、实现、测试和验收 | Gitea 工单;专项 Wiki 快照仅在人工明确要求时创建 | 本地 `docs/` 不是编辑入口。长期文档必须先修改 Wiki,读取确认后再导出镜像。 @@ -73,7 +73,7 @@ python dev_scripts/harness.py sync --check - [已有项目接入 DevHarness 指南](Existing-Project-Adoption-Guide.-) - [交付文档指南](Delivery-Documentation-Guide.-) - [岗位文档模板](Audience-Document-Template.-) -- [任务归档模板](Task-Archive-Template.-) +- [可选任务归档模板(兼容)](Task-Archive-Template.-) ## 同步原则 @@ -82,9 +82,9 @@ python dev_scripts/harness.py sync --check ``` - 核心页面和本地路径通过仓库中的 `wiki-docs.json` 显式映射;普通同步不处理任务归档。 -- 任务归档默认只保存在 Wiki,只有用户明确提出时才增量或全量导出到 `docs/task/`。 +- 默认不创建任务归档;只有用户明确要求专项快照或项目专用规则要求时,才创建 Wiki 归档并按需导出到 `docs/task/`。 - 镜像头记录来源页面、Wiki revision 和同步时间。 - 已映射镜像存在未提交修改时同步必须停止。 - 页面删除、重命名和映射变更必须人工确认。 -- 核心 Wiki 或必要同步失败时,相关任务不能标记为完成;未请求任务归档导出不阻止任务完成。 +- 长期事实发生变化而核心 Wiki 或必要同步失败时,相关任务不能标记为完成;没有长期文档变化时不运行 Wiki 同步,未请求可选归档不阻止任务完成。 - 凭据、个人数据和生产数据不得进入 Wiki 或镜像。