Health Reminder MCP Server

# ⚡ 快速开始指南 ## 🚀 5分钟上手 ### Windows 用户 1. **双击运行启动脚本** ``` 双击 start.bat 文件 ``` 脚本会自动： - 安装依赖 - 编译项目 - 启动客户端 2. **开始使用** - 看到菜单后，输入 `1` 并回车 - 立即收到第一次提醒 - 之后每 30 分钟自动提醒 ### macOS / Linux 用户 1. **运行启动脚本** ```bash chmod +x start.sh ./start.sh ``` 2. **开始使用** - 看到菜单后，输入 `1` 并回车 - 立即收到第一次提醒 - 之后每 30 分钟自动提醒 --- ## 📋 常用操作 ### 启动默认提醒（30分钟） ``` 选择: 1 ``` ### 自定义提醒时间 ``` 选择: 2 输入间隔: 60 (表示每小时提醒一次) ``` ### 停止提醒 ``` 选择: 3 ``` ### 查看当前状态 ``` 选择: 4 ``` ### 立即测试通知 ``` 选择: 5 ``` --- ## 🎯 使用场景推荐 | 场景 | 推荐间隔 | 说明 | |------|----------|------| | 办公室工作 | 30分钟 | 标准健康提醒 | | 程序开发 | 45-60分钟 | 深度工作时降低干扰 | | 学习/阅读 | 20-25分钟 | 番茄工作法 | | 轻度使用 | 60分钟+ | 偶尔使用电脑 | --- ## ⚙️ 手动安装（可选） 如果启动脚本无法使用，可手动执行： ```bash # 1. 安装依赖 npm install # 2. 编译项目 npm run build # 3. 启动客户端 npm run client ``` --- ## 🔧 常见问题 ### ❓ 没有收到通知？ **检查清单**： - ✅ 系统通知权限已开启 - ✅ 不在勿扰模式 - ✅ 通知中心设置正确 **测试方法**： 选择菜单选项 `5`（立即发送提醒），应该马上看到通知 ### ❓ 提示找不到 node 命令？ 需要先安装 Node.js： - 访问 https://nodejs.org/ - 下载并安装 LTS 版本 - 重启终端 ### ❓ 编译错误？ ```bash # 删除旧文件重新编译 rm -rf node_modules dist npm install npm run build ``` --- ## 📚 更多文档 - **完整文档**: 查看 `README.md` - **API 文档**: 查看 `docs/API.md` - **详细教程**: 查看 `docs/TUTORIAL.md` --- ## 💡 小技巧 1. **快速启动**: 创建桌面快捷方式指向 `start.bat` (Windows) 或 `start.sh` (Mac/Linux) 2. **开机自启**: 将快捷方式放到系统启动文件夹 3. **后台运行**: ```bash # 使用 pm2 npm install -g pm2 pm2 start npm --name "health-reminder" -- run client ``` 4. **自定义消息**: 准备几条不同的提醒语，定期更换保持新鲜感 --- ## 🎉 开始享受健康工作！ 记住：**健康是最重要的资产，定期活动让您更高效！** 💪 如有问题，欢迎查看详细文档或提交 Issue。