技能介绍

解决什么问题

在团队环境里，打印机通常是「最后才被想起」的外围设备：桌面客户端能连，但自动化流程很难用。想让 CI 产物直接落到某个工位旁的 WF-2250，或者让值班脚本把告警文本打印出来贴到机房墙上，传统做法得单独写打印脚本、管理 spooler、处理 PDF 转换，换一次网络环境就要重新调试。epson-mcp 把这件事收拢成一个 MCP server：让 Codex、OpenClaw 这类智能体客户端用统一接口完成诊断、打印与状态查询，不用再为每台机器手写 ESC/P 命令。

工作方式

核心是「后端 + 工具集」两层设计。

打印后端：默认走 raw9100，即 TCP/9100 直连并发送 ESC/P-R 指令，WF-2250 原生支持，响应最直接。若目标机器不支持 9100，可切到 lpd（TCP/515 LPR），但不少低端爱普生机型会直接忽略该协议。另有 windows 后端，通过 PowerShell 操作 Windows 打印池。
自动选择：backend=auto 时按 lpd → raw9100 → windows 顺序尝试；在 Linux 容器中找不到 powershell.exe 或 pwsh 时，Windows 后端会被自动跳过，不会因缺依赖而卡住。
工具面：

- epson_diag：先探一遍连通性与能力，避免在不可达的机器上继续跑流程。
- epson_print_text / epson_print_file / epson_print_raw：覆盖纯文本、共享卷文件（PDF 自动转换）以及 base64 编码的 ESC/P 或 PostScript 原始负载。
- epson_status：重新探测并返回状态摘要，适合在长时间任务后复核。
- epson_list_jobs / epson_cancel_job：管理 Windows spooler 中的任务，仅在 PowerShell 后端下可用。

适用边界与注意点

有几个能力是有意留空的。epson_ink 只是 stub：WF-2250 不通过网络暴露墨水余量，真正需要余量时得走 USB 或面板读数。epson_scan 与 epson_copy 同样是 stub——这台机器不支持网络扫描与网络复印，接口存在但不会返回实质结果，调用前建议先用 epson_diag 确认实际能力。

另外，windows 后端依赖目标主机装有 PowerShell；跨 Tailnet 暴露时要注意网络路径是否真能到达打印机所在网段。打印属于写操作，建议在流程里保留任务号或日志，便于事后追溯哪份 PDF 被送去了哪台机器。