Meldwork README banner

English · 简体中文

# Meldwork:让 Agent 自主协作推进任务 **提出目标,让 Agent 们协作完成。Meldwork 把你已有的 Agent 组织成一个工作小组,共享上下文、讨论方案、协作执行并相互检查,减少你在它们之间转述、催办和整合结果的工作。** Meldwork 是一个本地优先的多 Agent 协作工作空间,用来连接你已经在电脑上使用的 Agent 工具。你选定参与者、目标、上下文和权限后,自动讨论中的 Agent 可以接续彼此的工作,请求同伴补充或检查,并在授权范围内推进任务。它也支持单个 Agent 的直接会话和多个 Agent 的独立并发回复,覆盖研究、分析、写作、规划、评审和实施。 你无需安排每一轮发言,但仍负责目标、权限和关键决策。遇到信息缺失、权限请求或需要取舍的问题时,任务可能等待你处理。工作区写入需要明确授权;协作过程、运行状态和产物保存在本地,方便回看和继续工作。

下载 Meldwork V1.0.8 Apple 芯片 macOS 版 · 架构 · 许可证

## Meldwork 适合什么工作 当一个任务需要多个 Agent 共同推进,而你不想反复传递上下文、协调下一步时,Meldwork 更适合: - 研究与信息综合:结合本地 Agent 工具和明确选择的知识源; - 产品、市场、运营和技术分析; - 写作、规划、评审和结构化文档工作; - 处理本地文档、图片、音频、视频、PDF、代码和配置文件的多模态工作; - 在授权工作目录内执行、由其他 Agent 检查成果并继续修改的实施工作。 ## 一个任务如何在 Meldwork 中推进 1. **选择**一起处理任务的 Agent。 2. **限定**目标、工作目录、上下文、附件、Skill、知识源和权限。 3. **协作**:启动 Auto Discussion,让 Agent 讨论方案、接续执行并检查成果;也可选择直接会话或并发回复。 4. **决策**:在需要补充信息、授权或取舍时介入。 5. **查看结果**:检查交付物,必要时提出修改,让工作继续推进。 ## 协作模式 | 模式 | 运行方式 | 适合场景 | | --- | --- | --- | | **直接会话** | 一个已选 Agent 在适配器支持时保持对话和原生会话。 | 聚焦研究、写作、分析或执行。 | | **并发回复** | 已选 Agent 收到同一份冻结任务快照,并按稳定顺序返回独立回复。 | 在选择方案前比较不同视角。 | | **Auto Discussion V4** | Agent 独立提出方案后,接续讨论、请求同伴贡献、在授权范围内执行并检查成果。交付负责人判断任务进度,必要时请求用户决策;支持时保持原生会话。 | 希望减少人工协调的多步骤协作任务。 | 参与者始终由用户选择。从更大候选池自动选人组队不属于当前预览版。 ## 过程可回看,工作可继续 Meldwork 在本地保留任务上下文、Agent 回复、运行状态和产物,方便了解任务如何推进、哪里遇到阻塞,以及接下来需要处理什么。Run Ledger 保留阶段、参与者、尝试、产物、恢复状态和人工审批门;诊断工具输出与敏感运行信息留在 Electron 主进程边界内。 过程记录帮助检查协作情况,不代表每条结论都经过事实核验。Agent 的相互检查也不能保证结果正确,重要交付物仍需按实际用途验收。 ## General Agent 目录 当适配器和 CLI 版本兼容时,Meldwork 会检测并调用已安装的 Agent 命令。当前目录包括:
Codex logo
Codex
Hermes logo
Hermes
OpenClaw logo
OpenClaw
WorkBuddy logo
WorkBuddy
Zcode logo
Zcode
Pi Agent logo
Pi Agent
Kimi Code logo
Kimi Code
MiMo Code logo
MiMo Code
Claude Code logo
Claude Code
Gemini CLI logo
Gemini CLI
OpenCode logo
OpenCode
Qwen Code logo
Qwen Code
OpenCodeReview logo
OpenCodeReview
已批准的 Agent Connector 和自定义可执行 Agent 使用桌面端的连接器入口。完整的适配器、安装、Provider 和能力矩阵见[桌面端指南](desktop/README.md)。 ## 上下文与本地边界 Meldwork 作为本地 Electron 应用运行。对话、群组配置、运行记录和应用管理的附件保存在本地用户数据目录。渲染进程只通过受约束的 preload API 获取校验后的状态;可执行路径、凭据、原生会话引用、Skill 路径和任意 Shell 权限都留在主进程中。 选定的 Agent 仍可能把 Prompt、附件或 Skill 发送到其自身 CLI 凭据对应的模型服务商。知识访问必须明确选择并受边界约束:当前实现支持本地 Obsidian 检索,以及由本地 CLI 管理的飞书或钉钉访问模式。Local-first 描述的是 Meldwork 的数据和协作位置,不代表 Agent 使用的模型服务商一定离线。 ## 下载 V1.0.8 Apple 芯片 macOS 用户请前往 [Meldwork V1.0.8 预发布页](https://github.com/Ryder-Sun/Meldwork/releases/tag/Meldwork-V1.0.8),下载 [`Meldwork-1.0.8-arm64.dmg`](https://github.com/Ryder-Sun/Meldwork/releases/download/Meldwork-V1.0.8/Meldwork-1.0.8-arm64.dmg)。发布页同时提供 ZIP 压缩包和 SHA-256 校验文件。启动应用前,请至少安装一个受支持的本地 Agent CLI。 该预览版安装包使用 ad-hoc 临时签名,未使用 Apple Developer ID 签名,也未进行公证。macOS 首次启动时可能需要在“系统设置 → 隐私与安全性”中选择“仍要打开 / Open Anyway”。 ## 从源码运行 前置条件:Node.js `22.12+` 和 npm。 ```bash npm --prefix frontend ci npm --prefix desktop ci npm --prefix desktop run dev ``` 分发构建前运行: ```bash npm --prefix frontend test npm --prefix frontend run build npm --prefix frontend run build:desktop npm --prefix desktop test ``` ## V1.0.8 V1.0.8 将 Kimi 只读问答改为手动权限模式,避免强制进入计划流程;修复 MiMo 末尾文本丢失、原生 CLI 配置变量遗漏,以及发送后 Auto Discussion 模式重置。原生输出持续重复时会取消调用并保留已输出内容。Zcode 保持官方标志和 Pi Agent 前的位置,沿用原生默认配置;WorkBuddy 可以复用在 Meldwork 中选定的桌面已配置模型。 本轮对全部 13 个已安装 CLI 进行了真实调用。使用独立 Magpie 热修网关的五 Agent 无限轮讨论中,14 次原生调用全部完成。当前安装的 Magpie 可能把 `tool_calls:null` 误判为真实工具调用,将 `stop` 改写为 `tool_calls`,导致 OpenCode、MiMo 和 Hermes 持续续写;本次 Meldwork 发布不会安装或重启 Magpie。OpenClaw、Zcode、Gemini、Qwen 和 OpenCodeReview 在本机另有原生配置或认证故障,检测到安装不代表模型连接已可用。回归验证包括桌面测试 1,655 项、前端测试 370 项、Web 与桌面构建及打包验证。无限轮讨论保留进程停滞检测,工作区写入仍需明确授权。 Electron 实机界面另完成一轮五 Agent 无限轮讨论:19 次原生调用全部成功,无失败或自动重试,用时约 12 分钟。发送、完成、切回首页再返回群聊后,自动讨论与不限轮数均保持选中。该验收同样使用独立热修网关,证明流程可完成,不构成响应时长保证,也不代表用户现有网关已修复。 ## 文档 - [架构与产品边界](architecture.md) - [桌面端设置与 Agent 矩阵](desktop/README.md) - [贡献指南](CONTRIBUTING.md) - [安全策略](SECURITY.md) ## 许可证 Meldwork 以 [Apache License 2.0](LICENSE) 开源。在许可证条款范围内,可以商用、私用、修改和再分发。商用无需另行授权或支付许可费。Apache-2.0 不授予商标权;详见 [COMMERCIAL_USE.md](COMMERCIAL_USE.md)。