Codex 跑起任务后，我经常会切到浏览器、编辑器或文件管理器继续做别的事。问题也随之出现：它还在执行，还是正在等我批准？任务已经结束了吗？最后回复是什么？

为了确认这些事，我得一次次切回 Codex。短任务还好，遇到构建、检索、重构这类耗时任务，这种来回查看很快就变成一种打断。

Codex Beacon。它是一个只服务于 Codex、只面向 Windows 的桌面任务悬浮岛。

GitHub：github.com/0731koukou/codex-beacon
最新版本：Codex Beacon v0.4.0

它解决的不是“展示”，而是少切几次窗口

Codex Beacon 常驻在屏幕顶部，用一块紧凑的悬浮区域显示当前 Codex 任务。展开后可以看到真实任务标题、项目、模型、耗时、运行状态和最后回复，也能浏览最近的并行任务。

目前它主要处理几种状态：

• 进行中：使用青蓝色，表示 Codex 正在处理任务；
• 等待操作：使用琥珀色，提醒我回到 Codex 批准操作或补充信息；
• 已完成：使用绿色，并显示任务的最终回复；
• 失败或失联：使用红色或中性提示，避免把异常退出继续显示成“运行中”。

点击当前任务，可以通过对应的 Codex 任务地址跳回原对话。它没有试图替代 Codex，只是把最容易错过的状态留在视线里。

状态不是根据 CPU 占用猜出来的

Codex Beacon 使用 Codex 的本地 Hook 接收 UserPromptSubmit 和 Stop 事件，再读取对应的本地 rollout 记录与状态缓存。它不会因为进程还在就武断地判断任务正在运行，也不会用一个虚假的百分比进度制造确定感。

当前任务、最近任务和完成回复都来自本机数据。任务状态不需要上传到外部服务，悬浮岛也不依赖云端中转。

这里仍然有一个现实边界：Codex 目前没有提供一个适合第三方桌面工具稳定调用的外部审批接口。因此，Codex Beacon 可以提醒“需要批准”，也可以把我带回对应任务，但不会在悬浮岛里伪装成已经完成审批。这个限制写清楚，比做一个偶尔失效的按钮更可靠。

如果 Codex 或系统异常退出，没有正常产生结束事件，Codex Beacon 会在超时后把任务标记为失联，而不是无限保持进行中。

我刻意保留的产品取舍

界面上最重要的不是动画数量，而是状态能否一眼区分。进行中使用青蓝色，完成后才切换为绿色；等待批准使用琥珀色；失败使用红色。这样即使只看到一个小指示灯，也不容易误判当前状态。

状态缓存最多保留最近 6 条任务，展开面板会列出其中最新的 4 条，并按 session_id 和 turn_id 区分会话与轮次。多个 Codex 任务同时运行时，可以看见每条任务各自的状态，而不是只显示一个模糊的“Codex 忙碌中”。

悬浮岛本身保持克制：默认折叠，始终置顶，需要细节时再展开。它不是第二个 Codex 窗口，也不承担聊天、文件浏览或项目管理。

安装与使用

当前版本支持 Windows 10/11 x64。

1. 下载并运行安装包；
2. 启动 Codex Beacon，按界面提示连接或修复 Codex Hook；
3. 在 Codex 的“设置 → Hooks”或 /hooks 中审核并信任 Codex Beacon Hook；
4. 新建一条真实 Codex 任务，悬浮岛会开始同步状态。

下载入口：

• Windows 安装包
• v0.4.0 完整发布页
• 产品介绍视频

技术实现

Codex Beacon 的前端使用 React 19、TypeScript 和 Vite 7，桌面壳基于 Tauri 2。Hook 安装、本地状态读取、窗口定位、托盘和开机启动由 Rust 与 Windows API 负责。

项目使用 MIT License 开源。它是独立的社区项目，与 OpenAI 不存在隶属、合作或官方背书关系。

这仍然是一个早期版本。接下来真正值得做的，不是继续堆功能，而是把任务结束判定、审批提醒、跳回原对话和窗口动效继续磨稳。如果你也在 Windows 上长期使用 Codex，可以从 GitHub 仓库 下载体验；遇到不准确的状态或异常场景，也欢迎提交 Issue。