从订单进入，到打印与发货完成。

01 · 开始使用

快速开始

产品由桌面客户端和独立打印节点共同组成。首次使用建议按下面的顺序完成。

1. 1
   获取对应平台安装包

   日常操作电脑安装 macOS 或 Windows 客户端；生产现场另选一个打印节点安装包。

2. 2
   安装桌面客户端

   客户端连接云端业务服务，负责订单、成员、文件绑定、任务分配和经营数据操作。

3. 3
   安装并配置打印节点

   节点可运行在 Windows、macOS 或 Linux Docker。打开本机设置页，先选择文件保存路径。

4. 4
   登录管理员账号

   管理员可以创建成员、设置金额可见性，以及分配订单、打印、发货和用户管理权限。

5. 5
   扫描并配对打印节点

   在客户端打印页面扫描局域网节点，输入设置页显示的六位配对码。

6. 6
   添加打印机

   由已配对的节点扫描局域网设备，选择打印机并输入设备访问码。

7. 7
   同步或新建订单

   私域订单可以手动录入，也可按需连接已支持的电商平台。

8. 8
   绑定并发送打印文件

   文件经局域网直接上传到打印节点，再完成机型与耗材映射并发送 G-code。

02 · 账户

登录与连接

保持登录状态

勾选“保持登录状态”后，当前设备的登录凭证最多保留 15 天。凭证失效时，应用会立即返回登录页面，不继续展示订单或客户信息。

云端业务连接

桌面客户端默认通过 HTTPS 连接万方实验室云端。订单、账号和授权走云端，打印文件与打印机流量走本地节点，两条链路彼此独立。

03 · 打印节点

安装独立打印节点

打印节点是独立于桌面客户端的常驻服务。它负责保存源文件、加密保存打印机访问码，并处理 MQTT、FTPS、相机和打印结果同步。

五个安装包

客户端和打印节点可以安装在同一台电脑，也可以把节点部署在另一台长期在线的设备上。没有 NAS 也能使用。

Windows 与 macOS 节点

1. 安装打印节点包，完成系统服务注册。
2. 在节点本机打开设置页。
3. 填写文件保存目录的绝对路径并保存。
4. 保持节点运行，再到桌面客户端扫描与配对。

Linux Docker 节点

Docker 节点需要使用 host 网络，以便客户端通过 UDP 发现节点，并让节点访问局域网打印机。部署时挂载独立的数据目录与打印文件目录，同时设置自己的凭证加密密钥。

• TCP 19530：节点设置、配对、文件与打印操作。
• UDP 19531：桌面客户端在局域网内发现节点。
• 必须挂载节点数据目录和打印文件目录，避免容器更新后数据丢失。
• BAMBU_CREDENTIAL_KEY 需要为每个部署独立生成并妥善保管。

扫描与六位配对码

1. 让桌面客户端和打印节点位于同一局域网。
2. 在客户端打印页面点击扫描打印节点。
3. 选择发现的节点，输入设置页或节点控制台显示的六位配对码。
4. 配对成功后，旧配对码立即失效并自动生成新码。

配对后，客户端会保存节点授权，节点也会获得当前账户的云端同步配置。无需公网 IP、端口映射或从互联网访问节点。

04 · 日常工作

订单管理

订单工作台以客户 ID 为第一识别信息，商品详情显示在下一行。不同来源的订单会按标签区分；完成对应平台授权后，即可同步已支持的电商订单。

订单状态

点击订单顶部的状态标签即可切换状态。即使误点“已发货”，仍然可以在已发货页面改回其他状态。

新建私域订单

1. 点击“新增订单”。
2. 选择订单来源并填写客户 ID、商品详情、规格、金额和收货信息。
3. 需要优先生产时打开“加急”。加急订单会置顶并以红色强调。
4. 保存后进入订单详情绑定打印文件。

补发订单

在已发货订单上打开操作菜单并选择“补发”。系统会生成新的待打印任务，并在订单工作台标记“补发”，原发货记录仍然保留。

批量操作

进入选择模式后可以同时删除多笔订单或批量修改状态。删除订单前应确认其打印文件是否仍需保留。

05 · 生产文件

打印文件

源文件通过局域网从桌面客户端直接上传到已配对的打印节点，不经过云端大文件中转。云端只接收任务绑定、解析结果、缩略图引用和运行所需的必要元数据。

支持的文件

未切片的 3MF 可以绑定订单和解析打印盘，但在分配打印任务时只能选择已经切片的 G-code。

拖入文件

1. 打开订单详情。
2. 把文件拖入上传区域，或点击区域后从访达/文件资源管理器选择。
3. 客户端通过局域网把源文件上传到当前打印节点配置的保存目录。
4. 等待缩略图、打印时间、机型和耗材信息完成解析。
5. 多盘 3MF 会拆成多个打印盘任务，但文件页面仍保留并下载原始 3MF。

命名与归档

系统按日期创建目录，并使用客户、颜色和耗材重新命名文件。

同一客户在当天只有一个文件时，文件直接保存在日期目录；出现多个文件时，系统会自动建立以客户 ID 命名的子目录。删除至仅剩一个文件后，剩余文件会自动移回日期目录。

06 · 打印现场

打印监控

先在客户端连接一个打印节点，再由该节点通过 MQTT、FTPS 和相机服务直连局域网内的拓竹打印机。客户端本身不会保存打印机访问码。

添加打印机

1. 确认打印节点已配对，并与打印机处于同一个局域网。
2. 进入打印页面，由当前节点扫描设备。
3. 选择发现的打印机，输入设备访问码。
4. 确认名称、型号、序列号和在线状态后保存。访问码会加密写入节点本地数据库。

发送打印任务

1. 从待打印订单中选择已经切片的 G-code。
2. 选择兼容机型。P1S、A1、H2D 文件不会跨机型错误分配。
3. 为文件使用的每一种耗材映射 AMS 槽位或外置料架。
4. 核对喷嘴、材料和颜色后发送任务。

H2D 与 AMS

H2D 会分别显示左右喷嘴。AMS 槽位可以查看材料、颜色和剩余状态，并在发送任务前选择进料映射。没有完成耗材映射时，不应直接开始打印。

状态与实况

打印页面显示进度、剩余时间、喷嘴和热床温度、当前阶段、AMS 以及相机画面。状态以打印机 MQTT 实际上报为准，空闲时不会保留过期的“热床调平”等阶段文本。

原生 Windows 与 macOS 节点若缺少 ffmpeg，相机区域会显示依赖错误；Docker 节点已包含该依赖。

07 · 物流

待发货与物流

进入“待发货”可以集中处理已打包订单。普通快递与自提、闪送等其他交付方式会分组展示。

复制地址

点击订单即可复制单个地址；批量复制会使用中文分号连接多条地址，便于粘贴到快递平台。

手工发货订单

不需要生产、只需要寄快递的任务可以使用“手工订单”。填写收件信息和交付方式后，它只进入待发货流程，不创建打印任务。

连接物流服务

在组织设置中完成已支持物流平台的授权和发货信息配置后，即可从待发货页面创建运单、打印面单并保存快递单号。

08 · 管理

成员与权限

管理员可以创建、编辑和删除成员。每位成员只能修改自己的基础资料，不能自行扩大权限。

保存权限后立即刷新当前成员数据。金额权限关闭时，订单金额应显示为隐藏状态，而不是仅在前端视觉上遮挡。

09 · 数据

经营数据

经营数据按订单金额与发货时间聚合。图表支持当天数据和自定义日期范围，鼠标移动到折线或柱形位置时显示具体日期与金额。

• 没有“金额可见”权限的成员无法进入经营数据。
• 已发货订单使用平台真实发货时间，不使用同步时间代替。
• 补发任务不应重复计入原订单销售金额。

10 · 部署

云端、客户端与打印节点

产品由云端业务服务、桌面客户端、本地打印节点和局域网打印机组成。每一层只处理运行所需的数据。

为什么不把 G-code 全部上传云端

打印文件体积大，集中上传会增加存储和公网带宽成本，也会让生产依赖外网。默认本地保存能降低成本，并允许已经开始的打印在短时断网时继续运行。

节点主动同步，不需要入站端口

打印节点每隔约 10 秒通过出站 HTTPS 向云端发送心跳、节点状态和打印结果。即使所有桌面客户端都已关闭，节点仍可继续同步已完成或失败的打印任务。

您不需要固定公网 IP、DDNS、路由器端口映射，也不需要让互联网直接访问节点的 TCP 19530 或 UDP 19531。这两个端口只用于本地局域网。

没有 NAS 也能使用

直接在一台长期运行的 Windows 或 macOS 电脑上安装独立打印节点即可。文件可保存在本机硬盘或外接硬盘；NAS 只是可选存储位置，不是运行前提。

11 · 支持

故障排查

12 · FAQ

常见问题