jefferysha0627/agent-office-3d

Agent Office 3D 是一间在本机运行的低多边形 3D 办公室，把 AI 编程 Agent 的状态可视化：工作中、闲置、完成待命或卡在权限确认。它适合在 macOS 或 Linux 上同时运行多个编程 Agent、想一眼看清整体状态而不必逐个翻终端的人。启动后通过浏览器访问本地地址查看 3D 办公室，需要浏览器支持 WebGL（README）。

它展示什么

每位配置的员工有一张桌子，配状态灯和名牌；需要确认时名牌变红并冒出「!」气泡。点击员工可以查看最近的终端输出，这只是只读视图，办公室不能代你输入指令或按下确认。闲置员工会去倒咖啡、上跑步机或打瞌睡；房间里还有可勾选待办的布告栏、读取指定项目文件夹的书架，以及任务清单侧栏（功能说明）。

默认的示範模式完全不需要接 Agent：假状态会自动轮播，方便先看效果。README 也注明截图中的员工、任务、项目和金額都是虚构的。

接入真实 Agent

状态来自 source adapter。内置选项是 Herdr，一个给编程 Agent 用的终端多工工具：把 source.type 设为 herdr，并让每个 staff[].id 与 herdr agent list 里的名称一致（Herdr 模式、Herdr）。办公室只通过白名单调用 Herdr 的只读 list 和 read 指令。接入其他工具需要在 lib/sources.js 编写 adapter，返回同样的名称、状态和终端末尾内容。最多 8 位员工会获得固定座位，其余 Agent 使用剩余座位。

Minecraft 机制

闲置员工可以由规则驱动的 Mineflayer 机器人代表，在同一世界里挖矿、砍树和盖房子；每个机器人的第一人称画面会串流到该员工的桌上屏幕（Minecraft 章节、Mineflayer）。README 明确说这些机器人不调用任何 AI 模型，所以这段闲置活动不消耗 token。机器人只在员工闲置且有人开着办公室画面时才移动，员工恢复工作就停下。启用 Minecraft 后，玩游戏的选项一律是 Minecraft；真实 Agent 约有 12% 的机率选择它，示範模式则会让闲置员工更常去玩。

这条选配路径需要 Java 21 以上。安装流程会从 Mojang 官方下载 1.21.4 服务器 jar 并验证 SHA-1。你必须自己读完并输入 yes 接受 Minecraft EULA；不接受就不会下载任何东西（Minecraft EULA）。服务器只绑定 127.0.0.1 并启用白名单。若你拥有 Minecraft Java 版，可以在同一台电脑以 localhost:25570 以观察者模式进入，前提是你的玩家名称已加入 guest 名单。

需求与限制

• 必须安装 Node.js 20 以上；Java 21 以上与 Minecraft Java 服务器是选配，只用于游戏功能。3D 画面需要支持 WebGL 的浏览器（需求说明）。
• 支持 macOS 和 Linux。Windows 标为实验性支持：CI 会跑安装、语法检查和示範模式冒烟测试，但作者没有在真实 Windows 机器上验证过，Windows 上的 Minecraft 也尚未实测。
• 办公室会读取 Agent 的终端输出，其中可能包含程式码、路径或敏感内容。README 明确要求只在本机使用，不要通过公开的反向代理或通道对外暴露。
• 唯一的写入操作是在布告栏勾选待办，写入本地 JSON 文件。
• 仓库不包含任何 Mojang 文件；服务器 jar、EULA 和世界存档都留在本机未纳入版本控制的 minecraft/ 文件夹。项目采用 MIT 授权；README 指出 prismarine-viewer 内置的方块材质属于 Mojang，受 Minecraft 使用条款约束（授权）。

HotRepo 点评

2026-10-30，该项目以 104 颗总星数出现在 JavaScript 的新项目榜（仓库）。这只是一个有日期的单次观察，不足以证明持续成长或更广泛的采用。