夜巡特工

一句话定位
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 应用支持目录（仅本机）
- 合盖持续运行会耗电发热，建议放坚硬通风位置，任务跑完记得关掉

三、FAQ

Q1：它会一直让电池耗电吗？
只在开启时保持合盖运行。任务跑完点一下关掉，就恢复正常合盖睡眠，不影响续航。

Q2：需要会写代码吗？
不用。装上 Raycast 扩展就能用，菜单栏点咖啡杯开关即可。

Q3：它对所有 Agent 都有效吗？
它控制的是 macOS 合盖睡眠本身，不只是某个 Agent。只要进程在合盖状态下不被系统睡眠打断，就能持续运行。个别需要常驻屏幕的机制场景除外。

Q4：为什么不直接用 caffeinate？
`caffeinate` 通常防空闲睡眠，管不到 MacBook 合盖的睡眠逻辑。Agent Night Watch 显式控制 `SleepDisabled`，针对合盖场景更准确。

Q5：它安全吗？会碰我的密码吗？
不做任何密码/凭据存储。开启时会触发 macOS 自带管理员授权（每次开启都确认一次），不配置免密 sudo，不装特权助手。开源自可审计。

Q6：会损坏电脑吗？
不会。它只是切换一个系统睡眠开关。建议合盖运行时放通风处避免过热。

Q7：能和其他工具一起用吗？
可以。它只控制合盖睡眠覆盖，不与 IDEs、终端、其他 Raycast 扩展冲突。

ps：Night Watch 不会保持屏幕点亮。合盖持续运算仍会产生热量；高负载任务建议开盖并让屏幕自行熄灭，严禁在包内、床上或通风受阻的环境中运行。合盖前请移除键盘膜和较厚的摄像头盖。