从 Labelize 到 Labelize Studio：用 Rust + GPUI 做一个标签设计与预览工作台
内容提要
Labelize Studio 是基于 Rust 标签渲染引擎 Labelize 的桌面应用，采用 Rust 与 GPUI 开发，支持 Windows、macOS、Linux。可打开 ZPL、EPL、TSPL、CPCL、DPL 等文件逐页预览编辑，提供含 15 种对象的可视化设计器、多页 PDF/PNG 导出和虚拟打印机。v0.5.0 新增抗锯齿与矢量 PDF。项目仍处早期试用阶段，安装包未签名，欢迎反馈。
延伸解读
引擎与工作台的分工
Labelize 是独立的 Rust 渲染引擎，负责解析和渲染打印语言；Studio 则复用该引擎，专注于桌面交互、文档会话和任务管理。这种分层意味着，如果你只需要在系统中集成解析渲染或批量转换，可以直接使用 Labelize 的库、CLI 或 HTTP 接口；而需要可视化编辑和多页检查时，才需要 Studio。两者定位清晰，避免功能耦合。
编辑与导出的状态隔离
文章特别强调了状态边界的设计：预览结果绑定文档修订号，防止旧结果覆盖新内容；导出任务保存点击时的内容快照，后续编辑不影响已接收的任务；渲染在独立子进程中运行，输出先写临时文件再提交。这些机制保证了在多标签页、快速输入场景下，预览和导出不会串页或丢失，对需要反复调整标签的用户来说，是可靠性的关键。
v0.5.0 的渲染增强与限制
新版本加入抗锯齿和矢量 PDF 选项：抗锯齿保留平滑灰度边缘，矢量 PDF 保留文字、图形和条码的几何信息，PNG 可从矢量场景按 1–4 倍分辨率生成。但默认仍是黑白栅格输出，导入的位图不会获得矢量细节，PNG 本身仍是位图，标签物理尺寸不变。这些选项适合对输出质量有更高要求的场景，但需注意其适用边界。
早期试用阶段的注意事项
项目仍处早期试用阶段，Windows/macOS 安装包未签名，macOS 公证待完成；CI 构建通过不代表所有桌面环境已实机验收，原生 Windows x64 与 ZDesigner 链路、macOS 13 及更多 Linux 桌面环境仍需验证。试用时建议附上系统架构、应用版本、预期结果和最小标签样例反馈问题，并留意验收文档中的状态记录。
Q&A
Labelize Studio 是什么？它和 Labelize 引擎有什么关系？
Labelize Studio 是基于 Rust 标签渲染引擎 Labelize 的桌面应用，用 Rust 和 GPUI 开发，支持 Windows、macOS、Linux。Labelize 负责打印语言解析与渲染，Studio 复用这部分能力，负责桌面交互、文档会话、任务管理和系统打印接入。
Labelize Studio 支持打开哪些标签文件格式？
支持打开 ZPL、EPL、TSPL/TSC、CPCL 和 DPL 文件，也可以识别常见的 .prn 输入。每个文件有独立标签页，可逐页预览和编辑。
Labelize Studio 的设计器能创建哪些对象？
设计器包含文字、矩形、椭圆、线条、图片，以及 Code 128、Code 39、EAN-13、EAN-8、UPC-A、ITF、QR、Data Matrix、PDF417、Aztec 共 15 种对象。可调整位置、尺寸、旋转、文字排版和条码参数，管理图层顺序、显隐与锁定，支持撤销和重做。
Labelize Studio 如何导出文件？支持哪些格式？
一个任务可以保存为一份多页 PDF，或逐页 PNG。导出提交后会在后台继续处理，可以切换标签页或关闭窗口；任务列表只有在文件真正保存成功后才显示完成。
虚拟打印机在 Windows 和 macOS/Linux 上的工作方式有什么不同？
Windows 路径由 ZDesigner 生成 ZPL，再交给 Labelize；macOS/Linux 经 IPP/PAPPL 接收系统生成的栅格页面，直接保存 PDF/PNG，不需要转换成 ZPL。Windows 的完整 ZDesigner 链路仍待实机验收。
v0.5.0 版本新增了哪些功能？
v0.5.0 包含多标签页工作台、扩展设计器、PDF/PNG 导出、虚拟打印机和应用内更新入口。新增 Antialias 和 Vector 选项：抗锯齿保留平滑灰度边缘；矢量 PDF 保留文字、图形和条码几何；PNG 可从矢量场景按 1–4 倍分辨率生成，但仍是位图。默认保持黑白栅格输出。
Labelize Studio 目前有哪些使用限制或注意事项？
项目仍处早期试用阶段：Windows/macOS 安装包尚未签名，macOS 公证待完成；CI 构建通过不代表每种桌面环境都已实机验收。原生 Windows x64 与 ZDesigner、macOS 13 以及更多 Linux 桌面环境仍需验证。设计器输出 PDF/PNG，暂不导出 ZPL 等打印语言代码；已有打印语言文件仍按源代码编辑，不会自动拆解成设计对象。
