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
02
Per iniziare
- Ottieni il repository e verifica nel README che l'ambito pubblico sia ancora una fondazione e che UI e integrazione restino responsabilità dell'host.
- 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.
Fontigit clone https://github.com/HiroyukiFuruno/katana-chat-ui.git
cd katana-chat-ui
cargo test -p katana-chat-ui01 / 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
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.
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.
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.
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.