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