定时提醒插件 - 用户使用指南

目录

1. 快速开始
2. 界面介绍
3. 创建提醒
4. 管理提醒
5. 处理提醒通知
6. 常见场景
7. 常见问题

快速开始

安装插件后，你会在 VSCode 左侧活动栏看到一个铃铛图标，这就是提醒插件的入口。

3步创建你的第一个提醒：

1. 点击左侧铃铛图标打开侧边栏
2. 点击顶部的 + 按钮
3. 按提示输入提醒名称、内容，选择提醒频率

界面介绍

侧边栏视图

点击左侧活动栏的铃铛图标，打开提醒侧边栏：

┌─────────────────────────────┐
│ 提醒列表            [+][⚙][↻][✕] │  <- 工具栏
├─────────────────────────────┤
│ ▼ 待确认 (2)                    │  <- 待确认分组（有未处理提醒时显示）
│   🔔 喝水提醒    触发于 14:30    │
│   🔔 休息提醒    触发于 15:00    │
├─────────────────────────────┤
│ ▼ 所有提醒 (3)                  │  <- 所有提醒分组
│   🔔 喝水提醒    每 30 分钟      │
│   🔔 休息提醒    每 1 小时       │
│   🔕 周报提醒    每周五 17:00    │  <- 已禁用的提醒
└─────────────────────────────┘

工具栏按钮：

• + 添加新提醒
• ⚙ 打开配置页面
• ↻ 刷新列表
• ✕ 一键消除所有待确认提醒

状态栏

右下角状态栏显示提醒状态：

• 🔔 提醒 - 正常状态
• 🔔 提醒 (3) - 有 3 条待确认提醒（背景变为警告色）

配置页面

点击齿轮图标打开配置页面，可以：

• 查看所有提醒列表
• 添加新提醒（支持所有提醒类型）
• 编辑现有提醒
• 启用/禁用提醒
• 删除提醒

创建提醒

方式一：快速添加（推荐日常使用）

1. 按 Ctrl+Shift+P (Mac: Cmd+Shift+P) 打开命令面板
2. 输入「添加新提醒」并回车
3. 输入提醒名称（如「喝水提醒」）
4. 输入提醒内容（如「该喝水了，保持健康！」）
5. 选择提醒频率：
   • 每30分钟
   • 每小时
   • 每2小时
   • 每天上午9点
   • 每天下午6点
   • 自定义...（打开配置页面）

方式二：配置页面添加（支持更多选项）

1. 点击侧边栏齿轮图标打开配置页面
2. 点击「添加新提醒」按钮
3. 填写表单：

基本信息：

• 提醒名称：简短描述，如「喝水提醒」
• 提醒内容：触发时显示的消息

提醒类型：

4. 点击「保存」

管理提醒

在侧边栏管理

鼠标悬停在提醒项上，会显示操作按钮：

• 🔕 启用/禁用：暂时关闭提醒，不会删除配置
• ✏️ 编辑：打开配置页面修改
• 🗑️ 删除：永久删除提醒

也可以右键点击提醒项，在菜单中选择操作。

在配置页面管理

配置页面提供更完整的管理功能：

• 查看所有提醒的详细信息
• 批量编辑提醒
• 查看提醒的完整配置

处理提醒通知

通知弹出时

当提醒触发时，会在 VSCode 右下角弹出通知：

┌─────────────────────────────────┐
│ ⏰ 喝水提醒: 该喝水了！           │
│                                 │
│         [知道了] [暂停此提醒]     │
└─────────────────────────────────┘

操作选项：

• 知道了：确认提醒，从待确认列表移除
• 暂停此提醒：确认并禁用该提醒

超时未确认

如果在配置的时间内（默认30秒）没有点击任何按钮：

1. 通知会自动消失
2. 提醒保留在「待确认」列表中
3. 侧边栏图标显示数字角标
4. 状态栏显示待确认数量

处理待确认提醒

单个确认：

1. 点击侧边栏铃铛图标
2. 在「待确认」分组找到对应提醒
3. 点击旁边的 ✓ 按钮确认

一键全部确认：

1. 点击侧边栏顶部工具栏的「清除」按钮
2. 或使用命令「一键消除所有待确认提醒」

常见场景

场景1：工作时定时休息

需求：每小时提醒休息5分钟

设置：

• 名称：休息提醒
• 内容：工作1小时了，起来活动一下！
• 类型：间隔时间
• 间隔：60分钟

场景2：每日站会提醒

需求：每天早上9:30提醒参加站会

设置：

• 名称：站会提醒
• 内容：9:30站会即将开始
• 类型：每天
• 时间：09:25（提前5分钟）

场景3：每周周报提醒

需求：每周五下午提醒写周报

设置：

• 名称：周报提醒
• 内容：该写本周周报了
• 类型：每周
• 星期：周五
• 时间：16:00

场景4：农历生日提醒

需求：农历八月十五提醒中秋节

设置：

• 名称：中秋节提醒
• 内容：中秋节快乐！记得吃月饼
• 类型：农历每年
• 农历月：八月
• 农历日：15
• 时间：09:00

场景5：喝水提醒

需求：每30分钟提醒喝水

设置：

• 名称：喝水提醒
• 内容：该喝水了，保持健康！
• 类型：间隔时间
• 间隔：30分钟

常见问题

Q: 提醒没有触发？

检查以下几点：

1. 确认提醒已启用（图标是 🔔 而不是 🔕）
2. 确认插件总开关已启用（设置中 reminder.enabled 为 true）
3. 对于间隔提醒，首次触发可能需要等待一个间隔周期

Q: 如何修改通知超时时间？

1. 打开 VSCode 设置（Ctrl+,）
2. 搜索 reminder.notificationTimeout
3. 修改数值（单位：秒，范围：5-300）

Q: 关闭 VSCode 后提醒还会触发吗？

不会。提醒只在 VSCode 运行时触发。如果需要系统级提醒，建议使用操作系统自带的提醒功能。

Q: 多个 VSCode 窗口会重复提醒吗？

每个窗口都会独立显示通知，但待确认状态是共享的。在一个窗口确认后，其他窗口刷新列表会看到更新。

Q: 如何备份提醒配置？

提醒数据存储在 VSCode 的 globalState 中。目前暂不支持导出，建议在配置页面截图保存重要提醒的配置。

Q: 农历闰月怎么设置？

在配置页面选择「农历每年」类型后，勾选「闰月」选项。如果该年没有对应的闰月，会自动使用非闰月的日期。

快捷键

目前插件没有预设快捷键，你可以在 VSCode 键盘快捷方式设置中为以下命令绑定快捷键：

• reminder.openSettings - 打开设置
• reminder.addReminder - 添加提醒
• reminder.clearAllPending - 一键消除

如有问题或建议，请联系作者：

Gin Email: 392286507@qq.com