기반·도구

KatanA Chat UI

대화 기록과 입력 초안을 보존하고 표시 모델로 변환하는 작은 Rust 라이브러리입니다. 공개판은 기반 구축 단계이며 UI와 AI 연결은 host가 조합합니다.

KatanA 계열 앱에 채팅 UI를 통합하는 개발 담당자

01

구현된 기능

ChatPanelState로 대화 기록과 입력 초안 보존

근거

ChatPanel에서 초안을 갱신하고 표시 모델 생성

근거

기록 수와 초안을 담는 framework-neutral 표시 계약

근거

02

시작하기

  1. 저장소를 가져와 README에서 기반 구축 단계의 범위와 host 책임을 확인합니다.
  2. cargo test -p katana-chat-ui로 초안과 표시 모델 테스트를 확인하고 자신의 UI에 ChatPanel을 연결합니다.

Rust와 필요한 개발 도구를 준비하고, 도입 전에 링크된 README에서 환경 요구 사항을 확인하세요. 실행 예시는 기능의 시작점이며 모든 환경에서의 동작을 보장하지 않습니다.

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

01 / KCU

사용 장면

최소 chat state를 framework에서 분리하기

최신 KCU는 ChatPanelState에 ChatTurn 기록과 draft 문자열을 보관하고 ChatPanelRenderModel에 기록 수와 draft를 제공합니다. 호스트는 이 모델을 자신의 UI framework로 렌더링할 수 있으며 KCU 본체에는 widget 구현을 넣지 않습니다.

ACP 연결을 위한 전단 계약 준비하기

같은 공개 HEAD의 katana-acp-client에는 AiRequest, AiResponse, AiProvider가 있으며 intent, document context, prompt, history를 provider 경계로 전달할 수 있습니다. KCU가 provider 연결을 완결하는 것이 아니라 host나 connector가 이 계약을 구현하는 구성입니다.

02 / KCU

입력부터 출력까지

  1. host가 state 소유하기

    호스트는 ChatPanelState를 만들고 history와 draft의 수명 주기를 보유합니다. ChatPanel::new는 그 state를 mutable하게 빌릴 뿐 앱 전체의 workspace나 document state를 소유하지 않습니다.

  2. 입력을 render model로 변환하기

    UI 입력은 ChatPanel::draft_mut()으로 draft에 기록되고 render_model()이 history_len과 draft를 포함한 ChatPanelRenderModel을 생성합니다. 최신 구현에는 이전 버전의 첨부·message output·streaming UI 처리가 없습니다.

  3. provider 경계를 host가 연결하기

    ACP를 사용하는 host는 AiRequest에 AiIntent, DocumentContext, prompt, ChatTurn history를 넣고 AiProvider::execute()를 호출하는 설계입니다. 반환된 AiResponse를 history나 표시로 반영하는 책임은 host/connector 측에 있으며 KCU 본체에 구현된 처리가 아닙니다.

03 / KCU

주요 API·CLI

ChatPanelState — 채팅 상태
history: Vec<ChatTurn>과 draft: String만 보유하는 최신 chat state입니다. 입력이나 기록의 영속화, provider 실행 관리는 포함하지 않습니다.
ChatPanel — 상태 facade
new로 state를 빌리고 draft_mut으로 입력을 갱신하며 render_model로 표시용 snapshot을 만듭니다. UI framework 타입을 보유하지 않는 얇은 facade입니다.
ChatPanelRenderModel — 표시 모델
history_len과 draft를 가진 불변 표시 모델입니다. 호스트는 이를 임의의 UI로 렌더링할 수 있지만 message 상세나 output action은 최신 KCU 타입으로 공개되지 않습니다.
AiRequest와 AiProvider
AiRequest는 intent, DocumentContext, prompt, history를 나타내고 AiProvider는 available, capabilities, models, execute를 정의합니다. ACP transport 자체는 scaffolding이며 실제 provider 연결의 완성을 뜻하지 않습니다.

04 / KCU

구체적인 예

draft에서 render model 만들기

ChatPanelState를 default로 만들고 ChatPanel::new에 전달합니다. draft_mut()에 입력을 추가한 뒤 render_model()을 호출하고 history_len과 draft를 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

통합 조건과 책임 경계

host UI와 provider를 별도로 구현하기

README는 katana-chat-ui를 framework-neutral state/render model, Floem을 planned reference UI, connector를 planned boundary로 설명합니다. 도입 측은 자신의 UI로 ChatPanelRenderModel을 렌더링하고 별도로 ACP 또는 direct provider를 연결합니다.

scaffolding을 전제로 범위 고정하기

최신 README의 Status는 Scaffolding입니다. workspace shell, document state, UI adapter, diagram rendering, document export는 대상이 아니므로 현재는 최소 draft 표시와 ACP 계약 검토용 라이브러리로 취급합니다.

근거

조사 시점의 공개 저장소를 바탕으로 소개합니다. 링크된 고정 커밋에서 구현과 사용 방법을 확인할 수 있습니다.

저장소읽기 안내420c1052699e
근거 · KCU
모든 제품