428 lines
20 KiB
Markdown
428 lines
20 KiB
Markdown
# 🔍 Guide Recherche, PDF, Excel & Excalidraw
|
||
|
||
ObsiGate va au-delà de la simple lecture : recherche puissante, rendu des
|
||
documents riches (PDF, diagrammes) et indexation de leur contenu pour que tout
|
||
soit retrouvable.
|
||
|
||
> **Public :** tous les utilisateurs
|
||
> **Fiches techniques :** [`features/semantic-search.md`](../features/semantic-search.md) ·
|
||
> [`features/pdf.md`](../features/pdf.md) · [`features/excalidraw.md`](../features/excalidraw.md)
|
||
|
||
---
|
||
|
||
## 1. Recherche plein texte (TF-IDF)
|
||
|
||
Le moteur d'ObsiGate s'appuie sur un **index inversé** et un scoring **TF-IDF**
|
||
avec :
|
||
|
||
- **Boost titre** — une correspondance dans le titre pèse 3× plus.
|
||
- **Normalisation des accents** — `resume` trouve `résumé`, `elephant` trouve `éléphant`.
|
||
- **Stemming français** — les variantes des mots sont rapprochées.
|
||
- **Snippets surlignés** — les termes trouvés sont mis en `<mark>` dans l'extrait.
|
||
- **Facettes** — compteurs par vault, par tag et par extension sur les résultats, panneau
|
||
repliable d'un clic (chevron, état mémorisé).
|
||
- **Pagination** — 50 résultats par page.
|
||
- **Tri** — par pertinence (TF-IDF) ou par date de modification.
|
||
- **Chips de filtres** — les filtres actifs apparaissent sous forme de puces retirables.
|
||
- **Historique** — les 50 dernières recherches sont conservées en `localStorage`.
|
||
|
||
La recherche s'effectue **sans I/O disque** : le contenu est déjà en mémoire.
|
||
|
||
---
|
||
|
||
## 2. Syntaxe de requête
|
||
|
||
| Opérateur | Description | Exemple |
|
||
|---|---|---|
|
||
| `tag:<nom>` | Filtre par tag | `tag:recette docker` |
|
||
| `#<nom>` | Raccourci de tag | `#linux serveur` |
|
||
| `vault:<nom>` | Filtre par vault | `vault:IT kubernetes` |
|
||
| `title:<texte>` | Filtre par titre | `title:pizza` |
|
||
| `path:<texte>` | Filtre par chemin | `path:recettes/soupes` |
|
||
| `ext:<type>` | Filtre par type de fichier | `ext:md kubernetes` |
|
||
| `"phrase exacte"` | Recherche d'une phrase | `tag:"multi mots"` |
|
||
|
||
Les opérateurs sont **combinables** :
|
||
|
||
```text
|
||
tag:linux vault:IT ext:md serveur web
|
||
```
|
||
|
||
Cette requête cherche « serveur web » dans les fichiers Markdown de la vault
|
||
`IT` portant le tag `linux`.
|
||
|
||
### Filtres par extension
|
||
|
||
| Extension | Contenu |
|
||
|---|---|
|
||
| `ext:md` | Notes Markdown |
|
||
| `ext:py`, `ext:sh`, `ext:js` | Scripts et code |
|
||
| `ext:pdf` | Documents PDF (texte extrait) |
|
||
| `ext:excalidraw` | Diagrammes Excalidraw (texte extrait) |
|
||
|
||
---
|
||
|
||
## 3. Autocomplétion et suggestions
|
||
|
||
- **`/api/suggest`** — suggère des titres de fichiers.
|
||
- **`/api/tags/suggest`** — suggère des tags.
|
||
- Navigation clavier : `↑` / `↓` puis `Entrée` ; `Échap` ferme les suggestions.
|
||
|
||
### Raccourcis de recherche
|
||
|
||
| Raccourci | Action |
|
||
|---|---|
|
||
| `Ctrl + K` / `Cmd + K` | Focaliser la barre de recherche |
|
||
| `/` | Focaliser la recherche (hors champ texte) |
|
||
| `↑` / `↓` | Naviguer dans les suggestions |
|
||
| `Entrée` | Sélectionner la suggestion active ou lancer la recherche |
|
||
| `Échap` | Fermer les suggestions / quitter la recherche |
|
||
|
||
Recherches sauvegardées et signets sont disponibles via l'API
|
||
(`/api/saved-searches`, `/api/bookmarks`).
|
||
|
||
---
|
||
|
||
## 4. Recherche sémantique (optionnelle)
|
||
|
||
Au classement TF-IDF peut s'ajouter un classement **par embeddings**, fusionné
|
||
via la méthode **RRF** (Reciprocal Rank Fusion). Activation : touche `~`
|
||
(ou `Alt + S`) dans la recherche.
|
||
|
||
Deux modes :
|
||
|
||
1. **Sans dépendance** — un *embedder* par hachage fournit une base utilisable
|
||
immédiatement.
|
||
2. **Embeddings réels** — installez `backend/requirements-semantic.txt` et/ou
|
||
renseignez les variables `OBSIGATE_EMBEDDING_*` pour utiliser
|
||
`all-MiniLM-L6-v2`.
|
||
|
||
Détails et configuration :
|
||
[`features/semantic-search.md`](../features/semantic-search.md).
|
||
|
||
---
|
||
|
||
## 5. Support PDF
|
||
|
||
### Lecture
|
||
|
||
Les fichiers PDF de vos vaults s'affichent **en ligne** dans le navigateur via le
|
||
visualiseur PDF natif (iframe + `<embed>`). Le fichier est **streamé** en HTTP
|
||
Range (`206 Partial Content`) : les gros PDF se chargent progressivement.
|
||
|
||
### Recherche
|
||
|
||
Le texte est **extrait à l'indexation** (`pypdf` / `pymupdf`), donc le contenu
|
||
des PDF est recherchable via la recherche plein texte. Utilisez `ext:pdf` pour
|
||
limiter les résultats aux PDF.
|
||
|
||
### Métadonnées
|
||
|
||
`GET /api/file/{vault}/pdf/info` renvoie les métadonnées (pages, titre, auteur)
|
||
**sans transférer** le document.
|
||
|
||
```bash
|
||
curl "http://localhost:2020/api/file/Recettes/pdf/info?path=menu.pdf"
|
||
```
|
||
|
||
### Limites
|
||
|
||
- **Pas d'OCR** : les PDF scannés (images) ne sont pas recherchables.
|
||
- Pas d'annotation ni d'édition du PDF lui-même.
|
||
|
||
---
|
||
|
||
## 6. Tableurs Excel (XLSX)
|
||
|
||
### Affichage et édition
|
||
|
||
Un fichier `.xlsx` s'ouvre dans une visionneuse dédiée : un tableau par
|
||
feuille, des onglets pour naviguer entre elles (toujours visibles, même à
|
||
une seule feuille), les en-têtes A1/B1 et les numéros de ligne. La barre de
|
||
commandes regroupe les actions en sections (Formules · Insertion · Vue ·
|
||
Fichier) autour d'un bouton **Enregistrer** principal. Chaque cellule est
|
||
modifiable directement (clic), `Entrée` valide, `Échap` annule la saisie.
|
||
**Enregistrer** envoie les cellules modifiées à
|
||
`PUT /api/file/{vault}/xlsx/save` : une sauvegarde par feuille, avec
|
||
**backup automatique** du fichier avant écriture, et une écriture
|
||
**atomique** (le classeur n'est jamais laissé à moitié écrit).
|
||
|
||
Le bouton **« + »** à côté des onglets ajoute une nouvelle feuille. Deux
|
||
pastilles d'état rappellent les limites de la vue : **« Lecture seule »**
|
||
pour les formats `.xls`/`.ods`, et **« Formules non recalculées »** — ObsiGate
|
||
affiche la formule telle qu'elle est enregistrée, Excel la recalcule à
|
||
l'ouverture et les cellules dépendantes ne se rafraîchissent pas à l'écran.
|
||
|
||
### Avertissement avant enregistrement
|
||
|
||
Certains classeurs contiennent des éléments qu'ObsiGate ne sait pas
|
||
réécrire : **valeurs calculées** mises en cache par Excel, segments
|
||
(slicers), chronologies, contrôles de formulaire, connexions/requêtes,
|
||
XML personnalisé, signature numérique, commentaires enrichis, macros.
|
||
L'ouverture affiche alors un bandeau qui les liste, et la première
|
||
sauvegarde demande confirmation dans une fenêtre intégrée au thème de
|
||
l'application. Si vous refusez, rien n'est écrit.
|
||
|
||
> Les **graphiques, images et tableaux croisés** sont, eux, bien conservés.
|
||
|
||
Si le classeur est modifié ailleurs entre-temps (autre poste, Excel,
|
||
synchronisation…), ObsiGate n'interrompt pas votre travail : un bandeau vous
|
||
propose de **réessayer**. Le bouton **Réessayer** relit d'abord le fichier pour
|
||
récupérer la version courante, puis rejoue l'enregistrement — vos
|
||
modifications restent en place pendant tout ce temps.
|
||
|
||
### Formules
|
||
|
||
Par sécurité, une valeur saisie commençant par `=` ou `@` est **stockée comme
|
||
texte** (une formule injectée s'exécuterait à l'ouverture du fichier dans
|
||
Excel). Le bouton `f(x)` de la barre d'outils active les vraies formules pour
|
||
la session en cours.
|
||
|
||
```bash
|
||
curl -X PUT "http://localhost:2020/api/file/Recettes/xlsx/save?path=budget.xlsx" -H "Content-Type: application/json" -d '{"sheet": "Budget", "cells": {"B1": "250"}, "allow_formula": false, "force": false}'
|
||
```
|
||
|
||
- `allow_formula` : `true` pour écrire une vraie formule (`=B1*2`).
|
||
- `force` : `true` pour enregistrer malgré les éléments non préservés
|
||
(sinon l'API répond **409** `xlsx_lossy_content`).
|
||
- `if_match` (facultatif) : la **version** du fichier attendue, telle que la
|
||
lecture la renvoie (`xlsx_revision` ou `revision`). Si le fichier a changé
|
||
depuis, l'écriture est refusée (**409** `conflict`, `details.reason =
|
||
"stale_revision"`) au lieu d'écraser le travail de l'autre écrivain ;
|
||
relisez le fichier puis renvoyez la nouvelle version. Les trois routes
|
||
d'écriture (`xlsx/save`, `xlsx/structure`, `csv/save`) acceptent l'en-tête
|
||
`If-Match` ou le champ `if_match` et renvoient la version à jour dans
|
||
`revision`.
|
||
|
||
### Feuilles volumineuses et lecture par fenêtres
|
||
|
||
Le rendu est plafonné à **500 lignes × 40 colonnes** par feuille. Quand
|
||
une feuille dépasse ce plafond, un bandeau **« Feuille tronquée »**
|
||
l'annonce explicitement (par exemple « 500 lignes affichées sur 520 »)
|
||
au lieu de présenter une table courte comme complète — le classeur,
|
||
lui, n'est jamais modifié. La ligne d'en-têtes de colonnes reste
|
||
visible pendant le défilement vertical.
|
||
|
||
Côté API, `GET /api/file/{vault}/xlsx/sheet` sert une feuille **par
|
||
fenêtres de lignes**, y compris au-delà du plafond d'affichage — les
|
||
coordonnées A1 renvoyées sont celles de la feuille réelle :
|
||
|
||
```bash
|
||
curl "http://localhost:2020/api/file/Recettes/xlsx/sheet?path=budget.xlsx&sheet=Budget&offset=500&limit=200"
|
||
```
|
||
|
||
- `offset` : première ligne renvoyée (0-based) ; `limit` : nombre de
|
||
lignes (1 à 1 000 par requête).
|
||
- La réponse porte `total_rows`, `truncated` et `has_more` pour paginer.
|
||
- Erreurs : **404** si la feuille n'existe pas, **415** si le fichier
|
||
n'est ni un `.xlsx` ni un `.xlsm`.
|
||
|
||
### Fonctions avancées
|
||
|
||
**Barre de formule, zone Nom et navigation clavier** — au-dessus du tableau, la
|
||
**zone Nom** affiche l'adresse de la cellule active (`B12`) ou de la plage
|
||
sélectionnée (`A1:B3`) et elle est **éditable** (« Atteindre ») : saisissez une
|
||
référence puis `Entrée` pour y aller (`B12`, `A1:B3`, `$A$1`, ou `Feuille2!A1`
|
||
pour changer d'onglet) ; une référence inconnue est refusée avec un message et
|
||
l'adresse précédente est restaurée. La barre de formule reflète la cellule
|
||
active et propose les **noms de fonctions** courants pendant la saisie.
|
||
|
||
`Tab`/`Maj+Tab` et les flèches circulent entre les cellules, `Maj+flèches` étend
|
||
la sélection, `Entrée` valide, `Maj+Entrée` insère un saut de ligne **dans** la
|
||
cellule, `F2` ouvre la cellule en édition, `Suppr` vide la sélection,
|
||
`Échap` restaure la valeur d'origine ; `Origine`/`Fin` vont au bord de la ligne,
|
||
`Ctrl+Origine`/`Ctrl+Fin` aux coins de la feuille affichée,
|
||
`PgPréc`/`PgSuiv` font défiler d'un écran, `Ctrl+flèches` saute au bout de la
|
||
plage de données, `Ctrl+A` sélectionne toute la feuille affichée et `Ctrl+S`
|
||
enregistre. Tant que la cellule n'est pas en cours d'édition, `Suppr`
|
||
efface la sélection plutôt qu'un caractère.
|
||
|
||
**Presse-papiers de plage** — copier, couper et coller un **bloc** de cellules
|
||
(`Ctrl+C`, `Ctrl+X`, `Ctrl+V`, ou les entrées correspondantes du menu
|
||
contextuel) : coller un bloc copié ici **ou depuis Excel** remplit la plage à
|
||
partir de la cellule active et la laisse sélectionnée. Le collage est du
|
||
**texte** (formules et valeurs recopiées telles quelles) et reste **annulable** ;
|
||
« couper » efface la source après le collage (un collage sur place ne l'efface
|
||
pas). Un bloc plus large que la grille affichée est tronqué, avec un message.
|
||
|
||
**Annuler / rétablir** — `Ctrl+Z` (ou le bouton **Annuler** du ruban) revient
|
||
sur les dernières éditions de cellules, `Ctrl+Maj+Z` / `Ctrl+Y` les rétablit.
|
||
|
||
**Sélection et menu contextuel** — cliquer une cellule l'active, **glisser**
|
||
ou `Maj+clic` sélectionne une plage (affichée dans la zone Nom, ex. `A1:B3`),
|
||
et cliquer un **en-tête** sélectionne toute la ligne ou colonne. Un **clic
|
||
droit** (ou un **appui long** sur mobile) ouvre un menu : copier, couper,
|
||
coller, insérer/supprimer une ligne ou une colonne, trier A→Z / Z→A, effacer le
|
||
contenu. Chaque entrée porte une **icône** ; le menu se referme dès qu'il perd
|
||
le focus (clic ailleurs, `Échap`) et se parcourt au clavier (`↑`/`↓`).
|
||
|
||
**Tri, filtre, recherche, export** — le tri (ascendant / descendant) s'applique
|
||
depuis le menu contextuel et n'affecte que l'affichage ; les lignes se filtrent et
|
||
la recherche (`Ctrl+F` du panneau) parcourt **toutes les feuilles** : le compteur
|
||
indique le nombre de feuilles concernées et passer sur une correspondance
|
||
**active l'onglet** qui la contient.
|
||
|
||
La sortie propose quatre formats, toujours sur le **contenu affiché** (et jamais
|
||
sur les valeurs calculées en cache) :
|
||
|
||
- **CSV** (bouton `CSV`) — exporte la **sélection** quand une plage de plusieurs
|
||
cellules est active (le nom du fichier reprend la plage, ex.
|
||
`Fruits-A1B2.csv`), sinon la feuille entière ;
|
||
- **Markdown** et **HTML** (menu **Exporter**) — tableau markdown ou document
|
||
HTML autonome, mêmes règles de sélection ;
|
||
- **Imprimer** (menu **Exporter**) — imprime la feuille ou la sélection seule,
|
||
sans le ruban ni les panneaux de l'application.
|
||
|
||
Rien de tout cela ne modifie le classeur.
|
||
|
||
**Structure** — le menu **Structure** de la barre d'outils ajoute,
|
||
renomme, duplique ou supprime une feuille, et insère/supprime des lignes ou
|
||
colonnes autour de la cellule active (`PUT …/xlsx/structure`, backup
|
||
automatique et confirmation, comme pour l'édition des cellules).
|
||
|
||
**Mise en forme** — le bouton **Mise en forme** ouvre un menu qui agit sur la
|
||
**sélection courante** (une cellule ou une plage) :
|
||
|
||
- **caractère** — gras, italique, souligné, effacer la mise en forme ;
|
||
- **alignement** — gauche, centré, droite ;
|
||
- **couleurs** — couleur de police et couleur de fond (sélecteur natif, aucune
|
||
palette imposée) ;
|
||
- **format de nombre** — général, nombre, pourcentage, devise, date, texte ;
|
||
- **structure** — fusionner / défusionner les cellules, figer / libérer les
|
||
volets, largeur de colonne, hauteur de ligne (fusionner exige une vraie
|
||
plage).
|
||
|
||
L'écriture passe par `PUT …/xlsx/style`, avec les mêmes garanties que l'édition
|
||
des cellules : backup automatique, écriture atomique, confirmation si
|
||
l'opération détruirait des éléments non préservables (graphiques, valeurs
|
||
calculées en cache…) et **détection d'un écrivain externe** (`If-Match` →
|
||
message « Réessayer »). Un `.csv` ne portant pas de mise en forme, le bouton
|
||
n'y est pas proposé (il est également absent d'une grille en lecture seule).
|
||
La lecture restitue par ailleurs les couleurs, polices, cellules fusionnées et
|
||
volets figés du fichier ; l'ancrage de la zone figée est conservé au défilement.
|
||
Les **commentaires**, liens hypertexte, validation de données, mise en forme
|
||
conditionnelle et bordures restent hors périmètre.
|
||
|
||
**Formats de fichiers** — `.xlsm` s'édite comme un `.xlsx` et ses
|
||
**macros sont préservées** à l'enregistrement (y compris le chargement des
|
||
lignes au-delà du plafond) ; `.xls` et `.ods` s'affichent en **lecture
|
||
seule** ; un `.csv` s'ouvre dans la même grille et se réécrit conformément à
|
||
la RFC 4180 (les guillemets et séparateurs sont échappés). Le **séparateur
|
||
du CSV est détecté** (`;`, `,` ou tabulation) à la lecture et **réutilisé à
|
||
l'enregistrement** : un fichier exporté par Excel en français (point-virgule)
|
||
s'affiche donc en colonnes distinctes et le reste après édition.
|
||
|
||
**Tableau de bord** — le bouton **Tableau de bord** ouvre un **inspecteur
|
||
latéral droit** (la grille reste visible à côté) qui liste les plages
|
||
nommées du classeur (nom, référence, portée), signale les feuilles
|
||
contenant des graphiques ou des tableaux croisés, et donne pour chaque
|
||
feuille un résumé (cellules, lignes, colonnes, formules, valeurs
|
||
numériques) avec quelques chiffres clés. Cliquer une **plage nommée**
|
||
sélectionne sa première cellule dans la grille, et le panneau est
|
||
**redimensionnable**. L'en-tête de l'inspecteur offre
|
||
aussi un accès direct à l'**assistant IA**, qui peut ensuite exploiter ces
|
||
plages. Ses outils couvrent désormais les **trois formats édités**
|
||
(`.xlsx`, `.xlsm`, `.csv`) : `list_xlsx_sheets` et `xlsx_to_markdown` pour lire,
|
||
`search_workbook` (recherche dans toutes les feuilles, comptée par feuille),
|
||
`analyze_range` (agrégats — nombre, somme, moyenne, min, max — d'une plage A1),
|
||
`update_xlsx_cells` et `append_xlsx_rows` pour modifier, et
|
||
`edit_xlsx_structure` pour la structure (ajouter/renommer/dupliquer/supprimer
|
||
une feuille, insérer/supprimer des lignes ou des colonnes).
|
||
|
||
### Limites
|
||
|
||
- L'affichage intégré démarre à **500 lignes × 40 colonnes** par feuille ;
|
||
sous une feuille plus grande, le bouton **« Charger la suite »** (ou le
|
||
défilement vers le bas du tableau) ajoute les lignes suivantes par
|
||
fenêtres de 500 — elles deviennent aussitôt éditables et
|
||
sauvegardables. Le chargement paresseux est **vertical uniquement** :
|
||
l'axe des colonnes reste tronqué à 40 (les colonnes au-delà ne sont ni
|
||
affichées ni exportées).
|
||
- Un **format de nombre personnalisé** (devise, pourcentage…) est signalé
|
||
par une police à chasse fixe à la lecture ; depuis le bouton **Mise en
|
||
forme**, appliquer un format ne change que le format de la cellule, **pas**
|
||
la valeur affichée (aucun recalcul n'est fait, cf. les limites d'export
|
||
ci-dessous).
|
||
- `.xls` et `.ods` restent en lecture seule (convertir vers `.xlsx` pour
|
||
éditer) ; les macros d'un `.xlsm` sont conservées mais ne s'exécutent
|
||
pas dans ObsiGate.
|
||
- La **poignée de recopie** (fill), la multi-sélection `Ctrl+clic` et le
|
||
glisser-déposer de lignes/colonnes ne sont pas proposés ; un collage de
|
||
plusieurs cellules s'annule **cellule par cellule** (`Ctrl+Z` répété).
|
||
- Les exports (CSV, Markdown, HTML, impression) reflètent ce qui est **affiché** :
|
||
une feuille tronquée s'exporte tronquée, et les formules sortent telles
|
||
qu'enregistrées (aucune valeur calculée n'est recalculée). Un classeur reste
|
||
la source de vérité : utilisez **Charger la suite** pour exporter au-delà du
|
||
plafond.
|
||
- **Aucun moteur de formule** : ObsiGate lit et écrit les formules telles
|
||
qu'Excel les a enregistrées, sans jamais les recalculer. Une saisie
|
||
commençant par `=` ou `@` est stockée comme **texte** (garde anti-DDE)
|
||
tant que le bouton `f(x)` n'est pas activé ; l'enregistrement vous le
|
||
signale par un message. Excel reste la référence pour les valeurs calculées.
|
||
- L'**annulation** couvre l'édition, l'effacement, le tri/filtre et les
|
||
actions de structure ; en revanche une **suppression** (feuille, ligne,
|
||
colonne) n'est pas annulable, faute d'inverse.
|
||
|
||
---
|
||
|
||
## 7. Diagrammes Excalidraw
|
||
|
||
Les fichiers `.excalidraw` et `.excalidraw.md` (dont le format compressé du
|
||
**plugin Obsidian Excalidraw**) s'ouvrent dans un **éditeur visuel Excalidraw
|
||
complet**, dans une iframe sandboxée.
|
||
|
||
- **Dessin et édition** sans quitter ObsiGate.
|
||
- **Sauvegarde automatique** (débounce 2 s) ou `Ctrl + S`.
|
||
- **Thème** clair/sombre suivi automatiquement.
|
||
- **Texte indexé** : le texte des éléments du diagramme est extrait à
|
||
l'indexation et donc recherchable (`ext:excalidraw`).
|
||
|
||
Fiche technique : [`features/excalidraw.md`](../features/excalidraw.md).
|
||
|
||
---
|
||
|
||
## 8. Autres contenus riches
|
||
|
||
### Mermaid
|
||
|
||
Les blocs de code ` ```mermaid ` sont rendus en diagrammes interactifs (live
|
||
preview, thèmes, zoom, plein écran, pré-processeur compatible syntaxe Obsidian).
|
||
|
||
### Images Obsidian
|
||
|
||
Toutes les syntaxes d'images sont supportées avec résolution intelligente en
|
||
7 stratégies :
|
||
|
||
1. chemin absolu ;
|
||
2. dossier d'attachements configuré (`VAULT_N_ATTACHMENTS_PATH`) ;
|
||
3. index de démarrage (correspondance unique) ;
|
||
4. même répertoire que la note ;
|
||
5. racine de la vault ;
|
||
6. index de démarrage (correspondance la plus proche) ;
|
||
7. repli : `[image not found: fichier.ext]`.
|
||
|
||
Rescan manuel des attachements :
|
||
|
||
```bash
|
||
curl -X POST "http://localhost:2020/api/attachments/rescan/Recettes"
|
||
```
|
||
|
||
### Graphe et backlinks
|
||
|
||
- **Graphe** : vue force-directed (Barnes-Hut), filtres (tag, type), profondeur,
|
||
mode focus, export PNG, aperçu au survol (`Ctrl + clic`).
|
||
- **Backlinks** : `GET /api/file/{vault}/backlinks?path=…` liste les notes
|
||
pointant vers un document.
|
||
|
||
---
|
||
|
||
## 9. Dépannage
|
||
|
||
| Symptôme | Piste |
|
||
|---|---|
|
||
| Un PDF ne s'affiche pas | Vérifier la taille (`OBSIGATE_PDF_MAX_SIZE_MB`, défaut 50 Mo) |
|
||
| Le texte d'un PDF scanné n'est pas trouvé | Pas d'OCR : normal |
|
||
| Une image reste introuvable | Configurer `VAULT_N_ATTACHMENTS_PATH`, puis rescan |
|
||
| La recherche sémantique ne s'active pas | Vérifier le toggle `~` et `OBSIGATE_EMBEDDING_*` |
|
||
| Résultats obsolètes | Forcer une réindexation : `GET /api/index/reload` |
|