docs: update README and TODO with Autonomous Mode
- Add Autonomous Mode section in README with usage examples - Add new Phase 9: Autonomous Mode to TODO (completed) - Update project statistics (8,300 LOC, 35+ classes) - Version bump to 0.2.0 - Document both entry points (main.py and autonomous_mode.py) Users can now choose between: - Interactive mode: Standard gameplay with decision engine - Autonomous mode: LLM-orchestrated exploration and learning
This commit is contained in:
1 parent
a1a0ad5840
commit
72a2f1ec45
2 files changed
+54
-9
No files matched your search
@@ -129,6 +129,35 @@ monitoring:
|
||||
port: 8080
|
||||
```
|
||||
|
||||
## 🎮 Autonomous Mode
|
||||
|
||||
**Modalità completamente autonoma** dove il bot esplora, impara e cresce da solo guidato dall'LLM:
|
||||
|
||||
```bash
|
||||
# Avvia esplorazione autonoma per 60 minuti
|
||||
python -m src.autonomous_mode --duration 60
|
||||
|
||||
# Con config personalizzata
|
||||
python -m src.autonomous_mode --config my_config.yaml --duration 120
|
||||
```
|
||||
|
||||
**Caratteristiche:**
|
||||
- 🤖 **LLM-First**: L'LLM prende tutte le decisioni strategiche
|
||||
- 🗺️ **Auto-Mapping**: Esplora e mappa automaticamente il mondo
|
||||
- 🧠 **Learning**: Memorizza stanze pericolose, NPC utili, pattern
|
||||
- 📊 **Session Logging**: Salva tutto in `data/autonomous_sessions/`
|
||||
- 🎯 **Goal Dinamici**: Obiettivi di esplorazione e crescita
|
||||
- 🛡️ **Safety First**: Override automatico se HP critici
|
||||
|
||||
**Esempio di output:**
|
||||
```
|
||||
🚀 Avviata sessione autonoma: session_20240209_143022
|
||||
🧠 Decisione LLM: [explore] north
|
||||
Ragionamento: Uscita non esplorata, pericolo basso
|
||||
🔍 Scoperta: [room] Village Square: You are standing in...
|
||||
📄 Log completo: data/autonomous_sessions/session_20240209_143022.json
|
||||
```
|
||||
|
||||
## Configurable Embedding Models
|
||||
|
||||
Choose the best embedding model for semantic room search:
|
||||
|
||||
@@ -68,7 +68,17 @@ This document outlines the implementation status of the MUD AI Player.
|
||||
- [x] **Statistics**: Room count, exit count, session info
|
||||
- [x] **Vitals Display**: HP/MP/SP bars and values
|
||||
|
||||
## 🔄 Phase 9: Testing & Quality Assurance
|
||||
## ✅ Phase 9: Autonomous Mode (NEW!)
|
||||
|
||||
- [x] **LLM Orchestrator**: LLM-first decision making system
|
||||
- [x] **Autonomous Mode**: Standalone autonomous exploration entry point
|
||||
- [x] **Session Logging**: Structured JSON logs for each session
|
||||
- [x] **Learning Engine**: Memory for dangerous rooms, valuable NPCs, patterns
|
||||
- [x] **Game Context**: Complete game state awareness for LLM
|
||||
- [x] **Dynamic Goals**: Automatic exploration and growth objectives
|
||||
- [x] **Safety Overrides**: Automatic retreat on low HP/high danger
|
||||
|
||||
## 🔄 Phase 10: Testing & Quality Assurance
|
||||
|
||||
- [x] **Unit Tests**: 17 test files covering all major components
|
||||
- [x] **Test Coverage**: ~2,500 lines of test code
|
||||
@@ -77,7 +87,7 @@ This document outlines the implementation status of the MUD AI Player.
|
||||
- [ ] **End-to-End Tests**: Integration tests with mock MUD server (planned)
|
||||
- [ ] **Performance Tests**: Benchmark for large maps (planned)
|
||||
|
||||
## 🔄 Phase 10: Documentation
|
||||
## 🔄 Phase 11: Documentation
|
||||
|
||||
- [x] **README.md**: Comprehensive project overview
|
||||
- [x] **Architecture.md**: System design documentation
|
||||
@@ -108,18 +118,24 @@ This document outlines the implementation status of the MUD AI Player.
|
||||
|
||||
## 📊 Implementation Statistics
|
||||
|
||||
- **Total Lines of Code**: ~7,500
|
||||
- **Total Lines of Code**: ~8,300 (+780 nuove per Autonomous Mode)
|
||||
- **Test Coverage**: ~2,500 lines (17 test files)
|
||||
- **Documentation**: ~3,000 lines
|
||||
- **Modules**: 8 major modules
|
||||
- **Components**: 30+ classes
|
||||
- **Documentation**: ~3,200 lines
|
||||
- **Modules**: 9 major modules (incl. Autonomous)
|
||||
- **Components**: 35+ classes
|
||||
- **Entry Points**: 2 (main.py + autonomous_mode.py)
|
||||
- **Test Pass Rate**: 100%
|
||||
|
||||
## 🎯 Current Status
|
||||
|
||||
**Version**: 0.1.0
|
||||
**Status**: Feature Complete ✅
|
||||
**Version**: 0.2.0
|
||||
**Status**: Autonomous Mode Available ✅
|
||||
**Ready for Testing**: Yes
|
||||
**Production Ready**: Stabilization & testing phase
|
||||
**Production Ready**: Stabilization phase
|
||||
|
||||
### 🎮 Modalità Disponibili
|
||||
|
||||
1. **Interactive Mode** (`main.py`): Modalità standard con decision engine
|
||||
2. **Autonomous Mode** (`autonomous_mode.py`): Esplorazione completamente autonoma con LLM
|
||||
|
||||
The MUD AI Player is functionally complete with all core features implemented. The current focus is on testing, bug fixes, and documentation improvements before a stable release.
|
||||
Reference in new issue
Block a user