Knowledge base ZedWrite

L'assistant regarde la scène active, la direction de scène, la mémoire et le texte déjà écrit.

Il signale les objectifs génériques, les points de vue inconnus, les tensions sans révélation ou les continuités faibles.

Les suggestions restent limitées pour rester actionnables et éviter de noyer l'auteur.

Les alertes techniques de troncature sont filtrées quand elles ne doivent pas polluer l'analyse littéraire.

La passe 1 crée un contrat de chapitre et un plan de scènes avec les champs de Direction de scène.

La passe 2 écrit le chapitre en texte simple pour éviter les gros JSON fragiles et les imports bloqués.

Le serveur découpe le texte en scènes, réinjecte les métadonnées du plan et construit un fullChapter importable.

La passe 3 produit un audit léger de cohérence sans renvoyer tout le manuscrit, ce qui limite les risques de troncature.

Si OpenAI répond partiellement, ZedWrite tente d'importer le texte disponible au lieu de perdre toute la génération.

Les secrets doivent rester dans les variables d'environnement comme .env.local, jamais dans un fichier commit.

Une clé collée dans un chat ou un ticket doit être révoquée et recréée.

Un token GitHub pour pousser le repo doit avoir Contents: Read and write sur le dépôt choisi.

Une clé OpenAI invalide, sans quota ou sans accès au modèle produit une erreur claire côté génération.

La scène active est envoyée avec son texte, sa direction de scène, son résumé et ses champs de cohérence.

Le moteur de contexte ajoute les éléments utiles de la mémoire structurée et évite d'envoyer tout le projet inutilement.

Pour un roman long, les chapitres précédents, le chapitre actif et les chapitres suivants déjà présents peuvent être utilisés pour préparer la suite.

Les longs extraits peuvent être condensés pour rester dans une fenêtre de contexte stable.

Les risques peuvent venir d'un conflit avec la mémoire, d'un fil narratif résolu trop tôt ou d'une transition faible.

La correction doit rester locale: elle répare le passage ou la scène sans réinventer le projet entier.

Les faits canoniques et la Story Bible restent prioritaires sur une nouvelle invention IA.

Après correction, le projet conserve les résumés et faits utiles pour les futures générations.

La couverture utilise un modèle image séparé et consomme des crédits image.

Le prompt s'appuie sur le titre, le genre, l'ambiance et les éléments visuels utiles.

Les images sont indépendantes des crédits texte pour mieux suivre la consommation.

Une couverture peut être remplacée si une nouvelle direction visuelle est choisie.

Le menu gauche affiche les crédits texte restants et les crédits image restants.

Les actions longues comme Chapitre complet IA coûtent plus qu'une correction courte.

Les réglages admin permettent d'ajuster les plans, les crédits mensuels et les tarifs par type de génération.

Si OpenAI échoue après avoir généré une réponse côté fournisseur, les crédits OpenAI peuvent être consommés même si l'import échoue; ZedWrite cherche donc à récupérer les sorties partielles.

La création définit le titre, le type de contenu, l'objectif, la langue et le ton.

Le type de contenu adapte la structure attendue: roman, non-fiction, screenplay, YouTube, TikTok, storytelling court ou autre.

Les templates préremplissent une base de structure pour démarrer plus vite sans imposer une méthode unique.

Après création, le projet s'ouvre dans l'éditeur avec les chapitres, les scènes et la mémoire disponibles.

L'objectif narratif dit ce que la scène doit accomplir, au-delà du simple événement visible.

L'émotion, la tension, le rythme, le point de vue, le niveau de détail et la mise en scène orientent le style de génération.

Le champ Révélation éventuelle sert à noter une information nouvelle, un micro-renversement, une confirmation importante ou une promesse narrative.

Ce champ est repris dans le contexte IA et dans les alertes: une scène très tendue sans révélation peut être signalée.

Le texte affiché correspond à la scène active; les modifications sont sauvegardées dans le projet local.

Les actions IA peuvent ajouter du texte, remplacer un brouillon, corriger une sélection ou générer un chapitre complet.

Quand un texte est généré, l'historique conserve un résumé de l'action pour comprendre ce qui vient d'être appliqué.

La sélection de texte permet d'appliquer des actions ciblées sans modifier tout le chapitre.

Vue d'ensemble affiche les indicateurs globaux: utilisateurs, revenus, générations IA et conversion.

Analytics détaille les métriques de croissance, activité et usage.

Paiements et plans pilotent la logique commerciale et les crédits disponibles.

Paramètres contient les réglages de plans et les consignes système utilisées par l'assistant IA.

Le tableau de bord liste les projets et donne accès à la création, aux templates et à l'éditeur.

Un projet contient une intention, une langue, un ton, un type de contenu et une mémoire structurée.

L'éditeur travaille au niveau de la scène active: texte, direction de scène, mémoire, assistant et historique IA.

La cohérence repose sur les résumés, les personnages, les lieux, les intrigues ouvertes, les faits de continuité et la direction de scène.

Écrire IA continue la scène active en respectant l'objectif et la mémoire.

Conclure IA aide à fermer un chapitre ou une scène sans casser les fils ouverts.

Réécrire, Améliorer, Développer et Raccourcir modifient le texte selon l'intention choisie.

Les actions contextuelles sur sélection permettent d'ajouter tension, émotion, rythme, dialogue, description ou clarification.

Plus le nombre de mots et de scènes est élevé, plus le temps OpenAI peut augmenter.

La progression affichée pendant Chapitre complet IA est estimée tant que l'API ne stream pas ses événements serveur.

Pour des tests rapides, réduis temporairement le nombre de scènes ou la cible de mots.

Pour un suivi réel étape par étape, la prochaine évolution technique serait un flux SSE ou streaming serveur.

Si Chapitre complet IA reste longtemps en attente, le loader affiche une progression estimée et signale une étape anormalement longue.

Si une réponse OpenAI est tronquée, ZedWrite évite désormais de dépendre d'un manuscrit encodé dans un gros JSON.

Si les champs Direction de scène sont vides après génération, il faut relancer avec la version corrigée du plan de scènes.

Si le serveur local ne reflète pas les changements, redémarre le dev server puis recharge la page.

Si git push échoue, vérifie les droits du token GitHub ou la clé SSH configurée.

Un résumé de scène capture ce qui change concrètement dans le récit.

Un résumé de chapitre donne une vue canonique de ce qui vient d'être établi.

Le résumé global du projet peut être mis à jour quand un chapitre change fortement l'histoire.

Ces résumés permettent de garder une cohérence globale sans envoyer tout le manuscrit à chaque requête.

Les personnages servent à maintenir les motivations, relations, états émotionnels et rôles.

Les lieux évitent les contradictions spatiales et renforcent la continuité du monde.

Les intrigues ouvertes signalent ce qui ne doit pas être résolu trop tôt.

Les faits de continuité enregistrent les révélations, promesses, règles de monde, états de personnage et événements de timeline.