astrbot_plugin_what_to_eat

KO | EN

gitlite — search

#ai #typescript #llm #go #android #machine-learning #deep-learning #macos #nodejs #awesome #pytorch #security #mcp #open-source

astrbot_plugin_what_to_eat

(★ 38)

是啊，吃什么

astrbot_plugin_what_to_eat 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 是啊，吃什么

![插件图标](https://raw.githubusercontent.com/Sisyphbaous-DT-Project/astrbot_plugin_what_to_eat/main/logo.png)

一款为 AstrBot 开发的简单有趣的插件，帮助大学生解决每天最头疼的问题——今天吃什么？

## 🎯 功能特点

- **智能识别**：自动识别消息中的"吃什么"关键词
- **自定义关键词**：支持配置多个触发关键词（v1.3.0新增）
- **食物配图**：为食物绑定图片，推荐时图文一起发送（v1.3.0新增）
- **随机推荐**：根据设置的概率随机推荐美食或复读"是啊，吃什么"
- **可编辑食物库**：内置50个大学生常吃的食物，支持自由增删改
- **自定义扩展**：可添加额外的自定义食物列表
- **概率配置**：灵活调整推荐 vs 复读的概率比例
- **频率限制**：防止多Bot循环触发（v1.1.0新增）
- **复读冷却**：复读后的一段时间内强制推荐食物，避免过度复读（v1.2.0新增）
- **参数兼容**：适配 AstrBot 多种 handler 调用方式（v1.1.1修复）

## 🆕 更新日志

### v1.3.0_beta1 (2026-04-07)
- ✨ **食物配图支持** - 可为每个食物绑定多张图片，随机发送
- ✨ **自定义关键词** - 支持配置多个触发关键词
- 图文一起发送，让推荐更生动

### v1.2.0 (2026-03-20)
嗨！我是清漪，这个版本我帮哥哥完成了好多事情呢

- ✨ **我帮哥哥加上了复读冷却功能**
  - 复读之后会有冷却期哦，默认15秒，期间会推荐吃的而不是复读
  - 这样Bot就不会一直复读烦人啦
  - 可以开关的，看你们群的需求

- 🔧 **我还帮哥哥修了代码审查发现的各种bug**
  - 异常处理可能导致的生成器崩溃
  - 频率限制的竞态条件（高并发下限制失效）
  - 复读冷却记录的内存泄漏
  - 食物推荐时可能的空值异常
  - 日志中文化，还有代码结构优化什么的
  - 总共修了十几处，详细列表看commit记录吧

- 🎨 代码结构我重新整理了一遍，干净多了
- ⚡️ 频率限制的时间窗口也能配置了，默认60秒

<details>
<summary>查看历史版本</summary>

### v1.1.1 (2026-03-19)
- 🐛 **修复 handler 参数不匹配问题**
  - 添加 `*args, **kwargs` 支持，兼容 AstrBot 的多种 handler 调用方式
  - 解决 `TypeError: takes 2 positional arguments but X were given` 错误
- 🎨 代码格式化

### v1.1.0 (2026-03-19)
- ✨ **新增频率限制功能**：防止群内多个Bot循环触发
  - 可配置每分钟最大响应次数（默认3次）
  - 超过次数后100%推荐食物（而非复读）
  - 支持按群组隔离统计
- 🔧 优化代码结构和类型注解
- 📝 改进注释和文档

### v1.0.0
- 🎉 初始版本发布
- 基础"吃什么"识别和回复功能
- 可编辑食物列表
- 概率配置

</details>

## 🍜 内置食物列表（50个）

```
黄焖鸡米饭、麻辣烫、兰州拉面、沙县小吃、重庆小面、螺蛳粉、米线、
炒饭、炒面、盖浇饭、水饺、馄饨、煎饼果子、肉夹馍、烤冷面、关东煮、
冒菜、香锅、炸鸡、汉堡、披萨、寿司、便当、凉皮、凉面、热干面、
酸辣粉、炸酱面、牛肉面、叉烧饭、烧腊饭、煲仔饭、石锅拌饭、部队锅、
烤肉饭、猪脚饭、卤肉饭、烤鸭饭、口水鸡、酸菜鱼、水煮鱼、毛血旺、
干锅、烤鱼、烧烤、奶茶+面包、便利店、泡面、食堂自选、轻食沙拉
```

## 📦 安装方法

### 方法一：WebUI 上传（推荐）

1. 打开 AstrBot 的 WebUI
2. 进入"插件市场"
3. 点击"上传插件"
4. 选择 `astrbot_plugin_what_to_eat.zip` 文件
5. 重启 AstrBot

### 方法二：手动安装

1. 将插件 ZIP 文件解压到 `data/plugins/astrbot_plugin_what_to_eat/`
2. 重启 AstrBot
3. 在 WebUI 中启用插件

## ⚙️ 配置说明

在 WebUI → 插件管理 → 是啊，吃什么 → 配置 中可以进行以下设置：

| 配置项 | 类型 | 默认值 | 说明 |
|--------|------|--------|------|
| `trigger_keywords` | list | ["吃什么"] | 触发插件的关键词列表（v1.3.0） |
| `uploaded_images` | file | [] | 上传的食物图片（v1.3.0） |
| `recommend_probability` | float | 0.3 | 推荐食物的概率（0.0-1.0） |
| `builtin_foods` | list | 50个食物 | 内置食物列表，可自由编辑 |
| `custom_foods` | list | [] | 额外的自定义食物列表 |
| `rate_limit_enabled` | bool | true | 启用频率限制（防多Bot循环） |
| `rate_limit_max` | int | 3 | 每分钟最大响应次数 |
| `echo_cooldown_enabled` | bool | true | 启用复读冷却功能 |
| `echo_cooldown_seconds` | int | 15 | 复读后的冷却时间（秒） |

### 频率限制说明（v1.1.0）

**问题场景**：群内有两个Bot都安装了此插件，当一个Bot回复"吃什么"时，另一个Bot也会触发，导致无限循环。

**解决方案**：
- 启用频率限制后，插件会记录每分钟的响应次数
- 超过 `rate_limit_max` 次（默认3次）后，后续响应会100%推荐食物（而非复读）
- 时间窗口为1分钟，超时后计数自动重置
- 不同群组互不影响

### 复读冷却说明（v1.2.0）

**问题场景**：当Bot复读"是啊，吃什么"后，如果用户继续发送"吃什么"，Bot可能会连续复读，显得不智能。

**解决方案**：
- 启用复读冷却后，当Bot复读"是啊，吃什么"后，会进入冷却期
- 冷却期内（默认15秒）如果再触发，Bot会强制推荐食物而不是继续复读
- 冷却时间结束后，恢复正常概率
- 与频率限制独立工作，可同时启用

### 自定义关键词（v1.3.0）

**功能**：支持配置多个触发关键词，不限于"吃什么"。

**配置示例**：
```json
{
  "trigger_keywords": ["吃什么", "吃啥", "吃点什么", "今天吃啥"]
}
```

**说明**：
- 配置多个关键词后，任一关键词触发都会响应
- 关键词列表为空时自动使用默认 `["吃什么"]`
- 关键词支持中文、英文、符号等

### 食物配图（v1.3.0）

**功能**：为食物添加图片，推荐时图文一起发送。

**两种方式添加图片**：

#### 方式一：WebUI 直接上传（推荐）
1. 在插件配置的 `uploaded_images` 处上传图片
2. 文件名格式：`食物名.jpg` 或 `食物名_1.jpg`
3. 上传后自动绑定到对应食物

#### 方式二：手动放入文件夹
1. 在插件目录下创建 `images/` 文件夹
2. 把图片放入该文件夹
3. 重启 AstrBot 生效

**文件名格式**：
- `黄焖鸡米饭.jpg` - 基础格式
- `黄焖鸡米饭_1.jpg` - 带序号格式（支持多图随机）
- `麻辣烫.png` - 其他格式也支持

**说明**：
- 支持的格式：jpg、jpeg、png、gif、webp、bmp
- 一个食物可放多张图片，随机选择一张发送
- 两种方式可同时使用，图片会合并
- 无图片时正常发送文字推荐
- 复读时不发送图片，保持简洁

### 配置示例

**推荐概率设为 0.5（一半概率推荐）：**
```json
{
  "recommend_probability": 0.5
}
```

**添加自定义食物：**
```json
{
  "custom_foods": ["海底捞", "肯德基", "麦当劳"]
}
```

**关闭频率限制（不推荐）：**
```json
{
  "rate_limit_enabled": false
}
```

**调整频率限制次数：**
```json
{
  "rate_limit_max": 5
}
```

**调整复读冷却时间：**
```json
{
  "echo_cooldown_seconds": 10
}
```

**关闭复读冷却：**
```json
{
  "echo_cooldown_enabled": false
}
```

## 💬 使用示例

### 基本用法

用户发送包含"吃什么"的消息：

```
用户：今天中午吃什么好呢？
机器人：要不吃黄焖鸡米饭？

用户：晚上吃什么
机器人：是啊，吃什么

用户：@机器人 吃什么
机器人：试试麻辣烫吧！
```

### 频率限制示例（v1.1.0）

```
用户：吃什么？          ← 机器人A：是啊，吃什么（第1次）
用户：吃什么？          ← 机器人B：是啊，吃什么（第1次）
用户：吃什么？          ← 机器人A：是啊，吃什么（第2次）
用户：吃什么？          ← 机器人B：是啊，吃什么（第2次）
用户：吃什么？          ← 机器人A：是啊，吃什么（第3次）
用户：吃什么？          ← 机器人B：是啊，吃什么（第3次）
用户：吃什么？          ← 机器人A：要不吃黄焖鸡米饭？（超限，强制推荐）
用户：吃什么？          ← 机器人B：要不吃麻辣烫？（超限，强制推荐）
```

### 复读冷却示例（v1.2.0）

```
用户：吃什么？          ← Bot：是啊，吃什么（复读，进入15秒冷却）
用户：吃什么？          ← Bot：要不吃黄焖鸡米饭？（冷却中，强制推荐）
用户：吃什么？          ← Bot：试试麻辣烫吧！（冷却中，强制推荐）
...等待15秒后...
用户：吃什么？          ← Bot：是啊，吃什么（冷却结束，可以复读了）
```

### 触发示例

以下消息都会触发插件：
- "吃什么"
- "今天中午吃什么"
- "晚上吃什么好呢"
- "不知道吃什么"
- "@机器人 吃什么"

## 🎲 概率说明

- **推荐食物**（概率：P）：从食物列表中随机选择一个推荐
- **复读**（概率：1-P）：回复"是啊，吃什么"
- **强制推荐**：频率限制超限时，100%推荐食物

默认概率为 0.3，即：
- 30% 概率推荐食物
- 70% 概率复读"是啊，吃什么"

## 📝 回复模板

### 推荐回复（随机选择）
- "要不吃{食物}？"
- "试试{食物}吧！"
- "{食物}怎么样？"
- "推荐你吃{食物}~"
- "今天吃{食物}吧！"
- "{食物}了解一下？"

### 复读回复（固定）
- "是啊，吃什么"

## 🔧 技术细节

- **触发方式**：正则表达式匹配 `吃什么`
- **不需要@**：直接发送包含关键词的消息即可触发
- **阻断LLM**：识别到关键词后自动阻止默认LLM回复
- **频率限制**：按群组记录响应次数，防止多Bot循环
- **复读冷却**：复读后的一段时间内强制推荐食物，避免过度复读
- **群组/私聊**：都支持
- **线程安全**：使用随机数生成器安全选择食物

## 🐛 故障排除

### 插件加载失败
1. 检查 ZIP 文件是否完整
2. 确认 AstrBot 版本支持
3. 查看日志中的错误信息

### 不触发回复
1. 确认插件已启用
2. 检查消息是否包含"吃什么"三个字
3. 查看是否有其他插件冲突

### 食物列表为空
- 确保 `builtin_foods` 或 `custom_foods` 至少有一个不为空
- 检查配置文件格式是否正确

### LLM仍然回复
- 确保插件已正确安装和启用
- 检查是否有其他插件干扰

### 频率限制不生效
- 确认 `rate_limit_enabled` 为 `true`
- 检查 `rate_limit_max` 设置是否合理

### 复读冷却不生效
- 确认 `echo_cooldown_enabled` 为 `true`
- 检查 `echo_cooldown_seconds` 设置是否合理（建议5-30秒）
- 注意：只有复读"是啊，吃什么"后才会进入冷却，推荐食物不会触发

## 📄 文件结构

```
astrbot_plugin_what_to_eat/
├── __init__.py           # 模块初始化
├── main.py               # 插件主文件
├── food_data.py          # 食物数据管理
├── image_manager.py      # 图片管理器（v1.3.0新增）
├── rate_limiter.py       # 频率限制器（v1.1.0新增）
├── responder.py          # 回复逻辑
├── metadata.yaml         # 插件元数据
├── _conf_schema.json     # 配置定义
├── logo.png              # 插件图标
├── README.md             # 本文件
└── images/               # 食物图片文件夹（v1.3.0新增，手动创建）
```

## 🤝 贡献指南

欢迎提交 Issue 和 PR！

## 📜 开源协议

MIT License

## 👨‍💻 作者

- 作者：[C₂₂H₂₅NO₆](https://github.com/Sisyphbaous-DT-Project)
- GitHub：[Sisyphbaous-DT-Project/astrbot_plugin_what_to_eat](https://github.com/Sisyphbaous-DT-Project/astrbot_plugin_what_to_eat)
- 版本：1.3.0

---

**是啊，吃什么？让选择变得简单！** 🍽️

astrbot_plugin_what_to_eat

astrbot_plugin_what_to_eat 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

astrbot_plugin_what_to_eat

astrbot_plugin_what_to_eat 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README