### 业务背景
企事业单位局域网内通常按楼层分布多台打印机(含黑白与彩色机型)。普通共享打印
需要用户自行选择打印机,经常出现"就近的打印机排队、远处的空闲"以及"彩色稿件
被黑白机灰度打印"等问题。本系统以一台常驻主机为枢纽,提供一台**虚拟云打印机**:
用户只管向它打印,系统自动完成就近分配、彩稿择优、故障转移。
### 功能清单
* **IPP 虚拟打印机**:内置 IPP 1.1/2.0 服务端(`http://<本机IP>:631/ipp/print`),
Windows 添加打印机时选择 IPP 即可接入,免装驱动;仅声明 `image/pwg-raster`,
由 Windows 本地渲染位图,彻底绕开各型号打印机 PDF 解释器兼容性差异。
* **就近调度**:按 `|打印机楼层 - 任务来源楼层|` 升序择优,同楼层再按房间号由近
至远(双方房间号均为纯数字时生效),其后比较近 3 分钟负载与优先级权重。
* **色彩感知调度**:任务入库时逐像素检测稿件是否真实含彩色(灰度文档即使以
srgb_8 格式发送也能正确识别);彩色稿件只在"彩色打印机"候选集中按由近至远
分配,无可用彩机时降级灰度就近输出并记录日志,保证稿件不因色彩滞留。
* **位图转 PCL**:PWG Raster 位图在服务端转换为 PCL 指令流直发物理打印机——
黑白走 1bpp Floyd-Steinberg 抖动,彩色走 PCL 5c Direct by Pixel 模式
(含 Source Raster Width 声明),兼容 HP / 联想 / 震旦 / bizhub 等激光机型。
* **连入设备管理**:登记发送打印任务的设备(IP / MAC / 楼层 / 房间 / 科室),
支持 Excel 模板批量导入(自动校验格式、IP 去重、逐行反馈原因);任务到达时
按来源 IP 匹配名单(IP 变化时 ARP 反查 MAC 识别),以设备楼层作为调度起点,
未登记设备回退默认楼层。
* **设备发现**:一键扫描本机全部 /24 子网(9100/631/515 端口特征 + SNMP 读取
型号),支持手动添加与 Excel 批量导入,导入后自动探测在线状态。
* **故障转移与健康检查**:下发失败自动标记离线并尝试下一台;45 秒周期健康检查
使恢复的打印机自动重新上线。
* **Web 管理台**:Vue 3 + Element Plus 前端嵌入 exe,托盘菜单或浏览器打开
`http://127.0.0.1:631/` 管理打印机、连入设备、任务(含"彩稿"标记)、设置。
### 模块技术栈一览
| 模块 | 职责 | 关键技术 |
| --- | --- | --- |
| `internal/ipp` | IPP 虚拟打印机端点 | IPP 二进制编解码(自研)、操作码/属性标签、HTTP 多端点兼容 |
| `internal/rasterx` | PWG Raster → PCL 转换、色彩检测 | 页头偏移解析、Windows 私有行组压缩逆向解码、CUPS RLE、Floyd-Steinberg 抖动、PCL 5c 彩色指令 |
| `internal/dispatch` | 调度引擎 | 色彩过滤、多键稳定排序、故障转移、负载统计 |
| `internal/store` | 数据持久化 | JSON 原子写(tmp+fsync+rename)、滚动备份、启动恢复链、互斥锁 |
| `internal/discover` | 局域网扫描与健康检查 | TCP 探测、SNMP sysDescr、45s 周期巡检 |
| `internal/arpx` | IP 反查 MAC | Windows SendARP(`golang.org/x/sys`) |
| `internal/mdnsx` | 局域网服务广播 | `grandcat/zeroconf`(mDNS `_ipp._tcp`) |
| `internal/api` | REST API | `net/http` 路由,打印机/设备/任务/设置/统计接口 |
| `internal/webui` | 前端托管 | `go:embed` 静态资源 |
| `internal/trayapp` | 系统托盘 | `getlantern/systray`(图标、菜单、气泡通知) |
| `internal/autostart` | 开机自启 | 注册表 HKCU Run + `--minimized` |
| `internal/config` | 配置管理 | JSON 配置(端口/默认楼层/调度开关/实例 UUID) |
| `frontend/` | Web 管理台 | Vue 3 + TS + Vite + Element Plus + Pinia + xlsx |