<!-- gitea-wiki-mirror:start -->
generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
wiki_page: Home
wiki_url: http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Home
wiki_revision: ff8425429da943ad2ce9380d950458dc49a72658
synchronized_at: 2026-08-07T15:53:56Z
<!-- gitea-wiki-mirror:end -->

# 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 或镜像。