fdm/使用说明.md

78 lines
3.3 KiB
Markdown
Raw Permalink 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.

# 造境 · FDM 智能制造演示台
## 打开页面
本地生产预览地址:`http://127.0.0.1:4178`。
```powershell
npm.cmd install
npm.cmd run build
npm.cmd run preview
```
开发模式:`npm.cmd run dev`,地址为 `http://127.0.0.1:5178`。
这是纯前端可视化项目,无后端、无数据库,不发送打印机控制命令。字体与依赖均打包在本地;运行后不需要联网获取素材。
## 演讲演示
1. 使用桌面浏览器打开页面,点击右上角全屏按钮。
2. 默认展示《春节序曲》原始路径,可播放、暂停、拖动进度、逐指令前进或调整倍速。
3. 点击“FDM 成型示例”,展示独立生成的 100 层褶光花器;支持层数跳转。
4. “开始演示”重置当前模式并循环回放。原始路径使用 1 倍速,成型示例使用 60 倍速。
5. 三维窗口支持鼠标旋转、滚轮缩放、三维、俯视和正视,以及自动环绕、喷头显隐、完整路径显隐和图片导出。
6. 底部三项技术可打开详情;快拆喷头提供抬升概念示意。
桌面布局验证尺寸为 1920×1080、1440×900、1366×768 和 1280×720,浏览器缩放为 100%。较窄屏幕转为纵向排布,不承诺一屏显示。
## 数据边界
- 原文件来自 `F:\Downlaods\春节序曲.gcode`,副本位于 `public/data/spring-festival.gcode`,未修改原文件内容。
- 原文件共 232 行,包含 230 条有效运动指令、1 次 1 秒停顿,以及回零指令。
- 总路径约 158.644 mm,按指令进给速度估算约 29.009 秒;不包含真实回零耗时、加减速、通信与设备延迟。可视化假设回零位置为原点。
- 原文件无 E 轴挤出与温控指令,因此不显示真实打印层数,不将其渲染成虚构的实体打印结果。
- 花器是独立程序生成的 FDM 概念示例,不属于《春节序曲》原始文件。三维喷头也为概念结构,而非产品 CAD。
- 温控曲线全部为模拟数据,未连接真实传感器。图片中的激光熔池描述已调整为适用于 FDM 的热端温控概念。
- 70%、90% 等指标来源于用户提供的展示材料,未经过本项目实测验证。
- 当前回放针对提供文件的 G0/G1 直线运动,支持 G4、G20/G21、G28、G90/G91、G92、M82/M83 及温控设定解析;不提供任意文件导入。G2/G3 圆弧会产生不支持警告,不应作为通用机器指令执行器使用。
## 文件结构
```text
src/
main.js
lib/
gcode.js
playback.js
views/
Dashboard/
Dashboard.html
Dashboard.js
Dashboard.css
Scene.js
scripts/
prepare-data.js
verify-browser.js
tests/
gcode.test.js
public/data/
dist/
artifacts/
```
`prepare-data.js` 使用 `gcode-parser` 库解析源指令并生成播放数据;场景使用 Three.js,交互图标使用 Lucide。
## 验证
```powershell
npm.cmd test
npm.cmd run build
node scripts/verify-browser.js
```
浏览器验证需要预览服务运行。验证脚本使用本机已有的独立无头 Chromium;其他机器可通过 `BROWSER_PATH` 环境变量指定可执行文件路径。
测试截图与报告保存于 `artifacts/`。移动宽度仅作自动布局和像素检查,不替代 Mobile Preview 插件真机预览。
工作目录初始为空且无 Git 仓库或远程地址,因此未执行 Git 提交和推送。