Speaker Notes
自动 / Auto · Enterprise Dark

Intent Broker v1

本地优先、多 agent 协作协议中间层。它不替代 Codex、Claude Code 或 OpenCode 的推理能力，只负责承载协作协议、可靠投递和可重放状态真相。

10
核心 Intent
6
系统组件
1
本地单机 v1
问题

多 agent 协作缺少统一任务语义

协作通道不统一

多个本地 agent 窗口主要靠聊天与复制粘贴，没有稳定的任务协作面。

断线即失去上下文

如果只依赖实时连接，关键任务和审批上下文在断线或窗口关闭后难以恢复。

任务语义过弱

现有“直接聊天”表达不了认领、澄清、进度、提交与审批的完整闭环。

v1 的目标 是先把“任务协作 + 审批”跑通，并且让关键事件可重放、可审计、可恢复。

产品定义

Broker 只负责协议与投递

Broker 要做什么

  • 接收、校验并落盘 intent 事件
  • 按 participant / role / capability / broadcast 路由到 inbox
  • 维护 task、thread、approval 的聚合视图
  • 提供 pull、ack、查询、重放接口

Broker 不做什么

  • 模型推理与 prompt 组织
  • shell、git、browser 等具体工具执行
  • 各家 agent 内部会话协议建模
  • 任意工作流 DSL 或云端身份体系
核心模型

五个核心对象构成协作骨架

Intent Participant Task Thread Approval
  • Participant 表示人或 agent 协作方。
  • Intent 是带结构骨架的协作动作。
  • Task 表示长生命周期工作对象。
  • Thread 用于挂载澄清、进度和交付上下文。
  • Approval 独立于任务状态存在，但会影响推进。
状态机

状态由 intent 事件聚合生成

Task 状态链

01

open
收到任务请求

02

assigned
确认执行者

03

in_progress
首次进度上报

04

submitted
提交结果待确认

05

completed
确认完成

Approval 状态链

  • pending：收到 request_approval 后创建
  • approved / rejected：respond_approval 推进
  • expired：broker 根据 TTL 自动失效
  • cancelled：审批失效或任务取消

约束： `completed` 不直接回退到 `in_progress`，返工要开 follow-up task。

可靠性

先落事件，再投递 inbox

POST /intents event-store router inbox + cursor WS notify HTTP pull
  • SQLite 事件日志是事实源。
  • 每个 participant 有独立 inbox 与 cursor。
  • 至少一次投递，客户端用 `intent_id` / `event_id` 幂等去重。
  • 断线不会改变任务状态，只影响是否收到实时提醒。
架构与 API

六个组件围绕 event-store 协作

组件分层

  • broker-server：本地 HTTP / WebSocket 接口面
  • event-store：SQLite append-only 事件存储
  • projection-engine：派生 TaskView / ApprovalView / ThreadTimeline
  • router：participant / role / capability / broadcast 路由
  • policy-layer：审批、TTL、认领模式等本地策略
  • client-adapters：适配 Codex / Claude Code / OpenCode

最小 API 面

接口用途
POST /intents接收协作动作
GET /inbox/{participant}拉取待消费事件
POST /inbox/{participant}/ack确认消费
GET /tasks/{task_id}读取任务聚合视图
GET /events/replay事件重放与审计
验证与下一步

先验证闭环，再扩展远程化与 UI

v1 验证清单

  • 协议单测：解析、校验、幂等、状态推进
  • 路由测试：点对点、角色、能力、广播
  • 可靠性测试：先写事件、重连补拉、重复 ack
  • 集成测试：human 发起到 approval 完成整条任务流

一句话结论

Intent Broker 不是聊天系统，也不是工作流巨兽，而是一个把多 agent 与人类协作升级为 可重放、可审计、可恢复 本地基础设施的协议中间层。

建议下一步： 直接按 v1 的事件模型与 HTTP pull 主消费模式做第一版实现，先证明闭环，再做远程化与更细粒度策略扩展。