prompt-time

prompt-time

直接从 Claude Desktop 安排 Windows 桌面提醒。 零依赖——只需 PowerShell + Windows 任务计划程序。

功能

为 Claude Desktop 添加三个工具：

工具	功能
schedule_reminder	设置一次性或重复桌面提醒
list_reminders	显示当前安排的所有提醒
cancel_reminder	根据 ID 取消提醒

重启电脑或重启 Claude 后，提醒仍会保留。没有云端服务——所有操作都在本地运行。

60 秒内完成安装

1. 从最新版本下载 prompt-time-v2.2.6.zip。
2. 右键单击 zip 文件 → 全部解压。 必须先由 Windows 解压——从 zip 预览窗口中运行 install.bat 将无法正常工作。
3. 打开解压后的文件夹，双击 install.bat。
4. 如果 Claude Desktop 正在运行，安装程序会提示你重启。请确认——重启 Claude Desktop 后，MCP 工具才会显示。
5. 完成。工具现已就绪。

无需 Node、无需 npm、无需管理员权限，也无需互联网连接。

安装后，解压出的文件夹可以删除。 v2.2.6+ 会在安装时将 MCP 服务和监视器都复制到 prompt-time 数据目录，并让 Claude Desktop 的配置和计划任务使用数据目录中的副本。之后你可以移动或删除解压出的文件夹，不会造成任何问题。（如果要升级，只需从新解压的文件夹中重新运行 install.bat。）

使用示例

直接与 Claude 对话：

“提醒我今天下午 4 点发送每周更新” “设置一个工作日每天上午 9 点检查收件箱的提醒” “提醒我下周一下午 2 点参加董事会电话会议” “我设置了哪些提醒？” “取消提醒 PROMPTTIME-A1B2C3D4”

重复频率：once、daily、weekly、weekdays。精度约为 10 秒（监视器的轮询间隔）。

工作原理

包含两部分：

1. MCP 服务（prompt_time.ps1）——在 Claude Desktop 的进程树中运行。验证提醒并将其加入磁盘上的 JSONL 文件。
2. 监视器守护进程（prompt-time-watcher.ps1）——安装时注册为一次任务计划程序 At LogOn 任务。轮询队列，在进程内显示 Toast 弹出窗口，并更新重复条目。

MCP 服务运行时不会与任务计划程序通信，不会启动进程，也不会显示 UI。它只会为每条提醒写入一行 JSONL。其他所有工作都由监视器负责。

为什么使用两个进程——MSIX 边界

Claude Desktop 以 MSIX 打包应用 的形式发布。MSIX 容器会透明地虚拟化文件写入：在包内运行的服务调用 Add-Content $env:APPDATA\prompt-time\queue.jsonl 时，并不会写入 %APPDATA%\Roaming\prompt-time\queue.jsonl，而是写入 %LOCALAPPDATA%\Packages\<package-family>\LocalCache\… 下按包划分的影子目录。

任务计划程序启动的任何进程都在包外运行，因此为每个提醒创建的 schtasks 任务会在实际路径查找文件，却什么也找不到。

prompt-time 通过以下方式一次性解决此问题：启动时，每个组件（prompt_time.ps1、prompt-time-watcher.ps1、install.ps1、uninstall.ps1）都会发现 Claude AppX 包，并在其 LocalCache 中计算出相同的规范数据目录。服务写入和监视程序读取的都是同一个物理文件。监视程序会自行显示弹出窗口，而不是让任务计划程序来显示，这样所有承载状态的操作都位于边界的同一侧。

安装程序还会在 MCP 服务首次写入前，于规范路径预先创建队列文件；否则，MSIX 文件虚拟化会将新文件创建操作重定向到包影子目录，即便实际路径上的现有文件可以直接写入。

Claude Desktop 配置本身也有同样的问题。如果采用 MSIX 打包的 Claude 曾写入过自己的 claude_desktop_config.json（例如保存偏好设置），MSIX 就会在 %LOCALAPPDATA%\Packages\<family>\LocalCache\Roaming\Claude\claude_desktop_config.json 创建按包划分的影子副本，之后每次启动都会从影子副本读取。如果安装程序只写入 %APPDATA%，Claude 在这些计算机上就看不到配置。v2.2.3+ 会优先读取影子副本作为事实来源，并以原子方式将合并后的配置写入两个路径；卸载时也会从两个路径移除。v2.2.4 增加了写入后的自验证功能：如果配置项未能保留（例如被 AV 回滚或受托管策略覆盖），安装会明确报错并提供可执行的提示，而不是虚报成功。运行 diagnose.bat 可查看完整分析。

故障排查

通知被“专注助手”静音。 Windows“专注助手”（“设置” → “系统” → “专注”）会静音 Toast 通知。可以关闭该功能，或将 powershell.exe 添加到优先级列表。

Claude Desktop 中未显示工具。

1. 完全退出 Claude Desktop（右键单击系统托盘图标 → “退出”），然后重新打开。关闭按钮“X”只会最小化；工具不会重新加载。
2. 在解压后的文件夹中运行 diagnose.bat。它会读取你的配置，以 Claude Desktop 将使用的方式启动 prompt_time.ps1，读取 Claude Desktop 的 MCP 日志，并针对每项故障输出可执行的提示。大多数“安装已运行，但什么都没出现”的情况都可以在这里诊断，无需联系 IT。
3. 如果 diagnose.bat 显示所有检查均通过，但工具仍未显示，请运行 diagnose.bat -Json，并在提交 Bug 时附上输出。

install.bat 立即关闭。 请改为从 cmd 提示符运行，以便查看错误：在解压后的文件夹中运行 install.bat。安装程序还会将调试日志写入 %APPDATA%\prompt-time\prompt-time.debug.log（或 MSIX 对应的 LocalCache 路径）；请检查该位置。

提醒未触发。 检查监视程序任务是否正在运行：

Get-ScheduledTask -TaskName PROMPTTIME-Watcher | Get-ScheduledTaskInfo

LastTaskResult 应为 267009（正在运行）或 0（成功）。

卸载

双击 uninstall.bat。它会从 Claude Desktop 的配置中移除 prompt-time 条目，删除 PROMPTTIME-Watcher 计划任务，并清除数据目录。配置中的其他 MCP 服务不受影响。

测试

.\tests\run.ps1

如果未安装 Pester 5，则会安装；随后运行 Pester 测试套件，并在 tests/pester-results.xml 输出 NUnit XML。每次推送时，CI 都会运行同一测试流程，并执行 Invoke-ScriptAnalyzer。

安全

有关信任模型、供应链说明以及如何报告漏洞，请参阅 SECURITY.md。简而言之：信任边界是你本地的 Windows 用户；提醒标题和消息以明文形式存储在磁盘上（请勿在其中放入机密信息）；提示时会注册一个登录时运行的计划任务，作为一种标准持久化机制。

许可证

MIT — 请参阅 LICENSE。

---

由 Ryan Stewart 构建