Table of Contents

16 DevHarness 后续升级与基线记录

背景与目标
最终方案
修改文件
验收结果
测试
Wiki 证据
遗留问题
相关提交

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

16 DevHarness 后续升级与基线记录

类型：流程文档
状态：待验收
日期：2026-08-16
Gitea 工单：#16
Wiki 页面：Task-16-DevHarness-后续升级与基线记录
本地镜像：按 #14 规则不自动导出

背景与目标

已有项目接入后，需要从明确的旧 DevHarness 基线安全升级到新基线，并保留目标项目自己的业务、安全和文档事实。每个采用 DevHarness 的业务项目必须记录来源仓库和当前基线完整提交哈希。

最终方案

Project-Profile 新增“DevHarness 来源与基线”，记录来源仓库、当前基线提交、接入或升级日期和项目适配说明。
基线是 DevHarness 上游提交，不是业务项目自己的提交；禁止使用“最新版本”等动态描述。
Existing-Project-Adoption-Guide 新增“后续升级”，规定基线比较、差异分类、目标项目建单、最小合并、Wiki-first、验证和验收更新记录。
来源不一致、基线不存在、目标提交不明确或项目规则冲突时停止并等待确认。
不增加自动升级脚本，不复制 DevHarness 工单、任务归档或项目事实。

修改文件

docs/00-project-profile.md：来源与基线记录要求。
docs/08-existing-project-adoption.md：升级步骤、停止条件和可复制指令。
dev_scripts/check_harness.py：新增章节的严格结构检查。
tests/test_harness_docs.py：新增章节校验测试。

验收结果

验收标准	结果
接入指南包含“后续升级”及完整步骤	通过
每个业务项目必须记录来源仓库和完整基线提交	通过
明确差异分类、保护边界和停止条件	通过
未增加自动升级脚本或新流程框架	通过
Wiki 与核心镜像一致	通过
严格检查和单元测试通过	通过
工单保持待验收	通过

测试

python dev_scripts/check_harness.py --strict：通过。
python -m unittest discover -s tests -v：34 项全部通过。
python dev_scripts/sync_wiki_docs.py --check：13 个核心页面全部一致。
人工检查：可从旧基线定位比较范围，分类采用、改写、冲突和不采用项，并明确验收后确认新基线。
未验证部分：未在具体业务项目执行真实升级；本任务只定义和校验流程文档。

Wiki 证据

Project-Profile revision：16456d6ed083197759d553b1033e3e5c8a6b8932
Existing-Project-Adoption-Guide revision：2ef3d7cd26874f652e9bfab2a5c2f6c8273ab7ac

遗留问题

无。