Multica 架构与设计思路分析
multica-ai/multica 不是新的 coding agent loop,而是 managed agents platform。它把 Claude Code、Codex、Copilot CLI、OpenClaw、OpenCode、Hermes、Gemini、Pi 等本地/云 runtime 抽成“Agent teammate”:有 workspace、agent profile、issue board、task queue、runtime daemon、autopilot、squad、skills、activity timeline 和 WebSocket progress。
核心架构图
┌──────────────────────────── human team / board / CLI ────────────────────────┐
│ issue · assignment · comments · autopilot · squad routing │
└───────────────────────────────┬───────────────────────────────────────────────┘
│
┌───────────────────────────────▼───────────────────────────────────────────────┐
│ Go backend (Chi + sqlc + WebSocket) │
│ auth · workspace · agents · issues · task queue · skills · integrations │
└───────────────┬───────────────────────────────┬───────────────────────────────┘
│ │
┌───────────────▼──────────────┐ ┌─────────────▼──────────────────────────────┐
│ PostgreSQL + pgvector │ │ daemon / runtime │
│ workspace state · tasks │ │ detects CLIs · executes tasks · streams log │
└───────────────────────────────┘ └─────────────┬──────────────────────────────┘
│
┌─────────────────────────────────────────────────▼────────────────────────────┐
│ Claude Code / Codex / Copilot CLI / OpenCode / Hermes / Gemini / Pi / Kimi │
└───────────────────────────────────────────────────────────────────────────────┘
模块分层
| 层/目录 | 责任 |
|---|---|
server/cmd/server/** |
Go backend 入口、router、listeners、scheduler、runtime sweeper、auth scope guard。 |
server/internal/daemon/**, daemonws/** |
本地 daemon、runtime identity/health/wakeup、WebSocket hub。 |
server/internal/handler/** |
agent、autopilot、issue、skill、workspace、auth 等 HTTP handler。 |
server/pkg/db/queries/**, server/migrations/** |
sqlc 查询和 100+ migration,说明产品状态模型较重。 |
关键数据流
- 用户或 autopilot 创建 issue,分配给 agent/squad。
- backend 将任务入队,runtime daemon 通过 WebSocket/轮询接收并 claim/start。
- daemon 检测本机可用 agent CLI,按 agent 配置执行任务,并把 progress/log/activity 回传。
设计决策
- 核心抽象是“agent teammate”,不是“agent framework”;因此 DB schema、权限、工作区、任务生命周期比模型调用更重要。
- 通过 daemon 接入现有 CLI,避免重写 Codex/Claude/Pi 执行 loop,但也继承各 CLI 的安全/稳定性。
- Squad/Autopilot 是调度层:前者解决人如何分派,后者解决周期性工作如何自动生成任务。
对比定位
和 Codex/Pi/oh-my-pi 相比,Multica 是调度/协作外壳;和 AgentScope Runtime 相比,它不把单个 agent app 服务化,而是管一组现有 coding agents;和 nanobot 相比,它更像团队工作台,不是个人多渠道 agent 内核。
相关链接
- GitHub 当前状态底稿:src-github-stars-backlog-current-state
- 选型地图:github-stars-backlog-implementation-map