inkjet

🖨️ 低成本蓝牙热敏打印专家

基于开源 inkjet CLI 的 macOS 蓝牙热敏打印技能,支持文本、Markdown、图像及 QR 码的低成本物理输出,适合高频小票、标签与儿童作业场景。

收藏
7.6k
安装
2.5k
版本
v1.0.2
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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// 与全局配置优先级逻辑可能导致多项目环境的行为不一致。

inkjet 内容

手动下载zip · 3.0 kB
SKILL.mdtext/markdown
请选择文件