121 lines
2.8 KiB
Markdown
121 lines
2.8 KiB
Markdown
|
<div align="center">
|
|||
|
|
|
|||
|
|
# PrintDot Client
|
|||
|
|
|
|||
|
|
**中文** | [English](README_EN.md)
|
|||
|
|
|
|||
|
|
<img src="build/appicon.png" alt="PrintDot Client Logo" width="96" />
|
|||
|
|
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
## 简介
|
|||
|
|
|
|||
|
|
PrintDot Client 是一款基于 Wails 与 Vue 的桌面打印助手，主打“稳定、快速、好上手”。它将设备发现、连接管理与转发能力打包到一个轻量客户端里，让你用更少的配置成本，获得更高的打印链路稳定性与可用性。本项目是 [Vue Print Designer](https://github.com/0ldFive/Vue-Print-Designer) 的配套客户端。
|
|||
|
|
## 界面预览
|
|||
|
|
|
|||
|
|
<table>
|
|||
|
|
<tr>
|
|||
|
|
<td align="center">
|
|||
|
|
<img src="docs/images/1.png" width="300" alt="主界面" /><br />
|
|||
|
|
<em>主界面 - 设备状态与连接管理</em>
|
|||
|
|
</td>
|
|||
|
|
<td align="center">
|
|||
|
|
<img src="docs/images/2.png" width="300" alt="设置页面" /><br />
|
|||
|
|
<em>设置页面 - 偏好与配置选项</em>
|
|||
|
|
</td>
|
|||
|
|
</tr>
|
|||
|
|
</table>
|
|||
|
|
|
|||
|
|
## 优势
|
|||
|
|
|
|||
|
|
- 秒级启动与响应，日常操作几乎零等待
|
|||
|
|
- 稳定可靠的发现与转发链路，长时间运行也很安心
|
|||
|
|
- 跨平台一致体验，减少环境差异带来的折腾
|
|||
|
|
- 轻量架构、低资源占用，老机器也能顺滑跑
|
|||
|
|
- 细节打磨的设置与多语言体验，新手上手更快
|
|||
|
|
- 现代化界面与清晰信息层级，关键状态一眼可见
|
|||
|
|
|
|||
|
|
## 支持平台
|
|||
|
|
|
|||
|
|
- Windows
|
|||
|
|
- macOS
|
|||
|
|
- Linux
|
|||
|
|
|
|||
|
|
## 功能概览
|
|||
|
|
|
|||
|
|
- 自动发现与识别本地/网络设备
|
|||
|
|
- 稳定的连接维护与转发队列
|
|||
|
|
- 简洁的可视化状态与告警提示
|
|||
|
|
- 多语言界面与基础偏好设置
|
|||
|
|
- 适合长期后台运行的轻量模式
|
|||
|
|
|
|||
|
|
## 架构与模块
|
|||
|
|
|
|||
|
|
- 前端：Vue 3 + Vite + Tailwind，负责界面与交互
|
|||
|
|
- 桌面容器：Wails，提供跨平台窗口与系统能力
|
|||
|
|
- 后端：Go 服务层，负责发现、连接、转发与配置
|
|||
|
|
|
|||
|
|
## 安装与运行
|
|||
|
|
|
|||
|
|
### 开发模式
|
|||
|
|
|
|||
|
|
1. 安装 Wails 与 Node.js 依赖
|
|||
|
|
2. 运行开发命令
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
wails dev
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 生产构建
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
wails build
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### Windows
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
wails build -clean -nsis
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### macOS
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
wails build -clean -platform darwin/amd64
|
|||
|
|
wails build -clean -platform darwin/arm64
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
#### Linux
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
wails build -clean -platform linux/amd64
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 配置说明
|
|||
|
|
|
|||
|
|
- 配置文件由应用自动生成并维护
|
|||
|
|
- 可在设置页中调整设备与转发相关选项
|
|||
|
|
- 修改配置后即时生效，无需重启
|
|||
|
|
|
|||
|
|
## 常见问题
|
|||
|
|
|
|||
|
|
**Q: 设备没有出现或连接不稳定怎么办？**
|
|||
|
|
|
|||
|
|
- 请检查同一网络与防火墙放行
|
|||
|
|
- 重启客户端后重新发现
|
|||
|
|
- 若仍异常，请参考使用手册排查
|
|||
|
|
|
|||
|
|
**Q: 是否支持后台常驻？**
|
|||
|
|
|
|||
|
|
- 支持，应用优化了低资源占用与持续转发
|
|||
|
|
|
|||
|
|
## 贡献与开发
|
|||
|
|
|
|||
|
|
- 欢迎提交 Issue 与 Pull Request
|
|||
|
|
- 建议先阅读使用手册与配置说明，保持一致的行为与体验
|
|||
|
|
|
|||
|
|
## 使用手册
|
|||
|
|
|
|||
|
|
- 中文: [docs/usage_guide_zh.md](docs/usage_guide_zh.md)
|
|||
|
|
- English: [docs/usage_guide_en.md](docs/usage_guide_en.md)
|