v1.1.1

PrintHub v1.1.1

Patch release：修复桌面版在网络抖动时 mDNS 导致主进程崩溃，并统一 Web / 托盘图标为 Reicon。

---

下载 / Downloads

平台 Platform	文件 File	适用 For
macOS	PrintHub-1.1.1-mac-arm64.dmg	Apple 芯片 (M 系列)
macOS	PrintHub-1.1.1-mac-x64.dmg	Intel (x64)
Windows	PrintHub-1.1.1-win-x64.exe	Windows 10/11 x64

M 系列 Mac 下载 arm64 包，Intel Mac 下载 x64 包。

---

本版本修复 / Fixes

• mDNS 网络错误不再弹崩溃对话框 — Wi‑Fi 断开/唤醒/VPN 切换时，EADDRNOTAVAIL 224.0.0.251:5353 仅记录日志，TCP :9100 打印不受影响
• Reicon 图标统一 — Web 工具栏与 Desktop 托盘菜单使用 reicon-react / 统一 glyph 风格

---

完整变更 / Full changelog

v1.1.0...v1.1.1

---

MIT · README

v1.1.0

PrintHub v1.1.0

PrintHub 是局域网虚拟打印机：接收 POS / 收银机发出的 ESC/POS 小票与 TSPL 标签原始字节流，在浏览器中实时预览、查看历史，并支持调试打印与打印机场景模拟。

---

下载 / Downloads

平台 Platform	文件 File	适用 For	体积 Size
macOS	PrintHub-1.1.0-mac-arm64.dmg	Apple 芯片 (M 系列)	~110 MB
macOS	PrintHub-1.1.0-mac-x64.dmg	Intel (x64)	~110 MB
Windows	PrintHub-1.1.0-win-x64.exe	Windows 10/11 x64	~99 MB

M 系列 Mac 下载 arm64 包，Intel Mac 下载 x64 包。

---

安装说明 / Installation

未签名 / Unsigned builds

发布版 未做代码签名（无 Apple Developer ID / Windows Authenticode）：

• macOS：首次打开可能被拦截 → 右键 PrintHub → 打开，或在 系统设置 → 隐私与安全性 中允许
• Windows：SmartScreen 可能提示 → 更多信息 → 仍要运行

快速开始 / Quick start

1. 安装并启动 PrintHub（菜单栏 / 系统托盘会出现图标）
2. TCP 9100 始终可用 — 将 POS 指向 <本机IP>:9100
3. 局域网 HTTP 默认 关闭，可在托盘菜单中开启（端口 8081）
4. 打开内置 Web 控制台 — 预览、历史、调试打印、场景模拟

在线 UI 演示（无 TCP）： https://jackieleee.github.io/PrintHub/

---

本版本亮点 / Highlights

Inspector 检查器

• 指令块列表 — Setup / Preview / 复合块（QR、文本+样式）分组展示
• 预览联动 — 点击可预览块高亮对应区域；走纸、行距等恢复可点击
• 中英文 — 指令类别与块标题完整 i18n

导出 Export

• PNG / PDF — 预览渲染完成后导出；TSPL 按标签物理尺寸（如 40×30 mm）生成 PDF
• Hex / Base64 / 指令 / 原始文件 — 与历史任务一并导出

Agent 友好 Analyze API

• 新包 @virt-printer/analyze — JSON 结构化解析（commands、blocks、summary）
• CLI：pnpm exec printhub-analyze <file.bin> — 适合 Agent 与 CI

协议拟真 Protocol

• ESC/POS — GS ( N 字符表、GS ( A 打印浓度；Star ESC *、ESC GS ) E/I、切纸扩展
• TSPL — PUTBMP / PUTPCX、CODEPAGE、BLINE 等；手册补全 38 条 TSPL + Star 扩展分组
• Star 方言 — 自动检测并在预览区显示 Star 徽章；命令手册标注 标准 / Star / 通用

质量 Fixtures

• 新包 @virt-printer/fixtures — 18 条 ESC/POS + TSPL 回归样本与快照测试

---

系统要求 / Requirements

	macOS	Windows
架构	arm64 或 x64	x64
版本	12+ 推荐	10 / 11

开发者模式：Node.js 20+、pnpm 9+ — 见 README

---

完整变更 / Full changelog

v1.0.0...v1.1.0

---

MIT · README · SECURITY

v1.0.0

PrintHub v1.0.0

PrintHub 是局域网虚拟打印机：接收 POS / 收银机发出的 ESC/POS 小票与 TSPL 标签原始字节流，在浏览器中实时预览、查看历史，并支持调试打印与打印机场景模拟。

---

下载 / Downloads

平台 Platform	文件 File	适用 For	体积 Size
macOS	PrintHub-1.0.0-arm64.dmg	Apple 芯片 (M 系列)	~113 MB
macOS	PrintHub-1.0.0-universal.dmg	Apple 芯片 + Intel	~201 MB
Windows	PrintHub.Setup.1.0.0.exe	Windows 10/11 x64	~99 MB

M 系列 Mac 建议下载 arm64 包，体积更小。Intel Mac 请用 universal 包。

---

安装说明 / Installation

未签名 / Unsigned builds

发布版 未做代码签名（无 Apple Developer ID / Windows Authenticode）：

• macOS：首次打开可能被拦截 → 右键 PrintHub → 打开，或在 系统设置 → 隐私与安全性 中允许
• Windows：SmartScreen 可能提示 → 更多信息 → 仍要运行

快速开始 / Quick start

1. 安装并启动 PrintHub（菜单栏 / 系统托盘会出现图标）
2. TCP 9100 始终可用 — 将 POS 指向 <本机IP>:9100
3. 局域网 HTTP 默认 关闭，可在托盘菜单中开启（端口 8081）
4. 打开内置 Web 控制台 — 预览、历史、调试打印、场景模拟

在线 UI 演示（无 TCP）： https://jackieleee.github.io/PrintHub/

---

本版本亮点 / Highlights

桌面端 Desktop

• Electron 集成 Bridge — TCP 9100 + 可选 LAN HTTP/WebSocket，无需单独跑 CLI
• 菜单栏 / 系统托盘 — Bridge / TCP / mDNS / LAN 状态、复制局域网地址、HTTP 端口、重启 Bridge
• 中英文 — Header 与托盘 Language 子菜单双向同步，持久化到 settings.json
• macOS — arm64 + universal 双 DMG；托盘状态用 🟢🟡🔴 label 前缀
• Windows — NSIS 安装包；无边框窗口 + macOS 风格红黄绿按钮；浅色托盘图标

Web 控制台

• 工作台 — 左侧虚拟打印机 + 右侧「网络与端口 / 调试打印」Tab
• 预览 — ESC/POS 小票 & TSPL 标签 Canvas 渲染（Code128、QR、位图、反白等）
• 历史 — 最近 50 条任务，回放与导出（File / Hex / Base64）
• 调试打印 — 一键 Sample、Raw 提交（可离线本地预览）、内联命令手册
• 打印机模拟 — 正常 / 缺纸 / 开盖 / 离线 / 慢响应 / 拒打；钱箱脉冲检测；事件日志
• 主题 — 10 套 UI 主题；English / 中文

网络 Network

• mDNS — 广播 _pdl-datastream._tcp · 端口 9100，便于 POS / macOS 发现打印机
• 端口 — TCP 9100（打印数据，始终开启）；HTTP 8081（Web UI + API + WebSocket）

---

系统要求 / Requirements

	macOS	Windows
架构	arm64 或 x64 (universal)	x64
版本	12+ 推荐	10 / 11

开发者模式：Node.js 20+、pnpm 9+ — 见 README

---

完整变更 / Full changelog

f7176cc...v1.0.0

---

License: MIT