🏗️ 系统架构

VTeamOS 采用分层架构设计，确保系统的可扩展性、可维护性和高性能。

---

📐 架构总览

┌─────────────────────────────────────────────────────────────┐
│                     用户层 (User Layer)                      │
│           飞书、微信、WebUI、API、CLI                        │
└────────────────────────────┬────────────────────────────────┘
                             │
┌────────────────────────────▼────────────────────────────────┐
│                    服务层 (Service Layer)                    │
│                  AgentEvo (进化引擎)                         │
│           记忆、画像、渠道、心跳、Skill、SOP                  │
└────────────────────────────┬────────────────────────────────┘
                             │
┌────────────────────────────▼────────────────────────────────┐
│                    实例层 (Instance Layer)                   │
│                  AgentClaw (Agent 实例)                      │
│           Config、SOP-1st、Loop 模式、GitBranch              │
└────────────────────────────┬────────────────────────────────┘
                             │
┌────────────────────────────▼────────────────────────────────┐
│                    核心层 (Core Layer)                       │
│                  AgentCore (核心引擎)                        │
│           公共 Skill、公共 SOP、WASM Plugin、Go Plugin       │
└────────────────────────────┬────────────────────────────────┘
                             │
┌────────────────────────────▼────────────────────────────────┐
│                    平台层 (Platform Layer)                   │
│                  ConfigHub (配置中心)                        │
│           Bus、LLM、TTS、Embedding、Channel、MCP            │
└────────────────────────────┬────────────────────────────────┘
                             │
┌────────────────────────────▼────────────────────────────────┐
│                    资源层 (Resource Layer)                   │
│                  AgentResource (资源管理)                    │
│           服务器、调度、监控、路由                            │
└─────────────────────────────────────────────────────────────┘

---

🔧 核心组件

1. AgentCore (核心引擎)

AgentCore 是 VTeamOS 的心脏，负责：

• 🔧 工具执行: 12 工具基座
• 📡 消息路由: 多渠道消息分发
• 🔌 插件管理: WASM/Go/MCP 插件生命周期
• 📊 决策追踪: 执行路径记录和分析

// AgentCore 核心接口
type AgentCore interface {
    ExecuteTool(ctx context.Context, tool string, input map[string]any) (map[string]any, error)
    RouteMessage(ctx context.Context, msg *UnifiedMessage) error
    LoadPlugin(ctx context.Context, plugin Plugin) error
    GetDecisionTrace(ctx context.Context, taskID string) (*DecisionTrace, error)
}

2. AgentClaw (Agent 实例)

每个 AgentClaw 是一个独立的 Agent 实例：

• 🎯 独立配置: 模型、工具、权限
• 📚 专属 SOP: 特定领域的流程知识
• 🧠 私有记忆: 用户级记忆隔离
• 🔄 进化能力: 通过 A/B 测试优化

// AgentClaw 实例结构
type AgentClaw struct {
    ID          string
    Config      *ClawConfig
    SOPStore    *SOPStore
    Memory      *MemorySystem
    Evolution   *EvolutionWorker
}

3. AgentEvo (进化引擎)

AgentEvo 负责 Agent 的持续进化：

• 📊 数据收集: 交互记录、决策轨迹
• 🔍 模式发现: 成功路径识别
• 📝 SOP 结晶: 自动生成标准流程
• 🧪 A/B 测试: 验证优化效果

4. ConfigHub (配置中心)

ConfigHub 管理所有配置和资源：

• 🤖 LLM Provider: 多模型支持
• 🔊 TTS Provider: 语音合成
• 📡 Channel: 多渠道接入
• 🔌 MCP: 外部服务集成

---

🛠️ 技术栈

核心技术

组件	技术	优势
核心服务	Go	高并发、低延迟
安全组件	Rust	内存安全、高性能
轻量插件	TinyGo/WASM	快速启动、隔离执行
数据存储	SQLite	单机部署、零依赖
API 网关	gRPC	高效通信、类型安全

依赖服务

核心依赖:
  - Claude Code CLI: AI 编程助手
  - gRPC: 服务间通信
  - SQLite: 数据持久化

可选依赖:
  - Supabase: 云端存储
  - Redis: 缓存加速
  - Prometheus: 监控告警

---

📡 通信架构

消息流

用户消息
    ↓
渠道适配器 (Channel Adapter)
    ↓
消息标准化 (UnifiedMessage)
    ↓
AgentCore 路由
    ↓
AgentClaw 处理
    ↓
工具执行
    ↓
响应生成
    ↓
渠道回复

内部通信

// gRPC 服务定义
service AgentCoreService {
    rpc ExecuteTool(ToolRequest) returns (ToolResponse);
    rpc RouteMessage(MessageRequest) returns (MessageResponse);
    rpc LoadPlugin(PluginRequest) returns (PluginResponse);
}

// 事件总线
type EventBus interface {
    Publish(ctx context.Context, event *Event) error
    Subscribe(ctx context.Context, topic string, handler EventHandler) error
}

---

🔐 安全架构

权限模型

用户 (User)
    ↓ 认证
渠道 (Channel)
    ↓ 鉴权
AgentClaw (Instance)
    ↓ 权限控制
工具 (Tool)
    ↓ 沙箱隔离
资源 (Resource)

安全特性

• 🔒 渠道隔离: 不同渠道数据完全隔离
• 🛡️ 工具沙箱: WASM 插件隔离执行
• 🔑 权限控制: 细粒度工具权限
• 📝 审计日志: 完整操作记录

---

📊 监控架构

监控维度

┌─────────────────────────────────────────┐
│           应用层监控                     │
│   决策质量、任务成功率、用户满意度       │
├─────────────────────────────────────────┤
│           服务层监控                     │
│   响应时间、错误率、吞吐量               │
├─────────────────────────────────────────┤
│           资源层监控                     │
│   CPU、内存、网络、存储                  │
└─────────────────────────────────────────┘

关键指标

• 📈 决策准确率: Agent 选择正确工具的比例
• ⏱️ 任务完成时间: 从需求到交付的平均时长
• 🔄 SOP 命中率: 成功匹配标准流程的比例
• 💾 记忆召回精度: 记忆系统返回相关信息的比例

---

🚀 部署架构

单机部署

┌─────────────────────────────────┐
│         VTeamOS 单机            │
│  ┌─────────┐  ┌─────────┐      │
│  │ vteamd  │  │ WebUI   │      │
│  └────┬────┘  └────┬────┘      │
│       │            │           │
│  ┌────▼────────────▼────┐      │
│  │      SQLite          │      │
│  └──────────────────────┘      │
└─────────────────────────────────┘

分布式部署

┌─────────────────────────────────────────────────┐
│                 负载均衡                         │
└──────────────────┬──────────────────────────────┘
                   │
     ┌─────────────┼─────────────┐
     ▼             ▼             ▼
┌─────────┐  ┌─────────┐  ┌─────────┐
│ Node 1  │  │ Node 2  │  │ Node 3  │
│ vteamd  │  │ vteamd  │  │ vteamd  │
└────┬────┘  └────┬────┘  └────┬────┘
     │            │            │
     └────────────┼────────────┘
                  ▼
         ┌───────────────┐
         │  Supabase     │
         │  (DB + Storage)│
         └───────────────┘

---

🔮 架构演进

路线图

Phase 1: 单机版 ✅
    SQLite + 本地存储
    单 Agent 实例
    基础渠道支持

Phase 2: 多实例 🚧
    多 AgentClaw 隔离
    共享 AgentCore
    配置中心

Phase 3: 分布式 📋
    多节点部署
    资源调度
    高可用

Phase 4: 生态化 🎯
    插件市场
    SOP 共享
    社区协作

---

📚 下一步

• AgentCore - 深入了解核心引擎
• SOP-First - 详细了解 SOP 机制
• 团队成员 - 认识主创团队