ykcheungab b37c861254 文档：刷新架构报告的指标与结论（app_window 拆分已落地） ...

- What: `docs/architecture/studio-architecture.md` 的数字与结论按当前源码重扫后刷新：
  - 分层图/纯文本图：`app_window` 3044 → **2309 行 / fan-out 37**，并新增一层
    "②b Studio 控制器"（session_controller 437 / replay_controller 641 / view_layout 398 /
    display_prefs 227）；领域服务与共享层的行数一并更新（replay 291、calibration_service 194、
    coordinator 619、camera 238、view 757、asset_source 256、gl_backend 870；
    shared scene3d 4565 / acquisition 2627 / record 3008 / force 3057 / 基础设施 1507）。
  - 边界规则：模块数 89（studio 32 + shared 57）→ **94（studio 37 + shared 57）**，环 0 个不变。
  - 指标表：新增 `replay_controller`(641) 与 `session_controller`(437) 两行，并写明
    "app_window 的 fan-out 仍是最高（37），因为它本来就是装配器——但规则已经不在它里面"。
  - 生产面/验证面：studio 生产 14 655 行、shared 14 764、测试 15 639（shared 7226/334 项 +
    studio 8413/310 项）、工具 4046（ui_check 3401）；验证面 19.7k > 生产面 14.7k。
  - 评估第 1 条与"一句话结论"改写为：上帝对象已按职责拆开，并**诚实记账**留下的东西——
    约 40 个过渡转发（给 tests/`ui_check` 的桥，属过渡层）、仍留在窗口的预览与 2D 渲染
    （它们同时属于面板与相机），以及 fan-out 从 36 升到 37 的原因。
  - 建议表第 1 条标记为已完成（写清五个去处与新增 41 项控制器单测），新增第 1b 条
    "下次改动顺手删掉对应转发"，并补第 7 条"真机与 ARM 验收"（本机无设备/板卡，是当前最大空白）。
- What: `studio-architecture.svg` / `.png` 由 `.repro/make_studio_svg.py` 重新生成：
  窗口框改为"2309 行 · 158 方法 · fan-out 37 · 装配 + 信号转发"，右侧四个控制器小框，
  面板/服务/共享层/验证面的行数与测试项数同步；底部结论改为"已按职责拆开 + 剩下的胶水"。
  顺带修好 `svg_to_png.py` 里写死的 1560×1180（现在读 SVG 自己的尺寸），否则海报加高后会被裁掉。
- Why: 这份报告是"判断组织是否合理"的依据，数字或结论一旦过期就会误导决策；
  拆分改变最大的一处正是它第 1 条风险与第 1 条建议，必须同步。
- Verification: 图表脚本重跑无异常（SVG well-formed，PNG 1560×1210 已目视检查）；
  同批源码的验证为 pytest 644 passed / 0 failed / 15 skipped（offscreen）、
  tools/ui_check.py 587 项 0 失败、.repro/locale_check.py 0 缺失。
- Not in this change: 不改代码；不改 `.repro` 下的扫描脚本口径（仍以扫描输出为准）。

2026-09-15 10:02:37 +08:00

294 KiB

1560x1210px

Raw Permalink History