# LLM 工具清单

本文件列出所有可用的 LLM 函数工具，供配置 `config.toml` 中的白名单/黑名单时参考。

## 配置说明

在 `config.toml` 的 `[tools]` 节中配置：

```toml
[tools]
# 过滤模式
mode = "blacklist"  # all | whitelist | blacklist

# 白名单（mode = "whitelist" 时生效）
whitelist = ["web_search", "query_weather"]

# 黑名单（mode = "blacklist" 时生效）
blacklist = ["flow2_ai_image_generation", "jimeng_ai_image_generation"]
```

---

## 🎨 绘图类工具

| 工具名称 | 插件 | 描述 |
|----------|------|------|
| `nano_ai_image_generation` | NanoImage | NanoImage AI绘图，支持 OpenAI 格式 API，可自定义模型 |
| `flow2_ai_image_generation` | Flow2API | Flow2 AI绘图，支持横屏/竖屏选择，支持图生图 |
| `jimeng_ai_image_generation` | JimengAI | 即梦AI绘图，支持自定义尺寸 |
| `kiira2_ai_image_generation` | Kiira2AI | Kiira2 AI绘图 |
| `generate_image` | ZImageTurbo | AI绘图，支持多种尺寸 |

## 🎬 视频类工具

| 工具名称 | 插件 | 描述 |
|----------|------|------|
| `sora_video_generation` | Sora2API | Sora AI视频生成，支持横屏/竖屏 |

## 🔍 搜索类工具

| 工具名称 | 插件 | 描述 |
|----------|------|------|
| `web_search` | WebSearch | 联网搜索，查询实时信息、新闻、价格等 |
| `search_playlet` | PlayletSearch | 搜索短剧并获取视频链接 |
| `search_music` | Music | 搜索并播放音乐 |

## 🌤️ 生活类工具

| 工具名称 | 插件 | 描述 |
|----------|------|------|
| `query_weather` | Weather | 查询天气预报（温度、天气、风力、空气质量） |
| `get_daily_news` | News60s | 获取每日60秒读懂世界新闻图片 |
| `get_epic_free_games` | EpicFreeGames | 获取Epic商店当前免费游戏 |

## 📝 签到类工具

| 工具名称 | 插件 | 描述 |
|----------|------|------|
| `user_signin` | SignInPlugin | 用户签到，获取积分奖励 |
| `check_profile` | SignInPlugin | 查看用户个人信息（积分、连续签到天数等） |
| `register_city` | SignInPlugin | 注册或更新用户城市信息 |

## 🦌 打卡类工具

| 工具名称 | 插件 | 描述 |
|----------|------|------|
| `deer_checkin` | DeerCheckin | 鹿打卡，记录今天的鹿数量 |
| `view_calendar` | DeerCheckin | 查看本月的鹿打卡日历 |
| `makeup_checkin` | DeerCheckin | 补签指定日期的鹿打卡记录 |

## 💬 群聊类工具

| 工具名称 | 插件 | 描述 |
|----------|------|------|
| `generate_summary` | ChatRoomSummary | 生成群聊总结（今日/昨日） |

## 🎲 娱乐类工具

| 工具名称 | 插件 | 描述 |
|----------|------|------|
| `get_kfc` | KFC | 获取KFC疯狂星期四文案 |
| `get_random_video` | RandomVideo | 获取随机小姐姐视频 |
| `get_random_image` | RandomImage | 获取随机图片 |

---

## 常用配置示例

### 示例1：只启用搜索和天气（白名单模式）

```toml
[tools]
mode = "whitelist"
whitelist = [
    "web_search",
    "query_weather",
    "get_daily_news",
]
```

### 示例2：禁用所有绘图工具，只保留一个（黑名单模式）

```toml
[tools]
mode = "blacklist"
blacklist = [
    "jimeng_ai_image_generation",
    "kiira2_ai_image_generation",
    "generate_image",
    # 保留 flow2_ai_image_generation
]
```

### 示例3：禁用娱乐类工具

```toml
[tools]
mode = "blacklist"
blacklist = [
    "get_kfc",
    "get_random_video",
    "get_random_image",
]
```

---

> 💡 **提示**：修改配置后需要重启机器人才能生效。