Update AGENTS.md with Qwen3-VL screen analysis procedure, add MANUEL_COMPLET.md and vision-notes.md

This commit is contained in:
Tallagrand Thierry
2026-07-18 02:14:22 +02:00
parent 1b032b5a20
commit 2f3a66993b
16 changed files with 659 additions and 0 deletions

View File

@@ -63,3 +63,70 @@ Quand tu analyses le pipeline complet (plusieurs nœuds), n'extrais que les
lignes pertinentes (grep -n "name"/"jsCode" puis sed sur la plage), jamais
le workflow JSON entier en mémoire Python. Traite un nœud, résume, libère.
## Qwen3-VL — Traitement obligatoire des captures d'ecran
Quand le modele actif est `qwen3-vl` et que l'utilisateur fournit une ou plusieurs captures d'ecran, images d'interface, screenshots, photos d'ecran ou pieces jointes image, tu DOIS systematiquement appliquer cette procedure avant toute autre analyse.
### Procedure obligatoire
Pour chaque image recue, produire une sortie structuree avec exactement les sections suivantes :
1. OCR brut
- Recopier tout le texte visible dans l'image.
- Conserver les chemins, noms de fichiers, commandes, messages d'erreur, URLs visibles, noms de modeles, ports, statuts et valeurs numeriques.
- Ne pas corriger silencieusement le texte : si un caractere est incertain, l'indiquer avec `[incertain]`.
2. Elements UI visibles
- Decrire les boutons, menus, onglets, listes, champs, cases cochees, selection active, panneaux ouverts et zones importantes.
- Indiquer les elements selectionnes ou mis en evidence.
3. Erreurs, warnings et indices techniques
- Lister tous les messages d'erreur, warnings, traces, logs, codes HTTP, statuts Docker/vLLM/OpenCode/MCP ou signaux visuels de probleme.
- Si aucun probleme n'est visible, ecrire : `Aucune erreur visible`.
4. Etat actuel deduit
- Resumer ce que l'image montre concretement.
- Distinguer les faits visibles des hypotheses.
- Ne jamais inventer d'IP, URL, token, nom d'outil MCP ou valeur absente de l'image.
5. Actions recommandees
- Proposer les prochaines actions sous forme courte et operationnelle.
- Si l'image concerne n8n, Home Assistant, Victron, grid ou EVCS, respecter les regles MCP du projet : ne pas proposer de curl/wget/appel HTTP direct.
- Si une information manque, demander a l'utilisateur au lieu de deviner.
### Memoire partagee avec les autres modeles
Apres l'analyse, si la capture contient une information utile pour la suite de la session OpenCode, tu DOIS proposer ou creer un resume exploitable en texte dans :
`docs/vision-notes.md`
Format recommande :
```md
# Vision notes
Source
Image(s) analysee(s) : <description courte>
# OCR brut
...
# Éléments UI
...
# Erreurs visibles
...
# État actuel
...
# Actions recommandées
...
Objectif : permettre a un autre modele texte, par exemple `minimax-m2.5`, de reutiliser l'information extraite sans avoir acces aux pixels de l'image.
### Regle critique
Ne considere jamais que les autres modeles ont acces a l'image originale. Toute information importante vue dans la capture doit etre explicitement convertie en texte dans la reponse ou dans `docs/vision-notes.md`.
Cette analyse doit précéder toute modification de workflow ou configuration.