Files
road-compiler/.trellis/tasks/09-08-junction-reference-fidelity/research/preview-small-optimization.md
T

32 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 小范围预览优化(2026-09-14)
用户取消 300ms 硬门槛,要求明显提速、任务简洁、避免大改;正式修改前必须完成内部试验。
## 本次边界
先试验两处等价优化:
- direct-edit-solver.js:cluster selection 不构造最终必然被过滤掉的 road/junction/lane 手柄,所有约束仍完整求解。
- native-road.js:trimLineBeforeFirstControl 每条线建立按 minX 排序的碰撞候选包围盒,仍使用原精确 ringsOverlap、原采样步长和原裁切回退。
不接入子路网裁剪,不增加接口/客户端协议、跨请求缓存、版本失效机制或新依赖。模型缓存节省远小于标线裁切,本轮先减少扫描和无用派生计算,避免扩大状态管理风险。源数据、保存与正式编译契约保持原样。
验收:真实四节点/21m工作区,新旧完整 resolution 与 compiled 深比较;多类非空编辑确实 applied;现有几何与编辑回归;记录整接口计算和序列化耗时。若通过,可作为独立提交候选,用户复核后提交。
## 前序子路网试验
318条道路缩到12/32/56条,20次宽度调整的图层多重集合增删变化均一致。12条方案计算+序列化中位数338ms,样本P95 448ms;32条453ms;56条592ms。比较不包含非图层元数据,耗时不含增量提取与浏览器显示,尚不足以发布通用局部编译。因此仅保留研究,不纳入这次产品修改。
## 结果与正式实现
隔离原型完成 3 轮 × 7 场景,共 21 次新旧深比较:空文档、宽度、过渡长度、方向、位置、圆角、停止线。全部完整 resolution(含 Map、手柄、状态、诊断)与 compiled(全部图层及非图层产物)一致;所有非空编辑确实 applied。旧计算中位数 2199.3ms,新原型 1198.2ms。当前真实样本未发布 cluster-crossing-inset 手柄,未冒称该编辑参与此差分试验;已有设施回归另行通过。
试验通过后仅修改两个生产文件,增加一个完整求解结果不受手柄筛选影响的回归。生产实现与原型算法相同,只作格式和局部变量整理。
真实 editPreview 接口复测(独立运行,没有与测试并发):原先两次热运行计算+JSON序列化 2552/2512ms;优化后 1623/1556ms,平均下降约37%。模型解析仍68–71ms;resolver从306–313ms降至7–10ms;全量几何从1951–1997ms降至1303–1368ms。响应仍24,185,780字节。本报告不是浏览器输入到绘制完成延迟,未测网络和地图更新;3次接口样本不报告P95。
检查:新增求解器回归通过;npm test 前序全部代码、几何、编辑API、导入编译检查通过,最后 test/fixtures.js 仍是已有快照差异,未更新基线。首次沙箱内监听8899失败,取得工具批准后在沙箱外重跑得到上述结果。npm run test:client、npm run format:check、git diff --check 通过。无客户端改动,未重复E2E。
原始数据:preview-prototype-results.jsonl、preview-optimized-api.jsonl、preview-scope-results.jsonl。重跑差分:BASELINE_ROOT 指向6a8f026检出及其依赖,从当前仓库运行 node .trellis/tasks/09-08-junction-reference-fidelity/research/preview-equivalence-experiment.cjs。
本轮未提交。优化单元完成;父任务保持进行中。后续是否进一步缩短传输和渲染等待,应先测浏览器,不直接扩展本轮范围。