truetype
eacc946868
LLM fixes: - _try_repair_json() — ripara JSON malformato (apici, virgole trailing) - _strip_json_from_text() — rimuove residui JSON dalla narration - parse_tool_call() — rimuove troncamento 200 caratteri dal fallback DM fixes: - Fallback euristico quando params vuoti (dm.py) - Estrazione narrazione da dm_override/narrate params.params.text Prompt (prompts.py): - Vietati termini tecnici/scientifici/anacronistici (HPLC, laser, ...) - Aggiunto vocabolario fantasy obbligatorio Server (server.py): - dm_cycle in ThreadPoolExecutor per non bloccare WS ping - WebSocketDisconnect gestiti - Rimosso import inesistente db_schema Frontend (index.html): - Nascosti tool name dalla chat - Personaggio -> PG, connessioni aree con nomi Infrastruttura: - Switch da openrouter/free a DeepSeek V4 Flash via OpenCode Go - pyproject.toml, Dockerfile, docker-compose.yml, start.sh - .env auto-load (start.sh) - Funnel Lv0 (funnel.py) — creazione PG livello 0 Docs: architecture, database, setup, game mechanics, codebase ref
3.1 KiB
3.1 KiB
DCC RPG — AI Dungeon Master: Documentazione
Panoramica
Questo progetto implementa un Dungeon Master virtuale per il gioco di ruolo Dungeon Crawl Classics (regolamento introduttivo italiano). Il sistema usa un LLM (Ollama/OpenRouter) per la narrazione e l'interpretazione delle azioni, mentre un motore Python deterministico gestisce le meccaniche di gioco (tiri, combattimento, inventario).
Pattern architetturale: Neon Scratch Lounge (separazione Reasoning/Execution) Avventura: La Tomba del Mago Guerriero (9 aree) Target: On-premise, CPU-only, singolo giocatore, browser
Documenti
| File | Contenuto |
|---|---|
architecture.md |
Architettura, pattern NSL, data flow, flusso turno |
codebase-reference.md |
Tutti i moduli, API pubbliche, entry point |
database-schema.md |
Schema SQLite, tabelle, migrazioni, CRUD |
setup-guide.md |
Come avviare, configurare, connettere LLM |
adventure-data.md |
Struttura dati avventura, aree, mostri, enigmi |
game-mechanics.md |
Regole DCC implementate (dadi, classi, combattimento) |
development-guide.md |
Come estendere: nuovi tool, provider, aree |
Stack Tecnologico
| Componente | Tecnologia |
|---|---|
| LLM | Ollama (gemma2:9b) / OpenRouter / OpenAI-compatible |
| Backend | Python 3.10+ + FastAPI + uvicorn |
| Frontend | HTML + CSS + JS vanilla |
| Database | SQLite (WAL mode) |
| HTTP | httpx (LLM calls) |
| WebSocket | FastAPI WebSocket (real-time game) |
Scheletro del Turno
Giocatore "Cerco nella stanza"
→ LLM reasoning (prompt + contesto)
→ LLM risponde: {"tool": "ability_check", "params": {...}, "narration": "..."}
→ Esecuzione tool deterministico
→ Persistenza stato (SQLite)
→ Risposta al giocatore (narrazione + meccaniche)
Struttura Directory
rpg/
├── src/
│ ├── engine/ # Core game engine (DM, LLM, tools, dice, DB)
│ └── web/ # FastAPI server + frontend statico
├── data/ # SQLite DB, avventura JSON, tabelle critici
├── docs/ # Design doc originale
├── docs_dev/ # Questa documentazione
├── knowledge/ # 15 file knowledge base DCC
├── input/ # PDF sorgente, reference booklet
├── ocr_full/ # OCR output files
├── graphify-out/ # Grafo concettuale (62 nodi)
└── tests/ # Test (da popolare)
Stato Progetto (CHECKLIST.md)
Fasi completate:
- ✅ Pattern architetturale NSL analizzato e documentato
- ✅ OCR pipeline (22 screenshot + 41 pagine PDF = ~58K parole)
- ✅ Pulizia OCR (60 correzioni dadi, 11 testuali)
- ✅ Knowledge Base strutturata (15 file, ~3708 righe)
- ✅ Grafo concettuale (Graphify, 62 nodi, 27 archi)
- ✅ Avventura completata (9 aree + background)
Fase 0-4 implementata (codice):
- ✅ Backend core: DM cycle, tool registry, dice engine
- ✅ LLM integration: multi-provider, prompt template, parser
- ✅ Dati adventure machine-readable: JSON aree/mostri/quest
- ✅ DB schema: 8 tabelle, CRUD, migrazioni
- ✅ Frontend: WebSocket, chat, stato personaggio, mappa
- ✅ Heuristic fallback: keyword parser per quando LLM fallisce