# task-reminder

> 本地提醒调度技能。用于用户说“提醒我多久之后/在某个时间做什么”等新增提醒需求，尤其适合非技术用户。负责检查服务、自动启动、安装依赖并调用提醒脚本。

- Author: zshs000
- Repository: zshs000/task_scheduler
- Version: 20260206221533
- Stars: 2
- Forks: 1
- Last Updated: 2026-02-06
- Source: https://github.com/zshs000/task_scheduler
- Web: https://mule.run/skillshub/@@zshs000/task_scheduler~task-reminder:20260206221533

---

---
name: task-reminder
description: 本地提醒调度技能。用于用户说“提醒我多久之后/在某个时间做什么”等新增提醒需求，尤其适合非技术用户。负责检查服务、自动启动、安装依赖并调用提醒脚本。
---

# 提醒调度技能

## 核心流程

1) 确定可用的 Python 命令。
2) 检查服务是否运行（健康检查）。
3) 将用户请求转换为提醒命令。
4) 执行提醒命令并反馈结果（提醒通过邮件发送）。

## 1) 确定 Python 命令

优先顺序（第一个可用的为准）：
- `<skill_root>/.venv/Scripts/python.exe` (if exists)
- `py`
- `python`
- `python3`

若都不可用，请用户安装 Python。

## 2) 确保服务运行

读取配置文件：
- `<skill_root>/config/app_config.json`

优先使用 `web_api_base`，否则拼接 `http://{host}:{port}`。
说明：先读取配置，以确定健康检查所用的端口与地址。

健康检查：
- `GET {api_base}/health`

若健康检查失败：
- 使用选定的 Python 命令运行 `<skill_root>/scripts/start_server.py`。
- 再次请求 `GET {api_base}/health`。
- 若仍失败，报告错误并停止。

后台运行：
- 可用 `--daemon` 参数启动后台服务（会写入 `<skill_root>/server.pid`）。
- 若用户未明确说明，先询问是否需要后台常驻；用户同意则使用 `--daemon`，否则默认前台。

## 3) 解析用户请求（两类意图）

### A) 相对时间（无需追问）

示例：
- “提醒我 2小时后吃饭”
- “3天后提醒我提交报告”

转换为：
```
python remind.py <offset> <content>
```
其中 `<offset>` 为 `1d2h30m10s` 这类组合，`<content>` 为提醒内容。

内容增强（统一改写语气）：
- 提取原始意图文本（去掉“提醒我/提醒我在/…后”等引导词）
- 改写为更友好的提示语
- 示例：
  - 原始意图：吃饭
  - 改写内容：主人~该吃饭啦！别饿着～

### B) 相对日期 / 指定时间（可能需要追问）

示例：
- “明天早上8点提醒我开会”
- “后天 9点提醒我交作业”
- “2026-02-07 09:00 提醒我开会”

转换为：
```
python remind.py --at "<time>" <content>
```

规则：
- 用户说“明天/后天/下周…”但**没有具体时间**时，必须追问：“几点提醒？”
- 若用户提供了具体时间，原样传给 `--at`。
- 最大允许未来时间：30 天（脚本会校验）。
直接把提醒内容作为唯一内容参数传入。

内容增强（带时间语气）：
- 在内容里加入时间提示
- 示例：
  - 原始意图：开会
  - 用户时间：明天 08:00
  - 改写内容：主人~现在是 08:00，到了开会时间啦！

## 4) 执行提醒命令

在此工作目录运行：
- `<skill_root>/scripts`

示例：
```
python remind.py 2h30m 提交报告
python remind.py --at "明天 08:00" 开会
```

## 输出给用户

- 成功：确认提醒内容与时间（邮件已发送/将按时发送）。
- 失败：展示脚本错误信息，并提示检查服务或配置。