beat
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
BEAT 多方协同
这是 BEAT 的开源源码仓库,以 MIT 许可证发布。商业安装包、托管服务与技术支持不属于本仓库内容。 源码可以独立运行(见下方「从源码运行」);发现问题请提交 Issue,改动请走 Pull Request。
**Codex、DeepSeek、ZCode、拓展坞+助手是平等搭档,Claude 是失败时的只读顾问。**一个服务、一个看板、一个 MCP(beat)。
Codex 或 DeepSeek 或 ZCode 发起 → 全体同轮并发讨论和分工 → 全体批准同一版本 → 所有搭档按分工同时处理文件、命令和电脑操作 → 发起方核验 → 失败时请 Claude 建议并重新审批返工。模型没有固定先后顺序;共享电脑的具体操作互斥,思考和文件工作继续并行,各方保留自己的操作上下文。
ZCode 搭档默认停用:在看板「设置 → 模型默认值」里勾选启用后参与协作;首次使用需要完成一次 zcode login zai 浏览器授权(未登录时点「测试 ZCode 联通」会给出指引)。
同一任务的每位搭档固定使用自己的会话,讨论、执行、评估、返工和继续执行都向该会话追加消息;只有发起新任务才新建会话。API 搭档保存完整工具调用历史及稳定前缀,已收到的讨论记录不重复注入。固定会话不等于输入 token 免费或保证缓存命中。
2.2.125 更新要点(2026-10-19)
交付不再误判:方案只登记了部分文件时,自动补齐任务说明/产出引用里点名的文件;同一方案依赖任务重写前序产物不再算越界。
失败恢复:新增
node src/cli.mjs release <任务号> [--task 小任务],核对现有文件后只重新排队被隔离的小任务、不重放已完成写入。文件夹授权:新增
node src/cli.mjs folders list | add <目录> | remove <目录>,与看板「以后允许」写同一份授权记录。轮数与费用透明:轮数被本机上限或本地控制器调整时返回请求值与实际值;取消且未调用模型时明确「未产生费用」。
暂停语义:暂停的搭档被直接提问/追问时明确报「已手动暂停、未派发、未产生费用」,不静默换人;拓展坞也可暂停/恢复。
用量接口:新增
node src/cli.mjs usage;接口不返回金额与上游剩余配额,实际费用以提供方账单为准。接口细节:非法枚举报错给出可填值;
beat_get支持fields精简返回;wait_seconds派发前校验。
完整变更见 CHANGELOG.md。
Related MCP server: Council Blackboard
日常使用
运行 node src/cli.mjs open 打开看板(发行版里是双击启动脚本):
顶部三张状态卡:Codex / DeepSeek / Claude 是否在线、冷却到几点;可以手动「暂停」某一方(让别人顶上)。
发起:选「难题讨论」或「并行任务」,选发起方(提出问题、最后评估的一方),写清问题或目标。
右侧是过程:每次发言谁说的、同意还是有异议、分歧在哪;并行任务还有分工表、各搭档交付报告、每轮评估。
快速提问:直接问某一方,答复自动续上同一会话。
设置:Claude 顾问连接和拓展坞接入模型用同一套选项——服务商与名称、站点地址、密钥、「获取这个端点的模型列表」后搜索选模型、默认推理强度(未声明的端点只显示"由接口决定",不会假装支持)、接口协议与推理协议声明、支持图片输入、启用;「测试 Claude 联通」会先保存再测试。另有 Codex / DeepSeek 的默认模型;讨论发言上限、并行最多几轮、冷却时间、卡住多久算卡住(默认 12 分钟);允许的工作目录。
并行任务里,一方卡住会有另一方自动接手,接手记录和根因分析都出现在同一条任务的时间线上。
拓展坞(顶部「+」):选服务商(预置了通义千问、Kimi、智谱 GLM、豆包、腾讯混元、MiniMax、硅基流动、零一万物、百川、DeepSeek 官方 API,或自定义 OpenAI 兼容端点)→ 填密钥 → 「获取这个端点的模型列表」→ 搜索并选模型 → 保存后自动测试(列模型、实发一句、试一次工具调用)。 可以无限追加,同一家也能接多个模型;卡片上的 ⚙ 可修改、测试、上移/下移(只改变卡片显示顺序)、停用或移除。密钥只存在
secrets.local.json。附件:发起/提问卡片里可以拖入图片或文件、在输入框里直接粘贴截图、或点「选择文件」(单个 ≤50MB,最多 20 个)。
推理强度:发起时可分别给 Codex / DeepSeek 选强度;提问时选的强度会记到该会话;「设置」里可改两方的默认模型和默认强度。
每轮全体同时提出或审议意见,改动后重新全体批准;安全上限内未获全体本人批准就停止,不强行分工。所有搭档都可以领取文件或电脑任务。
在 Codex 或 DeepSeek 里直接说(setup 之后重启客户端,出现 beat 工具):
这个问题用 beat_discuss 和 DeepSeek 讨论一下:……
用 beat_parallel 和 DeepSeek 分工完成:在 E:\beat\workspaces\demo 里……,验收是……。完成后告诉我评估结论。
在哪个客户端里说,哪一方就是发起方。
命令行(node src/cli.mjs 查看全部):
node src/cli.mjs discuss "问题" --by codex
node src/cli.mjs parallel "目标" --by deepseek --cwd E:\beat\workspaces\demo
node src/cli.mjs get R1 --wait 120
node src/cli.mjs ask claude "问题" # 续问加 --session S1
node src/cli.mjs agents pause codex # 手动让 Codex 下线;resume 恢复
node src/cli.mjs claude-test三方是怎么被调用的
谁 | 方式 | 说明 |
Codex | 桌面端自带 | 用你账号当前的模型;对话进 Codex 历史,标题以「BEAT ·」开头;同一任务里讨论和评估在同一个 thread |
DeepSeek |
| 模型/推理强度读取桌面端当前选择;同一任务里的发言在同一个原生会话 |
Claude | 第三方号池 API(固定流式) | 只读;评估时附上变化文件的内容;密钥只存在 |
对方桌面端不需要开着。被拉起执行的子任务里禁止再发起协作(防递归)。并行任务同一时间只跑一条(避免两条任务同时改文件),讨论和问答不排队。
验收命令:Codex / DeepSeek 的沙箱里通常不能启动子进程(node --test 会报 spawn EPERM),所以双方在分工时商定 checks(如 node --test),每轮执行后由 BEAT 在沙箱外、工作目录内实际运行,把真实输出交给评估方。这些命令以你的权限运行,看板「设置」里可以关闭。
限制模式:默认"严格",可按任务放开
出厂默认是严格档(三个开关都是安全默认),避免普通买家在不理解后果时默认承担过大的权限面。需要装依赖、跑测试或写构建缓存时,在看板「设置 → 高级设置」按任务选择放开;已有任务保留发起时的设置,不会被后续改动悄悄改掉。
开关 | 出厂默认(严格) | 按需放开 |
| 只能读写任务目录(workspace-write):装不了依赖、跑不了测试 | 完全访问(danger-full-access):执行者能装依赖、跑任意命令 |
| 越界即失败:写了任务文件范围外的文件会判失败 | 不强制范围:范围外写入只留痕、不判失败 |
| 隔离:来源不明的改动或未核验的电脑输入隔离成 blocked,等人工确认 | 只留痕继续跑 |
为什么以前会"干完活却卡住"(R171 实测):PyInstaller 打包含法地写出 .build\cache\… 等 28 个文件,落在任务声明的文件范围外 → 被判"未知副作用"隔离 → 它的下游任务永远等不到 passed → 整轮失败,而产物其实都做好了。
隔离后怎么继续:看板任务卡片上会出现「放行被隔离的小任务(N)」按钮,点一下就把 blocked 的任务重新排队(beat_release 工具同效,会记下谁在什么时候放的行、原隔离原因)。这条通道是必需的——没有它,隔离就等于死局。
追问可以带附件:任务跑完后在「在本任务里继续追问」那块,和发起任务一样能拖入图片/文件/文件夹、粘贴截图。附件会复制到任务目录的 .beat-attachments/<任务号>/(不混进交付物),并随提示词一起送给搭档;图片 Codex 能直接当图片看。
谁在计票(模型不能自己宣布通过)
模型只负责"说出自己选哪一项",计票、判门槛、判严重反对,全部由 BEAT 的代码做。
每个在场席位回答: {"votes":[{"id":"risk","option":"…","reason":"…","serious":false}]}
↓ (模型只说票,不说结果)
BEAT 代码: 解析 JSON → 把本人票放进 votes[席位] → 归并同义选项 → 数票
→ 某选项得票 ≥ 门槛 且 无严重反对 → 锁定;否则记分歧、进入下一轮或裁决规则 | 说明 |
门槛 | 由代码按在场人数算:四家 3 票、三家 2 票、两家须一致(看板改不了,防止把门槛调低好通过) |
两关 | ① 每个席位的初版提纲本身就当一票(多数情况这关就锁定);② 只有没谈拢的那几项才进投票轮 |
严重反对 | 任一家标记 |
同义选项 | 有个一次性轻量归并:让一个模型只回答"哪些选项意思相同",拿到别名表后仍由代码重算票数 |
缺席/代答 | 掉线的席位不参与计票;被他人代答的票会标注、不计本人票 |
一直投不齐 | 最多投 3 轮(看板可改轮数),仍不齐就交裁决;裁决只能从已列选项里挑,不能自己写新方案、不能降低验收标准 |
模型不能做的事:替别人投票、宣布自己这方通过、改门槛、把严重反对压过去。这些都由代码把关,src/compact-discussion.mjs 里有对应的单元测试。
附件怎么送到每个搭档手里(两条通道,实测结论)
你上传的每类附件,所有搭档都能读到,但走的通道不同:
搭档 | 图片 | Excel / Word / PPT / PDF / 压缩包 / 文本 |
Codex(原生) | 图片输入(消息里是 | 只给路径,它自己用文件工具打开(按你的要求保持原样) |
DeepSeek(原生) | 只给路径 + 提示,它自己用工具读(CLI 未接受图片入参) | 同上 |
拓展坞 API(glm-5.3 / claude号池)、Claude | 图片输入(base64 随消息发送) | BEAT 用 |
实测(本机):
上传 sales.xlsx(北京/120/首季)→ 问 glm-5.3"第一列第二行的城市名"
答复:第一列第二行的城市名:北京;第三列第二行:首季 ✅转不出来的文件如实说明("BEAT 无法把这种文件转成文本"),不假装成功。
图片只发一次:按会话记账(
seenImages),同一条会话里不会每一步重复发。转换需要 Python(本机
~/.dsh自带 openpyxl / python-docx / python-pptx / Pillow);找不到就退回"只给路径"并在正文里注明。
执行者的沙箱权限(装依赖、跑测试要靠它)
执行者(Codex / DeepSeek 的原生会话)默认跑在 workspace-write 沙箱里:只能在任务目录内读写,不能启动子进程——所以 pip install、pytest、npm install 这类都会失败(报 spawn EPERM / ENOENT)。BEAT 自己的验收命令不受影响(它是以你的权限跑的),但装依赖这件事必须执行者能跑命令。
看板「设置 → 高级设置 → 执行者的沙箱权限」两个选项:
选项 | 效果 | 风险 |
只能读写任务目录(默认) | 执行者只能改任务目录里的文件;装不了依赖、跑不了测试 | 低 |
完全访问 | 执行者用自己的工具就能装依赖、跑任意命令 | 高:它能执行任意命令,请只在信任目标时开 |
实测(本机原本没有 pytest):
执行者报告:本机原无 pytest(No module named pytest),且用户 pip 配置里有 install.target=…
用 PIP_CONFIG_FILE=nul 仅对该次安装绕过配置,装到用户级 site-packages,未修改全局 pip 配置
复核轮: 验收命令 pytest tests/test_beautify.py 原样重跑 = 21 passed in 0.10s,退出码 0这是一次显式放开本机权限:时间线里会记「执行者按「完全访问」建立会话(可装依赖、可跑命令)」。
只影响执行阶段:讨论、评审、核验仍跑在只读会话里,不能改文件。
配置键:
config.json的flow.executorAccess(workspace-write|danger-full-access)。
每个任务都有自己的文件夹(文件写在哪里)
给一个目录发起并行任务后,BEAT 会在里面自动建一个任务目录,交付文件都落在那里,不再直接写在你给的目录根:
<你给的目录>/beat-runs/<日期>/<任务号>/
src/… 产出(模型按任务目录写相对路径)
test/…
package.json
.beat-control/ 框架自己的队列账本、检查证据、检查点(不用管它)每个小任务还有自己的子目录(
task-1/、task-2/…),多个任务互不覆盖。规划时 BEAT 会把真实任务目录告诉搭档,并要求文件范围与验收命令一律写相对路径(如
node --test test/x.test.mjs);万一写了绝对路径,落在任务目录内的会被自动归一成相对路径,落在目录外的会给出可改的报错。任务之间天然隔离:同一天跑 10 个任务就是 10 个文件夹;任务目录已存在且非空时会自动加后缀(
R168-2),不会混在一起。想看某个任务的产出,直接在
beat_get里读它返回的cwd,或者按上面的规则去<你给的目录>\beat-runs\<日期>\<任务号>\找。不想要这个行为:
config.json里把flow.taskFolder设为false就回到"直接写在你给的目录根"的老行为(创建失败时也会自动退回老行为,不会让任务挂掉)。
文件
路径 | 内容 |
| 服务、编排(orchestrator)、顶替(roster)、三方执行端、MCP、命令行。零第三方依赖,Node ≥ 24 |
| 看板 |
| 配置示例;复制为 |
| 本地访问令牌、Claude 密钥——不要外传,已在 |
| 任务、每一步、会话、事件、三方健康状态 |
| 每个任务的完整记录 |
| 每一步的原始事件流、服务日志 |
| 接入时对 Codex / DeepSeek 配置做的备份 |
给后续「操控电脑助手」的接口(src/dock.mjs)
拓展坞的底层客户端是通用的,电脑助手直接用它做「模型 → 调工具 → 把结果喂回模型」的循环:
import { loadConfig } from './src/config.mjs';
import { chatDock, dockList } from './src/dock.mjs';
const config = loadConfig();
const id = dockList(config).find(d => d.tools === 'supported')?.id; // 测试时已标出哪些模型能调工具
const messages = [{ role: 'system', content: '你可以操控这台电脑…' }, { role: 'user', content: '打开记事本' }];
const tools = [{ type: 'function', function: { name: 'run_command', description: '…', parameters: { type: 'object', properties: { cmd: { type: 'string' } }, required: ['cmd'] } } }];
for (;;) {
const r = await chatDock(config, id, { messages, tools }); // 流式;支持图片(截图)content
messages.push(r.message); // assistant 消息(含 tool_calls)可直接接回
if (!r.toolCalls.length) break;
for (const c of r.toolCalls) messages.push({ role: 'tool', tool_call_id: c.id, content: await runTool(c.name, JSON.parse(c.arguments)) });
}chatDock 返回 { text, toolCalls, finishReason, usage, model, message };错误信息是中文人话(密钥无效 / 限流 / 地址不对…)。
从源码运行
需要 Node.js ≥ 24.14。项目运行时零第三方依赖,npm install 只安装开发用的 eslint。
git clone https://github.com/HLX-CPU/BEAT.git
cd BEAT
Copy-Item config.example.json config.json # 可选;不建也能跑,省略的键使用内置默认值
npm install # 仅开发依赖
node src/cli.mjs start # 启动服务看板地址:http://127.0.0.1:8765。首次启动会在 secrets.local.json 生成访问令牌,请勿提交或外传。
把 BEAT 注册成 Codex / DeepSeek 的 MCP(会先备份原配置,完成后重启两个客户端):
node src/cli.mjs setup测试与维护
npm test # 单元测试(假执行端,不耗额度)
node tests/live-e2e.mjs # 实机端到端:真跑一次讨论 + 一次并行任务(耗少量额度)
npm test里含少量集成用例,会检测本机是否安装 Codex / DeepSeek / ZCode 桌面端;未安装时这些用例会报「未检测到…」,属于环境差异,不影响其余单元测试。
改了
src/要重启服务:node src/cli.mjs stop,下次调用自动拉起。服务重启时,未结束的任务标为「中断」,不自动重跑(可能已经写过文件)。
DeepSeek 写文件前,BEAT 会给工作目录补上它沙箱需要的本人权限(只限本人拥有的目录,原权限备份在
data/acl-backups)。
许可证
MIT © 2026 HLX-CPU
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
- aXDeprecatedio.github.ax-platform
Agent-native collaboration network: orchestrate a team of long-running agents from any MCP client.
Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Shared memory and mail for your AI agents. Verified with Claude Code; other MCP clients in testing.
Related MCP Servers
- FlicenseNot gradedqualityAmaintenanceEnables multiple AI models to collaborate under a shared goal, architecture, plan, loops, sandbox, and acceptance criteria via a local-first MCP server.-
- FlicenseCqualityBmaintenanceEnables AI agents to collaborate via shared blackboard state, multi-agent deliberation, human-in-the-loop proposal approval, operating-mode control, and audit logging through MCP.11-
- AlicenseNot gradedqualityBmaintenanceEnables multiple AI agents using MCP-compatible clients to collaborate in parallel on the same project across one or more machines, with direct messaging, a shared task board, atomic file/folder locking, presence tracking, and a live web dashboard.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables external MCP clients like Claude Desktop, Claude Code, Cursor and Zed to hand work to a local crew of AI agents that plan, write, check and fix code in a folder, while also acting as an MCP client that can use their tools. Runs locally with user-supplied keys, approval-gated commands, diffable and undoable runs.AGPL 3.0