架构与流程图 本文档中的图用 Mermaid 编写，可在支持 Mermaid 的 Markdown 预览器中查看。 1. 总体框架图 flowchart LR User[Human user] --> Web[apps/web<br/>Next.js] User --> Desktop[apps/desktop<br/>Electron] ...

Agent Workdir 与 Git Worktree 协作模型 这篇文档只解释一件事： 多个 agent 修改同一个项目时，代码文件到底放在哪里、分支怎么来、用户最后看什么。 先把最容易混淆的概念拆开： 名词 是什么 谁管理 workdir 一次 agent task ...

Squad Child Issue 生命周期 这篇文档只拆一条主线： 用户创建 squad 父 issue -> leader 拆 child issue -> teammate 执行 child issue -> child issue 完成 -> server 判断 stage barrier -> 唤醒 leader 汇总并推进下一 stage 这...

Agent Prompt 与运行指令分类目录 这份文档只整理“代码里写死、并可能进入 agent 运行上下文”的 prompt / instruction。它不是 UI 文案清单，也不是把所有变量名里带 prompt 的地方都列出来。 核心结论先放前面： Multica 给 provider 的直接输入不是只有一段 prompt，而是多层上下文叠加。 每次 task 启动时，...

flowchart TD classDef decision fill:#fff7e6,stroke:#c47f00,stroke-width:1px,color:#2f2100; classDef terminal fill:#f4f4f5,stroke:#a1a1aa,color:#18181b; subgraph UI["User / UI"] ...

Codex Prompt 与结果回写节点链路 本文只讲单 Agent 场景： 用户 -> Multica -> CodeSmith -> Codex 不考虑 team / squad / leader。主例子使用 issue 底部“留下评论…”触发；文末补充“回复…”场景的差异。 核心问题是： 用户输入长什么样 Multica 包装后的 prompt 长什么样 ...

Codex Provider 流程细节拆解 这篇文档只拆 Codex 这一条 provider 链路。重点不是“Codex 怎么写代码”，而是 Multica 后端和 daemon 如何把一个 Agent task 转成一次 codex app-server 执行，再把 Codex 的 thread、turn、消息、usage 和结果收回到 Multica 的 task 状态机里。 先明...

Agent 开发核心设计拆解 这篇文档以后端 Agent 开发为主线，解释 Multica 为什么这样设计、关键数据如何流转、扩展一个 Agent 能力时应该改哪些层。前端只在 HTTP/WebSocket 契约或触发入口上出现，不讨论页面、组件、状态库。 核心结论先放前面： Agent 不是一个 CLI 进程，也不是一段 prompt。它是工作区里的协作身份，同时绑定一个 ru...

后端技术详细拆解 这篇文档按后端工程视角拆 Multica。前端只出现在和后端强绑定的位置：HTTP header、认证 cookie/token、WebSocket 连接、事件 payload、上传/下载 URL。React、组件、状态库、页面技术不在本文范围内。 结论先放前面： Multica 后端核心是一个 Go API server，入口在 server/cmd/serv...

部署、认证、集成与排障 本文提炼文档站里的 Cloud/Self-host/Auth/CLI/GitHub/Lark/Troubleshooting 内容。它服务于代码学习：当你看到某个环境变量、token、webhook、daemon 状态时，能立刻知道它在系统里的位置。 Cloud 与 Self-host 的边界 Cloud 和 Self-host 换的是 server 层，不换执...