开发概述
本指南提供了 OpenHands 仓库中可用的关键文档资源概述。无论您是想要贡献代码、了解架构还是处理特定组件,这些资源都将帮助您有效地浏览代码库。
核心文档
项目基础
-
主项目概述 (
/README.md
) 了解 OpenHands 的主要入口点,包括功能和基本设置说明。 -
开发指南 (
/Development.md
) 为 OpenHands 开发人员提供的综合指南,包括设置、要求和开发工作流程。 -
贡献指南 (
/CONTRIBUTING.md
) 为贡献者提供的基本信息,涵盖代码风格、PR 流程和贡献工作流程。
组件文档
前端
- 前端应用程序 (
/frontend/README.md
) 设置和开发基于 React 的前端应用程序的完整指南。
后端
-
后端实现 (
/openhands/README.md
) Python 后端实现和架构的详细文档。 -
服务器文档 (
/openhands/server/README.md
) 服务器实现细节、API 文档和服务架构。 -
运行时环境 (
/openhands/runtime/README.md
) 涵盖运行时环境、执行模型和运行时配置的文档。
基础设施
- 容器文档 (
/containers/README.md
) 关于 Docker 容器、部署策略和容器管理的综合信息。
测试和评估
-
单元测试指南 (
/tests/unit/README.md
) 编写、运行和维护单元测试的说明。 -
评估框架 (
/evaluation/README.md
) 评估框架、基准测试和性能测试的文档。
高级功能
- 微代理架构 (
/microagents/README.md
) 关于微代理架构、实现和使用的详细信息。
文档标准
- 文档风格指南 (
/docs/DOC_STYLE_GUIDE.md
) 编写和维护项目文档的标准和指南。
开发入门
如果您是 OpenHands 开发的新手,我们建议按照以下顺序进行:
- 从主
README.md
开始,了解项目的目的和功能 - 如果您计划贡献,请查看
CONTRIBUTING.md
指南 - 按照
Development.md
中的设置说明进行操作 - 根据您的兴趣领域深入研究特定组件文档:
- 前端开发人员应关注
/frontend/README.md
- 后端开发人员应从
/openhands/README.md
开始 - 基础设施工作应从
/containers/README.md
开始
- 前端开发人员应关注
文档更新
在对代码库进行更改时,请确保:
- 更新相关文档以反映您的更改
- 在适当的 README 文件中记录新功能
- 任何 API 更改都反映在服务器文档中
- 文档遵循
/docs/DOC_STYLE_GUIDE.md
中的风格指南