Export

L'export télécharge un espace entier, ou un dossier précis, sous la forme d'une seule archive ZIP de fichiers Markdown. Comme vos fichiers sont la source de vérité (le principe file-first), l'export les lit directement sur le disque au lieu de les reconstruire depuis un index : l'archive emporte les fichiers réels, avec le notarium-id dans le frontmatter de chacun.

C'est précisément pour cela que l'export est réversible — vous pouvez le réintégrer par un import, ou le déplacer vers une autre instance sans rien perdre de la structure, de l'identité ni des dates. L'export ne consiste pas vraiment à « faire sortir des données » ; c'est une façon commode d'empaqueter ce qui vit déjà sur le disque sous la forme de vos fichiers.

Comment exporter

L'export se trouve dans l'onglet Export des paramètres d'un espace :

Le bouton met une tâche en file d'attente ; s'affichent ensuite une barre de progression en pourcentage (dès que le nombre de notes est connu) et un bouton Cancel.
Une fois prête, l'archive se télécharge automatiquement ; les boutons Download .zip (télécharger à nouveau) et Export again (relancer l'export) restent à côté.
Quitter l'onglet puis y revenir est sans risque : à votre retour, vous retrouverez la tâche en cours, ou un fichier prêt à télécharger.

Vous pouvez exporter un dossier précis depuis le menu contextuel de l'arborescence — l'entrée Export folder. C'est la même tâche, restreinte à un sous-arbre ; la progression apparaît dans un toast persistant doté d'un bouton d'annulation.

Options

Les deux voies d'export acceptent le même jeu de paramètres :

Paramètre	Valeurs	Ce qu'il fait
`scope`	`user` (par défaut) · `all`	`user` — vos notes uniquement ; `all` — tout ce que contient l'espace, y compris le point de montage de la mémoire de l'agent (`.notarium/memory`).
`frontmatter`	`keep` (par défaut) · `strip`	`keep` écrit le fichier tel quel ; `strip` retranche le bloc YAML — une copie propre, faite pour la lecture.
`folder`	chemin	Restreindre l'export à un sous-arbre (ce que fait Export folder).

frontmatter=strip casse la réimportation

Retrancher le frontmatter produit une copie avec pertes : avec le bloc YAML disparaissent aussi le notarium-id et les tags. Une telle archive est commode pour transmettre des notes à lire, mais vous ne pourrez plus la réimporter sans perte. Pour déplacer des données, restez sur keep (la valeur par défaut).

L'export n'est pas une sauvegarde de l'instance

Même avec scope=all, une archive d'export ne contient rien d'autre que les fichiers Markdown de l'espace. Aucune base de métadonnées : ni comptes, ni droits d'accès, ni historique des versions, ni état des tâches. Impossible de restaurer une instance à partir d'une telle archive. La sauvegarde est une opération distincte, lancée par une commande intégrée à l'image — voir Sauvegarde et restauration.

Sous le capot

L'export est conçu pour fonctionner en flux, afin qu'une base de connaissances de taille arbitraire ne reste jamais en mémoire :

Tâche asynchrone par défaut. Quand l'hôte dispose d'une base de métadonnées (la norme en auto-hébergement), l'export est une tâche durable : un worker en arrière-plan assemble le ZIP dans le stockage d'artefacts et sert le fichier fini avec prise en charge de la reprise du téléchargement. Un onglet fermé, une connexion coupée ou un redémarrage du serveur ne font pas dérailler l'export.
Le téléchargement n'est pas mis en mémoire tampon. Le navigateur écrit l'archive finie en flux, directement sur le disque, en tirant son nom de l'en-tête de réponse — une grande base de connaissances ne reste pas en mémoire dans l'onglet.
L'annulation arrête le travail. Un téléchargement annulé cesse d'extraire des notes — le serveur ne continue pas à lire toute la base de connaissances pour rien.

flowchart LR
  notes[(Notes Markdown)] -->|lecture disque| worker[Worker en arrière-plan]
  worker -->|ZIP| artifact[Artefact de tâche]
  artifact -->|téléchargement| user([Navigateur])

Export sans base de métadonnées

Sur un hôte sans base de métadonnées (elle n'est absente qu'en mode AUTH_MODE=none), il n'y a pas de couche de tâches : l'export emprunte la voie synchrone en flux — le même ZIP est servi en téléchargement direct dans une seule requête, sans progression ni reprise du téléchargement. Seul le mode de livraison change ; le résultat est le même.

Limites

Un espace à la fois. Les espaces sont des dépôts isolés, dotés de leur propre contrôle d'accès ; pour en exporter plusieurs, exportez chacun séparément.
L'artefact a un TTL. Le ZIP fini est conservé pendant une durée limitée (7 jours par défaut) puis supprimé par le nettoyage automatique (garbage collector) ; vous pouvez le retélécharger tant qu'il n'a pas expiré.
Les pièces jointes binaires ne sont pas exportées. L'archive emporte le texte des notes — des fichiers Markdown.
Annuler, mais pas suspendre. Une tâche peut être annulée ; il n'y a ni pause ni reprise.

Et ensuite

Import — réintégrer une archive, ou déplacer une base de connaissances vers une autre instance.
Vue d'ensemble de la section — pourquoi le file-first rend l'import et l'export peu coûteux.