OpenHands — 开源 AI 软件工程师¶

# === 方法一：CLI 安装（最简单） ===
# 安装 openhands
pip install openhands  # 安装 OpenHands 命令行工具

# 配置 API Key
export ANTHROPIC_API_KEY="sk-ant-你的密钥"  # 设置 Claude API Key

# 直接使用
openhands "给这个项目加上单元测试"  # 用自然语言下达任务

# === 方法二：Docker 本地 GUI ===
# 拉取并运行 OpenHands
docker pull docker.all-hands.dev/all-hands-ai/runtime:0.30-nikolaik  # 拉取运行时镜像

docker run -it --rm \
  --pull=always \
  -e SANDBOX_RUNTIME_CONTAINER_IMAGE=docker.all-hands.dev/all-hands-ai/runtime:0.30-nikolaik \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/.openhands:/home/openhands/.openhands \
  -p 3000:3000 \
  --add-host host.docker.internal:host-gateway \
  docker.all-hands.dev/all-hands-ai/openhands:0.30  # 启动 OpenHands 服务

# 打开浏览器访问 http://localhost:3000

# === 方法三：Cloud 版（免费试用） ===
# 访问 https://www.openhands.dev
# 用 GitHub 账号登录
# 免费使用 Minimax 模型

在 GUI 中：
1. 点击设置图标
2. 选择 LLM Provider：
   - Anthropic（推荐 Claude Sonnet 4）
   - OpenAI（GPT-4o）
   - 其他 OpenAI 兼容 API
3. 输入 API Key
4. 保存设置

CodeAct 是 OpenHands 的核心代理，它的工作方式：

1. 接收任务 — 你用自然语言描述要做什么
2. 制定计划 — AI 分析需求，规划执行步骤
3. 执行代码 — 在 Docker 沙盒中运行真实命令
4. 观察结果 — 查看命令输出、测试结果
5. 迭代修复 — 如果有错误，自动修改代码并重试
6. 完成交付 — 直到任务完成或需要人工介入

白话比喻：就像一个新人程序员，你给他任务，
他会自己试着做，做错了就改，直到做对为止

# 示例1：修复 GitHub Issue
在 GUI 或 CLI 中输入：
"修复 issue #42：用户登录时如果密码包含特殊字符会报错"

OpenHands 会：
1. 读取 issue 描述
2. 分析代码库找到相关代码
3. 编写修复代码
4. 运行测试验证修复
5. 生成 Git 提交

# 示例2：创建新功能
"给这个 Flask 应用加一个文件上传功能，支持 PDF 和图片"

OpenHands 会：
1. 分析项目结构
2. 创建上传路由
3. 添加文件验证逻辑
4. 更新前端页面
5. 写测试
6. 全部在 Docker 沙盒中运行和测试

# 用 Python SDK 编程控制 OpenHands
from openhands import Agent  # 导入 Agent 类

# 创建代理实例
agent = Agent(
    model="anthropic/claude-sonnet-4-20250514",  # 指定模型
    api_key="sk-ant-你的密钥"  # API Key
)

# 在代码中运行代理
result = agent.run(
    task="给 utils.py 中的所有函数加上 type hints",  # 任务描述
    workspace="/path/to/project"  # 项目路径
)

print(result.status)  # 查看执行状态
print(result.changes)  # 查看修改了哪些文件

# .github/workflows/openhands-autofix.yml
# 当 GitHub Issue 被标记为 "autofix" 时，自动让 AI 修复

name: OpenHands Auto Fix
on:
  issues:
    types: [labeled]

jobs:
  fix:
    if: github.event.label.name == 'autofix'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4  # 检出代码
      - name: Run OpenHands
        run: |
          pip install openhands  # 安装 OpenHands
          openhands --issue ${{ github.event.issue.number }}  # 让 AI 修复这个 Issue
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

# 使用 SDK 同时运行多个代理
from openhands import Agent  # 导入 Agent

# 代理1：修复 Bug
bug_agent = Agent(model="claude-sonnet-4")  # 创建修 Bug 的代理
bug_agent.run("修复登录模块的空指针异常")  # 运行任务

# 代理2：写测试（同时进行）
test_agent = Agent(model="claude-sonnet-4")  # 创建写测试的代理
test_agent.run("给用户管理模块写集成测试")  # 运行任务

# 可以扩展到上千个代理并行工作