Skip to content

Snapmaker Orca V2.4.0-Alpha-Release

Pre-release
Pre-release

Choose a tag to compare

@LiuLikeQian LiuLikeQian released this 10 Sep 10:04
· 12 commits to main since this release
ded5297

Snapmaker Orca 2.4.0 Alpha 发布公告
本次 2.4.0 Alpha 版本新增模型选中高亮显示、LOD(Level of Detail)层级细节系统、混色匹配自动模式颜色选择、高流量热端(High-Flow Hot End)参数支持等功能,并新增 6 款耗材丝、扩充多款耗材颜色库,完整清单见下方更新日志。同时,本版本完成了 OpenSSL、macOS 构建环境、Flutter 三项底层依赖的大版本升级,涉及所有联网功能、内置网页与 macOS 安装包——诚挚欢迎参与 Alpha 测试,测试指引见更新日志之后。


一、新增项

  1. 新增模型选中高亮显示,优化交互选择体验。
  • 选中模型时,显示最大包络框的同时,以白色高亮显示模型边缘。
image
  • 在装配环境下,选中模型时,以黄色高亮显示模型边缘。
image
  1. 新增 LOD(Level of Detail)层级细节系统,提升复杂场景下的模型渲染效率。
  2. 混色匹配中的自动模式新增颜色选择功能,用户可选耗材颜色。
image
  1. 部分耗材与工艺新增高流量热端(High-Flow Hot End)参数支持,使用说明见:《U1 热端使用指南》。
image
  1. 新增 6 款耗材丝,均适配 Snapmaker U1:
点击展开查看完整耗材清单
耗材丝 适配喷嘴直径
Snapmaker TPU 0.4 / 0.6 / 0.8 mm
Snapmaker PEBA 90A 0.4 / 0.6 / 0.8 mm
Snapmaker PLA Glow 0.6 / 0.8 mm
Snapmaker PLA Rainbow 0.2 / 0.4 / 0.6 / 0.8 mm
Snapmaker Support for PLA 0.2 mm
Snapmaker PETG-CF 0.6 / 0.8 mm
image
  1. 新增多款耗材的颜色库:
  • Snapmaker PVA: 新增 1 个颜色
  • PETG Translucent: 新增 1 个颜色
  • Support for PLA: 新增 1 个颜色
  • Snapmaker PLA Rainbow: 新增 1 个颜色 (含5 个色值)
  • PLA Basic: 新增 2 个颜色
  • Snapmaker TPU: 新增 2 个颜色
  • PLA Full Spectrum: 新增 4 个颜色
  • Snapmaker PEBA 90A: 新增 5 个颜色
  • Snapmaker PLA Glow: 新增 5 个颜色
  • PLA Snapspeed: 新增 10 个颜色
  • PLA Silk: 新增 14 个颜色
    二、优化项
  1. 整合并精简工艺预设列表。
  • 为简化工艺选择流程,本次更新对 Snapmaker U1 的工艺预设进行了精简合并。部分同层高但不同品质等级的预设(如“Fine”“High Quality”)已统一整合为“Standard”预设。
  • 详细映射关系见下表:
点击展开查看被删除的工艺模板清单
原工艺模板名称 对应简化版本
0.08 Extra Fine @Snapmaker U1 (0.4 nozzle) 0.08mm Standard @Snapmaker U1 (0.4 nozzle)
0.08 High Quality @Snapmaker U1 (0.4 nozzle) 0.08mm Standard @Snapmaker U1 (0.4 nozzle)
0.12 Fine @Snapmaker U1 (0.4 nozzle) 0.12mm Standard @Snapmaker U1 (0.4 nozzle)
0.12 High Quality @Snapmaker U1 (0.4 nozzle) 0.12mm Standard @Snapmaker U1 (0.4 nozzle)
0.16 Optimal @Snapmaker U1 (0.4 nozzle) 0.16mm Standard @Snapmaker U1 (0.4 nozzle)
0.16 High Quality @Snapmaker U1 (0.4 nozzle) 0.16mm Standard @Snapmaker U1 (0.4 nozzle)
0.2 Strength @Snapmaker U1 (0.4 nozzle) 0.20mm Standard @Snapmaker U1 (0.4 nozzle)
0.2 Standard @Snapmaker U1 (0.4 nozzle) 0.20mm Standard @Snapmaker U1 (0.4 nozzle)
0.24 Draft @Snapmaker U1 (0.4 nozzle) 0.24mm Standard @Snapmaker U1 (0.4 nozzle)
0.28 Extra Draft @Snapmaker U1 (0.4 nozzle) 0.28mm Standard @Snapmaker U1 (0.4 nozzle)
0.06 High Quality @Snapmaker U1 (0.2 nozzle) 0.08mm High Quality @Snapmaker U1 (0.2 nozzle)
0.06 Standard @Snapmaker U1 (0.2 nozzle) 0.08mm High Quality @Snapmaker U1 (0.2 nozzle)
0.08 Standard @Snapmaker U1 (0.2 nozzle) 0.08mm High Quality @Snapmaker U1 (0.2 nozzle)
0.08 High Quality @Snapmaker U1 (0.2 nozzle) 0.08mm High Quality @Snapmaker U1 (0.2 nozzle)
0.10 Standard @Snapmaker U1 (0.2 nozzle) 0.10mm High Quality @Snapmaker U1 (0.2 nozzle)
0.10 High Quality @Snapmaker U1 (0.2 nozzle) 0.10mm High Quality @Snapmaker U1 (0.2 nozzle)
0.12 Standard @Snapmaker U1 (0.2 nozzle) 0.12mm Standard @Snapmaker U1 (0.2 nozzle)
0.14 Standard @Snapmaker U1 (0.2 nozzle) 0.12mm Standard @Snapmaker U1 (0.2 nozzle)
0.18 Standard @Snapmaker U1 (0.6 nozzle) 0.18mm Standard @Snapmaker U1 (0.6 nozzle)
0.24 Standard @Snapmaker U1 (0.6 nozzle) 0.24mm Standard @Snapmaker U1 (0.6 nozzle)
0.30 Strength @Snapmaker U1 (0.2 nozzle) 0.30mm Standard @Snapmaker U1 (0.6 nozzle)
0.30 Standard @Snapmaker U1 (0.2 nozzle) 0.30mm Standard @Snapmaker U1 (0.6 nozzle)
0.36 Standard @Snapmaker U1 (0.6 nozzle) 0.30mm Standard @Snapmaker U1 (0.6 nozzle)
0.42 Standard @Snapmaker U1 (0.6 nozzle) 0.30mm Standard @Snapmaker U1 (0.6 nozzle)
0.24 Standard @Snapmaker U1 (0.8 nozzle) 0.24mm Standard @Snapmaker U1 (0.8 nozzle)
0.32 Standard @Snapmaker U1 (0.8 nozzle) 0.32mm Standard @Snapmaker U1 (0.8 nozzle)
0.40 Standard @Snapmaker U1 (0.8 nozzle) 0.40mm Standard @Snapmaker U1 (0.8 nozzle)
0.48 Standard @Snapmaker U1 (0.8 nozzle) 0.40mm Standard @Snapmaker U1 (0.8 nozzle)
0.56 Standard @Snapmaker U1 (0.8 nozzle) 0.40mm Standard @Snapmaker U1 (0.8 nozzle)
  1. 优化了较大模型在切片过程中的稳定性。
  2. 优化了 G-code 文件上传和打印的稳定性。
  3. 升级 OpenSSL 库至 3.5.7 版本,优化了网络通信的安全性与稳定性。
  4. 为“小区域流量补偿”功能的“流量补偿模型”参数增加了默认值,减少用户手动配置步骤。
    三、修复项
  5. 修复使用 GitHub 登录成功后,页面异常显示接口响应内容的问题。
  6. 修复 Windows 系统下,设备熄屏后导致 Orca 与设备联机状态异常的问题。
  7. 修复 Orca 联机失败时弹出异常对话框的问题。
  8. 修复使用第三方授权登录成功后,仍重复弹出登录提示窗的问题。
  9. 修复连续登录 24 小时后,系统异常弹出重新登录提示的问题。
  10. 缓解了各平台在弱网环境下,首页、设备页及预打印页出现白屏的问题(仅在2.4.0及以上版本生效)。
  11. 修复 Snapmaker PETG HF 在 0.4 mm 喷嘴下无官方颜色配置的问题。
  12. 修复在 0.4 mm 喷嘴下,Snapmaker PETG HF 耗材点击色块时仍显示旧色盘的问题。
  13. 修复因配置文件(hints.ini)内容缺失导致软件无法启动的问题。

诚邀参与 Alpha 测试
本次 2.4.0 Alpha 除新增一批功能(见上方更新日志)外,还完成了三项底层依赖的大版本升级——此类组件平时稳定运行、最易被忽视,也最难通过内部测试完全覆盖。

点击展开查看依赖升级清单
升级项 从 → 到 影响范围
OpenSSL(网络安全库) 1.1.1w → 3.5.7(LTS) 所有联网功能:登录、下载、发送打印、设备联机
macOS 构建环境 CI 从 macos-14 迁至 macos-15(macOS 15 宿主 + Xcode 16 工具链) 仅 macOS 包:打包/签名/公证链路、老系统兼容、工具链级差异
Flutter(内置网页框架) 3.24 → 3.41 所有内置网页:首页、登录、模型库、设备页、校准

我们已在主流打印机型号上验证核心流程(导入 → 切片 → 发送打印 → 设备监控)可正常运行;但各类系统版本、旧固件、自建打印服务器、弱网等环境,仍需依靠真实使用加以覆盖。在非主流路径上遇到问题属于预期现象——每一条反馈都直接影响正式版质量,遇到问题请直接提交反馈,无需先行排查。

以下环境我们内部最难覆盖,诚挚欢迎相应设备的用户参与验证:

  • macOS 旧系统用户(本次构建环境为历次最新,旧系统是差异最大的组合),以及已升级 macOS 26 (Tahoe) 的用户(建议进行一轮快速验证)
  • 弱网 / 企业网络 / 代理环境用户

三项升级可能引发的问题

  • 网络与设备连接:登录失败或报证书错误、模型/预设下载失败、局域网找不到设备、发送打印失败、设备状态不刷新、熄屏后联机异常(Windows)

  • 内置网页:首页/登录/模型库/设备页白屏、样式错乱、中文输入异常、按钮点击无响应

  • macOS 专属:首次启动 Gatekeeper/公证校验异常("已损坏/无法验证")、旧系统上启动或渲染异常、界面细节回归(深浅色、字体、表格线);如遇启动即闪退,请立即反馈,此类问题对定位最有价值

  • 不受影响:本地导入、切片、导出 G-code 到 U 盘等纯离线流程未涉及本次升级组件

升级注意事项
工艺预设已精简合并:同层高不同品质的预设(Fine / High Quality 等)已并入 Standard。如您有基于这些预设的自定义工艺,升级后请对照上方更新日志中的映射表检查参数是否符合预期——如发现映射有误,同样属于有效反馈,欢迎提交。

已知问题
已知问题集中维护在 #840(持续更新)。如无暇逐一核对,不确定是否重复的问题也请直接提交,重复条目由我们统一处理。

建议测试清单(约 30 分钟,按样本缺口程度排序)

  1. 冷启动 → 遍历设置页签(关注是否存在闪退或卡死)
  2. 登录账号 → 首页 → 下载模型(OpenSSL:登录与下载链路;本次包含多项登录链路修复,建议重点验证)
  3. 切片 → 局域网发送打印 → 设备页状态实时刷新(OpenSSL:设备联机链路)
  4. 自建打印服务器用户:连接并上传一次 G-code——目前测试样本最匮乏的场景
  5. 逐页打开首页/登录/模型库/设备页/校准等内置页面(Flutter:观察白屏、样式错乱、按钮无响应;可再于弱网或热点环境下复测一遍)
  6. macOS 用户:分别在深色与浅色模式下检查主窗口与设置页;macOS 12–14 用户额外留意启动和画布渲染
  7. 高流量热端:按《U1 热端使用指南》选择对应耗材与工艺切片打印,确认参数生效

反馈方式
反馈渠道:GitHub Issues。本次 Alpha 版本的反馈收集期约为一周以上,之后我们将汇总反馈并发布正式版。

  • 最低要求:提供一张截图或一段录屏,并简述操作步骤与异常结果即可,其余信息我们将跟进询问

  • 信息越完整,定位越快(尽量包含):软件版本号、操作系统及版本(macOS 注明小版本);打印机型号与固件版本(连接类问题必填);复现步骤、实际现象与预期结果;日志——配置目录下 log/ 文件夹最新日志

  • 崩溃:崩溃后如弹出上报提示,请选择上报(Alpha 版本崩溃会自动标记回传,是定位最快的途径),并补充说明当时正在进行的操作
    如您使用的机型属于主流列表且全流程顺利,也欢迎回复一句"型号 X + 固件 Y,全流程通过"——这对我们判断风险是否收敛同样重要。

安装与回退
安装 Alpha 会沿用现有配置。新版可能对配置做单向迁移,装回正式版未必完全恢复,安装前请完整备份配置目录:

  • Windows:%AppData%\Snapmaker_Orca\
  • macOS:~/Library/Application Support/Snapmaker_Orca/

回退到正式版:建议先完全卸载 Alpha,再重新安装正式版


### New Features

  1. Added Highlight-on-Select for models to improve interaction experience
  • When a model is selected, its bounding box is displayed and its edges are highlighted in white.
image
  • In assembly mode, the selected model's edges are highlighted in yellow.
image
  1. Added LOD (Level of Detail) system to improve rendering efficiency in complex scenes.
  2. Added color selection in Auto Match Mode for Color Mixing Match. You can now select filament colors manually.
image
  1. Added High-Flow Hot End parameter support for select filaments and print profiles. For more information, refer to https://wiki.snapmaker.com/en/snapmaker_u1/hot_end_guide.
image
  1. Added 6 new filaments, all compatible with Snapmaker U1:
Click to expand filament list
Filament *Compatible Nozzle Diameters
Snapmaker TPU 0.4 mm、0.6 mm、0.8 mm
Snapmaker PEBA 90A 0.4 mm、0.6 mm、0.8 mm
Snapmaker PLA Glow 0.6 mm、0.8 mm
Snapmaker PLA Rainbow 0.2 mm、0.4 mm、0.6 mm、0.8 mm
Snapmaker Support for PLA 0.2 mm
Snapmaker PETG-CF 0.6 mm、0.8 mm
image
  1. Expanded color options for multiple filaments:
  • Snapmaker PVA: +1 color
  • PETG Translucent: +1 color
  • Support for PLA: +1 color
  • Snapmaker PLA Rainbow: +1 color (with 5 color values)
  • PLA Basic: +2 colors
  • Snapmaker TPU: +2 colors
  • PLA Full Spectrum: +4 colors
  • Snapmaker PEBA 90A: +5 colors
  • Snapmaker PLA Glow: +5 colors
  • PLA Snapspeed: +10 colors
  • PLA Silk: +14 colors

Improvements

  1. Streamlined print profile presets.
  • Presets of the same layer height but different quality levels (e.g., "Fine" and "High Quality") have been merged into "Standard" presets.
  • The detailed mapping is shown below:
Click to expand and view the list of deleted process templates.
Original process template name Mapped To
0.08 Extra Fine @Snapmaker U1 (0.4 nozzle) 0.08mm Standard @Snapmaker U1 (0.4 nozzle)
0.08 High Quality @Snapmaker U1 (0.4 nozzle) 0.08mm Standard @Snapmaker U1 (0.4 nozzle)
0.12 Fine @Snapmaker U1 (0.4 nozzle) 0.12mm Standard @Snapmaker U1 (0.4 nozzle)
0.12 High Quality @Snapmaker U1 (0.4 nozzle) 0.12mm Standard @Snapmaker U1 (0.4 nozzle)
0.16 Optimal @Snapmaker U1 (0.4 nozzle) 0.16mm Standard @Snapmaker U1 (0.4 nozzle)
0.16 High Quality @Snapmaker U1 (0.4 nozzle) 0.16mm Standard @Snapmaker U1 (0.4 nozzle)
0.2 Strength @Snapmaker U1 (0.4 nozzle) 0.20mm Standard @Snapmaker U1 (0.4 nozzle)
0.2 Standard @Snapmaker U1 (0.4 nozzle) 0.20mm Standard @Snapmaker U1 (0.4 nozzle)
0.24 Draft @Snapmaker U1 (0.4 nozzle) 0.24mm Standard @Snapmaker U1 (0.4 nozzle)
0.28 Extra Draft @Snapmaker U1 (0.4 nozzle) 0.28mm Standard @Snapmaker U1 (0.4 nozzle)
0.06 High Quality @Snapmaker U1 (0.2 nozzle) 0.08mm High Quality @Snapmaker U1 (0.2 nozzle)
0.06 Standard @Snapmaker U1 (0.2 nozzle) 0.08mm High Quality @Snapmaker U1 (0.2 nozzle)
0.08 Standard @Snapmaker U1 (0.2 nozzle) 0.08mm High Quality @Snapmaker U1 (0.2 nozzle)
0.08 High Quality @Snapmaker U1 (0.2 nozzle) 0.08mm High Quality @Snapmaker U1 (0.2 nozzle)
0.10 Standard @Snapmaker U1 (0.2 nozzle) 0.10mm High Quality @Snapmaker U1 (0.2 nozzle)
0.10 High Quality @Snapmaker U1 (0.2 nozzle) 0.10mm High Quality @Snapmaker U1 (0.2 nozzle)
0.12 Standard @Snapmaker U1 (0.2 nozzle) 0.12mm Standard @Snapmaker U1 (0.2 nozzle)
0.14 Standard @Snapmaker U1 (0.2 nozzle) 0.12mm Standard @Snapmaker U1 (0.2 nozzle)
0.18 Standard @Snapmaker U1 (0.6 nozzle) 0.18mm Standard @Snapmaker U1 (0.6 nozzle)
0.24 Standard @Snapmaker U1 (0.6 nozzle) 0.24mm Standard @Snapmaker U1 (0.6 nozzle)
0.30 Strength @Snapmaker U1 (0.2 nozzle) 0.30mm Standard @Snapmaker U1 (0.6 nozzle)
0.30 Standard @Snapmaker U1 (0.2 nozzle) 0.30mm Standard @Snapmaker U1 (0.6 nozzle)
0.36 Standard @Snapmaker U1 (0.6 nozzle) 0.30mm Standard @Snapmaker U1 (0.6 nozzle)
0.42 Standard @Snapmaker U1 (0.6 nozzle) 0.30mm Standard @Snapmaker U1 (0.6 nozzle)
0.24 Standard @Snapmaker U1 (0.8 nozzle) 0.24mm Standard @Snapmaker U1 (0.8 nozzle)
0.32 Standard @Snapmaker U1 (0.8 nozzle) 0.32mm Standard @Snapmaker U1 (0.8 nozzle)
0.40 Standard @Snapmaker U1 (0.8 nozzle) 0.40mm Standard @Snapmaker U1 (0.8 nozzle)
0.48 Standard @Snapmaker U1 (0.8 nozzle) 0.40mm Standard @Snapmaker U1 (0.8 nozzle)
0.56 Standard @Snapmaker U1 (0.8 nozzle) 0.40mm Standard @Snapmaker U1 (0.8 nozzle)
  1. Improved slicing stability for large models.
  2. Improved upload and printing stability for G-code files.
  3. Upgraded OpenSSL library to version 3.5.7, enhancing network communication security and stability.
  4. Added a default value for the "Flow Compensation Model" parameter when "Small area flow compensation" is enabled, reducing manual steps.

Bug Fixes

  1. Fixed an issue where API response content was incorrectly displayed on the page after successful GitHub login.
  2. Fixed an issue on Windows where the device connection status became abnormal after the screen turned off.
  3. Fixed an issue where an unexpected error dialog appeared when Orca failed to connect to the device.
  4. Fixed an issue where the login prompt continued to appear after a successful third-party authorization login.
  5. Fixed an issue where the system incorrectly prompted for re-login after 24 hours of continuous login.
  6. Mitigated white screen issues on the Home page, Device page, and Preview page under weak network conditions on all platforms (effective only in 2.4.0 and later versions).
  7. Fixed an issue where Snapmaker PETG HF had no official color configuration under the 0.4 mm nozzle.
  8. Fixed an issue where the old color palette was still displayed when clicking the color swatch for Snapmaker PETG HF under the 0.4 mm nozzle.
  9. Fixed an issue where the software failed to launch due to missing content in the hints.ini file.

Call for Alpha Testing
The 2.4.0 Alpha release ships a batch of new features (see the changelog above), but more importantly, it moves three foundational dependencies to new major versions — components that normally run unnoticed, and the ones internal testing can never fully cover.

Click to expand dependency upgrade list
Component From → To Scope of impact
OpenSSL (network security library) 1.1.1w → 3.5.7 (LTS) All networked features: sign-in, downloads, sending print jobs, device connectivity
macOS build environment CI moved from macos-14 to macos-15 (macOS 15 host + Xcode 16 toolchain) macOS builds only: packaging/signing/notarization, older-OS compatibility, toolchain-level differences
Flutter (embedded web framework) 3.24 → 3.41 All embedded web pages: Home, sign-in, model library, device page, calibration

We have verified the core workflow (import → slice → send to printer → monitor) on mainstream printer models. But the variety of real-world environments — OS versions, older firmware, self-hosted print servers, weak networks — can only be covered by real usage. Running into problems on less common paths is expected — every report directly shapes the quality of the final release. Please report what you see directly; there is no need to troubleshoot first.

The following environments are the hardest for us to cover internally, and users in these groups are especially welcome to participate:

  • Users on macOS (our build environment has never been this new, so older systems are the biggest gap), and users already on macOS 26 (Tahoe) — a quick smoke test would be greatly appreciated
  • Users on weak networks, corporate networks, or behind proxies

Potential issues from the three upgrades

  • Network & device connectivity: sign-in failures or certificate errors, model/preset download failures, LAN device discovery failing, print upload failures, device status not refreshing, connection going abnormal after the screen turns off (Windows)
  • Embedded web pages: blank Home / sign-in / model library / device pages, broken styling, CJK input misbehaving, buttons not responding
  • macOS only: Gatekeeper/notarization issues on first launch ("damaged / cannot be verified"), startup or rendering problems on older systems, visual regressions (dark mode, fonts, table lines). If the app crashes on launch, please report it immediately — such reports are especially valuable
  • Not affected: purely offline workflows — local import, slicing, exporting G-code to USB — do not touch the upgraded components

Upgrade notes
Process presets have been consolidated. Presets of the same layer height but different quality tiers (Fine / High Quality, etc.) have been merged into Standard presets. If you have custom processes based on them, please check them against the mapping tables in the changelog above — if the mapping looks incorrect, that is also valid feedback — please report it.

Known issues
Tracked in #840 (continuously updated). If you are not sure whether an issue is already known, please report it anyway; duplicates will be consolidated on our side.

Suggested test checklist (~30 minutes, ordered by sample coverage need)

  1. Cold start → walk through all settings tabs (watch for crashes/freezes)
  2. Sign in → Home page → download a model (OpenSSL: the sign-in and download paths; this release includes several sign-in fixes, so this path deserves extra attention)
  3. Slice → send over LAN → watch device status update in real time (OpenSSL: the device connectivity path)
  4. Self-hosted print server users: connect and upload one G-code file — the scenario where we lack samples the most
  5. Open the embedded pages one by one — Home, sign-in, model library, device page, calibration (Flutter: watch for blank screens, broken styling, buttons not responding; a weak-network pass is a bonus)
  6. macOS users: check the main window and settings in both light and dark mode; on macOS 12–14, pay extra attention to startup and canvas rendering
  7. High-Flow Hot End: follow the Hot End guide to slice and print with a supported filament and profile, and confirm the parameters take effect

How to provide feedback
Channels: GitHub Issues. We plan to collect feedback for about one week, then incorporate it into the stable release.

  • Minimum requirements: a screenshot or screen recording plus one sentence describing what you did and what went wrong is enough; we will follow up with any questions
  • The more info, the faster the fix (when possible): app version, OS and version (macOS users: exact minor version); printer model and firmware version (required for connectivity issues); steps to reproduce, expected vs actual; logs — the latest file under log/ in the config directory
  • Crashes: when prompted after a crash, please allow the report to be sent (alpha crashes are tagged automatically, which is the fastest path to a fix), then add a short note about what you were doing
    If your printer is on the mainstream list and everything went smoothly, a one-line reply like "Model X + firmware Y, full workflow OK" is just as valuable — it helps us confirm the risks are contained.

Install & rollback
Installing the Alpha keeps your existing configuration. The new version may migrate configuration one-way, so rolling back may not fully restore it — back up the whole config directory before installing:

  • Windows: %AppData%\Snapmaker_Orca\
  • macOS: ~/Library/Application Support/Snapmaker_Orca/

To roll back to the stable release, fully uninstall the Alpha first and then reinstall the stable version