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): RC4 — notes de version, et 23 defauts documentes qui n'existent plus
Le wiki citait 23 issues comme ouvertes. Toutes sont fermees : chaque
« voir issue #N » decrivait donc un defaut corrige, et le wiki decrivait
une application qui n'existe plus.
Nouvelles notes de version (3.4), sur le modele des RC3 : orientees
utilisateur, ordonnees par ce qu'on perdait ou voyait de faux plutot que
par famille technique. La section 1 s'ouvre sur les deux defauts qui
retiraient du texte d'un livre exporte, parce que c'est ce qu'un auteur
doit lire en premier.
Dix-huit pages corrigees. Le plus souvent, un long paragraphe decrivant un
bug verifie dans le code est remplace par sa resolution — d'ou un diff qui
retire plus de lignes qu'il n'en ajoute. Les affirmations les plus
trompeuses etaient :
- les reglages d'ouvrage « n'ont aucune UI » (ils en ont une depuis la RC4)
- l'export Word d'un livre cite « sort vide » (corrige)
- le corpus manuscrit sans interface (elle existe)
- le compresseur de contexte « jamais appele » (cable, et ses trois
distorsions corrigees)
- `embeddingProvider` sans controle (section Embeddings)
- le filtre par collection absent, le bouton OCR manuel injoignable, le
toggle des noeuds auteurs desactive en dur
Home annonce la RC4 ; Features passe en 1.0.0-rc.4 et gagne deux sections
— corpus manuscrit et accessibilite — qui n'avaient nulle part ou vivre.
Les limitations connues des notes RC4 sont argumentees, pas subies :
pdfjs-dist renvoie a #77, et le mode de detection seule de l'inspecteur
explique pourquoi une source primaire contenant des imperatifs ne doit pas
etre tronquee.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
docs(wiki): douzième passe — touches d'envoi du chat inversées, contradictions avec les issues #24 et #28, minTopicSize figé à 3
Aucun nouveau bug applicatif filé cette passe — uniquement des
corrections de documentation, mais deux d'entre elles sont des
contradictions directes avec des bugs déjà filés lors des passes
précédentes, qui avaient survécu parce que les pages n'avaient pas été
recroisées entre elles :
- Features.md : les réglages de compression de contexte et le ratio de
compression dans RAGExplanation étaient encore présentés comme
actifs, alors que la passe 11 a établi qu'ils sont totalement
jamais câblés (issue #28) — corrigé et lié.
- RC3 Release Notes : les réglages de livre (notes, numérotation,
bibliographie) étaient listés comme une fonctionnalité RC3 sans
réserve, alors que 1.15-Books-and-Chapters.md documente depuis la
passe 9 qu'aucun n'a d'interface (issue #24) — réserve ajoutée et
lien.
- RC2 Release Notes : deux affirmations sur obsidian-vectors.db
encore séparé de brain.db à l'époque de RC2 étaient fausses même
pour ce tag précis — vérifié via `git show v1.0.0-rc.2:...` que la
fusion datait de 5 jours avant le tag.
Corrections supplémentaires :
- Keyboard Shortcuts : les touches d'envoi/retour à la ligne du chat
RAG étaient inversées (Ctrl/Cmd+Entrée envoie, Entrée simple insère
un retour à la ligne — c'était documenté à l'envers) ; la touche
Échap pour annuler n'existe pas, seul un bouton l'annule.
- Guide des templates Word : mauvais pointeur de dépannage vers le
Journal Panel (qui est le journal d'usage IA, sans rapport avec les
logs d'export).
- Corpus Analysis Guide : nombre de topics par défaut réellement 10
(pas "Auto"), taille minimale de topic figée à 3 dans le code (pas
5, sans aucune interface pour la changer).
- Tropy Integration Guide : documentation du bouton de purge de la
base des sources primaires (tropy:purge), jusqu'ici non documenté
mais correctement scopé (contrairement au bug Obsidian/brain.db).
- Brainstorm Mode Guide : liste des préfixes de verbes de lecture
incomplète dans la nouvelle section bannière MCP.
- Build and Deployment Guide : npm test tourne en mode watch par
défaut, pas "une fois" ; storage des clés API.
- ClioDeck Installation : le lanceur .desktop généré ajoute
--no-sandbox à l'AppImage, absent du lancement direct.
Quatre passes de vérification exhaustive supplémentaires n'ont rien
trouvé de nouveau dans leurs clusters respectifs (LLM & analyse au-delà
du point ci-dessus, install & build au-delà des deux points ci-dessus).
docs(wiki): huitième passe — une resynchronisation Zotero qui efface silencieusement la collection, une transcription manuelle fabriquée, une nuance sur l'issue #19
- Zotero guide : setBibliographySource écrase l'objet entier au lieu de
fusionner, et le sélecteur de collection repart à vide
(useState('')) à chaque réouverture du dialogue de sync. Resynchroniser
sans re-choisir la collection écrase silencieusement
zoteroCollection avec undefined — l'association précédente est
perdue sans avertissement. Documenté.
- Tropy guide : « Manuel : Transcription saisie dans ClioDeck » comme
quatrième source de transcription — fabriqué. updateTranscription(...,
source: 'manual') existe côté backend mais n'a aucun point d'appel
dans tout le renderer ; seul l'import de fichier PAGE/ALTO fonctionne
réellement.
- Word Templates : nuance ajoutée à l'avertissement de l'issue #19 —
sur le mécanisme 2 (docx natif), un échec de fusion de template
produit paradoxalement un document PLUS complet qu'une fusion
réussie, puisque le document natif est toujours construit à partir
du manuscrit correctement assemblé, alors qu'une fusion réussie
aurait rempli {content} avec la valeur non assemblée.
docs(wiki): l'export Word d'un livre est cassé dans le cas courant, pas juste "peu fiable"
En creusant pourquoi {content} ne recevait pas le manuscrit assemblé sur
la route pandoc (déjà noté), la trace complète du code a révélé un vrai
bug applicatif, pas seulement une nuance documentaire :
- WordExportModal.tsx:167 envoie un content vide pour un livre —
l'assemblage se fait censément côté main.
- word-export.ts:643-646 retourne immédiatement vers exportWithPandoc()
dès que bibliographie + pandoc + pas de moteur de citation (le cas le
plus courant pour un livre avec citations).
- assembleManuscript() n'a qu'UN SEUL point d'appel dans tout le fichier
(ligne 667), à l'intérieur du chemin natif — inatteignable depuis la
branche pandoc qui vient de renvoyer.
- exportWithPandoc() n'a aucune référence à manuscript/assembleManuscript
et écrit options.content (vide) tel quel dans le fichier d'entrée
pandoc (lignes 503-505). Pandoc réussit silencieusement sur un contenu
vide : le .docx produit a une page de titre et aucun texte de chapitre.
- pdf-export.ts fait ça correctement (assemblage inconditionnel avant
tout branchement bibliographie) — la route Word/pandoc est l'anomalie.
Signalé en issue #19 (bug applicatif réel, pas seulement un problème de
doc). Trois pages corrigées pour refléter la vraie gravité :
- 1.3-Guide-for-Using-Word-Templates.md : l'avertissement portait
uniquement sur {content} via un template ; élargi pour dire que
l'export sans template est tout autant affecté.
- 1.15-Books-and-Chapters.md : « Word produces one section per chapter »
était affirmé sans réserve — précisé que ça casse justement dans le
cas bibliographie + pandoc + pas de moteur de citation.
- 1.10-Export-Presentations.md : pointeur ajouté vers la mise en garde,
en précisant que le PDF n'est pas affecté.
Au passage, lien mort corrigé sur 1.4-Keyboard-Shortcuts.md : README.md
n'existe pas dans ce dépôt wiki.
docs(wiki): {content} n'est pas fiable pour un livre via le mécanisme placeholder
Vérifié dans word-export.ts : le manuscrit assemblé (chapitres joints)
est stocké dans une variable locale sourceMarkdown après un appel à
assembleManuscript(), mais mergeWithTemplate() reçoit content:
options.content tel quel (ligne 975) — la valeur d'origine, non
assemblée, envoyée vide par le renderer pour les livres
(validation.ts:569-570 le confirme). Le contenu assemblé n'alimente
que le chemin de génération native sans template. La table des
placeholders promettait « chapitres assemblés dans l'ordre » sans
cette réserve depuis la première rédaction de la page.
docs(wiki): la garantie « jamais perdre son export » ne couvre qu'un des deux mécanismes
Word Templates : « You'll never lose your export! » s'appliquait comme
si les deux mécanismes avaient un filet de sécurité. Faux — vérifié
dans word-export.ts : seul le mécanisme 2 (docxtemplater) a un
try/catch qui retombe sur la génération native. Le mécanisme 1
(pandoc + reference-doc) a son propre try/catch qui renvoie
{success: false, error} directement, sans repli — aucune relance côté
docx natif. Précisé.
Export-Presentations : la réserve ajoutée en passe 3 ne citait que 2
des 3 conditions du guide Word Templates (bibliographie absente OU
moteur de citation demandé) — il manquait « bibliographie présente
mais pandoc introuvable ». Reformulé pour renvoyer au guide plutôt que
de paraphraser une liste à trois conditions qui a déjà changé trois
fois sur l'autre page.
docs(wiki): troisième passe — contradiction laissée par ma propre réécriture, et une recommandation de la deuxième passe jamais appliquée
- Word Templates : la section « Creating a Template with Placeholders »
renvoyait encore à une « route 3 » — numérotation à trois routes que
ma propre réécriture de la deuxième passe avait pourtant remplacée
par deux mécanismes. La phrase contredisait donc l'aperçu corrigé
quatre lignes au-dessus. Reformulée pour dire explicitement à quel
mécanisme la section s'applique.
- Même page : « premier trouvé, ordre alphabétique » pour plusieurs
templates .dotx — faux, findTemplate() utilise fs.readdir() sans
aucun tri, l'ordre dépend du système de fichiers. Libellé du bouton
corrigé aussi (« Export to Word », pas « Export Word (.docx) »).
- Keyboard Shortcuts : Ctrl/Cmd+R et Ctrl/Cmd+Shift+R (reload/force
reload) existent réellement dans menu.ts mais n'étaient documentés
nulle part — un raccourci standard d'Electron, facile à déclencher
par erreur en écrivant, avec un effet réel (recharge la fenêtre).
- Export-Presentations : la deuxième passe avait explicitement
recommandé d'ajouter une réserve ici (« styles ou placeholders selon
la bibliographie ») après avoir corrigé le guide Word Templates —
recommandation jamais appliquée. Faite maintenant.
docs(wiki): deuxième passe — corriger une erreur dans ma propre réécriture, et un vrai manque d'UI
**Erreur dans ma propre correction précédente** :
- Guide des LLM embarqués : j'avais écrit que embeddingProvider se
règle « dans Paramètres → LLM » au même titre que generationProvider.
Faux — vérifié frais : grep sur tout src/renderer/ pour
"embeddingProvider" ne retourne aucun fichier ; RAGSettingsPanel.tsx
n'écrit jamais que generationProvider ; EmbeddedLLMSection.tsx ne
contient aucune occurrence du mot "embedding". Le moteur sait faire
des embeddings embarqués, mais rien dans l'interface ne permet de
les sélectionner ou de télécharger le modèle — seule l'édition
manuelle du fichier de configuration le permet aujourd'hui. Corrigé
à quatre endroits de la page, et signalé comme un vrai manque produit
en issue #18 (https://github.com/cliodeck/cliodeck-app/issues/18),
pas seulement un défaut de documentation.
**Erreur dans ma réécriture du guide Word Templates** : le découpage en
trois routes d'export était faux. Vérifié frais dans word-export.ts —
mergeWithTemplate() (fusion par {placeholders}) ne dépend que de
templatePath, pas du tout de useEnginePipeline. Il n'y a que deux
mécanismes réels : pandoc+reference-doc (styles, uniquement si
bibliographie + pandoc + moteur de citation non demandé), et
native+docxtemplater (placeholders, dans tous les autres cas — y
compris bibliographie + moteur de citation demandé, que ma première
version traitait à tort comme une troisième route « à base de styles »).
**Erreurs ratées par la première passe** :
- Corpus Analysis Guide : langue par défaut du topic modeling annoncée
« Français », en réalité « multilingual » (main.py:54-56,
useCorpusData.ts:145).
- Journal and History : une « icône History dans le panneau de chat »
fabriquée — AssistantChat.tsx n'a aucune référence à l'historique ;
le vrai composant de navigation (ChatHistoryView.tsx) ne vit que dans
le panneau Journal. Reformulé pour dire que c'est la même donnée,
pas une fonctionnalité séparée.
- Technical Architecture : la section Primary Sources (Tropy) décrivait
encore un vector store autonome (sources.db/sources.hnsw) alors que
PrimarySourcesVectorStore utilise le brain.db partagé depuis la
fusion — contradiction interne avec la section Key Architecture Files
déjà corrigée sur cette même page. L'étape « Dense Search » appelait
encore ollamaClient.generateEmbedding(), contredisant l'étape
Embedding Generation juste au-dessus, déjà corrigée elle aussi.
- Obsidian Vault Guide : « alongside the other workspace databases
(vectors.db, primary-sources.db) » — ces deux noms sont pré-fusion,
le vrai voisin est brain.db.
docs(wiki): documenter les trois chemins réels de l'export Word
La page ne décrivait que la fusion docxtemplater par {placeholder} —
or, vérifié dans word-export.ts, cette voie n'est empruntée que quand
aucune bibliographie n'est attachée au projet. Dès qu'une bibliographie
existe (le cas le plus fréquent chez des historiens) et que pandoc est
disponible, l'export passe par pandoc avec le .dotx en --reference-doc :
les styles Word nommés (Heading 1, Title...) s'appliquent, pas les
accolades. La page ne mentionnait aucune de ces deux autres voies.
Autres corrections :
- Type de projet « notes » et notes_template.dotx : n'existent pas
(types réels : article, book, presentation).
- {content} pour un livre : les chapitres assemblés dans l'ordre, pas
un document.md qui n'existe pas pour ce type de projet.
- Pied de page « Version 1.0.0, janvier 2026 » (antérieur à la
fonctionnalité livre) → 1.0.0-rc.3, sans date qui se périme.
first commit after move from inactinique