这是历史版本快照。当前架构以 v2.8 为准 →
前往「开发指引 · v2.8（当前版本）」。本页不重复完整的 DDD 设计，只保留 v2.7 概述、架构快照与 v2.7 → v2.7.1 变化对照（v2.7.1 → v2.8 演进见 v2.8 页 "v2.8 相对 v2.7.1 主要演进" 区块）。
A · v2.7 概述
v2.7（发布于 2026-06-03）落地了一次完整的领域重构：退役旧的 任务执行域（task-runtime）与讨论域（discussion）以及陈旧的 tasks/issues/projects schema，改以一组清晰的限界上下文重新划分整个系统。这是一次清库（clean-schema）发布——v2.6 → v2.7 不支持原地升级，需全新安装；carve-out 中移除了约 26,000 行历史代码。
重新划分的上下文
- 项目管理 ProjectManager——Project / Issue / Task，工作真相源。
- 智能体 Agent——Agent + 生命周期 + AgentWorkItem 控制流，真正执行任务的智能体端到端走专用工作项流。
- 环境 Environment——Worker / Agent supervisor / 文件传输会话（含 files / blobstore）。
- 会话 Conversation——统一的一套 URI 方案，贯穿 channel / DM / task / issue 四类会话。
- 可观测性 Observability（支撑域 · 只读）与 身份 Identity（共享内核）。
v2.7 同时交付的主要能力
- 智能体跨 worker 守护进程重启存活：每个智能体由 per-agent、detached 的 supervisor 托管；worker daemon 升级/重启不再打断运行中的智能体，断连后重新附着（survive-reattach），输出持久缓冲、ack-offset 状态跨重启保留；claude 进程真死则回退 Mode-B（reap-then-relaunch + session resume）。
- 实时控制：stream-first，poll fallback：start / stop / reset / work 控制命令走长连 SSE 控制流，喂同一条单调的
WorkerControlEvent日志；断连/心跳超时回退到按 offset 游标轮询，无重复无丢失（ADR-0050）。 - Worker 能力自动发现：每次
online探测本机已装的 agent CLI（claude-code / codex / opencode）并上报；--capabilities标志移除。运行时仅 claude-code 真正派发，codex / opencode 为 discovery-only。 - 会话附件：消息可端到端携带文件附件（经 files BC 上传、原子校验后 attach、按消息路由下载）；跨组织/不存在的 URI 在 attach 与 download 上返回字节级一致的
403，无存在性预言。 - Web Console 重设计与可用的身份流：侧栏信息架构调整、Fleet 合入 Environment、首屏路由修正（未初始化 →
/signup）、每请求读取真实会话身份、消息发送者显示真实名称等。
详细发布说明见仓库
docs/release/v2.7.md（含升级注意事项、macOS 26 安装修复、被移除的 CLI 命令、以及「What's not in v2.7」的 v2.8 延期清单）。
B · 架构快照
v2.7 的领域模型与 v2.7.1 / v2.8 视图完全一致：五大限界上下文、detached supervisor + survive-reattach、SSE 优先 / 轮询回退的控制流、Conversation BC 与文件附件模型，跨 v2.7→v2.7.1→v2.8 均未变动（v2.8 在 v2.7.1 上叠加的会话页 4-surface 统一 / agent 软归档 / Worker 详情页 / markdown 渲染等是 UX + 战术层增量, 领域模型不变）。因此本页不重绘完整的三 Tab 设计图（限界上下文地图 / 战术设计 / Event Storming）。
权威架构视图请见当前页：
开发指引 · v2.8（当前版本） 中的
C · DDD 设计（以现行代码校准） 三 Tab 图，以及 B · 主要机制设计。这些视图同样适用于 v2.7——领域模型并未迁移。
限界上下文一览
- 项目管理 ProjectManager（核心域 ·
internal/projectmanager）——Project / Issue / Task / Member，订阅真相。 - 智能体 Agent（核心域 ·
internal/agent）——Agent / AgentWorkItem / ActivityEvent，单活工作项不变式。 - 环境 Environment（核心域 · environment + workforce + files + blobstore）——Worker / AgentInstance / BootstrapToken / FileTransferSession / BlobStore。
- 会话 Conversation（核心域 ·
internal/conversation）——Conversation / Message（追加写），kind 恰 4 值：dm / channel / task / issue。 - 可观测性 Observability（支撑域 · 只读 · + outbox）——Event 追加写 + 投影读模型，纯下游消费者（OHS）。
- 身份 Identity（支撑域 · 真实 BC + 共享内核 ·
internal/identity）——Identity / Organization / Member / Invitation，另供 IdentityRef 共享词汇。 - SecretManagement（支撑域 ·
internal/secretmgmt）——UserSecret（每用户 API key）。
C · v2.7 → v2.7.1 变化
架构 / 领域模型无变化。v2.7 → v2.7.1 的 tag-to-tag 代码 diff 真实且不小（155 文件，+7,265 / −1,276），但每一项都是叠加在 v2.7 架构之上的增量特性、可运维性与 UX 抛光——没有任何限界上下文边界、聚合或核心机制被重画。文档层面 diff 极小：
docs/release/v2.7.md 是 v2.7.0 文档、未为 v2.7.1 改动，CHANGELOG 也没有独立的 [v2.7.1] 小节（两版同处单一 [Unreleased] 块，唯一 CHANGELOG delta 是 #211 多 center 安装的一条 Added）。
| 变化项 | 说明（均为增量 · 不改架构） |
|---|---|
组织内序列号 T<n> / I<n>#245 |
新增 migration 0049_v271_pm_org_sequence，按 (org,type) 的单调计数表（pm_org_sequence），竞态安全分配 + 回填，DTO 增 org_ref；让议题/任务有人类友好引用，取代 ULID 尾巴。 |
| 身份邮箱 + 最近会话 | migration 0048_v271_identity_email_last_session，为 identity 增 email / last-session 列。 |
| MCP 智能体自我 / 组织发现工具 #239 / #241 / #246 |
新增 get_my_profile、find_org_agent（返回可直接使用的 assignee_ref）、find_org_channel；精确区分 404 not-found / 403 not-a-member。β 只读，不改授权。 |
| worker 配置单一来源 #249 / #251 |
install worker 把全部 enroll 字段写入 config.yaml（0600），worker run 收敛为单个 --config=；token 不再出现在 ps / launchd plist / systemd unit 中。新增 WorkerConfig 结构；旧 flag 仍作覆盖，升级时迁移改写旧配置/单元。 |
| 单机多 center #211（CHANGELOG Added） |
install center --instance <name> → 独立前缀（~/.agent-center.<name>）+ 独立 launchd/systemd 标签 + 显式端口；新增 list-local-centers 与 server.instance 配置字段。仅全新安装。 |
升级比对 git commit 而非版本串 + --force#234 |
根因修复：同版本不同 commit 的重建也会重新安装。cli.SetInstallBuildCommit(buildCommit) 在 main.go 中贯通。 |
默认模型加固为 claude-opus-4-8#232 / #236 |
创建弹窗前端预填，后端创建处兜底强制（bulletproof floor）。 |
| Web Console UX 抛光 #238 / #240 / #250 / #253 / #247 / #242 / #228（文件改动主体） |
7 个详情页 Breadcrumb 导航 + 通用 <Breadcrumb> 组件；AgentDetail Stop/Restart/Reset 与 Message 按钮图标化（Reset 保留红色破坏性样式）；侧栏折叠图标简化为单笔 chevron（⌘B 不变）；频道 URL 改 hash id /channels/:channelId；表格化 ProjectDetail Issues/Tasks 与 AgentDetail WorkItems，Profile 模块 + Activity 时间线重做；在表格/详情/面包屑展示 T<n>/I<n> 引用。 |
结论：v2.7.1 是 v2.7 的纯增量演进。要查看与两版均一致的完整 DDD 架构、机制设计与三 Tab 图，请以 v2.8（当前版本） 页为准（v2.8 在 v2.7.1 基础上又演进了会话页 4-surface 统一、agent 软归档、Worker 详情页、markdown 渲染等，详见 v2.8 页演进 highlight 区块）。