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 或云端身份体系

核心模型

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

- 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

- 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 主消费模式做第一版实现，先证明闭环，再做远程化与更细粒度策略扩展。