sgClaw 架构研讨看板

总图定战略与边界 · 分图定技术与接口

第一部分:业务全景与宏观分工

明确“三大核心阵地”的作用、责任人与对接瓶颈 (Left to Right)

🌐 1. 浏览器交互宿主
👨‍💻 责任人:P4 (前端) + P2 (C++)
提供界面输入与 Agent 执行环境
UI 面板层 (P4)
Side Panel 助手界面 + Skill 管理后台
进程守护内核 (P2)
启动、管理与保活 sgClaw 独立子进程
底层能力复用 (现有)
复用 70+ 核心 CDP 浏览器操纵指令
⚡风险点 STDIO 跨进程通信流
(P2 ↔ P1a)
⚙️ 2. sgClaw AI 引擎
👨‍💻 责任人:P1a (协议) + P1b (Rust AI)
系统级智能中枢,负责推理与逻辑
协议枢纽层 (P1a)
Pipe 双向流处理、白名单指令拦截
推理与记忆引擎 (P1b)
ReAct 核心调度循环 + L0/1/2 记忆系统
沙箱加载器 (P1b)
验证签名并隔离运行外部业务 Skill
🔄 逻辑常识支撑 提示词与技能下发
(P1b ↔ P3)
📦 3. 业务技能与基座
👨‍💻 责任人:P3 (业务) + 算法基座
提供底层算力与具体场景业务规则
黄金基准样本 (P3)
人工手写测试的 15 个高可用业务场景
泛化扩容技能库 (P3)
通过大模型批量生成的长尾应用技能
大模型底座 (内网)
Minimax-M2.5/Deepseek v3.2 通用流式推理
向下滚动查看技术架构

第二部分:技术研发架构与数据流向

面向研发团队:明确模块边界、API 交互方式及底层数据流传路径

graph LR User(["👤 用户操作"]) subgraph BROWSER["🌐 浏览器侧 (P4+P2)"] direction TB SidePanel("UI: AI 面板 (Vue)") ProcessHost("Host: 进程守护") PipeListener("IPC: Pipe 监听") Cmd["Action: CDP 操纵指令"] SidePanel <-->|"Window IPC"| ProcessHost ProcessHost --> PipeListener PipeListener -.->|"复用"| Cmd end subgraph SGCLAW["⚙️ sgClaw AI 引擎进程 (P1a+P1b)"] direction TB PipeRW("Core: Pipe 双向读写") BrowserTool("Tool: Action 封装") Runtime("Brain: ReAct 核心循环") Memory[("Mem: 记忆层 (SQLite)")] SkillLoader("Sandbox: 沙箱加载验签") PipeRW <--> BrowserTool BrowserTool <--> Runtime Runtime --> Memory Runtime --> SkillLoader end subgraph EXT["☁️ 远端服务与库 (P3)"] direction TB LLM1("LLM: Claude/GPT API") SkillDB[/"Skill: 黄金/泛化技能库"/] end %% 数据流连线 User --> SidePanel PipeListener == "⚡ 高风险卡点 (STDIO 双工流)" === PipeRW Runtime <-->|"提示词组装"| LLM1 SkillLoader -->|"签名挂载调用"| SkillDB BrowserTool -.->|"执行结果回调"| PipeListener %% 颜色样式 classDef p1 fill:#fff7ed,stroke:#ea580c,stroke-width:1px classDef p2 fill:#eff6ff,stroke:#2563eb,stroke-width:1px classDef p3 fill:#f0fdf4,stroke:#16a34a,stroke-width:1px class PipeRW,BrowserTool,Runtime,Memory,SkillLoader p1 class SidePanel,ProcessHost,PipeListener,Cmd p2 class LLM1,SkillDB p3

第三部分:关键路径与里程碑依赖

面向 PM/TL:把握各干系人的研发依赖与联调卡点,控制排期风险

graph TB subgraph W1["📌 W1 独立开发期 (Day 1-3)"] direction LR P1a["P1a 协议层构建"] P2["P2 内核扩展开发"] P1b["P1b ReAct框架"] P3["P3 核心用例设计"] P4["P4 面板UI开发"] P1a ~~~ P2 ~~~ P1b ~~~ P3 ~~~ P4 end CRIT{{"⚠️ W1 末期关键联调 (Day 4-5)\n=====================\nP1a 🤝 P2 联合打通 STDIO Pipe\n(如果阻塞,整个后续测试将无法进行)"}} subgraph W2["🚀 W2 集成与验收期 (Day 6-10)"] direction TB INT1["P1b 🤝 P3\n沙箱能力与用例装载测试"] INT2["P1a 🤝 P1b\n引擎接入浏览器动作测试"] INT3["P2 🤝 P4\n前后端 IPC 接口贯通测试"] TEST["🎯 全链路 E2E 测试\n跑通首批 6 个核心业务场景"] SHIP["📦 P4 打包发版"] INT1 --> TEST INT2 --> TEST INT3 --> TEST TEST --> SHIP end W1 --> CRIT CRIT -->|打通后| W2 classDef crit fill:#fef2f2,stroke:#ef4444,stroke-width:2px,color:#991b1b class CRIT crit
🚨 风险管控重点说明:
Day 4-5 的 P1a (协议层) 与 P2 (内核层) 的 Pipe 通信是整个项目的物理连通基石。如果这个桥梁不通,P1b (AI 引擎)、P3 (业务技能) 和 P4 (UI 面板) 将沦为孤岛,无法进行端到端全链路验证。建议在此节点安排 Daily Sync 重点跟进,必要时准备 HTTP 兜底预案。