生日提醒

Birthday Reminder 5分钟上手 1) 先决条件 已安装本技能。 环境可执行 python3（建议 3.9+）。 已准备官方定时任务 技能（自动化）。 已准备通知通道凭据（如 Telegram 的 机器人_令牌 和 chat_id）。 2) 准备 birthdays.json

复制下面模板并按需修改：

{ "defaults": { "calendar": "solar", "timezone": "Asia/ShanghAI", "remind_at": "09:00", "off设置_days": [7, 1, 0], "leap_strategy": "skip" }, "people": [ { "name": "妻子", "calendar": "solar", "month": 3, "day": 25 }, { "name": "父母", "calendar": "lunar", "month": 8, "day": 8, "off设置_days": [15, 3, 0] } ] }

关键字段：

defaults：全局默认值。 people：生日记录列表；每一条可覆盖任意默认字段。 calendar：solar 或 lunar。 month/day：生日月日。 off设置_days：提醒提前天数数组，0 表示当天提醒。 remind_at：提醒时间，格式 HH:MM。 timezone：IANA 时区名，默认 Asia/ShanghAI。 leap_month：仅农历使用，是否闰月生日。 leap_strategy：闰月缺失年份处理策略。 skip：该年跳过。 use-non-leap：该年改用同月非闰月。 3) 准备 通知.json

建议从 as设置s/通知.example.json 复制后修改。常见 Telegram 配置：

{ "message_style": "warm", "channels": [ { "type": "telegram", "enabled": true, "机器人_令牌": "你的_机器人_令牌", "chat_id": "你的_chat_id" } ] }

支持的通知类型：

console file 网页hook feishu dingtalk slack telegram 4) 三步检查（推荐顺序）

先看会生成哪些提醒：

python3 scripts/birthday_reminder.py 列出 --config /绝对路径/birthdays.json

再查当前是否有到期提醒：

python3 scripts/birthday_reminder.py 检查 --config /绝对路径/birthdays.json --输出 json

最后预览发送内容（不真实发送）：

python3 scripts/通知_bridge.py \ --birthday-config /绝对路径/birthdays.json \ --通知-config /绝对路径/通知.json \ --dry-运行

时间模拟（推荐格式 yyyy-MM-DD HH:mm:ss）：

python3 scripts/通知_bridge.py \ --birthday-config /绝对路径/birthdays.json \ --通知-config /绝对路径/通知.json \ --now "2026-03-18 19:00:00"

5) 自动运行（官方定时任务 技能）

在官方定时任务 技能（自动化）里定时执行：

python3 scripts/通知_bridge.py \ --birthday-config /绝对路径/birthdays.json \ --通知-config /绝对路径/通知.json

推荐频率：每 10 分钟。 推荐时区：Asia/ShanghAI。 用户示例请求 “添加一条农历八月初八的生日，并提前 15 天和当天上午 9 点提醒。” “把妻子生日设为阳历 3 月 25 日，默认时区北京，提前 7 天和 1 天提醒。” 示例：桐桐（阳历 3/18 晚上 19:00，Telegram 提醒）

birthdays.json：

{ "defaults": { "calendar": "solar", "timezone": "Asia/ShanghAI", "remind_at": "09:00", "off设置_days": [0], "leap_strategy": "skip" }, "people": [ { "name": "桐桐", "calendar": "solar", "month": 3, "day": 18, "remind_at": "19:00", "off设置_days": [0] } ] }

通知.json：

{ "channels": [ { "type": "telegram", "enabled": true, "机器人_令牌": "你的_机器人_令牌", "chat_id": "你的_chat_id" } ] }

测试发送：

python3 scripts/通知_bridge.py \ --birthday-config /绝对路径/birthdays.json \ --通知-config /绝对路径/通知.json \ --now "2026-03-18 19:00:00"

常见问题 配置了但没收到提醒： 通常是官方定时任务 技能 没触发到 通知_bridge.py。 --now 怎么写： 推荐 yyyy-MM-DD HH:mm:ss，例如 2026-03-25 09:00:00。 只执行了 检查 为什么没发消息： 检查 只检查；真正发送需要执行 通知_bridge.py。 问题反馈 代码仓库：https://github.com/905583906/jeff-技能s 提交问题（Issues）：https://github.com/905583906/jeff-技能s/issues

遇到问题时，建议在 Issue 里附上：

你的配置片段（隐藏敏感信息） 执行命令 报错信息或截图