EvoClaw — 设计图

stateDiagram-v2 [*] --> RECEIVED RECEIVED --> PLANNING: 解析成功 RECEIVED --> FAILED: 解析失败 或 权限拒绝 或 预算用尽 PLANNING --> TOOL_EXECUTING: 计划就绪 PLANNING --> AWAITING_USER: 关键参数缺失 TOOL_EXECUTING --> OBSERVING: 工具返回 OBSERVING --> TOOL_EXECUTING: 仍有未完成步骤 OBSERVING --> AWAITING_USER: 高危 或 歧义 OBSERVING --> REFLECTING: 计划完成 AWAITING_USER --> TOOL_EXECUTING: 用户批准 AWAITING_USER --> FAILED: 用户拒绝 或 超时 10min REFLECTING --> DISTILLING: success true REFLECTING --> FAILED: success false DISTILLING --> COMPLETED: 写回 skill plus memory COMPLETED --> ARCHIVED: T plus 30 天 FAILED --> ARCHIVED: T plus 30 天 ARCHIVED --> [*]

stateDiagram-v2 [*] --> L3_RECENT: 任务结束写入 L3_RECENT --> L4_SKILL: 蒸馏成 skill L3_RECENT --> L5_ARCHIVE: 90 天未读且无 skill L3_RECENT --> GC: confidence 低于 0.2 且 60 天未读 L4_SKILL --> L5_ARCHIVE: 关联 skill 进入 ARCHIVED L4_SKILL --> GC: confidence 低于 0.2 且 60 天未读 L5_ARCHIVE --> GC: 365 天 且 confidence 低于 0.2 L0_PERM: L0 核心规则永久 L1_PREF: L1 用户偏好仅用户撤销时删 L2_ENV: L2 环境事实 90 天 或 doctor 续期 L2_ENV --> L1_PREF: 用户提升为偏好 GC --> [*]

erDiagram TASK ||--o{ TOOL_CALL : invokes TASK ||--|| REFLECTION : produces TASK ||--o{ AUDIT_EVENT : emits TASK ||--o{ COST_EVENT : accrues REFLECTION ||--o{ SKILL : creates_or_updates REFLECTION ||--|| MEMORY_L3 : writes SKILL ||--o{ SKILL_VERSION : versions SKILL ||--o{ FAILURE_PATTERN : records SKILL ||--o{ MEMORY_L4 : linked_to MEMORY_L3 ||--o| MEMORY_L4 : distill_into MEMORY_L3 ||--o| MEMORY_L5 : archive MEMORY_L4 ||--o| MEMORY_L5 : archive_when_skill_archived AUTH_RECORD ||--o{ TOOL_CALL : authorizes CHANNEL_SENDER ||--o{ TASK : originates POLICY_RULE ||--o{ AUDIT_EVENT : evaluates VAULT_ENTRY ||--o{ AUDIT_EVENT : substituted_in TASK { string task_id PK string user_input_safe string source string selected_model string state string started_at string finished_at } SKILL { string id PK string kind int version float score string state string created_from_task FK } MEMORY_L3 { string id PK string content float confidence string ts string source } VAULT_ENTRY { string name PK string value_redacted string kind string fingerprint string created_at }

sequenceDiagram autonumber participant U as 用户 participant CLI as evoclaw CLI participant RED as Redactor participant RT as ConversationRuntime participant PROV as Provider participant TOOL as Tool Registry participant SK as Skill Tree participant MEM as Memory participant LOG as JSONL Log U->>CLI: 输入任务 CLI->>RED: scrub user_input RED-->>CLI: user_input_safe CLI->>RT: run(user_input_safe) RT->>LOG: 写 Task 记录 loop 直到不再请求工具 RT->>PROV: stream(messages, tools) PROV-->>RT: assistant_text + tool_calls RT->>RED: scrub assistant_text 与 args RED-->>RT: scrubbed alt 有工具调用 RT->>TOOL: invoke(call) TOOL-->>RT: result RT->>RED: scrub result RED-->>RT: result_safe RT->>LOG: 写 Turn 记录 end end RT->>PROV: 反思回合 PROV-->>RT: ReflectionRecord RT->>SK: 蒸馏 + upsert skill RT->>MEM: 写 L3 记录 RT->>LOG: 写 End 记录 RT-->>CLI: final_text CLI-->>U: 输出

sequenceDiagram autonumber participant U as 用户 participant RT as ConversationRuntime participant AP as AcpProvider participant CHILD as 外部 CLI participant LOG as JSONL Log U->>RT: run(user_input_safe) RT->>AP: stream(req) AP->>CHILD: spawn claude --acp AP->>CHILD: initialize 握手 CHILD-->>AP: serverInfo AP->>CHILD: session/new CHILD-->>AP: session_id AP->>CHILD: session/prompt(text) CHILD-->>AP: 最终文本 AP-->>RT: stream events RT->>LOG: 写 Turn 与 End Note over CHILD: kill_on_drop true 自动 reap 子进程

sequenceDiagram autonumber participant RT as ConversationRuntime participant TR as ToolRegistry participant W as McpToolWrapper participant SRV as MCP Server participant LOG as JSONL Log Note over TR: install_all 启动期 spawn 每个 server TR->>W: 注册 mcp_github_list_issues RT->>TR: invoke(mcp_github_list_issues, args) TR->>W: run(ctx, args) W->>SRV: tools call name args SRV-->>W: ToolCallResult content isError W-->>TR: 渲染后的文本 TR-->>RT: scrubbed result RT->>LOG: 写 Turn

flowchart LR classDef p0 fill:#0f3a2a,stroke:#34d399,color:#fff classDef p1 fill:#0f3a44,stroke:#22d3ee,color:#fff classDef p2 fill:#1a2f4a,stroke:#5fb3ff,color:#fff classDef p3 fill:#2a1f4a,stroke:#a78bfa,color:#fff classDef p4 fill:#3a2f0a,stroke:#facc15,color:#fff classDef p5 fill:#3a210a,stroke:#fb923c,color:#fff classDef p6 fill:#3a1414,stroke:#f87171,color:#fff classDef p7 fill:#3a1424,stroke:#ec4899,color:#fff classDef p8 fill:#1a0014,stroke:#ec4899,color:#fff P0[P0 只读 read_file list_dir ask_user]:::p0 P1[P1 workspace 写 write_file patch_file]:::p1 P2[P2 本地安全 shell run_shell]:::p2 P3[P3 网络 web_fetch 与 MCP]:::p3 P4[P4 渠道封顶 浏览器类操作]:::p4 P5[P5 用户目录写]:::p5 P6[P6 系统修改]:::p6 P7[P7 凭证操作]:::p7 P8[P8 生产环境]:::p8 P0 --> P1 --> P2 --> P3 --> P4 --> P5 --> P6 --> P7 --> P8