fdm/演讲验收说明.md

46 lines
4.5 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 演讲验收说明
本文适用于当前《鸡你太美》714 层演示版本;早期《春节序曲》说明仅保留作历史资料。
## 打开方式
- 公网优先:`https://odacm.cn`,不同设备独立操作,不同步播放进度。
- 临时公网备用:`http://47.108.78.12`。这是未加密的演示页面,不用于输入密码或敏感信息;域名访问失败时可尝试此入口。
- 本地备用:双击 `artifacts/FDM完整演讲版.exe`,程序默认打开 `http://127.0.0.1:9999`。旧的 `FDM演讲面板.exe` 保留,但不作为本次验收版本。
- 局域网:保持程序窗口运行,平板连接相同网络,访问窗口列出的电脑局域网地址和 `9999` 端口。Windows 防火墙如弹出提示,仅对可信专用网络允许访问。访客网络隔离或防火墙拦截会导致平板无法连接。
- 本地程序内嵌页面、字体和打印数据,不需要安装 Node.js、Go,也不需要互联网下载素材。关闭程序窗口会停止服务。
- 端口被占用时可用 `FDM完整演讲版.exe -listen 0.0.0.0:10000`;不要结束其他不相关程序。
## 验收顺序
1. 打开公网,等待真实字节进度、无损解码、完整性校验及几何初始化完成;随后一次性展示完整数据。不显示抽样占位模型,也不在演示期间补下载路径。
2. 01:点击“流程演示”,观察多模态汇聚、逐层剖切、300 层路径规划、逐层沉积反馈;可暂停、前后切换。
3. 在普通路径页面点击“本层慢放”,核对黄色已走线、喷嘴亮点、原始行号和坐标;绿色表示已经完成的外壳。模型高度随打印进度变化,不代表数据缺失;拖动至第 714 层可看完整成品。勾选全部路径可同时显示内部轨迹。
4. 02:点击拆开、复装,观察 12 个部件的名称、结构和选中详情。
5. 03:观察熔融区和沉积动画,分别点击温降、过热、欠挤出,比较状态、料线、加热和进给变化;复位后恢复。
6. 投影使用横屏及全屏模式。桌面目标分辨率为 1280×720 及以上;小屏转为纵向布局,不保证一屏完整展示。
## 加载与技术边界
- 全量路径采用可逆整数差分与字节重排压缩;原始运动指令逐条保留,通过偏移索引按需解码文字,不构造百万条 JSON 对象。
- 路径及指令压缩传输合计约 16.55 MiB,Worker 负责下载、解压和校验,主线程完成几何初始化后才显示画面。资源使用版本化长缓存,再次打开可复用浏览器缓存,但每次仍执行完整加载与校验。
- “完整数据已就绪”后,当前打开页面的路径播放不再依赖网络;不承诺公网断网刷新仍可打开,离线备用请使用 EXE。
- 原始文件含 936,561 个运动段、714 层;回放为线性进给估时,不含真实加减速、通信或 Klipper 宏动作。
- 多模态建模为概念动画,不调用模型生成服务;材料参数来自既有切片,不重新切片。
- 快拆结构为演示模型,非产品 CAD。03 为 FDM 熔融区与沉积模拟,不是金属激光熔池,也不是实时传感器数据。
- 本项目无数据库,不需要清库;不向真实打印机发送控制指令。
- 按要求不配置证书自动续期;证书到期前需要人工更换。
## 部署结构
公网 80 跳转 HTTPS,443 由 Nginx 终止 TLS 并反代到回环地址 `127.0.0.1:9999`。Linux 程序通过 systemd 运行,所有静态资源内嵌。旧静态发布和配置备份保留,以便回退。
自动测试和截图位于 `artifacts/`;窄屏自动布局检查不能替代真实平板和 Mobile Preview 插件验收。
## 旧版实测记录(已被用户否决,不用于完整版验收)
- 公网 HTTPS 独立浏览器冷启动:首屏可操作 1.07 秒,完整路径后台就绪 45.12 秒。完整路径就绪后,断开网络但不刷新页面,层跳转、播放和技术演示通过。
- Windows 内嵌程序:本机浏览器首屏 0.48 秒,完整路径 3.23 秒;本机通过 WLAN 地址访问健康接口成功。尚未用另一台实体平板验收。
- 公网不同链路存在差异:独立浏览器 HTTPS 成功,命令行部分请求返回阿里云备案拦截页或 TLS 断连;服务器内部证书和反代正常。需要核实阿里云备案/接入状态,并用演讲现场网络确认。
- 上述是单次实测,不承诺任何网络都能秒开。完整数据仍约数十 MB,优化的是首屏和按需加载,不是删除真实路径。