docs(wiki): commandes d'installation reparees — les noms d'assets ont change en rc.4
Les guides donnaient des commandes `wget` avec les URL de rc.3. Bumper le
seul numero de version ne suffisait pas : les fichiers publies portent
desormais un prefixe de plateforme (`Linux.AppImage.-.`, `Mac.Silicon.-.`),
si bien qu'une URL construite a l'ancienne rend un 404. C'est exactement ce
sur quoi un nouvel utilisateur bute, et rien dans la page ne le lui dirait.
Les trois URL de telechargement du wiki sont verifiees : elles repondent en
200. Un commentaire dans chaque bloc explique le prefixe, pour que la
prochaine mise a jour ne refasse pas l'erreur.
Tailles d'installeurs mesurees sur les fichiers reellement publies, plutot
que reconduites : 262 Mo (AppImage), 158 Mo (deb), 263 et 268 Mo (DMG
Silicon et Intel).
En-tetes `**Version**` des neuf pages concernees passes en 1.0.0-rc.4.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
docs(wiki): neuvième passe — les réglages livre n'ont aucune UI, un bouton Test Connection qui n'existe pas pour Ollama
- Books-and-Chapters : les quatre réglages livre (style de notes,
numérotation, bibliographie, numérotation des chapitres) sont
présentés comme configurables alors qu'aucun n'a de chemin
d'interface — grep exhaustif : noteStyle n'apparaît que dans un
fichier de test, bookSettings. n'est lu nulle part côté renderer sauf
en lecture seule dans EditorPanel.tsx:169, ProjectPanel.tsx n'expose
que le sélecteur de type de projet. Seul un projet.json modifié à la
main permettrait de changer ces réglages — jamais mentionné comme
possible. Plus large et plus impactant que les précédentes lacunes
« capacité sans UI » vu le rôle central de la fonctionnalité livre.
Filé en issue #24.
- Guides Linux et macOS : « Click Test Connection to validate » dans la
configuration LLM/Ollama — ce bouton n'existe que pour Zotero
(ZoteroConfigSection.tsx). Le seul contrôle réel du panneau LLM est
le bouton de rafraîchissement des modèles (icône 🔄).
- Coût environnemental : preuve supplémentaire trouvée (recherche +
vérification directe d'une source citée) que la littérature publiée
sur le coût carbone de l'inférence LLM s'exprime généralement en
grammes voire en milligrammes, pas en kilogrammes — une requête
ChatGPT complète est couramment citée autour de 4 g CO2. Cela va à
l'encontre de l'indice directionnel précédent (qui supposait que les
chiffres à l'échelle du kg étaient probablement voulus). Aucune
source précise n'a pu être retrouvée pour le taux exact de cette
page dans un sens ou l'autre — l'encart reformulé pour présenter les
deux indices contradictoires honnêtement, sans trancher.
docs(wiki): la vérification Ollama se déclenche à l'ouverture des Paramètres, pas au lancement
Les quatre pages d'installation/build répétaient la même inexactitude,
copiée telle quelle d'une page à l'autre : « au premier lancement,
ClioDeck vérifie la connexion Ollama ». Vérifié dans ConfigPanel.tsx —
le déclencheur réel est un useEffect qui se déclenche au montage du
panneau Paramètres (handleRefreshModels), pas au démarrage de
l'application. Un utilisateur qui n'ouvre jamais les Paramètres ne
déclenche jamais cette vérification. Confirmé qu'aucune vérification
équivalente n'existe au niveau du démarrage (App.tsx, main/index.ts).
docs(wiki): corriger la création du venv Python — pas automatique
Le guide macOS affirmait que le venv Python se crée automatiquement au
premier lancement. Faux — topic-modeling-handlers.ts:3 dit
explicitement « Gestion manuelle de l'installation et du statut de
l'environnement Python » ; TopicModelingSection.tsx est un panneau de
paramètres avec bouton d'installation et suivi de progression, une
action déclenchée par l'utilisateur. Contredisait par ailleurs le guide
Linux, qui avait la bonne formulation (« si l'utilisateur le demande,
dans Settings »).
docs(wiki): deuxième passe — corriger vectors.db, une régression de numérotation, et deux erreurs de sécurité factuelle
Cette repasse adversariale a trouvé des erreurs que la première n'avait
pas vues, y compris deux que j'ai moi-même introduites en corrigeant
autre chose.
**Régression introduite par mes propres corrections précédentes** :
- Les arborescences de projet réécrites dans les guides Linux/macOS
citaient `vectors.db` comme fichier d'index PDF. Vérifié frais contre
backend/core/workspace/layout.ts:67 — le nom réel est `brain.db`,
store partagé (PDF + Tropy + historique) depuis la fusion. `vectors.db`
n'est qu'un nom pré-fusion, uniquement pertinent pour la migration
d'anciens projets. Corrigé dans 1.-ClioDeck-Installation.md,
1.1-Linux, 1.2-macOS, et 2.1-Build-and-Deployment-Guide.md (cette
dernière portait la même erreur, présente avant mes modifications).
- Numérotation cassée dans « Option B: Installation from Source »
(Linux et macOS) : la suppression d'une étape lors de ma correction
precedente avait laissé un saut 3 → 5 sans renuméroter. Corrigé dans
les deux fichiers.
**Erreurs à impact utilisateur réel, ratées par la première passe** :
- Obsidian Vault Guide : la page affirmait qu'« Unlink » laisse l'index
en place et qu'un re-lien le réutilise. Vérifié contre
fusion-handlers.ts:619-631 — le handler fait `fs.unlink(dbPath)`,
l'index est bien supprimé ; se relier déclenche une reconstruction
complète. Un utilisateur suivant l'ancienne description perdrait du
temps à croire son index intact. Champ TITLE → TITRE corrigé au
passage (vérifié fusion-chat-service.ts:838).
- Tropy Integration Guide : un raccourci clavier Ctrl+Shift+S pour la
synchronisation n'existe nulle part (grep sur menu.ts et les
composants PrimarySources, aucune occurrence) — retiré. La page
décrivait aussi les embeddings comme figés sur nomic-embed-text ;
tropy-service.ts:98 utilise le provider configuré, comme partout
ailleurs dans l'app. Chemins de stockage corrigés vers brain.db +
primary-hnsw.index (vérifiés dans PrimarySourcesVectorStore.ts:125-126).
- MCP Integration Guide : la troncature des réponses (4000 caractères,
2000 pour Gallica/HAL) n'était pas documentée alors qu'elle est
visible dans les réglages de l'app elle-même ; ajoutée. Libellés des
onglets alignés sur l'UI réelle (« Claude Code CLI », « Generic MCP
(stdio) »).
Build-and-Deployment-Guide.md : la section « User Installation » citait
encore des noms de fichiers 1.0.0 sans suffixe arm64, alors que les
guides Linux/macOS avaient déjà été corrigés dans le même sens la
première fois — incohérence entre pages, maintenant alignée.
docs(wiki): réécrire le guide d'installation macOS — même rot que Linux
Corrections identiques à celles du guide Linux (voir e09c011), plus une
propre à cette page :
- Nom de fichier DMG codé en dur (0.1.0) → les deux noms réels de la
release courante (Intel + Apple Silicon).
- structure de projet fabriquée, npx electron-rebuild -f, logs fichier
inexistants, mxbai « fallback », gemma2:2b sans réserve sur les
outils, liens morts, licence MIT : mêmes corrections que Linux.
- Désinstallation : la section supprimait ~/.config/cliodeck, un
chemin Linux (XDG) copié-collé par erreur dans le guide macOS —
Electron range les données utilisateur sous
~/Library/Application Support/ sur macOS, jamais sous ~/.config.
docs: seconde passe du wiki — vérifications, traductions, parcours débutant
La relecture adverse a rattrapé, entre autres, une erreur introduite par
la première passe : le guide des LLM embarqués affirmait désormais que
ClioDeck pouvait produire ses embeddings sans Ollama, au motif que le
catalogue propose un modèle embarqué et que le réglage existe. En traçant
l'appel jusqu'au registre de providers, il n'y a aucune branche
embarquée : le réglage ne change rien. La page dit maintenant la vérité,
écart entre catalogue et câblage compris.
Autres rattrapages :
- vingt liens vers l'ancien dépôt inactinique/cliodeck, dans sept pages
dont les deux guides d'installation ;
- la page journal décrivait .cliodeck/history.db et un dossier
conversations/, vestiges d'avant la fusion : tout vit dans brain.db ;
- six pages en français dans un wiki anglophone, et non deux comme la
première passe l'avait cru — les deux nommées sont traduites, quatre
restent ;
- quatre imprécisions dans les pages créées à la première passe (plan
derrière un dépliant, libellés réels des boutons, troncature de la
recherche, message d'un fichier manquant).
Créé : 1.0-Getting-Started, qui comblait le trou entre « installer » et
« écrire » — rien n'expliquait comment créer un projet ni ce que le choix
du type implique.
Les cinq pages laissées sous bandeau à la première passe ont été reprises
ligne à ligne : une était fausse, quatre exactes. Plus aucun bandeau.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
first commit after move from inactinique