AI Agent 正在运行，但屏幕上只有一行“处理中”。它在查资料、执行命令，还是等待工具返回？如果能把这些过程变成一个实时大屏，会是什么样？

这篇文章分享一次动手尝试：在开源项目 Agent Display 战术大屏的基础上，接入 Codex 已记录的执行事件，让两个主题展示真实任务状态。

先说清楚：大屏里的炫酷动画是视觉呈现。真实内容来自可读取到的执行记录；它无法展示模型内部的思考过程，也无法凭空补齐没有记录的信息。

一、为什么想给 Agent 做一个“工作大屏”？

使用 Agent 时，最终答案只是结果。遇到任务耗时长、工具调用失败、步骤反复重试等情况，我们常常更想知道：过程进行到了哪里？

例如，一次任务可能包含读取文件、搜索、执行命令和验证。把这些操作按时间整理出来，可以帮助我们：

• 快速找到最近一次工具调用和返回状态。
• 排查失败或等待时间较长的步骤。
• 对照执行记录复盘任务，而不是只看最终回答。

这不是给模型增加一层“大脑”，而是给已有的记录做一个更直观的观察界面。

二、先看效果：两套主题，两种表达

1. 视界熔炉 FORGE

「视界熔炉」以星核、机械结构和流线呈现任务过程。接入真实数据后，页面中的部分工作项、执行记录和状态可以对应到选定的 Codex 对话。

2. 天工开物 WORKS

「天工开物」用机械与光丝织造的方式呈现工作进程。它与视界熔炉共用同一条只读数据连接，但采用不同的视觉表达。

上游原版包含十套主题和模拟任务；当前适配版本的 06 / 07 接入真实记录，其余八套保留原版演示。主题切换后看到的内容，取决于该主题是否完成适配。

三、动画很酷，哪些数据是真的？

最容易产生误解的是：画面上看见很多光束和角色，就以为后台一定有很多 Agent 同时干活。实际上，视觉元素与运行事件需要分开看。

页面内容	如何理解
工具调用、返回、失败	来自所选对话中能够识别的执行记录
代码、命令或文件修改片段	展示记录里已有的片段，具体内容取决于日志是否提供
Token 与缓存信息	日志有对应字段时展示；缺失时不能当作 0 或虚构
光束、模型旋转、织造效果	根据状态设计的视觉映射，不代表模型内部神经活动
子智能体	只有记录中存在可识别事件时才能确认；工具类别不等于智能体

还有一个有趣的现象：**光流暂时没有明显变化，不等于 Agent 在“摸鱼”。**两个工具事件之间，模型可能正在处理上下文，也可能正在等待外部工具；如果记录没有提供更细状态，看板只能显示已知信息，不能推断内部细节。

四、实现思路：给现有记录接一块只读屏幕

这次改造的思路可以画成一条链路：

选定一个 Codex 对话的本地执行记录
               ↓
       只读采集与事件整理
               ↓
       本机服务提供状态数据
               ↓
   FORGE / WORKS 主题映射
               ↓
    浏览器绘制动画与任务面板

这里有三个设计选择：

1. **明确选择一条记录。**配置时指定目标对话的执行记录，不把不同聊天的事件混在一起。
2. **观察与执行分开。**采集器读取已有记录，不向原任务发指令，也不修改原任务流程。
3. **未知就是未知。**没有采集到的角色、进度或用量不补造；时间先后也不自动等于真实因果关系。

画面本身由浏览器渲染，电脑会消耗 CPU、内存和图形资源；查看已有记录不需要额外调用模型，因此这部分不会额外产生模型 Token。Codex 原任务的模型用量仍按原有规则计算。

五、想试试？Windows 快速开始

仓库提供的是可以自行查看和修改的代码。准备 Python 3.10 或更新版本，以及支持 WebGL 的现代浏览器；服务端只使用 Python 标准库。原版页面的部分字体和 Three.js 资源来自 CDN，首次加载需要网络。

下载并解压项目后，在项目目录运行：

py -3 configure.py

按提示指定要观察的那个对话对应的执行记录和看板名称。确认路径属于目标聊天后，再启动：

.\start.cmd

进入页面后可以切换到「视界熔炉」或「天工开物」。结束时，在启动服务的终端按 Ctrl+C，或使用页面上的关闭看板功能；再关闭网页可结束页面的动画渲染。

使用前建议先了解两个边界：一是程序只读取部分历史，长对话不一定能完整还原；二是日志可能包含代码和业务信息，分享截图前需要检查内容。配置文件与聊天记录也不应上传到公开仓库。

六、真实数据接入后，为什么有时没演示那么“热闹”？

原版演示使用预先编排的模拟任务，可以持续展示多角色协作；真实任务可能只有一个智能体，或者一段时间内没有新的工具事件。页面的丰富程度自然会受记录数量和种类影响。

我更希望它在“好看”的同时保持诚实：**有事件就展示事件，没有证据就不要编造。**后续可以在这个基础上继续完善不同主题的映射与交互。

项目地址与来源

• 本次适配仓库：Agent Display Codex：视界熔炉与天工开物真实数据接入
• 上游原项目：Agent Display 战术大屏，视觉设计、主题和原版动画由原作者创作。
• 关于 Trace 与 Span 的概念，可参考 OpenTelemetry 官方文档。本项目以现有执行记录为数据来源，不等同于完整的 OpenTelemetry 链路追踪系统。

上游采用 PolyForm Noncommercial License 1.0.0，使用及再分发时请查看仓库中的许可和署名说明；商业使用需另行确认授权。