Matter Day Reminder - 个人社交助理

帮助你管理亲友的重要日期（生日、纪念日等），提供智能双节点提醒和AI生成的祝福语与礼物建议。

核心功能

1. 联系人管理

• - 对话式录入：通过自然对话添加联系人信息
• 本地存储：所有数据以 Markdown + YAML Frontmatter 格式存储在本地
• 可配置路径：数据文件存放位置可自定义

2. 事件管理

• - 支持多种事件类型：生日、纪念日、其他重要日期
• 农历/阳历双支持：使用 lunar-javascript 库自动处理农历转换
• 闰月处理：闰月情况下仅在首月触发提醒

3. 智能提醒引擎

• - 双节点提醒策略：

• - 每日扫描：定时检查当天需要提醒的事件

4. AI 生成服务

• - 自适应祝福语：基于关系亲疏（父母/密友/普通朋友）、人物特征、场合性质动态调整语气风格
• 礼物建议：AI根据关系自动推断预算，仅提供类别/创意描述，不含商品链接

5. 推送渠道

• - 主渠道：OpenCode 消息推送
• 兜底渠道：邮件推送（当主渠道不可用时）

数据模型

联系人文件结构

每个联系人为独立的 Markdown 文件，存储在配置的数据目录中：

markdown

张三

事件

生日

• - 类型: 生日
• 日期: 1990-05-20
• 农历: false
• 提醒: true

结婚纪念日

• - 类型: 纪念日
• 日期: 2020-10-01
• 农历: false
• 提醒: true

备注

• - 不喜欢甜食
• 最近在看《三体》

数据目录结构

reminder-data/
├── config.yml # 全局配置
├── contacts/
│ ├── zhang-san.md
│ ├── li-si.md
│ └── wang-wu.md
└── logs/
└── reminders.log # 提醒日志

配置文件 (config.yml)

yaml

数据存储路径

提醒设置

推送设置

邮件设置（可选）

AI 生成设置

工作流程

添加联系人

当用户想要添加联系人时：

1. 1. 启动对话：询问联系人姓名、关系类型
2. 收集事件：询问生日/纪念日等，区分农历/阳历
3. 收集偏好：询问人物特征、兴趣爱好（用于生成个性化内容）
4. 创建文件：生成 Markdown 文件并保存到数据目录
5. 确认：向用户展示创建的文件内容，确认无误

处理日期输入（关键！）

当用户提到生日或纪念日时，必须明确询问是农历还是阳历。如果用户提供了农历日期，无论使用什么格式，都要统一转换为标准格式存储。

日期输入处理规则：

阳历日期（保持原样）：

• - 格式：YYYY-MM-DD
• 示例：1998-05-20

农历日期（必须统一为标准格式）：

• - 标准格式：- 日期: 农历X月X日
• 支持的输入格式（必须都能识别）：

格式转换规则：

1. 1. 识别包含农历、阴历、旧历关键词的输入，或明确说明是农历的输入
2. 提取月份和日期
3. 将阿拉伯数字转换为中文数字（6 → 六，8 → 八）
4. 去掉末尾的日字（如有）
5. 统一输出格式：- 日期: 农历X月X日
6. 设置：- 农历: true

数字转中文对照表：

1→一, 2→二, 3→三, 4→四, 5→五, 6→六,
7→七, 8→八, 9→九, 10→十, 11→十一, 12→十二

对话示例：

用户：帮我记一下我朋友的生日
助手：好的！请问这位朋友叫什么名字？
用户：叫李四，是我大学同学
助手：好的，李四，大学同学关系。请问他的生日是什么时候？
用户：农历八月初五
助手：收到。农历八月初五。还有其他需要记录的信息吗？比如兴趣爱好、不喜欢的礼物类型等？
用户：他喜欢打篮球，不喜欢甜食
助手：好的，已记录。还有其他事件需要添加吗？比如你们认识的纪念日？
用户：没有了
助手：好的，我现在为你创建联系人文件...

✅ 已创建联系人：李四
📁 文件位置：reminder-data/contacts/li-si.md
📅 事件：生日（农历八月初五）
🏷️ 标签：篮球
⚠️ 注意：不喜欢甜食

检查提醒

当检查当天需要提醒的事件时：

1. 1. 读取所有联系人：遍历数据目录中的所有 Markdown 文件
2. 解析日期：

1. 3. 判断提醒时间：

1. 4. 生成内容：

1. 5. 推送消息：

农历转换

使用 lunar-javascript 库进行农历/阳历转换：

javascript
const { Lunar } = require(lunar-javascript);

// 农历转阳历
function lunarToSolar(lunarYear, lunarMonth, lunarDay) {
const lunar = Lunar.fromYmd(lunarYear, lunarMonth, lunarDay);
const solar = lunar.getSolar();
return {
year: solar.getYear(),
month: solar.getMonth(),
day: solar.getDay()
};
}

// 检查今年农历日期对应的阳历日期
function getThisYearSolarDate(lunarMonth, lunarDay) {
const currentYear = new Date().getFullYear();
return lunarToSolar(currentYear, lunarMonth, lunarDay);
}

闰月处理：lunar-javascript 会自动标记闰月。在提醒逻辑中，确保闰月仅在首月触发一次。

使用场景

场景 1：添加新联系人

用户：帮我添加一个朋友
助手：好的！请问这位朋友叫什么名字？
...

场景 2：查看即将到来的提醒

用户：最近有什么重要日子吗？
助手：让我查看一下...

📅 未来7天提醒：

1. 1. 张三的生日 - 3天后（5月20日）

1. 2. 父母结婚纪念日 - 5天后（10月1日）

场景 3：生成祝福语

用户