docs: add DevHarness upgrade baseline guidance (#16)

2026-08-16 19:51:20 +08:00
parent fe99ca52e3
commit 947a06846e
4 changed files with 68 additions and 4 deletions
@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件)
 wiki_page: Project-Profile
 wiki_url: http://ilaer.eicp.net:8418/opc/dev_harness/wiki/Project-Profile.-
-wiki_revision: 62d1251f807f7d1b60017790c35d46186ffb9617
-synchronized_at: 2026-08-16T11:18:50Z
+wiki_revision: 16456d6ed083197759d553b1033e3e5c8a6b8932
+synchronized_at: 2026-08-16T11:49:52Z
 <!-- gitea-wiki-mirror:end -->

 # 项目档案
@@ -23,6 +23,19 @@ synchronized_at: 2026-08-16T11:18:50Z
 | 主要维护者 | `ila` |
 | 文档适用范围 | 默认分支当前版本；具体镜像 revision 见每个本地文件头 |

+## DevHarness 来源与基线
+
+每个采用 DevHarness 的业务项目都必须填写本节。它记录的是所采用的 DevHarness 上游版本，不是业务项目自己的提交。不得使用“最新版本”“当前 main”等动态描述代替完整提交哈希。
+
+| 项目 | 内容 |
+|---|---|
+| DevHarness 来源仓库 | `http://ilaer.eicp.net:8418/opc/dev_harness` |
+| 当前基线提交 | 本仓库是 DevHarness 上游源模板，不适用；复制到业务项目后必须替换为实际采用的完整提交哈希 |
+| 最后接入或升级日期 | 2026-08-16 |
+| 项目适配说明 | 本仓库维护源模板；业务项目填写保留、改写或未采用的 Harness 规则与工具 |
+
+首次接入和后续升级都必须在目标项目工单中记录旧基线、新基线和差异分类。升级验收通过后，目标项目应把“当前基线提交”和日期更新为已采用的上游提交；未完成或已回退的升级不得更新基线。
+
 ## 子项目与交付单元

 “子项目”是仓库中具有明确职责和规则边界的应用或模块；“交付单元”是能够独立构建、测试、版本化或发布的程序、服务、库或文档包。一个子项目可以对应一个交付单元，也可以包含多个交付单元。