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
ChatPanel met à jour le brouillon et produit un modèle d'affichage
RéférencesContrat d'affichage indépendant du framework avec nombre de messages et brouillon
Références02
Premiers pas
- 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.
- 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érencesgit clone https://github.com/HiroyukiFuruno/katana-chat-ui.git
cd katana-chat-ui
cargo test -p katana-chat-ui01 / 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
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.
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.
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.
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.