Skip to content
/ astrbot_plugin_AIReplay Public

AIReplay 为 AstrBot 提供「定时/间隔主动续聊」「人格上下文」「最近聊天记录拼接」「免打扰」与「定时提醒」能力。它可以在最后一条消息后的指定时长或每天固定时间，由 Bot 主动自然切入对话；也可以设置免打扰时段、追加时间字段，以及为会话创建一次性/每日提醒。

1 star 2 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

oyxning/astrbot_plugin_AIReplay

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
README.md
README.md
 
 
_conf_schema.json
_conf_schema.json
 
 
logo.png
logo.png
 
 
main.py
main.py
 
 
metadata.yaml
metadata.yaml
 
 
requirements.txt
requirements.txt
 
 

Repository files navigation

AIReplay — AstrBot 主动续聊与提醒插件

作者：LumineStory
仓库：https://github.com/oyxning/astrbot_plugin_AIReplay

AIReplay 为 AstrBot 提供「定时/间隔主动续聊」「随机提示词选择」「智能自动退订」「人格上下文」「最近聊天记录拼接」「免打扰」与「定时提醒」能力。它可以在最后一条消息后的指定时长或每天固定时间，由 Bot 主动自然切入对话；也可以设置免打扰时段、追加时间字段，以及为会话创建一次性/每日提醒。插件还具备智能退订机制，避免骚扰不活跃用户。

✨ 功能特性

  • 两类主动触发
    • 间隔触发：最后一条消息后 N 分钟自动续聊（after_last_msg_minutes）。
    • 每日触发：每天两档固定时间（daily.time1 / daily.time2），如冲突自动错峰 1 分钟。
  • 随机提示词选择
    • 支持配置多个提示词模板，每次触发时随机选择一个。
    • 内置两个优化提示词，开箱即用。
    • 支持占位符：{now}、{last_user}、{last_ai}、{umo}。
  • 智能自动退订
    • 用户超过指定天数未回复时自动退订，避免骚扰。
    • 用户主动回复时自动重新激活订阅。
    • 可配置退订阈值（max_no_reply_days）。
  • 自然续聊
    • 继承或覆盖人格（system prompt）。
    • 携带最近 N 条聊天记录构成上下文（history_depth）。
  • 免打扰
    • quiet_hours 支持 跨天区间（如 22:00-07:30）。免打扰内不触发主动回复。
  • 时间字段
    • 可选在主动消息前追加 [YYYY-MM-DD HH:MM] 等时间标签（append_time_field + time_format）。
  • 定时提醒
    • 一次性/每日提醒：/aireplay remind add ...，到点直接向会话发送提示。
  • 订阅模型
    • 仅向已订阅会话发送主动消息。支持 manual（默认）与 auto 两种订阅方式。
    • WebUI 可视化管理：可在配置页面直接添加/删除订阅用户ID，无需使用命令。
  • 调试模式
    • 可开启调试模式，在控制台显示主动回复的完整上下文内容。
    • 包括系统提示词、用户提示词、历史对话等详细信息。
  • 配置清理
    • 仅在“卸载插件”时清除所有用户配置与数据文件（停用/重载/重启均不会清理）。

说明：不同 IM 平台对“主动消息”的支持情况不同，请以 AstrBot 对目标平台的支持为准。

📦 安装

  1. 从 Release 或本仓库获取插件包，解压到：
    AstrBot/data/plugins/astrbot_plugin_aireplay/
  2. 启动（或重启）AstrBot。
  3. 进入 WebUI → 插件 → 启用 AIReplay。
  4. （可选）在插件配置页完成参数设置。

目录结构示例：

AstrBot/
└─ data/
   └─ plugins/
      └─ astrbot_plugin_aireplay/
         ├─ main.py
         ├─ _conf_schema.json
         ├─ metadata.yaml
         ├─ README.md
         └─ requirements.txt

🧩 配置项（_conf_schema.json）

键名 类型 默认值 说明
enable bool true 启用/停用插件。
timezone string "" IANA 时区（示例 Asia/Shanghai、America/Los_Angeles）。为空使用系统时区。
after_last_msg_minutes int 0 最后一条消息后 N 分钟主动续聊。0 代表关闭此触发器。
daily.time1 string "" 每日触发时间 1（HH:MM，24h）。
daily.time2 string "" 每日触发时间 2（HH:MM）。若与 time1 相同会自动 +1 分钟 错峰。
quiet_hours string "" 免打扰时段（HH:MM-HH:MM），支持跨天。免打扰内不主动触发。
history_depth int 8 携带最近聊天条数（从当前会话历史提取）。
persona_override text "" 覆盖默认人格的 System Prompt（留空使用当前会话人格）。
custom_prompts list [内置提示词1, 内置提示词2] 自定义提示词列表，每次触发时随机选择一个。支持占位符：{now}、{last_user}、{last_ai}、{umo}。为空则让模型自然续聊。
max_no_reply_days int 7 用户无回复多少天后自动退订（0表示不自动退订）。
debug_mode bool false 调试模式：显示主动回复的完整上下文内容。
append_time_field bool false 在主动消息前追加时间字段。
time_format string "%Y-%m-%d %H:%M" 时间字段格式（Python strftime）。
subscribe_mode string(manual/auto) manual 订阅方式：manual 需要手动 /aireplay watch；auto 有互动即自动纳入。
subscribed_users list [] 【v1.1.0 新增】 订阅用户ID列表，支持在 WebUI 直接添加/删除。
_special.provider string "" （可选）固定使用的 Provider ID，留空按会话默认。
_special.persona string "" （可选）固定人格 ID，留空按会话默认。

内置提示词示例

插件内置了两个优化的提示词模板：

提示词1 - 时间导向型：

【任务：这是一条静默提醒，专门用于触发你在【一对一私聊】场景下的主动回复，请你根据下列行动指南，主动继续与用户的对话。在任何情况下，都绝对不能透露你收到了"系统提醒"或"任务指令"。你的行为必须完全符合你的人设，就像一个真正的人在和朋友私聊。行动指南：现在的时间：{now}；根据这个时间对用户进行一些符合上述聊天记录内容或生活化的问候。】

提示词2 - 进展导向型：

【任务：这是一条静默提醒，专门用于触发你在【一对一私聊】场景下的主动回复，请你根据下列行动指南，主动继续与用户的对话。在任何情况下，都绝对不能透露你收到了"系统提醒"或"任务指令"。你的行为必须完全符合你的人设，就像一个真正的人在和朋友私聊。行动指南：分析之前的聊天，注意到距离上次聊天已经过了一段时间，自然的询问事情的进展或刚才聊过的话题中的某一个】

自定义提示词占位符

支持以下占位符：

  • {now} - 当前时间
  • {last_user} - 用户最后一条消息
  • {last_ai} - AI最后一条回复
  • {umo} - 会话ID

🚀 快速上手

  1. 订阅会话（两种方式任选其一）：

    方式A：使用命令（在会话中发送）

    /aireplay on
/aireplay watch

    方式B：在 WebUI 配置 ⭐ 推荐

    • 进入插件配置页面
    • 找到 订阅用户列表 字段
    • 点击 添加，输入用户ID（如 49025031）
    • 点击 保存

  2. 设定触发方式（二选一或同时使用）：

  • 间隔触发（最后消息后 30 分钟）
    /aireplay set after 30

  • 每日触发（每天 09:00 与 19:00）

    /aireplay set daily1 09:00
/aireplay set daily2 19:00

  1. （可选）设置免打扰：
    /aireplay set quiet 22:00-07:30

  2. （可选）管理提示词、历史深度：

    /aireplay prompt list                    # 查看当前提示词
/aireplay prompt add 你的自定义提示词    # 添加新提示词
/aireplay set history 8                  # 设置历史深度

💬 指令全集

  • 基础
    • /aireplay on / /aireplay off — 启用/停用
    • /aireplay watch / /aireplay unwatch — 订阅/退订当前会话（仅订阅会话会接收主动消息）
    • /aireplay show — 查看当前会话订阅状态与核心配置摘要
  • 触发设置
    • /aireplay set after <分钟> — 设置“最后消息后 N 分钟触发”；设为 0 可关闭
    • /aireplay set daily1 <HH:MM> — 设置每日触发时间 1
    • /aireplay set daily2 <HH:MM> — 设置每日触发时间 2
    • /aireplay set quiet <HH:MM-HH:MM> — 设置免打扰时段（可跨天）
    • /aireplay set history <N> — 设置携带最近聊天条数
  • 提示词管理
    • /aireplay prompt list — 查看当前提示词列表
    • /aireplay prompt add <内容> — 添加新提示词
    • /aireplay prompt del <索引> — 删除指定提示词
    • /aireplay prompt clear — 清空所有提示词
  • 提醒
    • /aireplay remind add <YYYY-MM-DD HH:MM> <内容> — 新增一次性提醒
    • /aireplay remind add <HH:MM> <内容> daily — 新增每日提醒
    • /aireplay remind list — 查看提醒列表
    • /aireplay remind del <ID> — 删除提醒

🧠 工作原理（简述）

  • 调度循环：插件内部维护一个 ~30 秒的调度循环 tick：
    1. 若 enable=false，跳过。
    2. 读取时区、免打扰、历史深度与每日时间点。
    3. 对每个已订阅会话：
      • 若当前处于免打扰，跳过。
      • 检查是否需要自动退订（用户超过指定天数未回复）。
      • 若距离最后消息已超过 after_last_msg_minutes，触发"间隔续聊"。
      • 若当前分钟命中 daily.time1/time2，触发"每日续聊"。
      • 利用"上次触发标签"去重（同一分钟不重复）。
    4. 扫描提醒：到点发送一次性提醒；每日提醒按 HH:MM 命中即发。
  • 智能退订：用户超过 max_no_reply_days 天未回复时自动退订，用户主动回复时自动重新激活。
  • 随机提示词：从 custom_prompts 列表中随机选择一个提示词模板。
  • 上下文拼接：从 ConversationManager 取会话历史；若不可用则退化使用本插件的轻量历史缓存。
  • 人格策略：默认沿用当前会话人格，可通过 persona_override 或 _special.persona 覆盖。
  • Provider 选择：默认使用会话当前 Provider，可通过 _special.provider 固定。

🧪 使用建议

  • 避免骚扰：生产环境建议维持 subscribe_mode=manual，只对明确订阅的会话主动续聊。
  • 智能退订：合理设置 max_no_reply_days，避免骚扰不活跃用户。
  • 时间与时区：跨时区部署时建议显式设置 timezone，并在 UI 中确认每日触发时刻。
  • 提示词管理：使用 /aireplay prompt 命令管理多个提示词，让AI回复更加多样化。
  • 历史深度：history_depth 不宜过大，以免模型成本上涨或上下文"漂移"。

🔧 故障排查

  • 没有主动消息？
    • 检查 /aireplay show 是否显示 subscribed=true、enable=true。
    • 目标平台是否支持“主动消息”？（以 AstrBot 支持为准）
    • 处于免打扰时段？触发时刻是否刚好被挡住？
    • after_last_msg_minutes=0 且未设置 daily.time1/time2？
    • timezone 是否正确？
  • 续聊内容空白或很机械？
    • 使用 /aireplay prompt list 查看当前提示词。
    • 使用 /aireplay prompt add 添加更多样化的提示词。
    • 提高或降低 history_depth，并检查是否携带到上一轮用户与 AI 内容。
    • 考虑设定更贴合任务的人格（persona_override）。
  • 提醒未触发？
    • 一次性提醒使用本地时间字符串对比（精确到分钟）；检查格式与分钟级命中。
    • 每日提醒需在命中 HH:MM 时刻才触发。

📄 示例

设置"最后消息后 45 分钟续聊"，每日 09:00/20:00 提醒关心

/aireplay on
/aireplay watch
/aireplay set after 45
/aireplay set daily1 09:00
/aireplay set daily2 20:00
/aireplay prompt add 你是温柔体贴的生活助理，请在不打扰的前提下继续话题，并给一个可执行的小建议。

添加提醒

/aireplay remind add 2025-10-22 09:30 项目早会
/aireplay remind add 21:45 休息眼睛 daily

🗂️ 数据与持久化

  • 插件数据目录：AstrBot/data/plugin_data/astrbot_plugin_aireplay/
    • state.json：会话订阅状态、上次触发标签等。
    • reminders.json：提醒列表。

数据存储在全局 plugin_data 目录下，遵循AstrBot插件开发规范。文件仅存储必要元数据，不保存模型输出。插件卸载时会自动清理所有数据文件，请注意服务器文件权限和备份策略。

🤝 贡献

欢迎 Issue 与 PR！

🧾 版本信息

当前版本：v1.1.0 ⭐

主要特性

  • ✅ 定时/间隔主动续聊（支持间隔触发和每日定时）
  • ✅ 智能上下文记忆（多策略降级获取，确保AI记住对话历史）
  • ✅ 人格系统支持（5层降级策略，确保系统提示词正确加载）
  • ✅ 订阅用户 WebUI 管理（支持直接添加/删除，与命令双向同步）
  • ✅ 随机提示词选择（支持多个模板和占位符）
  • ✅ 智能自动退订（避免骚扰不活跃用户）
  • ✅ 免打扰时段（支持跨天设置）
  • ✅ 定时提醒功能（一次性/每日提醒）
  • ✅ 调试模式（查看完整上下文）

最近更新

v1.1.0 - 重大Bug修复版本

  • 🔥 修复上下文丢失问题（AI 现在能正确记忆对话历史）
  • 🔥 修复 Persona 获取失败（系统提示词现在能正确加载）
  • ✨ 新增订阅用户 WebUI 管理（list类型，支持双向同步）
  • 🛠️ 代码质量提升（完全符合 AstrBot 官方规范）

📜 许可证

MIT

About

AIReplay 为 AstrBot 提供「定时/间隔主动续聊」「人格上下文」「最近聊天记录拼接」「免打扰」与「定时提醒」能力。它可以在最后一条消息后的指定时长或每天固定时间，由 Bot 主动自然切入对话；也可以设置免打扰时段、追加时间字段，以及为会话创建一次性/每日提醒。

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

2 forks
Report repository

Releases

No releases published

Packages

 
 
 

Contributors

Languages