164 lines
3.0 KiB
Markdown
164 lines
3.0 KiB
Markdown
# 文章批量处理工具
|
||
|
||
一个强大的文章批量处理工具，支持文章提取、AI改写、图片处理等功能。
|
||
|
||
## 功能特性
|
||
|
||
- ✅ 多平台文章提取（头条、微信、网易等）
|
||
- ✅ AI智能改写（支持Coze等AI服务）
|
||
- ✅ 图片自动下载和处理
|
||
- ✅ 原创度检测
|
||
- ✅ 内容合规检测
|
||
- ✅ 多线程批量处理
|
||
- ✅ GUI和命令行双模式
|
||
|
||
## 快速开始
|
||
|
||
### 安装依赖
|
||
|
||
```bash
|
||
pip install -r requirements.txt
|
||
```
|
||
|
||
### 配置环境变量
|
||
|
||
```bash
|
||
cp .env.example .env
|
||
# 编辑 .env 文件，填写敏感信息
|
||
```
|
||
|
||
### 运行应用
|
||
|
||
**GUI模式：**
|
||
```bash
|
||
python ArticleReplace.py
|
||
```
|
||
|
||
**命令行模式：**
|
||
```bash
|
||
# 处理Excel文件
|
||
python cli.py --excel 文章链接.xlsx --threads 3
|
||
|
||
# 处理单个链接
|
||
python cli.py --link https://www.toutiao.com/article/123
|
||
|
||
# 查看帮助
|
||
python cli.py --help
|
||
```
|
||
|
||
## 开发
|
||
|
||
### 代码格式化
|
||
|
||
```bash
|
||
# 格式化代码
|
||
python dev.py format
|
||
|
||
# 或直接运行
|
||
python scripts/format_code.py
|
||
```
|
||
|
||
### 运行测试
|
||
|
||
```bash
|
||
# 运行测试
|
||
python dev.py test
|
||
|
||
# 运行测试并生成覆盖率报告
|
||
python dev.py test --coverage
|
||
```
|
||
|
||
### 代码检查
|
||
|
||
```bash
|
||
# 代码检查
|
||
python dev.py lint
|
||
|
||
# 类型检查
|
||
python dev.py typecheck
|
||
```
|
||
|
||
### 打包应用
|
||
|
||
```bash
|
||
# 打包应用
|
||
python dev.py build
|
||
|
||
# 清理构建文件
|
||
python dev.py clean
|
||
```
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
ArticleReplaceBatch/
|
||
├── src/ # 源代码
|
||
│ ├── ui/ # UI组件
|
||
│ │ ├── main_window.py # 主窗口
|
||
│ │ ├── main_frame.py # 主页面
|
||
│ │ ├── config_frame.py# 配置页面
|
||
│ │ └── ...
|
||
│ └── services/ # 服务层
|
||
│ ├── web_scraping.py # 网页抓取
|
||
│ ├── image_processing.py # 图片处理
|
||
│ └── ai_service.py # AI服务
|
||
├── tests/ # 测试
|
||
├── scripts/ # 开发脚本
|
||
├── config_manager.py # 配置管理
|
||
├── cli.py # 命令行接口
|
||
├── dev.py # 开发工具
|
||
└── ArticleReplace.py # GUI应用
|
||
```
|
||
|
||
## 配置说明
|
||
|
||
主要配置文件：
|
||
|
||
- `config.ini` - 应用配置
|
||
- `.env` - 环境变量（敏感信息）
|
||
- `pyproject.toml` - 项目配置
|
||
|
||
### 配置项
|
||
|
||
| 配置项 | 说明 |
|
||
|--------|------|
|
||
| Coze.workflow_id | Coze工作流ID |
|
||
| Coze.access_token | Coze访问令牌 |
|
||
| General.max_threads | 最大线程数 |
|
||
| General.articles_path | 文章保存路径 |
|
||
| General.images_path | 图片保存路径 |
|
||
|
||
## 测试
|
||
|
||
```bash
|
||
# 运行所有测试
|
||
pytest tests/ -v
|
||
|
||
# 运行特定测试
|
||
pytest tests/test_config.py -v
|
||
|
||
# 生成覆盖率报告
|
||
pytest tests/ --cov=. --cov-report=html
|
||
```
|
||
|
||
## 代码质量
|
||
|
||
项目使用以下工具保证代码质量：
|
||
|
||
- **Black** - 代码格式化
|
||
- **isort** - 导入排序
|
||
- **mypy** - 类型检查
|
||
- **flake8** - 代码检查
|
||
- **pylint** - 代码审查
|
||
|
||
## 许可证
|
||
|
||
MIT License
|
||
|
||
## 贡献
|
||
|
||
欢迎提交问题和拉取请求！
|
||
|
||
## 联系方式
|
||
|
||
如有问题，请提交Issue。 |