LangBot/plugins/misc/ScheNotify/readme/README_zh_Hans.md

ScheNotify

使用自然语言计划日程提醒

功能介绍

ScheNotify 是一个 LangBot 插件，允许用户通过自然语言与 LLM 交互来设置定时提醒。

主要功能

• 🤖 自然语言交互：通过 LLM 理解用户的日程安排意图
• ⏰ 智能时间解析：自动获取当前时间并计算提醒时间
• 🌐 多语言支持：支持中文和英文的提醒消息
• 📝 日程管理命令：查看和删除已计划的提醒
• 🔔 自动通知：到达设定时间后自动发送提醒消息

配置

语言设置

在插件配置中可以选择提醒消息的语言：

• zh_Hans (简体中文) - 默认
• en_US (英语)

使用方法

1. 通过 LLM 设置提醒

直接用自然语言告诉 LLM 你的日程安排：

示例：

明天下午3点提醒我开会
后天早上9点提醒我交报告
下周一中午12点提醒我吃饭
2024-12-25 18:00 提醒我圣诞晚餐

LLM 会自动：

1. 调用 get_current_time_str 获取当前时间
2. 解析你的时间表达并转换为标准格式
3. 调用 schedule_notify 创建提醒

2. 查看计划的提醒

使用命令查看所有计划中的提醒：

!sche

示例输出：

[Notify] 计划中的提醒：
#1 2024-12-25 18:00:00：圣诞晚餐
#2 2024-12-26 09:00:00：交报告

3. 删除提醒

使用命令删除指定的提醒（使用 !sche 查看的序号）：

!dsche i <序号>

示例：

!dsche i 1   # 删除第1个提醒

组件说明

工具

1. get_current_time_str - 获取当前时间

   • 返回格式：YYYY-MM-DD HH:MM:SS
   • LLM 在设置提醒前必须先调用此工具

2. schedule_notify - 计划通知

   • 参数：时间字符串、提醒内容
   • 自动从 session 参数获取会话信息发送提醒

命令

1. sche (别名: s) - 列出所有计划的提醒
2. dsche (别名: d) - 删除指定的提醒

技术细节

• 定时检查间隔：每 60 秒
• 时间精度：分钟级（程序每分钟检查一次）
• 会话获取：通过 Tool 的 session 参数自动获取
• 持久化：当前使用内存存储（重启后丢失）

示例对话

用户： 明天下午2点提醒我参加会议

LLM： 好的，我来为你设置提醒。

[LLM 调用 get_current_time_str] [LLM 调用 schedule_notify(time_str="2024-12-26 14:00:00", message="参加会议")]

LLM： 已经为你设置好了！将在 2024-12-26 14:00:00 提醒您：参加会议

[第二天下午2点]

机器人： [Notify] 参加会议

注意事项

• 提醒时间必须是未来时间，过去的时间会被拒绝
• 提醒消息会发送到设置提醒时的同一个会话
• 重启插件后，未发送的提醒会丢失（未来版本将支持持久化）

开发者信息

• 作者：RockChinQ
• 版本：0.2.0
• 插件类型：LangBot Plugin v1

License

Part of the LangBot plugin ecosystem.