开发

开发环境概述

OpenHands 提供了一个全面的开发环境，支持本地开发和容器化工作流。开发过程通过集中的 Makefile 进行协调，该 Makefile 协调依赖管理、环境设置和各种开发任务。

开发工作流架构

开发环境支持多种平台（macOS、Linux、WSL），具有自动平台检测和特定于平台的配置。系统需要 Python 3.12、Node.js 22+、用于 Python 依赖管理的 Poetry，以及用于容器化开发的 Docker（可选）。

来源： Makefile1-336 Makefile46-61 Makefile63-136

构建系统架构

构建系统以 Make 目标为中心，协调 Poetry (Python)、npm (Node.js) 和 Docker 构建过程。该系统支持本地开发构建和生产 Docker 镜像构建。

构建系统组件

构建脚本 containers/build.sh 支持多种构建模式，包括用于注册表发布的 --push、用于本地 Docker 镜像的 --load，以及用于在不构建的情况下生成配置的 --dry。它自动处理特定于平台的构建（linux/amd64、linux/arm64），并根据 Git refs 和环境变量生成相应的标签。

来源： Makefile24-31 containers/build.sh1-183 containers/app/Dockerfile1-99 .github/workflows/ghcr-build.yml55-103

代码质量与 Linting 基础设施

OpenHands 通过使用 pre-commit 钩子、用于前端代码的 ESLint 以及用于 Python 代码的 Ruff/mypy 的多层方法来强制执行代码质量。Linting 系统集成到本地开发和 CI/CD 管道中。

代码质量管道

前端使用支持 TypeScript 的 ESLint、Airbnb 配置和 Prettier 集成。配置包括针对未使用导入、导入扩展和特定于 React 的模式的规则。Python 代码质量通过 Ruff（用于 linting 和格式化）、mypy（用于类型检查）以及用于 YAML 验证和尾部空格的其他钩子来强制执行。

来源： dev_config/python/.pre-commit-config.yaml1-45 frontend/.eslintrc1-76 frontend/.husky/pre-commit1-12 .github/workflows/lint.yml1-70 .github/workflows/lint-fix.yml1-92