热敏打印机控制技能评估
核心功能
inkjet 是一款专为 macOS 设计的开源 CLI 工具，用于通过蓝牙低功耗（BLE）直接控制廉价热敏打印机（如 X6h、GT01、儿童猫爪打印机等）。该工具无需传统蓝牙配对，直接通过 BLE 协议与打印机通信，显著降低了使用门槛。
主要能力矩阵：
- 文本打印：支持基础字符串、多行转义序列、字体大小调节
- Markdown 渲染：内置 Markdown 解析引擎，可直接渲染格式化收据、日志和工单
- 图像处理：支持 PNG/JPG 格式，可选 Floyd-Steinberg 抖动算法优化黑白转换
- 二维码生成：内置 QR 码生成，支持
--size 75级别的智能手机可靠扫描 - 多打印机编排：支持别名管理、角色路由（如厨房/办公/标签机）、负载均衡
显著优点
1. 零配对设计：绕过 macOS 蓝牙设置，直接 BLE 连接，解决传统蓝牙热敏打印机配对繁琐痛点
2. 极低运营成本：热敏纸成本接近零，适合高频物理输出场景
3. Agent 原生友好：Markdown 直接渲染避免临时文件，适合自动化工作流
4. 配置灵活：支持全局/项目级配置（.inkjet/ 目录），JSON 输出便于脚本集成
潜在局限与风险
| 维度 | 说明 |
|------|------|
| 平台锁定 | **仅支持 macOS**，无 Windows/Linux 支持 |
| 设备兼容性 | 依赖特定 BLE 协议栈，非所有热敏打印机兼容 |
| 内容限制 | 明确禁止 Emoji（渲染失败），色彩仅限黑白 |
| 安全边界 | BLE 通信无加密说明，物理距离内可被嗅探 |
适用人群
- 开发者/自动化工程师：构建物理输出工作流
- 小型零售/餐饮业：低成本收据、标签系统
- 教育场景：快速生成纸质练习题、手工材料
- IoT 爱好者：将数字状态转为物理反馈
常规风险提示
- 硬件碎片化：廉价热敏打印机厂商协议不统一，建议购买前确认兼容性列表
- 打印质量：热能参数（
energy）需针对纸张调整，过高烧穿、过低模糊 - 隐私泄露：二维码内容、打印文本在 BLE 广播范围内可能被拦截
生态与维护
- PyPI 分发，Homebrew 官方 Tap 维护
- 活跃开发（v0.x 阶段），API 可能有变动
- 社区以 GitHub Issues 为主，文档完整度高