澄曜打印共享

一、产品定位

一款运行在 Windows 上的局域网打印机轻量共享工具。把任意一台电脑上连接的真实打印机，变成局域网内其他人都能「一键连接」的共享打印机，无需配置 Windows 打印服务器、无需域环境、数据全程本地不上云。

适用场景：小办公室、家庭、工作室里只有一台电脑接了打印机，其他人想直接用，但碍于系统原生共享步骤繁琐、权限坑多、跨版本驱动不兼容而搞不定。

二、核心能力

• 主机端共享：在接了打印机的电脑上开启共享，自动监听局域网 IPP（631 端口）与 RAW（9100 端口）打印请求，对外暴露一个访问码。
• 客户端一键连接：在另一台电脑上输入主机访问码，自动通过 PowerShell 添加虚拟 IPP 打印机，无需手动找驱动、不用知道主机 IP。
• 内置打印引擎：集成 SumatraPDF 打印引擎（安装时随包落地，零额外安装），自动把客户端发来的 PDF 交给 Windows 打印子系统输出。解决了不少本地打印机（Samsung、部分 HP/LaserJet）「闪灯不吐纸」的裸 PDF 不打印问题。
• 实时日志 + 双端自检：主机/客户端均可查看连接日志，提供主机自检、客户端自检快速定位问题。
• 托盘常驻：点击窗口关闭按钮最小化到系统托盘而非退出，IPP 服务继续后台运行；右键托盘可「显示窗口 / 退出」。

三、技术架构

• 框架：Tauri 2（Rust 后端 + Web 前端），编译目标 x86_64-pc-windows-gnu，单文件体积小（安装包约 8.3 MB）。
• 后端（Rust）：
• core/ipp.rs：基于 tokio TcpSocket（SO_REUSEADDR）的 IPP/RAW 监听服务，监听线程句柄存入状态，停止共享时真正 abort 释放端口（修复了 10048 端口占用）。
• core/spooler.rs：PowerShell 脚本幂等添加 IPP 打印机，能识别「端口已存在 / 打印机已存在」并自动清理重试，不再误导用户去开 IPP 功能。
• core/state.rs / core/logger.rs：运行状态与本地日志模块。
• 前端（Web）：React + TypeScript，侧栏导航（主页 / 日志 / 关于），日志页支持查看、复制、打开文件夹。
• 打包：NSIS 安装包 + 便携 zip 双形态；PE manifest 注入 Common-Controls v6（托盘依赖）与 requireAdministrator（添加打印机需提权）。

四、使用流程

1. 主机：打开软件 → 开启共享 → 记下自动生成的访问码（含局域网地址）。
2. 客户端：打开软件 → 输入访问码 → 点「一键连接」→ 自动添加虚拟打印机，选它为默认即可像本地打印机一样使用。
3. 日常：窗口关掉也不用管，托盘里常驻；要彻底退出右键托盘选「退出」。