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 à :
1 Parent
e9507333f6
révision
f684023188
23 fichiers modifiés
+574
Aucun fichier ne correspond à votre recherche
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.).
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -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}"))
|
||||
@@ -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()
|
||||
@@ -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()
|
||||
@@ -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 : "
|
||||
@@ -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.
|
||||
@@ -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()
|
||||
Référencer dans un nouveau ticket
Bloquer un utilisateur