Base e strumenti

KatanA Chat UI

Base Rust per un pannello chat indipendente dall'applicazione host. La versione pubblica conserva la cronologia delle conversazioni e le bozze di input, quindi produce un modello di visualizzazione.

Responsabili dell'integrazione di una UI chat nelle app della serie KatanA

01

Funzioni implementate

ChatPanelState conserva cronologia e bozza di input

Fonti

ChatPanel aggiorna la bozza e genera un modello di visualizzazione

Fonti

Contratto di visualizzazione indipendente dal framework con conteggio dei messaggi e bozza

Fonti

02

Per iniziare

  1. Ottieni il repository e verifica nel README che l'ambito pubblico sia ancora una fondazione e che UI e integrazione restino responsabilità dell'host.
  2. Esegui cargo test -p katana-chat-ui per verificare i test della bozza e del modello di visualizzazione, poi collega ChatPanel alla tua UI.

Prepara Rust e gli strumenti di sviluppo necessari e consulta il README collegato per i requisiti prima dell'integrazione. Gli esempi sono punti di partenza e non garantiscono il funzionamento in ogni ambiente.

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

01 / KCU

Casi d'uso

Separare il chat state minimo dal framework

L’ultimo KCU conserva in ChatPanelState la cronologia di ChatTurn e la stringa draft e porta a ChatPanelRenderModel il numero di elementi della cronologia e draft. L’host può disegnare questo model con il proprio framework UI; KCU non incorpora widget.

Preparare il contratto precedente alla connessione ACP

Nel medesimo HEAD pubblico katana-acp-client espone AiRequest, AiResponse e AiProvider, con intent, document context, prompt e history passabili al confine provider. KCU non completa la connessione provider: il contratto viene implementato da host o connector.

02 / KCU

Flusso da input a output

  1. L’host possiede lo state

    L’host crea ChatPanelState e conserva il ciclo di vita di history e draft. ChatPanel::new prende in prestito lo state mutably e non possiede workspace o document state dell’intera app.

  2. Convertire input in render model

    L’input UI viene scritto in draft tramite ChatPanel::draft_mut(); render_model() crea ChatPanelRenderModel con history_len e draft. L’implementazione corrente non contiene le vecchie procedure UI per attachment, message output o streaming.

  3. Collegare il confine provider nell’host

    Un host ACP inserisce AiIntent, DocumentContext, prompt e ChatTurn history in AiRequest e chiama AiProvider::execute(). L’host o connector deve riflettere AiResponse in history o nella vista; non è una procedura implementata nel core KCU.

03 / KCU

API e CLI principali

ChatPanelState — Stato della chat
Lo stato chat corrente contiene solo history: Vec<ChatTurn> e draft: String. Non include persistenza di input o history né gestione dell’esecuzione provider.
ChatPanel — Facade dello stato
new prende in prestito state, draft_mut aggiorna input e render_model crea lo snapshot per la vista. È una facade sottile senza tipi di framework UI.
ChatPanelRenderModel — Modello di visualizzazione
È un model immutabile con history_len e draft. L’host può disegnarlo in qualsiasi UI, ma dettagli dei message e output action non sono esposti dai tipi KCU correnti.
AiRequest e AiProvider
AiRequest rappresenta intent, DocumentContext, prompt e history; AiProvider definisce available, capabilities, models ed execute. Il transport ACP è scaffolding e non implica una connessione provider completa.

04 / KCU

Capire con un esempio

Creare un render model da una draft

Crea ChatPanelState con default e passalo a ChatPanel::new. Aggiungi testo tramite draft_mut(), chiama render_model() e passa history_len e draft alla vista dell’host.

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

Integrazione e limiti

Implementare separatamente UI host e provider

Il README descrive katana-chat-ui come state/render model framework-neutral, Floem come planned reference UI e connector come planned boundary. L’integrazione disegna ChatPanelRenderModel nella UI propria e collega separatamente ACP o un provider diretto.

Fissare l’ambito come scaffolding

Lo Status del README corrente è Scaffolding. Workspace shell, document state, UI adapter, diagram rendering e document export sono fuori ambito: oggi è una libreria per draft minimo e valutazione del contratto ACP.

Fonti

Presentazione basata sui repository pubblici disponibili al momento della ricerca. Implementazione e procedure sono verificabili nel commit fissato del link.

Archivio del codiceLeggimi420c1052699e
Fonti · KCU
Tutti i prodotti