commit ff8425429da943ad2ce9380d950458dc49a72658 Author: ila Date: Fri Aug 7 23:47:53 2026 +0800 docs: 初始化 Wiki 文档中心 (#1) diff --git a/Home.md b/Home.md new file mode 100644 index 0000000..6a17bc3 --- /dev/null +++ b/Home.md @@ -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 或镜像。