新增 XSLPrintDot 项目,包含打印服务的核心功能和相关配置。实现打印机查询、打印任务处理、远程转发功能,并支持多平台设备ID获取。优化打印数据准备逻辑,增强系统的可维护性和扩展性,同时更新工作区配置以支持新项目。
This commit is contained in:
121
XSLPrintDot/README_EN.md
Normal file
121
XSLPrintDot/README_EN.md
Normal file
@@ -0,0 +1,121 @@
|
||||
<div align="center">
|
||||
|
||||
# PrintDot Client
|
||||
|
||||
[中文](README.md) | **English**
|
||||
|
||||
<img src="build/appicon.png" alt="PrintDot Client Logo" width="96" />
|
||||
|
||||
</div>
|
||||
|
||||
## Introduction
|
||||
|
||||
PrintDot Client is a desktop printing assistant built with Wails and Vue, focusing on "stability, speed, and ease of use". It packages device discovery, connection management, and forwarding capabilities into a lightweight client, allowing you to achieve higher printing stability and availability with less configuration effort. This project is the companion client for [Vue Print Designer](https://github.com/0ldFive/Vue-Print-Designer).
|
||||
|
||||
## Screenshots
|
||||
|
||||
<table>
|
||||
<tr>
|
||||
<td align="center">
|
||||
<img src="docs/images/1.png" width="300" alt="Main Interface" /><br />
|
||||
<em>Main Interface - Device Status & Connection Management</em>
|
||||
</td>
|
||||
<td align="center">
|
||||
<img src="docs/images/2.png" width="300" alt="Settings Page" /><br />
|
||||
<em>Settings Page - Preferences & Configuration</em>
|
||||
</td>
|
||||
</tr>
|
||||
</table>
|
||||
|
||||
## Advantages
|
||||
|
||||
- Instant startup and response, virtually zero wait for daily operations
|
||||
- Stable and reliable discovery and forwarding, worry-free for long-term running
|
||||
- Consistent cross-platform experience, less hassle from environment differences
|
||||
- Lightweight architecture with low resource usage, runs smoothly even on older machines
|
||||
- Polished settings and multilingual experience, easier for beginners
|
||||
- Modern interface with clear information hierarchy, key status visible at a glance
|
||||
|
||||
## Supported Platforms
|
||||
|
||||
- Windows
|
||||
- macOS
|
||||
- Linux
|
||||
|
||||
## Features
|
||||
|
||||
- Auto-discovery and identification of local/network devices
|
||||
- Stable connection maintenance and forwarding queue
|
||||
- Clean visual status and alert notifications
|
||||
- Multilingual interface and basic preferences
|
||||
- Lightweight mode suitable for long-term background running
|
||||
|
||||
## Architecture & Modules
|
||||
|
||||
- Frontend: Vue 3 + Vite + Tailwind for UI and interactions
|
||||
- Desktop Container: Wails for cross-platform windowing and system capabilities
|
||||
- Backend: Go service layer for discovery, connection, forwarding, and configuration
|
||||
|
||||
## Installation & Usage
|
||||
|
||||
### Development Mode
|
||||
|
||||
1. Install Wails and Node.js dependencies
|
||||
2. Run the development command
|
||||
|
||||
```bash
|
||||
wails dev
|
||||
```
|
||||
|
||||
### Production Build
|
||||
|
||||
```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
|
||||
```
|
||||
|
||||
## Configuration
|
||||
|
||||
- Configuration files are automatically generated and maintained by the application
|
||||
- Device and forwarding options can be adjusted in the settings page
|
||||
- Changes take effect immediately without restart
|
||||
|
||||
## FAQ
|
||||
|
||||
**Q: What if the device doesn't appear or the connection is unstable?**
|
||||
|
||||
- Check if devices are on the same network and firewall is properly configured
|
||||
- Restart the client and rediscover
|
||||
- If issues persist, refer to the user manual for troubleshooting
|
||||
|
||||
**Q: Does it support running in background?**
|
||||
|
||||
- Yes, the application is optimized for low resource usage and continuous forwarding
|
||||
|
||||
## Contributing
|
||||
|
||||
- Issues and Pull Requests are welcome
|
||||
- Please read the user manual and configuration guide first to maintain consistent behavior and experience
|
||||
|
||||
## User Manual
|
||||
|
||||
- 中文: [docs/usage_guide_zh.md](docs/usage_guide_zh.md)
|
||||
- English: [docs/usage_guide_en.md](docs/usage_guide_en.md)
|
||||
Reference in New Issue
Block a user