模块架构
Monkeys 生态的逻辑模块、能力服务和基础设施依赖
本文档描述 Monkeys 生态的逻辑模块架构。它不是部署指南。
本地启动和部署相关说明请查看 LOCAL_DEVELOPMENT.md、AGENT_BOOTSTRAP.md，以及 docker/ 下的 compose 文件。
分层视图
核心产品
核心产品是 Monkeys 平台的最小产品面：
| 模块 | 仓库 | 职责 |
|---|---|---|
| Studio 前端 | monkeys-studio | 主要面向用户的 Studio 工作区。 |
| Kernel 前端 | monkeys-kernel | 平台和 kernel 管理前端。 |
| Compute 前端 | monkeys-compute | Compute 控制面前端。 |
| 主后端 | monkeys-server | 核心 API、工作流入口、路由、marketplace 和服务总线。 |
能力服务
能力服务扩展核心产品，只在需要对应功能区域时部署。
| 能力 | 仓库 | 关系 |
|---|---|---|
| Agent 运行时 | monkeys-agent-server、monkeys-mcp-server、monkey-tools-agentkits | 增加 Agent 运行时、MCP 访问和可复用 Agent 工具。 |
| 计费与用量 | monkeys-billing-server | 跟踪用量、定价、余额和账单记录。 |
| 数据工作流 | monkeys-data-server、monkeys-conductor-worker | 增加数据服务 API 和工作流任务执行。 |
| Webhook | monkeys-webhook-server | 处理外发通知和外部 webhook 通道。 |
| 第三方工具 | monkey-tools-third-party-api、monkey-tools-third-party-api-python、monkey-tools-sandbox、monkey-tools-agentkits | 增加外部 API 适配器、Python 工具、代码沙箱和 Agent 工具包。 |
| 图片与 ComfyUI 流程 | monkeys-comfyui-worker | 执行 ComfyUI / 图片生成队列。 |
| 训练流程 | monkeys-training-worker | 执行模型训练和模型测试后台任务。 |
基础设施依赖
基础设施是共享的，本地使用时位于 docker/infrastructure/。
| 基础设施 | 使用方 |
|---|---|
| PostgreSQL | 主后端、agent、billing、data、webhook、training worker、Conductor |
| Redis | 主后端、workers、队列、缓存、后台分发 |
| Elasticsearch | Conductor 索引和搜索相关流程 |
| Conductor | 工作流编排和任务分发 |
| MinIO | 本地文件和资产对象存储 |
| Prometheus / Grafana | 可选本地指标和仪表盘 |
部署形态
Monkeys 服务按需部署。本地 services compose 使用 profiles 来反映这个模型。
职责规则
monkeys负责生态文档、本地基础设施 compose、services compose 和 Agent 启动说明。- 每个应用或服务仓库负责自己的源码、Dockerfile、配置示例、测试和构建命令。
- README 只描述仓库关系。启动和部署细节放在
LOCAL_DEVELOPMENT.md、AGENT_BOOTSTRAP.md和docker/*/README.md。 - 功能开发必须在所属仓库完成测试；推送前本地 test 和 build 命令应成功通过。