规模化的关键不是研发人员远程修改每台电脑，而是让新增门店和打印机经过标准化注册、绑定和验收，不需要改代码。
状态说明
本章是目标态部署规范，不是当前代理已经具备的功能。当前仍使用共享 HMAC 配置、单个
printerName、进程级全局busy、多个平台打印机标识共用状态，以及用户登录后的计划任务。设备证书、短期令牌、多队列映射、逐队列心跳、Windows Service、签名升级和可轮换二维码都需要按本文继续开发。
一、门店基础要求
- 稳定电源，重要门店配置 UPS。
- 稳定网络，优先有线连接门店电脑。
- Windows 电脑使用专用账户和固定设备名称。
- 系统时间自动同步。
- 禁止随意安装软件或修改打印驱动。
- 预留纸张、墨水和常用备件。
- 明确门店维护联系人和平台技术联系人。
二、打印机资产建档
后台创建打印机记录：
| 字段 | 示例说明 |
|---|---|
| 租户与门店 | 设备业务归属 |
| 设备编号 | 平台生成的稳定编号 |
| 品牌型号 | Epson L3250 或实际型号 |
| 序列号 | 设备铭牌序列号 |
| 安装位置 | 楼层、区域、柜台或机器位 |
| 连接方式 | USB、局域网或其他 |
| 纸张能力 | A4 等 |
| 颜色能力 | 黑白、彩色 |
| 双面能力 | 单面或自动双面 |
| Windows 队列名 | 固定且唯一 |
| 维护状态 | 待安装、验收中、在线、维护、停用 |
二维码生成前，资产记录必须完整。
三、Windows 驱动和队列
1. 安装官方驱动
从打印机厂商官方渠道获取与 Windows 版本匹配的驱动。记录驱动版本和下载来源，不使用不明修改版。
2. 固定队列名
使用明确且唯一的队列名。例如单机试点为 EPSON L3250 Series；同一电脑管理同型号多台设备时，可以使用门店和机位后缀，但平台映射必须完全一致。
3. 固定默认参数
检查纸张、方向、颜色、边距、缩放、无边距和质量。平台明确传入的参数优先，驱动默认值不能偷偷改变订单结果。
4. 打印测试页
在接入代理前，先通过 Windows 手工打印测试页，排除 USB、网络、驱动和硬件问题。
四、代理身份注册
推荐流程
- 后台为门店生成一次性注册码。
- 安装程序在门店电脑输入或扫描注册码。
- 代理生成本机密钥对。
- 中心平台验证注册码，签发设备证书或绑定公钥。
- 注册码立即失效。
- 代理使用设备证书换取短期会话令牌。
每个代理凭证独立，支持轮换、吊销和失窃响应。不能让所有门店共用一个永久 API Key。
五、打印机映射配置
代理配置是平台打印机到本地队列的明确映射：
agentId: store-sz-001-agent-01
apiBaseUrl: https://print-api.munvor.com
credentialRef: windows-cert-store://zhenhaoyin-agent
printers:
- printerId: printer-sz-001-a
queueName: EPSON L3250 Series
maxConcurrent: 1
heartbeatSeconds: 30
leaseSeconds: 90
示例只展示字段，不包含真实凭证。敏感密钥保存在 Windows 证书存储或受控密钥容器。
六、多打印机心跳
代理分别采集每个 Windows 队列：
- 是否存在
- 当前作业数
- 暂停、离线或错误状态
- 最近错误代码
- 最近成功打印时间
- 当前处理任务
- 驱动版本和能力版本
代理自身还上报版本、运行时间、磁盘空间、系统时间偏差和升级状态。不能把一个队列的状态复制给多个平台打印机。
七、Windows Service
生产代理应打包为 Windows Service：
- 开机自动启动，不依赖用户登录。
- 使用最小权限专用账户。
- 崩溃自动重启，但有退避和重启次数告警。
- 日志写入
ProgramData下受控目录并自动轮转。 - 本地回执数据库定期完整性检查。
- 缓存文件有大小和时间上限。
- 低磁盘空间时停止领取新任务。
- 升级包必须签名并校验哈希。
自动升级采用内部设备、1 家试点门店、10%、50%、全量的灰度顺序。任何打印参数变化都暂停扩散。
八、二维码安装
- 后台生成该
printer_id的可轮换场景码。 - 在二维码下印设备名称、门店位置、支持能力和客服入口。
- 将二维码贴在对应实体设备上。
- 一人扫码、一人核对后台设备与 Windows 队列。
- 完成真实小额订单。
- 拍摄二维码、机器铭牌和测试样张作为验收证据。
静态机身码可长期使用，但场景别名必须能够在后台吊销和重新绑定。
九、新设备验收
- Windows 手工测试页正常
- 代理心跳显示正确队列和能力
- 扫码定位到正确门店和打印机
- 一页黑白 PDF 正确
- 多页彩色 PDF 正确
- JPG 和 PNG 正确
- 多份打印数量正确
- 不支持的 A3/双面参数被拒绝
- 缺纸、卡纸和离线状态可见
- 代理重启后不重复打印
- 门店电脑重启后服务自动恢复
- 二维码、平台设备和实体机器三者一致
只有全部通过，设备才能从 maintenance 改为 online。
十、Epson L3250 的使用定位
L3250 适合低成本、轻负载 A4 彩色试点。官方同系列资料可作为纸仓、速度和连接能力的初步参考，但具体地区版本仍以本机驱动和样张为准。
如果目标是长时间无人值守、高日印量、自动双面或更强错误监测，应尽早评估商用设备：更大纸仓、更可靠进纸、自动双面、可读取耗材和错误状态的管理协议，以及明确售后 SLA。