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

ChatPanelState hält Gesprächsverlauf und Eingabeentwurf

Belege

ChatPanel aktualisiert den Entwurf und erzeugt ein Darstellungsmodell

Belege

Framework-neutraler Darstellungsvertrag mit Nachrichtenanzahl und Entwurf

Belege

02

Erste Schritte

  1. 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.
  2. 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.

Belege
sh
git clone https://github.com/HiroyukiFuruno/katana-chat-ui.git
cd katana-chat-ui
cargo test -p katana-chat-ui

01 / 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

  1. 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.

  2. 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.

  3. 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.

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

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.

Code-RepositoryREADME-Dokument420c1052699e
Belege · KCU
Alle Produkte