# mindverse/second-me architecture

> Architecture diagram of the GitHub repository mindverse/second-me, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mindverse/second-me
- Repository: https://github.com/mindverse/second-me

## Overview

下面给出一份非常详细的系统设计图绘制指南，这份指南会帮助你以极其细致的方式捕捉 Second Me 项目的所有主要组件及其相互之间的关系。以下是具体步骤和说明：

##### 确定主要组件与分层
- 前端层：主要对应 lpm_frontend 目录。该部分由 Next.js 构成，包含多个页面、组件与布局（如 Dashboard、Roleplay、Space、Playground 等）。你应画出前端用户界面，并标明其各个典型模块（例如主页、仪表板、应用列表以及各子模块）。
- 后端/核心层：主要对应 lpm_kernel 目录。这一层进一步细分为：
- 核心模块：L0、L1 和 L2，不仅封装了生成、提示、模型相关的逻辑（例如 l0_generator、l1_generator、l2_generator），而且包含模型训练、记忆管理以及多阶段的处理流程。
- API 服务：位于 lpm_kernel/api，它细分成多个领域（domains），包括 health、kernel（和 kernel2）、documents、memories、space、trainprocess、upload、以及 user_llm_config。每个领域都定义了 DTO、服务、路由等。绘制图中要为每个领域或至少为核心领域画出单独的模块，并用箭头标明前端如何调用这些 API。
- 通用服务与仓储：lpm_kernel/common 和 lpm_kernel/file_data 中的模块（例如数据库仓储、文件处理、文本/图像处理等），这些组件负责数据分片、向量存储、日志记录等功能。这部分建议在图中独立成一个“通用服务层”，并与 API 层进行连接。
- 集成服务与附属模块：包括 integrate 文件夹中的 wechat_bot（以及其他集成接口）、mcp 目录中的 mcp_local.py 和 mcp_public.py 模块，它们用于特定环境下的部署或者两种不同模式的运行。在图中可以单独绘制一个集成模块，并说明它如何与前后端交互。

##### 数据存储与外部依赖
- 数据库：注意到 docker/sqlite 目录以及 lpm_kernel/common/repository 下的 MySQL 和向量仓储模块，建议绘制一个数据库或数据存储系统的图标，标明持久化存储与内存数据存储（如向量存储）的不同用途。
- 外部依赖：在 dependencies 目录中，我们看到对 graphrag、llama.cpp 等依赖的引用。你应在图中添加“外部依赖”模块，明确这些组件如何被项目利用（例如作为模型推理后端或者数据处理工具）。

##### 部署与容器化支持
- Docker 部署：图中需要显示 Docker 容器化环境。包括 Dockerfile.frontend 与 Dockerfile.backend（以及 Apple 针对性的 Dockerfile.backend.apple），同时标明 docker-compose.yml 所起的协调作用。使用不同颜色或形状区分容器化部署与集成部署。
- 集成部署：另提供一条线展示直接在宿主机上运行（通过 Makefile 的 integrated setup）的方案，强调这一部署方式的高效性（无容器化开销）。

##### 组件间关系与交互指引
- 用箭头标明数据流和依赖关系：例如前端通过 HTTP/REST API 发送请求到后端 API 服务，API 层再调用核心服务（例如记忆管理、模型训练、文件数据处理）后返回数据。
- 指出内部模块之间的关系：如 API 层与内部分层（L0、L1、L2）的联动，以及文件数据处理与内核模型训练之间的数据交互。
- 展示集成服务（如微信机器人、MCP）如何连接到后端服务或与用户进行双向通讯。

##### 标签与图形细节
- 为每个组件添加清晰的标签，例如“前端 (Next.js)”、“API 网关”、“核心服务 – L1 模块”、“文件数据处理”、“数据库 / 向量存储”等。
- 使用方向箭头清楚表示调用和数据流向，例如从“前端”箭头指向“API 网关”、从 API 层指向“核心服务”模块。
- 利用颜色或不同图形（矩形、圆角矩形、云型表示“外部依赖”或“云服务”等）区分不同的层次和作用域。

##### 提示细化建议
- 将图分为明显的逻辑层级（用户界面层、应用服务层、数据存储层与外部依赖层），并用水平或垂直布局使层级关系一目了然。
- 考虑在图中添加注释或备注，例如标注“直接部署”与“容器化部署”的对比优劣，以及不同服务间的交互协议（如 REST/HTTP、TCP 连接等）。
- 展现详细模块时，可以在每个大模块内再绘制子模块，例如在“API 服务”内部构成多个小组件（health、kernel、space、upload 等），并在子模块间用箭头展示数据流或调用链。

根据以上详细步骤，建议你绘制一张包含下列主要元素的系统设计图：
● 前端用户界面模块（lpm_frontend - Next.js 应用）
● API 网关 / 服务层（lpm_kernel/api 下的领域分块）
● 核心业务逻辑层（lpm_kernel 内部的 L0、L1、L2 模块；文件数据与通用仓储）
● 集成/辅助模块（mcp、integrate 中的服务，比如微信机器人）
● 数据存储与向量仓储（数据库、SQLite、MySQL、向量仓储）
● 外部依赖与第三方组件（graphrag、llama.cpp 等）
● 部署架构对比（Docker 容器 vs. 集成部署）

通过以上详细和分层的图示设计，你能捕捉项目的所有精细架构与数据交互，实现一个“全景式”的系统设计图。记住使用清晰的标注、箭头指向以及颜色编码来确保所有组件及其交互关系都能直观易懂地展现出来。

## Diagram (Mermaid)

```mermaid
graph TD
    %% 用户界面层
    subgraph "用户界面层 (前端, Next.js)"
        FE["前端界面 (Next.js)"]:::frontend
    end

    %% API 服务层
    subgraph "API服务层 (API网关)"
        API["API网关 / 服务层 (lpm_kernel/api)"]:::api
    end

    %% 核心业务逻辑层
    subgraph "核心业务逻辑层"
        L0["核心服务 - L0"]:::core
        L1["核心服务 - L1"]:::core
        L2["核心服务 - L2"]:::core
        Repo["通用服务 - 仓储 (MySQL/向量)"]:::storage
        File["文件数据处理"]:::file
    end

    %% 集成/辅助模块
    subgraph "集成/辅助模块"
        WeChat["微信机器人"]:::integration
        MCP1["MCP模块 - Local"]:::integration
        MCP2["MCP模块 - Public"]:::integration
    end

    %% 数据存储层
    subgraph "数据存储层"
        DB["SQLite 数据存储"]:::database
    end

    %% 外部依赖与第三方
    subgraph "外部依赖/第三方"
        Ext["外部依赖 (graphrag, llama.cpp)"]:::external
    end

    %% 部署架构
    subgraph "部署架构"
        subgraph "Docker部署"
            DF["Dockerfile.frontend"]:::docker
            DBE["Dockerfile.backend"]:::docker
            DBA["Dockerfile.backend.apple"]:::docker
            DC["docker-compose.yml"]:::docker
        end
        subgraph "集成部署"
            MK["Makefile (Integrated Setup)"]:::integration
        end
    end

    %% 部署平台节点（表示部署方式对各组件的承载）
    P1["容器平台"]:::deployment
    P2["集成部署平台"]:::deployment

    %% 连线：前端 -> API
    FE -->|"HTTP/REST"| API

    %% API -> 核心服务层
    API -->|"调用"| L0
    API -->|"调用"| L1
    API -->|"调用"| L2
    API -->|"请求数据"| Repo
    API -->|"请求文件"| File

    %% 核心服务层 -> 数据存储
    Repo -->|"持久化存储"| DB

    %% 核心服务层相互调用 (可选展示内部联动)
    L0 -->|"协同"| L1
    L1 -->|"协同"| L2

    %% 集成模块与 API/核心的交互
    WeChat ---|"双向通信"| API
    MCP1 ---|"双向通信"| API
    MCP2 ---|"双向通信"| API

    %% 外部依赖对核心服务的支持
    Ext ---|"推理/处理支持"| L0
    Ext ---|"推理/处理支持"| L1

    %% 部署平台与各层的关联
    P1 ---|"容器化部署"| FE
    P1 ---|"容器化部署"| API
    P1 ---|"容器化部署"| L0
    P1 ---|"容器化部署"| L1
    P1 ---|"容器化部署"| L2
    P1 ---|"容器化部署"| Repo
    P1 ---|"容器化部署"| File
    P1 ---|"容器化部署"| WeChat
    P1 ---|"容器化部署"| MCP1
    P1 ---|"容器化部署"| MCP2

    P2 ---|"直接部署"| FE
    P2 ---|"直接部署"| API
    P2 ---|"直接部署"| L0
    P2 ---|"直接部署"| L1
    P2 ---|"直接部署"| L2
    P2 ---|"直接部署"| Repo
    P2 ---|"直接部署"| File
    P2 ---|"直接部署"| WeChat
    P2 ---|"直接部署"| MCP1
    P2 ---|"直接部署"| MCP2

    %% 点击事件
    click FE "https://github.com/mindverse/second-me/tree/master/lpm_frontend"
    click API "https://github.com/mindverse/second-me/tree/master/lpm_kernel/api"
    click L0 "https://github.com/mindverse/second-me/tree/master/lpm_kernel/L0"
    click L1 "https://github.com/mindverse/second-me/tree/master/lpm_kernel/L1"
    click L2 "https://github.com/mindverse/second-me/tree/master/lpm_kernel/L2"
    click Repo "https://github.com/mindverse/second-me/tree/master/lpm_kernel/common/repository"
    click File "https://github.com/mindverse/second-me/tree/master/lpm_kernel/file_data"
    click WeChat "https://github.com/mindverse/second-me/blob/master/integrate/wechat_bot.py"
    click MCP1 "https://github.com/mindverse/second-me/blob/master/mcp/mcp_local.py"
    click MCP2 "https://github.com/mindverse/second-me/blob/master/mcp/mcp_public.py"
    click DB "https://github.com/mindverse/second-me/tree/master/docker/sqlite"
    click Ext "https://github.com/mindverse/second-me/tree/master/dependencies"
    click DF "https://github.com/mindverse/second-me/blob/master/Dockerfile.frontend"
    click DBE "https://github.com/mindverse/second-me/blob/master/Dockerfile.backend"
    click DBA "https://github.com/mindverse/second-me/blob/master/Dockerfile.backend.apple"
    click DC "https://github.com/mindverse/second-me/blob/master/docker-compose.yml"
    click MK "https://github.com/mindverse/second-me/tree/master/Makefile"

    %% 样式定义
    classDef frontend fill:#ADD8E6,stroke:#000,stroke-width:2px;
    classDef api fill:#FFD700,stroke:#000,stroke-width:2px;
    classDef core fill:#90EE90,stroke:#000,stroke-width:2px;
    classDef storage fill:#FFB6C1,stroke:#000,stroke-width:2px;
    classDef file fill:#DA70D6,stroke:#000,stroke-width:2px;
    classDef integration fill:#FFA07A,stroke:#000,stroke-width:2px;
    classDef database fill:#FFE4B5,stroke:#000,stroke-width:2px;
    classDef external fill:#D3D3D3,stroke:#000,stroke-width:2px;
    classDef docker fill:#FF6347,stroke:#000,stroke-width:2px;
    classDef deployment fill:#87CEEB,stroke:#000,stroke-width:2px;
```
