From 8704bce444fd576b8600a04414aa90d1fe29eda5 Mon Sep 17 00:00:00 2001 From: Rin Date: Thu, 8 Jan 2026 23:23:40 +0800 Subject: [PATCH] docs(minecraft): update with current file structure --- services/minecraft/README.md | 51 ++++++++++++++++++++++-------------- 1 file changed, 31 insertions(+), 20 deletions(-) diff --git a/services/minecraft/README.md b/services/minecraft/README.md index 8eb604827..c6330ae87 100644 --- a/services/minecraft/README.md +++ b/services/minecraft/README.md @@ -215,28 +215,39 @@ Player: "build a house" ``` src/ -├── cognitive/ # 🧠 Three-layer cognitive system -│ ├── perception/ # Layer A: Event processing -│ │ └── event-manager.ts -│ ├── reflex/ # Layer B: Instant reactions +├── cognitive/ # 🧠 Perception → Reflex → Conscious → Action +│ ├── perception/ # Event ingestion +│ │ └── event-manager.ts # Normalizes raw Mineflayer events +│ ├── reflex/ # Fast, rule-based reactions │ │ └── reflex-manager.ts -│ ├── conscious/ # Layer C: LLM-powered reasoning -│ │ ├── orchestrator.ts -│ │ ├── completion.ts -│ │ ├── prompt.ts -│ │ └── handler.ts -│ ├── container.ts # Dependency injection -│ ├── index.ts # Cognitive system entry -│ └── types.ts # Shared type definitions -├── agents/ # Specialized AI agents -│ ├── action/ # Action execution agent -│ ├── planning/ # Goal planning agent -│ └── chat/ # Conversation agent +│ ├── conscious/ # LLM-powered reasoning +│ │ ├── blackboard.ts # Shared working memory +│ │ ├── brain.ts # Core reasoning loop/orchestration +│ │ ├── completion.ts # LLM completion helper +│ │ ├── handler.ts # Routes stimuli into the brain +│ │ ├── task-manager.ts # Manages concurrent tasks +│ │ ├── task-state.ts # Task lifecycle enums/helpers +│ │ └── prompts/ # Prompt definitions (e.g., brain-prompt.ts) +│ ├── action/ # Task execution layer +│ │ ├── task-executor.ts # Executes planned steps with retries +│ │ └── types.ts +│ ├── container.ts # Dependency injection wiring +│ ├── index.ts # Cognitive system entrypoint +│ └── types.ts # Shared cognitive types +├── agents/ # Specialized agents +│ ├── action/ # Low-level actuator bridge +│ ├── planning/ # Goal planner (LLM) +│ ├── chat/ # Conversational responses +│ └── memory/ # Memory-related helpers ├── libs/ -│ └── mineflayer/ # Mineflayer bot wrapper -├── skills/ # Atomic bot capabilities -├── composables/ # Reusable functions -└── utils/ # Helper utilities +│ └── mineflayer/ # Mineflayer bot wrapper/adapters +├── skills/ # Atomic bot capabilities +├── composables/ # Reusable functions (config, etc.) +├── plugins/ # Mineflayer/bot plugins +├── web/ # Debug web dashboard +├── utils/ # Helpers +├── debug-server.ts # Local debug server entry +└── main.ts # Bot entrypoint ``` ### 🎯 Design Principles