How siri-ming/xingchen-agent works
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: AgentController.java Agent endpoints · store.js Chat state · App.vue App shell · AuthService.java Authentication
Components 29
Web interface
- App shell
frontend/src/App.vue - Chat state
frontend/src/store.js - API helpers
frontend/src/api.js - Chat workspace
frontend/src/components/ChatArea.vue - Skill manager
frontend/src/components/SkillModal.vue - File panel
frontend/src/components/FilePanel.vue - Message display
frontend/src/components/MessageItem.vue
Backend services
- Agent endpoints
src/main/java/com/xingchen/xingchenagent/controller/AgentController.java - Auth endpoints
src/main/java/com/xingchen/xingchenagent/controller/AuthController.java - Skill endpoints
src/main/java/com/xingchen/xingchenagent/controller/SkillController.java - Authentication
src/main/java/com/xingchen/xingchenagent/service/AuthService.java - Conversation service
src/main/java/com/xingchen/xingchenagent/service/ConversationService.java - File service
src/main/java/com/xingchen/xingchenagent/service/FileService.java - Skill service
src/main/java/com/xingchen/xingchenagent/service/SkillService.java - Recommendations
src/main/java/com/xingchen/xingchenagent/service/RecommendService.java
Agent and models
- Agent runtime
src/main/java/com/xingchen/xingchenagent/agent/BaseAgent.java - Web search tool
src/main/java/com/xingchen/xingchenagent/tool/TavilySearchTool.java - Agent messages
io/agentscope/core/message/Msg.java - Message blocks
io/agentscope/core/message/ContentBlock.java - Chat model API
io/agentscope/core/model/ChatModelBase.java - DashScope model
io/agentscope/extensions/model/dashscope/DashScopeChatModel.java
Persistence and files
- Chat history
src/main/java/com/xingchen/xingchenagent/entity/ChatHistory.java - Conversations
src/main/java/com/xingchen/xingchenagent/entity/Conversation.java - File records
src/main/java/com/xingchen/xingchenagent/entity/UploadedFile.java - Object storage
src/main/java/com/xingchen/xingchenagent/service/MinioService.java - Skill records
src/main/java/com/xingchen/xingchenagent/entity/SkillInfo.java - User records
src/main/java/com/xingchen/xingchenagent/entity/UserInfo.java
Other components
- User
- QQ OAuth
Connections 26
- User → App shell: uses
- App shell → Chat state: reads state
frontend/src/App.vue - App shell → Chat workspace: renders
frontend/src/App.vue - App shell → Skill manager: renders
frontend/src/App.vue - Chat workspace → Chat state: uses state
frontend/src/components/ChatArea.vue - File panel → Chat state: uses state
frontend/src/components/FilePanel.vue - Message display → Chat state: reads state
- Skill manager → Chat state: uses state
frontend/src/components/SkillModal.vue - Chat state → API helpers: calls
frontend/src/store.js - Agent endpoints → Conversation service: manages
src/main/java/com/xingchen/xingchenagent/controller/AgentController.java - Agent endpoints → File service: manages
src/main/java/com/xingchen/xingchenagent/controller/AgentController.java - Agent endpoints → Chat history: queries
src/main/java/com/xingchen/xingchenagent/controller/AgentController.java - Agent endpoints → Conversations: uses
src/main/java/com/xingchen/xingchenagent/controller/AgentController.java - Agent endpoints → File records: uses
src/main/java/com/xingchen/xingchenagent/controller/AgentController.java - Agent endpoints → Recommendations: requests
src/main/java/com/xingchen/xingchenagent/controller/AgentController.java - Auth endpoints → Authentication: delegates to
src/main/java/com/xingchen/xingchenagent/controller/AuthController.java - Authentication → User records: queries
src/main/java/com/xingchen/xingchenagent/service/AuthService.java - Authentication → QQ OAuth: exchanges OAuth
src/main/java/com/xingchen/xingchenagent/service/AuthService.java - Skill endpoints → Skill service: delegates to
src/main/java/com/xingchen/xingchenagent/controller/SkillController.java - Skill service → Skill records: persists
src/main/java/com/xingchen/xingchenagent/service/SkillService.java - Skill service → Object storage: stores skill files
src/main/java/com/xingchen/xingchenagent/service/SkillService.java - File service → File records: persists
src/main/java/com/xingchen/xingchenagent/service/FileService.java - File service → Object storage: stores and reads
src/main/java/com/xingchen/xingchenagent/service/FileService.java - Agent messages → Message blocks: contains blocks
io/agentscope/core/message/Msg.java - Chat model API → Agent messages: accepts messages
io/agentscope/core/model/ChatModelBase.java - Chat model API → DashScope model: implemented by
io/agentscope/extensions/model/dashscope/DashScopeChatModel.java