Base / outil

KatanA Chat UI

Une base Rust de panneau de chat indépendante de l'application hôte. La version publique conserve l'historique des conversations et les brouillons de saisie, puis produit un modèle d'affichage.

Développeurs qui intègrent une UI de chat dans les applications de la famille KatanA

01

Capacités implémentées

ChatPanelState conserve l'historique et le brouillon de saisie

Références

ChatPanel met à jour le brouillon et produit un modèle d'affichage

Références

Contrat d'affichage indépendant du framework avec nombre de messages et brouillon

Références

02

Premiers pas

  1. Récupérez le dépôt et vérifiez dans le README que le périmètre public est encore une fondation et que l'hôte garde la responsabilité de l'UI et de l'intégration.
  2. Lancez cargo test -p katana-chat-ui pour vérifier les tests du brouillon et du modèle d'affichage, puis connectez ChatPanel à votre propre UI.

Préparez Rust et les outils de développement nécessaires, puis consultez le README lié pour les prérequis avant l'installation. Les exemples indiquent un point de départ et ne garantissent pas le fonctionnement dans tous les environnements.

Références
sh
git clone https://github.com/HiroyukiFuruno/katana-chat-ui.git
cd katana-chat-ui
cargo test -p katana-chat-ui

01 / KCU

Cas d'utilisation

Garder un état chat minimal hors du framework UI

ChatPanelState stocke l'historique ChatTurn et la chaîne draft, puis ChatPanelRenderModel expose le nombre d'éléments et le draft. Le host rend ce modèle avec son propre framework, sans widget dans KCU.

Préparer le contrat avant ACP

Le katana-acp-client public expose AiRequest, AiResponse et AiProvider pour transmettre intent, document context, prompt et historique ChatTurn à la frontière provider. KCU ne réalise pas cette connexion : le host ou connector implémente le contrat.

02 / KCU

Flux entrée-sortie

  1. Laisser le host posséder l'état

    Le host crée ChatPanelState et possède le cycle de vie de history et draft. ChatPanel::new ne fait qu'emprunter cet état mutable ; il ne possède ni workspace ni document state.

  2. Transformer l'entrée en modèle d'affichage

    L'UI écrit via ChatPanel::draft_mut(), puis render_model() produit ChatPanelRenderModel avec history_len et draft. L'implémentation actuelle ne contient aucun traitement UI d'attachments, message output ou streaming de l'ancienne version.

  3. Connecter provider à la frontière host

    Un host ACP remplit AiRequest avec AiIntent, DocumentContext, prompt et historique ChatTurn, puis appelle AiProvider::execute(). Le host ou connector applique AiResponse à history ou à l'affichage ; KCU ne réalise pas ce traitement.

03 / KCU

API et CLI principales

ChatPanelState — État du chat
Stocke history en Vec<ChatTurn> et draft en String : c'est tout l'état chat actuel. Il ne persiste pas l'entrée ou l'historique et ne gère pas l'exécution provider.
ChatPanel — Façade de l’état
Emprunte l'état avec new(), met à jour l'entrée par draft_mut() et crée un snapshot avec render_model(). C'est une facade fine, sans type de framework UI ni ownership du workspace.
ChatPanelRenderModel — Modèle d’affichage
Contient history_len et draft comme modèle immutable pour le host. Les détails de message et output actions ne font pas partie des types publics KCU actuels.
AiRequest et AiProvider
AiRequest porte intent, DocumentContext, prompt et history ; AiProvider définit available, capabilities, models et execute. Le transport ACP reste un scaffolding, pas une intégration provider terminée.

04 / KCU

Comprendre par un exemple

Construire un render model depuis un brouillon

Le code crée ChatPanelState, construit ChatPanel, ajoute du texte avec draft_mut(), puis appelle render_model() et transmet history_len et draft à l'affichage du host. Il ne simule ni l'envoi à une IA ni l'ajout d'une réponse à l'historique.

rust
use katana_chat_ui::{ChatPanel, ChatPanelState};

fn main() {
    let mut state = ChatPanelState::default();
    let mut panel = ChatPanel::new(&mut state);
    panel.draft_mut().push_str("Explain this document");
    let model = panel.render_model();
    println!("history={} draft={}", model.history_len, model.draft);
}

05 / KCU

Intégration et limites

Implémenter UI host et provider séparément

Le README décrit katana-chat-ui comme state/render model framework-neutral, Floem comme UI de référence planned et connector comme frontière planned. Le host rend ChatPanelRenderModel dans sa propre UI et connecte séparément ACP ou un provider direct.

Fixer explicitement la frontière scaffolding

Le status public est Scaffolding. Workspace shell, document state, UI adapter, diagram rendering et document export sont hors périmètre ; adoptez KCU seulement comme fondation de draft/display minimale et de contrat ACP, ces responsabilités restant au host.

Références

Cette présentation repose sur les dépôts publics au moment de l'examen. Vérifiez l'implémentation et l'utilisation dans les commits figés liés.

DépôtFichier README420c1052699e
Références · KCU
Tous les produits