Base y herramientas
KatanA Chat UI
Base Rust para un panel de chat independiente de la aplicación anfitriona. La versión pública conserva el historial de conversaciones y el borrador de entrada y genera un modelo de visualización.
Responsables de integrar una UI de chat en aplicaciones de la serie KatanA
01
Funciones implementadas
02
Primeros pasos
- Obtenga el repositorio y compruebe en el README que el alcance público sigue siendo una base y que la UI y la integración corresponden al host.
- Ejecute cargo test -p katana-chat-ui para comprobar las pruebas del borrador y del modelo de visualización y después conecte ChatPanel a su propia UI.
Prepare Rust y las herramientas de desarrollo necesarias y consulte el README enlazado para conocer los requisitos antes de integrar. Los ejemplos son puntos de entrada y no garantizan el funcionamiento en todos los entornos.
Fuentesgit clone https://github.com/HiroyukiFuruno/katana-chat-ui.git
cd katana-chat-ui
cargo test -p katana-chat-ui01 / KCU
Casos de uso
Separar el estado mínimo del chat del framework
El KCU actual mantiene en ChatPanelState un historial de ChatTurn y una cadena draft, y produce ChatPanelRenderModel con history_len y draft. El host puede dibujar ese modelo en su propio framework UI; KCU no incorpora widgets.
Preparar el contrato previo para ACP
El katana-acp-client público del mismo HEAD ofrece AiRequest, AiResponse y AiProvider, con intent, document context, prompt e history en el límite del provider. KCU no completa la conexión del provider; la implementan el host o el connector.
02 / KCU
Flujo de entrada a salida
El host posee el estado
El host crea ChatPanelState y conserva el ciclo de vida de history y draft. ChatPanel::new solo toma prestado ese state de forma mutable y no posee el workspace ni el document state de toda la aplicación.
Convertir la entrada en render model
La entrada UI se escribe en draft mediante ChatPanel::draft_mut(); render_model() genera ChatPanelRenderModel con history_len y draft. La implementación actual no contiene el procesamiento antiguo de attachments, message output ni streaming UI.
El host conecta el límite del provider
Un host ACP introduce en AiRequest AiIntent, DocumentContext, prompt y el historial ChatTurn, y llama a AiProvider::execute(). El host/connector debe reflejar AiResponse en history o en la pantalla; no es procesamiento implementado por KCU.
03 / KCU
APIs y CLI principales
ChatPanelState — Estado del chat- El estado actual contiene solo history: Vec<ChatTurn> y draft: String. No incluye persistencia de la entrada o historial ni gestión de ejecución del provider.
ChatPanel — Fachada del estado- new toma prestado el state, draft_mut actualiza la entrada y render_model crea un snapshot para mostrar. Es una fachada ligera sin tipos del framework UI.
ChatPanelRenderModel — Modelo de presentación- Es un modelo inmutable con history_len y draft. El host puede dibujarlo en cualquier UI; los detalles de message y output action no son tipos públicos del KCU actual.
AiRequest y AiProvider- AiRequest representa intent, DocumentContext, prompt e history; AiProvider define available, capabilities, models y execute. El transporte ACP es scaffolding y no significa que exista una conexión real de provider.
04 / KCU
Entender con un ejemplo
Crear un render model desde un borrador
Cree un ChatPanelState predeterminado, páselo a ChatPanel::new(), añada la entrada mediante draft_mut() y llame a render_model(). El host pasa history_len y draft a su propia UI; el ejemplo solo prueba el límite entre estado y presentación y no envía nada a una IA.
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
Integración y límites
Implementar UI del host y provider por separado
El README define katana-chat-ui como state/render model framework-neutral, Floem como UI de referencia planificada y connector como límite planificado. El host dibuja ChatPanelRenderModel y conecta ACP o un provider directo aparte.
Fijar el alcance de scaffolding
El estado actual del README es Scaffolding. Workspace shell, document state, UI adapter, diagram rendering y document export no están incluidos; por ahora sirve para probar la vista mínima de draft y el contrato ACP.
Fuentes
Presentación basada en los repositorios públicos disponibles en el momento de la investigación. La implementación y los pasos se pueden comprobar en el commit fijado del enlace.