Skip to content

docs(v3): 真实会话集成仅 Claude Code（诚实标注）+ Codex 列明确 backlog（#12） #209

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
raysonmeng wants to merge 2 commits into
base: feat/v3-token-revoke
Choose a base branch
from
Open

docs(v3): 真实会话集成仅 Claude Code（诚实标注）+ Codex 列明确 backlog（#12） #209

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9d1d6e9
docs(v3): 诚实标注「真实会话集成仅 Claude Code」+ Codex/其它 agent 列明确 backlog（#12）
Jun 26, 2026
14d0305
docs(v3): 真三机跨网协作实测 runbook（HTML，自包含）
Jun 27, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions docs/09-v3协作系统规格.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -221,6 +221,16 @@ OpenCode / Kilo 最易（25+ 事件、插件模型）→ Claude Code 易（hooks

每个 agent 注册成各自的 logical agent id，归属到同一个 person。互不混淆。

### 5.5 实现状态（诚实标注，2026-06）

§5 是 adapter 的**设计契约（愿景）**，不是已交付清单。截至当前的真实状态：

- **已 ship 的真实会话集成 = 仅 Claude Code**：room-bridge 把房间事件注入活 Claude session（MCP 推送通道），Stop hook 发布完成事件（「最后一公里」）。这是目前唯一端到端打通「收事件进 session + 检测完成并发布」的 agent。
- **控制面 agent-无关**：broker / room / 身份 / presence / 路由 / 鉴权从不读 `agentType`——任何讲 Envelope 协议、持 broker 签发 PSK token 的进程都是合法房间成员（headless 替身、脚本、其它 agent 都能连上并收发事件，§13 Docker 验收即用替身证过控制面协议）。
- **Codex**：有 v1 单机 Claude↔Codex 桥，但**未接进 v3 房间流**——§5.2 的三件套（register / publish-on-completion / receive-into-session）尚未对 Codex 实现。
- **其它 agent（OpenCode / Cursor / Kilo / …）**：协议层可接，§5.2 的薄 adapter **未做**。
- 这些都是**明确 backlog（"未做"），不是砍掉的范围**（对比 §10 的"明确不做"）。要让异构 agent 真正在同一房间里协作，需按 §5.2 给每个目标 agent 补齐这三件套。

---

## 6. 三个可替换接口与自带电池实现（Backbone 层）
Expand Down Expand Up @@ -403,6 +413,12 @@ broker 那台机器宕了，单实例必有不可用窗口。自带电池版做
- **B 的全自动调度 / session 上下文迁移**——演进层，MVP-B 只做半自动 offer/claim（§9.5）。
- **嵌入 Tailscale 库 / `tailscale serve` 暴露 WebSocket**——不做；靠系统级 Tailscale + 直连 `100.x`（§7）。

### 10.1 明确 backlog（"未做"，区别于上面"明确不做"）

> 上面是**有意砍掉/留作演进**的；这里是**应做但当前未做**的，列清避免假装已完成。

- **Codex / 其它 agent 的 v3 房间会话集成**——目前**仅 Claude Code** 接进了 v3 房间流（§5.5）。控制面 agent-无关，任何讲 Envelope + 持 PSK 的进程都能当房间成员；但「把房间事件推进活 session + 检测完成并发布」这层**每个 agent 的薄 adapter**只做了 Claude。Codex 有 v1 单机桥但未接 v3 房间流；其它 agent 协议层可接、会话集成未做。补法见 §5.2 三件套。

---

## 11. 三档演进路线
Expand Down
2 changes: 2 additions & 0 deletions docs/10-跨网部署与运维.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# 10. v3 跨网部署与运维（Tailscale 直连 + git 数据面）

> 定位：把 [09 规格](09-v3协作系统规格.md) §7（网络/鉴权）与 §2.6（控制面/数据面分离）的 **what**，落成可执行的 **how**。面向"想让两台以上机器、跨网协作"的运维者。代码连接层（`abg broker start` 绑可配 host、`AGENTBRIDGE_BROKER_URL` 连远端、PSK 握手）已就绪，本篇是接它的操作手册。
>
> **会话集成范围（诚实标注）**：v3 房间事件「自动推进活 session + 完成自动发布」目前**仅 Claude Code** 端到端打通（见 [09 §5.5](09-v3协作系统规格.md)）。控制面 agent-无关——任何持 PSK token 的进程都能当房间成员收发事件；但本手册里「agent 自动获知/自动发布」的体验当前以 **Claude Code 会话**为准。Codex 等其它 agent 的 v3 房间会话集成是明确 backlog（[09 §10.1](09-v3协作系统规格.md)）。

---

Expand Down
Loading