Basis / Tool
KatanA Chat UI
Eine vom Host unabhängige Rust-Grundlage für ein ChatPanel. Die öffentliche Version hält Gesprächsverlauf und Eingabeentwurf und erzeugt daraus ein Darstellungsmodell.
Entwickler, die Chat-UI in KatanA-Anwendungen integrieren
01
Implementierte Fähigkeiten
02
Erste Schritte
- Rufen Sie das Repository ab und prüfen Sie im README, dass der öffentliche Umfang noch eine Grundlage ist und UI sowie Integration beim Host liegen.
- Führen Sie cargo test -p katana-chat-ui aus, prüfen Sie die Tests für Entwurf und Darstellungsmodell und verbinden Sie ChatPanel anschließend mit Ihrer UI.
Bereiten Sie Rust und die erforderlichen Entwicklungstools vor und prüfen Sie vor der Installation die Umgebungsanforderungen im verknüpften README. Beispiele zeigen einen Einstieg und garantieren keinen Betrieb in jeder Umgebung.
Belegegit clone https://github.com/HiroyukiFuruno/katana-chat-ui.git
cd katana-chat-ui
cargo test -p katana-chat-ui01 / KCU
Anwendungsfälle
Minimalen Chat-State vom Framework trennen
KCU hält im aktuellen ChatPanelState eine ChatTurn-Historie und einen draft-String und erzeugt daraus ein ChatPanelRenderModel mit history_len und draft. Der Host zeichnet dieses Modell in seinem UI-Framework; KCU selbst enthält keine Widget-Implementierung.
Vorgelagerten Vertrag für ACP bereitstellen
Das öffentliche katana-acp-client desselben Heads stellt AiRequest, AiResponse und AiProvider bereit; intent, document context, prompt und history können an die Provider-Grenze übergeben werden. KCU führt die Provider-Verbindung nicht aus, sondern überlässt deren Implementierung Host oder Connector.
02 / KCU
Ablauf von Eingabe zu Ausgabe
Host besitzt den State
Der Host erstellt ChatPanelState und hält den Lebenszyklus von history und draft. ChatPanel::new leiht diesen State nur veränderbar aus und besitzt weder den Workspace noch den Dokumentzustand der gesamten Anwendung.
Eingabe in Render Model umwandeln
UI-Eingabe wird über ChatPanel::draft_mut() in draft geschrieben; render_model() erzeugt ChatPanelRenderModel mit history_len und draft. Die aktuelle Implementierung enthält keine alte Attachment-, Message-Output- oder Streaming-UI-Verarbeitung.
Provider-Grenze durch den Host verbinden
Ein ACP-Host füllt AiRequest mit AiIntent, DocumentContext, prompt und ChatTurn-History und ruft AiProvider::execute() auf. Das Übernehmen von AiResponse in history oder Anzeige liegt bei Host/Connector und ist keine implementierte KCU-Verarbeitung.
03 / KCU
Wichtige APIs und CLI
ChatPanelState — Chat-Zustand- Der aktuelle Chat-State enthält nur history: Vec<ChatTurn> und draft: String. Persistenz von Eingabe und Historie sowie Provider-Ausführung gehören nicht dazu.
ChatPanel — Zustandsfassade- new leiht State aus, draft_mut aktualisiert die Eingabe und render_model erstellt einen Anzeige-Snapshot. Die dünne Fassade enthält keine UI-Framework-Typen.
ChatPanelRenderModel — Anzeigemodell- Das unveränderliche Anzeigemodell enthält history_len und draft. Der Host kann es in beliebiger UI zeichnen; Detaildaten von Nachrichten und output action sind im aktuellen KCU-Vertrag nicht veröffentlicht.
AiRequest und AiProvider- AiRequest beschreibt intent, DocumentContext, prompt und history; AiProvider definiert available, capabilities, models und execute. Der ACP-Transport ist Scaffolding und bedeutet keine fertige Provider-Verbindung.
04 / KCU
An einem Beispiel verstehen
Aus einem Entwurf ein Render-Modell erzeugen
Erstellen Sie einen Default-ChatPanelState, übergeben Sie ihn an ChatPanel::new(), schreiben Sie Eingabe über draft_mut() und rufen Sie render_model() auf. Der Host gibt history_len und draft an seine eigene UI weiter; das Beispiel prüft nur diese State/Display-Grenze und sendet nichts an eine KI.
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
Integration und Grenzen
Host-UI und Provider getrennt implementieren
README beschreibt katana-chat-ui als framework-neutralen State/Render Model, Floem als geplante Referenz-UI und Connector als geplante Grenze. Der Host zeichnet ChatPanelRenderModel selbst und verbindet separat ACP oder einen direkten Provider.
Scaffolding als Umfangsgrenze festlegen
Der aktuelle README-Status ist Scaffolding. Workspace-Shell, Dokumentzustand, UI-Adapter, Diagramm-Rendering und Dokumentexport sind nicht enthalten; derzeit eignet sich das Crate zur Erprobung von Draft-Anzeige und ACP-Vertrag.
Belege
Diese Übersicht basiert auf den öffentlichen Repositories zum Zeitpunkt der Prüfung. Implementierung und Nutzung können in den verknüpften fixierten Commits geprüft werden.