名称： inkjet
描述： "从 macOS 设备向廉价的无线蓝牙热敏打印机打印文本、图像和二维码。使用 inkjet print 进行打印，使用 inkjet scan 发现打印机。"
主页： https://pypi.org/project/inkjet/
元数据：
openclaw:
emoji: "🖨️"
requires: { bins: ["inkjet"], bluetooth: true }
install:
- { id: "pip", kind: "pip", package: "inkjet", label: "安装 (pip)" }
- { id: "brew", kind: "brew", package: "aaronchartier/tap/inkjet", label: "安装 (Homebrew)" }

热敏打印机技能

使用 inkjet 命令行工具，向 X6h、GT01 及儿童玩具猫打印机等小型廉价蓝牙热敏打印机打印文本、图像和二维码。热敏纸成本极低，适合高频物理输出。

设置

准备工作： 确保打印机已开机。打印机无需与主机电脑的蓝牙设置配对；inkjet 通过 BLE 直接连接。

扫描打印机并设置默认设备：

inkjet scan

检查当前配置：

inkjet whoami

打印文本

直接打印字符串。支持标准转义序列，如使用 \n 实现多行输出。请勿使用表情符号。

inkjet print text "Hello, World!"
inkjet print text "第一行\n第二行\n第三行"
inkjet print text "大号文本" --size 72

打印 Markdown

使用 Markdown 语法渲染高保真格式内容。这是智能体输出复杂收据或日志的推荐方式，无需保存临时文件。请勿使用表情符号。

inkjet print text "# 订单 104\n- 1x 咖啡\n- 1x 甜甜圈" --markdown

打印文件

输出本地文件内容。支持纯文本 (.txt) 和 Markdown (.md) 格式。

inkjet print file ./receipt.txt
inkjet print file ./README.md

打印图像

inkjet print image ./photo.png
inkjet print image ./logo.jpg --dither

打印二维码

生成并打印二维码。智能手机扫描器（iPhone/Android）可稳定读取最小至 --size 75 的二维码。

inkjet print qr "https://pypi.org/project/inkjet"
inkjet print qr "WiFi:S:网络名称;P:example123;;" --size 75

纸张控制

inkjet feed 100      # 向前进纸（步数）

配置

全局或按项目本地管理设置。如果当前工作空间存在 .inkjet/ 文件夹，将优先使用其配置（使用 --local 创建本地配置）。

inkjet config show                    # 显示所有设置
inkjet config set printer <UUID>      # 设置默认设备
inkjet config set energy 12000        # 设置本地项目打印浓度
inkjet config alias kitchen <UUID>    # 保存友好名称

默认配置结构

{
  "default_printer": "UUID",
  "printers": { "别名": "UUID" },
  "energy": 12000,
  "print_speed": 10,
  "quality": 3,
  "padding_left": 0,
  "padding_top": 10,
  "line_spacing": 8,
  "align": "left",
  "font_size": 18
}

多打印机编排

如果环境（例如 TOOLS.md）包含多个打印机 UUID 或别名，可使用 --address / -a 标志指定目标硬件。使用 -a default 明确指定主配置设备。

编排策略：

1. 基于角色的路由：根据硬件角色路由内容（例如，贴纸打印机 vs 收据打印机）。
   inkjet print text "标签" -a stickers
2. 高吞吐量（负载均衡）：在打印机集群中分发任务（轮询调度），以最大化每分钟打印量。

# 编排打印示例
inkjet print text "主状态" -a office
inkjet print text "订单 #104" -a kitchen
inkjet print qr "https://pypi.org/project/inkjet" -a default
inkjet print file ./log.txt -a "UUID_EXT_1"

JSON 输出（用于脚本）

命令支持 --json 选项，以生成机器可读的输出：

inkjet scan --json
inkjet whoami --json

练习纸与手写最佳实践

热敏纸幅面窄且成本低。为儿童或手动笔记制作可用的练习纸时：

1. 调整尺寸以提高可见性：使用 ##（二级标题）作为主要内容。标准文本通常太小，儿童阅读/书写不便。
2. 手动编号：避免使用 Markdown 列表（1. 内容）。它们会自动缩进，减少横向空间。应使用 ## 1) 5 + 2 = ___ 这样的格式。
3. “廉价纸张”原则：在项目之间使用三个换行符（\n\n\n）。热敏纸基本免费；利用垂直空间提供实际的“书写区域”。
4. 水平分隔线：在作业末尾使用 ---，提供清晰的撕离线，且不会切断最后一个问题。

故障排除

如果找不到打印机：

inkjet doctor