# 快速开始指南

本文档提供了ArticleReplaceBatch的快速开始指南。

---

## 安装

### 1. 克隆项目

```bash
git clone <repository-url>
cd ArticleReplaceBatch
```

### 2. 安装依赖

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

### 3. 配置环境

```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
```

---

## 配置说明

主要配置文件：`config.ini`

### Coze配置

```ini
[Coze]
workflow_id = your_workflow_id
access_token = your_access_token
is_async = true
```

### 常规配置

```ini
[General]
max_threads = 3
min_article_length = 100
articles_path = articles
images_path = picture
```

---

## 开发

### 运行测试

```bash
python dev.py test
```

### 代码格式化

```bash
python dev.py format
```

### 代码检查

```bash
python dev.py lint
```

---

## 更多信息

- [完整文档](../README.md)
- [API文档](./API.md)
- [开发者指南](./DEVELOPER_GUIDE.md)
- [部署指南](./DEPLOYMENT_GUIDE.md)