Pascal Editor
Pascal 实践构想:可解释的场景修复与版本实验室
设计展示图修复前后、GPU 回退和过期写入决策的学习项目,使用有目的的图解与可选空间交互。
你将学会
- 让看不见的数据变化可见
- 只为空间问题增加三维交互
- 把图形验收连接到持久状态
开始前需要
- 基础场景图、JavaScript 和 HTTP 知识
- 尺寸与关系具有明确预期的自有小场景
解释实现边界,复现本章检查清单或窄范围图练习。
先看结论
- 将修复决策和原始图一起展示。
- 三维用于空间查看,二维用于状态变化。
- 把已验收修订连接到重开检查。
让看不见的数据变化可见
值得尝试的学习项目可以并排展示导入前场景、修复决策、结果图与视觉预览。这是编辑构想,不是 Pascal 宣布的路线图。学习者应能指出哪段墙被删除、哪个引用已经过期,以及为什么某个父节点仍有歧义。
先使用源码探针已有的确定性样例:没有子节点的零长度墙、挂门的墙、重复子引用,以及一个或两个父级声明。保留原输入,将修复计数与模式警告分开展示。修复动画不能暗示尚未解决的冲突已经自动消失。
只为空间问题增加三维交互
这里可选 Three.js 视图确有用途:旋转小墙体与开口、切换堆叠和分离楼层,或检查退化宿主墙被保留的几何。图差异和版本时间线仍以二维更清晰。按问题选择不同表示,能丰富内容,而不必让每篇文章都变成沉重演示。
图形不支持或用户减少动态效果时,仍提供静态 SVG 和文字结果。只有用户请求时才加载交互模块,使用自有资源并在退出时释放。它们是拟议实验室的设计要求,不表示本篇已经交付或测试完整交互应用。
把图形验收连接到持久状态
再设计一个版本练习:两个读取者看到版本三,其中一个保存版本四,另一个过期写入者收到冲突,而不是静默覆盖。把通过验收的修订连接到重新打开的场景及明确产物结论,不用本地存储 published 标记替代公网部署证据。
只有预期结果可复现、不支持情况可见、源码版本和测试范围明确时,实验室才算完成。现有证据覆盖纯图与 slug 函数,以及模拟渲染编排;完整 SQLite、编辑器和 GPU 运行尚未执行。学习项目应展示不同证据层次,不把所有绿勾说成同等验证。
实施步骤
- 1
创建已知损坏的自有小图。
- 2
分开展示原始、修复和未解决状态。
- 3
增加带静态回退的可选空间查看。
- 4
将过期写入和重开作为独立集成层测试。
可复制示例
{"proposal":"场景修复与版本实验室","staticFallbackRequired":true,"interactiveDemoShipped":false,"sourceHelperProbeExecuted":true,"actualGpuRuns":0,"upstreamRoadmapClaim":false}常见问题
这篇文章已经包含交互实验室了吗?
没有。它是扩展构想,文章提供静态图和可执行窄范围样例,不冒充完整编辑器演示。
为什么同时使用二维和三维解释?
几何查看适合旋转,图归属、修复决策和版本冲突则更适合示意图与时间线。
资料来源
- README.md来源核查 2026-09-08
- LICENSE来源核查 2026-09-08
- packages/cli/package.json来源核查 2026-09-08
- packages/core/package.json来源核查 2026-09-08
- packages/viewer/README.md来源核查 2026-09-08
- packages/cli/src/runtime.ts来源核查 2026-09-08
- packages/cli/src/editor-process.ts来源核查 2026-09-08
- packages/cli/src/mcp-connector.ts来源核查 2026-09-08
- packages/mcp/src/transports/http.ts来源核查 2026-09-08
- packages/mcp/src/storage/sqlite-scene-store.ts来源核查 2026-09-08
- packages/core/src/store/use-scene.ts来源核查 2026-09-08
- packages/viewer/src/components/renderers/node-renderer.tsx来源核查 2026-09-08
- packages/viewer/src/lib/renderer-capability.ts来源核查 2026-09-08
- packages/core/src/validation/validate-build-json.ts来源核查 2026-09-08
- packages/core/src/utils/heal-scene-graph.ts来源核查 2026-09-08
- packages/mcp/src/storage/slug.ts来源核查 2026-09-08