01
구현된 기능
02
시작하기
- 저장소를 가져와 README에서 기반 구축 단계의 범위와 host 책임을 확인합니다.
- cargo test -p katana-chat-ui로 초안과 표시 모델 테스트를 확인하고 자신의 UI에 ChatPanel을 연결합니다.
Rust와 필요한 개발 도구를 준비하고, 도입 전에 링크된 README에서 환경 요구 사항을 확인하세요. 실행 예시는 기능의 시작점이며 모든 환경에서의 동작을 보장하지 않습니다.
근거git clone https://github.com/HiroyukiFuruno/katana-chat-ui.git
cd katana-chat-ui
cargo test -p katana-chat-ui01 / 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
입력부터 출력까지
host가 state 소유하기
호스트는 ChatPanelState를 만들고 history와 draft의 수명 주기를 보유합니다. ChatPanel::new는 그 state를 mutable하게 빌릴 뿐 앱 전체의 workspace나 document state를 소유하지 않습니다.
입력을 render model로 변환하기
UI 입력은 ChatPanel::draft_mut()으로 draft에 기록되고 render_model()이 history_len과 draft를 포함한 ChatPanelRenderModel을 생성합니다. 최신 구현에는 이전 버전의 첨부·message output·streaming UI 처리가 없습니다.
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 표시로 넘깁니다.
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 계약 검토용 라이브러리로 취급합니다.
근거
조사 시점의 공개 저장소를 바탕으로 소개합니다. 링크된 고정 커밋에서 구현과 사용 방법을 확인할 수 있습니다.