# siri-ming/xingchen-agent architecture

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

- Interactive diagram: https://gitdiagram.com/siri-ming/xingchen-agent
- Repository: https://github.com/siri-ming/xingchen-agent

## Overview

XingChen is a web-based conversational assistant with accounts, conversation history, file handling, skills, and agent responses. The visible user workflow is the Vue interface and store coordinating chat state and API helpers; the backend exposes agent, authentication, and skill controllers, with the agent controller managing conversation and file operations. The tree also includes AgentScope message/model abstractions and a DashScope provider. Backend chat execution and several integrations are only partially evidenced here, so uncertain connections are omitted rather than inferred.

Main entry points: [`src/main/java/com/xingchen/xingchenagent/controller/AgentController.java`](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/controller/AgentController.java) (Agent endpoints), [`frontend/src/store.js`](https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/store.js) (Chat state), [`frontend/src/App.vue`](https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/App.vue) (App shell), [`src/main/java/com/xingchen/xingchenagent/service/AuthService.java`](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/AuthService.java) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Web interface"]
  node_app["App shell<br/>[App.vue]"]
  node_store["Chat state<br/>[store.js]"]
  node_api["API helpers<br/>[api.js]"]
  node_chatui["Chat workspace<br/>[ChatArea.vue]"]
  node_skillsui["Skill manager<br/>[SkillModal.vue]"]
  node_filesui["File panel<br/>[FilePanel.vue]"]
  node_messagesui["Message display<br/>[MessageItem.vue]"]
end

subgraph group_backend["Backend services"]
  node_agentcontroller["Agent endpoints"]
  node_authcontroller["Auth endpoints"]
  node_skillcontroller["Skill endpoints"]
  node_authservice["Authentication<br/>[AuthService.java]"]
  node_conversations["Conversation service"]
  node_fileservice["File service<br/>[FileService.java]"]
  node_skillsvc["Skill service<br/>[SkillService.java]"]
  node_recommend["Recommendations"]
end

subgraph group_agent["Agent and models"]
  node_agentcore["Agent runtime<br/>[BaseAgent.java]"]
  node_search["Web search tool"]
  node_msg["Agent messages<br/>[Msg.java]"]
  node_content["Message blocks<br/>[ContentBlock.java]"]
  node_chatmodel["Chat model API<br/>[ChatModelBase.java]"]
  node_dashscope["DashScope model"]
end

subgraph group_data["Persistence and files"]
  node_history[("Chat history<br/>[ChatHistory.java]")]
  node_conversation[("Conversations<br/>[Conversation.java]")]
  node_uploadedfile[("File records<br/>[UploadedFile.java]")]
  node_minio["Object storage<br/>[MinioService.java]"]
  node_skillinfo[("Skill records<br/>[SkillInfo.java]")]
  node_userdb[("User records<br/>[UserInfo.java]")]
end

node_user(("User"))
node_qq["QQ OAuth"]

node_user -->|"uses"| node_app
node_app -->|"reads state"| node_store
node_app -->|"renders"| node_chatui
node_app -->|"renders"| node_skillsui
node_chatui -->|"uses state"| node_store
node_filesui -->|"uses state"| node_store
node_messagesui -.->|"reads state"| node_store
node_skillsui -->|"uses state"| node_store
node_store -->|"calls"| node_api
node_agentcontroller -->|"manages"| node_conversations
node_agentcontroller -->|"manages"| node_fileservice
node_agentcontroller -->|"queries"| node_history
node_agentcontroller -->|"uses"| node_conversation
node_agentcontroller -->|"uses"| node_uploadedfile
node_agentcontroller -->|"requests"| node_recommend
node_authcontroller -->|"delegates to"| node_authservice
node_authservice -->|"queries"| node_userdb
node_authservice -->|"exchanges OAuth"| node_qq
node_skillcontroller -->|"delegates to"| node_skillsvc
node_skillsvc -->|"persists"| node_skillinfo
node_skillsvc -->|"stores skill files"| node_minio
node_fileservice -->|"persists"| node_uploadedfile
node_fileservice -->|"stores and reads"| node_minio
node_msg -->|"contains blocks"| node_content
node_chatmodel -->|"accepts messages"| node_msg
node_chatmodel -->|"implemented by"| node_dashscope

click node_app "https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/App.vue"
click node_store "https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/store.js"
click node_api "https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/api.js"
click node_chatui "https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/components/ChatArea.vue"
click node_skillsui "https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/components/SkillModal.vue"
click node_filesui "https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/components/FilePanel.vue"
click node_messagesui "https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/components/MessageItem.vue"
click node_agentcontroller "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/controller/AgentController.java"
click node_authcontroller "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/controller/AuthController.java"
click node_skillcontroller "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/controller/SkillController.java"
click node_authservice "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/AuthService.java"
click node_conversations "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/ConversationService.java"
click node_fileservice "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/FileService.java"
click node_skillsvc "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/SkillService.java"
click node_recommend "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/RecommendService.java"
click node_agentcore "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/agent/BaseAgent.java"
click node_search "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/tool/TavilySearchTool.java"
click node_msg "https://github.com/siri-ming/xingchen-agent/blob/master/io/agentscope/core/message/Msg.java"
click node_content "https://github.com/siri-ming/xingchen-agent/blob/master/io/agentscope/core/message/ContentBlock.java"
click node_chatmodel "https://github.com/siri-ming/xingchen-agent/blob/master/io/agentscope/core/model/ChatModelBase.java"
click node_dashscope "https://github.com/siri-ming/xingchen-agent/blob/master/io/agentscope/extensions/model/dashscope/DashScopeChatModel.java"
click node_history "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/entity/ChatHistory.java"
click node_conversation "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/entity/Conversation.java"
click node_uploadedfile "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/entity/UploadedFile.java"
click node_minio "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/MinioService.java"
click node_skillinfo "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/entity/SkillInfo.java"
click node_userdb "https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/entity/UserInfo.java"

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_app,node_store,node_api,node_chatui,node_skillsui,node_filesui,node_messagesui,node_user toneBlue
class node_agentcontroller,node_authcontroller,node_skillcontroller,node_authservice,node_conversations,node_fileservice,node_skillsvc,node_recommend toneAmber
class node_agentcore,node_search,node_msg,node_content,node_chatmodel,node_dashscope toneMint
class node_history,node_conversation,node_uploadedfile,node_minio,node_skillinfo,node_userdb toneRose
class node_qq toneIndigo
```

## Components

### Web interface

- [App shell](https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/App.vue): `frontend/src/App.vue`
- [Chat state](https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/store.js): `frontend/src/store.js`
- [API helpers](https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/api.js): `frontend/src/api.js`
- [Chat workspace](https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/components/ChatArea.vue): `frontend/src/components/ChatArea.vue`
- [Skill manager](https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/components/SkillModal.vue): `frontend/src/components/SkillModal.vue`
- [File panel](https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/components/FilePanel.vue): `frontend/src/components/FilePanel.vue`
- [Message display](https://github.com/siri-ming/xingchen-agent/blob/master/frontend/src/components/MessageItem.vue): `frontend/src/components/MessageItem.vue`

### Backend services

- [Agent endpoints](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/controller/AgentController.java): `src/main/java/com/xingchen/xingchenagent/controller/AgentController.java`
- [Auth endpoints](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/controller/AuthController.java): `src/main/java/com/xingchen/xingchenagent/controller/AuthController.java`
- [Skill endpoints](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/controller/SkillController.java): `src/main/java/com/xingchen/xingchenagent/controller/SkillController.java`
- [Authentication](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/AuthService.java): `src/main/java/com/xingchen/xingchenagent/service/AuthService.java`
- [Conversation service](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/ConversationService.java): `src/main/java/com/xingchen/xingchenagent/service/ConversationService.java`
- [File service](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/FileService.java): `src/main/java/com/xingchen/xingchenagent/service/FileService.java`
- [Skill service](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/SkillService.java): `src/main/java/com/xingchen/xingchenagent/service/SkillService.java`
- [Recommendations](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/RecommendService.java): `src/main/java/com/xingchen/xingchenagent/service/RecommendService.java`

### Agent and models

- [Agent runtime](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/agent/BaseAgent.java): `src/main/java/com/xingchen/xingchenagent/agent/BaseAgent.java`
- [Web search tool](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/tool/TavilySearchTool.java): `src/main/java/com/xingchen/xingchenagent/tool/TavilySearchTool.java`
- [Agent messages](https://github.com/siri-ming/xingchen-agent/blob/master/io/agentscope/core/message/Msg.java): `io/agentscope/core/message/Msg.java`
- [Message blocks](https://github.com/siri-ming/xingchen-agent/blob/master/io/agentscope/core/message/ContentBlock.java): `io/agentscope/core/message/ContentBlock.java`
- [Chat model API](https://github.com/siri-ming/xingchen-agent/blob/master/io/agentscope/core/model/ChatModelBase.java): `io/agentscope/core/model/ChatModelBase.java`
- [DashScope model](https://github.com/siri-ming/xingchen-agent/blob/master/io/agentscope/extensions/model/dashscope/DashScopeChatModel.java): `io/agentscope/extensions/model/dashscope/DashScopeChatModel.java`

### Persistence and files

- [Chat history](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/entity/ChatHistory.java): `src/main/java/com/xingchen/xingchenagent/entity/ChatHistory.java`
- [Conversations](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/entity/Conversation.java): `src/main/java/com/xingchen/xingchenagent/entity/Conversation.java`
- [File records](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/entity/UploadedFile.java): `src/main/java/com/xingchen/xingchenagent/entity/UploadedFile.java`
- [Object storage](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/service/MinioService.java): `src/main/java/com/xingchen/xingchenagent/service/MinioService.java`
- [Skill records](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/entity/SkillInfo.java): `src/main/java/com/xingchen/xingchenagent/entity/SkillInfo.java`
- [User records](https://github.com/siri-ming/xingchen-agent/blob/master/src/main/java/com/xingchen/xingchenagent/entity/UserInfo.java): `src/main/java/com/xingchen/xingchenagent/entity/UserInfo.java`

### Other components

- **User**
- **QQ OAuth**

## Connections

- User → App shell: uses
- App shell → Chat state: reads state (evidence: `frontend/src/App.vue`)
- App shell → Chat workspace: renders (evidence: `frontend/src/App.vue`)
- App shell → Skill manager: renders (evidence: `frontend/src/App.vue`)
- Chat workspace → Chat state: uses state (evidence: `frontend/src/components/ChatArea.vue`)
- File panel → Chat state: uses state (evidence: `frontend/src/components/FilePanel.vue`)
- Message display → Chat state: reads state
- Skill manager → Chat state: uses state (evidence: `frontend/src/components/SkillModal.vue`)
- Chat state → API helpers: calls (evidence: `frontend/src/store.js`)
- Agent endpoints → Conversation service: manages (evidence: `src/main/java/com/xingchen/xingchenagent/controller/AgentController.java`)
- Agent endpoints → File service: manages (evidence: `src/main/java/com/xingchen/xingchenagent/controller/AgentController.java`)
- Agent endpoints → Chat history: queries (evidence: `src/main/java/com/xingchen/xingchenagent/controller/AgentController.java`)
- Agent endpoints → Conversations: uses (evidence: `src/main/java/com/xingchen/xingchenagent/controller/AgentController.java`)
- Agent endpoints → File records: uses (evidence: `src/main/java/com/xingchen/xingchenagent/controller/AgentController.java`)
- Agent endpoints → Recommendations: requests (evidence: `src/main/java/com/xingchen/xingchenagent/controller/AgentController.java`)
- Auth endpoints → Authentication: delegates to (evidence: `src/main/java/com/xingchen/xingchenagent/controller/AuthController.java`)
- Authentication → User records: queries (evidence: `src/main/java/com/xingchen/xingchenagent/service/AuthService.java`)
- Authentication → QQ OAuth: exchanges OAuth (evidence: `src/main/java/com/xingchen/xingchenagent/service/AuthService.java`)
- Skill endpoints → Skill service: delegates to (evidence: `src/main/java/com/xingchen/xingchenagent/controller/SkillController.java`)
- Skill service → Skill records: persists (evidence: `src/main/java/com/xingchen/xingchenagent/service/SkillService.java`)
- Skill service → Object storage: stores skill files (evidence: `src/main/java/com/xingchen/xingchenagent/service/SkillService.java`)
- File service → File records: persists (evidence: `src/main/java/com/xingchen/xingchenagent/service/FileService.java`)
- File service → Object storage: stores and reads (evidence: `src/main/java/com/xingchen/xingchenagent/service/FileService.java`)
- Agent messages → Message blocks: contains blocks (evidence: `io/agentscope/core/message/Msg.java`)
- Chat model API → Agent messages: accepts messages (evidence: `io/agentscope/core/model/ChatModelBase.java`)
- Chat model API → DashScope model: implemented by (evidence: `io/agentscope/extensions/model/dashscope/DashScopeChatModel.java`)
