# sgprint

**Repository Path**: sg185/sgprint

## Basic Information

- **Project Name**: sgprint
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-29
- **Last Updated**: 2026-05-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 标签打印系统

一款基于 Python + PyQt6 开发的标签打印工具，支持扫码枪扫描、产品管理、模板设计等功能。

## 功能特性

- **扫码打印**: 支持扫码枪扫描产品编码，自动查询并打印标签
- **产品管理**: 录入和管理产品信息（编码、名称、重量、厂商等）
- **模板设计**: 可视化设计标签模板，支持文本、条码、二维码等元素
- **打印记录**: 记录所有打印历史，支持统计查询
- **多打印机支持**: 自动检测系统打印机，支持 DL-720C 等条码打印机

## 系统要求

- Windows 10/11 操作系统
- Python 3.11+ (开发环境)
- DL-720C 或其他 Windows 兼容打印机

## 扫码枪推荐

| 型号 | 特点 | 价格区间 |
|-----|------|---------|
| **斑马 DS2208** | 即插即用，USB键盘模式 | ¥600-900 |
| 霍尼韦尔 1900GSR | 工业级，二维扫描 | ¥800-1200 |
| 新大陆 HR22 | 国产优质，性价比高 | ¥400-600 |

## 安装运行

### 方法一：直接运行源码

```bash
# 1. 安装依赖
pip install -r requirements.txt

# 2. 运行程序
python main.py
```

### 方法二：构建可执行文件

```bash
# 运行构建脚本
build.bat
```

构建完成后，可执行文件位于 `dist/标签打印系统.exe`

## 使用说明

### 1. 首次使用

1. 连接打印机并安装驱动
2. 连接扫码枪（USB键盘模式）
3. 运行程序，在顶部选择打印机

### 2. 录入产品

1. 点击"产品管理"标签
2. 点击"新增产品"按钮
3. 填写产品信息并保存

### 3. 设计模板

1. 点击"模板设计"标签
2. 点击"新建模板"或编辑现有模板
3. 添加文本、条码等元素
4. 使用变量如 `{code}`、`{name}` 等
5. 保存模板

### 4. 扫码打印

1. 回到"扫码打印"页面
2. 使用扫码枪扫描产品编码
3. 系统自动查询产品信息
4. 选择模板和打印份数
5. 点击"立即打印"

## 模板变量

| 变量 | 说明 |
|-----|------|
| `{code}` | 产品编码 |
| `{name}` | 产品名称 |
| `{weight}` | 重量 |
| `{manufacturer}` | 厂商 |
| `{specification}` | 规格 |
| `{batch_no}` | 批次号 |
| `{production_date}` | 生产日期 |
| `{expiry_date}` | 有效期 |
| `{remark}` | 备注 |

## 项目结构

```
sgprint/
├── database/          # 数据库模块
│   ├── schema.sql     # 数据库结构
│   └── db_manager.py  # 数据库管理
├── models/            # 数据模型
├── services/          # 业务服务
│   ├── print_service.py    # 打印服务
│   ├── scanner_service.py  # 扫码服务
│   └── template_service.py # 模板服务
├── ui/                # 用户界面
│   ├── components/    # UI组件
│   ├── main_window.py # 主窗口
│   ├── print_view.py  # 打印页面
│   ├── product_manager.py  # 产品管理
│   ├── template_designer.py # 模板设计
│   └── print_history.py     # 打印记录
├── utils/             # 工具函数
└── __init__.py

main.py                # 程序入口
requirements.txt       # 依赖列表
build.bat             # 构建脚本
```

## 数据库

使用 SQLite3 本地数据库，数据文件存储在：
```
C:\Users\<用户名>\.sgprint\sgprint.db
```

## 许可证

MIT License