# aozorayui/ai-plugin architecture

> Architecture diagram of the GitHub repository aozorayui/ai-plugin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aozorayui/ai-plugin
- Repository: https://github.com/aozorayui/ai-plugin

## Overview

AI-Plugin is a Yunzai-Bot AI assistant plugin. Users invoke chat, image-generation, memory, and management commands; chat can plan and execute tools before returning a response. Group chat capture and recall, persistent conversation memory, model routing, and optional integrations extend that flow. Edges are based on the README and SOURCE INDEX references; where implementation excerpts were unavailable, documented capabilities are represented without asserting unverified internal calls.

Main entry points: [`apps/chat.js`](https://github.com/aozorayui/ai-plugin/blob/main/apps/chat.js) (Chat commands), [`client/AiClient.js`](https://github.com/aozorayui/ai-plugin/blob/main/client/AiClient.js) (Model client), [`apps/fast_chat.js`](https://github.com/aozorayui/ai-plugin/blob/main/apps/fast_chat.js) (Group chat), [`tools/index.js`](https://github.com/aozorayui/ai-plugin/blob/main/tools/index.js) (Tool collection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interactions"]
  node_chat["Chat commands<br/>[chat.js]"]
  node_fastchat["Group chat<br/>[fast_chat.js]"]
  node_image["Image generation<br/>[image.js]"]
  node_memorycmd["Memory commands<br/>[memory.js]"]
  node_management["Plugin management<br/>[management.js]"]
end

subgraph group_agent["Agent and tools"]
  node_registry["Tool registry<br/>[registry.js]"]
  node_toolset["Tool collection<br/>[index.js]"]
  node_planner["Task planning<br/>[agent_plan.js]"]
  node_runtime["Agent runtime<br/>[agent_runtime.js]"]
  node_policy["Tool policy<br/>[agent_policy.js]"]
  node_intent["Intent parsing<br/>[tool_intent.js]"]
  node_result["Tool results<br/>[tool_result.js]"]
  node_search["Web search<br/>[search.js]"]
  node_fetch["Web fetch<br/>[web_fetch.js]"]
  node_vision["Vision relay<br/>[vision_relay.js]"]
end

subgraph group_memory["Conversation memory"]
  node_conversation["Conversation history<br/>[conversation.js]"]
  node_database[("SQLite persistence<br/>[database.js]")]
  node_vector["Vector memory<br/>[vector_memory.js]"]
end

subgraph group_platform["Models and platform"]
  node_client["Model client<br/>[AiClient.js]"]
  node_config["Plugin configuration<br/>[config.js]"]
  node_common["Shared utilities<br/>[common.js]"]
  node_access["Access control<br/>[access.js]"]
  node_imageutil["Image handling<br/>[image.js]"]
  node_modeloutput["Model output<br/>[model_output.js]"]
  node_qqface["QQ face mapping<br/>[qq_face.js]"]
end

node_user(("User"))
node_externalmodels{{"Model providers"}}
node_yunzai{{"Yunzai-Bot"}}
node_web{{"Web sources"}}

node_user -->|"sends command"| node_chat
node_user -->|"mentions bot"| node_fastchat
node_user -->|"requests image"| node_image
node_user -->|"manages memory"| node_memorycmd
node_user -->|"manages plugin"| node_management
node_chat -->|"requests model"| node_client
node_chat -->|"loads history"| node_conversation
node_chat -->|"checks access"| node_access
node_chat -->|"runs tools"| node_runtime
node_chat -->|"handles images"| node_imageutil
node_fastchat -->|"requests model"| node_client
node_fastchat -->|"runs tools"| node_runtime
node_fastchat -->|"uses tools"| node_toolset
node_fastchat -->|"shares memory"| node_conversation
node_image -->|"requests image"| node_client
node_memorycmd -->|"reads history"| node_conversation
node_memorycmd -->|"requests summaries"| node_client
node_conversation -->|"reads and writes"| node_database
node_database -->|"queues indexing"| node_vector
node_runtime -->|"uses task plans"| node_planner
node_runtime -->|"dispatches tools"| node_registry
node_registry -->|"filters intent"| node_intent
node_registry -->|"applies policy"| node_policy
node_registry -->|"normalizes results"| node_result
node_toolset -->|"exports registry"| node_registry
node_toolset -->|"exports search"| node_search
node_toolset -->|"exports fetch"| node_fetch
node_toolset -->|"exports relay"| node_vision
node_search -->|"searches sources"| node_web
node_fetch -->|"fetches pages"| node_web
node_client -->|"routes requests"| node_externalmodels
node_client -->|"loads settings"| node_config
node_client -->|"uses networking"| node_common
node_chat -->|"uses mappings"| node_qqface
node_chat -.->|"formats response"| node_modeloutput
node_vector -.->|"indexes records"| node_database
node_management -->|"updates settings"| node_config
node_yunzai -.->|"loads plugin command"| node_chat

click node_chat "https://github.com/aozorayui/ai-plugin/blob/main/apps/chat.js"
click node_fastchat "https://github.com/aozorayui/ai-plugin/blob/main/apps/fast_chat.js"
click node_image "https://github.com/aozorayui/ai-plugin/blob/main/apps/image.js"
click node_memorycmd "https://github.com/aozorayui/ai-plugin/blob/main/apps/memory.js"
click node_management "https://github.com/aozorayui/ai-plugin/blob/main/apps/management.js"
click node_client "https://github.com/aozorayui/ai-plugin/blob/main/client/AiClient.js"
click node_conversation "https://github.com/aozorayui/ai-plugin/blob/main/model/conversation.js"
click node_database "https://github.com/aozorayui/ai-plugin/blob/main/utils/database.js"
click node_vector "https://github.com/aozorayui/ai-plugin/blob/main/utils/vector_memory.js"
click node_registry "https://github.com/aozorayui/ai-plugin/blob/main/tools/registry.js"
click node_toolset "https://github.com/aozorayui/ai-plugin/blob/main/tools/index.js"
click node_planner "https://github.com/aozorayui/ai-plugin/blob/main/utils/agent_plan.js"
click node_runtime "https://github.com/aozorayui/ai-plugin/blob/main/utils/agent_runtime.js"
click node_policy "https://github.com/aozorayui/ai-plugin/blob/main/utils/agent_policy.js"
click node_intent "https://github.com/aozorayui/ai-plugin/blob/main/utils/tool_intent.js"
click node_result "https://github.com/aozorayui/ai-plugin/blob/main/utils/tool_result.js"
click node_search "https://github.com/aozorayui/ai-plugin/blob/main/tools/search.js"
click node_fetch "https://github.com/aozorayui/ai-plugin/blob/main/tools/web_fetch.js"
click node_vision "https://github.com/aozorayui/ai-plugin/blob/main/tools/vision_relay.js"
click node_config "https://github.com/aozorayui/ai-plugin/blob/main/utils/config.js"
click node_common "https://github.com/aozorayui/ai-plugin/blob/main/utils/common.js"
click node_access "https://github.com/aozorayui/ai-plugin/blob/main/utils/access.js"
click node_imageutil "https://github.com/aozorayui/ai-plugin/blob/main/utils/image.js"
click node_modeloutput "https://github.com/aozorayui/ai-plugin/blob/main/utils/model_output.js"
click node_qqface "https://github.com/aozorayui/ai-plugin/blob/main/utils/qq_face.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_chat,node_fastchat,node_image,node_memorycmd,node_management,node_user toneBlue
class node_registry,node_toolset,node_planner,node_runtime,node_policy,node_intent,node_result,node_search,node_fetch,node_vision toneAmber
class node_conversation,node_database,node_vector toneMint
class node_client,node_config,node_common,node_access,node_imageutil,node_modeloutput,node_qqface toneRose
class node_externalmodels,node_yunzai,node_web toneIndigo
```

## Components

### User interactions

- [Chat commands](https://github.com/aozorayui/ai-plugin/blob/main/apps/chat.js): `apps/chat.js`
- [Group chat](https://github.com/aozorayui/ai-plugin/blob/main/apps/fast_chat.js): `apps/fast_chat.js`
- [Image generation](https://github.com/aozorayui/ai-plugin/blob/main/apps/image.js): `apps/image.js`
- [Memory commands](https://github.com/aozorayui/ai-plugin/blob/main/apps/memory.js): `apps/memory.js`
- [Plugin management](https://github.com/aozorayui/ai-plugin/blob/main/apps/management.js): `apps/management.js`

### Agent and tools

- [Tool registry](https://github.com/aozorayui/ai-plugin/blob/main/tools/registry.js): `tools/registry.js`
- [Tool collection](https://github.com/aozorayui/ai-plugin/blob/main/tools/index.js): `tools/index.js`
- [Task planning](https://github.com/aozorayui/ai-plugin/blob/main/utils/agent_plan.js): `utils/agent_plan.js`
- [Agent runtime](https://github.com/aozorayui/ai-plugin/blob/main/utils/agent_runtime.js): `utils/agent_runtime.js`
- [Tool policy](https://github.com/aozorayui/ai-plugin/blob/main/utils/agent_policy.js): `utils/agent_policy.js`
- [Intent parsing](https://github.com/aozorayui/ai-plugin/blob/main/utils/tool_intent.js): `utils/tool_intent.js`
- [Tool results](https://github.com/aozorayui/ai-plugin/blob/main/utils/tool_result.js): `utils/tool_result.js`
- [Web search](https://github.com/aozorayui/ai-plugin/blob/main/tools/search.js): `tools/search.js`
- [Web fetch](https://github.com/aozorayui/ai-plugin/blob/main/tools/web_fetch.js): `tools/web_fetch.js`
- [Vision relay](https://github.com/aozorayui/ai-plugin/blob/main/tools/vision_relay.js): `tools/vision_relay.js`

### Conversation memory

- [Conversation history](https://github.com/aozorayui/ai-plugin/blob/main/model/conversation.js): `model/conversation.js`
- [SQLite persistence](https://github.com/aozorayui/ai-plugin/blob/main/utils/database.js): `utils/database.js`
- [Vector memory](https://github.com/aozorayui/ai-plugin/blob/main/utils/vector_memory.js): `utils/vector_memory.js`

### Models and platform

- [Model client](https://github.com/aozorayui/ai-plugin/blob/main/client/AiClient.js): `client/AiClient.js`
- [Plugin configuration](https://github.com/aozorayui/ai-plugin/blob/main/utils/config.js): `utils/config.js`
- [Shared utilities](https://github.com/aozorayui/ai-plugin/blob/main/utils/common.js): `utils/common.js`
- [Access control](https://github.com/aozorayui/ai-plugin/blob/main/utils/access.js): `utils/access.js`
- [Image handling](https://github.com/aozorayui/ai-plugin/blob/main/utils/image.js): `utils/image.js`
- [Model output](https://github.com/aozorayui/ai-plugin/blob/main/utils/model_output.js): `utils/model_output.js`
- [QQ face mapping](https://github.com/aozorayui/ai-plugin/blob/main/utils/qq_face.js): `utils/qq_face.js`

### Other components

- **User**
- **Model providers**
- **Yunzai-Bot**
- **Web sources**

## Connections

- User → Chat commands: sends command (evidence: `README.md`)
- User → Group chat: mentions bot (evidence: `README.md`)
- User → Image generation: requests image (evidence: `README.md`)
- User → Memory commands: manages memory (evidence: `README.md`)
- User → Plugin management: manages plugin (evidence: `README.md`)
- Chat commands → Model client: requests model (evidence: `apps/chat.js`)
- Chat commands → Conversation history: loads history (evidence: `apps/chat.js`)
- Chat commands → Access control: checks access (evidence: `apps/chat.js`)
- Chat commands → Agent runtime: runs tools (evidence: `README.md`)
- Chat commands → Image handling: handles images (evidence: `apps/chat.js`)
- Group chat → Model client: requests model (evidence: `README.md`)
- Group chat → Agent runtime: runs tools (evidence: `README.md`)
- Group chat → Tool collection: uses tools (evidence: `apps/fast_chat.js`)
- Group chat → Conversation history: shares memory (evidence: `README.md`)
- Image generation → Model client: requests image (evidence: `apps/image.js`)
- Memory commands → Conversation history: reads history (evidence: `README.md`)
- Memory commands → Model client: requests summaries (evidence: `README.md`)
- Conversation history → SQLite persistence: reads and writes (evidence: `model/conversation.js`)
- SQLite persistence → Vector memory: queues indexing (evidence: `utils/database.js`)
- Agent runtime → Task planning: uses task plans (evidence: `utils/agent_runtime.js`)
- Agent runtime → Tool registry: dispatches tools (evidence: `README.md`)
- Tool registry → Intent parsing: filters intent (evidence: `tools/registry.js`)
- Tool registry → Tool policy: applies policy (evidence: `tools/registry.js`)
- Tool registry → Tool results: normalizes results (evidence: `tools/registry.js`)
- Tool collection → Tool registry: exports registry (evidence: `tools/index.js`)
- Tool collection → Web search: exports search (evidence: `tools/index.js`)
- Tool collection → Web fetch: exports fetch (evidence: `tools/index.js`)
- Tool collection → Vision relay: exports relay (evidence: `tools/index.js`)
- Web search → Web sources: searches sources (evidence: `README.md`)
- Web fetch → Web sources: fetches pages (evidence: `README.md`)
- Model client → Model providers: routes requests (evidence: `README.md`)
- Model client → Plugin configuration: loads settings (evidence: `client/AiClient.js`)
- Model client → Shared utilities: uses networking (evidence: `client/AiClient.js`)
- Chat commands → QQ face mapping: uses mappings (evidence: `apps/chat.js`)
- Chat commands → Model output: formats response (evidence: `apps/chat.js`)
- Vector memory → SQLite persistence: indexes records (evidence: `utils/database.js`)
- Plugin management → Plugin configuration: updates settings (evidence: `apps/management.js`)
- Yunzai-Bot → Chat commands: loads plugin command
