Codex Pixel Office：把 AI 编程会话变成一间实时工作的像素办公室

本文最后更新于18 天前，其中的信息可能已经过时，如有错误请发送邮件到2275012286@qq.com，或者在下方留言。

我给 Codex 盖了一间像素办公室。

当几个编程任务同时运行，主会话又拉起多个子代理时，终端窗口很快就变得难以追踪：谁还在工作，谁在等我，哪个任务刚刚结束？Codex Pixel Office（Codex 像素办公室）把本机真实的 Codex 会话映射成像素员工，让这些状态变成一间可以巡视、点击和继续派活的办公室。

它既是会话状态看板，也提供继续对话、创建任务和中断执行的入口。像素动作由程序读取到的会话事件驱动，是对工作状态的可视化表达，并不代表能看到模型内部的完整思考过程。

本文更新于 2026 年 9 月 27 日，下载与运行说明对应 v1.2.2 源码发行版。支持 Windows、Linux 桌面窗口和本机浏览器模式。项目由我独立开发，非 OpenAI 官方产品。

Codex 像素办公室界面：会话工位、主会话与子代理、状态统计和聊天侧栏 — 应用界面预览。不同版本、主题和会话数量下的布局可能有所不同。

项目地址与下载

两个发行页均提供 codex-pixel-office-v1.2.2-source.zip、codex-pixel-office-v1.2.2-source.tar.gz 和 SHA256SUMS.txt。Windows 用户可以选择 ZIP，Linux 用户可以选择 tar.gz。

下载包是源码包，不是免安装 EXE。解压后仍需准备 Python 及对应运行模式的依赖。如果只是想先体验界面，建议从浏览器模式开始。

阅读导航：功能介绍 · 快速开始 · 桌面模式 · 工作原理 · 常见问题

一、这间办公室能做什么

真实会话对应像素员工

办公室每 2 秒同步一次最近活跃的未归档 Codex 会话。默认活跃时间范围为 30 分钟，每个会话拥有自己的工位。主会话使用金色标准工位，子代理使用青绿色紧凑工位，并优先安排在父会话附近；也可以切换“全部 / 主会话 / 子代理”筛选。

点击员工，可以查看会话标题、模型、工作目录、父会话、当前活动和最近更新时间。这里的“活跃”依据本地会话记录判断，不等同于每个员工都正在消耗模型额度。

状态变成动作

状态	含义	画面表达
`working`	处理任务或生成回复	在工位工作、敲键盘等
`thinking`	事件显示正在思考或组织方案	阅读、踱步、看白板等
`tool`	调用工具	操作终端、查看资料等
`waiting`	等待输入、子代理或其他结果	等待动作，或在自由活动时前往其他区域
`idle`	近期没有新活动	休息、喝咖啡等

动作会随状态和自由活动设置变化。办公室还支持画面缩放、平移和主题切换；会议厅里的老板 NPC 则让整个场景更有生活感。

点开员工，继续原来的任务

聊天侧栏通过本机 codex exec resume 继续原会话，回复边生成边显示。输入框支持 Enter 发送、Shift + Enter 换行，也可以为会话选择后续消息使用的模型。

如果任务方向不对，可以中断当前轮次，已显示的回复会保留。中断不等于撤销：此前已经发生的文件修改或工具操作不会自动回滚。

“叫人来加班”：启动新任务，找回老任务

办公室暂时没有员工时，可以指定工作目录，直接创建新的 Codex 会话；也能搜索未归档的历史会话并继续执行。新建或恢复成功后，界面会刷新并选中对应员工。

二、快速开始：先用浏览器跑起来

浏览器模式需要 Python 3.11 或更高版本，后端使用 Python 标准库。状态监控还需要本机存在可读取的 Codex 会话数据；发送消息、启动任务和查询模型等功能则需要本机已安装并登录 Codex CLI。

1. 获取代码

可以从上面的发行页下载并解压源码包，也可以用 Git 获取当前主分支：

git clone https://gitee.com/qianmonai/codex_pixel_office.git
cd codex_pixel_office

GitHub 对应地址为 https://github.com/QianmoNai/codex-pixel-office.git。使用 GitHub 克隆时，默认目录名为 codex-pixel-office。下文命令均在实际源码目录中执行。

2. Windows 浏览器模式

双击 start-windows.cmd，或在 PowerShell 中运行：

.\start-windows.cmd

3. Linux 浏览器模式

./start.sh

启动后默认打开 http://127.0.0.1:8765。这是你自己电脑上的地址，需要本机服务正在运行。

如果办公室为空，可以先在同一环境中使用 Codex 创建一个任务，再回到页面查看；也可以扩大时间范围：

# Linux
./start.sh --active-minutes 120

# Windows PowerShell
.\start-windows.cmd --active-minutes 120

三、需要独立窗口时，再安装桌面模式

Windows 10 / 11

桌面模式需要 Python 3.11+、.NET Framework 4.6.2+、Microsoft Edge WebView2 Runtime，以及 requirements-windows.txt 中的 pywebview 依赖。

推荐双击 install-windows.cmd。安装脚本会选择可用的 Python、检查 WebView2、安装依赖并创建开始菜单快捷方式。WebView2 缺失时，先从微软官方页面安装 Runtime。

也可以只安装依赖，再直接启动：

py -3 -m pip install -r requirements-windows.txt
.\run-windows.cmd

常用参数：

.\run-windows.cmd --fullscreen
.\run-windows.cmd --active-minutes 60
.\run-windows.cmd --codex-home "$env:USERPROFILE\.codex"

对应的 .ps1 脚本也可使用；若受到 PowerShell 执行策略限制，优先使用仓库提供的 .cmd 入口。卸载开始菜单快捷方式使用 uninstall-windows.cmd。

Linux 桌面模式

先通过所在发行版的软件包管理器准备 PyGObject、GTK4 和 WebKitGTK 6，再执行：

./run-desktop.sh

# 可选：全屏运行
./run-desktop.sh --fullscreen

# 可选：添加到当前用户的应用菜单
./install-desktop.sh

依赖包名因发行版而异；如果暂时不想配置 GTK 环境，可继续使用浏览器模式。移除菜单入口使用 ./uninstall-desktop.sh。

两端的菜单安装器都不会复制整个项目。快捷方式引用当前源码目录，安装后不要随意移动或删除它；移动后需要重新安装菜单入口。

四、它怎样知道 Codex 在做什么

项目主要读取 Codex 数据目录中的 state_5.sqlite 和 rollout JSONL 事件文件。默认数据目录是 Linux / WSL 下的 ~/.codex，或 Windows 下的 %USERPROFILE%\.codex。

本机 Codex 会话
  ↓ 元数据与事件记录
SQLite 数据库 + rollout JSONL
  ↓ 只读读取、状态整理
Python 本地服务
  ↓ 本地 HTTP API
像素办公室界面

Python 后端以只读方式打开状态数据库，并读取事件文件末尾的一部分内容。前端再把整理后的活动映射为状态、气泡和角色动作。用户主动发送消息时，程序调用 Codex CLI 创建或继续会话。

这些内部数据格式不是稳定的公共接口。Codex 更新后，如果数据库结构或事件格式变化，项目可能需要适配；状态也存在轮询间隔，不是逐毫秒的进程监控。

五、本地优先，以及它的边界

默认只监听 127.0.0.1，状态数据库使用只读连接。
聊天和模型等敏感接口限制为本机回环客户端。
活动摘要过滤隐藏推理、完整命令和工具参数；你主动输入的消息与助手回复仍会显示在聊天区。
对消息、输出、并发和执行时间设置限制，沿用 Codex 的权限及沙箱配置。

“本地优先”不等于模型完全离线。主动发送消息或启动任务后，Codex 仍可能访问你配置的模型服务和工具，产生相应的网络请求与费用。录屏或分享截图前，也应检查会话标题、工作目录和聊天内容中是否有不适合公开的信息。

这不是一个带多用户权限管理的远程控制台，不建议直接暴露到公网。将监听地址改为 0.0.0.0 会扩大状态页面的可访问范围。

六、常见问题

办公室没有员工

先确认当前环境中确实有 Codex 会话，数据目录包含 state_5.sqlite，且会话未归档并处于显示时间范围内。尝试 --active-minutes 120，或使用 --codex-home 指向实际的数据目录。

能看到员工，但无法聊天

在启动办公室的同一环境里检查 codex --version，并确认 Codex 已完成登录。检查模型是否可用、工作目录是否存在，以及该会话是否已有一轮任务正在执行。

Windows 与 WSL 显示的会话不一样

两者默认读取不同的数据目录。建议在产生会话的同一环境中运行办公室，不要直接混用另一环境的 rollout 文件路径。

端口 8765 被占用

# Linux
CODEX_PIXEL_PORT=9000 ./start.sh

# Windows PowerShell
$env:CODEX_PIXEL_PORT = "9000"
.\start-windows.cmd

随后访问 http://127.0.0.1:9000。

下载后为什么没有 EXE 安装包

v1.2.2 提供的是源码发行包。Windows 的 .cmd 是启动或安装辅助入口，仍依赖本机 Python；浏览器模式可以省去桌面 WebView 相关依赖。

七、v1.2.2 更新与开源说明

本次发布包含“叫人来加班”、聊天中断控制，以及会话轮询和聊天超时处理优化。发布检查中还修复了 Windows 批处理命令转义、PowerShell 5.1 路径处理和前端 JavaScript MIME 类型兼容问题。

发布流程已通过 Linux、Windows 下 Python 3.11 / 3.13 的自动化检查，包括 Windows 启动脚本和开始菜单安装、卸载检查。自动化检查不等于覆盖所有系统环境，遇到问题时请附上系统版本、Python 版本和复现步骤。

当前仓库采用 GPL-3.0-only 开源许可，完整条款见仓库 LICENSE。Codex Pixel Office 是独立的第三方项目，与 OpenAI 没有官方隶属或背书关系。

如果你经常同时运行多个 Codex 任务，可以先从浏览器模式试起：创建一个真实会话，看它入驻工位，再点开员工继续任务。原本散落在终端里的协作过程，就有了一个更直观的入口。

前往 Gitee 下载 v1.2.2 · GitHub 下载