# py-tools

**Repository Path**: no-oars/py-tools

## Basic Information

- **Project Name**: py-tools
- **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-09-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 日常工具集合

这是一个用于存储各种日常工具的项目，按功能分类整理。

## 📁 项目结构

```
tools/
├── image_tools/          # 图片处理工具
├── report_tools/         # 报告生成工具
├── file_tools/           # 文件处理工具
├── network_tools/        # 网络相关工具
└── README.md            # 项目说明文档
```

## 🛠️ 工具列表

### 📸 图片处理工具 (image_tools/)

#### download_images.py - 批量图片下载工具

- **功能**: 从 URL 列表批量下载图片并压缩到 ZIP 文件
- **特点**:
  - 支持批量下载
  - 自动按下标顺序命名
  - 错误处理和重试机制
  - 自动清理临时文件
  - 进度显示

**使用方法**:

```bash
cd image_tools
pip install -r requirements.txt
python download_images.py
```

### 📊 报告生成工具 (report_tools/)

#### weekly_report.py - Git 周报生成工具

- **功能**: 从 Git 提交记录自动生成工作周报
- **特点**:
  - 自动分析提交记录
  - 智能分类工作内容
  - 统计文件修改情况
  - 支持多周期报告
  - 支持指定作者过滤
  - 修复了 Windows 编码问题
  - 改进的错误处理机制

**使用方法**:

```bash
cd report_tools

# 生成本周周报
python weekly_report.py

# 生成上周周报
python weekly_report.py --week -1

# 指定作者生成周报
python weekly_report.py --author "张三"

# 保存周报到文件
python weekly_report.py --save

# 指定输出文件名
python weekly_report.py --save --output my_report.txt

# 指定Git仓库路径
python weekly_report.py --repo /path/to/repo
```

**参数说明**:

- `--repo, -r`: Git 仓库路径 (默认: 当前目录)
- `--author, -a`: 指定作者名称 (默认: 当前 Git 用户)
- `--week, -w`: 周偏移量 (0=本周, -1=上周, -2=上上周...)
- `--save, -s`: 保存报告到文件
- `--output, -o`: 指定输出文件名

**周报内容包括**:

- 📊 基本统计信息 (提交数量、时间范围)
- 📋 工作内容分类 (新功能、Bug 修复、代码优化等)
- 📁 主要修改文件统计
- 📊 文件类型分布统计

**其他工具**:

- `test_weekly_report.py`: 测试脚本，验证工具功能
- `troubleshooting.md`: 故障排除指南
- `demo_report.txt`: 示例周报输出
- `demo_with_multiline.py`: 多行提交信息处理演示

**新功能 (v1.2)**:

- ✅ 支持多行提交信息解析
- ✅ 自动保存到 `report/` 文件夹
- ✅ 智能文件名: `周报_2025年第26周_0623-0629.txt`
- ✅ 改进的提交分类算法

### 📄 文件处理工具 (file_tools/)

_待添加工具_

### 🌐 网络相关工具 (network_tools/)

_待添加工具_

### 🎙️ 语音合成工具

#### qwen_tts_test.py - Qwen-TTS 语音合成测试工具

- **功能**: 基于图片台词测试 Qwen-TTS 语音合成 API
- **特点**:
  - 支持多角色对话语音合成
  - 支持中文方言音色 (北京话、上海话、四川话)
  - 两种测试模式：多方言版 vs 统一方言版
  - 自动保存到 qwen/ 文件夹
  - 智能文件命名和分类

#### qwen_unified_dialect_test.py - 统一方言测试工具

- **功能**: 所有角色使用统一方言但不同音色的语音合成测试
- **特点**:
  - 统一使用北京话，通过不同音色区分角色
  - 包含方言对比功能（标准话/北京话/上海话/四川话）
  - 音色分配：Dylan 男声、Cherry 甜美、Ethan 成熟、Serena 优雅、Chelsie 严厉
  - 便于对比不同音色在同一方言下的表现效果

**使用方法**:

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

# 设置API密钥
set DASHSCOPE_API_KEY=your_api_key

# 运行完整测试（每个角色不同方言）
python qwen_tts_test.py

# 运行统一方言测试（所有角色同一方言不同音色）
python qwen_unified_dialect_test.py

# 运行简化测试
python qwen_simple_test.py
```

**支持的音色**:

- **中英双语**: Cherry, Ethan, Chelsie, Serena
- **中文方言**: Dylan (北京话), Jada (上海话), Sunny (四川话)

**配置说明**:

- **多方言版本**: 详见 `qwen/角色方言配置说明.md`

  - 北京话 (Dylan): 邻居 1、保安队长等权威角色
  - 上海话 (Jada): 邻居 2、房东、江城同学等精明角色
  - 四川话 (Sunny): 邻居 3、江城、路人等普通民众角色

- **统一方言版本**: 所有角色使用北京话，通过音色区分
  - Dylan: 男性角色（邻居 1、江城）
  - Cherry: 温和女性（路人甲、邻居 2）
  - Ethan: 权威男性（邻居 3、保安队长）
  - Serena: 优雅女性（江城同学、路人乙）
  - Chelsie: 严厉女性（房东）

## 🚀 快速开始

1. 克隆或下载项目到本地
2. 进入对应工具目录
3. 安装依赖 (如果有 requirements.txt)
4. 运行工具

## 🛠️ 故障排除

如果遇到问题，请参考：

- `report_tools/troubleshooting.md` - 详细的故障排除指南
- 运行测试脚本：`python report_tools/test_weekly_report.py`

**常见问题**:

- Windows 编码错误：已在最新版本中修复
- Git 仓库未找到：确保在 Git 仓库目录中运行
- 没有提交记录：检查时间范围和作者名称

## 📝 贡献指南

欢迎添加新的实用工具！请按照以下规范：

1. **目录结构**: 将工具放入对应的分类目录
2. **文档说明**: 在工具文件中添加详细的文档注释
3. **依赖管理**: 如需额外依赖，请创建对应的 requirements.txt
4. **错误处理**: 添加适当的错误处理和用户友好的提示信息
5. **更新 README**: 在此 README 中添加新工具的说明

## 📋 待办事项

- [ ] 添加文件处理工具
- [ ] 添加网络相关工具
- [ ] 创建统一的配置管理
- [ ] 添加日志记录功能
- [ ] 创建 GUI 界面

## 📞 联系方式

如有问题或建议，请通过以下方式联系：

- 创建 Issue
- 提交 Pull Request

---

**最后更新时间**: 2025 年 6 月