# random_generate_file

**Repository Path**: zxstty/random_generate_file

## Basic Information

- **Project Name**: random_generate_file
- **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-12-02
- **Last Updated**: 2025-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 随机文件生成工具使用文档

## 一、环境要求
1. **Python版本**：推荐Python 3.11及以上版本
2. **操作系统**：支持Windows、Linux、macOS等主流操作系统

## 二、依赖安装
需安装以下Python依赖包：
```bash
pip install pydantic uuid toml openai asyncio beautifulsoup4 openpyxl
```

## 三、配置说明
工具运行前需确保存在有效的配置文件（`config.py`），配置项包含：
- LLM配置（API密钥、API地址、模型名称、最大令牌数、温度值、请求超时时间）
- 文件配置（支持的文件扩展名、文本长度范围、列数范围、行数范围等）
- 领域与关键词配置（用于生成文件内容的领域信息及相关关键词）

## 四、使用指导
### 1. 基本使用
在命令行中执行以下命令启动工具：
```bash
python 脚本文件名.py
```

### 2. 命令行参数
支持以下可选参数：
- `--output/-o`：指定文件输出路径（默认：`./generated_files`）
  示例：`python 脚本文件名.py -o ./my_files`
- `--count/-n`：指定生成文件的个数（默认：10）
  示例：`python 脚本文件名.py -n 20`
- `--threads/-t`：指定使用的线程数（默认：4）
  示例：`python 脚本文件名.py -t 8`
- `--domain_cnt`：指定每个文件使用的领域数量（默认：3）
  示例：`python 脚本文件名.py --domain_cnt 5`

### 3. 功能说明
工具支持生成多种类型的文件，包括：
- 文本类文件（如JSON、HTML、YAML等）
- 表格类文件（XLSX、CSV）

生成的文件内容会结合指定的领域和关键词，通过LLM生成符合格式要求的内容，并自动处理文件名重复、内容编码等问题。

## 五、注意事项
1. 确保LLM配置正确，API密钥有效且具备相应的调用权限
2. 生成大量文件时，建议合理设置线程数，避免资源占用过高
3. 输出路径需具备可写权限，工具会自动创建不存在的目录