inkjet

核心用法

inkjet 是一款面向 macOS 的蓝牙热敏打印机控制技能，通过 inkjet CLI 与 X6h、GT01 等廉价 BLE 热敏打印机直接通信，无需系统蓝牙配对。核心工作流分为三步：使用 inkjet scan 发现设备并配置默认打印机，随后通过 inkjet print 子命令输出内容。支持五种输出模式：纯文本（含转义序列与字号控制）、Markdown 渲染（推荐用于复杂收据）、本地文件打印（.txt/.md）、图像打印（支持 Floyd-Steinberg 抖动算法）以及 QR 码生成（最低 75px 可读）。进阶功能包括多打印机编排（通过 --address 按别名或 UUID 路由任务）、配置热更新（./.inkjet/config.json 本地优先）以及管道输入（stdin 流式打印）。

显著优点

1. 零门槛硬件接入：绕过 macOS 蓝牙配对流程，直接通过 BLE 连接，降低硬件调试成本。
2. Markdown 原生支持：无需临时文件即可渲染格式化收据，对 AI Agent 输出极为友好。
3. 极低成本运营：热敏纸单价极低，配合 "Cheap Paper Rule"（大三倍行距设计哲学），适合教育场景的高频物理输出。
4. 灵活的多机编排：支持基于角色的路由（厨房/前台）与负载均衡策略，满足小商户多点位需求。
5. 双渠道分发：pip 与 Homebrew 双轨安装，覆盖开发者与普通用户群体。

潜在缺点与局限性

• 平台锁定：仅支持 macOS，Windows/Linux 用户无法使用。
• 硬件兼容性窄：官方仅验证 X6h、GT01 及儿童猫打印机，其他型号可能需手动调参。
• 无持久化连接：每次打印建立独立 BLE 会话，高频任务存在连接开销。
• 图像处理能力有限：依赖外部抖动算法，复杂照片打印质量受限。
• Emoji 支持缺失：文档明确禁止 Emoji 输入，国际化场景受限。

适合的目标群体

• 小型零售/餐饮业主：需要低成本小票、标签打印解决方案。
• 教育工作者与家长：利用热敏纸低成本特性，批量生成儿童数学作业或手写练习纸。
• IoT 与硬件爱好者：寻求可脚本化的物理输出接口，用于状态看板或日志硬拷贝。
• AI Agent 开发者：需要无需文件落地的即时物理反馈通道。

使用风险

• 蓝牙稳定性：BLE 连接受环境干扰，密集设备场景可能出现丢包。
• 依赖项维护：inkjet CLI 为个人开源项目，长期更新承诺不明确。
• 热敏纸耐久性：打印内容随时间褪色，不适合长期存档。
• 配置漂移风险：本地 ./.inkjet// 与全局配置优先级逻辑可能导致多项目环境的行为不一致。