# Telegram 插件

XBoard 的 Telegram Bot 插件，提供用户账号绑定、流量查询、订阅链接获取等功能。

## 功能特性

-   ✅ 工单通知功能（可配置开关）
-   ✅ 支付通知功能（可配置开关）
-   ✅ 用户账号绑定/解绑
-   ✅ 流量使用情况查询
-   ✅ 订阅链接获取
-   ✅ 工单回复支持

## 可用命令

### `/start` - 开始使用

欢迎新用户并显示帮助信息，支持动态配置。

### `/bind` - 绑定账号

绑定用户的 XBoard 账号到 Telegram。

```
/bind [订阅链接]
```

### `/traffic` - 查看流量

查看当前绑定账号的流量使用情况。

### `/getlatesturl` - 获取订阅链接

获取最新的订阅链接。

### `/unbind` - 解绑账号

解绑当前 Telegram 账号与 XBoard 账号的关联。

## 配置选项

### 基础配置

| 配置项       | 类型    | 默认值                                                                                     | 说明                 |
| ------------ | ------- | ------------------------------------------------------------------------------------------ | -------------------- |
| `auto_reply` | boolean | true                                                                                       | 是否自动回复未知命令 |
| `help_text`  | text    | '请使用以下命令：\\n/bind - 绑定账号\\n/traffic - 查看流量\\n/getlatesturl - 获取最新链接' | 未知命令的回复文本   |

### `/start` 命令动态配置

| 配置项                  | 类型 | 说明                     |
| ----------------------- | ---- | ------------------------ |
| `start_welcome_title`   | text | 欢迎标题                 |
| `start_bot_description` | text | 机器人功能介绍           |
| `start_bind_guide`      | text | 未绑定用户的绑定指导     |
| `start_unbind_guide`    | text | 已绑定用户显示的命令列表 |
| `start_bind_commands`   | text | 未绑定用户显示的命令列表 |
| `start_footer`          | text | 底部提示信息             |

### 工单通知配置

| 配置项                 | 类型    | 默认值 | 说明                 |
| ---------------------- | ------- | ------ | -------------------- |
| `enable_ticket_notify` | boolean | true   | 是否开启工单通知功能 |

### 支付通知配置

| 配置项                  | 类型    | 默认值 | 说明                 |
| ----------------------- | ------- | ------ | -------------------- |
| `enable_payment_notify` | boolean | true   | 是否开启支付通知功能 |

## 使用流程

### 新用户使用流程

1. 用户首次使用 Bot，发送 `/start`
2. 根据提示绑定账号：`/bind [订阅链接]`
3. 绑定成功后即可使用其他功能

### 日常使用流程

1. 查看流量：`/traffic`
2. 获取订阅链接：`/getlatesturl`
3. 管理绑定：`/unbind`