26 lines (20 loc) · 1.43 KB

Pigsty SIM

浏览器端等轴测 LEGO 风 3D 数字孪生:解析 Pigsty pigsty.yml,把 HA PostgreSQL 部署渲染为一座会呼吸的科技之城。

必读

完整设计规格:docs/DESIGN.md —— 定稿态(v0.4.0)的设计策略、布局/布线数值、动效系统、页面逻辑与工程纪律,详细到可以据此重建整个作品。 做任何微调之前先读它,尤其是「九、工程纪律」一章的不变量:

共享材质做动画前必须 clone;
signalGeom 副通道:函数顶部清空、消费方必须晚于 rails.rebuild;
全场景遍历用 scene.traverse(rails.group 与 root 平级);
从旧提交恢复代码要复查已删特性是否复活;
python 补丁必须 assert 旧串存在;
一条线一个合并 Mesh;band 材质双面;标签浮离表面 ≥0.12;
headless 截图:--enable-unsafe-swiftshader + still=1,大场景黑帧先重试 (PIL 亮度 >30 有场景 / ~24 黑帧),永远不要先怀疑场景代码。

常用

构建 npm run build;预览 npm run preview(:4173)
截图: "Google Chrome" --headless --enable-unsafe-swiftshader --run-all-compositor-stages-before-draw --window-size=1600,1000 --hide-scrollbars --virtual-time-budget=10000 --screenshot=out.png "http://localhost:4173/?still=1&lang=en"
URL 调试参数见 DESIGN.md 第八章(preset/lang/theme/yaw/zoom/focus/select/promote/layers/power/still)
沟通:与作者(Vonng)用简体中文;UI 文案双语