Files
ObsiGate/docs/features/ai-provider-picker.md
T
bruno eea2108ac2
CI / lint (push) Successful in 1m8s
CI / security (push) Successful in 44s
CI / test (push) Successful in 2m5s
CI / build (push) Successful in 39s
CI / e2e (push) Successful in 10m37s
fix(ai): lisibilite des modeles + contexte @ en mode General (BUG-010, BUG-011)
BUG-011: popover des modeles aligne a droite (right:0), largeur 340px bornee, noms sur plusieurs lignes + title. BUG-010: la selection @ capture le vault renvoye par tree-search et _contextVault() le propage aux requetes /context et /chat, corrigeant le contexte ad-hoc en mode General.
2026-09-12 13:50:14 -04:00

60 lines
3.9 KiB
Markdown

# #82 — Assistant IA — Section « Fournisseur & modèle » compacte
> **Statut :** ✅ Livré (en attente de validation utilisateur)
> **Effort :** 1 jour | **Impact :** 🟢
> **Références :** [Roadmap](../ROADMAP.md) · [Assistant IA #81](./ai-assistant-commands.md) · [Changelog](../../CHANGELOG.md)
- **Description :** rendre la barre de sélection du modèle de l'assistant IA **plus discrète** tout
en conservant les informations utiles :
1. **Capacités via bulle** — la liste complète des types d'endpoints (Chat, Embeddings, Rerank,
Images, Video, Audio Speech, Audio Transcriptions, Vision) n'est plus affichée en permanence.
Un bouton **ⓘ** révèle une bulle d'information au **survol**, au **clic** ou par **appui long**
(mobile).
2. **Recherche de modèle** — le `<select>` natif est remplacé par une liste déroulante compacte
dotée d'un **champ de recherche** qui filtre les modèles en tapant (insensible à la casse et
aux accents).
3. **Compatibilité** — un `<select class="ai-picker-model">` masqué reste présent (source de
vérité) pour les commandes admin `/model` et l'état persisté `obsigate_ai_picker`.
## A. Picker partagé — ✅ livré
- [x] `frontend/js/ai.js` : `buildAIPickerUI()` réécrit (provider compact + combobox modèle + bulle
capacités). Le picker reste partagé par l'assistant (`bookslm.js`) et la barre d'édition IA.
- [x] `renderCapabilityList()` conservé et affiché dans la bulle (le panneau de configuration
`#cfg-ai-default-model-caps` continue de l'utiliser directement).
- [x] Fermeture des popovers au clic extérieur via un unique listener délégué (pas de fuite).
- [x] i18n FR/EN (`ai.model_search`, `ai.model_info`).
## B. Correctifs associés — ✅ livré
- [x] **BUG-007** — détection `/` et `@` Unicode + filtrage insensible aux accents + navigation
clavier ↑/↓ fiabilisée (jeton de séquence, `scrollIntoView`).
- [x] **BUG-008** — contexte ad-hoc `@` pris en compte en mode Général côté backend
(`backend/bookslm_routes.py`) et recherche de mention sur `vault=all` sans vault courant.
## C. Tests — ✅ livré
- [x] `tests/frontend/ai.test.mjs` : filtrage accentué, mentions accentuées, navigation ↑/↓,
recherche de modèle + bulle de capacités, plafonnement des longues listes (OpenRouter).
- [x] `tests/test_bookslm.py` : contexte ad-hoc en mode Général (`/chat`).
## D. Durcissement anti-cache (BUG-009) — ✅ livré
- [x] Locales chargées avec `cache: 'no-store'` (`frontend/js/i18n.js`) : plus de clés brutes
affichées à cause d'un `fr.json` obsolète en cache HTTP.
- [x] `SW_VERSION` incrémenté (`frontend/sw.js`) pour purger les caches du service worker.
- [x] Styles critiques du picker appliqués **en ligne** (popover absolu, liste en colonne, options
`display:block`) pour rester corrects même si `style.css` est servi depuis un cache.
- [x] Rendu plafonné à 200 modèles (`MODEL_RENDER_LIMIT`) + indicateur `ai.model_more`.
## E. Lisibilité & contexte `@` (BUG-010, BUG-011) — ✅ livré
- [x] Popover modèle **aligné à droite** du déclencheur (`right: 0`), largeur 340 px bornée à
`100vw - 24px` : ne dépasse plus le bord de la sidebar ancrée à droite (BUG-011).
- [x] Noms de modèles sur **plusieurs lignes** (`overflow-wrap: anywhere`, police 0,78 rem) avec
attribut `title` complet.
- [x] La sélection `@` **capture le vault** renvoyé par `/api/tree-search` ; `_contextVault()`
propage ce vault aux requêtes `/context` et `/chat` et les recherches suivantes restent dans
ce vault (BUG-010, mode Général).
## F. Points d'attention
- La table de capacités reste **statique** (`backend/model_capabilities.py`) : un modèle inconnu
retombe sur le défaut du fournisseur.
- Le select masqué est conservé uniquement pour la rétro-compatibilité ; ne pas le supprimer sans
migrer `_cmdSwitchModel` / `_applyPickerSelection` dans `frontend/js/bookslm.js`.