Micro-Multi 是一个以多 Agent 协作为核心的本地桌面工作区。你提出需求,主 Agent 拆分任务;你确认分工后,成员按负责文件和任务依赖执行,主 Agent 汇总结果。方案、成员进度、工具输出和代码差异放在同一个工作区里。
例如给订单接口加分页:一个成员修改接口,一个成员编写测试,文档成员更新参数说明。互不依赖的任务可以同时做;需要等接口完成的测试按依赖启动。同一文件的并发写入由调度器协调。
另一个重点是 DeepSeek Harness(dsh)插件兼容性。应用使用原生 Cordis Host 和 dsh 客户端模块系统,加载插件声明的服务、工具、设置表单和界面贡献。启用的工具也能交给团队成员使用。已有的 Skills 和 MCP 服务可以继续接入。
Windows / Linux · 中英文界面 · 自选模型服务 · Apache-2.0
为什么需要协作调度
单 Agent 适合短任务。实现、测试和审查都交给同一个执行循环时,通常需要依次处理,职责和中间结果也混在同一段上下文中。仅在提示词里写“分工”还不够:谁能修改哪些文件、谁必须等待谁、任务是否已启动,需要程序处理。
| 单 Agent 或没有协调器的分工 | Micro-Multi 的处理方式 |
|---|---|
| 实现、测试、文档依次执行 | 独立任务并行,依赖任务等待前置报告;可设置并发上限。 |
| 多个成员都修改同一个文件 | 声明文件归属,用路径锁和任务依赖协调写入。 |
| 所有职责使用同一模型 | 成员默认继承主模型,你可以在方案里单独修改。 |
| 重试时容易重复派发 | 同一任务复用正在运行或已完成的执行,批准过的版本只启动一次。 |
| 插件只接到了主 Agent | 已启用的 dsh、MCP 和命令工具可供主 Agent 与成员调用。 |
这些是执行方式的区别,不是性能排名。并行能缩短独立任务的等待时间,但更多成员也可能增加模型调用和费用。小改动可以只用主 Agent;有明确分工的大任务再启用团队。
安装
在 GitHub Releases 下载对应系统的软件包。
| 系统 | 软件包 |
|---|---|
| Windows x64 | NSIS 安装程序 |
| Debian / Ubuntu x64 | Debian 包 |
| Linux x64 | AppImage |
| 校验和 | SHA256SUMS.txt |
Windows 运行安装程序,然后从开始菜单打开 Micro-Multi。Debian 或 Ubuntu 使用 sudo apt install ./<package>.deb 安装下载的包。AppImage 先执行 chmod +x <file>.AppImage,再运行该文件;没有 FUSE 时可加上 --appimage-extract-and-run。
安装包内置 Python 和 Node.js。仓库操作需要另外安装 Git,Docker 和插件所需的外部 CLI 也按需安装。桌面指南介绍 Linux 凭据库、Ubuntu AppImage 配置、校验和及自行构建的方法。
完成第一个任务
-
打开设置 → 模型 → 添加或编辑模型,填写名称、API 地址、模型 ID 和密钥,然后点击“检测连接”。
-
添加本地项目目录。保留“直接关联此目录”勾选项,即可在原目录中工作;没有 Git 的目录会自动初始化仓库。
-
在该项目中新建对话,选择模型、多 Agent 协作模式和允许的操作权限。
-
说明要修改什么,以及怎样检查。例如:
为订单列表接口添加分页,保留现有响应字段。 将接口实现、边界测试、参数文档拆给不同成员,列出负责文件和依赖。 主 Agent 汇总改动,运行相关测试并说明结果。 -
审核聊天里的协作方案,必要时调整成员、模型和负责文件,然后点击“确认执行”。
-
查看成员进度,打开改动文件和测试输出;需要调整时在原对话中补充要求。
你可以向对话添加附件,也可以打开右侧工作区查看文件、审查、预览和终端活动。项目与对话介绍主要操作,模型配置说明接口连接方式。
使用团队协作
主 Agent 准备方案,列出成员职责、任务、负责文件、依赖和模型。通过“调整团队”修改安排,再点击“确认执行”启动这版方案。批准前不会执行成员任务。新任务或新一轮反馈需要重新确认。
确认使用服务端保存的方案版本。若方案确实更新了,聊天卡片直接显示新版分工,审核后可以在原处再次确认,无需切到协作导图。
成员默认跟随主模型,也可以单独选择其他模型。团队视图显示状态和报告,工具记录展示实际执行的操作。运行中可以补充说明、暂停对话或停止执行。验收时应查看改动和测试输出;具体流程见团队协作。
添加指令和工具
在“自定义”中管理扩展。
| 扩展 | 用途 |
|---|---|
| Skills | 在 SKILL.md 中保存可复用的工作指令。项目技能放在 .agents/skills/。 |
| MCP 服务 | 接入本地或远程服务提供的工具。 |
| dsh 插件 | 原生 Cordis 服务与工具、模型提供者、设置表单和对话界面组件。 |
| 命令插件 | 调用本地命令实现的工具。 |
安装后打开插件详情配置参数。有些插件需要先填写账号、API 密钥或安装外部程序,才能使用其工具。输入区的 + 菜单列出已启用能力。选择扩展类型可参考扩展指南,安装或开发 dsh 插件可参考dsh 指南。
兼容范围以包声明的入口、依赖和所需服务为准,不代表每个第三方包都已验证。聊天启动先恢复工作区,插件客户端随后加载;不提供前端的插件不会因页面探测而启动 Host。原生服务仍按 dsh 的依赖与生命周期加载。
权限和数据
输入区提供三种权限:“请求批准”在修改文件和运行命令前询问;“帮我批准”允许修改文件,运行命令仍需确认;“完全访问”允许文件操作、命令和已启用的外部工具。权限说明介绍这些设置的作用。
项目记录、对话和附件保存在本地。请求模型时会发送任务需要的上下文,启用的扩展也可能向其服务发送数据。模型配置中的 API 密钥使用系统凭据库保存。本地命令和原生插件以你的系统用户权限运行。
安装版数据位于 Windows 的 %APPDATA%\Micro-Multi\data,或 Linux 的 ${XDG_CONFIG_HOME:-~/.config}/Micro-Multi/data。源码模式默认使用工作目录下的 .masp,可通过 MASP_HOME 指定其他位置。升级和卸载保留数据,备份时应将数据目录与应用程序分开处理。
从源码运行
准备 Python 3.11+、Node.js 24+、npm 和 Git,在仓库根目录执行:
python -m venv .venv
Windows PowerShell 使用 .\.venv\Scripts\Activate.ps1 激活虚拟环境,Linux 使用 source .venv/bin/activate。随后执行:
python -m pip install -e ".[dev]"
npm ci
npm run desktop
如果使用浏览器,运行 python -m masp.cli serve,然后访问 http://127.0.0.1:3080/。配置和数据目录见部署指南。
技术栈
| 部分 | 实现 |
|---|---|
| 桌面应用 | Electron,使用沙箱渲染进程及桌面操作 preload 桥。 |
| 后端 | Python、FastAPI、Uvicorn 和 Pydantic,负责本地接口与智能体执行。 |
| 界面 | HTML、CSS 和 JavaScript;原生插件组件由 React 渲染。 |
| 智能体与插件运行时 | Node.js、Cordis 和 deepseek-harness 软件包。 |
| 存储 | SQLite 保存应用记录,本地文件保存附件,系统凭据库保存模型密钥。 |
| 通信 | HTTP 接口、对话事件 SSE 流,以及插件订阅 WebSocket。 |
| 构建与文档 | electron-builder、esbuild,以及由 Markdown 生成的静态网站。 |
架构说明介绍各部分如何通信,以及对应的源码目录。
文档与参与贡献
开始使用时,可以依次阅读模型配置、项目与对话、团队协作和扩展。遇到问题时,参见常见问题。
可复现的问题提交到 Issues,附上操作步骤和脱敏日志;使用讨论和建议可放在 Discussions。贡献代码前请阅读贡献指南,安全漏洞通过安全政策中的私密渠道报告。
Micro-Multi 使用 Apache-2.0 许可证。第三方组件保留各自许可证,参见 NOTICE 和运行时溯源。