适用于 AstrBot 的入群欢迎插件，支持欢迎图片、AI 个性化欢迎、群专属欢迎语、私聊群规、黑白名单管理。
- 本插件仅验证过支持 OneBot 11 协议。
- 建议使用 AstrBot v4.12.0 或以上版本。
- 若机器人启动后欢迎未触发，请尝试重启机器人或重载插件。
- 群欢迎模板库：可在后台维护多套欢迎模板，按群号匹配，命中群优先使用模板配置；模板未填写的项自动回退到全局配置。
- 群专属欢迎语：可为不同群单独设置欢迎内容，未设置的群使用全局默认。
- AI 个性化欢迎：调用 AstrBot 配置的大模型，根据新成员昵称生成一句定制欢迎语，支持指定模型、失败重试。
- 欢迎图片池：可配置多张欢迎图片，每次入群随机发送一张，支持网络 URL 或本地路径。
- 群人数统计：欢迎语中可追加"你是当前群里第 X 位成员"。
- 私聊发送群规：新人入群后尝试私聊发送群规内容（默认关闭，防风控）。
- 黑白名单：灵活控制哪些群启用欢迎功能。
- 防刷屏冷却：同一用户短时间内重复入群不重复触发。
- 冷却数据持久化：重启后冷却记录不丢失。
将插件文件夹（含 main.py、_conf_schema.json、metadata.yaml）放入 AstrBot 的 data/plugins/ 目录，重启 AstrBot 即可。
进入 AstrBot 后台 → 插件配置页面，可设置以下项目：
| 配置项 | 说明 | 默认值 |
|---|---|---|
| 🎉 全局默认欢迎语 | 支持变量 {name}（昵称）、{count_text}（第几位成员） |
内置默认语 |
| 📦 群欢迎模板库 | 按群号匹配，命中群优先使用模板配置（详见下方优先级说明） | 空 |
| ✅ 白名单群号 | 每行一个群号，填写后只有这些群触发欢迎 | 空 |
| 🚫 黑名单群号 | 每行一个群号，白名单为空时生效 | 空 |
| 📊 开启群人数统计 | 欢迎语末尾追加成员序号 | 开启 |
| 📩 开启私聊群规 | 新人入群后尝试私聊发送群规 | 关闭 |
| 📜 群规内容 | 私聊发送的具体文字 | 内置示例 |
| 🤖 开启 AI 个性化欢迎 | 调用大模型生成一句定制欢迎语 | 关闭 |
| 🧠 AI 模型提供商 | 指定用于生成欢迎语的模型，留空使用系统默认 | 空（系统默认） |
| 🔄 AI 重试次数 | AI 生成失败后的重试次数，0 表示不重试 | 0 |
| 📝 AI 提示词 | 指导 AI 生成内容，支持 {name} 变量 |
内置提示词 |
| 🖼️ 欢迎图片池 | 可填多张图片 URL 或本地路径，每次随机发送一张 | 空（不发送） |
| ⏱️ 防刷屏冷却（秒） | 同一用户重复入群的最小触发间隔 | 300 秒 |
配置优先级从高到低为：
- 模板库：
group_ids中包含当前群的模板。模板中的开关项（如群人数统计、私聊群规、AI欢迎）始终以模板为准；文本/图片列表项留空时回退到下一级。 - 群专属欢迎语：通过
/welcome set指令设置的旧版群欢迎语。 - 全局默认配置：上方表格中的全局配置项。
旧版配置（白名单、黑名单、群专属欢迎语等）完全兼容，不配置模板库时行为与旧版一致。
⚠️ 请勿在 WebUI 中手动修改「群专属配置」字段，该字段由系统自动维护，手动编辑可能导致 JSON 损坏。请使用/welcome set指令进行配置。
所有指令需要管理员权限。指令前缀默认为 /，请根据你的 AstrBot 配置调整。
| 场景 | 指令 | 说明 |
|---|---|---|
| 群聊 | /welcome set 欢迎 {name} 加入！ |
设置本群专属欢迎语 |
| 群聊 | /welcome set reset |
清除本群设置，恢复全局默认 |
| 群聊 | /welcome set show |
查看本群当前欢迎语 |
| 私聊 | /welcome set <群号> 欢迎 {name} 加入！ |
为指定群设置欢迎语 |
| 私聊 | /welcome set reset <群号> |
清除指定群设置 |
| 私聊 | /welcome set show <群号> |
查看指定群当前欢迎语 |
| 指令 | 说明 |
|---|---|
/welcome status（群聊） |
查看插件状态 + 本群欢迎语及来源 |
/welcome status（私聊） |
查看插件状态 + 已自定义群的数量 |
/welcome status <群号>（私聊） |
查看插件状态 + 指定群欢迎语 |
| 指令 | 说明 |
|---|---|
/welcome count on/off |
开启 / 关闭群人数统计 |
/welcome rules on/off |
开启 / 关闭私聊群规 |
/welcome ai on/off |
开启 / 关闭 AI 个性化欢迎 |
白名单不为空时，只有白名单内的群会触发欢迎；白名单为空时，黑名单内的群不触发欢迎。
| 指令 | 说明 |
|---|---|
/welcome wl add <群号> |
加入白名单 |
/welcome wl del <群号> |
移出白名单 |
/welcome wl list |
查看白名单 |
/welcome bl add <群号> |
加入黑名单 |
/welcome bl del <群号> |
移出黑名单 |
/welcome bl list |
查看黑名单 |
Q：开启了私聊群规，但新人没收到私聊？
新成员可能关闭了"允许陌生人发起临时会话"，或当前平台风控限制了临时会话。建议将重要群规直接写在群欢迎语中。
Q：AI 欢迎开启了，但没有生效？
请确认：① 已执行 /welcome ai on；② AstrBot 已配置可用的大模型（平时 @ 机器人能正常回复即可）；③ 若指定了模型，确认该模型 ID 填写正确。
Q：如何为不同群指定不同的 AI 模型？
可在"群欢迎模板库"中为指定群号单独配置"AI 模型提供商"，模板配置优先于全局；未配置模板或模板留空的群使用全局设置。
Q：配置了欢迎图片但群里没显示？
请确认图片 URL 可直接在浏览器打开，且 OneBot 客户端能正常访问。部分客户端可能不支持某些图片格式或过大的文件。图片池中每张图片都会随机发送，若某张无法访问会正常发送其余图片。
启用"AI 个性化欢迎"功能即表示您同意以下条款：
- 数据传输：本插件仅将新成员的公开昵称发送给您配置的大语言模型，不涉及 QQ 号或其他私密信息。
- 内容免责：AI 生成内容由您所配置的模型提供，插件开发者不对内容的准确性或适宜性作任何保证。
- 费用说明：启用此功能将消耗您配置的模型服务的 API 调用额度，请根据实际需求酌情使用。
如果这个插件对你有帮助，欢迎点个 Star ⭐ 谢谢喵