🚀 现代化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!