# 🏗️ sgClaw 系统架构总图

完整系统组件 · 层级关系 · 负责人标注 · 数据流向

P1a · 核心通信（赵义仑）
P1b · 业务支持
P2 · 浏览器对接
P3 · AI 辅助迁移
P4 · 前端发布
已有系统（复用）
🎨 用户交互层
AI 助手 Side Panel
👤 P4 · 前端工程师
功能：用户输入自然语言指令，查看执行进度，管理 Skill 启用/禁用
AgentControlPanel.vue
SkillManager.vue
IPC 调用
用户指令："导出 ERP 报表"
🌐 浏览器内核层（SuperRPA Chromium）
sgClaw 进程管理器
👤 P2 · C++ 工程师
功能：启动 sgClaw 子进程，监听 STDIO Pipe，转发 JSON 指令，MAC 白名单检查
SgClawProcessHost.cc (~600 行)
PipeListener.cc
MacWhitelistCheck.cc
现有浏览器能力
已有系统
复用：CommandRouter（70+ 命令）、CdpBridge、Zombie 模式等
CommandRouter
CDP 协议
⚡ STDIO Pipe 通信 关键路径
🧠 sgClaw AI 引擎层（Rust 进程）
通信与工具层
👤 P1a · 赵义仑 核心
功能：Pipe 双向通信，JSON 序列化，15 个 BrowserAction，MAC 策略
PipeReader/Writer (~900 行)
BrowserPipeTool
MacPolicy
AI Runtime 引擎
👤 P1b · Rust 工程师
功能：ReAct 循环，工具调用，三层记忆，Critic 评估
AgentRuntime (~600 行)
Memory (L0/L1/L2)
Critic 评估器
Skill 加载器
👤 P1b · Rust 工程师
功能：扫描 Skill 目录，Ed25519 验签，JS 沙箱执行
SkillLoader.rs
SignatureVerifier
JSRuntime (Deno Core)
推理请求 / 流式响应
🤖 外部服务层
AI 大模型（内网部署）
已有服务
功能：接收自然语言 + 上下文，返回 JSON 格式的操作序列
Claude 3.5 / GPT-4
本地 Qwen-72B
DeepSeek
Skill 技能仓库
👤 P3 · AI + 业务工程
功能：存储 400+ 业务场景的技能包，带签名验证
10-15 黄金样本（手写）
390 AI 生成 Skill
Ed25519 签名

### 📊 数据流向总结

① 用户输入（P4 Vue 界面）→ ② IPC 传递（P2 C++ 层）→ ③ Pipe 通信（P1a Rust 层，关键路径）→ ④ AI 推理（P1b Runtime + 大模型）→ ⑤ Skill 查询（P3 仓库）→ ⑥ 操作执行（P2 CommandRouter → 浏览器）→ ⑦ 记忆沉淀（P1b Memory）

### ⚠️ 关键依赖关系

1. P1a + P2 必须先联调成功（Day 4-5），否则整个系统无法打通。
2. P1b 依赖 P1a 的 BrowserPipeTool（Day 6 对接），才能让 AI 调用浏览器。
3. P3 的 Skill 需要 P1b 的加载器（Day 6-7 验证），才能被执行。
4. P4 的 UI 需要 P2 的 IPC 接口（Day 6 集成），才能控制 sgClaw。

## 🛠️ 技术栈总结

P1a + P1b（Rust）
• Rust 1.75+
• ZeroClaw 框架
• Tokio 异步运行时
• SQLite (L2 记忆)
• Ed25519 签名
• Deno Core (JS 沙箱)
P2（C++ 浏览器）
• C++17
• Chromium 120+
• STDIO Pipe
• CDP 协议
• 现有 CommandRouter
• JSON 解析（RapidJSON）
P3（AI + 业务）
• JavaScript (ES2022)
• Qwen-72B / DeepSeek
• Prompt Engineering
• agent-vue 场景分析
• Ed25519 签名工具