💗 天使之心
插件名称： AngelHeart
当前版本： 0.9.3
让 AI 在群聊中懂得观察时机、判断气氛，并以更自然的方式参与对话。
天使之心会自动管理 bot 的群聊参与状态和聊天上下文。普通用户无需记住命令，也不需要手动切换状态。
🚀 快速了解
| 项目 | 说明 |
|---|---|
| 是否需要固定命令 | 不需要 |
| 是否支持群聊 | 支持，主要功能集中在群聊互动 |
| 是否支持私聊 | 支持私聊上下文接管 |
| 是否每句话都回复 | 不一定，插件会判断是否适合回应 |
| 是否会主动发言 | 可能，会根据群聊气氛和当前状态决定 |
| 主要作用 | 改善回复时机、多人上下文和聊天自然度 |
✨ 它会带来什么变化？
安装并启用后，bot 的表现可能出现以下变化：
- 不再机械地回复群里的每一句话；
- 被艾特或被明确呼唤时，更容易回应；
- 群聊讨论密集或出现复读时，可能主动加入；
- 回复后会进入观察期，避免连续抢话；
- 能更清楚地区分群里不同用户的发言；
- 私聊中的上下文也会被重新整理，使对话更连贯。
🧭 四种互动状态
| 状态 | 含义 | 常见表现 |
|---|---|---|
| 不在场 | bot 保持安静观察 | 群聊正常进行时不随意插话 |
| 被呼唤 | 检测到 @ 或关键词呼唤 | 准备对用户作出回应 |
| 混脸熟 | 检测到复读或密集讨论 | 可能主动参与群聊 |
| 观测中 | bot 回复后进入观察期 | 暂时减少发言，避免刷屏 |
状态会根据群聊情况自动切换，普通用户无需操作。
🧠 两级 AI 协作
天使之心使用两级 AI 分工：
| 角色 | 作用 |
|---|---|
| 轻量级 AI | 快速分析对话，判断是否需要回应 |
| 重量级 AI | 在确实需要回复时生成正式内容 |
这种方式的目标是在保持回复质量的同时，减少不必要的大模型调用。
💬 怎么和它聊天？
明确需要回复时
群聊中建议直接艾特 bot：
@bot 你怎么看刚才讨论的方案？
@bot 帮我总结一下现在的结论
普通群聊互动
不艾特时，bot 可能根据当前状态和群聊气氛自行决定是否参与。
因此，不应期待它对每句话都作出回应。
私聊
私聊仍由主框架直接响应，但天使之心会参与整理聊天历史，使上下文更加连贯。
📚 多人群聊上下文
天使之心会重新整理群聊历史，将发言人、时间和消息内容组织成更清晰的上下文，再交给大模型处理。
这有助于减少：
- 把不同用户的话误认为同一个人说的；
- 忽略前文关键信息；
- 人格提示词与群聊记录互相干扰；
- 回复对象或讨论主题判断错误。
⚠️ 使用注意
- bot 不回应某句话不一定是故障，可能只是判断当前不适合插话。
- 群聊越活跃，bot 越可能根据状态主动参与。
- 艾特 bot 通常比只说关键词更可靠。
- 如果管理员设置了白名单，插件可能只在指定群聊或会话中生效。
- 回复频率、观察时间和主动参与程度由管理员配置决定。
- 插件改善上下文，但无法保证大模型永远不会理解错误。
❓ 常见问题
Q：为什么 bot 有时不回我？
天使之心会判断当前是否需要回复。群聊中没有艾特、上下文不明确或 bot 正处于观察期时，都可能保持安静。
Q：怎样提高 bot 回应概率？
直接艾特 bot，并把问题说完整：
@bot 请回答我刚才关于服务器配置的问题
Q：为什么 bot 会主动加入聊天？
当插件检测到密集讨论、复读或合适的互动时机时，可能进入“混脸熟”状态并主动参与。
Q：主动发言会不会刷屏？
插件带有观察期和冷却机制，目的是减少过于频繁的插话。但最终效果仍取决于管理员配置。
Q：私聊也会判断是否回复吗？
README 说明私聊仍保持主框架直接响应，不经过群聊的秘书判定链路，但会使用天使之心整理后的上下文。
📎 项目信息
- 显示名称：天使之心
- 项目作者：kawayiYokami
- 当前版本：0.9.3
- 项目地址：https://github.com/kawayiYokami/astrbot_plugin_angel_heart
