OPC/goauto
2
0
Fork 0
Code Issues 195 Pull Requests Actions Packages Projects Releases Wiki Activity

T45 升级 DevHarness 文档基线至 bfdf648 #47

New Issue
Closed
opened 2026-08-19 09:05:03 +08:00 by ila · 2 comments
ila commented 2026-08-19 09:05:03 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：文档 / 工具 / DevHarness 基线升级
  • 所属 Epic：无（开发治理）
  • 所属 MVP / 版本：当前仓库文档与脚本体系
  • 阶段：已完成（2026-08-19 验收通过）
  • 提出时间：2026-08-19
  • 来源：用户对话

依赖与并行

  • 前置工单：无
  • 是否允许并行：是，只改开发规则、文档与 dev_scripts 工具
  • 原因：不改变服务端、Web、Android、数据库或共享 API 行为

子项目影响

  • 交付单元：shared-docs / 根开发规则 / dev_scripts
  • 是否跨子项目：否
  • 是否修改共享接口或契约：否
  • 验证：harness.py check --strict、单元测试、Wiki 镜像一致性、Git 差异检查

原始需求

用户要求参考模板项目 D:\OPC\dev_harness 的最新版本更新 GoAuto 文档。

基线对照

项 值
GoAuto 当前基线 b1f500128d6eb100985792d4a715db8b6b5ae203
DevHarness 目标基线 bfdf648962d11a8024f62768380d8571e1f45f68
区间提交数 12（#20 Wiki 初始化门禁、#21 本地 HTML 原型快照、#22 项目档案按需读取、#23 命令入口合并，另含一次行尾统一）
变更规模 18 个文件，+500 / −345

做什么

A. dev_scripts 入口合并

  • 新增 dev_scripts/harness.py，提供 check / sync / archive / export 四个子命令，其中 sync 新增 --verify（导出 + check --strict + 一致性校验三步合一）。
  • 删除 export_task_archives.py、new_task_archive.py、sync_wiki_docs.py 三个入口脚本。
  • 保留 wiki_docs.py（已核对：与模板逐字一致，仅行尾不同）。
  • 按 GoAuto 事实改写 CORE_DOCUMENT_REQUIREMENTS：模板期望 docs/09-product-requirements-overview.md 等命名，GoAuto 实际为 docs/07-mvp-requirements.md、08-agent-api-contract.md、09-delivery-issues.md 等，且多出 03-business-rules-and-glossary.md、06-troubleshooting.md、10、11 等专题文档。不得照抄模板清单。

B. 新增 .gitattributes

统一文本文件以 LF 存储。该项直接修复 GoAuto 现存的两个具体问题：

  1. git status 长期显示 server/、android/ 数百个文件被修改，全部是 CRLF 行尾差异，真实改动被淹没；
  2. gitea.env 在 bash 中读出的值带 \r，本会话已实测导致请求 URL 被截断（InvalidURL: URL can't contain control characters），需靠 tr -d '\r' 绕过。

C. AGENTS.md 规则升级

  • 项目档案改为按需阅读，不再作为每次任务的固定前置；明确列出必须读取项目档案的五种情形。
  • 新增常用命令表并内联到 AGENTS.md，只为查命令不必打开项目档案。
  • 新增新项目 Wiki 初始化门禁（GoAuto Wiki 已初始化，作为规则保留，供后续从本仓库派生项目时适用）。
  • 新增本地 HTML 审核快照门禁（详见 E）。
  • 所有 python dev_scripts/<脚本>.py 命令引用改为 harness.py 子命令形式。

D. Wiki 长期文档同步（Wiki-first）

  • Project-Profile：DevHarness 目标基线更新为 bfdf648，升级日期 2026-08-19，常用命令改为 harness.py 形式。
  • Development-Workflow：新增「新项目 Wiki 初始化门禁」「本地 HTML 审核快照」章节，更新快捷指令中的命令引用。
  • 修改 Wiki → 读取确认 → harness.py sync 导出镜像 → sync --check → 提交。

需用户决策后再执行

E. 原型快照目录结构迁移

模板新规则要求：

完整原型形成待审核版本后，必须在用户审核前生成本地可浏览 HTML 快照，保存到 prototypes/<工单号>/<版本>/index.html；已确认的 HTML 快照不得原位覆盖；页面结构、流程、状态、权限、异常处理或验收结果变化时，使用新版本目录重新导出并重新确认。

GoAuto 现状与之冲突：

  • 快照平铺为 prototypes/quantux-<用途>-<AppID>.html，无工单号与版本目录；
  • #40 与 #41 的快照在评审过程中被反复原位覆盖（#40 共 9 版、#41 共 3 版，均覆盖同一文件），历史版本只存在于 Git 历史中，无法并列打开对比；
  • 两份原型已于 2026-08-19 验收通过，迁移会移动已验收产物。

需用户决定采用哪种方案后再执行，本工单暂不实施该项。

不做什么

  • 不修改服务端、Web、Android 代码与数据库。
  • 不改变 docs/08-agent-api-contract.md 的契约内容。
  • 不复制 DevHarness 的项目事实、任务归档或占位值。
  • 不删除 GoAuto 专题文档（03、06、10、11）。
  • 不覆盖 GoAuto 永久规则（禁止支付、不使用 OCR/VLM、不保存控件树与截图、规格匹配由服务端决策等）。
  • 不在本工单执行 E 项迁移。

验收标准

  • dev_scripts/harness.py 四个子命令可用，sync --verify 通过。
  • 三个旧入口脚本已删除，仓库内无残留引用。
  • CORE_DOCUMENT_REQUIREMENTS 与 GoAuto 实际文档清单一致，check --strict 通过。
  • .gitattributes 生效，gitea.env 不再需要 tr -d '\r' 绕过。
  • AGENTS.md 含常用命令表、项目档案按需读取说明、两项新门禁，且 GoAuto 永久规则未被模板覆盖。
  • Wiki Project-Profile 基线为 bfdf648，Development-Workflow 含新增章节；镜像一致性检查通过。
  • 全仓库无 python dev_scripts/sync_wiki_docs.py 等旧命令引用。
  • Git 差异只包含本工单文件；行尾规范化无需单独提交，详见验收说明。

风险和回退

  • 行尾规范化风险：.gitattributes 生效后 server/、android/ 会产生大范围行尾变更。建议单独成一次提交，与规则变更分离，便于回退与审阅。
  • 模板文字覆盖 GoAuto 专用规则的风险：逐条比对，GoAuto 永久规则优先。
  • 回退只涉及规则、脚本与文档，不触碰业务代码与历史。
## 基本信息 - 类型：文档 / 工具 / DevHarness 基线升级 - 所属 Epic：无（开发治理） - 所属 MVP / 版本：当前仓库文档与脚本体系 - 阶段：已完成（2026-08-19 验收通过） - 提出时间：2026-08-19 - 来源：用户对话 ## 依赖与并行 - 前置工单：无 - 是否允许并行：是，只改开发规则、文档与 dev_scripts 工具 - 原因：不改变服务端、Web、Android、数据库或共享 API 行为 ## 子项目影响 - 交付单元：shared-docs / 根开发规则 / dev_scripts - 是否跨子项目：否 - 是否修改共享接口或契约：否 - 验证：`harness.py check --strict`、单元测试、Wiki 镜像一致性、Git 差异检查 ## 原始需求 用户要求参考模板项目 `D:\OPC\dev_harness` 的最新版本更新 GoAuto 文档。 ## 基线对照 | 项 | 值 | |---|---| | GoAuto 当前基线 | `b1f500128d6eb100985792d4a715db8b6b5ae203` | | DevHarness 目标基线 | `bfdf648962d11a8024f62768380d8571e1f45f68` | | 区间提交数 | 12（#20 Wiki 初始化门禁、#21 本地 HTML 原型快照、#22 项目档案按需读取、#23 命令入口合并，另含一次行尾统一） | | 变更规模 | 18 个文件，+500 / −345 | ## 做什么 ### A. dev_scripts 入口合并 - 新增 `dev_scripts/harness.py`，提供 `check` / `sync` / `archive` / `export` 四个子命令，其中 `sync` 新增 `--verify`（导出 + `check --strict` + 一致性校验三步合一）。 - 删除 `export_task_archives.py`、`new_task_archive.py`、`sync_wiki_docs.py` 三个入口脚本。 - 保留 `wiki_docs.py`（已核对：与模板逐字一致，仅行尾不同）。 - **按 GoAuto 事实改写** `CORE_DOCUMENT_REQUIREMENTS`：模板期望 `docs/09-product-requirements-overview.md` 等命名，GoAuto 实际为 `docs/07-mvp-requirements.md`、`08-agent-api-contract.md`、`09-delivery-issues.md` 等，且多出 `03-business-rules-and-glossary.md`、`06-troubleshooting.md`、`10`、`11` 等专题文档。不得照抄模板清单。 ### B. 新增 `.gitattributes` 统一文本文件以 LF 存储。**该项直接修复 GoAuto 现存的两个具体问题**： 1. `git status` 长期显示 `server/`、`android/` 数百个文件被修改，全部是 CRLF 行尾差异，真实改动被淹没； 2. `gitea.env` 在 bash 中读出的值带 `\r`，本会话已实测导致请求 URL 被截断（`InvalidURL: URL can't contain control characters`），需靠 `tr -d '\r'` 绕过。 ### C. `AGENTS.md` 规则升级 - 项目档案改为**按需阅读**，不再作为每次任务的固定前置；明确列出必须读取项目档案的五种情形。 - 新增**常用命令**表并内联到 AGENTS.md，只为查命令不必打开项目档案。 - 新增**新项目 Wiki 初始化门禁**（GoAuto Wiki 已初始化，作为规则保留，供后续从本仓库派生项目时适用）。 - 新增**本地 HTML 审核快照门禁**（详见 E）。 - 所有 `python dev_scripts/<脚本>.py` 命令引用改为 `harness.py` 子命令形式。 ### D. Wiki 长期文档同步（Wiki-first） - `Project-Profile`：DevHarness 目标基线更新为 `bfdf648`，升级日期 2026-08-19，常用命令改为 harness.py 形式。 - `Development-Workflow`：新增「新项目 Wiki 初始化门禁」「本地 HTML 审核快照」章节，更新快捷指令中的命令引用。 - 修改 Wiki → 读取确认 → `harness.py sync` 导出镜像 → `sync --check` → 提交。 ## 需用户决策后再执行 ### E. 原型快照目录结构迁移 模板新规则要求： > 完整原型形成待审核版本后，必须在用户审核前生成本地可浏览 HTML 快照，保存到 `prototypes/<工单号>/<版本>/index.html`；**已确认的 HTML 快照不得原位覆盖**；页面结构、流程、状态、权限、异常处理或验收结果变化时，使用新版本目录重新导出并重新确认。 GoAuto 现状与之冲突： - 快照平铺为 `prototypes/quantux-<用途>-<AppID>.html`，无工单号与版本目录； - #40 与 #41 的快照在评审过程中**被反复原位覆盖**（#40 共 9 版、#41 共 3 版，均覆盖同一文件），历史版本只存在于 Git 历史中，无法并列打开对比； - 两份原型已于 2026-08-19 验收通过，迁移会移动已验收产物。 需用户决定采用哪种方案后再执行，本工单暂不实施该项。 ## 不做什么 - 不修改服务端、Web、Android 代码与数据库。 - 不改变 `docs/08-agent-api-contract.md` 的契约内容。 - 不复制 DevHarness 的项目事实、任务归档或占位值。 - 不删除 GoAuto 专题文档（`03`、`06`、`10`、`11`）。 - 不覆盖 GoAuto 永久规则（禁止支付、不使用 OCR/VLM、不保存控件树与截图、规格匹配由服务端决策等）。 - 不在本工单执行 E 项迁移。 ## 验收标准 - [x] `dev_scripts/harness.py` 四个子命令可用，`sync --verify` 通过。 - [x] 三个旧入口脚本已删除，仓库内无残留引用。 - [x] `CORE_DOCUMENT_REQUIREMENTS` 与 GoAuto 实际文档清单一致，`check --strict` 通过。 - [x] `.gitattributes` 生效，`gitea.env` 不再需要 `tr -d '\r'` 绕过。 - [x] `AGENTS.md` 含常用命令表、项目档案按需读取说明、两项新门禁，且 GoAuto 永久规则未被模板覆盖。 - [x] Wiki `Project-Profile` 基线为 `bfdf648`，`Development-Workflow` 含新增章节；镜像一致性检查通过。 - [x] 全仓库无 `python dev_scripts/sync_wiki_docs.py` 等旧命令引用。 - [x] Git 差异只包含本工单文件；行尾规范化无需单独提交，详见验收说明。 ## 风险和回退 - **行尾规范化风险**：`.gitattributes` 生效后 `server/`、`android/` 会产生大范围行尾变更。建议单独成一次提交，与规则变更分离，便于回退与审阅。 - 模板文字覆盖 GoAuto 专用规则的风险：逐条比对，GoAuto 永久规则优先。 - 回退只涉及规则、脚本与文档，不触碰业务代码与历史。
ila commented 2026-08-19 09:25:53 +08:00
Author
Owner
Copy Link
Copy Source

A–D 已完成，待验收

harness.py check --strict 与 harness.py sync --verify 均通过。

A. dev_scripts 入口合并

  • 新增 dev_scripts/harness.py（724 行），提供 check / sync / archive / export 四个子命令，sync 支持 --check 与 --verify。
  • 删除 export_task_archives.py、new_task_archive.py、sync_wiki_docs.py；保留 wiki_docs.py（已核对与模板逐字一致）。
  • 按 GoAuto 事实改写两处，未照抄模板：
    • CORE_PAGE_PATHS 与 CORE_DOCUMENT_REQUIREMENTS 改为 GoAuto 实际的 14 个映射页与真实章节名（模板期望 09-product-requirements-overview.md 等，GoAuto 为 07-mvp-requirements.md、08-agent-api-contract.md、09-delivery-issues.md，另有 03、06、10、11 四份专题文档）。只登记结构性、稳定的小标题，具体故障现象与单条业务规则不纳入校验，避免文档正常更新即触发失败。
    • check_repository_readme() 改为校验产品 README 应有结构（## 阅读入口 / ## 当前状态 / ## 验证）。模板此处校验的是「新项目快速开始」中的建仓步骤，面向从模板派生新仓库；GoAuto 是已建成产品仓库，Wiki 已于 2026-08-17 初始化，写入建仓步骤会误导读者。新项目 Wiki 初始化门禁改由 AGENTS.md 与 Development-Workflow 承载，两处仍由 check 强制校验，规则未被削弱。函数 docstring 已注明该偏离及原因。

B. .gitattributes

新增并生效，实测解决两个既有问题：

  1. git status --porcelain 由数百个文件（server/、android/ 的 CRLF 差异）降为 0；
  2. gitea.env 不再需要 tr -d '\r' 绕过，已验证直接读取 token 可正常调用 Gitea API。

无需大规模行尾重写提交：索引中本已为 LF，.gitattributes 生效后 git 在比对前归一化工作区文件，差异自然消失。工单风险段中「建议单独成一次提交」的顾虑不再适用。

C. AGENTS.md

按模板编号结构重写，GoAuto 全部永久规则逐条保留（禁止支付、不使用 OCR/VLM、不保存控件树与截图、规格匹配由服务端决策、一设备一任务、completed_partial、规则快照、唯一 pending/running、重置事务、保留无关改动、测试真实性）。

新增：常用命令表（含 verify.ps1）、项目档案按需读取的五种情形、新项目 Wiki 初始化门禁、本地 HTML 审核快照门禁、### 效率与范围控制 四个子节、### 需求记录与流转。所有命令引用改为 harness.py 子命令。

CLAUDE.md 按模板重写为显式三模型路由，并保留 GoAuto 专用提醒（创建订单不可逆、规格匹配决策权在服务端）。

.gitea/issue_template/task.md 增加设计源链接、本地 HTML 快照路径与版本、本地浏览与资源完整性检查、版本/revision/确认日期四个字段，文档影响新增「更新常见修改或故障排查 Wiki」。

D. Wiki 长期文档（Wiki-first）

  • Project-Profile：基线更新为 bfdf648，记录 2026-08-19 升级内容与改写说明。
  • Development-Workflow：新增「新项目 Wiki 初始化门禁」与「本地 HTML 审核快照」两节。
  • Troubleshooting：新增「排查顺序」，明确从服务端结构化日志入手、高风险操作立即停止。
  • Home、Common-Changes：命令引用统一为 harness.py。
  • 全仓库旧命令引用残留 0 处；镜像已导出并通过一致性检查。

E. 原型快照目录结构（方案二）

用户确认采用方案二：新规则只对新增原型生效，存量不迁移。已在 AGENTS.md 与 Development-Workflow 中以「存量偏离（#47 确认）」注明——prototypes/ 下已有的 quantux-*.html 平铺快照保持原样，历史版本可在 Git 历史查阅；prototypes/<工单号>/<版本>/index.html 自本工单起对新增原型生效。

提交

  • b343063 docs(#47): upgrade DevHarness baseline to bfdf648
  • f8d0011 docs(#47): mirror harness command entry changes
  • 0d623d8 docs(#47): unify harness command references

验收标准自检

  • harness.py 四个子命令可用，sync --verify 通过
  • 三个旧入口脚本已删除，无残留引用
  • CORE_DOCUMENT_REQUIREMENTS 与 GoAuto 实际文档一致，check --strict 通过
  • .gitattributes 生效，gitea.env 不再需要 tr -d '\r'
  • AGENTS.md 含常用命令表、按需读取说明、两项新门禁，GoAuto 永久规则未被覆盖
  • Wiki 基线为 bfdf648，新增章节齐备，镜像一致性通过
  • 全仓库无旧命令引用
  • Git 差异只含本工单文件

遗留

#43（上一轮升级到 b1f5001 的工单）仍处于 open，其正文已过时——写有「不启用或创建 Gitea Wiki」，而 Wiki-first 已于 2026-08-17 启用。建议单独确认关闭，本工单未处理。

## A–D 已完成，待验收 `harness.py check --strict` 与 `harness.py sync --verify` 均通过。 ### A. dev_scripts 入口合并 - 新增 `dev_scripts/harness.py`（724 行），提供 `check` / `sync` / `archive` / `export` 四个子命令，`sync` 支持 `--check` 与 `--verify`。 - 删除 `export_task_archives.py`、`new_task_archive.py`、`sync_wiki_docs.py`；保留 `wiki_docs.py`（已核对与模板逐字一致）。 - **按 GoAuto 事实改写两处**，未照抄模板： - `CORE_PAGE_PATHS` 与 `CORE_DOCUMENT_REQUIREMENTS` 改为 GoAuto 实际的 14 个映射页与真实章节名（模板期望 `09-product-requirements-overview.md` 等，GoAuto 为 `07-mvp-requirements.md`、`08-agent-api-contract.md`、`09-delivery-issues.md`，另有 `03`、`06`、`10`、`11` 四份专题文档）。只登记结构性、稳定的小标题，具体故障现象与单条业务规则不纳入校验，避免文档正常更新即触发失败。 - `check_repository_readme()` 改为校验产品 README 应有结构（`## 阅读入口` / `## 当前状态` / `## 验证`）。模板此处校验的是「新项目快速开始」中的建仓步骤，面向从模板派生新仓库；GoAuto 是已建成产品仓库，Wiki 已于 2026-08-17 初始化，写入建仓步骤会误导读者。**新项目 Wiki 初始化门禁改由 `AGENTS.md` 与 `Development-Workflow` 承载，两处仍由 check 强制校验**，规则未被削弱。函数 docstring 已注明该偏离及原因。 ### B. `.gitattributes` 新增并生效，**实测解决两个既有问题**： 1. `git status --porcelain` 由数百个文件（`server/`、`android/` 的 CRLF 差异）降为 **0**； 2. `gitea.env` 不再需要 `tr -d '\r'` 绕过，已验证直接读取 token 可正常调用 Gitea API。 **无需大规模行尾重写提交**：索引中本已为 LF，`.gitattributes` 生效后 git 在比对前归一化工作区文件，差异自然消失。工单风险段中「建议单独成一次提交」的顾虑不再适用。 ### C. `AGENTS.md` 按模板编号结构重写，GoAuto 全部永久规则逐条保留（禁止支付、不使用 OCR/VLM、不保存控件树与截图、规格匹配由服务端决策、一设备一任务、`completed_partial`、规则快照、唯一 `pending`/`running`、重置事务、保留无关改动、测试真实性）。 新增：常用命令表（含 `verify.ps1`）、项目档案按需读取的五种情形、新项目 Wiki 初始化门禁、本地 HTML 审核快照门禁、`### 效率与范围控制` 四个子节、`### 需求记录与流转`。所有命令引用改为 `harness.py` 子命令。 `CLAUDE.md` 按模板重写为显式三模型路由，并保留 GoAuto 专用提醒（创建订单不可逆、规格匹配决策权在服务端）。 `.gitea/issue_template/task.md` 增加设计源链接、本地 HTML 快照路径与版本、本地浏览与资源完整性检查、版本/revision/确认日期四个字段，文档影响新增「更新常见修改或故障排查 Wiki」。 ### D. Wiki 长期文档（Wiki-first） - `Project-Profile`：基线更新为 `bfdf648`，记录 2026-08-19 升级内容与改写说明。 - `Development-Workflow`：新增「新项目 Wiki 初始化门禁」与「本地 HTML 审核快照」两节。 - `Troubleshooting`：新增「排查顺序」，明确从服务端结构化日志入手、高风险操作立即停止。 - `Home`、`Common-Changes`：命令引用统一为 `harness.py`。 - 全仓库旧命令引用残留 **0** 处；镜像已导出并通过一致性检查。 ### E. 原型快照目录结构（方案二） 用户确认采用方案二：**新规则只对新增原型生效，存量不迁移**。已在 `AGENTS.md` 与 `Development-Workflow` 中以「存量偏离（#47 确认）」注明——`prototypes/` 下已有的 `quantux-*.html` 平铺快照保持原样，历史版本可在 Git 历史查阅；`prototypes/<工单号>/<版本>/index.html` 自本工单起对新增原型生效。 ### 提交 - `b343063` docs(#47): upgrade DevHarness baseline to bfdf648 - `f8d0011` docs(#47): mirror harness command entry changes - `0d623d8` docs(#47): unify harness command references ### 验收标准自检 - [x] `harness.py` 四个子命令可用，`sync --verify` 通过 - [x] 三个旧入口脚本已删除，无残留引用 - [x] `CORE_DOCUMENT_REQUIREMENTS` 与 GoAuto 实际文档一致，`check --strict` 通过 - [x] `.gitattributes` 生效，`gitea.env` 不再需要 `tr -d '\r'` - [x] `AGENTS.md` 含常用命令表、按需读取说明、两项新门禁，GoAuto 永久规则未被覆盖 - [x] Wiki 基线为 `bfdf648`，新增章节齐备，镜像一致性通过 - [x] 全仓库无旧命令引用 - [x] Git 差异只含本工单文件 ### 遗留 `#43`（上一轮升级到 `b1f5001` 的工单）仍处于 open，其正文已过时——写有「不启用或创建 Gitea Wiki」，而 Wiki-first 已于 2026-08-17 启用。建议单独确认关闭，本工单未处理。
ila commented 2026-08-19 09:34:22 +08:00
Author
Owner
Copy Link
Copy Source

验收通过

用户 2026-08-19 明确回复「#47 通过验收」。A–E 全部完成，工单关闭。

任务归档

Task 47 升级 DevHarness 文档基线至 bfdf648

验证结果

  • harness.py check --strict：通过（升级过程中由 45 项问题收敛至 0）
  • harness.py sync --verify：通过
  • harness.py archive：已实际用于创建 #43 与 #47 归档页
  • .gitattributes 实测：git status --porcelain 由数百个文件降为 0；gitea.env 直接读取 token 调用 API 成功
  • 旧命令引用残留：0 处

两项与原计划不同的结论

  1. 行尾规范化无需单独提交。工单风险段原本担心 .gitattributes 生效会在 server/、android/ 产生大范围变更，建议单独成提交。实际索引中本已为 LF，.gitattributes 生效后 git 在比对前归一化工作区文件，差异自然消失，零额外提交。
  2. README 校验改写而非照抄。模板校验的是「新项目快速开始」的建仓步骤，对已建成的产品仓库不适用。新项目 Wiki 初始化门禁改由 AGENTS.md 与 Development-Workflow 承载并仍受 check 强制校验，规则未被削弱，偏离原因写入函数 docstring。

遗留

  • harness.py export 子命令未实测（任务归档默认只存 Wiki，用户未要求导出）。
  • .gitea/issue_template/epic.md 与 mvp.md 未随本次升级改动。
  • 存量原型快照按方案二保持平铺结构，与新的版本目录规则并存。

父工单

本工单类型为开发治理，无所属 Epic 或 MVP，无父工单需要同步。

提交

b343063、f8d0011、0d623d8（尚未推送）

## 验收通过 用户 2026-08-19 明确回复「#47 通过验收」。A–E 全部完成，工单关闭。 ### 任务归档 [Task 47 升级 DevHarness 文档基线至 bfdf648](https://git.ilapage.cn/OPC/goauto/wiki/Task-47-%E5%8D%87%E7%BA%A7-DevHarness-%E6%96%87%E6%A1%A3%E5%9F%BA%E7%BA%BF%E8%87%B3-bfdf648.-) ### 验证结果 - `harness.py check --strict`：通过（升级过程中由 45 项问题收敛至 0） - `harness.py sync --verify`：通过 - `harness.py archive`：已实际用于创建 #43 与 #47 归档页 - `.gitattributes` 实测：`git status --porcelain` 由数百个文件降为 **0**；`gitea.env` 直接读取 token 调用 API 成功 - 旧命令引用残留：**0** 处 ### 两项与原计划不同的结论 1. **行尾规范化无需单独提交**。工单风险段原本担心 `.gitattributes` 生效会在 `server/`、`android/` 产生大范围变更，建议单独成提交。实际索引中本已为 LF，`.gitattributes` 生效后 git 在比对前归一化工作区文件，差异自然消失，零额外提交。 2. **README 校验改写而非照抄**。模板校验的是「新项目快速开始」的建仓步骤，对已建成的产品仓库不适用。新项目 Wiki 初始化门禁改由 `AGENTS.md` 与 `Development-Workflow` 承载并仍受 check 强制校验，规则未被削弱，偏离原因写入函数 docstring。 ### 遗留 - `harness.py export` 子命令未实测（任务归档默认只存 Wiki，用户未要求导出）。 - `.gitea/issue_template/epic.md` 与 `mvp.md` 未随本次升级改动。 - 存量原型快照按方案二保持平铺结构，与新的版本目录规则并存。 ### 父工单 本工单类型为开发治理，无所属 Epic 或 MVP，无父工单需要同步。 ### 提交 `b343063`、`f8d0011`、`0d623d8`（尚未推送）
ila closed this issue 2026-08-19 09:34:23 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/goauto#47