Files
MapLibreParticleLab/docs/50_Step记录/STEP-096_V13隔离盲审_v1.md
tei b5c1c4879a
Some checks failed
validate-scripts / validate-scripts (push) Has been cancelled
docs: deliver isolated blind V13 audit STEP-096
2026-09-25 21:31:27 +09:00

5.0 KiB
Raw Permalink Blame History

STEP-096 V13 隔离盲审 v1

状态与范围

状态:完成(仅隔离盲审文档交付)。日期:2026-09-25。

本阶段按当前任务书独立读取隔离快照源码和当前规范,形成调查、Step 与完成报告。完成不表示 V13 构建、测试、GPU 画面或性能通过。未做代码修复,后续验证全部 NOT RUN。

输入与可核实环境

项目 事实及限制
唯一工作目录 /Users/tei/dev/MapLibreParticleV13Blind096
机器观察值 Mac-mini-tei.lan
目标导出 SHA ee0b89e711bf01335b3aa71d36def785cd97fec3,来自任务书;未用 Git 对象独立核验
版本声明 manifest:revision 13,RN/Android 13.4.1-particle.13,iOS 6.28.0-particle.13
产物 sourceCommit 声明 ddf20dec9fe9cd05b77274827b6825829500dd5a,不作为本快照 HEAD
当前 branch / Git HEAD / clean / remote NOT AVAILABLE;本轮未运行 Git
实际 TUI、screen、模型和 effort 启动记录 NOT AVAILABLE;未访问目录外配置、会话日志或终端回放补证

已读取 AGENTS.md、PARTICLE_BASELINE.md、docs/00_项目规范/、总则 README 及所列当前有效总则,包括当前基线与开发路线 v2,以及本任务。当前总则中的旧发布坐标与快照 .13 声明分开记录,不重写总则或历史。未打开外部路径、历史调查/Step/完成报告、既有审查材料或开发日志;本轮输出目录只用于写入和检查本轮三份新稿。

只读过程

  1. 从公开 API 和目录建立 Style/分段、Renderer/gfx、场 ingress/runtime、平台 bridge 与 GPU 数据路径地图。
  2. 追踪正常、拒绝、fallback、失效和销毁路径,区分 owner、共享不可变快照与 GPU 资源;对候选寻找反例,不按问题数量补齐。
  3. 阅读 C++、GLSL、Metal、Android、iOS、RN、测试源码和配置;核对公开 PLAY 调用方、纹理更新条件、attachment 状态、CRC/容量、线程派发与同步点。
  4. 排除颜色投影仅看第一分量、强引用环、关闭缓存同步遗漏、纯重排遗漏等未成立候选;保留粒子独立前置更新门槛的完整证据。
  5. 写入三份中文报告;对本轮新稿进行文件存在、相对链接、引用行号和行尾空格的轻量静态检查。未启动构建、测试 runner、设备或 profiler。

结果

调查形成 13 条独立 finding:P1 四条(B01、B02、B06、B13),P2 九条;无 P0。类型为确定缺陷七条、源码确定成本四条、设计限制两条。这里的“确定”限定源码控制流/数值语义,不代表已发生用户事故;全部运行效果 NEEDS_RUNTIME。

主要正确性证据为跨渲染目标 stencil 记录、Metal depth/stencil clear 请求传递、encoded 播放推进、粒子完整内容身份、8-bit 零值和 Mercator 度量、retained 失败提交。成本和设计限制涉及 Metal 同步等待、资源重复分配、重复物化、UI 同步处理、共享地理 mask 与 store 总预算。每条的条件、精确路径/行号、反例、影响边界、安全修复与验证方案见调查报告。

三份交付文件

文件 内容
调查报告 架构地图、B01—B13 证据、反例、性能模型、覆盖缺口、验证矩阵、分批建议
本 Step 记录 范围、输入、只读过程、结果、未运行验证、后续责任
Codex 完成报告 交付状态、发现索引、证据质量、边界与移交方案

未运行验证与阻塞

  • CMake/Ninja/Xcode/Gradle、编译、链接、codegen、打包:NOT RUN。
  • C++/GL/Metal/Jest 测试、设备安装/启动、GPU capture、性能与内存测量:NOT RUN。
  • Git 状态、commit、push、远端核对和产物公网回读:NOT RUN。
  • 外部仓库、上游差异、真实安装环境、历史日志、启动配置:NOT AVAILABLE。

这些是任务约束和证据边界,不阻塞文档交付;它们阻止把本报告升级为运行态或发布验收。未确认 Vulkan 全链、全部图层组合及竞态行为,详见调查覆盖缺口。源码未写入;没有 Git diff 或导出对象逐文件比对证据,不声称已核验工作树 clean。

下一步与停止

Codex 在三份报告自检后停止,不继续修复、追加开发日志或解盲比较。RDC 随后冻结三份原稿的 SHA-256 与时间,独立移交正式仓库同路径、追加 粒子开发记录.md,执行四文件 scoped commit/push 和远端核查;这些动作本轮均未执行。新代码任务优先处理 B01/B02/B06/B13,并补 B12 失败恢复;其余数值/域语义和性能/容量工作按调查报告分批推进。验证场景和已有 runner 的定向执行命令已写入调查报告,交由后续 RDC 阶段执行。