🚀 现代化PT资源发布助手 - 重构版本
本版本是对原项目的全面重构,在完全保持向后兼容性的同时,大幅提升了代码质量和开发体验:
🏗️ 现代化架构 - 模块化设计,符合Python最佳实践
⚙️ 智能配置 - 分层配置系统,支持环境变量覆盖
📝 专业日志 - 彩色输出,结构化记录
🛡️ 类型安全 - 完整的异常体系和类型检查
🧪 测试保证 - 完整的测试框架和代码覆盖
🔧 开发工具 - 自动化代码质量保证
- 🎬 自动获取PT-Gen简介信息 - 支持多个API源
 - 📋 MediaInfo信息提取 - 智能媒体分析
 - 📸 自动截图生成 - 可配置截图参数
 - 🖼️ 缩略图制作 - 自动生成预览图
 - ☁️ 图床上传 - 支持多种图床服务
 - 🏷️ 智能命名 - 根据模板自动生成标题和文件名
 - 📁 文件整理 - 自动创建目录结构
 - 🌱 种子制作 - 一键生成torrent文件
 
- 📺 剧集批量处理 - 支持批量重命名和分集处理
 - 🔗 硬链接支持 - 节省存储空间
 - 🎭 短剧特殊处理 - 专门的短剧命名和简介生成
 - 🚀 API接口 - 完整的RESTful API
 - 🐳 Docker支持 - 容器化部署
 
# 克隆项目
git clone https://github.com/your-username/publish-helper.git
cd publish-helper
# 安装依赖
pip install -r requirements.txt
# 配置环境(可选)
cp .env.example .env
# 编辑 .env 文件配置你的API密钥# GUI模式
python src/main_gui_new.py
# API模式  
python src/main_api_new.py
# 原有方式依然支持
python src/main_gui.py
python src/main_api.py# 使用docker-compose
docker-compose up -d
# 或直接构建
docker build -t publish-helper .
docker run -p 15372:15372 publish-helper创建 .env 文件:
# API配置
API_PORT=15372
API_DEBUG=false
# PT-Gen配置
PTGEN_API_URL=https://ptgen.agsvpt.work/
PTGEN_API_KEY=your_api_key
# 图床配置
IMAGE_HOST_TYPE=freeimage
IMAGE_HOST_API_KEY=your_image_host_key
# 日志配置
LOG_LEVEL=INFO
LOG_FILE=logs/app.log- 薄荷图床 - 需要API密钥
 
# 安装开发依赖
pip install -r requirements-dev.txt
# 安装pre-commit钩子
pre-commit install
# 运行测试
pytest tests/ -v --cov=src# 代码格式化
black src/ tests/
isort src/ tests/
# 代码检查
flake8 src/ tests/
mypy src/
# 或使用Makefile
make format  # 格式化代码
make lint    # 代码检查
make test    # 运行测试publish-helper/
├── src/
│   ├── config/            # 配置管理
│   │   ├── __init__.py
│   │   └── settings.py
│   ├── utils/             # 工具模块
│   │   ├── logger.py      # 日志系统
│   │   ├── exceptions.py  # 异常定义
│   │   └── file_utils.py  # 文件工具
│   ├── core/              # 核心功能
│   ├── gui/               # GUI界面
│   ├── api/               # API接口
│   ├── main_gui_new.py    # GUI入口
│   └── main_api_new.py    # API入口
├── tests/                 # 测试代码
├── docs/                  # 文档
├── requirements.txt       # 生产依赖
├── requirements-dev.txt   # 开发依赖
└── docker-compose.yml     # Docker配置
欢迎贡献代码!请遵循以下步骤:
- Fork 项目
 - 创建功能分支 (
git checkout -b feature/amazing-feature) - 提交更改 (
git commit -m 'Add amazing feature') - 推送到分支 (
git push origin feature/amazing-feature) - 创建 Pull Request
 
- 遵循 PEP 8 代码风格
 - 使用 Black 进行代码格式化
 - 添加类型注解
 - 编写测试用例
 - 更新文档
 
- 现代化项目架构
 - 分层配置管理系统
 - 专业日志框架
 - 完整的异常处理体系
 - 自动化开发工具链
 - 完整的测试框架
 
- 代码质量大幅提升
 - 更好的错误处理
 - 改进的Docker配置
 - 完善的文档系统
 
- 完全向后兼容
 - 保持所有原有功能
 - 现有配置自动迁移
 
本项目基于 GNU General Public License v3.0 开源。
- bjdbjd - 原作者和主要维护者
 - Pixel-LH - 核心贡献者
 - EasonWong0603 - 功能开发
 - sertion1126 - Docker支持
 - TommyMerlin - 功能改进
 
感谢所有为项目贡献代码、报告问题、提供建议的开发者和用户!
如果这个项目对你有帮助,请给我们一个 ⭐ Star!