xEdit Automation — Compétence Hub
Cette compétence est le point d'entrée toujours chargé pour tout travail xEdit. Elle est la source unique de vérité pour "quel chemin utiliser" et "ce qu'il ne faut jamais faire". Les compétences spécialisées (par exemple xedit-conflict-audit) héritent de son routage, de ses anti-patrons et de sa discipline de vérification ; elles ne les répètent pas.
Boîte à outils en un coup d'œil (divulgation progressive, compatible r6)
Le démon xEdit forké est mieux traité comme une surface de divulgation progressive :
commencez par les petits outils d'intention MCP, demandez au démon actif quels blocs de capacité r6 il supporte, puis passez aux modèles plus riches à un seul appel seulement lorsque la clé system.capabilities.supports.* correspondante est présente.
- Découverte et session —
xedit_session,xedit_list_capabilities. Appelezxedit_sessionen premier à chaque conversation. Ensuite, appelezxedit_list_capabilitiesune fois pour voir le résumé des commandes,contractVersionExpectedet les ancrages r6supports.*. - Lecture des enregistrements et des conflits —
xedit_find_record,xedit_read_record,xedit_inspect_conflicts. Ce sont la colonne vertébrale W2 (audit de conflit) ; passez au passage atomique lorsque W2 a besoin d'un bloc de réponse r6 qu'aucun outil d'intention n'expose encore. - Passage atomique —
xedit_call(command, args). Pour toute commande native du démon qui n'a pas encore d'outil d'intention. Exécute toujours le pipeline complet (validation → état → règles → audit). Utilisez-le à chaque fois que les outils d'intention ne conviennent pas.
Pour la documentation de référence approfondie, interrogez d'abord la BGS KB structurée (bgs_kb_query / bgs_kb_get). Les enregistrements de référence approfondie se trouvent sous knowledge/bgs-kb/packs/core/records/xedit/ (interrogeable via bgs_kb_query / bgs_kb_get).
Doctrine de routage (quel chemin utiliser)
| Forme de la tâche | Chemin |
|---|---|
| Intention connue à haute fréquence (auditer un conflit, lire un enregistrement, exécuter un travail, écrire un correctif) | Outil d'intention MCP |
| Nouveau / débogage / composition libre de commandes natives | Passage atomique MCP : xedit_call(command, args) — toujours dans le harnais |
| Tempête d'opérations atomiques exploratoires (essais-erreurs, lecture-évaluation répétée, test d'hypothèses) | Déléguer à un sous-agent investigateur en lecture seule avec cette compétence chargée ; le sous-agent utilise son propre contexte, retourne un résumé distillé |
| Mutation en masse importante et formalisable | MCP xedit_run_script (Batch 4+) avec exécution à sec et instantané |
| Démon explicitement en mode par défaut (non-MCP), débogage manuel uniquement | Direct xedit-client.ps1 est acceptable — mais UNIQUEMENT lorsque l'utilisateur a explicitement accepté le risque et que le démon n'est pas en mode -automation-mcp-mode |
L'agent ne devrait jamais avoir de raison de contourner le MCP. Le passage atomique existe pour cela.
Jugement de création de correctifs
Aperçu
La création de correctifs ne consiste pas à "faire disparaître le rouge". C'est un petit argument de compatibilité : préservez le gagnant actuel, transmettez uniquement les valeurs en amont qui devraient encore survivre, et laissez derrière vous un plugin de correctif réversible dont le contenu dit ce que vous vouliez dire. Le tri est un levier à choix unique ; le correctif est la façon de garder les valeurs intentionnelles de deux mods actives en même temps. Mais vrai-en-principe n'est pas vrai-à-l'échelle-du-pack : si le plan est de recoudre chaque FormID parce que "xEdit peut tout réparer", le plan est déjà cassé.
Utilisez cette section lorsque vous êtes sur le point de créer ou de juger un correctif via le MCP. Utilisez xedit-conflict-audit d'abord lorsque la question est encore "qu'est-ce qui gagne, qu'est-ce qui entre en conflit, et cela devrait-il être un correctif ou un réordonnancement ?" Cette compétence possède l'appel correctif-vs-réordonnancement ; cette section possède le fait que le correctif que vous êtes sur le point d'écrire est bien formé.
Flux de décision : ce correctif est-il bien formé ?
digraph patch_authoring_judgment {
// Les sauvegardes en attente d'arrêt bloquent les opérations du cycle de vie ; voir État sale et
// contrôle de relance ci-dessous. Un redémarrage n'est pas un mécanisme de durabilité.
rankdir=TB;
node [shape=box];
start [shape=doublecircle, label="Besoin d'un correctif ?"];
audit [label="Auditer le gagnant réel + les champs de conflit\n(xedit-conflict-audit si pas déjà fait)"];
reorder [shape=diamond, label="Le réordonnancement suffit-il\nsans perdre les valeurs nécessaires ?"];
no_patch [shape=doublecircle, label="Pas de correctif : réordonner / laisser le gagnant\npuis vérifier la relecture"];
winner [label="Copier/cibler le gagnant actuel\npas un perdant plus ancien"];
intent [label="Nommer chaque valeur à transmettre\nQue fait-elle ? Pourquoi devrait-elle survivre ?"];
noise [shape=diamond, label="Des valeurs copiées inchangées\nou du bruit de style ITM/vert ?"];
clean [label="Supprimer les valeurs inchangées/sans intention"];
refs [shape=diamond, label="Suppression ou marquage de suppression\nd'enregistrements/éléments ?"];
referenced [label="Exécuter l'audit referencé_par / référence\nArrêter si les conséquences sont inconnues"];
esl [label="Choisir délibérément la forme du correctif\nGénéralement ESP marqué ESL quand sûr ; éviter ESL/ESM natif si la liberté de tri est importante"];
reversible [shape=diamond, label="Correctif réversible séparé\n(pas d'édition directe du mod source, pas de débordement d'écrasement non géré) ?"];
fix_shape [label="Déplacer dans le mod MO2 géré\nou créer un plugin de correctif dédié"];
verify [label="Sauvegarder + redémarrer + relire\nL'écrasement gagnant montre les valeurs intentionnelles"];
pass [shape=doublecircle, label="Correctif bien formé"];
start -> audit -> reorder;
reorder -> no_patch [label="oui"];
reorder -> winner [label="non, besoin de valeurs combinées"];
winner -> intent -> noise;
noise -> clean [label="oui"];
noise -> refs [label="non"];
clean -> refs;
refs -> referenced [label="oui"];
refs -> esl [label="non"];
referenced -> esl;
esl -> reversible;
reversible -> fix_shape [label="non"];
reversible -> verify [label="oui"];
fix_shape -> verify -> pass;
// Les sauvegardes en attente du contrat 0.23 utilisent xedit_flush ; le redémarrage seul n'est pas une preuve.
verify [label="Sauvegarder + inspecter l'état en attente ; xedit_flush si nécessaire ; relecture fraîche"];
}
Correction de la sauvegarde différée : Le nœud historique
Sauvegarder + redémarrer + reliredu diagramme est remplacé. Sisession.savesignale unsavePendingShutdownCountnon nul, inspectezxedit_dirty, puis utilisezxedit_flushsur un démon de contrat 0.23. L'outil valide la réponse de drainage et confirme la sortie promise du démon. UnlastFlushpartialou inconnu n'est pas une preuve de durabilité. L'arrêt/redémarrage normal reste refusé tant qu'une file d'attente en attente existe ;force:trueabandonne l'état et n'est jamais une preuve de durabilité.
Vérifications de création
- Transmettre le gagnant. Le jeu lit l'écrasement final/gagnant pour un FormID. Construisez le correctif à partir du gagnant actuel, puis transmettez uniquement les valeurs du mod plus ancien qui doivent encore survivre.
- Pas de cargo inchangé. Si une valeur copiée ne change pas de sens, c'est du bruit de style ITM, pas de la compatibilité. Supprimez-la à moins que vous puissiez indiquer pourquoi elle est intentionnellement conservée.
- Correctif en tant que couche séparée. Ne glissez pas les valeurs directement dans le mod source simplement parce qu'il est la colonne la plus à droite aujourd'hui. Un correctif doit être réversible en désactivant/supprimant la couche de correctif, pas en supprimant manuellement des champs du plugin de quelqu'un d'autre.
- Préserver les références. Si une suppression ou un marquage de suppression entre dans le plan, arrêtez-vous et exécutez d'abord le chemin référencé-par/relire. Des références inconnues signifient un rayon d'impact inconnu.
- Choisir délibérément la forme du plugin. Les correctifs de compatibilité ordinaires veulent généralement la liberté de tri ESP normale plus le marquage ESL quand c'est sûr. Le comportement de l'ordre de chargement ESL/ESM natif n'est pas une mise à niveau de propreté gratuite.
- Bon correctif contre correctif pansement. Un bon correctif a une intention nommée pour chaque valeur transmise et réduit la dette de conflit. Un correctif pansement copie des enregistrements entiers, édite les mods sources ou essaie de recoudre chaque FormID parce que le tri a été traité comme sans importance.
Discipline d'interrogation KB
Cette section de jugement est indépendante du jeu. Interrogez KB pour les pièges de correction spécifiques au jeu, les mises en garde des familles d'enregistrements et les faits actuels de la chaîne d'outils plutôt que de les fossiliser ici.
bgs_kb_query({ query: "xedit patch authoring gotchas", domains: ["xedit", "load-order"], games: ["<current game>"] })
Si KB est silencieux, marquez [GAP] et conservez la règle de correction au niveau du framework au lieu d'inventer une doctrine spécifique au jeu.
Signaux d'alarme (STOP)
| Pensée | Réalité |
|---|---|
| "C'est rouge, alors copie la valeur de gauche." | Le rouge est une invitation à inspecter. Ce n'est pas un verdict que la valeur perdante devrait survivre. |
| "Le mod le plus à droite est faux ; je vais l'éditer directement." | Alors vous avez fait du mod source le correctif. Utilisez un correctif d'écrasement séparé pour que l'inversion soit propre. |
| "Le tri n'a pas d'importance car xEdit peut tout corriger." | En principe, oui ; sur des centaines de milliers de FormID, non. Utilisez le tri pour réduire la dette de réparation, puis corrigez le reste significatif. |
| "Les valeurs copiées vertes/inchangées sont inoffensives." | Ce sont des marchandises sans intention. Si elles ne changent pas de sens, supprimez-les. |
| "L'ESL natif est plus propre que l'ESP marqué ESL." | L'ESL/ESM natif peut coûter la liberté de tri normale. Utilisez l'ESP marqué ESL lorsque c'est la forme de correctif sûre. |
| "Cela semble inutilisé ; supprimez-le." | Référencé-par d'abord. La suppression sans connaissance de la référence est un rayon d'impact inconnu. |
Rationalisations
| Excuse | Réalité |
|---|---|
| "Je vais juste glisser un champ dans le plugin gagnant." | Un champ est toujours une édition de mod source. Créez une couche de correctif, ou le vous futur supprimera manuellement les champs égarés un par un. |
| "Le correctif devrait préserver tout ce qu'un mod a touché." | Préservez l'intention, pas l'historique. Certaines modifications sont essentielles au mod ; d'autres sont une préférence d'auteur accessoire qui devrait perdre face à une règle systémique. |
| "Je ne sais pas ce que fait ce champ, donc je vais copier la version qui a l'air plausible." | Une signification de champ inconnue est une tâche de recherche, pas un coup de dé. Lisez la structure de l'enregistrement, CK/wiki/exemples de la communauté et le comportement réel dans le pack. |
| "L'écrasement est correct ; MO2 le voit." | L'écrasement est un débordement. Un vrai correctif appartient à une couche de mod gérée avec un nom que le vous futur peut comprendre. |
| "La réponse a dit ok ; le correctif est terminé." | L'acceptation du correctif est la relecture de l'écrasement gagnant après sauvegarde/redémarrage, avec les valeurs intentionnelles visibles et aucun cargo involontaire. |
Vérifications de capacités de divulgation progressive r6
Ne supposez pas que chaque démon est r6. Lisez xedit_list_capabilities une fois et bifurquez sur les clés de support ci-dessous. Sur les démons pré-r6, revenez aux anciens modèles explicites de liste d'enregistrements/parcours enfant/boucle par enregistrement ; sur les démons r6+, utilisez le formulaire à un appel ou conscient de la page pour réduire les allers-retours et préserver le contexte.
| Clé de capacité | Contrat | Préférez ce modèle | Enregistrement KB |
|---|---|---|---|
supports.childGroupNavigation | 0.13 | Naviguer dans les groupes enfants CELL/WRLD/DIAL/QUST via les souches elements.children | xedit.childgroup-navigation.v1 |
supports.createParentSpec | 0.16 / 0.18 | Créer des enregistrements directement sous les groupes enfants parents avec records.create parent | xedit.records-create-parent-spec.v1 |
supports.elementsChildrenPagination | 0.17 | Paginer elements.children avec limit / offset | xedit.elements-children-pagination.v1 |
supports.reverseNavigation | 0.19 | Ajouter includeParents:true et lire relations.parents | xedit.reverse-navigation.v1 |
Pour l'ensemble du delta du contrat r6, interrogez l'enregistrement KB xedit.r6-contract-summary.v1.
Navigation dans les groupes enfants (supports.childGroupNavigation)
Sur les démons r6+, elements.children sur les enregistrements CELL, WRLD, DIAL et QUST renvoie une entrée enfant virtuelle avec kind: "child_group". Traitez cette entrée comme une souche de navigation en lecture seule, pas comme un élément mutable réel.
Utilisez-la une génération à la fois :
elements.children({ file, formId, path: "\\Child Group" })
elements.children({ file, formId, path: "\\Child Group\\Persistent" })
elements.children({ file, formId, path: "\\Child Group\\Temporary" })
elements.children({ file, formId, path: "\\Child Group\\Visible when Distant" })
elements.children({ file, formId, path: "\\Child Group\\Block X, Y" })
elements.children({ file, formId, path: "\\Child Group\\Block X, Y\\Sub-Block M, N" })
- Parcourez exactement le niveau suivant ; ne demandez pas l'arbre entier quand une page ou une étiquette de groupe enfant suffit.
- Les chemins
\\Child Group...sont synthétiques et EN LECTURE SEULE. Les verbes de mutation doivent utiliser des localisateurs FormID plats ({ file, formId }) ou une spécificationrecords.create.parent; ne passez pas de chemins de localisateurs synthétiques aux mutateurs. - Pour les cellules WRLD, utilisez
Persistentou la route Bloc/Sous-Bloc/coordonnée selon le groupe enfant cible. - Référence approfondie :
xedit.childgroup-navigation.v1.
Pagination elements.children (supports.elementsChildrenPagination)
Sur les démons r6+, elements.children accepte limit et offset :
elements.children({ file, formId, path, limit: 200, offset: 0 })
limitest limité à 1-1000 et par défaut à 200.- Les réponses incluent
count,total,offsetettruncated. - Si
truncatedest vrai, gardez le mêmelimit, ajoutezcountàoffset, et récupérez la page suivante jusqu'à couverture. - Ne supposez pas que les groupes enfants CELL sont petits : la cellule vanilla FO4
00000025Temporarycontient 742 enregistrements. - Référence approfondie :
xedit.elements-children-pagination.v1.
Navigation inverse (supports.reverseNavigation)
Sur les démons r6+, ajoutez includeParents: true lorsque vous avez besoin de connaître la propriété ou le confinement sans un deuxième verbe. Les appels de lecture pris en charge incluent :
records.getrecords.find_by_form_id/records.find_by_editor_idet les wrappers MCP tels quexedit_find_recordrecords.master_or_selfrecords.winning_overrideelements.getelements.children
La réponse peut inclure :
relations.parents: [{ locator, object }, ...]
Les parents sont les plus proches en premier avec une limite de profondeur de démon de 16. C'est la réponse préférée à "quelle CELL possède ce REFR?" ou "quel groupe QUST/DIAL contient cet enfant?" Utilisez la chaîne parent comme preuve de relecture ; ne construisez pas une boucle d'index inverse personnalisée sauf si la clé de support est absente. Référence approfondie : xedit.reverse-navigation.v1.
Spécification parent records.create (supports.createParentSpec)
La création d'enregistrements mutables dans les groupes enfants est verrouillée par r6 et nécessite toujours le chemin normal de consentement de mutation MCP. Lorsqu'elle est prise en charge, spécifiez le parent cible explicitement au lieu d'essayer de muter des chemins \\Child Group synthétiques.