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

核心功能

inkjet 是一款专为 macOS 设计的 CLI 工具，用于控制廉价无线蓝牙热敏打印机（如 X6h、GT01 及儿童玩具猫打印机）。Skill 本身为纯文档型，无可执行代码，仅提供完整的 inkjet 使用指南。

显著优点

• 多格式输出：支持纯文本、Markdown 渲染、图片（含抖动算法优化）、二维码生成
• 零配置连接：无需系统蓝牙配对，inkjet 直接通过 BLE 连接打印机
• 多打印机编排：支持别名管理和地址路由，可实现角色分配（如厨房/办公室）或负载均衡
• 极低运行成本：热敏纸价格低廉，适合高频物理输出场景
• 灵活输入方式：支持文件打印、管道输入（stdin）、JSON 输出（便于脚本化）

潜在局限

• 平台限制：仅支持 macOS（Homebrew 安装渠道），pip 安装虽跨平台但蓝牙功能依赖 macOS
• 无表情符号支持：文档明确提醒避免使用 Emoji，否则可能输出异常
• 打印宽度受限：热敏纸宽度固定（通常为 58mm），复杂布局可能自动折行
• T3 来源风险：由个人开发者维护，虽代码开源但长期维护稳定性需自行评估

适合人群

• 需要实体化数字内容的开发者（日志、任务清单、调试信息）
• 教育场景（打印儿童练习题、临时标签）
• 小型商户（简易收银小票、订单标签）
• IoT/硬件爱好者（物理输出反馈、状态看板）

常规风险

1. 供应链安全：通过 PyPI/Homebrew 分发，虽为标准渠道，但 inkjet CLI 本身为 T3 来源，建议关注上游更新
2. 蓝牙权限：需授予系统级蓝牙访问权限，建议仅从官方渠道安装 CLI 工具
3. 物理介质依赖：热敏纸随时间推移会褪色，不适合长期存档

配置建议

使用 --local 创建项目级 .inkjet/config.json，针对不同文档类型调整 padding、energy（打印浓度）和 font_size，避免重复输入命令参数。