# 安装

***

## 1. 克隆仓库

```bash
git clone https://github.com/augy-studios/verbal-warning-logger.git
cd verbal-warning-logger
```

***

## 2. 创建虚拟环境

虚拟环境可将机器人的依赖与系统 Python 隔离开来。

```bash
python3 -m venv .venv
```

激活它：

**Linux / macOS：**

```bash
source .venv/bin/activate
```

**Windows（命令提示符）：**

```bat
.venv\Scripts\activate.bat
```

**Windows（PowerShell）：**

```powershell
.venv\Scripts\Activate.ps1
```

你的提示符现在应该显示 `(.venv)` ，以确认环境已激活。

***

## 3. 安装依赖

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

这将安装：

| 软件包                      | 用途                |
| ------------------------ | ----------------- |
| `discord.py >= 2.4.0`    | Discord API 库     |
| `python-dotenv >= 1.0.1` | 加载 `.env` 配置      |
| `aiofiles >= 23.2.1`     | 异步文件 I/O          |
| `aiosqlite >= 0.20.0`    | 用于警告和投票的异步 SQLite |
| `supabase >= 2.0.0`      | Auttaja 集成（可选）    |

***

## 4. 创建你的 .env 文件

复制示例文件并填写：

```bash
cp .env.example .env
```

查看 [配置](/zh/zi-tuo-guan/configuration.md) 页面，了解每个变量的详细信息。

***

## 下一步

一旦你的 `.env` 已准备好，请前往 [运行机器人](/zh/zi-tuo-guan/running.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vigila.augystudios.com/zh/zi-tuo-guan/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.