龙虾智能打印网关连接器

要解决什么问题

在飞书、微信、企微或钉钉里把文件发给智能体后，你往往还要回到电脑前打开文件、选打印机再点打印。若办公室已经部署了 800claw Smart Print Gateway（跑在局域网里的 FastAPI 服务），更自然的流程是：文件留在对话里，助手在用户明确确认之后，把同一份文件提交到网关，由网关转 PDF 并走 Windows 打印驱动出纸。

本技能不是内网扫描器或远程控制工具，只做一件事：把用户指定要打印的文件，发到用户主动提供的网关地址。

技能如何工作

典型数据流如下：

• 用户在 IM 中发送待打印文件，智能体先保存到本地。
• 必须先询问是否打印，收到明确确认后才能调用网关；不得自动提交。
• 通过技能目录内的 print_file.py（及健康检查、指南生成等脚本）向网关发 HTTP 请求；部分运行环境会拦截对私有 IP 的 requests/curl，脚本因此用 socket 构造 HTTP/1.0 与 192.168.x.x 这类地址通信。
• 首次对接：用户提供网关 IP + 端口 与 X-API-Key，可先访问 /health 或 /openapi.json 验证；成功后把地址与 Key 写入助手长期记忆，日常打印不再反复询问。
• 提交任务前通过 /printers 动态获取打印机列表；不传 printer_name 则用系统默认打印机。支持 .docx、.xlsx、.pdf、.txt、.png、.jpg 等格式，并可设置份数、颜色、版式、双面等参数。
• 提交后可 GET /status/{job_id} 查状态；相同任务在网关防抖窗口内重复提交会返回 409，需 force=true 或先查状态再决定是否重打。

边界与注意点

• 网关地址与 API Key 不能硬编码在技能或脚本默认值里；仅存在于当前用户工作区记忆，不上传第三方。
• 网络范围严格限于用户配置的局域网网关；不访问公网、不扫网段。
• 需与本地已部署的打印网关配合使用；接口细节以网关 /openapi.json 为准。