关键信息
macOS 本地工具- 目标用户
- 同时使用多个 AI 编码工具的开发者
- 核心用途
- 任务完成、中断与授权等待提醒
- 主要输入
- Codex、Cursor、OpenCode 的本地状态
- 主要输出
- 飞书消息、macOS 铃声与可选语音
- 使用的技术
- Node.js · SQLite · 飞书 SDK · launchd
- 重复控制
- 24 小时事件去重 · 10 分钟通知冷却
业务流程与系统设计
三张来源图公开介绍与项目需求资料中的业务、资料和组件关系。各图注明当前设计与使用条件。
面向哪些工作
Coding Task Monitor 面向使用 Codex、Cursor 与 OpenCode 执行编码任务的 macOS 用户。工具读取本地任务日志和数据库,在任务完成、中断或等待授权时提醒用户查看。
长时间任务经常需要用户在某个节点继续操作。项目通过飞书消息、本地铃声和可选语音朗读,让用户能够知道任务进入了需要关注的状态。
主要功能
| 工作范围 | 工具行为 |
|---|---|
| Codex 状态 | 读取 SQLite、session index 与 rollout 资料 |
| Cursor 与 OpenCode | 读取对应的本地日志 |
| 飞书通知 | 支持应用机器人与自定义群机器人 |
| 本地提醒 | 使用 macOS afplay 播放铃声,say 可朗读摘要 |
| 重复通知检查 | 24 小时事件窗口与 10 分钟通知冷却 |
| 后台运行 | 使用 macOS launchd 管理持续运行 |
README 给出的默认扫描间隔为 10 秒,可通过配置调整监控来源、通知方式和播报参数。Node.js、飞书 SDK、SQLite 读取库与 macOS 系统命令共同支撑运行。
使用流程
工具扫描本地数据库与日志,识别完成、中断和授权请求。经过重复通知检查后,根据配置发送飞书通知,或播放本地铃声与语音。
上方流程图介绍事件如何进入提醒渠道。通知发生后,用户继续在对应编码工具中处理任务或授权请求。
当前状态
本次介绍核验于 2026-10-14,使用 2026-07-10 最近提交的源码版本。README 提供初始化游标、dry-run、前台运行、通知诊断和 launchd 管理命令。
本地铃声和语音依赖 macOS,飞书通知需要相应应用或机器人配置。初始化游标用于控制历史事件,dry-run 用于阅读待处理结果。本次仅核验公开源码说明,没有运行监听或发送通知。
许可与资料
README 的 License 章节标注 MIT。本次读取的默认分支没有独立的根目录 LICENSE 文件,GitHub API 未给出许可证标识;介绍材料保留这两项来源信息。
公开仓库名称为 Coding-redphone-monitoring,项目 README 使用名称 Coding Task Monitor。源码入口指向原始仓库,页面名称用于说明用途。
来源与版本
README 标注 MIT · 许可文件待补充
- 公开 README 配置与通知说明 · 2026-07-10 提交
- GitHub 仓库 ↗
- 固定版本 README ↗
公开源码 9e997e072b60 · 核验 2026-10-14
