桌面角色扮演游戏（TTRPG）的道具制作长期面临一个矛盾：数字工具便于生成内容，但实体道具更能营造沉浸感。Sales & Dungeons 项目通过热敏打印机桥接这一鸿沟，允许游戏主持人（DM）将法术卡、物品描述、角色便签等内容实时打印成收据式手牌。本文基于该开源项目的架构实践，剖析从 HTML/CSS 模板到 ESC/POS 指令的渲染链路，并探讨低功耗蓝牙传输的工程实现要点。
架构概览：浏览器渲染引擎作为布局器
Sales & Dungeons 的核心设计决策在于复用成熟的 Web 技术栈处理打印布局。模板采用 HTML/CSS 配合 Nunjucks 模板引擎编写，开发者可以使用 Flexbox、Grid 等现代布局方案设计收据版面。应用程序内嵌 Chromium 内核执行渲染，将模板内容转换为位图图像，再编码为 ESC/POS 指令序列发送给打印机。
这一架构的优势在于屏蔽了热敏打印机固有的分辨率与行宽限制。传统 ESC/POS 开发需要手动计算字符宽度、处理换行与分页，而通过浏览器渲染，开发者只需关注视觉设计，由引擎自动处理 203 DPI 或 300 DPI 的像素映射。项目支持 58mm 和 80mm 两种常见纸宽，通过 CSS 媒体查询或模板参数适配不同尺寸。
ESC/POS（Epson Standard Code for Point of Sale）是热敏打印机领域的事实标准指令集。Sales & Dungeons 主要使用其中的图像打印指令 GS v 0，该指令支持以位图模式逐行传输图像数据。具体流程为：将渲染后的 PNG 图像按打印机宽度裁剪，转换为单色位图，每 8 个像素打包为一个字节，配合适当的行间距参数发送至设备。
ESC/POS 关键指令与布局优化
收据式布局与常规文档存在显著差异：纸张为连续卷纸而非分页介质，宽度受限但长度可扩展，且通常不需要复杂的多栏排版。针对这些特性，以下 ESC/POS 指令在 TTRPG 工具开发中尤为关键：
图像打印指令 GS v 0 m xL xH yL yH d1...dk：这是 Sales & Dungeons 渲染链路的核心出口。参数 m 指定打印模式（通常为 0 表示正常模式），xL/xH 和 yL/yH 分别表示图像宽度和高度的高低字节。数据段 d1...dk 为位图像素数据，每个字节代表 8 个垂直排列的像素。对于 576 像素宽的标准 80mm 打印机（203 DPI），每行需要 72 字节数据。
字符样式指令 ESC ! n：用于设置字体大小、加粗、倍高等属性。在道具卡设计中，标题通常使用倍高倍宽（n = 0x30），正文使用标准字体，关键数值（如伤害骰、金币数量）使用加粗强调。合理组合这些样式可以减少对图像模式的依赖，提升打印速度。
切纸指令 GS V m：控制打印机在内容结束后执行全切或半切。TTRPG 手牌通常需要全切（m = 1）以便直接分发，而连续报表可使用半切（m = 0）保留连接点。
行间距指令 ESC 3 n：设置行间距为 n 点。收据式布局通常使用较小的行间距（如 24 点或 30 点）以在有限宽度内容纳更多信息，但需避免过小导致视觉拥挤。
性能优化方面，连续传输大批量图像数据可能导致打印机缓冲区溢出。Sales & Dungeons 的实现采用分块策略：将大尺寸图像按 256 行或 512 行为单位分批发送，每批之间插入 DLE EOT n 状态查询指令确认打印机就绪，或利用操作系统底层的流控机制。
蓝牙传输层的实现路径
Sales & Dungeons 原生支持的连接方式包括 Windows Direct Printing、Raw USB、CUPS（Linux/Mac）和 Serial 串口，蓝牙并非内置选项。然而，移动场景下的热敏打印需求日益增长，蓝牙低功耗（BLE）或经典蓝牙 SPP（Serial Port Profile）成为扩展方向。
蓝牙热敏打印的实现可分为两个层次：
系统级透传方案：在 Windows 或 Linux 上，可通过操作系统蓝牙栈将打印机配对为虚拟串口（COM 端口或 /dev/rfcomm0）。Sales & Dungeons 的 Serial 连接模式可直接使用此虚拟串口，无需修改应用代码。此方案的优势在于兼容性好，但依赖主机系统的蓝牙协议栈配置，且配对过程对终端用户不够友好。
应用层直连方案：在移动平台或嵌入式设备上，需要应用直接管理蓝牙连接。以经典蓝牙 SPP 为例，实现流程包括：扫描发现打印机设备（通常以 "Printer" 或厂商名称广播）、建立 RFCOMM 通道、获取输入输出流、写入 ESC/POS 指令数据。BLE 方案则更为复杂，需要打印机支持 BLE 打印服务（通常基于自定义 GATT 特征值），且 MTU（最大传输单元）限制通常为 20-512 字节，需要实现分包重组逻辑。
可落地的工程参数
基于上述分析，以下参数清单可供开发者在类似项目中直接参考：
打印机选型：优先选择明确标注 ESC/POS 兼容的设备。常见选择包括 Epson TM-T 系列（工业级）、Xprinter XP-58/80 系列（性价比）、以及各类国产 58mm 便携打印机。关键规格确认：打印分辨率（203 DPI 或 300 DPI）、有效打印宽度（48mm 对应 384 像素，72mm 对应 576 像素）、接口类型（USB、串口或蓝牙）。
指令缓存管理：典型热敏打印机缓冲区为 4KB-64KB。发送数据前建议查询打印机状态（DLE EOT 1 返回 1 字节状态码），或保守地按 1KB-2KB 分块传输，块间延迟 10-50ms。
蓝牙分包策略：经典蓝牙 SPP 通常支持 1024 字节或更大的 payload，可直接使用。BLE 场景下，若 MTU 为 23 字节（默认），建议将 ESC/POS 指令按 20 字节分包；若协商至 512 字节 MTU，可按 500 字节分包。每包发送后等待 write 回调确认，避免数据堆积。
图像预处理：渲染后的图像建议先转换为 1-bit 黑白（阈值 128），再进行 dithering 处理（如 Floyd-Steinberg 算法）以保留细节。对于 58mm 纸宽，目标宽度设为 384 像素；80mm 纸宽设为 576 像素。高度无硬性限制，但超过 1024 像素的图像建议分段打印。
Sales & Dungeons 项目展示了如何将 Web 技术栈与嵌入式打印协议结合，为非技术背景的 TTRPG 玩家提供低门槛的实体道具生成方案。对于开发者而言，理解 ESC/POS 指令的编码细节与蓝牙传输的流控机制，是将此类工具扩展到移动平台的关键。
资料来源
- Sales & Dungeons 官方文档：https://sales-and-dungeons.app/docs/intro/
- Hackaday 项目页面：https://hackaday.io/project/188736-thermal-printing-meets-dungeons-dragons
内容声明：本文无广告投放、无付费植入。
如有事实性问题，欢迎发送勘误至 i@hotdrydog.com。