docs: 初始化 Wiki 文档中心 (#1)

2026-08-07 23:47:53 +08:00
commit ff8425429d
1 changed files with 37 additions and 0 deletions
@@ -0,0 +1,37 @@
+# DevHarness 文档中心
+
+DevHarness 是一个以 Gitea 工单管理开发任务、以 Wiki 管理长期开发文档、以 Git 记录代码变更的 AI 辅助开发模板。
+
+## 事实来源
+
+| 信息 | 事实来源 |
+|---|---|
+| 任务状态、讨论、阻塞、验收过程 | Gitea 工单 |
+| 架构说明、开发规范、操作手册、任务归档 | Gitea Wiki |
+| 源码和与特定代码版本强绑定的文档 | Git 仓库 |
+| 离线浏览副本 | Git 仓库中的 `docs/` Wiki 镜像 |
+
+本地 `docs/` 不是编辑入口。长期文档必须先修改 Wiki，读取确认后再导出镜像。
+
+## 文档入口
+
+- [项目档案](Project-Profile)
+- [开发工作流](Development-Workflow)
+- [任务归档模板](Task-Archive-Template)
+- [Gitea 工单](http://ilaer.eicp.net:8418/opc/dev_harness/issues)
+- [代码仓库](http://ilaer.eicp.net:8418/opc/dev_harness)
+
+## 同步原则
+
+固定顺序：
+
+```text
+修改 Wiki → 读取确认 → 导出 docs → 校验差异 → 提交镜像
+```
+
+- 页面和本地路径通过仓库中的 `wiki-docs.json` 显式映射。
+- 镜像头记录来源页面、Wiki revision 和同步时间。
+- 同步工具发现已跟踪镜像存在未提交修改时必须停止。
+- 页面删除、重命名和映射变更必须人工确认，不自动传播。
+- Wiki 或导出失败时，相关任务不能标记为完成。
+- 凭据、个人数据和生产数据不得进入 Wiki 或镜像。