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 契约的库。
依据
内容基于调查时点的公开代码仓库。可通过链接中的固定提交确认实现和使用方法。