读法：每张卡 = 一个能力 / 推迟项；推迟项标注 触发条件（什么时候会重新排期）。点上方标签按阶段筛选。完整描述与影响分析见仓库 docs/design/roadmap.md。
v2 已完成
✓ SHIPPED v2.0 GA · 2026-05-24v2 周期（P8–P12）落地的核心能力，按 ADR landscape 归类。
Worker enroll 轻量化
bootstrap-token exchange 流；终端一行命令完成 enroll。 ADR-0023
AgentInstance 一等公民化
worker 上的 agent 实例升为独立 AR，可独立配置 + 监控。 ADR-0024
Supervisor 即内建 AgentInstance
supervisor 走同一套 lifecycle（amend 0024）。 ADR-0029
agent:create = G1 CLI Endpoint
通过 CLI 创建 agent，不走 supervisor 协议。 ADR-0025
AgentAdapter 矩阵扩展
claudecode + codex + opencode 三 adapter。 ADR-0030
MCP per-agent 注入
MCPInjectionService 在 worker daemon 侧按 agent 注入。 ADR-0027
Skill File Mount (lite)
supervisor.md 等 skill 走 file mount。 ADR-0028
SecretManagement BC
UserSecret AR + master-key AES-256 加密 + 明文永不回显。 ADR-0026
Channel 一等公民 + schema reset
channel 升一等 + Conversation v2 schema。 ADR-0032
Identity 模型重构
4→3 kinds + kind:id 前缀。 ADR-0033
Conversation Participants 字段
会话参与者显式建模。 ADR-0034
跨 Conversation 消息接力 (CV3)
message carry-over 跨会话。 ADR-0035
从消息派生 Issue/Task (CV4)
选中消息 → 开 Issue / Task。 ADR-0036
Conversation 业务模型 v2 统一
supersedes 0017/0021/0022。 ADR-0039
Web Console 即 v2 用户主入口
React SPA + SSE + 13 页覆盖 channel/DM/issue/task/agent/secret/IR/fleet；go:embed 进单 binary。 ADR-0037
CLI UX 增强
--format=table|json|text 统一 + 分组 help + topic 索引。 ADR-0038
v2 撤回 Bridge / Vendor 集成
v1 飞书 / 钉钉 / Bridge BC 撤回；v2 仅 loopback Web Console。 ADR-0031
v2.1 backlog
◷ QUEUED post-GA 小项显式 defer 到 v2.1 的小项；权威清单见 docs/plans/v2.1-backlog.md。
Unread message tracking
channel / DM 列表显示未读角标；需 user_conversation_read_state 表 + endpoints + SSE 事件。估算 ~6h · v2.8 已实现（#268/#264 P1）
SPA 覆盖率收尾
web 行覆盖 98.6% → 100%。估算 ~1h · post-GA hardening
v2.8 已完成 · 会话页 UX + 工具显示 + 富文本
✓ SHIPPED v2.8 · 2026-06-06 · 12 PR ship chain (0 production-affecting finding)v2.8 周期一日交付：(1) 会话页 UX 主体 + (2) 全局工作项侧栏 + (3) 测试实例工具 + 5 piggyback 件（agent 归档 epic / Worker 详情页 / Activity epic / markdown 渲染 / #/@ picker）。验收报告 docs/release/v2.8-acceptance-report.md + consolidated runtime evidence。
4-surface 统一架构
channel / DM / task 线程 / issue 线程 4 个会话面统一切到 ConversationView 外壳 + 已读游标 + SSE。PR #182 · e8f9b5c
未读 badge + @mention 红数字
侧栏会话名旁显未读数 + 红 mention badge（≤99+）+ aria-label SR 可读 · 非纯色。PR #182 / #268 后端
关注 toggle (Follow)
频道 / DM 头 + 工单 banner 可关注 / 取消关注。PR #182
跨频道工作项一处看
左侧全局 sidebar 含 Issues + Tasks + assignee 列 + 跨频道聚合。PR #156 / #258
install test-instance --with-agent
一键起含真 claude-opus-4-8 agent 的测试 instance（prod 零足迹 · 同机 dev 友好）。#261 / #257 phase 1
agent 归档后端
soft archive 软删 + agent 行保留 + 释放 worker binding + hard-delete 改 admin-only + 严格两步（running → 409 must-stop-first）。PR #181 · #272
agent 4 button 全图标 + 二次确认
start / stop / restart / archive 全 SVG icon + 破坏性操作 ConfirmModal + #271 Start 偶发回文字 bug 修 + ESLint guard 防回退。PR #183 · #270
(archived) chip 渲染
agent 归档后任务列表显 "(archived)" 标识 · 嵌套字段 assignee.assignee_lifecycle。PR #184/#185 后端 DTO + 前端 chip
WorkerDetail 4-tab
Profile（5 真字段 + 5 v2.9 占位）+ Bound Agents（重启 + Open + in-UI hint）+ Management（rename / Install / Re-mint / Remove + bound-agent 警示）+ Activity placeholder。PR #190 · #273
useTablistKeyboard 共享 hook
WAI-ARIA tab 键盘导航：箭头键 roving-tabindex + Enter/Space 激活（manual activation 防 async tab 触发风暴）+ 回写 #228 AgentDetail。institutional
Activity 翻页后端
cursor-based pagination + (a) presence-check + 并发 append 闸 + ULID DESC 稳定单调。PR #186 · #274 backend
Load older + Checking 折叠
"Load older" 按钮翻历史 + 连续 "Checking messages" 自动折叠 + 跨 Load-older 页边界 re-group 不裂。PR #188 · #274 frontend part 1
Tool 富渲染 SVG icon
CAT_TOOL_USE / CAT_TOOL_RESULT 显工具名 + 参数 + ✓/✗ 状态 + 内联输出折叠（复用 CollapsibleCodeBlock）+ SVG icon（非 emoji）+ not-color-only。PR #189 · #274 frontend part 2
完整 markdown + GFM
react-markdown + remark-gfm（表格 / task list / strikethrough / autolink）。PR #187 · #276
XSS 严格 escape
no rehype-raw 原始 HTML 不渲染 + urlTransform 拦 javascript:/data: scheme + link rel="noopener noreferrer"。Tester2 真注入 <script>/onerror/javascript: 全 neutralize。安全 red-line · @oopslink 拍 Q-A1=(i)
CollapsibleCodeBlock 共组件 13 a11y locks
code >20 行自动折叠 + 前 5 行预览 + "Show N more lines" + copy 复全量 + 语言 badge + 双向 expand/collapse + aria-controls by useId（多实例不碰撞）+ aria-live="off" 防 SR 念全文 + WCAG 兄弟非嵌套 disclosure。PR #187 · 13 lock institutional
ARIA combobox 写消息补全
输 @ 弹人 / 输 # 弹频道 + ↑↓ active + Enter 插 + Esc 关 + email 不误触发 + 全键盘 + aria-activedescendant by stable option-id。PR #192 · #275
插入 token + trailing space
选完插 @<name> / #<channel-name> + 尾随空格 + cursor 落空格后 = wake word-boundary 真触（@Bob ✓ / @Bobxyz ✗）+ 零后端改。PR #192 · word-boundary lock
选项 hover-only id
option 可见 = 仅名字 + full id 仅 hover/title 显（#192 chrome 对齐）。PR #193 · runtime fix
0 production-affecting finding
跨 12 PR ship chain + 2 follow-up（cleanup + runtime fix），全程零 production finding · 15 instances pattern proven · consolidated runtime 7/7 + 7/7 PASS direct on shipped。institutional discipline
v2.8.1 已完成 · Web Console UX 大改版 + 派发可靠性
✓ SHIPPED v2.8.1 · 2026-06-10 · 65 PR · 三面验收（产品 / 后端 / 前端）v2.8 架构线上的 UX 点发布：8 个界面改版 + 编辑收敛 + 两个列表增强 + 根治 agent 派发单活竞态。验收报告 docs/release/evidence/v2.8.1-acceptance-report.md（每验收点内嵌截图证据）。
Task & Issue 详情统一编辑
详情侧栏只读、编辑统一进单一 Edit 面板（去逐字段行内编辑）；Issue 详情对齐 Task 详情风格。#250 / #252 · #257
聊天 / DM UX 刷新
消息行 / DM 布局 / 代码块宽度 / 输入框重做 + Channels / Agents / Settings 视觉过一遍 · 对比度(AA) 深浅两模式验。8 改版
@提及 / 头像弹详情侧栏
点消息里 @ 的 agent / human、或 DM 头像，弹对应详情侧栏（按 kind 分流）。#258
Channels & Agents 列表
Channels 行加创建时间 + 参与者头像 + 最近消息预览；Agents 行加供应商(CLI/model) + 最后活动时间与内容。#255 list-enrich · #251 Issue batch-update
单活竞态根治
activate 路径原是非原子 check-then-act + 部分（非唯一）索引，并发派同一 agent 会产生多个活跃工作项。改 pull model + UNIQUE 部分索引（agent_work_items(agent_id) WHERE status IN active/waiting_input）+ queue-not-drop：一个 agent 同时只有一个活跃工作项。#277 / #278
v2.7+ 身份 / 认证进阶
→ PLANNED post v2.6v2.6 引入 Identity BC + Organization + Member + 基础 passcode + JWT cookie auth。下列条目在 v2.6 周期被明确「近期不做」（2026-05-27 决策），等 v2.6 ratify 后再排具体周期。
Email 注册 + 验证
signup 加 email 字段 + 验证邮件 + 未验证限权。触发：第二个真实用户 / 远程访问 / 需 password reset
Password Reset / Recovery
忘记 passcode 经 email 重置；账号 / 2FA 恢复路径。触发：Email 上线 + 多用户
2FA（TOTP / Email Code）
TOTP authenticator 或 email 一次性码二次验证。触发：账号承载共享 Org 资源 / 远程被滥用风险
SSO（Google / GitHub / SAML）
外部 IdP 一键登录，跳过 passcode。触发：企业 / 团队场景
PAT / API Token
带 scope / 限定 Org / 可 revoke 的程序化访问 token。触发：脚本调 API / CI·CD 集成
Account Switcher
同浏览器多 Identity，顶 bar 切换（Google 多账号模式）。触发：一机多角色（个人 + 工作）
ABAC 细粒度权限
channel / project / agent 级授权，超 owner/admin/member 三档 RBAC。触发：需"某 channel 仅特定成员可写"等
Refresh Token + 远程登出
JWT refresh + 其它设备登出 + session 列表。触发：跨设备使用 / 安全事件
失败登录锁定 / 异常检测
连续失败触发 lockout；IP / 设备指纹异常检测。触发：公网暴露后
Events organization_id 反范式列
events 表加直接列加速跨 Org 审计查询。触发：事件量增长、审计查询慢
Organization 硬删除（Purge）
UI 永久删除 Org 并清空数据。触发：UI 自助永久清理 / 合规"被遗忘权"
Identity 自助注销
/me 页 "Delete my account"，受最小 owner invariant 守门。触发：主动注销 + transfer ownership 完整
v2.9 待做（deferred-with-pointer）
→ PLANNED post v2.8 · 源于 v2.8 周期显式 defer 的 epicv2.8 周期为遵守 epic 不切碎纪律 + T-9 不空挂原则，将以下能力显式 defer 到 v2.9，每条已在 v2.8 ship code 中标注 "Coming v2.9" 占位 + ADR/PR pointer。v2.8.1 hotfix 周期 ship D pull-model + race fix 后，v2.9 头号特性增 agent memory directory（CLI-agnostic）+ ad-hoc thread。
⭐ Agent memory directory (CLI-agnostic)
v2.9 头号特性（@oopslink 2026-06-07 拍）。agent 自己 home/data dir 下 /memory/ 子目录：MEMORY.md 索引 + notes/（user-preferences / project-context / work-log）+ tasks/<id>/（plan / progress）。agent 自律 maintain（read on boot + update during work + write on complete）。跨 CLI portable：claude / codex / opencode 通用，不绑 claude-code session.jsonl 特定格式。CLI 切换不丢 memory。v2.8.1 替代：DB agent_work_items active WI query + claude-code session resume（v2.7 #216 supervisor reattach）= 两层 memory 联合，够用 for D pull-model ship · v2.9 epic：memory dir + agent prompt 改造（read/write memory）+ 跨 CLI 一致性 + DB 与 memory 关系明确（DB authoritative, memory advisory）
⭐ Custom avatar upload
v2.9 重要特性（@oopslink 2026-06-07 12:42 拍 Phase A=v2.8.1 / Phase B=v2.9 phased）。v2.8.1 Phase A = 自动 initials avatar（display_name 首字符 + user_id 哈希派生稳定 color，无 storage cost）覆盖立即视觉。v2.9 Phase B = 用户可上传 custom avatar 替换 initials。v2.8.1 Phase A：Initials avatar (Dev2 polish, ~3-4hr) — round 32-40px + hash-deterministic color + a11y aria-label · v2.9 Phase B：(1) DB migration identity.avatar_url/avatar_id field · (2) Admin upload endpoint via Files BC（图片裁剪/Profile edit modal/removal）· (3) Phase A initials 保留作 fallback · (4) Agent profile slock-style pixel avatar option
⭐ Ad-hoc thread (Slack-style)
v2.9 重要特性（@oopslink 2026-06-07 拍）。在 channel / DM 任意 message 上起 ad-hoc thread（Slack 模式 "Reply in Thread"）。系统底层 parent_conversation_id 数据模型已存在（v2.7 整改时 task-thread / issue-thread 自动 thread 通过同套字段实现），仅 API + UX surface 未暴露。v2.8 现状：系统级 thread (per-Task / per-Issue) auto-created（用 ParentConversationID），用户级 ad-hoc thread on channel/DM 未实现 · v2.9 epic：(1) 新 admin/api endpoint POST /conversations/{id}/threads off message · (2) Frontend ConversationView 加 thread 入口 UI + thread side panel · (3) follow-state auto-follow on engage（已实现，复用）· (4) MCP start_thread(parent_msg_id) + agent 看 thread 也能区分参与
Worker info reporting
Worker 详情页 Profile 缺 5 字段（hostname / OS / arch / agent-center binary version / install path）无后端源；workforce.Worker 实体 + worker 端上报路径未做。v2.8 占位：Profile 5 真字段 + 5 "Coming v2.9" · v2.9 epic：worker enroll 时上报 + workforce schema + DTO 扩
Worker removal cascade / unbind
v2.8 DELETE /workers/{id} = silent orphan（bound agent worker_id 悬空保留，availability 降 unavailable 不崩）；无 unbind/rebind endpoint。v2.8 替代：Restart + Archive-via-AgentDetail + in-UI hint · v2.9 epic：cascade（worker 删 → bound-agent auto-archive / unbind/rebind option）
Task → agent work-items 关联 view
v2.8.1 5th Phabricator-style Task detail refactor 时 @oopslink mockup spec 含 "WorkItems summary" sidebar (N Paused/Running/Pending/Done) but 系统无 task → 子-work-items 数据源 (Dev2 grounded 2026-06-07 18:20)。v2.8.1 5th defer 此 sidebar slot。v2.8.1 status：5th Task detail sidebar 不含 WorkItems summary slot (clean ship) · v2.9 epic：(1) 新后端 API GET /tasks/<id>/related-agent-work-items (aggregate agent work items dispatched for this task) · (2) Task detail sidebar 显聚合 status counts · low-pri candidate (data exposure 需求驱动)
富块 blocks[] / 结构化卡片 (DM redesign D)
v2.8 评估后 @oopslink 拍 "block 不引入"（agent 工具调用走 Activity 路径 / 长 code 折叠靠 markdown 派生 + CollapsibleCodeBlock）。v2.8.1 DM redesign 重启讨论（@oopslink 2026-06-07 12:46 拍）：聊天页结构化卡片需求（GitHub Pages 发布结果含状态码表格、部署详情 chips、deploy 耗时标签）超出 markdown 表达力。v2.8.1 status：仅 A+B+C ship (Layout + Composer + Avatar)，D 结构化卡片 defer · v2.9 discussion 路径: (d1) blocks[] 系统（agent emit JSON blocks + FE 渲染卡片，Slack blocks API 模式）/ (d2) Markdown 模式识别 + 卡片模板（FE 启发式 detect, 易碎）/ (d3) Tool-call / Activity 路径（agent 调 tool + FE 渲染 tool result with custom card, 与 #274 一致） · Artifact promote 方向（a/b/c/d）一并讨论
Mention id-based format (option B)
v2.8 picker 插的 @<name> 文本 token rename-fragile（改名后旧消息显 stale name，同 Slack/Discord）。v2.9 epic：id-bearing token @<id> + 改 mention.Present matcher（read_state.go:294 + wake_projector.go:509）
Worker Activity tab
v2.8 占位 "Coming v2.9"（无 GET /api/workers/{id}/activity endpoint）。v2.9 epic：worker 端事件流（与 worker-info-reporting 同 epic candidate）
Mention friendly-handle @username
v2.8 picker 选项 hover-only 裸 id 对齐 #192 chrome standard；MemberResult 无保证 handle。v2.9 epic：从 email 或 user-set 派生 stable @handle 作可见 secondary
v3 推迟 · 长期愿景
∞ DEFERRED v3+ 周期需要重新设计或跨度过大的能力，系统性放到 v3 做。完整影响分析见源文档。
外部 IM / 渠道接入（重新设计）
v2 撤回 vendor 集成（ADR-0031）；v3+ 整体重做 transport / Identity binding / 路由架构。触发：非 Web Console 入口需求
Remote CLI
从笔记本直接 agent-center query --remote=vps，免 SSH。触发：SSH-to-VPS 频次高
Token cost 折算成钱
已统计 token 数，v3 折算成 RMB / USD。触发：需监控月度花销
Per-project 限定 agent CLI
项目声明 allowed_agent_clis 限制可跑 CLI。触发：项目级合规 / CLI 偏好
AgentImage 模型 + Memory git 化
agent 本体打成不可变镜像（tag/digest）经 registry 分发；数据走独立 git 仓，本体与数据分开版本化。触发：跨机/跨用户分发模板 / agent 类型过多
云 Computer 节点支持
Worker 从"开发机 daemon"扩展为可注册算力节点（含云节点），按需拉起。触发：临时跑大量 agent / 本地算力不足
Web 时间轴可视化（flamegraph）
Honeycomb / Jaeger 风格横向时间轴 + flamegraph 专做 trace 可视化。触发：嵌套 tool calls 几百条难诊断
Task / Execution 模型扩展
父子状态联动、ETA-trigger 唤醒、per-project timeout/workspace/retry 覆盖、Issue reopen amend、复杂 Artifact 维度。ADR-0010 两层模型之外
派单可靠性进阶
完整 fencing token、cross-worker fail-over、--force-abandon、envelope budget、worker quarantine / drain。ADR-0011 之外
Supervisor / Cognition 进阶
自动重试、cross-invocation 协调、Memory 并发锁 / 聚合查询 / 体积告警、显式 pending 状态、多 supervisor 跨机。ADR-0012/0013 之外
Conversation 模型扩展
拆分 kind 两轴（受众 scope vs attached_to）、复杂多 channel 嵌套。触发：规模化 / 多 vendor 接入
Workspace 模式进阶
readonly mount 强制、fixed-path 模式、多路径 workspace。触发：agent 自律不够 / 跨多目录
Observability 进阶
实时 stream timeline（-f）、全文搜 events、跨 event 关联推断。
性能优化
启动 <5s、enroll <1s、send→SSE <500ms、万级 events index、bundle 拆分、SSE 吞吐。v2 P12 决策 · GA 不卡 baseline
DAG 任务依赖高级特性
cascade abandon、OR/conditional 依赖、DAG 可视化、拓扑排序自动派单。基础 deps 已有
Supervisor 自动收敛 Issue
低风险 / 高置信场景自动 conclude，不必每次推用户。触发：决策信任建立 / 某类 Issue 采纳率 100%
Agent 主动加入 Issue 讨论
worker agent 直接在 Issue thread 发评论，不只 supervisor 间接参与。触发：明确场景需 agent 直接表态
容器化 agent 执行
每个 task 跑隔离容器（替代 / 叠加 worktree）。触发：跑不信任代码 / 资源限制
Prometheus / OTel / Grafana 接入
events / metrics 导出时序库 + 看板。触发：需 P99 / 失败率 / 利用率看板
Per-project 自定义观测维度
项目按"扩展点规范"声明额外 trace 维度 / metric，不侵入观测层代码。触发：多项目共性额外维度
Deployment as Product
把部署从 ops 脚本升级为一级产品主题：DDD 框架 / ADR / phase plan / Linux guide / Docker / CI·release / diagnose 工具。v3 既定主题（2026-05-25 决策）
多用户 / SaaS
多用户共享实例 / SaaS 运营 —— 基本是重做认证·权限·隔离·计费·运维。触发：极远 · 个人工具被验证后
团队模版功能
预定义"标准团队配置"（含哪几种 agent + channel + role + 关系），用户一键 instantiate 完整团队 setup，不必逐个 agent / channel 手动创建。触发：用户多次手动创建相似 team / 多项目共享标准 team · 2026-06-06 @oopslink 提出
// 源：docs/design/roadmap.md · 边界（不做）见 requirements/03-out-of-scope.md