# UsefulTools

**Repository Path**: null_742_3501/useful-tools

## Basic Information

- **Project Name**: UsefulTools
- **Description**: 一些常用的脚本
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-14
- **Last Updated**: 2026-06-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Useful Tools

实用的日常工具集合，包含视频文件扫描分析工具和 Jira 周报生成工具。

## 项目结构

```
useful-tools/
├── CHFS_Scanner/          # CHFS 视频扫描器
│   ├── ts_scanner.py      # 主程序
│   ├── requirements.txt   # Python 依赖
│   └── chromedriver.exe   # Chrome 驱动
└── WeeklyUpload/          # Jira 周报工具
    ├── AmlogicJira.py    # Jira API 封装
    ├── Configure.py      # 配置管理
    ├── jira_list_ui.py  # Jira 列表界面
    ├── main_ui.py       # 主界面
    ├── weekly_sump.py   # 周报生成
    └── json_format.py   # JSON 工具
```

## CHFS_Scanner

CHFS 视频文件扫描分析工具，用于扫描 CHFS 文件系统中的视频文件，并提取视频元信息。

### 功能特性

- 目录树扫描：支持递归扫描指定路径下的所有视频文件
- 自动识别 chromedriver：自动检测系统中的 Chrome 驱动
- 去重功能：基于 MD5 值检测重复文件
- MD5 计算：计算视频文件前 1MB 的 MD5 值
- FFprobe 视频分析：使用 FFprobe 提取视频编码、分辨率、时长等信息
- Excel 导出：将分析结果导出为 Excel 文件

### 依赖环境

```bash
pip install -r CHFS_Scanner/requirements.txt
```

需要安装 FFprobe 工具（FFmpeg 包的一部分）。

### 使用方法

```python
from ts_scanner import CHFSVideoScanner

scanner = CHFSVideoScanner(
    base_url="http://localhost:8080",
    ffprobe_path="ffprobe",
    headless=True,
    max_workers=3,
    output_excel="video_info.xlsx"
)

# 扫描并分析视频
results = scanner.scan_and_analyze()

# 保存结果到 Excel
scanner.save_to_excel(results)

# 清理资源
scanner.cleanup()
```

## WeeklyUpload

Jira 周报生成工具，用于获取和处理 Amlogic Jira 系统中的周报数据。

### 功能特性

- 周报标签管理：自动识别周报标签
- Issue 查询：按用户名、日期范围查询 Jira Issues
- 评论统计：统计用户在特定时间段内的评论数量
- 周报生成：生成符合规范的周报内容
- 数据导出：支持导出为文本格式

### 依赖环境

需要安装 PyQt5 和相关 Jira 库。请参考各模块的 import 语句安装相应依赖。

### 主要类说明

- `AmlogicJira`: Jira API 交互类
- `Configure`: 配置管理类
- `JiraListWindow`: Jira 列表显示窗口
- `MyApp`: 主应用程序窗口
- `WeeklySumup`: 周报汇总类

## 配置说明

WeeklyUpload 模块使用配置文件保存用户设置，包括：
- Jira 服务器地址
- 用户名
- 日期范围设置

## 注意事项

1. CHFS_Scanner 需要 Chrome 浏览器配合 chromedriver 使用
2. WeeklyUpload 需要有效的 Jira 账户权限
3. 部分功能需要 FFmpeg/FFprobe 环境

## 许可证

请参考各模块目录下的 LICENSE 文件。