文件	说明
`README.md`	总览、阶段关系、实施顺序、当前状态
`phase-0-current-state-and-target.md`	当前现状、问题、目标架构、ADR
`phase-1-safe-foundation.md`	基础设施加固阶段
`phase-2-controlled-collaboration.md`	受控协作阶段
`phase-3-dynamic-collaboration.md`	动态协作阶段
`phase-4-visibility-and-isolation.md`	可视化与隔离执行阶段
`phase-5-advanced-features.md`	高级特性(可选)
`phase-6-tool-system-refactoring.md`	工具系统重构
`phase-7-hook-interception-layer.md`	Hook 拦截层
`phase-8-plugin-ecosystem.md`	插件生态
`phase-9-skills-registry.md`	Skills 注册表
`phase-10-advanced-orchestration.md`	高级编排
`phase-r-rag-upgrade.md`	RAG 系统升级专项(VCPToolBox 借鉴)

当前总体状态（2026-04-04）

当前 Jarvis agent runtime 不再是“Phase 2/3/4 纯草案”，而是已经具备以下现实状态：

78 → 90 成熟度标尺

分数	含义	当前状态
75	受控协作基线：task/event/verifier/collaboration/dynamic guardrail 已稳定	已达到
85	visibility + verification 基线：phase/checkpoint、topology、evidence、runtime summary、operator 调试入口可用	基本达到
90	isolation runtime + cost governance + operator surface：会话/工作区隔离、成本阈值治理、前端可运营面板闭环	已达到
95+	full sandbox / persistence / realtime UI / advanced memory	明确延后

Phase	当前状态	说明
Phase 1	已落地	verifier、task/event schema、基础执行模式已存在
Phase 2	已实现基线	collaboration mode、task decomposition、owner、result collection、verifier 收尾已运行
Phase 3	已实现受限基线	parent/root/depth、spawn policy、budget、interrupt/recovery、事件链路已存在
Phase 4	已完成 90 分闭环	visibility API、isolation runtime MVP、cost governance MVP、operator/debug surface 已落地
Phase 5	未开始	保留为 full sandbox / persistence / realtime push 等可选增强
Phase 6	待开始	工具系统重构（对标 claw-code）
Phase 7	待开始	Hook 拦截层
Phase 8	待开始	插件生态
Phase 9	待开始	Skills 注册表
Phase 10	待开始	高级编排
Phase R	部分推进	RAG 升级按专项继续推进

本次新增落地

本次补齐了一个此前缺失但非常关键的层：

runtime 显式 phase model
runtime checkpoint model
phase / checkpoint history 持久化
phase / checkpoint event trace
对应自动化测试

新增后，当前 runtime 已可显式追踪：

current_phase
phase_history
current_checkpoint
checkpoint_history

并且会进入这些显式阶段：

phase_0_bootstrap
phase_1_routing
phase_2_controlled_collaboration
phase_3_dynamic_collaboration
phase_4_visibility_and_verification

总体升级原则

保持简单请求路径稳定 - Direct Mode 不受影响
复杂请求才启用协作模式 - Collaboration Mode 按需触发
执行与验证分离 - Verifier 作为独立角色
动态能力必须受约束 - Budget + Permission + Depth
所有升级都要配套测试 - 回归测试优先
优先做显式状态，不先做大拆分 - 先让运行时可观察、可验证，再抽模块
优先服务个人助手主线 - 先补记忆、会话、计划闭环、开发协作稳定性，再考虑平台化外壳

追加 checkpoint（按个人助手定位）

下面这些 checkpoint 比“做成通用开源 harness”更值得优先推进：

P0：必要升级点

Checkpoint A：会话连续性可靠
- conversation / session 重启后可恢复关键状态
- phase / checkpoint / active task / verifier summary 不丢失
- 降低“每次都要重新解释上下文”的成本
Checkpoint B：记忆系统可用且可控
- 用户偏好、项目背景、日常规划信息可稳定沉淀
- memory 写入有分类、检索、去重、更新机制
- 避免记忆污染、过期信息误用、重复记录
Checkpoint C：plan / daily / task 闭环打通
- 对话中识别出的行动项能沉淀到 plan / daily
- task 状态变化能反映到 daily 执行记录
- 支持“继续昨天未完成事项”的续做能力
Checkpoint D：开发协作稳定性提升
- 多文件读改查路径更稳
- tool 失败时有更清晰的恢复策略
- 常见开发任务（解释/修改/调试/重构）成功率优先于花哨能力
Checkpoint E：后台任务与自动化可靠
- 后台任务状态可追踪、失败原因可定位
- 定时任务/异步任务不易丢失
- background manager / scheduler 路径优先做稳定性修补

P1：有价值但可后置

verifier 更强的证据链能力
team / 多 agent 协作体验优化
更细的 tool governance 与 operator drilldown
更好的 RAG / 长短期知识组织

P2：可明显推后

通用 CLI / REPL 产品壳
面向外部的插件生态/市场
平台级 OAuth / 多租户 / 对外服务化
完整对标 claw-code-main 的通用 harness 外层

阶段关系图（按真实状态修订）

Phase 0 ──────────────────────────────────────────────────────────────┐
│ 现状与目标                                                           │
│ - 当前架构分析                                                        │
│ - Demo 借鉴映射                                                      │
│ - ADR 架构决策                                                       │
└────────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase 1 ──────────────────────────────────────────────────────────────┐
│ 基础设施加固 (Safe Foundation)                                        │
│ - verifier / schema / execution mode 基础                            │
│ 状态：已落地                                                          │
└────────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase 2 ──────────────────────────────────────────────────────────────┐
│ 受控协作 (Controlled Collaboration)                                   │
│ - collaboration mode                                                 │
│ - 任务拆解 / owner / 结果回收 / verifier                              │
│ - 当前已补 phase + checkpoint                                         │
│ 状态：已实现基线                                                      │
└────────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase 3 ──────────────────────────────────────────────────────────────┐
│ 动态协作 (Dynamic Collaboration)                                      │
│ - parent/root/depth tracking                                         │
│ - spawn policy + budget                                              │
│ - interrupt/recovery                                                 │
│ - phase + checkpoint trace                                           │
│ 状态：已实现受限基线                                                  │
└────────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase 4 ──────────────────────────────────────────────────────────────┐
│ 可视化与隔离 (Visibility + Isolation)                                 │
│ - visibility 查询 API                                                 │
│ - continuity snapshot 持久化                                          │
│ - isolation strategy 设计                                             │
│ 状态：最小闭环已完成                                                  │
└────────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase 5 ──────────────────────────────────────────────────────────────┐
│ 高级特性 (Advanced Features)                                          │
│ - full sandbox / persistence / cost monitoring / advanced UI         │
│ 状态：规划中，可选                                                    │
└────────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase 6 ──────────────────────────────────────────────────────────────┐
│ 工具系统重构 (Tool System Refactoring)                                 │
│ - ToolRegistry / HookExecutor / StreamingToolExecutor                 │
│ - 新增工具集：Glob/Grep/LSP/Bash/PowerShell/Cron                     │
│ 状态：待开始（对标 claw-code tools/）                                 │
└────────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase 7 ──────────────────────────────────────────────────────────────┐
│ Hook 拦截层 (Hook Interception Layer)                                 │
│ - PreTool/PostTool Hook 机制                                         │
│ - 危险操作确认 / 安全扫描 / 审计日志                                   │
│ 状态：待开始（依赖 Phase 6）                                          │
└────────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase 8 ──────────────────────────────────────────────────────────────┐
│ 插件生态 (Plugin Ecosystem)                                           │
│ - PluginManager / 生命周期管理 / 插件市场                             │
│ 状态：待开始（依赖 Phase 6, 7）                                       │
└────────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase 9 ──────────────────────────────────────────────────────────────┐
│ Skills 注册表 (Skills Registry)                                       │
│ - 动态 Skills 加载 / MCP Skill Builder / Bundled Skills               │
│ 状态：待开始（依赖 Phase 6）                                          │
└────────────────────────────────────────────────────────────────────┘
         │
         ▼
Phase 10 ─────────────────────────────────────────────────────────────┐
│ 高级编排 (Advanced Orchestration)                                      │
│ - Team Leader / Remote Transport / Session Manager / Background Tasks  │
│ 状态：待开始（对标 claw-code assistant/）                             │
└────────────────────────────────────────────────────────────────────┘

Demo 项目借鉴映射

Demo项目	主要借鉴点	对应 Phase
Swarm-IDE	Event trace、Dynamic Spawn、拓扑可视化	Phase 3, 4
Claude Code CLI	Coordinator-worker、Verifier 分离、Tool 权限	Phase 1, 2
Claw Code	Runtime 分层、Port Manifest、隔离策略	Phase 2, 4, 6, 7, 8, 9, 10
VCPToolBox	TagMemo V6、多索引、Token 感知分块	Phase R, Phase 5

Claw Code 详细对照

Claw Code 组件	Jarvis Phase	说明
`tools/`	Phase 6	工具注册表、分层执行
`StreamingToolExecutor`	Phase 6	流式工具执行
`toolHooks.ts`	Phase 7	Hook 拦截层
`PluginLifecycle`	Phase 8	插件生态
`skills/loadSkillsDir.ts`	Phase 9	Skills 注册表
`skills/bundledSkills.ts`	Phase 9	Bundled Skills
`assistant/sessionHistory.ts`	Phase 10	高级会话管理
`cli/structuredIO.ts`	Phase 10	结构化传输
`cli/remoteIO.ts`	Phase 10	远程传输

本次代码落点

本次 phase/checkpoint 补强主要修改：

backend/app/agents/state.py
backend/app/agents/graph.py
backend/app/agents/schemas/event.py
backend/app/services/agent_service.py
backend/tests/backend/app/agents/test_graph.py
backend/tests/backend/app/services/test_brain_ingestion.py

新增的关键事件

agent.phase.changed
agent.checkpoint.recorded

新增的关键持久化字段

current_phase
phase_history
current_checkpoint
checkpoint_history

当前仍未完成的内容

虽然能力已经明显前进，但下面这些仍属于后续工作：

工程结构层

独立 coordinator.py
独立 message_bus.py
独立 event_bus.py
dynamic/ 与 recovery/ 目录化拆分

Claw Code 差距（Phase 6-10）

Phase 6: 工具系统重构（ToolRegistry/HookExecutor/StreamingToolExecutor）
Phase 7: Hook 拦截层（PreTool/PostTool）
Phase 8: 插件生态（PluginManager/生命周期/市场）
Phase 9: Skills 注册表（动态加载/MCP Builder）
Phase 10: 高级编排（Team/Remote Transport/Session Manager）

平台能力层

full sandbox / persistence / realtime push
独立 coordinator.py / message_bus.py / event_bus.py
更完整的 operator drilldown 与实时推送
SSE / WebSocket 实时推送（延后）
sandbox container 执行器（延后）

当前阶段结论

目前最准确的说法不是：

“Jarvis 还在做 agent phase 规划。”

而是：

“Jarvis 已经具备多阶段 agent runtime 的核心基线，当前工作重点已经从‘是否可行’转向‘如何把已存在能力继续工程化、可视化、隔离化’。”

这也是后续测试、验收和继续升级的正确前提。

README.md Unescape Escape

Jarvis Agents 升级计划索引

文档说明