產品說明

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 中全程觀察其行為。

OpenHands

產品說明

常用操作與配置

環境準備與啟動

進階技巧：結合本地模型 (Ollama)

注意事項

操作介面