dev_harness/docs/README.md

generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Home wiki_url: http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Home wiki_revision: 448de2a90fc237f6d5df6a5e8da1f94df2665a30 synchronized_at: 2026-08-07T15:57:30Z

DevHarness 文档中心

DevHarness 是一个以 Gitea 工单管理开发任务、以 Wiki 管理长期开发文档、以 Git 记录代码变更的 AI 辅助开发模板。

事实来源

信息	事实来源
任务状态、讨论、阻塞、验收过程	Gitea 工单
架构说明、开发规范、操作手册、任务归档	Gitea Wiki
源码和与特定代码版本强绑定的文档	Git 仓库
离线浏览副本	Git 仓库中的 docs/ Wiki 镜像

本地 docs/ 不是编辑入口。长期文档必须先修改 Wiki，读取确认后再导出镜像。

文档入口

• 项目档案
• 开发工作流
• 任务归档模板
• Gitea 工单
• 代码仓库

同步原则

固定顺序：

修改 Wiki → 读取确认 → 导出 docs → 校验差异 → 提交镜像

• 页面和本地路径通过仓库中的 wiki-docs.json 显式映射。
• 镜像头记录来源页面、Wiki revision 和同步时间。
• 同步工具发现已跟踪镜像存在未提交修改时必须停止。
• 页面删除、重命名和映射变更必须人工确认，不自动传播。
• Wiki 或导出失败时，相关任务不能标记为完成。
• 凭据、个人数据和生产数据不得进入 Wiki 或镜像。