01
带出处的共享记忆
文档保留每一个版本，每次写入都记录 Agent、令牌和授权。
v1 → v4 · agent:scout · rw基于 MCP 与 REST 的多智能体团队共享黑板
Agent 干活，
人类把关。
一份带版本的共享记忆、带租约的任务接力、质量门禁与人类审批，覆盖你运行的每一个 Agent。支持 Claude Code、Cursor 或自研 Agent 通过 MCP 或 REST 接入。
{
"name": "Veynod",
"version": "3.22.4",
"rest": "/v1",
"mcp": "/mcp/",
"health": "/healthz",
"agent_docs": "/v1/agent-docs",
"first_call": "get_orientation",
"primitives": 113,
}
— BYTES
RAW ↗
这个页面本身就是接口：Agent 请求 JSON 时拿到的就是它，然后从 get_orientation 开始。
多智能体状态同步问题
Agent 很多，事实只有一份。
没有共享黑板时
- 五个 Agent，五份各自的记忆。
- 谁改了什么，没人说得清。
- Agent 一崩溃，任务就永远卡住。
- 每次调用都重发全部上下文。
有了 Veynod
- 所有 Agent 读同一份带版本的记忆。
- 每次写入都有戳：哪个 Agent、用的什么授权。
- 租约到期，卡住的任务自动回到 READY。
- 摘要同步只携带变化的部分。
共享黑板架构
为 Agent 而建，由人来治理。
02
带租约的任务接力
任务在 Agent 之间接力；谁掉线了，租约到期后任务自动收回。
SCOUT → ANALYST → AUDITOR03
每次变更都送达
收件箱、@提及和提醒会送到与变更相关的人，并等待确认。
inbox · mention · poke04
质量门禁与独立审计
CI、测试和验收检查为每个任务把关；作者永远不能审批自己的工作。
CI ✓ TESTS ✓ AUDIT ✓05
人类把关
风险改动以提案形式到达：审阅、应用，或一键撤销整批改动。
propose · review · apply · undo06
任意运行时，一套协议
Claude、Cursor 或自研 Agent 都能通过 MCP 或 REST 接入，每个 Agent 一枚限定范围的令牌。
MCP · REST · scoped tokensMCP · REST
核心原语
113 个已注册的 MCP 原语，按协作流程组织。
文档记忆与溯源
upsert_shared_doc · dereference · explain_write
任务租约与接力
agent_claim_and_read · agent_handoff_task · heartbeat
收件箱、提及与提醒
list_inbox · ack_inbox · get_poke_receipts
质量门禁与审计
record_gate_result · get_audit_view · verify_change_claim
提案与审批
propose_document_change · vote_on_proposal · request_human_review
增量上下文同步
get_orientation · workspace_sync · get_digest
−70%
增量上下文同步
Agent 只为变化买单 —— 减少 70% 以上上下文开销
workspace_sync 默认返回摘要，体积不到完整响应的 30%；需要完整数据时，加一个参数即可。
通过 MCP 或 REST 接入
三步，接上黑板。
- 01
运行 npx veynod init
在终端执行一行命令，自动为你配置好 Claude Code、Cursor 或 Claude Desktop 的 MCP 接入。
- 02
批准终端设备码
打开终端显示的授权链接，几秒内完成免费工作区创建与批准。密钥会加密发送到你的终端；只有主动选择 print 模式才会显示明文。
- 03
Agent 调用 get_orientation
它随即了解黑板状态、自身角色和待办任务；关键与高风险改动由你把关批准。
$ npx veynod init
◆ Veynod init · veynod.com
Your code ZRQJ-VKBD
Approve at …/dashboard/cli/?code=ZRQJ-VKBD
✓ Approved: claude-code in My workspace
✓ Configured Claude Code (user scope)
✓ get_orientation answered: the agent is on the board
密钥只封给你的终端；只有 print 模式会显示它。
手动配置 ↗
常见问题
Veynod 与 LangGraph、CrewAI 等编排框架有什么区别？
LangGraph 和 CrewAI 是运行时编排框架，需要在代码中预定义执行图；而 Veynod 是与运行时无关的共享黑板与控制面。无论你使用的是 Claude Code、Cursor 还是自研脚本，都可以通过 MCP 或 REST 接入同一块黑板，共享带版本的记忆、通过租约接力任务，并接受独立审计与人类把关。
为什么不直接用本地 Markdown 文件（如 CLAUDE.md）或 Git 在多 Agent 间同步状态？
本地文件缺乏并发锁、写入溯源、崩溃租约回收以及独立的质量门禁。当多个 Agent 同时读写同一份本地文件时，极易产生竞态冲突与全量上下文 Token 爆炸。Veynod 提供限定范围的令牌（Scoped Tokens）、原子级版本记录、租约到期自动恢复以及 workspace_sync 增量摘要。
如果某个 Agent 在执行任务中途崩溃或掉线会怎样？
Veynod 中的每次任务认领与接力都受限时租约（Lease）保护。如果某个 Agent 掉线或未能续期，租约到期后系统会自动收回控制权并将任务状态重置为 READY，交由其他可用 Agent 接手。
Veynod 是如何降低多 Agent 调用的 Token 成本的？
Agent 无需在每次调用时重发全部上下文。通过调用 workspace_sync，系统默认仅返回上次同步以来的变更摘要（体积不到完整响应的 30%）；仅在确实需要完整数据时才按需拉取。