Manual/GenUI 交互界面
CRUX 1.0.0 RC1

GenUI 交互界面

Agent 的回答,可以是一个界面。

GenUI 天气面板
GenUI 天气面板RC1 实机截图 · 查看原图 ↗

回答不必止于 Markdown

当答案需要你选择、填写或操作,Agent 可以直接构建一个终端原生界面:方案选择器、表单、表格或进度面板。你在回答里操作,结果回到对话,任务继续。

界面由 Crux 的组件目录渲染,支持数据绑定和实时更新,无需打开浏览器。

text
请用一个 GenUI 表单让我选择要检查的模块,
支持多选,并留一个输入框填写额外要求。
提交后再开始分析。

界面如何更新

Agent 创建 surface 后,可以通过 surface_update 更新数据与组件,例如报告分阶段进度或添加结果。输入框、复选框与选项把数据写回界面模型,按钮动作回到对话流程。

历史中的表单

已提交的聊天表单以只读状态保留在历史里。Home 和插件中的控制可以持续使用,它们与一次性提交的聊天表单有不同生命周期。

与插件如何搭配

GenUI 适合当前任务中的临时交互;插件适合长期留在 Home 或 Sidebar 的信息与操作。两者可以复用界面声明与组件能力。

图片示例

网站中的 GenUI 图片由 Crux 的 SurfaceHost 经 Nocterm 实际渲染生成,使用固定示例数据。它们是组件渲染快照,不是 Ghostty 实拍,也不是性能或真实账户用量记录。

适用于 1.0.0 RC1。示例数字为演示数据。反馈问题