起身提醒

一款面向 Windows 10/11 的本地托盘提醒工具。默认连续使用电脑 50 分钟后建议活动 5 分钟，并提供系统通知、可选弹窗、锁屏/空闲判断、今日统计和可选 Codex MCP 集成。

本项目是非官方社区项目，与 OpenAI 不存在隶属、合作或背书关系。Codex 是 OpenAI 的商标；项目仅使用其名称准确描述可选的兼容功能，不使用 OpenAI 或 Codex 官方标识。

使用方式

• 安装版：运行 起身提醒-Setup-*-x64.exe，适合日常使用，支持开始菜单和开机启动。

• 便携版：运行 起身提醒-Portable-*-x64.exe，无需安装，默认不开启开机启动和 Codex 集成。

• 关闭主窗口不会退出应用；需要通过托盘菜单选择“退出”。

所有设置和统计保存在 Electron 的用户数据目录，不记录具体按键、鼠标位置或输入内容。托盘应用是唯一计时和数据源。

Related MCP server: focus-timer-tools

Codex 集成

Codex 集成默认关闭。开启后，在设置页展开“MCP 连接配置”，将显示的配置加入 Codex。MCP 使用 stdio，并通过带随机令牌的 Windows 命名管道连接正在运行的托盘应用，不开放本地网络端口。

便携版不会依赖 Windows Toast 作为唯一提醒通道：即使系统通知未注册或被静默丢弃，也会保留非聚焦轻量弹窗，并独立播放已启用的系统提示音。为避免出现完全不可见的提醒，便携版不会在全屏时关闭这个弹窗兜底。“通知 + 轻量弹窗”会从第一次提醒开始显示弹窗。

Windows 托盘图标使用随程序打包的 PNG 资源，避免部分系统无法解析运行时 SVG 而显示为空白图标。

提供的工具：

• get_status

• start_break

• snooze_reminder

• pause_reminders

• get_today_stats

• get_daily_summary（按需总结模式）

• update_settings

• acknowledge_codex_reminder

“同步 + 计时控制”提供查询和计时操作；“只读同步 + 按需总结”开放本地数据摘要工具；“只读同步 + 状态检查”会在状态结果中提供防重复提醒标记。后两项不允许 Codex 修改托盘状态，并且需要 Codex 主动调用对应工具，应用不会自行向外部服务发送请求。

本地开发

pnpm install
pnpm typecheck
pnpm test
pnpm build
pnpm dev

生成安装版和便携版：

pnpm dist

构建产物位于 release/。该目录不会提交到源码仓库；正式二进制文件应通过 GitHub Releases 发布，并附带版本说明和校验值。

开源许可

项目源码采用 MIT License 发布，版权归 rayc2026 及贡献者所有。第三方运行时及开发工具的许可信息见 THIRD_PARTY_NOTICES.md。

项目生成的配置和统计只保存在用户本地。发布者不应将个人用户数据目录、签名证书、令牌或构建密钥提交到仓库或 Release。

架构

• src/main：Electron 主进程、计时状态机、持久化、托盘、Windows 系统事件和命名管道。

• src/renderer：主面板、提醒弹窗、活动倒计时及空闲确认界面。

• src/mcp：Codex stdio MCP 适配器。

• src/shared：共享类型和默认设置。

运行时不访问互联网，也不包含遥测或自动更新。