CN Holiday Reminder — 节假日提醒 + 恋爱助手#

两个模块，一个 cron job 搞定：节假日再也不怕忘调休，纪念日再也不怕忘记。

---

模块一：节假日查询与提醒#

使用方法#

bash

python <skill-dir>/scripts/holiday.py --status          # 今日状态
python <skill-dir>/scripts/holiday.py --check 2026-05-01 # 查某天
python <skill-dir>/scripts/holiday.py --calendar 2026    # 全年日历
python <skill-dir>/scripts/holiday.py --next             # 下一个假期
python <skill-dir>/scripts/holiday.py --alerts 3         # 未来3天提醒
python <skill-dir>/scripts/holiday.py --json             # JSON输出

数据说明#

• 2025 年：国务院正式数据
• 2026 年：预测数据（标记 *），国务院公布后更新
• 内置数据，零 API 依赖

---

模块二：恋爱助手 💑#

首次安装引导#

安装 skill 后，Agent 应主动引导用户完成设置：

1. 询问"要设置恋爱助手吗？可以帮你记住纪念日和生日～"
2. 运行 love.py --setup 进行交互式设置
3. 或由 Agent 收集信息后直接写入 ~/agent-memory/love.json

需要收集的信息：

• 另一半的名字/昵称
• 在一起的日期（YYYY-MM-DD）
• 另一半的生日（YYYY-MM-DD）
• 自定义纪念日（可选，如求婚日、结婚日）
• 提醒偏好（提前几天、是否每月纪念日提醒）

使用方法#

bash

python <skill-dir>/scripts/love.py --setup              # 交互式设置
python <skill-dir>/scripts/love.py --status             # 状态总览
python <skill-dir>/scripts/love.py --together           # 在一起多久（精确到秒）
python <skill-dir>/scripts/love.py --alerts 7           # 未来7天恋爱提醒
python <skill-dir>/scripts/love.py --holidays           # 浪漫节日日历
python <skill-dir>/scripts/love.py --json               # JSON输出

对话查询#

用户可以直接问 Agent：

• "在一起多久了" → 精确到 X年X月X天X小时X分X秒
• "TA生日还有几天" → 倒计时
• "下个情人节" → 日期和天数
• "今年有哪些浪漫节日" → 完整日历

内置浪漫节日#

日期节日提示02-14💝 情人节准备礼物和浪漫晚餐03-08👸 女神节送她一份惊喜03-14🤍 白色情人节回赠礼物的日子05-20💕 520表白日说出你的爱七夕🎋 七夕节中国情人节11-11🛍️ 双十一一起买买买12-24🎄 平安夜送苹果，许平安12-25🎅 圣诞节交换圣诞礼物

数据存储#

数据保存在 ~/agent-memory/love.json，格式：

json

{
  "partner_name": "小美",
  "anniversary": "2025-06-15",
  "partner_birthday": "1998-03-20",
  "custom_dates": [
    {"name": "求婚日", "date": "2026-02-14", "emoji": "💍"}
  ],
  "reminders": {
    "anniversary": true,
    "birthday": true,
    "love_holidays": true,
    "monthly": false,
    "days_before": 1
  }
}

Agent 可以直接读写此文件，无需每次运行脚本。

---

Cron 自动提醒#

一个 cron job 同时检查节假日和恋爱纪念日：

text

schedule: { kind: "cron", expr: "0 8 * * *", tz: "Asia/Shanghai" }
payload: {
  kind: "agentTurn",
  message: "检查今天的节假日和恋爱提醒：
    1. 运行 holiday.py --alerts 3
    2. 运行 love.py --alerts 3
    如果有任何提醒就合并后通知用户，没有则不发消息。"
}
sessionTarget: "isolated"
delivery: { mode: "announce", channel: "feishu" }

提醒示例#

text

🔔 调休提醒：明天（周六）需要上班，国庆节调休
💝 还有1天就是情人节！准备礼物和浪漫晚餐
💑 今天是你和小美的恋爱纪念日！在一起 365 天了！
🎂 还有2天就是小美的生日！准备礼物了吗？

---

故障排查#

问题原因解决方案"尚未设置恋爱助手"love.json 不存在运行 love.py --setup 或让 Agent 引导设置七夕日期不对农历日期每年不同检查脚本中 QIXI_DATES 数据纪念日计算差一天时区问题确认系统时区为 Asia/Shanghaicron 没同时检查恋爱提醒cron message 没包含 love.py更新 cron job 的 message 内容自定义纪念日不提醒days_before 设太小修改 love.json 中 reminders.days_before编码错误Windows GBK脚本已内置 UTF-8 修复