jefferysha0627/agent-office-3d

选用指南

AI 根据 README 整理 · 2026/10/30 02:51:46

使用方式

通过命令行启动，使用npm start运行演示模式，或通过npm run demo:minecraft启动Minecraft演示。

查看 README 依据

## 用 AI Agent 安裝 下載這個 repo 後，在資料夾裡打開你的 AI Coding Agent（Claude Code、Codex、Cursor…），直接貼上這句話： ```text 請讀這個 repo 的 AGENTS.md，幫我把 Agent Office 裝好並打開麥塊示範。 ``` Agent 會照 [AGENTS.md](AGENTS.md) 先跑 `npm run doctor` 檢查環境，再幫你安裝、啟動示範，並詢問要不要接 Herdr、怎麼客製公司名稱和員工。安裝 Node.js、Java 這類系統軟體前，它會先問你；Minecraft EULA 一定要你自己輸入 `yes`，Agent 不會代為同意。Claude Code 使用者也可以直接輸入 `/setup-office`。 ## 快速看麥塊 不用接自己的 Agent，兩個指令就能看到示範員工偷玩 Minecraft（需要 Node.js 20 以上、Java 21 以上）： ```bash npm ci npm run demo:minecraft ```

支援平台：macOS、Linux。**Windows 為實驗性支援**：CI 會在 Windows 上跑安裝、語法檢查與示範模式測試，但作者沒有 Windows 實機驗證過，Minecraft 在 Windows 上也還沒實測。 ## 安裝與啟動 ### macOS／Linux ```bash git clone https://github.com/jefferysha0627/agent-office-3d.git agent-office-3d cd agent-office-3d npm ci npm start ``` ### Windows（PowerShell） ```powershell git clone https://github.com/jefferysha0627/agent-office-3d.git agent-office-3d cd agent-office-3d npm ci npm start ``` 啟動後會自動打開 http://127.0.0.1:4870/ 。預設是**示範模式**：不需要任何 Agent，員工狀態會自動輪播，讓你先看到效果。按 `Ctrl+C` 停止。 ## 設定

部署要求

需要Node.js 20以上；可选Java 21以上和Minecraft Java版服务器用于Minecraft功能。支持macOS和Linux，Windows为实验性支持。

查看 README 依据

- **閒置時的小動作**：倒咖啡、喝水、跑步機、伸懶腰、打瞌睡、偷玩內建小遊戲；有開 Minecraft 的話，螢幕上是他自己的 Minecraft 機器人第一人稱畫面。 - **布告欄**：年度目標、KPI、本週重點、現金流、待辦清單。點布告欄會飛過去打開全螢幕介面，待辦可以直接勾選。 - **書架＝專案資料庫**：每本書是一個專案資料夾，點了可以看裡面的 Markdown 文件和截圖（只讀）。 - **任務清單**：右側列出任務資料夾裡的檔案，點了看全文。 - **一隻貓**：在走道散步、趴睡、跳上空桌。 | 布告欄 | 書架專案介面 | |---|---| |  |  | ## 需求 - **Node.js 20 以上**（必要） - **Java 21 以上＋ Minecraft Java 版伺服器**（選用，只有想讓員工玩 Minecraft 才需要） - 一個支援 WebGL 的瀏覽器（Chrome、Edge、Safari、Firefox）

支援平台：macOS、Linux。**Windows 為實驗性支援**：CI 會在 Windows 上跑安裝、語法檢查與示範模式測試，但作者沒有 Windows 實機驗證過，Minecraft 在 Windows 上也還沒實測。 ## 安裝與啟動 ### macOS／Linux ```bash git clone https://github.com/jefferysha0627/agent-office-3d.git agent-office-3d cd agent-office-3d npm ci npm start ``` ### Windows（PowerShell） ```powershell git clone https://github.com/jefferysha0627/agent-office-3d.git agent-office-3d cd agent-office-3d npm ci npm start ``` 啟動後會自動打開 http://127.0.0.1:4870/ 。預設是**示範模式**：不需要任何 Agent，員工狀態會自動輪播，讓你先看到效果。按 `Ctrl+C` 停止。 ## 設定

已知限制

Windows支持为实验性，未在真实硬件上测试；Minecraft服务器仅绑定127.0.0.1，不能对外开放。

查看 README 依据

支援平台：macOS、Linux。**Windows 為實驗性支援**：CI 會在 Windows 上跑安裝、語法檢查與示範模式測試，但作者沒有 Windows 實機驗證過，Minecraft 在 Windows 上也還沒實測。 ## 安裝與啟動 ### macOS／Linux ```bash git clone https://github.com/jefferysha0627/agent-office-3d.git agent-office-3d cd agent-office-3d npm ci npm start ``` ### Windows（PowerShell） ```powershell git clone https://github.com/jefferysha0627/agent-office-3d.git agent-office-3d cd agent-office-3d npm ci npm start ``` 啟動後會自動打開 http://127.0.0.1:4870/ 。預設是**示範模式**：不需要任何 Agent，員工狀態會自動輪播，讓你先看到效果。按 `Ctrl+C` 停止。 ## 設定

3. 進來後會自動變成**觀察者模式**：可以飛、穿牆，不會碰到世界。按數字鍵 `1`（或滑鼠中鍵打開觀察者選單）選員工，就能跳到他身上看。 4. 想拍影片時，可以加上 `DEMO_ALL_IDLE=1`（只在示範模式有效），讓所有示範員工一直閒置、持續在 Minecraft 裡活動。 設定的名稱會跟機器人一起放進白名單，不在名單上的人連不進來。 > 提醒：這個伺服器是離線模式（機器人不需要正版帳號），而且只綁 `127.0.0.1`，只能在這台電腦上使用。不要改綁定位址或開放對外連線。 - 這個 repo 不包含任何 Mojang 的檔案；伺服器 jar、EULA、世界存檔都在本機的 `minecraft/`，不進版控。 - 在 `npm start` 的終端機輸入文字會轉給 Minecraft 主控台（例如 `time set day`、`list`）。 - 關閉時會先讓機器人離線，再請伺服器存檔關閉。 ## 常見問題 **玩 Minecraft 會耗 Token 嗎？** 不會。Minecraft 裡的員工是照規則跑的 Mineflayer 機器人（找樹、挖礦、蓋東西），不會呼叫任何 AI 模型。只有你的 Agent 真的在工作時才會用到 Token，而且那跟這個辦公室無關。 **辦公室會替我的 Agent 下指令嗎？**