UV 控制台使用教程（当前版）

更新时间：2026-05-21。本文适用于当前 Electron 版 UV 控制台 v1.0.11，用于 eufyMake E1 UV 打印机的日常排版、收图、打印和维护。

阅读方式：现场同事只需要按“打开软件 → 确认参数 → 选模板/填照片 → 发送打印 → 按机身 START”的顺序操作。看到 ✅ 表示当前已开通或已验证；看到 ❌ 表示当前不要使用；看到 ⚠️ 表示可用但有安全前提。

本次更新重点

• 自动重试可见：打印失败命中可恢复场景时，软件会自动重连打印机并重发 1 次；界面会出现橙色“自动重试”横幅，显示正在重连还是正在重发。
• 自动确认倒计时：开启自动分配和自动确认后，模板未满但已有照片时，会在顶部显示倒计时横幅；倒计时结束会按当前张数自动发送。
• 状态反馈更清楚：打印阶段、失败原因、自动重试进度会同步显示在顶部提示、toast 和日志里，现场同事可以截图给开发排查。
• 操作边界更明确：当前仍只建议使用 720 DPI、标准质量、未知材质、白色>CMYK 或 CMYK、普通平印。

一、当前可用范围

界面里有些参数是预留项，不代表已经开通。打印前先按下面的支持范围确认。

项目	当前可用	当前不要使用	备注
墨水模式	白色>CMYK、CMYK	光油、白色、CMYK>白色、CMYK>白色>CMYK、CMYK>光油、白色>CMYK>光油、贴纸	目前只开通“白色 + 彩色”和“纯彩色”。
DPI	720	360、1440	720 是当前真机验证基准。
质量	标准	高品质、草稿	标准与 Studio 真值一致，最稳定。
材质	未知	木、亚克力、金属、绘图板、塑胶、陶瓷、玻璃、棉帆布、涤纶帆布、亚麻帆布、人造革、真皮、硬纸板	其他材质值没有真机对照，不要选。
白墨收缩	默认 0.2 mm	纯 CMYK 模式下无效	只对白墨模式有意义；现场一般不改。
跳过测高	同介质、同厚度、连续重复打印时才可用	首次打印、换材料、换厚度时不要用	误用可能导致喷头撞到物体。
跳过当前照片	不建议使用	需要少打某张时，直接从模板槽位移除照片	当前主流程不要依赖这个开关。
工艺	普通平印	浮雕、仿银、仿金	后端未对接，选了也会按普通平印处理。

二、截图说明

本文已补入主流程和设置页截图。顶部提示类截图（自动确认倒计时、自动重试、跳过测高警告）目前不易稳定复现，本文先保留文字说明；后续现场遇到时再补图。

1. 已补：主界面、左侧照片栏、中间模板队列、右侧控制栏。
2. 已补：设置 → 软件自身、照片内容、模板参数、打印工艺、墨水模式下拉、服务接口、日志。
3. 待补：自动确认倒计时横幅、自动重试横幅、跳过测高警告。

三、安装与首次启动

1. 下载最新的 UV-Console-v*-win-x64.zip。
2. 右键 zip → 全部解压缩，放到桌面、D 盘或固定工作目录。
3. 进入解压后的文件夹，双击 UV控制台.exe 启动。
4. 如果 Windows 弹出 SmartScreen，点“更多信息” → “仍要运行”。

凭证说明：软件需要 eufyMake Studio 的账号和设备凭证才能连接打印机。如果本机已经安装并登录过 Studio，一般会自动读取；如果没有，使用同事导出的 uv-credentials-*.json 导入。

凭证导入方式

• 方式 A：安装官方 eufyMake Studio，用公司账号登录一次，确认能看到打印机，然后重新打开 UV 控制台。
• 方式 B（推荐）：让已有凭证的同事打开 UV 控制台 → 设置 → 软件自身 → 诊断 → 导出凭证；你在首次启动提示里导入这个 JSON。
• 安全提醒：凭证 JSON 代表公司账号和设备信息，只能在内部可信渠道传递。

四、主界面认识

截图位 1：主界面全景。

• 顶部栏：左侧是“队列 / 历史”，右侧是打印机芯片、刷新状态、语言切换、声音开关、设置入口。
• 顶部提示横幅：重要状态会显示在主内容上方，包括打印机告警、自动确认倒计时、自动重试进度和跳过测高警告。
• 打印机芯片：显示 A/B 打印机、连接状态、是否忙碌、是否待维护或墨量不足。芯片离线时可点它尝试重连。
• 左侧照片栏：显示收到的照片，分为“新照片 / 已填充 / 已使用”。新照片可以拖到模板槽位。
• 中间模板队列：每一条模板就是一块要打印的排版；槽位里放入照片后就可以打印。
• 右侧控制栏：包含自动分配、自动确认、确认打印/暂停/继续、取消打印和墨水余量。

五、日常打印流程

1. 打印前检查

• 确认打印机已开机，电脑和打印机在同一局域网。
• 确认材料已放稳，平台上没有会挡住喷头的异物。
• 看顶部打印机芯片，状态应为“空闲 / READY / 就绪”一类；如果显示离线，先点刷新或重连。
• 看右侧墨水条，C/M/Y/K/W/G 低于 10% 时先处理墨量告警。
• 确认“设置 → 打印工艺”里使用当前支持参数：720、标准、未知、白色>CMYK 或 CMYK、普通平印。

2. 选择或制作布局模板

截图位 6、7：设置 → 照片内容。

1. 点右上角设置按钮，进入 照片内容。
2. 如果已有模板，在“加载模板”里选择；如果没有，点“添加图片”创建画布框。
3. 在画布上拖动框位置，或在“位置 / 尺寸 / 旋转”里输入 X、Y、宽、高、旋转角度。
4. 多选时可按 Shift + 点击，也可点“全选”；方向键微调 1mm，Shift+方向键 10mm，Alt+方向键 0.1mm。
5. 平台尺寸默认使用小平台约 333 × 88 mm。除非实际换平台，否则不要改。
6. 确认排版后填写模板名，点“保存”；改已有模板时先“加载模板”，再点“覆盖”。

发送打印测试：照片内容页的“发送打印测试”会把当前画布合成测试图并真机打印，主要用于验证坐标是否准确。日常批量打印通常走主界面的照片队列。

3. 放入照片

截图位 2、3：照片栏和模板队列。

• 照片从外部接口或取图目录进入后，会出现在左侧“新照片”。
• 自动分配开启：新照片会自动放入队首待填充模板。
• 自动分配关闭：手动把左侧照片拖进中间模板槽位。
• 模板只要放入至少 1 张照片，就可以打印；未满槽时按钮会显示“打印当前 N/M 张”。
• 拖错照片时，可以从槽位移除，或删除整个模板重新排。

4. 发送打印

截图位 4：右侧控制栏。

1. 选中要打印的模板，或让系统默认选队首 ready 模板。
2. 右侧主按钮显示 确认打印 或 打印当前 N/M 张 时，点击它。
3. 如果弹出“跳过测高警告”，只有在同材料同厚度连续打印时才点确认；否则点取消，回到打印工艺页取消“跳过测高”。
4. 软件发送文件后，等待打印机进入机台确认/START 状态。
5. 看到“请按打印机上的物理 START 按钮”提示后，到机器旁按机身 START。
6. 打印中不要移动材料，不要关闭软件；需要中止时点右侧 取消打印。
7. 如果顶部出现橙色“自动重试”横幅，先不要重复点击确认或取消，等软件完成自动重连和重发。

5. 自动确认

• 自动分配：控制新照片是否自动填入模板。
• 自动确认：自动分配开启后，模板满槽会立即自动发送；模板未满但已有照片时，会按设置的倒计时自动发送。
• 倒计时横幅：顶部会显示“Ns 后自动打印 X/Y 张”。如果新照片继续进入，倒计时会继续等待直到模板填满或倒计时结束。
• 建议：新同事先关闭自动确认，熟悉流程后再由负责人决定是否开启。
• 注意：如果开启了“跳过测高”，自动确认会被安全机制拦截，需要先手动确认一次跳过测高警告。

6. 自动重试提示

提示：自动重试横幅目前没有稳定复现截图；现场如果遇到橙色“自动重试 1/1”横幅，截图后可补到本节。

• 什么时候出现：发送打印后，如果遇到“未进入打印准备状态”“未收到打印确认”“1104 step1 超时”等可恢复失败，软件会自动重试。
• 重试次数：当前最多自动重试 1 次。重试时会先强制重连打印机，再重发同一个打印任务。
• 界面提示：顶部橙色横幅会显示“自动重试 1/1”，并区分“强制重连打印机中”和“重发打印任务中”；右侧会显示简短失败原因。
• 现场操作：看到横幅时先等待，不要重复点“确认打印”、不要频繁点“取消打印”或“紧急重置”。横幅会在成功、取消或最终失败后自动消失。
• 仍然失败：如果 toast 显示“自动重试失败，已放弃”，先不要继续批量打印，截图主界面和日志页，并导出诊断包。

六、设置面板说明

1. 软件自身

截图位 5：设置 → 软件自身。

• 维护：闪喷、清洁、深度清洁、注墨。维护过程中打印机不可用，不要连续狂点。
• 重连打印机：打印机换网、断线或顶部芯片离线时使用，通常等 5–15 秒。
• 紧急重置打印任务：只在打印卡死、取消无效时使用；它会强制清理后台打印状态并重连。
• 导出凭证：给同事导入账号和设备凭证时使用。
• 导出诊断包：软件报错时导出 zip 发给开发同事。
• 调试 / 原始命令：研发入口，现场同事不要发送原始命令。

2. 照片内容

• 添加图片：在画布上新增一个打印框；下拉选项会带尺寸，例如方形、横版、竖版或圆形测试图。
• 删除选中 / 全选 / 清空选择：用于管理画布框，支持多选整体调整。
• 锁定比例：调整宽高时保持原比例，日常建议开启。
• 位置 / 尺寸 / 旋转：精确控制打印位置。X、Y 使用毫米；旋转使用角度。
• 布局模板：保存、覆盖、删除排版模板。覆盖和删除会弹确认框。

3. 打印工艺

截图位 8：设置 → 打印工艺。

设置项	怎么选	不能用/不要选
DPI	选 720 ✅	360 ❌、1440 ❌
质量	选 标准 ✅	高品质 ❌、草稿 ❌
材质	选 未知 ✅	木、亚克力、金属、绘图板、塑胶、陶瓷、玻璃、棉帆布、涤纶帆布、亚麻帆布、人造革、真皮、硬纸板全部 ❌
墨水模式	白色>CMYK ✅、CMYK ✅	光油、白色、CMYK>白色、CMYK>白色>CMYK、CMYK>光油、白色>CMYK>光油、贴纸全部 ❌
白墨收缩	默认 0.2；白色>CMYK 时才有意义	CMYK 纯彩色下无效，不用调
跳过测高	同材料同厚度连续打印可勾选 ⚠️	首次打印、换材料、换厚度不要勾选
跳过当前照片	不要依赖这个开关	需要少打某张时，从模板槽位移除照片
工艺	普通平印 ✅	浮雕 ❌、仿银 ❌、仿金 ❌

4. 服务接口

截图位 10：设置 → 服务接口。

• HTTP 照片接收：用于外部系统把照片传进软件。需要接收时点“启动”，不用时可停止。
• 端口：默认即可，只有负责人要求时才改。
• 自动打印：新任务进队后立即开始，属于高风险自动化开关；现场默认不要随便开启。
• 取图目录：待打印照片存放目录。
• 完成目录：打印完成后照片归档目录。
• 导入/导出配置：用于换电脑或备份设置；导入后如提示重启，就关闭软件再打开。

5. 日志

截图位 11：设置 → 日志。

• 过滤：输入关键字，只看相关日志，例如“错误”“墨量”“打印”。
• 自动滚动：保持开启，方便看最新状态。
• 复制：把当前日志复制给开发同事。
• 清空：只清空界面显示，不一定删除磁盘日志；报问题时优先导出诊断包。

七、常见问题

1. 打印机离线或一直未连接

1. 确认打印机开机，电脑和打印机在同一个网络。
2. 点顶部刷新按钮，等待几秒。
3. 仍未恢复时，打开 设置 → 软件自身 → 重连打印机。
4. 如果还是失败，关闭 UV 控制台重新打开，并导出诊断包。
5. 公司在的三台平板，都在两台安克上测试了连接，都可以成功连接上。需要注意的就是这里换一台机器连接，这里要手动改成当前的设备，然后刷新，如果还是一直握手失败，就开一下官方软件，查看一下当前设备状态，不需要其他操作，退出官方软件回到我们软件等待一下就能成功连上。

   

2. 墨量告警或需要注墨

1. 暂停继续发送新任务。
2. 打开 设置 → 软件自身 → 维护 → 注墨。
3. 等待注墨完成，再回主界面点墨水刷新。
4. 如果某色仍低于 10%，按现场耗材流程处理。

3. 打印卡住或取消无效

1. 如果顶部正在显示“自动重试”横幅，先等待它完成；不要一边重试一边连续点击按钮。
2. 没有自动重试提示、且确实长时间无变化时，先点右侧“取消打印”，等待 10–15 秒。
3. 如果界面仍显示打印中，进入 设置 → 软件自身 → 紧急重置打印任务。
4. 紧急重置后等重连完成，再重新发送任务。
5. 如果实体打印机已经开始物理打印，不要只依赖软件按钮，按现场安全流程处理设备。

4. 出现 RIP 错误或打印失败

• 先检查“打印工艺”是否选了 ❌ 参数，尤其是光油、贴纸、浮雕、非 720 DPI、非标准质量。
• 墨水模式只允许 白色>CMYK 和 CMYK。
• 如果顶部出现“自动重试”横幅，说明软件正在尝试自恢复，先等待最终结果。
• 切回支持参数后重新发送；仍失败时导出诊断包并附上截图。

5. 不确定该选白色>CMYK 还是 CMYK

• 白色>CMYK：先打白底，再打彩色。适合透明、深色或需要白底托色的材料。
• CMYK：纯彩色，不打白墨。适合白色或浅色底材，速度和耗材更省。
• 不确定时，先用小样测试，不要直接批量打印。

6. 软件出错怎么反馈

1. 打开 设置 → 软件自身 → 诊断。
2. 点“导出诊断包”。如果问题跨多天，可勾选包含历史日志。
3. 同时截图：主界面、错误弹窗、打印工艺设置、日志页。
4. 把诊断 zip、截图、你刚才点了哪些按钮，一起发给开发同事。

八、现场操作建议

• 默认参数保持：720 DPI / 标准 / 未知材质 / 白色>CMYK 或 CMYK / 普通平印。
• 看到 ❌ 的选项不要选，即使下拉框里能点。
• 换材料或换厚度时，一定取消“跳过测高”。
• 批量打印前先打一张小样，确认坐标、颜色、白底是否正确。
• 打印中不要移动材料，不要频繁点维护、注墨、重连、紧急重置。
• 自动重试中先观察顶部横幅和日志，不要重复触发新的打印任务。