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

ChatPanelState conserva el historial y el borrador de entrada

Fuentes

ChatPanel actualiza el borrador y genera un modelo de visualización

Fuentes

Contrato de visualización independiente del framework con cantidad de mensajes y borrador

Fuentes

02

Primeros pasos

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

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

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

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

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

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

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

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.

RepositorioLéame420c1052699e
Fuentes · KCU
Todos los productos