fdm/演讲验收说明.md

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，优化的是首屏和按需加载，不是删除真实路径。