Schedule Assistant 日程提醒助手

你的贴心日程管家 —— 早安播报 · 习惯提醒 · LLM 日程管理 · Apple 日历双向同步 · Notion 待办同步

核心特性 • 功能概览 • 快速开始 • 配置项说明 • LLM 可调用工具 • 更新日志

本项目由 AI 编写 · 插件 Logo 来源于 Pixiv Pid: 130776279

核心特性

特性	说明
每日早安播报	天气 + 今日日程 + Notion 待办 + 熬夜检测，一条消息搞定起床信息
智能习惯提醒	洗澡 / 睡觉 / 喝水定时提醒，提醒时间可配置
LLM 日程管理	动嘴管日程：新增 / 删除 / 查询 / 修改，自然语言时间解析
Apple 日历双向同步	iCloud CalDAV 读取 + 写入，自动去重与增量更新
Notion 待办同步	早安播报中附 DDL 倒计时（还剩N天 / 今天截止 / 已逾期）
多平台 Markdown 渲染	QQ 官方原生表格，Onebot 等平台自动降级纯文本

功能概览

每日早安播报

每天早上自动推送（可配置时间），一条消息搞定起床信息：

习惯提醒

习惯	默认时间	说明
洗澡提醒	22:00	提醒时间可配置
睡觉提醒	23:00	智能催睡，超时带吐槽
喝水提醒	每90分钟	9:30–21:30 时段内循环提醒
日程智能提醒	提前 N 分钟	LLM 生成自然语言提醒，结合上下文

Apple iCloud 日历双向同步

读取（Apple → 本地）：

定时拉取 iCloud 日历事件到本地存储
自动同步新增 / 修改 / 删除，以 Apple 日历为准

写入（本地 → Apple）：

通过机器人添加的日程自动写入指定 Apple 日历
记录事件 UID，支持后续同步识别与去重

接入所需：

username — Apple ID 邮箱（如 xxx@icloud.com）
app_password — App 专用密码（在 appleid.apple.com 生成，不是登录密码）
calendar_id — 目标日历 UUID，留空默认第一个。UUID 可从 Apple 日历的 CalDAV 服务器地址里复制：地址形如 …/calendars/<UUID>/，取其中 UUID 段填入

Notion 待办同步

Notion 待办会在每日早安播报中列出，并附 DDL 倒计时（还剩 N 天 / 今天截止 / 已逾期）。需先配置 Maton Gateway 作为中间层接入。

Markdown 渲染

所有定时播报（早安 / 习惯 / 日程提醒）走统一渲染管线，按平台自动降级：

native — 平台原生解析 md（qq_official、discord、telegram 等），原文直发
plain — 不支持原生 md 的平台自动 strip 降级为纯文本

QQ 原生表格自动渲染为对齐行，无需额外配置；可在配置中关闭或强制切换。

快速开始

第一步：安装日程提醒助手

AstrBot WebUI → 插件市场 → 搜索 schedule_assistant

**提示：**依赖声明在插件 requirements.txt（apscheduler / aiohttp / python-dateutil）：AstrBot 加载与安装插件时会自动预检并补齐缺失依赖，通常无需手动安装。

第二步：最小配置（跑通全部定时提醒）

只需在 WebUI 插件配置 → 基础设置 → user_ids 填一行：

你的平台ID:FriendMessage:你的用户ID

平台ID:会话类型:用户ID（UMO 格式）一行搞定「提醒谁 + 从哪个平台发」。填纯 QQ 号也可以，会自动按私聊发送。

第三步（可选）：配置 Notion 同步

在 Maton 上接入 Notion（OAuth2 方式），生成 Maton API Key
插件配置 → 外部服务 填入 maton_api_key，并用 notion_db_ids 指定要读取的数据库（如 事务:xxx、阅读:yyy）

**注意：**Notion 待办经第三方网关 gateway.maton.ai 中转（非直连 Notion 官方 API）：maton_api_key 会作为请求头发送给该第三方，其可读取你指定数据库中的标题、状态与截止日期等字段。

配置项说明

基础设置

配置项	类型	默认	说明
`persona_id`	string	`""`	LLM 人设 ID（对应配置文件中的 `persona_id`），留空自动从会话获取
`user_nickname`	string	`""`	用户昵称，留空则播报称呼为「主人」
`user_ids`	list	`[]`	用户名单 ID 列表，每行一个接收自动提醒的用户 ID（QQ 号或平台 UID）；填 UMO 格式（`平台ID:会话类型:用户ID`）可同时完成平台路由

日程提醒设置

配置项	类型	默认	说明
`enable_schedule_reminder`	bool	`false`	日程 LLM 智能提醒开关（默认关闭）
`schedule_reminder_minutes`	int	`10`	日程提前提醒分钟数（日程开始前多少分钟提醒，全天日程不提醒）
`schedule_reminder_check_interval`	int	`5`	日程提醒扫描间隔（分钟），建议设为提前量的 1/3~1/2（如提前10分钟则间隔3-5分钟），最小值2分钟且不大于提前量

习惯提醒设置

配置项	类型	默认	说明
`enable_morning_report`	bool	`true`	早安播报开关
`morning_report_time`	string	`09:00`	早报推送时间（HH:MM）
`enable_bath_reminder`	bool	`true`	洗澡提醒开关
`bath_time`	string	`22:00`	洗澡提醒时间
`enable_sleep_reminder`	bool	`true`	睡觉提醒开关
`sleep_time`	string	`23:00`	睡觉提醒时间
`enable_water_reminder`	bool	`true`	喝水提醒开关
`water_interval`	int	`90`	喝水间隔（分钟）
`water_start_time`	string	`09:30`	喝水开始时间
`water_end_time`	string	`21:30`	喝水结束时间

日历同步设置

配置项	类型	默认	说明
`enable_apple_calendar_sync`	bool	`false`	Apple 日历双向同步开关
`apple_calendar_sync_interval`	int	`30`	Apple 日历同步间隔（分钟）
`apple_calendar.username`	string	-	Apple ID 邮箱
`apple_calendar.app_password`	string	-	App 专用密码（非登录密码）
`apple_calendar.calendar_id`	string	-	目标日历 UUID，留空默认第一个；UUID 从 Apple 日历的 CalDAV 服务器地址（`…/calendars/<UUID>/`）里复制
`webcal_urls`	list	`[]`	WebCal 共享日历链接

WebCal 订阅安全：webcal_urls 只接受公网 https:// 订阅地址（webcal:// 自动转 https://）。插件会拒绝 localhost、内网（如 192.168.x / 10.x）、云元数据（169.254.169.254）等地址（防 SSRF）。请勿填写内网或本机地址。

写入开关统一使用顶层的 enable_apple_calendar_sync，开启后本地创建/删除的日程会自动同步到 Apple 日历。

外部服务设置

配置项	类型	默认	说明
`maton_api_key`	string	`""`	Maton API Key（Notion 功能必需）
`notion_db_ids`	list	`[]`	Notion 数据库 ID 列表，格式：`["事务:xxx", "阅读:yyy"]`
`weather_api_key`	string	`""`	心知天气 API Key（seniverse.com）
`weather_city`	string	`北京`	天气查询城市（默认：北京）

消息渲染设置

配置项	类型	默认	说明
`markdown_enabled`	bool	`true`	全局 Markdown 渲染开关，关闭后降级为纯文本
`markdown_native_platforms`	list	`[]`	额外追加原生解析 Markdown 的平台类型名（填实例 ID 无效）
`qq_markdown_enabled`	bool	留空	QQ 平台开关：留空跟随全局；`false` 强制 QQ 不走原生 md

提醒 Prompt 模板

配置项	类型	默认	说明
`prompt_morning`	string	`""`	早安播报模板。占位符：`{username} {date} {weekday} {weather_current} {weather_forecast} {agenda} {notion_todos} {late_night}`
`prompt_bath`	string	`""`	洗澡提醒模板。占位符：`{current_time} {default_time} {history}`
`prompt_sleep`	string	`""`	睡觉提醒模板。占位符：`{current_time} {default_time} {is_late} {history}`
`prompt_water`	string	`""`	喝水提醒模板。占位符：`{current_time} {history}`
`prompt_schedule`	string	`""`	日程提醒模板。占位符：`{item_title} {time_label} {ahead_label} {item_context} {conv_history}`

各模板留空则使用内置默认（见 prompt_config.py）；想定制提醒语气时填写，支持 {变量名} 占位符。

快速配置模板

在 WebUI 配置面板填写，或参考以下结构（data/config/schedule_assistant_config.json）：

{
  "basic_settings": {
    "persona_id": "",
    "user_nickname": "",
    "user_ids": ["你的平台ID:FriendMessage:你的用户ID"]
  },
  "schedule_reminder_settings": {
    "enable_schedule_reminder": false,
    "schedule_reminder_minutes": 10,
    "schedule_reminder_check_interval": 5
  },
  "habit_reminder_settings": {
    "enable_morning_report": true,
    "morning_report_time": "09:00",
    "enable_bath_reminder": true,
    "bath_time": "22:00",
    "enable_sleep_reminder": true,
    "sleep_time": "23:00",
    "enable_water_reminder": true,
    "water_interval": 90,
    "water_start_time": "09:30",
    "water_end_time": "21:30"
  },
  "calendar_sync_settings": {
    "enable_apple_calendar_sync": false,
    "apple_calendar_sync_interval": 30,
    "apple_calendar": { "username": "", "app_password": "", "calendar_id": "" },
    "webcal_urls": []
  },
  "external_services_settings": {
    "maton_api_key": "",
    "notion_db_ids": [],
    "weather_api_key": "",
    "weather_city": "北京"
  },
  "message_render_settings": {
    "markdown_enabled": true,
    "markdown_native_platforms": [],
    "qq_markdown_enabled": null
  },
  "prompt_settings": {
    "prompt_morning": "",
    "prompt_bath": "",
    "prompt_sleep": "",
    "prompt_water": "",
    "prompt_schedule": ""
  }
}

LLM 可调用工具

插件注册 4 个 LLM 工具，模型会自动判断何时调用，你只需用自然语言说需求：

时间写法：数字/ISO 格式（2024-01-15 14:30、2024-01-15 09:00-11:00、2024-01-16）或中文口语（「明天9点」「明天9点到11点」「明天全天」）；纯日期即全天。

用户: 帮我加个明天早上9点开组会的日程
🤖 → create_schedule(title=组会, datetime_str=明天9点)
    已创建日程「组会」，时间：08-17 09:00 ✅

用户: 明天9点到11点开组会
🤖 → create_schedule(title=组会, datetime_str=明天9点到11点)
    已创建日程「组会」，时间：08-17 09:00-11:00 ✅

用户: 后天全天团建
🤖 → create_schedule(title=团建, datetime_str=后天全天)
    已创建日程「团建」，时间：08-18 全天 ✅

用户: 把下午3点的会议改到4点
🤖 → update_schedule(title_keyword=会议, new_datetime=下午4点)
    已修改日程：时间改为下午4点 ✅

用户: 看看这周有什么安排
🤖 → list_schedules(days=7)
    📋 接下来7天日程（共3个）：
    ━━━ 08-17 周一 ━━━
      ⏰ 09:00 │ 组会
      ...

用户: 删除明天的读书会
🤖 → delete_schedule(title_keyword=读书会)
    已删除日程「读书会」✅

create_schedule

创建新日程。

参数	类型	说明
`title`	string	必填，日程标题/内容
`datetime_str`	string	必填，数字/ISO 时间（`2024-01-15 14:30`、`2024-01-15 09:00-11:00`）或中文口语（「明天9点」「明天9点到11点」「明天全天」）；纯日期即全天
`end_datetime_str`	string?	可选，区间日程的结束时间（如「11点」）；不填为单时间点（Apple 日历按开始后 1 小时）
`description`	string?	可选备注描述

delete_schedule

删除日程。支持按 ID 精确匹配或按标题关键词模糊匹配。

参数	类型	说明
`schedule_id`	string?	日程 ID（精确匹配）
`title_keyword`	string?	标题关键词（模糊匹配，如「开会」「组会」）

list_schedules

查看日程列表。

参数	类型	说明
`days`	int?	查看最近几天的日程，默认7天

update_schedule

修改日程。可单独或组合更新标题、时间、备注。

参数	类型	说明
`schedule_id`	string?	日程 ID（精确匹配）
`title_keyword`	string?	标题关键词（模糊匹配）
`new_title`	string?	新标题
`new_datetime`	string?	新时间，写法同 `datetime_str`
`new_end_datetime`	string?	区间日程的新结束时间（如「11点」），需与 `new_datetime` 一起给
`new_description`	string?	新备注

更新日志

查看完整更新日志 →

支持与致谢

如果这个插件对你有帮助，欢迎点亮 Star，有问题和建议请提交 Issue 或 Pull Request。

AstrBot 开源聊天机器人框架
插件 Logo 来源于 Pixiv Pid: 130776279

许可证与作者

本项目采用 MIT License 开源协议。

@OMSociety

Name		Name	Last commit message	Last commit date
.astrbot-plugin/i18n		.astrbot-plugin/i18n
docs		docs
reminders		reminders
services		services
tests		tests
tools		tools
.gitattributes		.gitattributes
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
LICENSE		LICENSE
README.md		README.md
README_en.md		README_en.md
README_ja.md		README_ja.md
README_ru.md		README_ru.md
__init__.py		__init__.py
_conf_schema.json		_conf_schema.json
apple_calendar.py		apple_calendar.py
async_utils.py		async_utils.py
constants.py		constants.py
engine.py		engine.py
logo.png		logo.png
main.py		main.py
markdown.py		markdown.py
messaging.py		messaging.py
metadata.yaml		metadata.yaml
notion_client.py		notion_client.py
prompt_config.py		prompt_config.py
requirements.txt		requirements.txt
ruff.toml		ruff.toml
schedule_store.py		schedule_store.py
time_parser.py		time_parser.py

Navigation Menu

Repository files navigation

Schedule Assistant 日程提醒助手

核心特性

功能概览

每日早安播报

习惯提醒

Apple iCloud 日历双向同步

Notion 待办同步

Markdown 渲染

快速开始

第一步：安装日程提醒助手

第二步：最小配置（跑通全部定时提醒）

第三步（可选）：配置 Notion 同步

配置项说明

基础设置

日程提醒设置

习惯提醒设置

日历同步设置

外部服务设置

消息渲染设置

提醒 Prompt 模板

快速配置模板

LLM 可调用工具

create_schedule

delete_schedule

list_schedules

update_schedule

更新日志

支持与致谢

许可证与作者

About

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Schedule Assistant 日程提醒助手

核心特性

功能概览

每日早安播报

习惯提醒

Apple iCloud 日历双向同步

Notion 待办同步

Markdown 渲染

快速开始

第一步：安装日程提醒助手

第二步：最小配置（跑通全部定时提醒）

第三步（可选）：配置 Notion 同步

配置项说明

基础设置

日程提醒设置

习惯提醒设置

日历同步设置

外部服务设置

消息渲染设置

提醒 Prompt 模板

快速配置模板

LLM 可调用工具

create_schedule

delete_schedule

list_schedules

update_schedule

更新日志

支持与致谢

许可证与作者

About

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages