01
已實作功能
02
開始使用
- 取得儲存庫,並在 README 中確認公開範圍仍處於基礎建設階段,UI 與整合由宿主負責。
- 執行 cargo test -p katana-chat-ui 檢查草稿與顯示模型測試,再將 ChatPanel 接入自己的 UI。
請準備 Rust 與必要的開發工具,並在導入前透過連結的 README 確認環境需求。執行範例是功能入口,不保證在所有環境中運作。
依據git clone https://github.com/HiroyukiFuruno/katana-chat-ui.git
cd katana-chat-ui
cargo test -p katana-chat-ui01 / KCU
使用情境
將最小聊天狀態與框架分離
最新的 KCU 在 ChatPanelState 中保留 ChatTurn history 和 draft 字串,並將 history_len 和 draft 輸出到 ChatPanelRenderModel。宿主可以使用自己的 UI 框架繪製此模型,而不會把 widget 實現帶入 KCU。
準備 ACP 連線的預契約
同一公開 HEAD 中的 katana-acp-client 具有 AiRequest、AiResponse 和 AiProvider,並且可以將意圖、文件上下文、提示和歷史記錄傳遞到提供者邊界。在此配置中,宿主和聯結器實現此契約,而不是 KCU 完成提供者連線。
02 / KCU
從輸入到輸出的流程
宿主擁有狀態
宿主生成 ChatPanelState 並維護 history 和 draft 的生命週期。ChatPanel::new 只 mutable borrow 該 state,並不擁有整個應用的 workspace 或 document state。
將輸入轉換為渲染模型
UI 輸入通過 ChatPanel::draft_mut() 寫入 draft,render_model() 生成包含 history_len 和 draft 的 ChatPanelRenderModel。最新實現沒有舊版的附件、message output 或 streaming UI 處理。
宿主連線提供者邊界
使用 ACP 的宿主旨在用 AiIntent、DocumentContext、提示和 ChatTurn 歷史記錄填充 AiRequest,並呼叫 AiProvider::execute()。 Host/Connector端負責將返回的AiResponse反映到歷史記錄中並顯示,並不是KCU本身的實現過程。
03 / KCU
主要 API 與 CLI
ChatPanelState — 聊天狀態- ChatPanelState 只包含 history: Vec<ChatTurn> 和 draft: String,是最新的 chat state。它不包括輸入或 history 持久化,也不包括 provider 執行管理。
ChatPanel — 狀態門面- 使用 new 借用 state,使用 draft_mut 更新輸入,並使用 render_model 建立顯示 snapshot。它是一個不包含 UI framework 型別的薄 facade。
ChatPanelRenderModel — 顯示模型- 它是一個具有history_len和draft的不可變顯示模型。宿主可以將其繪製到任何 UI,但訊息詳細資訊和輸出操作不會作為最新的 KCU 型別公開。
AiRequest 和 AiProvider- AiRequest 表示 intent、DocumentContext、prompt 和 history;AiProvider 定義 available、capabilities、models 和 execute。ACP transport 本身是 Scaffolding,並不意味著完成了實際 provider 連線。
04 / KCU
透過範例理解
從草稿建立渲染模型
建立預設的 ChatPanelState 並將其傳遞給 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
整合條件與責任邊界
分別實現宿主 UI 和提供者
README 使用 katana-chat-ui 作為框架中立的狀態/渲染模型,使用 Floem 作為計劃的參考 UI,使用聯結器作為計劃的邊界。實施者在他/她的UI中繪製ChatPanelRenderModel並單獨連線ACP或直接提供者。
根據腳手架固定範圍
最新 README 的 Status 是 Scaffolding。workspace shell、document state、UI adapter、diagram rendering 和 document export 不在範圍內,因此當前應將其作為研究最小 draft 顯示和 ACP 契約的庫。
依據
內容根據調查時點的公開儲存庫。可透過連結中的固定提交確認實作與使用方式。