# 📅 日程提醒助手 · 使用指南

> 适合所有人，不需要任何编程基础。

---

## ✨ 核心特色：在哪里聊天，提醒就发到哪里，零配置

> 大多数提醒工具需要你先配置渠道、绑定账号、填写 ID……这个助手不需要。
>
> **你在哪里发消息，提醒就回到哪里——Web 界面、钉钉、飞书，直接就能用。**

你设置好日程提醒后，到时间助手会主动在对话里发消息给你：

```
⏰ 日程提醒
📌 【客户拜访】即将在 30 分钟后开始
🕐 14:00 – 15:00  📍 客户办公室
```

如果你需要**定时主动推送**（比如每天早上 7 点自动发日报），才需要配置目标渠道（钉钉/飞书/企业微信/Telegram）和接收者 ID。

---

## 快速开始（推荐）：一次配置，每天自动提醒

> 让管理员或部署人员运行一次以下命令，之后你就什么都不用做了：

```bash
bash /app/skills/schedule-reminder/scripts/setup.sh
```

按提示填写：日程文件路径、消息渠道、你的用户 ID、每天几点发日报。  
完成后，**每天早上**自动发送今日日程摘要，并按时提醒每个会议。

---

## 这个助手能帮你做什么？

你把日程表发给 AI 助手，它会：

1. **自动列出**今天和近期的待办事项，整理成清晰的表格
2. **发现冲突**：比如两个会议时间重叠，或者前一个刚结束下一个就开始
3. **帮你设置提醒**：在指定时间之前，直接在当前对话里发消息提醒你（Web 界面、钉钉、飞书都行）
4. **不骚扰**：只提醒你确认过的事项，不会群发给别人

---

## 支持的日程输入方式

不管你的日程存在哪里、格式是什么，助手都能处理：

| 方式          | 怎么做                           | 适合场景                 |
| ------------- | -------------------------------- | ------------------------ |
| 直接粘贴表格  | 把 Markdown 表格复制粘贴到对话框 | 日程已有表格             |
| 发送截图/照片 | 直接上传图片，助手自动 OCR 识别  | 手机截图、扫描件、课程表 |
| 发送文件      | 上传 Excel / CSV / Word / PDF    | 从其他工具导出的日程表   |
| 说一句话      | 直接说"明天下午3点开会"          | 临时添加单个事项         |
| 指定文件路径  | 告诉助手文件在哪，如 `~/日程.md` | 文件已在服务器上         |
| 别人的时间表  | 发孩子课程表说"我要接女儿"       | 从他人日程推导自己的行动 |

---

## 第一步：准备你的日程表

### 方式一：直接粘贴表格

把日程填进下面这个表格（可以直接复制粘贴，然后改成你的内容）：

```
| 日期       | 开始时间 | 结束时间 | 事项           | 地点     | 参与者   | 优先级 | 提前(分钟) | 备注         |
|------------|----------|----------|----------------|----------|----------|--------|------------|--------------|
| 2026-03-02 | 09:00    | 10:00    | 周会           | 会议室A  | 全员     | 高     | 15         | 带PPT        |
| 2026-03-02 | 14:00    | 15:00    | 客户拜访       | 客户办公室 | 张三   | 高     | 30         |              |
| 2026-03-03 | 10:00    | 11:00    | 季度汇报       | 大会议室 | 全员     | 高     | 20         |              |
```

#### 填写说明

| 列名       | 必填 | 怎么填                                 | 示例            |
| ---------- | ---- | -------------------------------------- | --------------- |
| 日期       | ✅   | 年-月-日（四位年份）                   | 2026-03-02      |
| 开始时间   | ✅   | 24小时制，冒号分隔                     | 09:00 / 14:30   |
| 结束时间   | ✅   | 同上（用于判断是否有冲突）             | 10:00           |
| 事项       | ✅   | 简短的名称                             | 周会 / 客户拜访 |
| 地点       | ❌   | 线下写地点，线上会议写"线上"           | 会议室A / 线上  |
| 参与者     | ❌   | 相关人员，逗号分隔                     | 张三, 李四      |
| 优先级     | ❌   | 高 / 中 / 低（不填默认"中"）           | 高              |
| 提前(分钟) | ❌   | 提前多少分钟发提醒（不填默认 15 分钟） | 15 / 30         |
| 备注       | ❌   | 想让提醒消息里带上的额外信息           | 记得带合同      |

> **小技巧**：不确定的列可以不填，直接留空就行，不影响使用。列名也不必完全一致，助手会自动识别。

---

### 方式二：发送截图或照片

直接把日程截图/拍照上传发给助手，说一句：

```
帮我识别这张课程表，设置提醒
```

助手会自动 OCR 识别图片中的表格内容，展示识别结果后让你确认再写入日程。

支持格式：JPEG、PNG、截图、扫描件、PDF 图片等。

---

### 方式三：发送 Excel / CSV / Word / PDF 文件

直接上传文件，助手会自动转换为 Markdown 后读取：

```
帮我把这个 Excel 里的日程导入
```

支持：Excel（`.xlsx/.xls`）、CSV（`.csv`）、Word（`.docx`）、PDF（`.pdf`）、PowerPoint（`.pptx`）

---

### 方式四：直接说一句话（自然语言）

不需要表格，直接描述就行：

```
明天下午3点有个客户会议，提前半小时提醒我
```

```
下周五上午10点产品评审，会议室B，高优先级
```

```
3月5号截止提交季度报告，提前一天提醒
```

助手会解析时间和事项，展示确认卡片后写入日程。

---

### 方式五：发别人的时间表（间接日程）

如果你发的是别人的时间表，告诉助手你需要做什么，它会帮你推导出自己的行动：

```
这是我女儿的课程表，我需要接她放学，下课后15分钟内到
```

助手不会把"语文、数学、美术"写进你的日程，而是根据下课时间帮你生成**接送提醒**：

```
📅 根据课程表，为您生成接送日程，请确认：

| 日期   | 出发时间 | 事项       | 备注                   |
|--------|----------|------------|------------------------|
| 每周一 | 09:15    | 接女儿放学 | 课程：语文 8:50-9:30   |
| 每周三 | 14:25    | 接女儿放学 | 课程：体育 10:30-14:10 |
| 每周五 | 15:45    | 接女儿放学 | 课程：手工 14:50-15:30 |

✅ 全部写入  ✏️ 修改某项  ❌ 取消
```

---

## 第二步：发给 AI 助手

把表格内容**直接粘贴**到对话框里，然后加一句话：

```
帮我看今天的日程，设置提醒
```

或者这样说也可以：

- `帮我看这周有什么安排`
- `检查一下有没有时间冲突`
- `提醒我今天所有的会议`

---

## 第三步：确认提醒设置

AI 助手会回复一个预览，大概是这样的：

---

📅 **今日日程（3月2日）**

| 时间        | 事项     | 地点       | 优先级 | 提前提醒 |
| ----------- | -------- | ---------- | ------ | -------- |
| 09:00–10:00 | 周会     | 会议室A    | 🔴 高  | 15分钟   |
| 14:00–15:00 | 客户拜访 | 客户办公室 | 🔴 高  | 30分钟   |

以下提醒将在约定时间直接发回此对话：

- ⏰ **08:45** 提醒 → 09:00 周会（提前15分钟）
- ⏰ **13:30** 提醒 → 14:00 客户拜访（提前30分钟）

是否确认创建提醒？

---

你回复"**确认**"或"**好的**"，AI 就会自动设置好提醒任务。

如果你想调整，可以直接说：

- `把下午那个改成提前1小时`
- `跳过周会提醒，其他的都设置`

---

## 当天的提醒长什么样？

在约定的时间，AI 会给你发这样一条消息：

---

⏰ **日程提醒**

📌 **【客户拜访】** 即将在 30 分钟后开始  
🕐 14:00 – 15:00  
📍 客户办公室  
👥 参与者：张三  
📝 记得带合同

祝会议顺利！

---

## 时间冲突是什么意思？

如果你的日程表里有两件事时间重叠，AI 会提前告诉你：

```
⚠️ 发现时间冲突：
【周会】09:00–10:00 与【产品评审】09:30–11:00 重叠 30 分钟。
建议：将产品评审调到 10:00 之后，或确认是否可以同时参加线上会议。
```

你可以选择忽略（比如一个是线上可同时参加），或者调整日程后重新发给 AI。

---

## 提醒发到哪里？

**你在哪里发消息，提醒就回到哪里，不需要任何配置。**

- 在 Web 界面对话 → 提醒发回 Web 界面
- 在钉钉对话 → 提醒发回钉钉
- 在飞书对话 → 提醒发回飞书
- 在 Telegram 对话 → 提醒发回 Telegram

定时自动推送（cron）也一样，默认回到你上次发消息的渠道，**不需要填写渠道名或用户 ID**。

只有需要推送给**其他用户**或**特定群组**时，才需要指定渠道和接收者 ID。

提醒**只发给你自己**，不会发给其他人，也不会群发。

---

## 常见操作一览

| 你想做什么               | 对 AI 说什么                             |
| ------------------------ | ---------------------------------------- |
| 看今天的日程             | 帮我看今天的日程                         |
| 看明天的安排             | 帮我看明天有什么                         |
| 看整周的日程             | 帮我整理这周的安排                       |
| 只检查冲突，不设提醒     | 帮我检查一下日程有没有冲突               |
| 取消某个提醒             | 取消下午客户拜访的提醒                   |
| 取消今天所有提醒         | 取消今天的所有提醒                       |
| 修改提前时间             | 把周会的提醒改成提前30分钟               |
| 设置每天固定提醒         | 每天早上9点提醒我填日报                  |
| 添加一条新日程           | 明天下午3点客户会议，提前30分钟提醒      |
| 上传截图识别日程         | （直接发图片）帮我识别并设置提醒         |
| 上传文件导入日程         | （直接发文件）帮我把这里的日程导入       |
| 从孩子课程表生成接送提醒 | 这是课程表，我要接女儿，下课后15分钟内到 |

---

## 常见问题

**Q：日程表格式填错了会怎样？**  
A：AI 会告诉你哪里格式不对，你改好重新发就行。列名不标准（如"开始"写成"起始时间"）也没关系，助手会自动识别。

**Q：提醒会自动重复吗？**  
A：单次会议的提醒执行一次后自动删除。如果你需要每周、每天重复提醒，告诉 AI 一声：`每周一早上9点提醒我开周会`，AI 会单独帮你设置。

**Q：我换手机 / 重新开群了，提醒还有效吗？**  
A：提醒绑定的是你的账号 ID，不是设备。只要 AI 助手服务在运行，就会正常发送。

**Q：如果我有很多条日程，能一次全设置吗？**  
A：可以。把整周的日程表发给 AI，说"帮我设置这周所有高优先级事项的提醒"，AI 会批量处理并逐条确认。

**Q：发截图识别不准怎么办？**  
A：AI 会展示识别结果让你确认，你可以在确认前修改任何字段，或者直接让 AI 重新识别。

**Q：提醒失败了怎么办？**  
A：告诉 AI "帮我查一下提醒任务状态"，它会列出所有已设置的提醒，你可以确认或重新创建。

---

## 日程表模板（直接复制使用）

```
| 日期 | 开始时间 | 结束时间 | 事项 | 地点 | 参与者 | 优先级 | 提前(分钟) | 备注 |
|------|----------|----------|------|------|--------|--------|------------|------|
|      |          |          |      |      |        |        |            |      |
```

把上面的表格发给 AI，然后说：**"帮我按这个格式设置今天的提醒"** 就可以了。
