Base e ferramentas

KatanA Chat UI

Base Rust para um painel de chat independente do aplicativo host. A versão pública mantém o histórico de conversas e os rascunhos de entrada e produz um modelo de exibição.

Responsáveis por integrar uma UI de chat em aplicativos da série KatanA

01

Funções implementadas

ChatPanelState mantém o histórico e o rascunho de entrada

Fontes

ChatPanel atualiza o rascunho e produz um modelo de exibição

Fontes

Contrato de exibição independente de framework com contagem de mensagens e rascunho

Fontes

02

Primeiros passos

  1. Obtenha o repositório e confirme no README que o escopo público ainda é uma fundação e que a UI e a integração continuam sob responsabilidade do host.
  2. Execute cargo test -p katana-chat-ui para verificar os testes do rascunho e do modelo de exibição e depois conecte ChatPanel à sua própria UI.

Prepare Rust e as ferramentas de desenvolvimento necessárias e consulte o README indicado para os requisitos antes da integração. Os exemplos são pontos de entrada e não garantem funcionamento em todos os ambientes.

Fontes
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 o chat state mínimo do framework

A implementação atual de KCU mantém em ChatPanelState o histórico de ChatTurn e a string draft, e expõe quantidade do histórico e draft em ChatPanelRenderModel. O host desenha esse modelo no próprio framework; KCU não traz widget.

Preparar o contrato anterior à conexão ACP

katana-acp-client expõe AiRequest, AiResponse e AiProvider; intent, document context, prompt e history podem ser entregues à fronteira do provider. KCU não conclui a conexão: host ou connector implementa esse contrato.

02 / KCU

Fluxo da entrada à saída

  1. Deixar o host dono do state

    O host cria ChatPanelState e mantém o ciclo de vida de history e draft. ChatPanel::new apenas toma esse state emprestado de forma mutável; não possui workspace ou document state da aplicação.

  2. Converter a entrada em render model

    A UI escreve a entrada em draft com ChatPanel::draft_mut(); render_model() cria ChatPanelRenderModel com history_len e draft. A implementação atual não inclui o antigo processamento de anexos, message output ou streaming UI.

  3. Conectar a fronteira do provider no host

    O host que usa ACP preenche AiRequest com AiIntent, DocumentContext, prompt e history de ChatTurn e chama AiProvider::execute(). Host ou connector decide como refletir AiResponse em history e na UI; isso não é processamento implementado no KCU.

03 / KCU

APIs e CLI principais

ChatPanelState — Estado do chat
É o chat state atual com apenas history: Vec<ChatTurn> e draft: String. Não inclui persistência de input/histórico nem gerenciamento de execução do provider.
ChatPanel — Facade do estado
new toma o state emprestado, draft_mut atualiza a entrada e render_model cria um snapshot de exibição. É uma facade fina sem tipos de UI framework.
ChatPanelRenderModel — Modelo de exibição
É um modelo imutável com history_len e draft. O host pode desenhá-lo em qualquer UI, mas detalhes de message e output action não fazem parte dos tipos KCU atuais.
AiRequest e AiProvider
AiRequest representa intent, DocumentContext, prompt e history; AiProvider define available, capabilities, models e execute. O ACP transport é scaffolding e não significa conexão provider concluída.

04 / KCU

Entenda com um exemplo

Criar render model a partir de draft

Crie ChatPanelState com default, passe-o a ChatPanel::new, acrescente texto com draft_mut() e chame render_model(). Entregue history_len e draft à UI do 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

Integração e limites

Implementar UI e provider separadamente

O README descreve katana-chat-ui como state/render model framework-neutral, Floem como planned reference UI e connector como planned boundary. O consumidor desenha ChatPanelRenderModel e conecta ACP ou um provider direto separadamente.

Fixar o escopo de scaffolding

O Status do README atual é Scaffolding. Workspace shell, document state, UI adapter, diagram rendering e document export estão fora do escopo; trate a biblioteca como base para draft mínimo e contrato ACP.

Fontes

Apresentação baseada nos repositórios públicos disponíveis no momento da pesquisa. A implementação e os passos podem ser conferidos no commit fixado do link.

RepositórioLeia-me420c1052699e
Fontes · KCU
Todos os produtos