sunflowermm-xrk-agt-2

联合研制单位

联合研制工作室

XRK-AGT 是由向日葵开发，各个大学志同道合的学生联合研制，基于 Node.js 打造的 多平台、多Tasker、工作流驱动型智能体平台，采用分层架构设计，支持：

• 🌐 多平台消息接入：OneBotv11 / QBQBot / GSUIDCORE / stdin / 自定义 Tasker
• 🔌 插件工作流：指令插件 + AI 工作流 (AIStream)
• 🌐 Web 与 HTTP/API 服务：内置 Web 控制台 + REST API + WebSocket
• ⭐ system-Core 内置模块：10个HTTP API、6个工作流（50+个MCP工具）、4个Tasker、企业级Web控制台
• 🎨 渲染与截图：基于 Puppeteer / Playwright 的页面渲染与图片输出

如果你是第一次接触本项目：

• 仅想先跑起来：直接看下面的「快速开始」
• 想了解整体架构：先看「架构层次说明」和 PROJECT_OVERVIEW.md
• 想看底层设计边界（推荐）：阅读 docs/底层架构设计.md
• 想做二次开发/写插件：阅读 docs/README.md 与各子文档

🏗️ 架构层次说明

XRK-AGT 采用清晰的分层架构设计，各层职责明确，便于扩展和维护。

flowchart LR
    subgraph Clients["👥 外部入口"]
        direction TB
        QQ["📱 QQ/OneBotv11"]
        IM["💬 IM平台"]
        WebUI["🌐 Web控制台"]
        API["🔌 HTTP客户端"]
    end

    subgraph Runtime["⚙️ 运行核心层"]
        Bot["🤖 Bot主类<br/>HTTP/WS/反向代理/事件总线"]
    end

    subgraph Infra["🏗️ 基础设施层"]
        direction TB
        Loaders["📚 加载器"]
        Bases["📦 基类库"]
        HttpBiz["💼 HTTP业务层"]
    end

    subgraph Tasker["📡 任务层"]
        direction TB
        TOneBot["OneBotv11"]
        TStdin["stdin/自定义"]
    end

    subgraph Events["📢 事件系统"]
        Listeners["事件监听器<br/>去重/标准化/分发"]
    end

    subgraph Business["💼 业务层"]
        direction TB
        Plugins["🔌 插件"]
        HttpAPI["📡 HTTP API"]
        Streams["🌊 AI工作流"]
    end

    Clients -->|消息接入| Bot
    Bot -->|核心服务| Infra
    Infra -->|协议对接| Tasker
    Infra -->|事件处理| Events
    Infra -->|业务支撑| Business
    Tasker -->|事件传递| Events
    Events -->|事件分发| Business

    style Clients fill:#E3F2FD,stroke:#1976D2,stroke-width:3px,color:#000
    style Runtime fill:#FFF3E0,stroke:#F57C00,stroke-width:4px,color:#000
    style Infra fill:#E8F5E9,stroke:#388E3C,stroke-width:3px,color:#000
    style Tasker fill:#E1F5FE,stroke:#0277BD,stroke-width:3px,color:#000
    style Events fill:#FCE4EC,stroke:#C2185B,stroke-width:3px,color:#000
    style Business fill:#F3E5F5,stroke:#7B1FA2,stroke-width:3px,color:#000
    style Bot fill:#FFF9C4,stroke:#F9A825,stroke-width:4px,color:#000

分层说明：

• ⚙️ 运行核心层：统一管理 HTTP/HTTPS/WebSocket、中间件、认证、反向代理、事件总线
• 🏗️ 基础设施层：提供基类、加载器、HTTP 业务层和数据库客户端
• 📡 任务层：对接各协议，将平台消息转换为统一事件结构
• 📢 事件系统：对事件做去重、标准化与预处理，再分发到插件系统
• 💼 业务层：具体业务实现，包括指令插件、HTTP API 与 AI 工作流

详细架构说明：请参见 PROJECT_OVERVIEW.md

⭐ Star 趋势

🚀 快速开始

📥 1. 克隆项目

请使用浅克隆以减小下载体积（--depth=1 仅拉取最新提交）：

# Github
git clone --depth=1 https://github.com/sunflowermm/XRK-AGT.git

# Gitee
git clone --depth=1 https://gitee.com/xrkseek/XRK-AGT.git

# Gitcode
git clone --depth=1 https://gitcode.com/Xrkseek/XRK-AGT.git

cd XRK-AGT

📦 2. 安装依赖

# 推荐：pnpm（仅支持 pnpm）
pnpm install

⚙️ 3. 配置环境变量（可选）

创建 .env 文件（用于代理配置等）：

# 主服务端口（默认 8080）
XRK_SERVER_PORT=8080