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

升级 DevHarness 文档与工作流基线至 4bbacf4 #114

New Issue
Closed
opened 2026-08-27 17:32:21 +08:00 by ila · 2 comments
ila commented 2026-08-27 17:32:21 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：文档 / 工作流升级
  • 所属 Epic：无
  • 所属 MVP / 版本：无
  • 阶段：进行中

依赖与并行

  • 前置工单：无
  • 是否允许与前置工单并行：是
  • 原因：仅升级开发治理资料与 Harness 校验，不改变产品运行行为。

子项目影响

  • 仅影响的子项目 / 交付单元：shared-docs、DevHarness 工具与测试
  • 是否跨子项目：否
  • 是否修改共享接口或契约：否
  • 各子项目需要执行的验证：Harness 单元测试、严格结构检查、Wiki 镜像一致性检查。

原始需求

  • 来源：用户对话
  • 提出时间：2026-08-27
  • 关键原话或脱敏摘要：本项目工作流程和文档参考 D:\OPC\dev_harness 生成；该仓库已更新，要求 GoAuto 参考其最新内容更新文档和工作流。

要解决什么

  • 当前代码事实：GoAuto 项目档案记录的可复现 DevHarness 基线为 bfdf648962d11a8024f62768380d8571e1f45f68；本地 DevHarness 当前提交为 4bbacf4d7fb265984396bb5589c544105043fa0b，区间共 13 个提交。GoAuto 已通过 #76 提前吸收上游 #25 的工单唯一任务事实源与按需快照原则，但尚未完整吸收 #24、#26、#27、#28。
  • 目标契约 / 用户期望：以明确提交为基线增量合并上游治理变化，并按 GoAuto 事实改写。
  • 假设与未确认项：不臆造生产部署拓扑；本次引入部署模板和落点规则，不创建包含未确认生产参数的部署实例页。

做什么 / 不做什么

  • 做：
    • 项目档案基线更新为 4bbacf4d…，记录旧基线、升级区间和 GoAuto 适配/不采用项。
    • 增量合并 Gitea MCP 优先与最小工单读取规则。
    • 将完整原型门禁改为“可访问且版本明确的线上原型默认审核；本地 HTML 仅在用户或项目规则明确要求时导出”，保留 GoAuto 已确认快照不可覆盖和安全清理规则。
    • 增加 PowerShell、UTF-8 与 ExecutionPolicy 边界。
    • 增加部署文档模板及映射，并规定 GoAuto 真实部署事实确认后建立 Deployment-and-Operations；不写占位生产参数。
    • 更新单元工单模板、自然语言快捷指令、Harness 结构校验与测试。
    • 先更新线上 Wiki并回读 revision，再同步本地镜像。
  • 不做：
    • 不复制 DevHarness 的项目事实、历史工单、任务归档或占位值。
    • 不改变 GoAuto 产品代码、API、数据库、状态机、权限、安全或采集/采购行为。
    • 不发布、不部署，不修改真实环境。
    • 不删除或覆盖既有已确认原型快照。

已确认方案

上游差异分类：

  • 直接采用：Gitea MCP 优先与最小读取、PowerShell/UTF-8/ExecutionPolicy 边界、线上原型与按需导出语义、部署模板结构、工单模板字段及 Harness 校验思想。
  • 按项目改写：核心 Wiki 路径、验证命令、GoAuto 多交付单元、安全红线、已有 #76 单人工作流和历史快照兼容边界。
  • 不采用：DevHarness 自身项目事实、任务记录、占位技术栈、未经证实的生产部署参数。
  • 冲突处理：GoAuto 更严格的付款、订单、设备、数据、真机和高风险确认规则保持不变。

预计修改：

  • AGENTS.md
  • .gitea/issue_template/task.md
  • dev_scripts/harness.py
  • tests/test_wiki_docs.py
  • wiki-docs.json
  • 新增 docs/templates/deployment.md Wiki 镜像
  • 按真实影响更新 Project-Profile、Development-Workflow、Local-Development-and-Verification、Common-Changes 及必要的 Home/Architecture 页面镜像

需求变化记录

日期 变化内容 原因 用户确认
2026-08-27 从旧基线增量升级到本地 DevHarness 当前明确提交 用户要求参考更新后的 DevHarness 是

设计与原型门禁

  • 修改类型：非 UI
  • 所需设计证据：工作流差异与结构校验设计
  • 状态：已确认
  • 无需 UI 原型或无需任何原型的原因：仅开发治理文档、模板和校验工具变化，不改变产品界面。

文档影响

  • 更新项目档案或本地开发与验证 Wiki
  • 更新开发工作流 Wiki
  • 更新常见修改 Wiki
  • 新增部署文档模板 Wiki
  • 不影响业务规则、架构、API 契约和产品需求，除非实施核对发现其入口文字必须同步；若发生则在评论记录。

交付文档影响

  • 无面向客户/岗位的交付文档影响，原因：本次是内部开发治理升级；部署模板不是 GoAuto 真实部署说明。

任务记录与可选快照

  • 单次任务事实来源：当前 Gitea 工单正文与评论
  • 默认不创建任务快照

验收标准

  • 项目档案记录完整新旧基线与适配说明。
  • 新增上游四类治理能力且不削弱 GoAuto 专用安全规则。
  • 工单模板与 Harness 校验一致。
  • 线上 Wiki 页面已回读并取得 revision，本地镜像一致。
  • Harness 单元测试、严格检查及差异检查通过。
  • 提交只包含本工单相关文件并回写证据。

验证方式

  • python -m unittest discover -s tests -v
  • python dev_scripts/harness.py check --strict
  • python dev_scripts/harness.py sync --check
  • git diff --check

风险和回退

  • 风险：直接复制上游会覆盖 GoAuto 专用安全门禁或写入模板占位事实；通过逐项增量合并、在线 Wiki 主源和结构测试控制。
  • 回退：Git 回退本工单提交；线上 Wiki 若需回退，使用实施前读取的页面内容与 revision，逐页恢复并重新同步。
## 基本信息 - 类型：文档 / 工作流升级 - 所属 Epic：无 - 所属 MVP / 版本：无 - 阶段：进行中 ## 依赖与并行 - 前置工单：无 - 是否允许与前置工单并行：是 - 原因：仅升级开发治理资料与 Harness 校验，不改变产品运行行为。 ## 子项目影响 - 仅影响的子项目 / 交付单元：shared-docs、DevHarness 工具与测试 - 是否跨子项目：否 - 是否修改共享接口或契约：否 - 各子项目需要执行的验证：Harness 单元测试、严格结构检查、Wiki 镜像一致性检查。 ## 原始需求 - 来源：用户对话 - 提出时间：2026-08-27 - 关键原话或脱敏摘要：本项目工作流程和文档参考 `D:\OPC\dev_harness` 生成；该仓库已更新，要求 GoAuto 参考其最新内容更新文档和工作流。 ## 要解决什么 - 当前代码事实：GoAuto 项目档案记录的可复现 DevHarness 基线为 `bfdf648962d11a8024f62768380d8571e1f45f68`；本地 DevHarness 当前提交为 `4bbacf4d7fb265984396bb5589c544105043fa0b`，区间共 13 个提交。GoAuto 已通过 #76 提前吸收上游 #25 的工单唯一任务事实源与按需快照原则，但尚未完整吸收 #24、#26、#27、#28。 - 目标契约 / 用户期望：以明确提交为基线增量合并上游治理变化，并按 GoAuto 事实改写。 - 假设与未确认项：不臆造生产部署拓扑；本次引入部署模板和落点规则，不创建包含未确认生产参数的部署实例页。 ## 做什么 / 不做什么 - 做： - 项目档案基线更新为 `4bbacf4d…`，记录旧基线、升级区间和 GoAuto 适配/不采用项。 - 增量合并 Gitea MCP 优先与最小工单读取规则。 - 将完整原型门禁改为“可访问且版本明确的线上原型默认审核；本地 HTML 仅在用户或项目规则明确要求时导出”，保留 GoAuto 已确认快照不可覆盖和安全清理规则。 - 增加 PowerShell、UTF-8 与 ExecutionPolicy 边界。 - 增加部署文档模板及映射，并规定 GoAuto 真实部署事实确认后建立 `Deployment-and-Operations`；不写占位生产参数。 - 更新单元工单模板、自然语言快捷指令、Harness 结构校验与测试。 - 先更新线上 Wiki并回读 revision，再同步本地镜像。 - 不做： - 不复制 DevHarness 的项目事实、历史工单、任务归档或占位值。 - 不改变 GoAuto 产品代码、API、数据库、状态机、权限、安全或采集/采购行为。 - 不发布、不部署，不修改真实环境。 - 不删除或覆盖既有已确认原型快照。 ## 已确认方案 上游差异分类： - 直接采用：Gitea MCP 优先与最小读取、PowerShell/UTF-8/ExecutionPolicy 边界、线上原型与按需导出语义、部署模板结构、工单模板字段及 Harness 校验思想。 - 按项目改写：核心 Wiki 路径、验证命令、GoAuto 多交付单元、安全红线、已有 #76 单人工作流和历史快照兼容边界。 - 不采用：DevHarness 自身项目事实、任务记录、占位技术栈、未经证实的生产部署参数。 - 冲突处理：GoAuto 更严格的付款、订单、设备、数据、真机和高风险确认规则保持不变。 预计修改： - `AGENTS.md` - `.gitea/issue_template/task.md` - `dev_scripts/harness.py` - `tests/test_wiki_docs.py` - `wiki-docs.json` - 新增 `docs/templates/deployment.md` Wiki 镜像 - 按真实影响更新 Project-Profile、Development-Workflow、Local-Development-and-Verification、Common-Changes 及必要的 Home/Architecture 页面镜像 ## 需求变化记录 | 日期 | 变化内容 | 原因 | 用户确认 | |---|---|---|---| | 2026-08-27 | 从旧基线增量升级到本地 DevHarness 当前明确提交 | 用户要求参考更新后的 DevHarness | 是 | ## 设计与原型门禁 - 修改类型：非 UI - 所需设计证据：工作流差异与结构校验设计 - 状态：已确认 - 无需 UI 原型或无需任何原型的原因：仅开发治理文档、模板和校验工具变化，不改变产品界面。 ## 文档影响 - [x] 更新项目档案或本地开发与验证 Wiki - [x] 更新开发工作流 Wiki - [x] 更新常见修改 Wiki - [x] 新增部署文档模板 Wiki - [ ] 不影响业务规则、架构、API 契约和产品需求，除非实施核对发现其入口文字必须同步；若发生则在评论记录。 ## 交付文档影响 - [x] 无面向客户/岗位的交付文档影响，原因：本次是内部开发治理升级；部署模板不是 GoAuto 真实部署说明。 ## 任务记录与可选快照 - 单次任务事实来源：当前 Gitea 工单正文与评论 - [x] 默认不创建任务快照 ## 验收标准 - [ ] 项目档案记录完整新旧基线与适配说明。 - [ ] 新增上游四类治理能力且不削弱 GoAuto 专用安全规则。 - [ ] 工单模板与 Harness 校验一致。 - [ ] 线上 Wiki 页面已回读并取得 revision，本地镜像一致。 - [ ] Harness 单元测试、严格检查及差异检查通过。 - [ ] 提交只包含本工单相关文件并回写证据。 ## 验证方式 - `python -m unittest discover -s tests -v` - `python dev_scripts/harness.py check --strict` - `python dev_scripts/harness.py sync --check` - `git diff --check` ## 风险和回退 - 风险：直接复制上游会覆盖 GoAuto 专用安全门禁或写入模板占位事实；通过逐项增量合并、在线 Wiki 主源和结构测试控制。 - 回退：Git 回退本工单提交；线上 Wiki 若需回退，使用实施前读取的页面内容与 revision，逐页恢复并重新同步。
ila commented 2026-08-27 17:45:10 +08:00
Author
Owner
Copy Link
Copy Source

实施完成，待验收

上游基线与适配

  • DevHarness 旧基线：bfdf648962d11a8024f62768380d8571e1f45f68
  • 新基线：4bbacf4d7fb265984396bb5589c544105043fa0b
  • 核对区间：13 个提交。
  • GoAuto 已通过 #76 提前吸收上游 #25 的工单唯一事实源原则，本次未重复迁移。
  • 本次增量吸收：
    • #24 部署文档模板和部署文档落点；
    • #26 Gitea MCP 优先与最小工单读取；
    • #27 线上原型默认审核、本地 HTML 按需导出；
    • #28 PowerShell UTF-8、Shell 与 ExecutionPolicy 边界。
  • 未复制 DevHarness 的项目事实、历史工单、任务归档、占位技术栈或未确认生产部署参数；GoAuto 的付款、订单、设备、数据、真机和高风险确认规则保持不变。

实现

  • 更新根 AGENTS.md、单元工单模板和自然语言快捷指令。
  • 更新 Harness 核心页面/必需文件/模板字段/治理规则校验，并增加回归测试。
  • 新增并映射 Deployment-Template；它明确不是当前生产部署说明，真实拓扑未确认前不得建立虚假实例页。
  • 项目档案记录新旧完整提交、升级区间和适配边界。
  • 开发工作流增加 Gitea 最小读取、线上原型与按需导出、部署文档落点。
  • 本地验证增加 PowerShell/UTF-8/ExecutionPolicy 边界；常见修改同步原型与部署规则。
  • 标准任务仍不创建任务归档；原型和任务快照都只在用户或项目规则明确要求时导出。

Wiki 与 revision

  • Project-Profile：5c3a304d160e52f23b94c54a127b0fb51333a8f4
  • Development-Workflow：3167457d79824afe532dd5560990af8a485a57d1
  • Local-Development-and-Verification：2fe9eeb9f4ac985423e02701108d2fac07377503
  • Common-Changes：b7d5520da954c544248e979c4ababb86d2784a43
  • Deployment-Template：389f09d292b0aa408f26f1967e33eec82d37cedf

以上页面均已在线回读；执行一轮 sync 和一轮 sync --check，镜像一致。

验证

  • python -m unittest discover -s tests -v：21 项通过。
  • python -m compileall -q dev_scripts tests：通过。
  • python dev_scripts/harness.py check --strict：通过。
  • python dev_scripts/harness.py sync --check：通过。
  • git diff --check：通过。
  • 未运行服务端/Web/Android 产品测试：本工单没有修改产品代码、运行接口、数据库或 UI。

提交与推送

  • 提交：2a44b50a537a9facaa4bbdf146462d278de165dd — docs(#114): upgrade DevHarness workflow baseline
  • 已推送到 origin/main，本地与远端 HEAD 一致。
  • 工作区只剩用户原有未跟踪文件 gitea.zip，未修改、未提交。

工单保持打开，等待用户验收。

## 实施完成，待验收 ### 上游基线与适配 - DevHarness 旧基线：`bfdf648962d11a8024f62768380d8571e1f45f68` - 新基线：`4bbacf4d7fb265984396bb5589c544105043fa0b` - 核对区间：13 个提交。 - GoAuto 已通过 #76 提前吸收上游 #25 的工单唯一事实源原则，本次未重复迁移。 - 本次增量吸收： - #24 部署文档模板和部署文档落点； - #26 Gitea MCP 优先与最小工单读取； - #27 线上原型默认审核、本地 HTML 按需导出； - #28 PowerShell UTF-8、Shell 与 ExecutionPolicy 边界。 - 未复制 DevHarness 的项目事实、历史工单、任务归档、占位技术栈或未确认生产部署参数；GoAuto 的付款、订单、设备、数据、真机和高风险确认规则保持不变。 ### 实现 - 更新根 `AGENTS.md`、单元工单模板和自然语言快捷指令。 - 更新 Harness 核心页面/必需文件/模板字段/治理规则校验，并增加回归测试。 - 新增并映射 `Deployment-Template`；它明确不是当前生产部署说明，真实拓扑未确认前不得建立虚假实例页。 - 项目档案记录新旧完整提交、升级区间和适配边界。 - 开发工作流增加 Gitea 最小读取、线上原型与按需导出、部署文档落点。 - 本地验证增加 PowerShell/UTF-8/ExecutionPolicy 边界；常见修改同步原型与部署规则。 - 标准任务仍不创建任务归档；原型和任务快照都只在用户或项目规则明确要求时导出。 ### Wiki 与 revision - Project-Profile：`5c3a304d160e52f23b94c54a127b0fb51333a8f4` - Development-Workflow：`3167457d79824afe532dd5560990af8a485a57d1` - Local-Development-and-Verification：`2fe9eeb9f4ac985423e02701108d2fac07377503` - Common-Changes：`b7d5520da954c544248e979c4ababb86d2784a43` - Deployment-Template：`389f09d292b0aa408f26f1967e33eec82d37cedf` 以上页面均已在线回读；执行一轮 `sync` 和一轮 `sync --check`，镜像一致。 ### 验证 - `python -m unittest discover -s tests -v`：21 项通过。 - `python -m compileall -q dev_scripts tests`：通过。 - `python dev_scripts/harness.py check --strict`：通过。 - `python dev_scripts/harness.py sync --check`：通过。 - `git diff --check`：通过。 - 未运行服务端/Web/Android 产品测试：本工单没有修改产品代码、运行接口、数据库或 UI。 ### 提交与推送 - 提交：`2a44b50a537a9facaa4bbdf146462d278de165dd` — `docs(#114): upgrade DevHarness workflow baseline` - 已推送到 `origin/main`，本地与远端 HEAD 一致。 - 工作区只剩用户原有未跟踪文件 `gitea.zip`，未修改、未提交。 工单保持打开，等待用户验收。
ila commented 2026-08-27 17:45:53 +08:00
Author
Owner
Copy Link
Copy Source

验收通过

  • 验收时间：2026-08-27（Asia/Shanghai）
  • 验收结论：用户明确确认 #114 验收通过。
  • 长期文档影响：实施阶段已完成 Wiki 更新、在线回读与镜像一致性检查；本次验收未产生新的长期事实，不重复同步 Wiki。
  • 工单处理：关闭单元工单；本工单无所属 MVP/Epic，无需同步父工单。
## 验收通过 - 验收时间：2026-08-27（Asia/Shanghai） - 验收结论：用户明确确认 #114 验收通过。 - 长期文档影响：实施阶段已完成 Wiki 更新、在线回读与镜像一致性检查；本次验收未产生新的长期事实，不重复同步 Wiki。 - 工单处理：关闭单元工单；本工单无所属 MVP/Epic，无需同步父工单。
ila closed this issue 2026-08-27 17:45:53 +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#114