ptcg-card
PTCG 卡图生成器
一个功能完善的 PTCG 繁体中文卡图下载和 Word 文档生成工具，专为宝可梦卡牌玩家设计。
功能特点
核心功能
- ✅ 图形化界面 - 现代化暗色主题，简洁直观的操作界面
- ✅ 卡片搜索 - 内置搜索功能，支持官网 API 实时查询卡片
- ✅ 图片预览 - 搜索结果显示卡片缩略图，可视化选择
- ✅ 简繁转换 - 内置简繁转换工具，方便繁体中文搜索
- ✅ 图片缓存 - 智能缓存机制，已下载的卡片自动使用缓存
- ✅ 批量生成 - 支持一次性生成多张卡片，可自定义数量
- ✅ 自定义文件名 - 灵活指定输出文件名，支持冲突检测
- ✅ 历史记录 - 完整的文档管理功能，查看/打开/删除
- ✅ 智能布局 - 自动按 3 列排列卡片，A4 纸完美适配
- ✅ 进度显示 - 实时下载进度条，状态信息清晰可见
快捷操作
- 🚀 一键搜索 - 直接在程序内搜索卡片，无需切换浏览器
- 📋 批量选择 - 搜索结果中快速选择多张卡片并指定数量
- 💾 示例加载 - 内置示例卡片，快速上手体验
- 🔄 自动缓存 - 重复下载自动使用本地缓存，提升速度
使用方法
方式一：直接运行 EXE（推荐）
- 下载
dist/PTCG卡图生成器.exe - 双击运行即可使用
方式二：源码运行
- 安装依赖：
pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/ - 运行程序：
python main_gui.py - 或使用启动脚本（Windows）：
启动.cmd
详细功能说明
1. 卡片搜索
方式一：内置搜索
- 在 “🔍 卡片搜索” 输入框中输入卡片名称
- 点击 “🔎 搜索” 按钮（或按回车）
- 在弹出的预览窗口中查看搜索结果
- 点击 “✓ 选择” 按钮，输入需要的数量
- 卡片编号自动添加到输入框
提示：使用繁体中文搜索效果更好，可使用内置的 “🔤 简繁转换” 功能
方式二：官网搜索
点击右上角的 “🔍 卡片搜索官网” 按钮，自动打开浏览器跳转到 PTCG 香港官网的卡片搜索页面。
在官网找到想要的卡片编号后，复制编号回到程序输入。
2. 输入格式
每行输入一个卡片编号，格式如下：
# 注释行（以 # 开头会被忽略）
8065 # 编号，默认插入 4 张
8066 2 # 编号，后面空格跟数量，插入 2 张
7311 5 # 另一张卡片，插入 5 张
快捷操作：
- 点击 “📝 加载示例” 可快速加载示例内容
- 点击 “🗑️ 清空” 可清空输入框
3. 简繁转换
在 “🔤 简繁转换” 输入框中输入简体中文：
- 点击 “🔄 转换” 按钮
- 文字自动转换为繁体中文
- 结果自动填充到搜索输入框
4. 自定义文件名
在 “📁 自定义文件名” 输入框中填写文件名（可选）：
- 留空：自动使用时间戳命名（如
20260209123456.docx） - 填写：使用指定名称（如
我的卡组.docx） - 冲突处理：如果文件已存在，会弹出确认对话框询问是否覆盖
5. 生成 Word 文档
- 输入或选择卡片编号
- （可选）指定自定义文件名
- 点击 “✨ 生成Word文档” 按钮
- 等待下载和生成完成
- 完成后会弹出提示，显示文件位置和缓存使用情况
生成的文档保存在 output 文件夹中。
6. 历史记录管理
点击 “📚 历史记录” 按钮打开历史记录窗口，可以：
- 📖 打开文件 - 直接打开选中的 Word 文档
- 📂 打开文件夹 - 打开 output 文件夹
- 🔄 刷新 - 刷新文件列表
- 🗑️ 删除 - 删除不需要的文件（需确认）
历史记录显示：
- 文件名
- 修改时间
- 文件大小
文件结构
ptcg-card/
├── main_gui.py # 图形化界面主程序
├── main.py # 命令行版本（基础实现）
├── requirements.txt # Python 依赖列表
├── ptcg_card.spec # PyInstaller 打包配置
├── template.docx # Word 文档模板
├── mumu.ico # 应用程序图标
├── card.txt # 示例卡片编号
├── 启动.cmd # Windows 快速启动脚本
├── 打包.cmd # Windows 快速打包脚本
├── output/ # 生成的 Word 文档目录（自动创建）
└── tmp/ # 卡片图片缓存目录（自动创建）
技术栈
- Python 3.13 - 核心编程语言
- tkinter - 原生 GUI 界面
- requests - HTTP 请求下载图片
- Pillow (PIL) - 图片处理和缩放
- python-docx - Word 文档操作
- tqdm - 进度条显示
- zhconv - 简繁中文转换（可选依赖）
- beautifulsoup4 - HTML 解析（可选依赖）
- PyInstaller - 打包成 EXE 文件
可选依赖
以下依赖为可选功能，不影响核心使用：
# 简繁转换功能
pip install zhconv
# 提升搜索解析能力
pip install beautifulsoup4
打包成 EXE
如果要重新打包成 EXE：
Windows 快速打包
打包.cmd
手动打包
pyinstaller ptcg_card.spec
打包后的文件位于 dist/PTCG卡图生成器.exe
注意事项
- 打包前请确保
template.docx和mumu.ico文件存在 - 建议在 Windows 环境下进行打包
- 打包后的 EXE 文件已包含所有必需依赖
常见问题
Q: 搜索功能提示”未找到匹配的卡片”
A: PTCG 官网使用繁体中文索引，建议使用简繁转换功能后再次搜索。
Q: 图片下载失败
A: 可能是网络问题，请检查网络连接或稍后重试。
Q: 生成的 Word 文档打开报错
A: 请确保 template.docx 文件存在且未被损坏。
Q: 如何清空缓存
A: 直接删除 tmp 文件夹即可，程序会自动重新创建。
项目截图
（可添加项目界面截图）
许可证
本项目基于 Apache License 2.0 开源。
致谢
- PTCG 香港官网 - 提供卡片图片和搜索 API
- 所有贡献者
更新日志
v1.0.0
- ✨ 初始版本发布
- 🎨 现代化暗色主题界面
- 🔍 内置卡片搜索功能
- 🔄 简繁转换工具
- 📚 历史记录管理
- 💾 智能图片缓存