官方網站
Git 儲存庫產品說明
OpenHands (曾用名 OpenDevin，即你所指的 LocalHands 核心專案) 是一款強大的開源 AI 代理人（AI Agent），旨在打造一個能夠自主執行任務的「數位軟體工程師」。它不僅能像 ChatGPT 一樣回答問題，還能直接操作終端機、編輯檔案、執行腳本以及瀏覽網頁來解決複雜的程式問題。
與傳統的 AI 聊天機器人不同，OpenHands 運行在一個安全的沙盒環境（Docker）中。當你給它一個指令（例如：「幫我寫一個爬蟲並測試它」），它會自主規劃步驟：建立檔案、撰寫代碼、運行測試，並根據錯誤訊息自我修復。它是開發者提升生產力、實現開發流程自動化的終極利器。
核心特色：
- 自主執行力：具備讀寫檔案、運行 Shell 指令與瀏覽網頁的能力。
- 多模型支援：可串接 OpenAI (GPT-4o)、Anthropic (Claude 3.5 Sonnet) 或本地端的 Ollama (Llama 3)。
- 沙盒安全機制：所有代碼執行均在隔離的 Docker 容器中進行，保護主機系統安全。
- 即時協作介面：提供直觀的 Web UI，讓使用者可以隨時監看 AI 的思考過程與執行進度。
- 事件驅動架構：支援複雜的任務規劃與長期記憶，能處理多步驟的工程任務。
常用操作與配置
OpenHands 主要透過 Web 介面操作，但其配置與啟動通常涉及以下核心概念：
環境準備與啟動
由於 OpenHands 需要執行代碼，最推薦的啟動方式是透過 Docker：
# 使用 Docker 啟動 OpenHands (範例指令)
docker run -it
-e SANDBOX_USER_ID=$UID
-v /var/run/docker.sock:/var/run/docker.sock
-p 3000:3000
--name openhands-app
ghcr.io/all-hands-ai/openhands:0.21
| 功能模組 | 功能說明 | 使用情境 |
|---|---|---|
| Workspace (工作區) | 指定 AI 操作的實體目錄 | 將現有專案目錄掛載給 AI 進行修改 |
| Terminal (終端機) | AI 自主執行的命令列介面 | 安裝套件、編譯程式或啟動開發伺服器 |
| File Browser | 即時呈現 AI 建立或修改的檔案 | 檢查 AI 撰寫的代碼品質與結構 |
| Browser (瀏覽器) | AI 模擬真人上網行為 | 查詢最新文件、測試網頁前端渲染結果 |
| Agent Planner | 展示 AI 目前的任務目標與子步驟 | 了解 AI 的邏輯思維，並在必要時介入修正 |
進階技巧：結合本地模型 (Ollama)
如果你極度重視隱私或不想支付 API 費用，可以將 OpenHands 與 Ollama 結合，實現 100% 的本地化 AI 開發環境：
- 在本地啟動 Ollama 並下載模型：
ollama run llama3。 - 在 OpenHands 的設定介面（Settings）中，將
LLM Provider選項改為Ollama。 - 設定 API URL 為本地位址（通常為
http://localhost:11434）。 - 即可在不連網的情況下，讓 AI 幫你重構代碼。
注意事項
- Docker 需求：執行 OpenHands 必須安裝 Docker，因為它是 AI 運行代碼的隔離溫床。
- 權杖管理：若使用 GPT 或 Claude，請確保已在設定中正確配置 API Key。
- 持續監控：雖然 AI 具備自主性，但在處理生產環境代碼時，建議在 Web UI 中全程觀察其行為。
操作介面
