跳转至

代理服务 · 打印模块（print-Modules）

服务分类：代理服务 —— 对应 nfprinter 打印编辑代理

模块定位

打印代理服务：作为 Android/PC 客户端与网络打印机之间的打印编辑与转发代理 （服务端组件 nfprinter 独立进程部署，可选上报 nfarmsd）。

功能

  • 收单：POST /api/v1/jobs（printer / filename / document_b64 / options）， 任务入库（SQLite）+ 文档落 spool；
  • 队列状态机：queued → processing → done | failed | cancelled，失败记 error；
  • PJL 编辑：副本数 / 双面 / 灰度 / 分页（@PJL SET ... + ENTER LANGUAGE， 作业名与页范围做注入防护）；
  • 转发：JetDirect 9100 原始 TCP 推送，读写超时 + 回包读取；
  • 上报：任务完成/失败可选 POST /api/v1/telemetry（kind=printer）。

接口要点

POST   /api/v1/jobs                 提交打印任务（base64 文档 + 选项）
GET    /api/v1/jobs?status=         任务列表（状态过滤）
GET    /api/v1/jobs/{id}            任务详情
DELETE /api/v1/jobs/{id}            取消排队中任务
GET    /api/v1/printers             已注册打印机
GET    /health                      健康检查

状态与关联

  • 已实现：nfprinter（Rust，Windows）nfprinter serve；Android 端源码 nfprinter/android/；
  • 关联客户端：nfprinter/；关联前端：tools/（工具聚合入口）。