5.4 KiB
LazyBoy 讓 Agent 在 Docker 裡使用自己的 Linux 桌面，操作瀏覽器、終端與檔案。你可以建立不同的 Agent、在群組中協作，把示範整理成技能，再安排定時執行。
目前為早期版本 0.1.0，提供桌面與手機瀏覽器介面；模型金鑰由你自行設定。
功能
- 持續的工作空間：每個 Agent 有自己的對話、工作紀錄與可設定的長期記憶。
- 真的能操作電腦：開網頁、使用終端、整理檔案、操作圖形介面，過程可即時觀看。
- 隨時人工接管：在同一個桌面完成登入、驗證或手動調整，再交回 Agent。
- 多 Agent 與群組：支援 Team 共用電腦與 Private 獨立電腦模式。
- 示範教學與排程：把操作示範整理成技能，使用 cron 安排重複工作。
- 自選模型與工具：支援 xAI、OpenCode Go、OpenAI 相容端點，以及 MCP 與檔案技能。
- 語音通話：設定語音服務後，可以透過通話與 Agent 互動。
- 手機操作：可收合聊天側欄，遠端桌面提供鍵盤、觸控板、右鍵、拖曳與捲動控制。
- 英文與繁體中文：可在介面切換語言。
快速開始
需要 Docker 與 Compose、Git、Make、Python 3，以及一組支援的模型 API 金鑰。macOS 可使用 Docker Desktop 或 OrbStack；Linux 可使用 Docker Engine。
取得本專案原始碼後，在專案根目錄執行：
make env
編輯產生的 .env，填入 XAI_API_KEY、OPENCODE_GO_API_KEY 或 OPENAI_API_KEY 其中之一。初始化工具會產生登入與服務所需的金鑰，重新執行時保留既有設定。
make up
make health
開啟 http://127.0.0.1:3101，用 .env 裡的 LAZYBOY_APP_TOKEN 登入，建立 Agent 並選擇模型。
第一次會從原始碼建置 API 與 Linux 桌面映像，所需時間較長。容器內已包含建置環境，完整 Docker 部署不需要在主機安裝 Rust 或 Node.js。
可以先試一個具體任務：
開啟我指定的網站，整理頁面重點，將結果存成工作區裡的 Markdown 檔案。
服務狀態與日誌：
make ps
make logs
make down # 停止服務，保留 PostgreSQL 資料
資源限制、環境變數、HTTPS 與容器內 sudo 設定，請見 部署與操作。
在手機上使用
手機與桌面使用同一個 Web 介面。將服務部署在可連線的主機後，用手機瀏覽器開啟該服務的網址即可；127.0.0.1 只代表手機本身，不能拿來連另一台電腦。
聊天側欄可點外側空白處收合。操作遠端桌面時，可切換直接點選與觸控板模式，使用工具列叫出鍵盤、按右鍵或拖曳。對外提供服務時請設定 HTTPS，詳見 部署指南。
技術組成
- 前端：React 19、TypeScript、Vite、noVNC
- 後端：Rust 2024、Axum、Tokio
- 資料：PostgreSQL、pgvector、SQLx
- 桌面：Docker、Debian、XFCE、Chromium、Xvfb
- 電腦控制：CDP、AT-SPI、X11
- 擴充：MCP、檔案技能、示範 playbook
流程圖、控制權交接、元件職責與電腦生命週期狀態機，集中在 架構與流程。原有的 互動流程圖 也保留；下載後用瀏覽器開啟即可操作。
本機開發
除了 Docker，需安裝支援 Rust 2024 edition 的 Rust 工具鏈，以及 Node.js／npm。
make dev
make dev-supervisor # 終端 1
make dev-api # 終端 2
前端熱更新使用另一個終端：
cd apps/web
npm install
npm run dev
開啟 http://127.0.0.1:5173。測試指令與專案目錄說明請見 開發指南。
文件
| 文件 | 內容 |
|---|---|
| 架構與流程 | 任務流程圖、系統架構、電腦生命週期狀態機 |
| 互動流程圖 | 可縮放、搜尋的 HTML 圖表；下載後開啟 |
| 部署與操作 | 資源、環境變數、安全設定、網站驗證、sudo |
| 開發指南 | 本機開發、檢查與測試、目錄結構 |
| 設定範例 | 環境變數與預設值 |
資料
對話、記憶、瀏覽器設定檔與加密憑證保存在自架主機。使用外部模型時，任務所需的提示詞、工具結果與截圖仍可能傳送給該模型供應商。
