# 熊猫福利发卡

**Repository Path**: hongliu666/panda-welfare-card-issuance

## Basic Information

- **Project Name**: 熊猫福利发卡
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-17
- **Last Updated**: 2025-10-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 快捷发卡 v1.0

一个强大的Windows桌面应用程序，用于通过全局快捷键管理和快速分发卡密/激活码。

## ✨ 核心功能

### 🎯 卡密管理
- **多规格支持** - 创建和管理多个卡密规格/分类
- **批量导入** - 支持一次性添加多个卡密
- **库存追踪** - 实时显示每个规格的剩余数量
- **使用历史** - 完整记录每个卡密的使用时间

### ⌨️ 快捷键系统
- **全局快捷键** - 在任何Windows应用中都能工作
- **灵活配置** - 支持单个按键或组合键
- **自动检测** - 智能识别按下的快捷键
- **冲突避免** - 自动处理快捷键冲突

### 💾 数据管理
- **MySQL数据库** - 云端存储，数据安全可靠
- **自动备份** - 一键导出数据到本地文件
- **数据迁移** - 从旧版本txt文件无缝迁移
- **实时同步** - 多设备间数据实时同步

## 🚀 快速开始

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

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

## 📖 使用指南

### 1. 添加规格
1. 点击"添加规格"按钮
2. 输入规格名称（如：游戏激活码、软件许可证等）
3. 系统自动分配快捷键（F1、F2...）

### 2. 设置快捷键
1. 选择规格，点击"设置快捷键"
2. 点击"开始检测"
3. 按下你想要的快捷键（支持单键或组合键）
4. 系统自动识别并设置

**支持的快捷键类型：**
- 单个按键：F1-F12、A-Z、0-9、方向键等
- 组合键：Ctrl+A、Alt+F1、Shift+S等
- 多重组合：Ctrl+Alt+A等

### 3. 添加卡密
1. 选择对应规格
2. 在文本框中输入卡密（每行一个）
3. 点击"添加卡密"
4. 系统自动去重并添加

### 4. 使用快捷键分发
1. 在任意Windows应用中
2. 按下设置的快捷键
3. 卡密自动复制到剪贴板并粘贴
4. 库存自动减少

### 5. 数据管理
- **查看库存** - 显示所有规格的库存情况
- **统计信息** - 查看详细的使用统计
- **备份数据** - 导出数据到backup文件夹
- **刷新** - 手动刷新界面显示

## 🛠️ 技术架构

### 前端界面
- **框架**: Tkinter
- **特性**: 响应式布局、用户友好界面

### 后端数据
- **数据库**: MySQL 8.0+
- **连接**: PyMySQL驱动
- **特性**: 事务支持、索引优化

### 系统集成
- **快捷键**: keyboard库实现全局钩子
- **剪贴板**: pyperclip实现跨平台支持
- **平台**: Windows专用优化

## 📊 数据库结构

### specs 表（规格表）
```sql
CREATE TABLE specs (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(100) NOT NULL UNIQUE,
    hotkey VARCHAR(50),
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);
```

### cards 表（卡密表）
```sql
CREATE TABLE cards (
    id INT AUTO_INCREMENT PRIMARY KEY,
    spec_id INT NOT NULL,
    content TEXT NOT NULL,
    is_used BOOLEAN DEFAULT FALSE,
    used_at DATETIME NULL,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    FOREIGN KEY (spec_id) REFERENCES specs(id) ON DELETE CASCADE
);
```

## 🔧 配置文件

### MySQL连接配置
默认连接信息在 `core/mysql_database.py` 中：
```python
host='154.9.235.140'
port=3306
user='fulifaka'
password='Li714810.'
database='fulifaka'
```

## 📁 项目结构
```
快捷发卡_v1.0/
├── main.py                    # 程序入口
├── requirements.txt           # 依赖列表
├── CLAUDE.md                 # 项目指导
├── README.md                 # 项目说明
├── core/                     # 核心模块
│   ├── card_manager.py       # 卡密管理
│   ├── mysql_database.py     # 数据库操作
│   ├── hotkey_manager.py     # 快捷键管理
│   └── clipboard_utils.py    # 剪贴板工具
├── ui/                       # 用户界面
│   └── main_window.py        # 主窗口
├── data/                     # 数据目录
└── backup/                   # 备份目录
```

## 🎯 使用场景

- **游戏零售商** - 快速分发游戏激活码
- **软件供应商** - 管理软件许可证密钥
- **电商客服** - 高效处理卡密订单
- **系统管理员** - 批量分发访问凭证

## 🔒 安全特性

- **数据加密** - MySQL数据库连接加密
- **访问控制** - 基于用户权限的数据访问
- **使用追踪** - 完整的卡密使用日志
- **备份机制** - 定期数据备份防止丢失

## 🐛 故障排除

### 快捷键不工作
1. 检查是否以管理员权限运行
2. 确认快捷键没有被其他程序占用
3. 重新设置快捷键

### 数据库连接失败
1. 检查网络连接
2. 验证数据库服务器状态
3. 确认连接凭据正确

### 程序无法启动
1. 确认Python环境正确
2. 安装所有依赖包
3. 检查文件权限

## 📈 版本历史

### v1.0 (2024-09-16)
- ✅ 基础卡密管理功能
- ✅ 全局快捷键支持
- ✅ MySQL数据库集成
- ✅ 自动数据迁移
- ✅ 数据备份功能
- ✅ 统计信息显示

## 📞 支持

如需技术支持或报告问题，请联系开发团队。

---

**快捷发卡 v1.0** - 让卡密分发更高效！ 🚀