夜巡特工

项目介绍

一句话定位Agent Night Watch 是一个写在 MacBook 菜单栏的 Raycast 开关，样子是一只咖啡杯。单击打开它，可以合上电脑盖子，长任务的 Agent 照常继续跑；单击关掉它，恢复正常的合盖睡眠。它解决什么问题把长任务（比如 Codex 跑自动化）交给 Agent 后合盖，MacBook 会进入睡眠，任务中断。一直开着屏幕又晃眼，心里总是情不自禁惦记。Agent Night Watch 用一个菜单栏咖啡杯开关，让「合盖保持运行」和「正常睡眠」可以随意切换。 功能亮点| 亮点 | 说明 || 咖啡杯状态一目了然 | 冒水汽 = 合盖继续跑；没水汽 = 正常睡眠 || 一次点击切换 | 正常状态下单击咖啡杯直接切换，不用进菜单 || 严格权限边界 | 不存密码、不配免密 sudo、不装常驻特权助手 || 每一次开启都授权 | 开启弹管理员授权，关闭自己创建的会话不需再输密码 || 读真实系统状态 | 用 macOS `SleepDisabled` 作为事实源，不是普通空闲睡眠断言 || 可恢复关闭 | 随时点一下关掉，电脑恢复合盖睡眠 || 与 caffeinate 不同 | 普通工具防空闲睡眠，这个显式控制全局合盖睡眠覆盖 | 使用场景- **夜晚**：睡前合盖，让 Codex/Agent 跑长任务，不被屏幕光打扰，第二天醒来收货。- **出门**：把长任务挂上再合盖离开，保护屏幕隐私，回来查看任务顺畅。- **调试运行**：需要持续运行的本地服务或长任务，合盖保持在线。- **省心看守**：不用一直盯着屏幕看进度，合盖让电脑自己干活。 开源与安装- MIT 协议开源- GitHub：https://github.com/Yuchen07569/raycast-agent-night-watch- Raycast Store 版本已提交，尚未上架；上架前可从源码安装： ``` git clone https://github.com/Yuchen07569/raycast-agent-night-watch.git cd raycast-agent-night-watch/raycast-extension npm ci npm run dev ```- 仓库附带一个 Codex Skill，负责安装、检查、升级、排障（不替你开/关睡眠，开关仍在咖啡杯和快捷键上）### 安全与数据- 无网络请求、无遥测、无账号系统- 不保存密码、不写用户会话目录的敏感文件- 状态文件写在 macOS 应用支持目录（仅本机）- 合盖持续运行会耗电发热，建议放坚硬通风位置，任务跑完记得关掉 三、FAQQ1：它会一直让电池耗电吗？只在开启时保持合盖运行。任务跑完点一下关掉，就恢复正常合盖睡眠，不影响续航。Q2：需要会写代码吗？不用。装上 Raycast 扩展就能用，菜单栏点咖啡杯开关即可。Q3：它对所有 Agent 都有效吗？它控制的是 macOS 合盖睡眠本身，不只是某个 Agent。只要进程在合盖状态下不被系统睡眠打断，就能持续运行。个别需要常驻屏幕的机制场景除外。Q4：为什么不直接用 caffeinate？`caffeinate` 通常防空闲睡眠，管不到 MacBook 合盖的睡眠逻辑。Agent Night Watch 显式控制 `SleepDisabled`，针对合盖场景更准确。Q5：它安全吗？会碰我的密码吗？不做任何密码/凭据存储。开启时会触发 macOS 自带管理员授权（每次开启都确认一次），不配置免密 sudo，不装特权助手。开源自可审计。Q6：会损坏电脑吗？不会。它只是切换一个系统睡眠开关。建议合盖运行时放通风处避免过热。Q7：能和其他工具一起用吗？可以。它只控制合盖睡眠覆盖，不与 IDEs、终端、其他 Raycast 扩展冲突。 ps：Night Watch 不会保持屏幕点亮。合盖持续运算仍会产生热量；高负载任务建议开盖并让屏幕自行熄灭，严禁在包内、床上或通风受阻的环境中运行。合盖前请移除键盘膜和较厚的摄像头盖。