46 lines
1.7 KiB
Markdown
46 lines
1.7 KiB
Markdown
<!-- 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: 448de2a90fc237f6d5df6a5e8da1f94df2665a30
|
|
synchronized_at: 2026-08-07T15:57:30Z
|
|
<!-- 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 或镜像。
|