RAG local de Mind sur le serveur Minecraft (fiches + BM25 + pont modifié)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Cette révision appartient à :
Claude a révisé 2026-10-10 14:51:46 +02:00
1 Parent e9507333f6
révision f684023188
23 fichiers modifiés
+574

Aucun fichier ne correspond à votre recherche

+8
Voir le fichier
@@ -0,0 +1,8 @@
# Amis : /friend
mots-cles: friend, ami, amis, amitié, accès, donner accès, partager, claim, retirer, unadd, liste d'amis, inviter, construire chez moi, lui donner accès
statut: verifie
---
- /friend add <joueur> : donne à ce joueur l'accès à tous tes claims (il peut y construire et utiliser tes blocs). Il doit être connu du serveur.
- /friend unadd <joueur> : lui retire l'accès.
- /friend : affiche la liste de tes amis.
L'accès est donné pour tous tes claims d'un coup, pas chunk par chunk. Les amis ne servent qu'aux claims : pour se téléporter vers un ami, voir /tpa.
+9
Voir le fichier
@@ -0,0 +1,9 @@
# Claims : protéger sa base avec /claim
mots-cles: claim, unclaim, claims, protéger, protection, maison, base, griefing, voleur, chunk, coffre, sécuriser, empêcher, casser, construction, limite, 25, info
statut: verifie
---
/claim protège le chunk où tu te trouves (un carré de 16 x 16 blocs, sur toute la hauteur). Tu peux en protéger 25 au maximum. Pour protéger une grande base, claim plusieurs chunks côte à côte.
- /claim info : dit à qui appartient le chunk et combien de claims il te reste.
- /unclaim : libère le chunk (il faut en être le propriétaire).
Dans un chunk claimé par un autre joueur, tu ne peux pas casser, poser, ouvrir ni utiliser ses blocs (coffres, portes, machines Create...), ni abîmer ses cultures ou attaquer ses animaux ; les explosions et les perles d'ender sont aussi bloquées. Seuls le propriétaire et ses amis (/friend add) ont accès.
Je ne connais pas de règle sur la libération des claims abandonnés.
+14
Voir le fichier
@@ -0,0 +1,14 @@
# Toutes les commandes du serveur
mots-cles: commandes, commande, liste, aide, help, que faire, taper, utiles, quelles commandes, disponibles
statut: verifie
---
Commandes utiles pour les joueurs :
- /spawn : retour au spawn.
- /rtp : téléportation aléatoire dans la carte déjà explorée.
- /tpa <joueur>, /tpahere <joueur>, /tpaccept, /tpadeny, /tpacancel : téléportation entre joueurs.
- /sethome [nom], /home [nom], /homes, /delhome [nom] : tes points de retour (3 maximum).
- /claim, /unclaim, /claim info : protéger des chunks (25 maximum).
- /friend add <joueur>, /friend unadd <joueur>, /friend : gérer les amis qui ont accès à tes claims.
- /msg mind <message> : me parler en privé.
- /guide : le guide de bienvenue avec des boutons cliquables.
Je ne connais pas d'autres commandes pour les joueurs (pas de /back, /warp, économie, etc.).
+6
Voir le fichier
@@ -0,0 +1,6 @@
# Create et machines
mots-cles: create, aeronautics, new age, machines, engrenage, énergie, contraption, engin volant, avion, ferme automatique, lag, ram
statut: verifie
---
Le serveur a Create, avec Create Aeronautics (engins volants) et Create New Age (énergie). Je n'ai pas d'explications détaillées sur leurs recettes dans mes fiches du serveur.
Protège tes machines avec /claim. Les règles sur la taille des machines ne sont pas encore décidées.
+6
Voir le fichier
@@ -0,0 +1,6 @@
# La commande /guide
mots-cles: guide, /guide, bienvenue, accueil, menu, boutons, cliquer, tutoriel, débuter, commencer, nouveau, début
statut: verifie
---
/guide affiche le guide de bienvenue : un message de Mind avec un bouton [Répondre] qui ouvre un menu cliquable : Commandes, Mods du serveur, Règles. Les règles ne sont pas encore écrites dans le guide.
Au spawn, tu peux suivre l'avenue et marcher sur la plaque de pression : elle t'envoie quelque part sur la carte.
+10
Voir le fichier
@@ -0,0 +1,10 @@
# Homes : /sethome, /home, /homes, /delhome
mots-cles: home, homes, sethome, delhome, maison, base, point de retour, enregistrer, domicile, nombre, limite, maximum, rentrer
statut: verifie
---
- /sethome [nom] : enregistre un home là où tu es. Tu peux en avoir 3 au maximum. Sans nom, le premier libre est utilisé (1, 2, 3).
- /home [nom] : te téléporte à ce home. Avec un seul home, /home seul suffit ; avec plusieurs, il te montre la liste.
- /homes : liste tes homes ; clique sur un nom pour y aller.
- /delhome [nom] : supprime un home (le [x] de /homes pré-remplit la commande, tu dois la valider).
Un nom de home fait 1 à 16 caractères : lettres sans accents, chiffres et tirets ; majuscules et minuscules sont identiques.
Délai de 3 secondes avant la téléportation : reste immobile. Impossible de définir un home dans le chunk claimé par un autre joueur, sur la zone du spawn, ou hors Overworld/Nether/End. Si l'arrivée n'est pas sûre, la téléportation est refusée avec un message.
+6
Voir le fichier
@@ -0,0 +1,6 @@
# Fonctions qui n'existent pas
mots-cles: back, warp, warps, économie, argent, shop, boutique, kit, kits, fly, vol, gamemode, creatif, créatif, grade, rang, tpall, nick, discord, ip, adresse
statut: verifie
---
Il n'y a pas, à ma connaissance, de /back, de warps, d'économie ni de boutique, de kits, de grades ou de commande de vol sur ce serveur. Je ne promets aucune de ces fonctions.
Pour une demande de nouvelle fonction, parle à un admin du serveur. Je ne peux pas donner l'adresse du serveur : demande-la à un admin.
+13
Voir le fichier
@@ -0,0 +1,13 @@
# Mods du serveur
mots-cles: mods, mod, modpack, liste des mods, installés, quels mods, ajouts, create, terralith, tectonic, gravestone, veinminer, sodium, lithium, shader, optimisation, launcher, installer, installation
statut: verifie
---
Ajouts du serveur :
- Create, Create Aeronautics et Create New Age : machines, engrenages, énergie, engins volants.
- Terralith et Tectonic : paysages plus variés, montagnes plus hautes.
- Gravestone : une tombe garde tes affaires à ta mort.
- Simple Voice Chat : chat vocal de proximité (touche V pour les réglages).
- Veinminer, Hybrid Birds, Clumps (orbes d'expérience regroupés), armure en netherite pour chevaux.
- Le shader Gastinel Wind : le vent anime arbres, feuilles et eau selon la météo.
- Des mods d'optimisation (Sodium, Lithium, FerriteCore, ModernFix...) et des sons d'ambiance.
Le launcher du serveur installe tout automatiquement.
+7
Voir le fichier
@@ -0,0 +1,7 @@
# Mort et tombe (Gravestone)
mots-cles: mort, morts, mourant, meurt, décès, mourir, meurs, tombe, gravestone, affaires, objets, récupérer, inventaire, perdu, coordonnées, réapparition, respawn, stuff
statut: verifie
---
Quand tu meurs, le mod Gravestone place une tombe qui garde tes affaires. Retourne à l'endroit de ta mort pour les récupérer.
À ta réapparition, un message rouge t'indique où tu es mort : « Tu es mort en X Y Z (dimension) ». Clique dessus pour copier les coordonnées. Le message est aussi dans ton historique de chat.
Je ne connais pas les détails de la tombe (durée, qui peut l'ouvrir) : regarde-la en jeu.
+6
Voir le fichier
@@ -0,0 +1,6 @@
# Me parler : /msg mind
mots-cles: msg, mind, parler, question, demander, aide, ia, assistant, chuchote, privé, contacter, discuter, tell, w
statut: verifie
---
Je suis Mind, l'IA du serveur. Pour me poser une question en privé, tape /msg mind suivi de ta question. Ma réponse n'est visible que par toi, en gris italique (« Mind vous chuchote : ... »).
Je réponds à une question à la fois, en quelques phrases. Je connais les commandes et le fonctionnement du serveur, et je peux t'aider sur Minecraft (recettes, mobs...). Si je ne sais pas, je le dis.
+6
Voir le fichier
@@ -0,0 +1,6 @@
# Règles du serveur (non publiées)
mots-cles: règles, règle, regle, interdit, autorisé, ban, bannir, sanction, triche, grief, griefing, pvp, signaler, admin, tricher, insulte, mute, exclusion, avertissement
statut: brouillon
---
Les règles du serveur ne sont pas encore validées ni publiées : elles arrivent bientôt. Je ne peux donc pas dire ce qui est autorisé ou interdit en détail, ni les sanctions, ni comment signaler quelqu'un.
Le bon sens s'applique : respecte les autres joueurs, ne casse pas et ne vole pas ce qui ne t'appartient pas, et protège ta base avec /claim. Pour une question sur les règles, demande à un admin.
+8
Voir le fichier
@@ -0,0 +1,8 @@
# Commande /rtp (téléportation aléatoire)
mots-cles: rtp, /rtp, aléatoire, random, au hasard, explorer, téléportation aléatoire, protection, invulnérable, hasard, découvrir
statut: verifie
---
/rtp te téléporte à un endroit aléatoire de la carte déjà explorée. Aucun nouveau terrain n'est généré, et l'endroit est choisi sûr (pas dans l'eau, la lave, ni chez un autre joueur claimé).
Délai de 3 secondes : reste immobile, c'est annulé si tu bouges ou si tu es blessé. Recharge de 1 seconde.
Après l'arrivée, tu es protégé 15 secondes contre les dégâts (pas contre le vide). La protection s'arrête dès que tu attaques.
Il existe aussi « /rtp spawn », mais il est réservé à la plaque de pression de l'entrée du spawn : les joueurs n'ont pas besoin de le taper.
+8
Voir le fichier
@@ -0,0 +1,8 @@
# Le serveur en bref
mots-cles: serveur, minecraft, survival, vanilla, version, java, neoforge, 1.21.1, whitelist, liste blanche, rejoindre, jouer, mods, présentation, c'est quoi
statut: verifie
---
Le serveur est un survival presque vanilla en Minecraft Java 1.21.1 avec NeoForge, entre amis. Il ajoute quelques mods (Create, Terralith, Gravestone, chat vocal...) et des commandes maison : /spawn, /rtp, /tpa, homes, claims, amis, et /msg mind pour me parler.
Le serveur est sur liste blanche : seuls les joueurs ajoutés par les admins peuvent se connecter.
Le launcher du serveur installe automatiquement les mods nécessaires.
Pour les règles, voir la fiche « Règles » : elles ne sont pas encore publiées.
+6
Voir le fichier
@@ -0,0 +1,6 @@
# Commande /spawn
mots-cles: spawn, /spawn, retour, retourner, point de départ, départ, entrée, ramener, revenir au spawn
statut: verifie
---
/spawn te ramène au point de spawn du monde.
Il y a un délai de 3 secondes : reste immobile, la téléportation est annulée si tu bouges ou si tu es blessé. Entre deux /spawn, la recharge est de 1 seconde.
+10
Voir le fichier
@@ -0,0 +1,10 @@
# Se téléporter vers un ami : /tpa, /tpahere, /tpaccept, /tpadeny, /tpacancel
mots-cles: tpa, tpahere, tpaccept, tpadeny, tpacancel, téléporter, téléportation, rejoindre, ami, joueur, chez un ami, aller voir, venir, demande, accepter, refuser, annuler, expire
statut: verifie
---
- /tpa <joueur> : tu demandes à aller vers ce joueur.
- /tpahere <joueur> : tu demandes que ce joueur vienne vers toi.
- Le joueur qui reçoit la demande répond avec /tpaccept (accepter) ou /tpadeny (refuser), ou en cliquant dans le chat.
- /tpacancel annule ta dernière demande (ou /tpacancel <joueur>).
La demande expire au bout de 1 minute. Après l'acceptation, la téléportation se fait au bout d'environ 1 seconde. Pas de recharge entre deux demandes.
Le joueur doit être connecté. Pour aller chez toi, utilise /home.
+7
Voir le fichier
@@ -0,0 +1,7 @@
# Chat vocal Simple Voice Chat (touche V)
mots-cles: vocal, voix, micro, microphone, parler, voice chat, simple voice chat, touche v, touche, push to talk, proximité, entendre, son, réglages, voicechat
statut: verifie
---
Le serveur a Simple Voice Chat : un chat vocal de proximité, on entend les joueurs proches de soi. La touche V (par défaut) ouvre le menu des réglages du vocal (micro, volume...). Les touches se changent dans Options > Contrôles.
Le launcher installe le mod automatiquement. Si tu n'entends personne ou que le micro ne marche pas, ouvre le menu avec V et vérifie le micro choisi. Je ne connais pas d'autre solution de dépannage.
Ne partage pas d'infos personnelles en vocal.
+7
Voir le fichier
@@ -0,0 +1,7 @@
# Zone de spawn protégée
mots-cles: spawn, zone protégée, incassable, casser, poser, construire au spawn, protégé, entrée, avenue, plaque de pression, explosion, tnt
statut: verifie
---
La zone du spawn est protégée pour tous les joueurs (hors admins) : on ne peut pas y casser ni poser de blocs, ni ouvrir les coffres, fours ou tonneaux, ni utiliser un seau ou un briquet. Elle est aussi protégée des explosions, du feu, des pistons et de l'eau ou de la lave venant de l'extérieur.
Restent utilisables : boutons, plaques de pression, portes en bois, trappes en bois, portillons, leviers, établi, coffre de l'ender et table d'enchantement.
La plaque de pression de l'entrée t'envoie sur un beau point de la carte. Ne construis pas au spawn : fais ta base ailleurs et protège-la avec /claim.
+16
Voir le fichier
@@ -0,0 +1,16 @@
"""Essai hors-jeu du pont avec RAG : aucune commande RCON, aucun message en jeu.
python3 essai_rag.py -> fiches récupérées seulement
python3 essai_rag.py --mind -> + réponse de Mind (même ToolLoop / slot que le pont)
"""
import sys
import mind_chat as mc
QUESTIONS = ["comment je me téléporte chez un ami", "combien de homes je peux avoir ?", "comment protéger ma maison",
"c'est quoi la touche vocal ?", "quelles sont les règles du serveur ?", "y a-t-il une commande /back ?",
"quelle est la capitale de la France ?", "comment fabriquer une pioche en diamant ?"]
if __name__ == "__main__":
for q in QUESTIONS:
prompt, fiches, web = mc.construire_prompt(f"essai dit : {q}")
print(f"\n### {q}\nfiches: {[f.id for f in fiches]} web={web} prompt={len(prompt)} car.")
if "--mind" in sys.argv:
print("Mind >", mc.repondre("essai", f"essai dit : {q}"))
+148
Voir le fichier
@@ -0,0 +1,148 @@
"""Pont Minecraft <-> Mind (production) : Mind est un PNJ qu'on contacte en privé.
Le mod gastinelmind intercepte « /msg mind <texte> » (aussi /tell, /w) et écrit dans le journal serveur
une ligne « [GastinelMind] DEMANDE <pseudo> <uuid> :: <texte> ». Ce pont lit les logs du conteneur
minecraft-neoforge, ne réagit qu'à ces lignes (plus au chat public) et répond en chuchotement au seul
demandeur via RCON (tellraw <pseudo>). Une question à la fois, historique court par joueur.
"""
import json, re, subprocess, sys, time, urllib.parse, urllib.request
from collections import defaultdict, deque
from pathlib import Path
sys.path.insert(0, str(Path.home() / "LocalLLM"))
from gastinel_mind.core.llm_client import LLMClient # noqa: E402
from gastinel_mind.core.tool_loop import ToolLoop # noqa: E402
# RAG local sur le serveur Minecraft (fiches Markdown + BM25, sans dépendance). Absent ou cassé : le pont
# fonctionne comme avant (wiki seul), il ne plante jamais à cause du RAG.
RAG_DOSSIER = Path(__file__).resolve().parent / "connaissances"
try:
sys.path.insert(0, str(RAG_DOSSIER))
import rag_minecraft # noqa: E402
BASE_RAG = rag_minecraft.Base.charger(RAG_DOSSIER / "fiches")
print(f"RAG : {len(BASE_RAG.fiches)} fiches chargées", flush=True)
except Exception as e: # noqa: BLE001
rag_minecraft, BASE_RAG = None, None
print(f"RAG désactivé : {type(e).__name__}: {e}", flush=True)
CONTENEUR = "minecraft-neoforge"
DEMANDE = re.compile(r"\[GastinelMind\] DEMANDE (\w{3,16}) ([0-9a-fA-F-]{36}) :: (.+)$")
CONSIGNE = ("(Tu réponds dans le chat d'un serveur Minecraft entre amis : 2 à 4 phrases maximum, "
"texte simple sans Markdown. Le serveur est en Minecraft Java 1.21.1 avec NeoForge et les mods Create, "
"Create Aeronautics, Create New Age, Terralith, Tectonic, Gravestone et Veinminer. "
"Pour une question de jeu (craft, recette, bloc, mob, mécanique), réponds UNIQUEMENT d'après les extraits "
"du wiki Minecraft fournis ci-dessous ; dans les modèles {{Fabrication}}, la lettre A/B/C est la colonne "
"gauche/centre/droite et le chiffre 1/2/3 la ligne haut/milieu/bas ; décris les cases avec ces mots, "
"jamais avec les codes, et « résultat » est ce qu'on obtient. Si les extraits ne contiennent pas la réponse, dis que tu "
"n'es pas sûre au lieu d'inventer.) ")
WIKI = "https://fr.minecraft.wiki/api.php"
# Mots de la question qui n'aident pas la recherche wiki.
VIDES = set("""comment quoi quel quels quelle quelles est sont les des une pour avec dans sur par fait faire
fais fabrique fabriquer fabrication craft crafts crafter recette recettes obtenir obtient trouve trouver peut
peux on qui que quand combien minecraft mind salut stp svp moi toi tu je il elle nous vous ils ça cela
aussi trop tres très bien mais donc car ou où the and how""".split())
PAGES_HORS_SUJET = ("Édition", "La mise à jour", "Différences", "Tag de", "Type de son", "Bedrock Edition")
historiques = defaultdict(lambda: deque(maxlen=6))
def wiki(question, n=2):
"""Extraits wikitext des n premières pages du wiki Minecraft (FR) pour la question ; '' si rien."""
def api(**p):
url = WIKI + "?" + urllib.parse.urlencode({**p, "format": "json", "formatversion": 2})
return json.load(urllib.request.urlopen(urllib.request.Request(url, headers={"User-Agent": "gastinel-mind/1.0"}), timeout=10))
mots = [m for m in re.findall(r"[a-zàâçéèêëîïôûùüÿœ]+", question.lower().replace("'", " "))
if len(m) > 2 and m not in VIDES]
if not mots:
return ""
try:
res = api(action="query", list="search", srsearch=" ".join(mots), srlimit=6)["query"]["search"]
titres = [r["title"] for r in res if not r["title"].startswith(PAGES_HORS_SUJET)][:n]
extraits = []
for t in titres:
texte = api(action="parse", page=t, prop="wikitext", redirects=1)["parse"]["wikitext"]
extraits.append(f"=== {t} ===\n" + texte.split("== Historique")[0].split("== Valeurs")[0][:2500])
return "\n\n".join(extraits)
except Exception as e:
print(f"wiki : {type(e).__name__}: {e}", flush=True)
return ""
def analyser(ligne):
"""Ligne de log -> (pseudo, uuid, texte) si c'est une demande du mod, sinon None."""
m = DEMANDE.search(ligne.strip())
if not m:
return None
texte = m.group(3).strip()
return (m.group(1), m.group(2), texte) if texte else None
def commande_chuchotement(joueur, texte):
"""Commande tellraw « Mind vous chuchote : ... » en gris italique, pour le seul joueur.
Le composant est construit avec json.dumps : aucun guillemet bricolé à la main."""
texte = re.sub(r"[*_`#>]+", "", texte).replace("\n", " ").strip()[:600]
composant = {"text": f"Mind vous chuchote : {texte}", "color": "gray", "italic": True}
return f"tellraw {joueur} " + json.dumps(composant) # accents en \uXXXX : sûr via RCON
def rcon(cmd):
subprocess.run(["docker", "exec", CONTENEUR, "rcon-cli", cmd], capture_output=True, timeout=30)
def chuchoter(joueur, texte):
rcon(commande_chuchotement(joueur, texte))
def construire_prompt(message):
"""(prompt, fiches, web) : fiches du serveur si la question les concerne, sinon wiki Minecraft comme avant."""
question = message.split(" dit : ", 1)[-1]
fiches = []
if BASE_RAG is not None:
try:
fiches = BASE_RAG.rechercher(question)
except Exception as e: # noqa: BLE001
print(f"RAG : {type(e).__name__}: {e}", flush=True)
if fiches: # question sur le serveur : uniquement les fiches, pas de web
return rag_minecraft.bloc_contexte(fiches) + message, fiches, False
extraits = wiki(question)
contexte = f"\n\nExtraits du wiki Minecraft :\n{extraits}\n\nMessage : " if extraits else ""
sans_fiche = rag_minecraft.CONSIGNE_SANS_FICHE if rag_minecraft else ""
return CONSIGNE + sans_fiche + contexte + message, [], True
def repondre(joueur, message):
prompt, fiches, web = construire_prompt(message)
if fiches:
print(f"RAG : {[f.id for f in fiches]}", flush=True)
loop = ToolLoop(LLMClient(), id_slot=3, web_enabled=web)
parts = []
for d in loop.run_stream(prompt, history=list(historiques[joueur]), max_tokens=300):
if d.get("content_replace") is not None:
parts = [d["content_replace"]]
elif d.get("content"):
parts.append(d["content"])
reponse = "".join(parts).strip() or "Je n'ai pas de réponse, désolée."
historiques[joueur].extend([{"role": "user", "content": message}, {"role": "assistant", "content": reponse}])
return reponse
def main():
logs = subprocess.Popen(["docker", "logs", "-f", "--since", "0s", CONTENEUR], stdout=subprocess.PIPE,
stderr=subprocess.STDOUT, text=True, errors="replace")
for ligne in logs.stdout:
demande = analyser(ligne)
if not demande:
continue
joueur, _uuid, message = demande
try:
reponse = repondre(joueur, f"{joueur} dit : {message}")
print(f"<{joueur} -> Mind> {message}\n[Mind -> {joueur}] {reponse}", flush=True)
chuchoter(joueur, reponse)
except Exception as e: # Mind indisponible : on le dit au joueur sans planter
print(f"erreur : {type(e).__name__}: {e}", flush=True)
chuchoter(joueur, "Je suis indisponible pour le moment.")
sys.exit("flux de logs terminé") # conteneur redémarré : systemd relance le pont
if __name__ == "__main__":
main()
+32
Voir le fichier
@@ -0,0 +1,32 @@
"""Tests à blanc du pont (aucun appel RCON ni IA) : python3 -m unittest test_mind_chat"""
import json, unittest
import mind_chat as mc
UUID = "0f8fad5b-d9cb-469f-a165-70867728950e"
class TestPont(unittest.TestCase):
def test_ligne_du_mod(self):
ligne = f"[22:14:49] [Server thread/INFO] [co.ga.GastinelMind/]: [GastinelMind] DEMANDE totoche10 {UUID} :: comment faire du pain ?\n"
self.assertEqual(mc.analyser(ligne), ("totoche10", UUID, "comment faire du pain ?"))
def test_texte_avec_separateur(self):
ligne = f"[GastinelMind] DEMANDE Bob_1 {UUID} :: a :: b"
self.assertEqual(mc.analyser(ligne)[2], "a :: b")
def test_chat_public_ignore(self):
self.assertIsNone(mc.analyser("[22:00:00] [Server thread/INFO] [minecraft/MinecraftServer]: <totoche10> salut Mind"))
self.assertIsNone(mc.analyser("[22:00:00] [Server thread/INFO] [minecraft/MinecraftServer]: <x> [GastinelMind] DEMANDE"))
def test_tellraw_json_valide(self):
cmd = mc.commande_chuchotement("totoche10", 'Il faut 3 "blés"\net du {pain} \\ ok')
self.assertTrue(cmd.startswith("tellraw totoche10 "))
comp = json.loads(cmd[len("tellraw totoche10 "):])
self.assertEqual(comp["color"], "gray")
self.assertTrue(comp["italic"])
self.assertEqual(comp["text"], 'Mind vous chuchote : Il faut 3 "blés" et du {pain} \\ ok')
if __name__ == "__main__":
unittest.main()
+138
Voir le fichier
@@ -0,0 +1,138 @@
"""Petit RAG local pour Mind sur le serveur Minecraft : fiches Markdown + recherche BM25 en Python pur.
Aucune dépendance. Une fiche = un fichier .md :
# Titre
mots-cles: a, b, c
statut: verifie | brouillon
---
texte de la fiche
Usage :
base = Base.charger(dossier_fiches)
fiches = base.rechercher("combien de homes ?") # 0 à 4 fiches
bloc = bloc_contexte(fiches) # texte à injecter dans le prompt
"""
import math
import re
import unicodedata
from collections import Counter
from dataclasses import dataclass
from pathlib import Path
MAX_FICHES = 4
SCORE_MIN = 2.2 # en dessous : la fiche n'est pas retenue (question hors serveur)
RAPPORT_MIN = 0.4 # une fiche doit valoir au moins 40 % de la meilleure
K1, B = 1.4, 0.75
POIDS_TITRE, POIDS_MOTS = 2, 3
RACINE = 5
VIDES = set("""le la les un une des du de d l au aux et ou a à en y est sont suis es etre ai as avons avez ont
je tu il elle on nous vous ils elles me te se lui leur mon ma mes ton ta tes son sa ses notre votre nos vos ce cet cette ces
que qui quoi quel quels quelle quelles quand comment pourquoi ou dont ne pas plus pour par sur sous avec sans dans chez vers
faut peut peux peuvent veux veut puis fait faire fais dit dis donc mais car si ca cela ici la
est-ce quoi moi toi font combien stp svp merci salut hello bonjour mind alors aussi trop tres bien the and how what
""".split())
_VIDES_N = set()
def normaliser(texte):
t = unicodedata.normalize("NFD", texte.lower().replace("’", "'"))
return "".join(c for c in t if unicodedata.category(c) != "Mn")
def _racine(mot):
# racinisation grossière : pluriel retiré puis troncature à 5 lettres
# (téléporter / téléportation / téléporte -> telep ; les noms de commandes courts restent intacts)
if len(mot) > 3 and mot.endswith(("s", "x")):
mot = mot[:-1]
return mot[:RACINE]
def jetons(texte):
global _VIDES_N
if not _VIDES_N:
_VIDES_N = {normaliser(m) for m in VIDES}
mots = re.findall(r"[a-z0-9]+", normaliser(texte).replace("'", " "))
return [_racine(m) for m in mots if m not in _VIDES_N and len(m) > 1]
@dataclass
class Fiche:
id: str
titre: str
mots_cles: list
statut: str
corps: str
def texte_indexe(self):
return (jetons(self.titre) * POIDS_TITRE
+ jetons(" ".join(self.mots_cles)) * POIDS_MOTS
+ jetons(self.corps))
def lire_fiche(chemin):
brut = Path(chemin).read_text(encoding="utf-8").replace("\r\n", "\n")
entete, _, corps = brut.partition("\n---\n")
titre, mots, statut = Path(chemin).stem, [], "verifie"
for ligne in entete.splitlines():
if ligne.startswith("# "):
titre = ligne[2:].strip()
elif ligne.startswith("mots-cles:"):
mots = [m.strip() for m in ligne.split(":", 1)[1].split(",") if m.strip()]
elif ligne.startswith("statut:"):
statut = ligne.split(":", 1)[1].strip()
return Fiche(Path(chemin).stem, titre, mots, statut, corps.strip())
class Base:
def __init__(self, fiches):
self.fiches = fiches
self.docs = [Counter(f.texte_indexe()) for f in fiches]
self.longueurs = [sum(d.values()) for d in self.docs]
self.moyenne = (sum(self.longueurs) / len(fiches)) if fiches else 1
n = len(fiches)
df = Counter(m for d in self.docs for m in d)
self.idf = {m: math.log(1 + (n - c + 0.5) / (c + 0.5)) for m, c in df.items()}
@classmethod
def charger(cls, dossier):
return cls([lire_fiche(p) for p in sorted(Path(dossier).glob("*.md"))])
def scores(self, question):
q = set(jetons(question))
res = []
for f, d, ln in zip(self.fiches, self.docs, self.longueurs):
s = 0.0
for m in q:
if m in d:
tf = d[m]
s += self.idf[m] * tf * (K1 + 1) / (tf + K1 * (1 - B + B * ln / self.moyenne))
res.append((s, f))
return sorted(res, key=lambda x: -x[0])
def rechercher(self, question, n_max=MAX_FICHES, score_min=SCORE_MIN, rapport_min=RAPPORT_MIN):
classes = self.scores(question)
if not classes or classes[0][0] < score_min:
return []
meilleur = classes[0][0]
return [f for s, f in classes[:n_max] if s >= score_min and s >= rapport_min * meilleur]
CONSIGNE_FICHES = (
"(Cette question concerne le serveur Minecraft : réponds UNIQUEMENT d'après les fiches ci-dessous, "
"en 2 à 4 phrases, texte simple sans Markdown, sans rien inventer. Si les fiches ne contiennent pas la "
"réponse, dis « je ne sais pas » et invite à demander à un admin. Une fiche « brouillon » n'est pas "
"validée : ne l'annonce jamais comme une règle. Ne promets aucune fonction qui n'est pas dans les fiches. "
"Ne donne jamais d'adresse, de mot de passe ni d'information sur d'autres joueurs.)")
CONSIGNE_SANS_FICHE = (
"(Si la question porte sur les commandes, les règles ou le fonctionnement de CE serveur Minecraft et que "
"tu n'as pas de fiche à ce sujet, réponds « je ne sais pas » et invite à demander à un admin : n'invente "
"ni commande, ni limite, ni règle.) ")
def bloc_contexte(fiches):
"""Texte à insérer dans le prompt : consigne stricte + fiches retenues."""
parts = [f"=== Fiche : {f.titre}" + (" [BROUILLON non validé]" if f.statut != "verifie" else "") + f" ===\n{f.corps}"
for f in fiches]
return CONSIGNE_FICHES + "\n\nFiches du serveur :\n" + "\n\n".join(parts) + "\n\nMessage : "
+39
Voir le fichier
@@ -0,0 +1,39 @@
RAG : 17 fiches chargées
### comment je me téléporte chez un ami
fiches: ['tpa', 'amis', 'commandes-liste'] web=False prompt=2328 car.
RAG : ['tpa', 'amis', 'commandes-liste']
Mind > Pour te téléporter chez un ami, tu peux utiliser la commande /tpa suivie du nom du joueur pour lui demander de te téléporter. L'ami doit ensuite répondre avec /tpaccept pour valider la demande. La téléportation s'effectue environ une seconde après son acceptation.
### combien de homes je peux avoir ?
fiches: ['homes'] web=False prompt=1417 car.
RAG : ['homes']
Mind > Tu peux avoir 3 homes au maximum. Tu peux les enregistrer avec la commande /sethome.
### comment protéger ma maison
fiches: ['claims', 'homes'] web=False prompt=2178 car.
RAG : ['claims', 'homes']
Mind > Tu peux protéger ta maison avec la commande /claim qui protège le chunk où tu te trouves. Tu peux en protéger 25 au maximum. Pour protéger une grande base, tu peux claim plusieurs chunks côte à côte.
### c'est quoi la touche vocal ?
fiches: ['vocal', 'mods-liste'] web=False prompt=1772 car.
RAG : ['vocal', 'mods-liste']
Mind > La touche pour ouvrir le menu des réglages du chat vocal est la touche V par défaut. Elle permet de configurer le micro et le volume du chat vocal de proximité.
### quelles sont les règles du serveur ?
fiches: ['regles', 'serveur-general', 'guide'] web=False prompt=1938 car.
RAG : ['regles', 'serveur-general', 'guide']
Mind > Les règles du serveur ne sont pas encore publiées. Pour toute question sur les règles, demande à un admin.
### y a-t-il une commande /back ?
fiches: ['inexistant', 'commandes-liste'] web=False prompt=1649 car.
RAG : ['inexistant', 'commandes-liste']
Mind > Il n'y a pas de commande /back sur ce serveur. Pour toute demande de nouvelle fonction, parle à un admin du serveur.
### quelle est la capitale de la France ?
fiches: [] web=True prompt=3581 car.
Mind > Je ne sais pas. Demande à un admin.
### comment fabriquer une pioche en diamant ?
fiches: [] web=True prompt=6113 car.
Mind > Pour fabriquer une pioche en diamant, place un diamant dans la case en haut à gauche, un diamant dans la case en haut au centre et un diamant dans la case en haut à droite. Mets ensuite un bâton dans la case du milieu au centre et un autre bâton dans la case du bas au centre. Le résultat sera une pioche en diamant.
+64
Voir le fichier
@@ -0,0 +1,64 @@
"""Tests hors-jeu du RAG : python3 -m unittest test_rag_minecraft (depuis le dossier connaissances/)"""
import re
import unittest
from pathlib import Path
import rag_minecraft as rag
ICI = Path(__file__).parent
BASE = rag.Base.charger(ICI / "fiches")
# (question, fiche attendue en tête)
ATTENDUS = [
("comment je me téléporte chez un ami", "tpa"),
("combien de homes je peux avoir ?", "homes"),
("comment protéger ma maison", "claims"),
("c'est quoi la touche vocal", "vocal"),
("comment je donne accès à mon claim à un pote, /friend", "amis"),
("j'ai perdu mes affaires en mourant", "mort-gravestone"),
("comment revenir au spawn", "spawn"),
("c'est quoi /rtp", "rtp"),
("quelles sont les règles du serveur ?", "regles"),
("quels mods y a-t-il ?", "mods-liste"),
("est-ce qu'il y a un /back ?", "inexistant"),
]
HORS_SUJET = ["quelle est la capitale de la France ?", "raconte-moi une blague",
"comment fabriquer une pioche en diamant", "combien font 2 + 2"]
class TestRag(unittest.TestCase):
def test_attendus(self):
for q, attendu in ATTENDUS:
with self.subTest(q=q):
r = BASE.rechercher(q)
self.assertTrue(r, f"aucune fiche pour {q!r}")
self.assertEqual(r[0].id, attendu, [f.id for f in r])
self.assertLessEqual(len(r), 4)
def test_hors_sujet(self):
for q in HORS_SUJET:
with self.subTest(q=q):
self.assertEqual(BASE.rechercher(q), [])
def test_limites_reelles(self):
homes = next(f for f in BASE.fiches if f.id == "homes").corps
claims = next(f for f in BASE.fiches if f.id == "claims").corps
self.assertIn("3 au maximum", homes)
self.assertIn("25 au maximum", claims)
def test_aucun_secret(self):
for f in BASE.fiches:
texte = f.titre + " " + f.corps + " " + " ".join(f.mots_cles)
self.assertIsNone(re.search(r"\b\d{1,3}(\.\d{1,3}){3}\b", texte), f.id) # IPv4
self.assertIsNone(re.search(r"[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}", texte), f.id) # UUID
self.assertIsNone(re.search(r"(?i)mot de passe|password|token|secret", texte.replace(
"ni de mot de passe", "")), f.id)
def test_brouillon_marque(self):
regles = next(f for f in BASE.fiches if f.id == "regles")
self.assertIn("BROUILLON", rag.bloc_contexte([regles]))
self.assertIn("pas encore validées", regles.corps)
if __name__ == "__main__":
unittest.main()