Полная архитектурная декомпозиция проекта OpenHands с детализированными Mermaid-диаграммами до уровня методов.
| # | Файл | Слой | Описание |
|---|---|---|---|
| 0 | 00-overview.md | Overview | Общая диаграмма слоёв, таблица модулей, основные потоки данных |
| 1 | 01-core.md | Core | Конфигурация (OpenHandsConfig 42 поля, LLMConfig 39 полей, AgentConfig, SandboxConfig, KubernetesConfig), схемы, сообщения, исключения |
| 2 | 02-llm.md | LLM | Провайдеры LLM (sync/async/streaming), роутинг, метрики, retry/debug, реестр моделей, tool names, fn_call_converter |
| 3 | 03-controller.md | Controller | AgentController, State машина, StuckDetector, ReplayManager, Budget/Iteration Control |
| 4 | 04-events.md | Events | 20+ типов Actions, 17+ типов Observations, EventStream, EventStore, EventFilter, сериализация, Action→Observation маппинг |
| 5 | 05-agenthub.md | AgentHub | CodeActAgent (10 tools), BrowsingAgent, LocAgent (3 tools), ReadOnlyAgent (3 tools) — параметры всех инструментов, маппинг на Actions |
| 6 | 06-runtime.md | Runtime | Docker/K8s/Local/Remote/CLI Runtime, BashSession, FileEditMixin, MCP Client/Proxy, Agent Skills, Plugins |
| 7 | 07-memory.md | Memory | ConversationMemory, 10 типов Condensers (NoOp, RecentEvents, LLMSummarizing, Pipeline и др.), View |
| 8 | 08-server.md | Server/API | V0: FastAPI + WebSocket. V1 App Server: DI-framework, SQL storage, Sandbox management (Docker/Process/Remote), Event callbacks, JWT, Alembic |
| 9 | 09-storage.md | Storage | FileStore (Local/InMemory/S3/GCS/WebHook), ConversationStore, Settings (28 полей), Secrets |
| 10 | 10-integrations.md | Integrations | GitHub, GitLab, Bitbucket, Azure DevOps, Forgejo — Git services, Issue/PR handlers, Resolver, Microagents |
| 11 | 11-security.md | Security | InvariantAnalyzer, GraySwanAnalyzer, LLMRiskAnalyzer, ConfirmationPolicy |
| 12 | 12-utils-extras.md | Utils & Extras | PromptManager, async utils, HTTP, chunks, Critic, Experiments, IO, Linter |
- 13 файлов документации
- 5300+ строк Markdown с Mermaid-диаграммами
- 181 поле конфигурации задокументировано
- 16 инструментов агентов с полными параметрами
- 12 архитектурных слоёв покрыты
Mermaid-диаграммы рендерятся автоматически на GitHub. Для локального просмотра можно использовать:
- VS Code с расширением Markdown Preview Mermaid Support
- Mermaid Live Editor
Анализ выполнен на основе исходного кода OpenHands (февраль 2026).
Документация распространяется под лицензией MIT.