每张图都在回答一个问题

flowchart LR
    subgraph UI_PLATFORMS["多端接入平面"]
        CLI["CLI REPL
cli.py"]
        TUI["TUI 界面
ui-tui/"]
        GW["20+ 消息网关
plugins/platforms/"]
        ACP["ACP 适配器
acp_adapter/entry.py"]
    end

    subgraph CTRL["控制平面 (Control Plane)"]
        AIA["AIAgent 实例
run_agent.py:400"]
        LOOP["ReAct 主循环
agent/conversation_loop.py:669"]
        COMP["上下文压缩器
agent/context_compressor.py"]
        CURATOR["Curator 后台策展
agent/curator.py"]
    end

    subgraph DATA["数据平面与存储 (Data & Storage)"]
        PROMPT["字节级稳定提示词三明治
agent/system_prompt.py"]
        SKILLS[("skills/ 技能库
SKILL.md 快照")]
        MEM[("MEMORY.md & USER.md
冻结快照 (memory_tool.py:9)")]
        FTS[("SQLite FTS5
session_search")]
    end

    subgraph EXEC["执行与 6 种后端 (5 种隔离 + local 裸跑)"]
        REGISTRY["工具注册表
tools/registry.py"]
        SANDBOX["6 种执行后端
local / docker / modal ..."]
    end

    CLI & TUI & GW & ACP -->|"输入分流"| AIA
    AIA --> LOOP
    LOOP -->|"1. 组装逐字节稳定 Prompt"| PROMPT
    PROMPT --- SKILLS
    PROMPT --- MEM
    LOOP -->|"2. 触发工具调用"| REGISTRY --> SANDBOX
    SANDBOX -->|"3. 结果追加 (Role=Tool)"| LOOP
    LOOP -.->|"4. 达到 50% 阈值触发压缩"| COMP
    CURATOR -.->|"5. 空闲时评审归档技能"| SKILLS

    classDef ctrlBox fill:#eef4ff,stroke:#4a6fa5,stroke-width:1.5px
    classDef ctrl fill:#d0e1fd,stroke:#1e88e5,stroke-width:2px
    classDef data fill:#f4fff0,stroke:#4a8f3c,stroke-width:2px
    classDef exec fill:#fff4ec,stroke:#4f46e5,stroke-width:2px
    
    class CTRL ctrlBox
    class AIA,LOOP,COMP,CURATOR ctrl
    class PROMPT data
    class REGISTRY,SANDBOX exec

    style SKILLS fill:#f4fff0,stroke:#4a8f3c,stroke-width:2px
    style MEM    fill:#f4fff0,stroke:#4a8f3c,stroke-width:2px
    style FTS    fill:#f4fff0,stroke:#4a8f3c,stroke-width:2px
    

flowchart LR
    W["Agent 调用 memory 工具写入"] --> DISK[("MEMORY.md / USER.md
磁盘持久化文件")]
    DISK -.->|"❌ 本会话刻意切断/不生效
修改提示词会破坏前缀缓存"| CUR["当前会话的系统提示词
(只读已冻结快照)"]
    DISK ==>|"✅ 下一个会话启动时
作为全新冻结快照注入"| NEXT["下一个会话的系统提示词"]

    classDef now fill:#ffebee,stroke:#c62828,stroke-width:2px
    classDef next fill:#e8f5e9,stroke:#2e7d32,stroke-width:2.5px
    classDef store fill:#fff8e1,stroke:#f57f17,stroke-width:2px
    class CUR now
    class NEXT next
    class DISK store
    

sequenceDiagram
    autonumber
    actor U as 用户 (Terminal User)
    participant R as src/screens/REPL.tsx
    participant H as src/utils/handlePromptSubmit.ts
    participant Q as src/query.ts & QueryEngine.ts
    participant C as src/constants/prompts.ts
    participant A as src/services/api/claude.ts
    participant P as src/utils/permissions/
    participant T as src/tools/ (43 个工具)

    U->>R: 敲击回车
    R->>H: 传递输入文本
    H->>H: 判定: 斜杠命令 / !shell / 普通消息
    H->>Q: 启动 queryLoop 主循环

    loop 每回合循环 (Per-Turn Loop)
        Q->>C: 重新组装上下文 (Prompts + CLAUDE.md + Git状态)
        C-->>Q: 交付全新 messages[] 数组
        Q->>A: SSE 流式请求 Anthropic API
        A-->>Q: 实时返回 Token 流及 tool_use 块
        
        alt 模型申请调用工具
            Q->>P: 提权裁决 (checkPermissions in Tool.ts:500)
            alt mode ∈ {bypassPermissions, dontAsk} 或命中已授权规则
                P-->>Q: 允许执行
            else 属于高危命令/未授权
                P->>R: 触发终端交互弹窗
                R->>U: 显示权限确认选项
                U-->>R: 选择 允许 / 拒绝 / 本次允许
                R-->>P: 返回用户判定结果
                P-->>Q: 交付最终许可状态
            end

            alt 许可通过
                Q->>T: 执行对应工具逻辑 (Bash / Edit / Read...)
                T-->>Q: 返回工具执行结果 (tool_result)
            else 许可拒绝
                P-->>Q: 返回拒绝提示信息
            end
            Note over Q: 将结果回流 append 进 messages[]，开启下一轮
        else 模型仅回复纯文本 (无 tool_use)
            Q-->>R: 输出回复文本，收敛并退出循环
        end
    end
    

flowchart LR
    subgraph BROWSER["① 渲染进程 (Web / Electron Renderer) · 无特权"]
        UI["Next.js 16 App Router + React 18
apps/web/src/"]
        VIEWER["FileViewer.tsx (660 KB)
沙箱 iframe 预览"]
    end

    subgraph SIDECAR["② SSR 侧车 · 低特权"]
        SSR["Next.js Server Sidecar
apps/web/"]
    end

    subgraph DAEMON["③ Daemon 主进程 · 唯一特权方"]
        SERVER["Express Server (绑 loopback)
apps/daemon/AGENTS.md:96"]
        DB[("better-sqlite3
projects · runs · conversations")]
        SYS_PROMPT["prompts/system.ts (2075 行)
20 层提示词组装入口"]
        DEFS["RuntimeAgentDef ×26
runtimes/defs/ (纯数据规格)"]
        GATE["出口质量闸门
lint-artifact & Design Jury"]
    end

    subgraph CLI_CHILD["④ 被 Spawn 的第三方 CLI · 独立子进程"]
        CLIS["claude / codex / cursor-agent / opencode ...
(共 26 条定义描述 25 个 CLI 二进制)"]
    end

    subgraph DISK["⑤ 项目 cwd 文件系统"]
        FS[("真实产物文件
HTML / PDF / PPTX / MP4")]
    end

    UI -->|"HTTP 请求"| SSR
    UI -->|"HTTP / SSE (Loopback)"| SERVER
    SERVER --- DB
    SERVER --> SYS_PROMPT
    SERVER -.->|"读取参数定义 (纯数据)"| DEFS
    DEFS -.->|"buildArgs() 纯函数
仅产出 argv 数组"| SERVER
    SERVER -->|"spawn(binary, argv)
唯一持有 spawn 权"| CLIS
    CLIS -->|"直接写盘 (产物不回传 Daemon)"| FS
    FS -.->|"事后读取进行校验"| GATE
    GATE -.->|"校验不合格重新触发"| SYS_PROMPT

    classDef privileged fill:#fff3e0,stroke:#e65100,stroke-width:2.5px
    classDef unprivileged fill:#e8eaf6,stroke:#283593,stroke-width:1.5px
    classDef third fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px,stroke-dasharray:4 3
    classDef storage fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px

    class DAEMON privileged
    class SERVER,SYS_PROMPT,GATE privileged
    class BROWSER,SIDECAR,UI,VIEWER,SSR unprivileged
    class CLI_CHILD,CLIS third
    class DISK storage
    class DEFS third

    style DB fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
    style FS fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
    

flowchart LR
    NEED["需求：接入第 26 个 CLI 运行引擎"] --> ASK{"要改什么？"}
    ASK -->|"❶ 数据扩展 (数据即适配器)"| D1["runtimes/registry.ts
往数组加一条 RuntimeAgentDef 字面量
改动半径 = 1 个文件 · 0 行新逻辑代码"]
    ASK -.->|"❷ 接口扩展 (本项目不需要)"| D2["编写 JavaScript 类 / 实现 Adapter 接口"]
    ASK -.->|"❸ 核心改造 (本项目不需要)"| D3["修改 Daemon 主循环调度器"]
    D1 --> OK["✅ 接入完成"]

    classDef good fill:#e8f5e9,stroke:#2e7d32,stroke-width:2.5px
    classDef na   fill:#fafafa,stroke:#bdbdbd,stroke-dasharray:4 3,color:#9e9e9e
    class D1,OK good
    class D2,D3 na
    

flowchart LR
    subgraph CLIENTS["客户端接入层 (全是 HTTP/SSE 客户端)"]
        TUI["packages/tui
OpenTUI + SolidJS 终端 UI"]
        DESK["packages/desktop / web / app
桌面与 Web 前端"]
        ZED["Zed 编辑器
(ACP 客户端)"]
    end

    subgraph SERVER_WORKER["Bun 进程 / Worker 线程 (Agent 本体 - 星形核心)"]
        HTTP_API["server/routes/instance/httpapi
REST + SSE 实时事件接口"]
        EFFECT_GEN["Effect TS 框架
(Effect.gen 依赖注入 & 结构化并发)"]
        SESSION_LOOP["session/prompt.ts
Agent 主循环心脏"]
        INTERNAL_ACP["packages/opencode/src/acp/
内嵌 ACP 协议转换层"]
        TOOLS["tool/registry.ts
内置工具注册表"]
        SQLITE[("SQLite + Drizzle ORM
会话持久化存储")]
    end

    subgraph LLM_TIER["外部模型厂商"]
        LLM_PROVIDERS["Multi-Provider LLM SDK
(OpenAI / Anthropic / DeepSeek / Kimi 等 30+ 厂商)"]
    end

    TUI & DESK -->|"HTTP 请求"| HTTP_API
    ZED <-->|"ACP JSON-RPC"| INTERNAL_ACP --> HTTP_API
    HTTP_API --> EFFECT_GEN --> SESSION_LOOP
    SESSION_LOOP -->|"读写 CRUD"| SQLITE
    SESSION_LOOP -->|"dispatch"| TOOLS
    TOOLS -->|"result"| SESSION_LOOP
    SESSION_LOOP -->|"llm.stream"| LLM_PROVIDERS

    classDef client fill:#e1f5fe,stroke:#0288d1,stroke-width:2px
    classDef server fill:#efebe9,stroke:#4e342e,stroke-width:2.5px
    classDef ext fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px
    class CLIENTS,TUI,DESK,ZED client
    class SERVER_WORKER,HTTP_API,EFFECT_GEN,SESSION_LOOP,INTERNAL_ACP,TOOLS server
    class LLM_TIER,LLM_PROVIDERS ext

    style SQLITE fill:#efebe9,stroke:#4e342e,stroke-width:2.5px
    

flowchart LR
    subgraph TAURI_SHELL["① 桌面壳 & 界面进程 (Rust / Tauri)"]
        GUI["React 界面 (surfaces/gui/src)
会话视图 / 工具卡 / 审批卡"]
        STT["Rust STT 侧车 (stt/)
语音输入处理"]
    end

    subgraph PYTHON_SERVER["② Python Agent 引擎服务进程 (coworker/)"]
        FASTAPI["FastAPI / uvicorn 服务
coworker/server/run.py"]
        MGR["SessionManager 会话编排
coworker/server/manager.py"]
        ENGINE["TurnEngine 循环心脏
coworker/engine.py"]
        EVENTS["TurnEngine EventStream
(events.py: TURN_START / TOOL_PROPOSED)"]
        INBOX["Attention Inbox 收件箱
(带外人类注意力队列)"]
        SCHED["Cron 调度器
coworker/automation/scheduler.py"]
    end

    subgraph STORAGE_EXT["③ 密钥库与基础设施"]
        KEYRING[("本地 OS 密钥库
secrets.py:3 Secrets Never Enter Context")]
        CONNECTORS["25+ 应用连接器
Slack / Jira / GitHub / Calendar"]
        AISUITE["aisuite 统一 LLM SDK
(OpenAI / Anthropic / Ollama)"]
    end

    GUI -->|"HTTP 请求"| FASTAPI
    FASTAPI -->|"WebSocket 事件推送"| GUI
    STT --> GUI
    FASTAPI --> MGR --> ENGINE
    ENGINE --> EVENTS
    EVENTS -->|"1. 提权请求不阻塞，丢入队列"| INBOX
    INBOX -.->|"2. 人类有空时审批放行"| ENGINE
    SCHED --> MGR
    ENGINE --- KEYRING
    ENGINE --> CONNECTORS
    ENGINE --> AISUITE

    classDef rust fill:#ffebee,stroke:#c62828,stroke-width:2px
    classDef python fill:#e8f5e9,stroke:#2e7d32,stroke-width:2.5px
    classDef ext fill:#fff8e1,stroke:#f57f17,stroke-width:2px
    class TAURI_SHELL,GUI,STT rust
    class PYTHON_SERVER,FASTAPI,MGR,ENGINE,EVENTS,INBOX,SCHED python
    class STORAGE_EXT,CONNECTORS,AISUITE ext

    style KEYRING fill:#fff8e1,stroke:#f57f17,stroke-width:2px
    

stateDiagram-v2
    [*] --> Plan: 用户输入 Goal 任务目标
    
    state Plan {
        [*] --> AnalyzingCodebase: xai-codebase-graph 索引分析
        AnalyzingCodebase --> DecomposingSubtasks: 拆解为可验证的子目标数组
        DecomposingSubtasks --> PlanLocked: 锁定任务规划线索
    }

    PlanLocked --> Execute: 状态机推向执行

    state Execute {
        [*] --> ToolExecution: ToolBridge 调用 (~25 Rust 工具)
        ToolExecution --> FileMutation: 修改代码与操作 Shell
        FileMutation --> InspectOutput: 捕获运行日志与 Diff
    }

    Execute --> Validate: 状态机推向验证

    state Validate {
        [*] --> RunTests: 自动运行编译与单元测试
        RunTests --> CheckCriteria: 检查目标断言条件
    }

    Validate --> [*]: 验证通过，目标完成 (Goal Completed)
    
    Validate --> StrategistRecover: 验证失败 / 遇到编译错误
    
    state StrategistRecover {
        [*] --> AnalyzeFailure: 战略师 Agent 分析失败根因
        AnalyzeFailure --> AdjustPlan: 修正后续子任务规划
    }

    StrategistRecover --> Execute: 带着修正案重新执行
    

flowchart TB
    subgraph ENTRANCE["入口层 (Entrance Scripts)"]
        MAIN["main.py ➔ Manus.create()"]
        FLOW["run_flow.py ➔ PlanningFlow (多 Agent 编排)"]
        SANDBOX_MAIN["sandbox_main.py ➔ Daytona 云沙箱版"]
        MCP_SERVER["run_mcp_server.py ➔ FastMCP 服务端"]
    end

    subgraph HIERARCHY["Agent 继承链 (单色相多明度能力偏序图)"]
        BASE["BaseAgent (app/agent/base.py)
• 基础 step() 循环框架
• 🛡️ 止损防线 1: is_stuck() / handle_stuck_state()
• 🛡️ 止损防线 2: max_steps 默认限制 = 10 步 (base.py:40)"]
        REACT["ReActAgent (app/agent/react.py)
• 新增 think() 与 act() 抽象方法"]
        TOOL_CALL["ToolCallAgent (app/agent/toolcall.py)
• 新增 LLM 工具调用 Block 解析与挂载"]
        MANUS["Manus / BrowserAgent / DataAnalysis / SandboxManus
• 注入特定工具箱 (browser-use / search / python / chart)"]

        BASE -->|"继承并扩展"| REACT
        REACT -->|"继承并扩展"| TOOL_CALL
        TOOL_CALL -->|"继承并实例化"| MANUS
    end

    subgraph DELIVERABLES["调研与交付物工具集 (app/tool/)"]
        BROWSER["browser_use_tool.py (Playwright 浏览器)"]
        SEARCH["web_search.py (Google/Baidu 级联搜索)"]
        PYTHON["python_execute.py (代码执行)"]
        CHART["chart_visualization/ (图表绘制)"]
    end

    ENTRANCE --> HIERARCHY
    MANUS --> DELIVERABLES
    DELIVERABLES -->|"交付成果"| HANDBOOK[("HTML 旅游手册 / 调研报告 / 数据图表")]

    classDef lv1 fill:#fce4ec,stroke:#ad1457,stroke-width:2px
    classDef lv2 fill:#f8bbd0,stroke:#ad1457,stroke-width:2px
    classDef lv3 fill:#f48fb1,stroke:#ad1457,stroke-width:2px
    classDef lv4 fill:#f06292,stroke:#ad1457,stroke-width:2.5px,color:#fff

    class BASE lv1
    class REACT lv2
    class TOOL_CALL lv3
    class MANUS lv4