docs: 明确核心镜像与任务快照边界 (#14)

ila
2026-08-16 19:15:47 +08:00
parent 3f50238b63
commit 52e9a6f8fe
+5 -3
@@ -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 或镜像。