ila/yovision
1
0
Fork 0
Code Issues 14 Pull Requests 14 Actions Packages Projects Releases Wiki Activity

[ARCH] 同步 DevHarness 最新工作流与文档基线 #108

New Issue
Closed
opened 2026-08-27 16:56:02 +08:00 by ila · 3 comments
ila commented 2026-08-27 16:56:02 +08:00
Owner
Copy Link
Copy Source

状态

已完成

基本信息

  • 类型：根级工作流与文档迁移
  • 任务类型：协调任务
  • 主项目：仓库级 DevHarness
  • 主 agent：协调 agent
  • 子项目影响：不修改 Sense、Brain、Bell 产品代码
  • 前置工单：无
  • 是否允许并行：可以；本任务只取得下列根级 Harness、Wiki 与镜像路径

原始需求与追溯

  • 来源：用户对话
  • 提出时间：2026-08-27
  • 关键摘要：当前项目由 D:\OPC\dev_harness 生成；上游更新后，同步更新当前项目的文档和工作流。
  • 用户已于 2026-08-27 确认差异分析与迁移方案，并要求“建工单并做”。

基线

  • DevHarness 来源：https://git.ilapage.cn/OPC/dev_harness
  • 当前采用基线（由初始导入文件 blob 对照确认）：f23c2cf81f9792495f696d49e88d79b16cf29810
  • 目标基线：4bbacf4d7fb265984396bb5589c544105043fa0b
  • 目标提交主题：docs: 规范 PowerShell UTF-8 与执行策略 (#28)

目标

把 YoVision 的 DevHarness 工具、工作流规则、工单模板和长期 Wiki 文档迁移到目标基线，同时完整保留 YoVision 的三项目并行、分支治理、GoAdmin 基线、共享写路径和 UI 复用等项目专用门禁。

非目标

  • 不修改 Sense/**、Brain/**、Bell/** 或 contracts/** 产品实现。
  • 不复制 DevHarness 自身的产品事实、示例任务归档或项目状态。
  • 不删除现有 docs/task/** 和 prototypes/** 历史资产。
  • 不在本工单进行全仓库换行符批量规范化。
  • 不改变任何产品运行行为、数据库或部署状态。

已确认方案

  1. 引入统一入口 dev_scripts/harness.py，替代三个旧命令脚本。
  2. 合并上游 AGENTS/CLAUDE/README/工单模板规则，保留全部 YoVision 项目专用内容。
  3. 把现有 GoAdmin 专用严格校验迁入统一 Harness。
  4. 工单正文与评论作为单次任务事实源；docs/task/ 改为按明确要求导出的可选历史快照。任务页退出核心固定映射，但现有文件保留。
  5. 保留 YoVision 现有 Product-Requirements 页面和原型资产，只补充新版要求。
  6. 增加部署模板，并为已有常驻 Sense 服务补充 YoVision 部署与运维长期页面。
  7. 仅补齐 #66、#67 历史快照的结构字段以通过新版严格校验，不改变任务结论。
  8. 添加 .gitattributes，不执行全仓库 renormalize。

设计证据

  • UI 原型：不适用。
  • 替代技术设计：用户已确认的 DevHarness 差异分析和本工单方案。
  • 原因：仅变更开发工作流、文档和内部工具，不改变产品界面或交互。

write_paths

  • AGENTS.md
  • CLAUDE.md
  • README.md
  • .gitattributes
  • .gitignore
  • .gitea/issue_template/task.md
  • dev_scripts/**
  • tests/**
  • wiki-docs.json
  • docs/**

禁止写入：Sense/**、Brain/**、Bell/**、contracts/**、goadmin-baseline.json。

长期文档影响

更新 YoVision Wiki 的项目档案、开发工作流、架构与代码地图、业务规则与术语、本地开发与验证、常见修改、故障排查、文档初始化/既有项目接入、产品需求、交付指南和模板；新增部署模板及部署与运维页面。所有本地 docs/ 改动必须由 Wiki 回读后导出。

风险与回退

  • 风险：覆盖项目专用规则、遗漏旧命令引用、任务快照来源边界变化、换行符产生大范围无关差异。
  • 控制：逐段合并、保留专用校验、全库检查旧命令引用、不删除历史快照、不运行 renormalize。
  • 回退：撤销本任务分支/PR；Wiki 页面按实施前 revision 恢复，不删除页面。

验收标准

  • 统一 Harness 命令可执行，旧命令引用已迁移。
  • YoVision 项目专用规则和 GoAdmin 校验完整保留。
  • 核心 Wiki 映射与可选任务快照边界符合新规则，现有历史快照未删除。
  • DevHarness 来源、旧/新完整 commit 和项目适配写入项目档案。
  • 部署模板与适用于现状的部署运维页面存在。
  • python dev_scripts/harness.py check --strict 通过。
  • python dev_scripts/harness.py sync --check 通过。
  • python -m unittest discover -s tests -v 通过。
  • git diff --check 通过。
  • 改动经任务分支提交、推送并通过 PR 合回 dev，工单停在待验收。

未验证边界

不验证 Sense/Brain/Bell 产品运行、现场部署或生产环境；本任务不改变这些行为。

## 状态 已完成 ## 基本信息 - 类型：根级工作流与文档迁移 - 任务类型：协调任务 - 主项目：仓库级 DevHarness - 主 agent：协调 agent - 子项目影响：不修改 Sense、Brain、Bell 产品代码 - 前置工单：无 - 是否允许并行：可以；本任务只取得下列根级 Harness、Wiki 与镜像路径 ## 原始需求与追溯 - 来源：用户对话 - 提出时间：2026-08-27 - 关键摘要：当前项目由 `D:\OPC\dev_harness` 生成；上游更新后，同步更新当前项目的文档和工作流。 - 用户已于 2026-08-27 确认差异分析与迁移方案，并要求“建工单并做”。 ## 基线 - DevHarness 来源：`https://git.ilapage.cn/OPC/dev_harness` - 当前采用基线（由初始导入文件 blob 对照确认）：`f23c2cf81f9792495f696d49e88d79b16cf29810` - 目标基线：`4bbacf4d7fb265984396bb5589c544105043fa0b` - 目标提交主题：`docs: 规范 PowerShell UTF-8 与执行策略 (#28)` ## 目标 把 YoVision 的 DevHarness 工具、工作流规则、工单模板和长期 Wiki 文档迁移到目标基线，同时完整保留 YoVision 的三项目并行、分支治理、GoAdmin 基线、共享写路径和 UI 复用等项目专用门禁。 ## 非目标 - 不修改 `Sense/**`、`Brain/**`、`Bell/**` 或 `contracts/**` 产品实现。 - 不复制 DevHarness 自身的产品事实、示例任务归档或项目状态。 - 不删除现有 `docs/task/**` 和 `prototypes/**` 历史资产。 - 不在本工单进行全仓库换行符批量规范化。 - 不改变任何产品运行行为、数据库或部署状态。 ## 已确认方案 1. 引入统一入口 `dev_scripts/harness.py`，替代三个旧命令脚本。 2. 合并上游 AGENTS/CLAUDE/README/工单模板规则，保留全部 YoVision 项目专用内容。 3. 把现有 GoAdmin 专用严格校验迁入统一 Harness。 4. 工单正文与评论作为单次任务事实源；`docs/task/` 改为按明确要求导出的可选历史快照。任务页退出核心固定映射，但现有文件保留。 5. 保留 YoVision 现有 Product-Requirements 页面和原型资产，只补充新版要求。 6. 增加部署模板，并为已有常驻 Sense 服务补充 YoVision 部署与运维长期页面。 7. 仅补齐 #66、#67 历史快照的结构字段以通过新版严格校验，不改变任务结论。 8. 添加 `.gitattributes`，不执行全仓库 renormalize。 ## 设计证据 - UI 原型：不适用。 - 替代技术设计：用户已确认的 DevHarness 差异分析和本工单方案。 - 原因：仅变更开发工作流、文档和内部工具，不改变产品界面或交互。 ## write_paths - `AGENTS.md` - `CLAUDE.md` - `README.md` - `.gitattributes` - `.gitignore` - `.gitea/issue_template/task.md` - `dev_scripts/**` - `tests/**` - `wiki-docs.json` - `docs/**` 禁止写入：`Sense/**`、`Brain/**`、`Bell/**`、`contracts/**`、`goadmin-baseline.json`。 ## 长期文档影响 更新 YoVision Wiki 的项目档案、开发工作流、架构与代码地图、业务规则与术语、本地开发与验证、常见修改、故障排查、文档初始化/既有项目接入、产品需求、交付指南和模板；新增部署模板及部署与运维页面。所有本地 `docs/` 改动必须由 Wiki 回读后导出。 ## 风险与回退 - 风险：覆盖项目专用规则、遗漏旧命令引用、任务快照来源边界变化、换行符产生大范围无关差异。 - 控制：逐段合并、保留专用校验、全库检查旧命令引用、不删除历史快照、不运行 renormalize。 - 回退：撤销本任务分支/PR；Wiki 页面按实施前 revision 恢复，不删除页面。 ## 验收标准 - [x] 统一 Harness 命令可执行，旧命令引用已迁移。 - [x] YoVision 项目专用规则和 GoAdmin 校验完整保留。 - [x] 核心 Wiki 映射与可选任务快照边界符合新规则，现有历史快照未删除。 - [x] DevHarness 来源、旧/新完整 commit 和项目适配写入项目档案。 - [x] 部署模板与适用于现状的部署运维页面存在。 - [x] `python dev_scripts/harness.py check --strict` 通过。 - [x] `python dev_scripts/harness.py sync --check` 通过。 - [x] `python -m unittest discover -s tests -v` 通过。 - [x] `git diff --check` 通过。 - [x] 改动经任务分支提交、推送并通过 PR 合回 `dev`，工单停在待验收。 ## 未验证边界 不验证 Sense/Brain/Bell 产品运行、现场部署或生产环境；本任务不改变这些行为。
ila added the kind/taskpriority/p0scope/coordination labels 2026-08-27 16:56:02 +08:00
ila commented 2026-08-27 17:09:43 +08:00
Author
Owner
Copy Link
Copy Source

实施记录（2026-08-27）：Gitea MCP 可正常处理核心 Wiki，但读取/更新 Task-66-Sense视频接入与Profile、Task-67-Sense视频服务生命周期与状态对账 时把中文 sub_url 百分号再次编码，GET 返回 404。为完成已确认的历史快照结构兼容修复，将仅对这两个已存在页面回退使用 Gitea API；凭据仍只从 .codex/gitea.env/进程环境读取，不写入命令输出、工单或仓库。更新后会在线回读 revision 并由 harness.py export 导出。

实施记录（2026-08-27）：Gitea MCP 可正常处理核心 Wiki，但读取/更新 `Task-66-Sense视频接入与Profile`、`Task-67-Sense视频服务生命周期与状态对账` 时把中文 `sub_url` 百分号再次编码，GET 返回 404。为完成已确认的历史快照结构兼容修复，将仅对这两个已存在页面回退使用 Gitea API；凭据仍只从 `.codex/gitea.env`/进程环境读取，不写入命令输出、工单或仓库。更新后会在线回读 revision 并由 `harness.py export` 导出。
ila commented 2026-08-27 17:22:35 +08:00
Author
Owner
Copy Link
Copy Source

最终实施证据（待验收）

结果

  • DevHarness 已由 f23c2cf81f9792495f696d49e88d79b16cf29810 迁移到 4bbacf4d7fb265984396bb5589c544105043fa0b。
  • 新统一入口：dev_scripts/harness.py（check、sync、archive、export）。
  • YoVision 三项目写路径、explore/main/dev、GoAdmin 固定基线、默认模块精简和 UI 复用门禁均已保留并纳入测试。
  • wiki-docs.json 只保留 19 个核心映射；现有历史快照未删除，任务快照默认按需导出。
  • 新增 Deployment-Template 和 Deployment-and-Operations；没有修改 Sense、Brain、Bell、contracts 产品实现。
  • #66/#67 历史快照只补充可由提交/PR核对的“修改文件”和标准“未验证部分”字段，未改变验收结论。
  • 按新版默认策略，未为 #108 创建任务快照。

Wiki 回读与镜像

核心页面均已在线回读并通过 sync --check：

  • Home 8ba2aba01f28
  • Project-Profile 5e6d18991d69
  • Development-Workflow b377b601b040
  • Architecture-and-Code-Map ee5b5507bf8a
  • Business-Rules-and-Glossary 96fca4d2aa41
  • Local-Development-and-Verification 7ede95108304
  • Common-Changes becaa9f08fd0
  • Troubleshooting 046624c1b2d7
  • New-Project-Documentation-Setup 66d63c1e43de
  • Existing-Project-Adoption-Guide 54e7c774b679
  • Product-Requirements e912a1ca1410
  • Requirements-Migration-Matrix 3e430119f84e
  • Multi-Agent-Collaboration cc4031224ddd
  • Product-Roadmap 2d5b8550109a
  • Delivery-Documentation-Guide 5b295898612f
  • Audience-Document-Template 2b44e14c41aa
  • Deployment-and-Operations 367c6aed6eae
  • Deployment-Template 75bd653ab2f3
  • Task-Archive-Template 08fe74e95b01

兼容快照 revision：#66 87b3a59f3f27；#67 718765b6b8ef。对应镜像提交为 a3d1bdf。

Git / PR

  • Harness 与规则提交：266bf23
  • Wiki 镜像提交：a3d1bdf
  • PR：#109
  • 合入 dev：b37c35009623d807bc00e869a1148c0d2e303931
  • 本地 dev 与 origin/dev 一致，工作区干净。
  • Gitea 合并 API 实际成功但返回空响应，已通过 PR merged=true 和远端 dev SHA 双重确认。

验证

  • python dev_scripts/harness.py check --strict：通过。
  • python dev_scripts/harness.py sync --check：19 个核心页面全部一致。
  • python -m unittest discover -s tests -v：48 项通过。
  • git diff --check：通过。
  • 合并到 dev 后重新执行严格检查和 48 项测试：通过。

未验证部分

未运行 Sense、Brain、Bell 产品、真机、现场部署或生产环境；本工单没有修改产品运行行为。

## 最终实施证据（待验收） ### 结果 - DevHarness 已由 `f23c2cf81f9792495f696d49e88d79b16cf29810` 迁移到 `4bbacf4d7fb265984396bb5589c544105043fa0b`。 - 新统一入口：`dev_scripts/harness.py`（`check`、`sync`、`archive`、`export`）。 - YoVision 三项目写路径、`explore/main/dev`、GoAdmin 固定基线、默认模块精简和 UI 复用门禁均已保留并纳入测试。 - `wiki-docs.json` 只保留 19 个核心映射；现有历史快照未删除，任务快照默认按需导出。 - 新增 `Deployment-Template` 和 `Deployment-and-Operations`；没有修改 Sense、Brain、Bell、contracts 产品实现。 - #66/#67 历史快照只补充可由提交/PR核对的“修改文件”和标准“未验证部分”字段，未改变验收结论。 - 按新版默认策略，未为 #108 创建任务快照。 ### Wiki 回读与镜像 核心页面均已在线回读并通过 `sync --check`： - Home `8ba2aba01f28` - Project-Profile `5e6d18991d69` - Development-Workflow `b377b601b040` - Architecture-and-Code-Map `ee5b5507bf8a` - Business-Rules-and-Glossary `96fca4d2aa41` - Local-Development-and-Verification `7ede95108304` - Common-Changes `becaa9f08fd0` - Troubleshooting `046624c1b2d7` - New-Project-Documentation-Setup `66d63c1e43de` - Existing-Project-Adoption-Guide `54e7c774b679` - Product-Requirements `e912a1ca1410` - Requirements-Migration-Matrix `3e430119f84e` - Multi-Agent-Collaboration `cc4031224ddd` - Product-Roadmap `2d5b8550109a` - Delivery-Documentation-Guide `5b295898612f` - Audience-Document-Template `2b44e14c41aa` - Deployment-and-Operations `367c6aed6eae` - Deployment-Template `75bd653ab2f3` - Task-Archive-Template `08fe74e95b01` 兼容快照 revision：#66 `87b3a59f3f27`；#67 `718765b6b8ef`。对应镜像提交为 `a3d1bdf`。 ### Git / PR - Harness 与规则提交：`266bf23` - Wiki 镜像提交：`a3d1bdf` - PR：#109 - 合入 `dev`：`b37c35009623d807bc00e869a1148c0d2e303931` - 本地 `dev` 与 `origin/dev` 一致，工作区干净。 - Gitea 合并 API 实际成功但返回空响应，已通过 PR `merged=true` 和远端 `dev` SHA 双重确认。 ### 验证 - `python dev_scripts/harness.py check --strict`：通过。 - `python dev_scripts/harness.py sync --check`：19 个核心页面全部一致。 - `python -m unittest discover -s tests -v`：48 项通过。 - `git diff --check`：通过。 - 合并到 `dev` 后重新执行严格检查和 48 项测试：通过。 ### 未验证部分 未运行 Sense、Brain、Bell 产品、真机、现场部署或生产环境；本工单没有修改产品运行行为。
ila commented 2026-08-27 17:29:52 +08:00
Author
Owner
Copy Link
Copy Source

用户验收

  • 验收结论：通过
  • 确认时间：2026-08-27
  • 用户原话：#108通过验收
  • 验收基线：PR #109，合并提交 b37c35009623d807bc00e869a1148c0d2e303931
  • 文档处理：本次验收未产生新的长期事实；核心 Wiki 与镜像已在待验收阶段完成并验证一致，因此不重复更新 Wiki。
  • 任务快照：按当前 DevHarness 默认策略不创建，用户未要求专项快照。
## 用户验收 - 验收结论：通过 - 确认时间：2026-08-27 - 用户原话：`#108通过验收` - 验收基线：PR #109，合并提交 `b37c35009623d807bc00e869a1148c0d2e303931` - 文档处理：本次验收未产生新的长期事实；核心 Wiki 与镜像已在待验收阶段完成并验证一致，因此不重复更新 Wiki。 - 任务快照：按当前 DevHarness 默认策略不创建，用户未要求专项快照。
ila closed this issue 2026-08-27 17:29:59 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
area/ux
UI/UX 与交互原型
 kind/epic
长期产品目标
 kind/mvp
可独立验收的最小版本
 kind/task
单元实施任务
 priority/p0
首个纵切必需能力
 project/bell
Bell 项目
 project/brain
Brain 项目
 project/sense
Sense 项目
 scope/coordination
跨项目协调任务
 scope/independent
不依赖其他项目在线的项目内任务
No labels kind/task priority/p0 scope/coordination
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ila/yovision#108