Agent Office 3D：把编程 Agent 变成办公室员工

AI项目5小时前更新 onemo

5 0

Agent Office 3D 干的事很简单：把散在终端里的 Agent 状态，变成办公室里看得见的人。谁在干活、谁闲着、谁卡在等你确认，抬头看一眼就知道。它在本机运行，自带一整套示范数据，不接任何 Agent 也能先玩上十分钟。

它把终端里的状态搬进了办公室

低多边形风格的 3D 办公室，每个 Agent 一张桌子、一盏状态灯、一块名牌。需要你确认时，名牌会变红并挂上感叹号——这是整套界面里唯一的告警设计，也最不容易被忽略。

空闲员工不会站着发呆：倒咖啡、喝水、踩跑步机、伸懒腰、打瞌睡，还会玩内置小游戏。看着像装饰，实际是把「这个人现在闲置」变成一眼可辨的状态。

镜头之外的员工、任务、项目和金额都是示范数据，不是真实业务。界面上那张「示范模式（假状态）」的标签，作者自己标得很清楚。

六个能直接用的功能

实时状态、只读终端、公告板、书架、任务清单、Minecraft 休息区。前三样是日常会用的，后两样偏展示和消遣。

点员工可以看它最近的终端输出，但办公室不提供发送指令的入口。看和操作被刻意分开，这个取舍值得记下来。

公告板是全屏界面：年度目标、KPI、本周重点、现金流、待办清单。待办能直接勾选，这是整个办公室里唯一能写入的地方。

书架把每个项目文件夹做成一本「书」，点开是只读的 Markdown 与截图浏览。比起切窗口翻目录，这种方式更适合边看边想。

环境要求与平台现状

Node.js 20 以上是硬要求。Java 21 以上只在开启 Minecraft 时才需要，此外浏览器得支持 WebGL。

macOS 与 Linux 是主要支持平台。Windows 目前属于实验性支持：CI 会跑安装、语法检查和示范模式测试，但作者没在实体 Windows 环境验证过，Minecraft 部分同样没验。要在 Windows 上长期用，先做好踩坑的预期。

三条启动路径

最省事的是命令行：克隆仓库、装依赖、启动，浏览器打开 127.0.0.1:4870。默认进入 demo 模式，员工状态自动轮播，不需要先准备 Agent。

第二条是让 Agent 替你装。在项目文件夹里开 Claude Code、Codex 或 Cursor，贴一句「请读这个 repo 的 AGENTS.md，把 Agent Office 装好并打开麦块示范」，它会照着执行 npm run doctor、协助安装并询问配置。

第三条是看 Minecraft 演示：npm run demo:minecraft。首次运行会检查 Java、要求你读完 EULA，而且必须亲自输入 yes 才会写入 eula=true，输入其他内容会直接取消，也不会下载任何 Mojang 文件。这不是多余的步骤，是许可本身的要求。

配置文件里的关键字段

把 office.config.example.json 复制成 office.config.json 就能改。这个文件不进版本控制；文件不存在时，程序回落到示例配置。

常改的几项：port（默认 4870）、openBrowser、company.name、company.currency、company.logo、owner.name 与 owner.title、cat.name、staff[]、source.type。主管桌只是装饰，不接收 Agent 状态。

staff 最多 8 位，每人有 id、title、color。id 必须和状态来源里的 Agent 名称一致，对不上的人永远显示不出状态，这是最常见的配置错误。

source.type 只有 demo 与 herdr 两个值。接上 Herdr 之后，办公室只会调用 herdr agent list 和 herdr agent read 两条只读指令，内置白名单挡掉其余命令——它不会替你按键，也不会替你点权限确认。想接别的工具，在 lib/sources.js 写个 adapter，返回同格式的员工清单即可。