基礎與工具

KatanA Chat UI

獨立於宿主應用程式的 Rust 聊天面板基礎。公開版本保存對話歷史與輸入草稿,並產生顯示模型。

將聊天 UI 整合到 KatanA 系列應用程式的開發負責人

01

已實作功能

ChatPanelState 保存對話歷史與輸入草稿

依據

ChatPanel 更新草稿並產生顯示模型

依據

與框架無關的顯示契約,包含訊息數量與草稿

依據

02

開始使用

  1. 取得儲存庫,並在 README 中確認公開範圍仍處於基礎建設階段,UI 與整合由宿主負責。
  2. 執行 cargo test -p katana-chat-ui 檢查草稿與顯示模型測試,再將 ChatPanel 接入自己的 UI。

請準備 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

使用情境

將最小聊天狀態與框架分離

最新的 KCU 在 ChatPanelState 中保留 ChatTurn history 和 draft 字串,並將 history_len 和 draft 輸出到 ChatPanelRenderModel。宿主可以使用自己的 UI 框架繪製此模型,而不會把 widget 實現帶入 KCU。

準備 ACP 連線的預契約

同一公開 HEAD 中的 katana-acp-client 具有 AiRequest、AiResponse 和 AiProvider,並且可以將意圖、文件上下文、提示和歷史記錄傳遞到提供者邊界。在此配置中,宿主和聯結器實現此契約,而不是 KCU 完成提供者連線。

02 / KCU

從輸入到輸出的流程

  1. 宿主擁有狀態

    宿主生成 ChatPanelState 並維護 history 和 draft 的生命週期。ChatPanel::new 只 mutable borrow 該 state,並不擁有整個應用的 workspace 或 document state。

  2. 將輸入轉換為渲染模型

    UI 輸入通過 ChatPanel::draft_mut() 寫入 draft,render_model() 生成包含 history_len 和 draft 的 ChatPanelRenderModel。最新實現沒有舊版的附件、message output 或 streaming UI 處理。

  3. 宿主連線提供者邊界

    使用 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 的顯示層。

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

整合條件與責任邊界

分別實現宿主 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 契約的庫。

依據

內容根據調查時點的公開儲存庫。可透過連結中的固定提交確認實作與使用方式。

儲存庫閱讀指南420c1052699e
依據 · KCU
所有產品