How hfutcoder/cloud-cold-backend works
Cloud-Code is a Spring Boot AI assistant backend. A user request enters the agent API, where the agent service preprocesses skills, retrieves conversation-bound knowledge and long-term memories, then selects a fast, plan-execute, or coordinator/worker agent and streams results over SSE. Separate product branches provide skill discovery and script execution, PDF ingestion and hybrid retrieval, human approval/resume, chat history, and user/pet memory. The README documents the principal flows; the excerpts additionally confirm document ingestion’s MinIO, document-record, knowledge-preparation, and chunk-storage calls. Other unsampled subsystem links are based on README documentation.
Main entry points: AgentServiceImpl.java Agent service · KnowledgeServiceImpl.java Knowledge service · SimpleReactAgent.java Agent modes · KnowledgeDocumentIngestionServiceImpl.java PDF ingestion
Components 27
API and accounts
- Agent API
src/main/java/com/shenchen/cloudcoldagent/controller/agent/AgentController.java - Approval API
src/main/java/com/shenchen/cloudcoldagent/controller/hitl/HitlCheckpointController.java - Knowledge API
src/main/java/com/shenchen/cloudcoldagent/controller/knowledge/KnowledgeController.java - Document API
src/main/java/com/shenchen/cloudcoldagent/controller/knowledge/DocumentController.java - Account API
src/main/java/com/shenchen/cloudcoldagent/controller/user/UserController.java - User service
src/main/java/com/shenchen/cloudcoldagent/service/user/impl/UserServiceImpl.java
Agent runtime
- Agent service
src/main/java/com/shenchen/cloudcoldagent/service/agent/impl/AgentServiceImpl.java - Agent modes
src/main/java/com/shenchen/cloudcoldagent/agent/SimpleReactAgent.java - Plan-execute
src/main/java/com/shenchen/cloudcoldagent/agent/PlanExecuteAgent.java - Coordinator
src/main/java/com/shenchen/cloudcoldagent/agent/multiagent/CoordinatorAgent.java - Worker pool
src/main/java/com/shenchen/cloudcoldagent/agent/multiagent/worker/WorkerPool.java - Worker agent
src/main/java/com/shenchen/cloudcoldagent/agent/multiagent/worker/WorkerAgent.java - SSE events
src/main/java/com/shenchen/cloudcoldagent/common/AgentStreamEventFactory.java - HITL approval
src/main/java/com/shenchen/cloudcoldagent/service/hitl/impl/HitlExecutionServiceImpl.java
Skill workflow
- Skill workflow
src/main/java/com/shenchen/cloudcoldagent/workflow/skill/service/impl/SkillWorkflowServiceImpl.java - Skill service
src/main/java/com/shenchen/cloudcoldagent/service/skill/impl/SkillServiceImpl.java - Skill registry
src/main/java/com/shenchen/cloudcoldagent/registry/CachingSkillRegistry.java
Knowledge retrieval
- PDF ingestion
src/main/java/com/shenchen/cloudcoldagent/service/knowledge/impl/KnowledgeDocumentIngestionServiceImpl.java - Knowledge service
src/main/java/com/shenchen/cloudcoldagent/service/knowledge/impl/KnowledgeServiceImpl.java - PDF processing
src/main/java/com/shenchen/cloudcoldagent/document/extract/reader/PdfMultimodalProcessor.java - Chunk storage
src/main/java/com/shenchen/cloudcoldagent/document/load/store/StoreService.java - Search indexes
src/main/java/com/shenchen/cloudcoldagent/service/storage/ElasticSearchService.java - Object storage
src/main/java/com/shenchen/cloudcoldagent/service/storage/MinioService.java
Conversation and memory
- Chat history
src/main/java/com/shenchen/cloudcoldagent/memory/store/MysqlChatMemoryRepository.java - Long-term memory
src/main/java/com/shenchen/cloudcoldagent/service/usermemory/impl/UserLongTermMemoryServiceImpl.java - Memory scheduler
src/main/java/com/shenchen/cloudcoldagent/job/UserLongTermMemoryScheduler.java
Other components
- User
Connections 26
- User → Agent API: sends request
- Agent API → Agent service: calls
- Agent service → Skill workflow: preprocesses skills
- Agent service → Knowledge service: pre-retrieves knowledge
- Agent service → Long-term memory: recalls memories
- Agent service → Agent modes: dispatches
- Agent modes → Plan-execute: uses thinking mode
- Agent modes → Coordinator: uses expert mode
- Coordinator → Worker pool: dispatches tasks
- Worker pool → Worker agent: runs workers
- Agent service → SSE events: streams events
- Approval API → Agent service: resumes agent
- Agent service → HITL approval: intercepts tools
- Skill workflow → Skill service: loads skills
- Skill service → Skill registry: uses registry
- Document API → PDF ingestion: uploads document
- PDF ingestion → Object storage: uploads file
src/main/java/com/shenchen/cloudcoldagent/service/knowledge/impl/KnowledgeDocumentIngestionServiceImpl.java - PDF ingestion → Knowledge service: prepares and stores
src/main/java/com/shenchen/cloudcoldagent/service/knowledge/impl/KnowledgeDocumentIngestionServiceImpl.java - Knowledge service → PDF processing: parses PDF
- Knowledge service → Chunk storage: stores chunks
- Chunk storage → Search indexes: indexes chunks
src/main/java/com/shenchen/cloudcoldagent/document/load/store/StoreService.java - Knowledge service → Search indexes: searches indexes
- Knowledge API → Knowledge service: manages knowledge
- Agent service → Chat history: uses chat memory
- Long-term memory → Memory scheduler: scans pending sessions
- Account API → User service: manages accounts