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

[DOCS] 同步三项目协调 E2E 运行与排障文档 #171

New Issue
Closed
opened 2026-08-31 20:55:10 +08:00 by ila · 3 comments
ila commented 2026-08-31 20:55:10 +08:00
Owner
Copy Link
Copy Source

状态

已完成（2026-08-31 用户验收通过；PR #172 已合入 dev@5adee5c）

基本信息

  • 类型：长期文档同步
  • 主项目：YoVision
  • 主 agent：单一 coordination/docs agent
  • 所属 Epic：#7
  • 所属 MVP：#156
  • 来源：已验收工单 #155 与用户明确指令
  • 前置：#155 已验收并通过 PR #170 合入 dev@0276bce

目标

把 #155 已验证的三项目协调 E2E 单入口、隔离边界、故障覆盖、清理/秘密扫描和明确未验证范围写入 Gitea Wiki 长期事实源，在线回读 revision 后同步对应核心镜像，为 MVP #156 验收提供稳定运行与排障入口。

范围

  • 更新 Wiki Deployment-and-Operations：协调 E2E 的用途、前置工具、默认完整命令、调试参数、临时 PostgreSQL/随机身份/进程归属和清理边界。
  • 更新 Wiki Local-Development-and-Verification：从仓库根执行的唯一命令、阶段组成、成功判据、三端独立回归及未验证边界。
  • 更新 Wiki Troubleshooting：依赖缺失、迁移失败、端口/残留进程、Bell 有状态测试并发污染、秘密扫描和安全保留临时诊断的处理顺序。
  • 每页更新后在线回读完整正文与 revision。
  • 运行 python dev_scripts/harness.py sync、sync --check、check --strict，提交生成镜像。
  • 完成后执行 MVP #156 集成验收，但不代替人工验收或自行关闭 MVP。

非目标

  • 不修改 Sense、Brain、Bell、contracts 或 E2E 脚本。
  • 不改变接口、配置、部署行为、权限、安全策略或测试逻辑。
  • 不写入任何真实 token、密码、Cookie、私钥、生产地址或客户数据。
  • 不创建任务归档，不更新与 #155 无关的 Wiki 页面。

精确 write_paths

  • Gitea Wiki：Deployment-and-Operations、Local-Development-and-Verification、Troubleshooting
  • docs/delivery/deployment-and-operations.md
  • docs/04-local-development-and-verification.md
  • docs/06-troubleshooting.md

禁止写入其他 Git 路径。

验收标准

  • 三个 Wiki 页面准确记录 #155 已验证事实，且不夸大真实 GPU、真机、16 路或生产验证结论
  • 默认命令为 pwsh scripts/e2e/coordination/run-coordination-e2e.ps1，成功判据明确
  • -SkipIndependentProductE2E 明确仅供 harness 调试，不能作为 #155/MVP 验收
  • 记录动态端口、Sense/Bell 独立随机数据库 owner/database、随机测试身份、秘密扫描和只清理所属资源
  • 记录 Bell 有状态数据库测试必须串行，避免跨包并行生成额外评估事实
  • 三页均在线回读取得新 revision，核心镜像同步一致
  • DevHarness strict、镜像 check 和 Git diff check 通过
  • MVP #156 验收命令重新运行并记录真实结果

风险与回退

风险是文档命令与已合并脚本不一致、泄露测试凭据或夸大验证范围。写入前以 dev@0276bce 脚本和 #155 证据为准；仅写变量名和随机/临时边界。回退使用 Wiki revision 恢复三个页面，再重新同步镜像。

文档影响

本工单本身即长期文档闭环；Gitea Wiki 是主源，docs/04-local-development-and-verification.md、docs/06-troubleshooting.md、docs/delivery/deployment-and-operations.md 是生成镜像。

## 状态 已完成（2026-08-31 用户验收通过；PR #172 已合入 `dev@5adee5c`） ## 基本信息 - 类型：长期文档同步 - 主项目：YoVision - 主 agent：单一 coordination/docs agent - 所属 Epic：#7 - 所属 MVP：#156 - 来源：已验收工单 #155 与用户明确指令 - 前置：#155 已验收并通过 PR #170 合入 `dev@0276bce` ## 目标 把 #155 已验证的三项目协调 E2E 单入口、隔离边界、故障覆盖、清理/秘密扫描和明确未验证范围写入 Gitea Wiki 长期事实源，在线回读 revision 后同步对应核心镜像，为 MVP #156 验收提供稳定运行与排障入口。 ## 范围 - 更新 Wiki `Deployment-and-Operations`：协调 E2E 的用途、前置工具、默认完整命令、调试参数、临时 PostgreSQL/随机身份/进程归属和清理边界。 - 更新 Wiki `Local-Development-and-Verification`：从仓库根执行的唯一命令、阶段组成、成功判据、三端独立回归及未验证边界。 - 更新 Wiki `Troubleshooting`：依赖缺失、迁移失败、端口/残留进程、Bell 有状态测试并发污染、秘密扫描和安全保留临时诊断的处理顺序。 - 每页更新后在线回读完整正文与 revision。 - 运行 `python dev_scripts/harness.py sync`、`sync --check`、`check --strict`，提交生成镜像。 - 完成后执行 MVP #156 集成验收，但不代替人工验收或自行关闭 MVP。 ## 非目标 - 不修改 Sense、Brain、Bell、contracts 或 E2E 脚本。 - 不改变接口、配置、部署行为、权限、安全策略或测试逻辑。 - 不写入任何真实 token、密码、Cookie、私钥、生产地址或客户数据。 - 不创建任务归档，不更新与 #155 无关的 Wiki 页面。 ## 精确 write_paths - Gitea Wiki：`Deployment-and-Operations`、`Local-Development-and-Verification`、`Troubleshooting` - `docs/delivery/deployment-and-operations.md` - `docs/04-local-development-and-verification.md` - `docs/06-troubleshooting.md` 禁止写入其他 Git 路径。 ## 验收标准 - [x] 三个 Wiki 页面准确记录 #155 已验证事实，且不夸大真实 GPU、真机、16 路或生产验证结论 - [x] 默认命令为 `pwsh scripts/e2e/coordination/run-coordination-e2e.ps1`，成功判据明确 - [x] `-SkipIndependentProductE2E` 明确仅供 harness 调试，不能作为 #155/MVP 验收 - [x] 记录动态端口、Sense/Bell 独立随机数据库 owner/database、随机测试身份、秘密扫描和只清理所属资源 - [x] 记录 Bell 有状态数据库测试必须串行，避免跨包并行生成额外评估事实 - [x] 三页均在线回读取得新 revision，核心镜像同步一致 - [x] DevHarness strict、镜像 check 和 Git diff check 通过 - [x] MVP #156 验收命令重新运行并记录真实结果 ## 风险与回退 风险是文档命令与已合并脚本不一致、泄露测试凭据或夸大验证范围。写入前以 `dev@0276bce` 脚本和 #155 证据为准；仅写变量名和随机/临时边界。回退使用 Wiki revision 恢复三个页面，再重新同步镜像。 ## 文档影响 本工单本身即长期文档闭环；Gitea Wiki 是主源，`docs/04-local-development-and-verification.md`、`docs/06-troubleshooting.md`、`docs/delivery/deployment-and-operations.md` 是生成镜像。
ila commented 2026-08-31 20:56:22 +08:00
Author
Owner
Copy Link
Copy Source

开始实施（2026-08-31）：从 dev@0276bceab5004efdf9713039bf48091c62ee9263 建立 docs/171-coordination-e2e-wiki。仅更新工单声明的三个 Wiki 页面和三个生成镜像；以 #155 已合并脚本、完整 E2E 通过证据及明确未验证边界为依据，不修改产品、契约或测试入口。

开始实施（2026-08-31）：从 `dev@0276bceab5004efdf9713039bf48091c62ee9263` 建立 `docs/171-coordination-e2e-wiki`。仅更新工单声明的三个 Wiki 页面和三个生成镜像；以 #155 已合并脚本、完整 E2E 通过证据及明确未验证边界为依据，不修改产品、契约或测试入口。
ila commented 2026-08-31 21:27:34 +08:00
Author
Owner
Copy Link
Copy Source

最终实施证据（2026-08-31）

差异与事实源

  • 已在线更新并完整回读 Wiki：
    • Deployment-and-Operations revision c376d69227aa159a7839a829f5bfb5a7beaf89e6
    • Local-Development-and-Verification revision 889ffccc30a998a5cc8c4a5d91af3c72771c093a
    • Troubleshooting revision eec4beb8e5b9b8ff18401b272fd249aff7711509
  • 已由 Wiki 同步三个核心镜像：docs/delivery/deployment-and-operations.md、docs/04-local-development-and-verification.md、docs/06-troubleshooting.md。
  • 记录默认完整入口、阶段与成功判据、临时 PostgreSQL/身份/秘密隔离、Bell 有状态测试串行边界、清理归属和故障排查；未修改产品、契约或测试代码。

验证

  • python dev_scripts/harness.py sync --check：通过。
  • python -m unittest discover -s tests -v：48 项通过。
  • python dev_scripts/harness.py check --strict：通过。
  • git diff --check：通过。
  • pwsh scripts/e2e/coordination/run-coordination-e2e.ps1：退出码 0；最终输出 COORDINATION_E2E passed。
  • 默认完整 E2E 内：Sense isolated E2E 通过；Brain 74 passed；Bell isolated E2E 通过；测试拥有的进程和临时资源已清理。

提交与评审

  • 提交：d4de462、a69ef62。
  • PR：#172，目标分支 dev，当前可合并。
  • 分支：docs/171-coordination-e2e-wiki。

未验证边界

  • 未覆盖真实 GPU/生产模型、真实摄像头/厂商环境、生产迁移、16 路长时间运行及现场网络副作用；文档未将这些内容声明为已验证。

状态：待人工验收。未创建任务归档。

## 最终实施证据（2026-08-31） ### 差异与事实源 - 已在线更新并完整回读 Wiki： - `Deployment-and-Operations` revision `c376d69227aa159a7839a829f5bfb5a7beaf89e6` - `Local-Development-and-Verification` revision `889ffccc30a998a5cc8c4a5d91af3c72771c093a` - `Troubleshooting` revision `eec4beb8e5b9b8ff18401b272fd249aff7711509` - 已由 Wiki 同步三个核心镜像：`docs/delivery/deployment-and-operations.md`、`docs/04-local-development-and-verification.md`、`docs/06-troubleshooting.md`。 - 记录默认完整入口、阶段与成功判据、临时 PostgreSQL/身份/秘密隔离、Bell 有状态测试串行边界、清理归属和故障排查；未修改产品、契约或测试代码。 ### 验证 - `python dev_scripts/harness.py sync --check`：通过。 - `python -m unittest discover -s tests -v`：48 项通过。 - `python dev_scripts/harness.py check --strict`：通过。 - `git diff --check`：通过。 - `pwsh scripts/e2e/coordination/run-coordination-e2e.ps1`：退出码 0；最终输出 `COORDINATION_E2E passed`。 - 默认完整 E2E 内：Sense isolated E2E 通过；Brain `74 passed`；Bell isolated E2E 通过；测试拥有的进程和临时资源已清理。 ### 提交与评审 - 提交：`d4de462`、`a69ef62`。 - PR：#172，目标分支 `dev`，当前可合并。 - 分支：`docs/171-coordination-e2e-wiki`。 ### 未验证边界 - 未覆盖真实 GPU/生产模型、真实摄像头/厂商环境、生产迁移、16 路长时间运行及现场网络副作用；文档未将这些内容声明为已验证。 状态：待人工验收。未创建任务归档。
ila closed this issue 2026-08-31 21:43:50 +08:00
ila commented 2026-08-31 21:43:50 +08:00
Author
Owner
Copy Link
Copy Source

验收结论（2026-08-31）：用户明确回复“#171 验收通过”。PR #172 已合入 dev，合并提交 5adee5c3b40b037cbfbb4508e12a066e9fbe6099；三个 Wiki revision 与生成镜像、完整协调 E2E 和未验证边界均沿用最终证据评论。工单关闭，未创建任务归档。

验收结论（2026-08-31）：用户明确回复“#171 验收通过”。PR #172 已合入 `dev`，合并提交 `5adee5c3b40b037cbfbb4508e12a066e9fbe6099`；三个 Wiki revision 与生成镜像、完整协调 E2E 和未验证边界均沿用最终证据评论。工单关闭，未创建任务归档。
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 project/bell project/brain project/sense 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#171