# 2026-08-07 — v0.8.0 平台化升级（P0+P1+P2 全量推进）

> 本次版本对应外部审查报告《Awesome-Gaussian-Skills_审查报告与能力平台升级路线》提出的 P0/P1/P2 全部里程碑。
> 核心变化：从"论文目录 + 技能包"升级为"知识层 → 能力层 → 评测层 → 编排层"四层能力平台。

## P0 — 可信度修复（全部完成）

### 单一数据源
- 新增 `scripts/build_knowledge_base.py`：合并 CSV / docs/index.html METHODS / docs/abstracts.js 四套历史载体为单一真源 `data/methods.json`
- 清除 5 个经 arXiv 原文核验确证的伪造条目（虚构方法名挂在真实 arXiv ID 上）：GS-LRM-v2、GS-LRM-full、MVSplat-v2、GPSGaussian-Stereo、GaussianCross
- 同 arXiv ID 别名合并 9 对（如 VG2GT→VG²GT、GGD-SLAM-ICRA→GGD-SLAM、DENSER→DENSR）
- 类别归一：历史 87/44 种标签归一到 23 个规范 taxonomy（data/categories.json）
- 前沿批次补齐 14 条经 arXiv 原文核验的真条目（VGGT/CUT3R/Spann3R/MonST3R/NoPoSplat/Flash3D/CAT3D/Splatt3R/ReconFusion/pixelSplat/MVSplat/LatentSplat/GS-LRM/PhysGaussian/Shape of Motion/4DGen/DreamGaussian4D/TC4D/Comp4D/GSMem）
- 重新生成全部下游载体：CSV（784 行）/ index.html METHODS（783 条）/ abstracts.js（783 键，移除 71% 占位假文）

### 数据 CI
- 新增 `scripts/validate_knowledge_base.py`：去重 / arXiv 格式 / 类别规范 / 黑名单 / 三载体计数一致
- 新增 `.github/workflows/knowledge-ci.yml`：push/PR 触发离线校验，每周定时在线抽样核验 arXiv 可达性

### 数字对齐
- 全库统一：783+ 方法 / 23 类别 / 15 技能 / 104 bug 模式 / 60 运行时模式 / 40+ 转换方法
- 修复 README 技能表编号（两个 6、缺 7）→ 1-15 连续
- 合并 Roadmap 中两条同名 v0.3.6 矛盾条目；README_CN 版本号与英文对齐
- 类别明细表从 29 行重新生成，与 23 taxonomy 一致

### 事实错误修正（arXiv 外部核验）
- code-reviewer 学习率表（position 0.0016→0.00016，opacity 0.005→0.05，scale 0.00005→0.005，与 INRIA 官方实现对齐）
- paper-reader 3DGS 基线 PSNR ~25.2→27.21 dB（原论文 Table 1）
- baselines.md Scaffold-GS venue ICCV 2023→CVPR 2024 Highlight；Bonfire→Bonsai；Mip-NeRF 360 场景数 8→9
- cad-mesh methods-database DeepCAD CVPR'21→ICCV'21；CSGNet NeurIPS'21→CVPR'18
- methods-core.md NegGS arXiv 2405.14786→2405.18163；3DGS 基线 25.2→27.21/0.795/0.252
- 在线书 spatial-embodied-intelligence.html：RT-2 arXiv 2307.16518→2307.15818；V-JEPA 2 2506.09947→2506.09985；SplaTAM 标题修正；时间线 RT-2 2024.01→2023.07
- method-compare 轴值表损坏修复（\x07 控制字符替换了 a，导致 pplication/ll）
- articulated-reasoner 删除虚构的"穿透惩罚基准"数据表（78%/62%/91% 等无出处数字），改为诚实的 λ 扫描流程
- paper-reader RGS 归属修正（非 Relightable GS，实为 CBCT 残差 GS）
- 三处 venue 漂移保守化（Fake3DGS/GaussianPile/VEDAL 标注"venue 待核实"）
- runtime-bug-patterns.md "108+ static code bugs"→104

### 仓库卫生
- 确认个人 docx / ~$ 锁文件 / 新建文件夹 已被 .gitignore 覆盖，不会污染开源仓库

## P1 — 能力闭环（全部完成）

### 真渲染回路（P1-6）
- `renderer-bridge.ts` 重写：HTTP + WebSocket 同端口（:9842），HTTP 提供 /scenes/* 与 /exports/* 文件服务（路径穿越防护）
- 多客户端支持 + hello 握手协议（renderer: gsplat | three-points，capabilities 声明）
- `import_scene` 导入后序列化规范 PLY 到 .temp/scenes/，通过 HTTP 服务，发送 `load_gaussians_url`——gsplat.js 渲染器执行真排序+alpha 合成
- 三个渲染器页面全部升级到完整协议：gsplat-renderer.html（真 3DGS）、renderer.js（修复二进制 JSON.parse 崩溃）、renderer.html（hello + 未知消息回 pong）
- WS Origin 白名单（RENDERER_ORIGINS，默认仅 localhost 源）

### 场景状态服务化（P1-7）
- scene_id 服务端权威返回，bridge gs-mcp-client 不再本地伪造 `scene-${Date.now()}`
- 场景索引持久化：`saveIndex` / `loadIndex` 写入 .temp/scenes/index.json，重启后按原 id 惰性恢复
- `loadFromPlyFile` 支持 keepId 参数（恢复时保持 id 稳定）

### 工具治理（P1-8）
- `export_result` 真实序列化：新增 `exporters.ts`，PLY（标准 3DGS 62 属性布局，opacity→logit / scale→log / SH DC 反变换）+ SPLAT（32B/splat）格式，写盘并返回 URL
- `prune_by_importance` 五种策略真实分发：sparsity（小+不透明）/ dog（结构带通）/ coreset（体素覆盖）/ gradient（颜色对比代理）/ variational（置信度代理）；preserve_regions 改为完全豁免
- `cast_ray` 网格加速：均匀网格索引 + 沿射线步进采样候选体素，从 O(N) 降到 O(steps×candidates)；描述改为诚实（球体近似，非 DDF-GS）
- `import_scene` 路径白名单（sceneRoots）+ 512MB 上限 + 解析失败默认报错（allow_synthetic_fallback 显式 opt-in）
- `modify_gaussians` 安全门：>10% 影响必须 confirm=true
- 新增 `validate.ts`：零依赖运行时校验（asString/asNumber/asVec3/resolveSafePath 等），全部 handler 经 guarded 包裹
- 13 个实验工具移入 experimentalTools，默认不列出（INCLUDE_EXPERIMENTAL=1 显式），描述明确标注 NOT IMPLEMENTED
- `query_spatial_context` 真实实现（P2-14）：体素聚类 scene_graph + 成对空间关系 + 点对测量
- `resolve_voice_command` 真实实现：包装 voice-intent 的 23 条意图映射

### 安全基线（P1-9）
- bridge render-server：CORS 从全开改为白名单（ALLOWED_ORIGINS）；STUDIO_TOKEN 可选 Bearer 鉴权（/api/*，SSE 放行）；移除启动时 kill -9 / Stop-Process 强杀端口逻辑
- toonflow-client：移除源码硬编码 admin/admin123，仅从 TOONFLOW_USER/TOONFLOW_PASS 读取
- vendor/3dgs-renderer.ts：修复三个不存在的端点（/api/render/frame→/api/render/direct 或 /single，/api/render/status→/api/render/tasks，/api/render/animation→/single+renderConfig）；补充 axios 受保护引用

### 质量地基（P1-10）
- 21 项单元测试（node:test，零额外依赖）：PLY 解析（sigmoid/exp/SH 反变换）、5 种 prune 策略、网格射线、空间上下文、PLY/SPLAT 导出往返、意图映射、参数校验、路径穿越
- `.github/workflows/ci.yml`：mcp-server 构建 + 测试 + bridge 构建 + 知识库校验

## P2 — 平台化（脚手架完成）

### Benchmark 竞技场（P2-11）
- `bench/metrics.py`：纯 numpy PSNR/SSIM + 可选 LPIPS（eval_impl: bench-metrics/1.0.0）
- `bench/run_eval.py`：renders/ vs gt/ 配对评测，生成 [S] 来源条目
- `bench/leaderboard.json`：6 条带来源的种子记录（全部 [A]，3DGS/NegGS/Scaffold-GS 在 T&T 与 Mip-NeRF 360）
- `bench/README.md`：四级来源标注（A/C/S/E）+ 协议透明原则 + 收录优先级

### 技能编排层（P2-12）
- `skills/_contracts/`：三份 JSON Schema（paper-insight / comparison-report / experiment-plan）
- `scripts/validate_skill_contract.py`：零依赖 JSON Schema 子集校验器 + 示例自检（正向 PASS / 反向正确报 FAIL）
- `scripts/router_load.py`：Router manifest 真实加载器（解析 manifest.yaml → 轴值校验 → 片段存在性检查 → 可选 emit 拼接上下文），三个 Router 技能全部可用
- 标准流水线定义：paper-reader →(paper-insight)→ method-compare →(comparison-report)→ experiment-planner →(experiment-plan)→ bench/run_eval

## 验证
- TypeScript 编译：mcp-server + bridge 全部通过（strict: true）
- 单元测试：21/21 PASS
- 知识库校验：PASS（783 方法，无重复名/ID，无黑名单条目，三载体计数一致）
- 契约校验：3/3 示例 PASS，负向用例正确 FAIL
- Router 加载器：3/3 技能可用，轴值/片段存在性校验生效

## 未完成（下一版本）
- Spec-First Sculpting 三工具仍为规格（SKILL.md 定义，代码 0%），v0.8.0 已如实标注"NOT IMPLEMENTED, do not call"
- 自动训练+评测流水线需 GPU 环境（gsplat/diff-gaussian-rasterization CUDA sidecar）
- 在线排行榜页面（docs/index.html leaderboard tab 读取 bench/leaderboard.json）
- v1.0 CI/CD 多框架官方收录、v2.0 多 Agent 协作