基础设施与工具

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
全部产品