# rltools

**Repository Path**: lovewinner/rltools

## Basic Information

- **Project Name**: rltools
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-29
- **Last Updated**: 2026-06-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 工具脚本集合

本文件夹包含三个Python脚本，用于不同的自动化任务。

## 功能概览

| 脚本名称 | 功能描述 | 主要依赖 | 输入参数 | 环境变量 | 详细说明 |
|---------|---------|---------|---------|---------|---------|
| `delete_short_finished_runs.py` | 删除Weights & Biases中运行时间<1分钟的已完成运行 | wandb | 无 | `WANDB_API_KEY`（必需）<br>`WANDB_ENTITY`（可选） | [使用说明](#1-delete_short_finished_runspy) |
| `delete_crashed_runs.py` | 删除Weights & Biases中所有崩溃的运行 | wandb | 无 | `WANDB_API_KEY`（必需）<br>`WANDB_ENTITY`（可选） | [使用说明](#2-delete_crashed_runspy) |
| `mineru.py` | 使用MinerU API从PDF中提取内容 | requests | `pdf_url_or_path`（必需）<br>`output_dir`（可选） | `MINERU_API_KEY`（必需） | [使用说明](#3-minerupy) |

## 详细使用说明

### 1. delete_short_finished_runs.py

**使用方法：**
```bash
# 设置环境变量
export WANDB_API_KEY="your_wandb_api_key"
export WANDB_ENTITY="your_username_or_team"  # 可选，脚本会尝试自动检测

# 运行脚本
uv run delete_short_finished_runs
```

**功能特点：**
- 遍历指定实体下的所有项目
- 查找状态为"finished"的运行
- 计算运行时长（创建时间到心跳时间）
- 删除运行时长小于60秒的运行
- 不删除关联的artifacts（`delete_artifacts=False`）

### 2. delete_crashed_runs.py

**使用方法：**
```bash
# 设置环境变量
export WANDB_API_KEY="your_wandb_api_key"
export WANDB_ENTITY="your_username_or_team"  # 可选，脚本会尝试自动检测

# 运行脚本
uv run delete_crashed_runs
```

**功能特点：**
- 遍历指定实体下的所有项目
- 查找状态为"crashed"的运行
- 删除所有崩溃的运行
- 不删除关联的artifacts（`delete_artifacts=False`）

### 3. mineru.py

**使用方法：**
```bash
# 设置环境变量
export MINERU_API_KEY="your_mineru_api_key"

# 运行脚本（基本用法）
uv run mineru <pdf_url_or_path>

# 运行脚本（指定输出目录）
uv run mineru <pdf_url_or_path> <output_dir>
```

**参数说明：**
- `pdf_url_or_path`（必需）：PDF文件的URL或本地路径
- `output_dir`（可选）：输出目录，默认为当前目录

**功能特点：**
- 调用MinerU API v4提取PDF内容
- 使用VLM模型版本进行提取
- 自动创建输出目录（如果不存在）
- 返回API响应状态码和数据

## 安装依赖

首次使用需同步依赖环境：
```bash
uv sync
```

## 注意事项

1. **Weights & Biases脚本**：运行前确保已正确配置WANDB API密钥和实体信息
2. **MinerU脚本**：需要有效的MinerU API密钥
3. **删除操作**：删除运行是不可逆操作，请谨慎使用
4. **网络连接**：所有脚本都需要网络连接才能访问相应的API服务