对话输入面板
两行编辑器:上面有提示、下面有控件的 radius-24 卡、添加菜单、具有自动、手动、计划模式和绕过所有功能的权限选择器、具有可滚动提供者轨道的模型选择器和所选模型上的工作弹出窗口、麦克风和发送,以及挂在卡顶部边缘的状态选项卡,其中包含分支、项目文件夹和上下文仪表。单行 Composer 胶囊保持原样;这是智能体表面的较高布局。
安装
已支持深色模式,此 组件 会自动使用 BoardUI 的语义设计变量。 设置主题切换.
使用共享 UI 包或自定义导入别名? 配置您的安装路径 在运行 CLI 之前。复制粘贴示例使用默认导入。
权限
选择器仅在悬停、按下或菜单打开时绘制其表面,因此在休息时它会读取为加号按钮旁边的标签。该菜单列出了四种模式,每种模式都有一行描述和一个 了解更多 标题中的链接按钮(learnMoreHref 或 onLearnMore). 汽车 是默认值;设置 defaultPermission 从别处开始,或通过 permission 和 onPermissionChange 拥有它。触发器、菜单和选项列表也单独提供 PermissionMenu 和 COMPOSER_PERMISSIONS.
{/* Auto is the default; start on another mode */}<ComposerPanel defaultPermission="plan" />
{/* Or own the mode yourself */}const [permission, setPermission] = useState<ComposerPermission>("auto");<ComposerPanel permission={permission} onPermissionChange={setPermission} />
{/* The picker on its own; "Learn more" is a Link Button, a link with href or a button with onLearnMore */}<PermissionMenu value={permission} onChange={setPermission} learnMoreHref="/docs/permissions" />模型选择器
341px 面板:供应商的可滚动导轨在左侧进行标记,所选供应商的阵容在模型标题下的右侧以单选行形式显示,并带有快速搜索提示。 MODEL_PROVIDERS 提供 18 个现实阵容,设计中包含的 8 个标记加上 LobeHub 图标集中的 10 个图标,从 OpenAI 和 Anthropic 到 Google、Mistral、xAI 和 Amazon。只有选定的行带有努力标签;按下它会打开努力弹出窗口,其中包含与胶囊作曲家使用的相同的六档“更快到更聪明”滑块。快速搜索,或 /,将标题变成一个字段,可以同时过滤每个阵容,每场比赛都标有其提供者;选择后您就会进入该提供商的名单。每个列表都会滚动。通行证 providers 为您自己的目录。
{/* Start on a model and effort stop; MODEL_PROVIDERS ships eighteen realistic lineups */}<ComposerPanel defaultModel="anthropic/fable-5.1" defaultEffort={3} />
{/* Or own both */}const [model, setModel] = useState("openai/gpt-5.6-mini");const [effort, setEffort] = useState(1); // 0 Low … 5 Max, see EFFORT_LEVELS<ComposerPanel model={model} onModelChange={setModel} effort={effort} onEffortChange={setEffort} />
{/* Your own catalogue, and the picker on its own */}<ModelPicker providers={[{ id: "acme", name: "Acme", logo: "/logos/acme.svg", models: [{ id: "acme/acme-1", name: "Acme 1" }] }]} value={model} onChange={setModel}/>状态选项卡
该选项卡是一个 34 像素的灰色条,每边插入 28 像素,仅在顶部呈圆形,包含分支、项目文件夹和 16 像素上下文环。它是 status 插槽:渲染 ComposerStatusTab 遵循你自己的价值观,放弃其他任何东西,或者通过 null 对于裸卡。
{/* Branch, project folder and context meter */}<ComposerPanel status={<ComposerStatusTab branch="release/2.0" project="boardui" context={82} />}/>
{/* No tab at all */}<ComposerPanel status={null} />提及和命令
传入 triggers,提示框就会变成 TokenInput:@ 在光标处打开文件菜单,/ 打开命令菜单,选中的项目会成为不可拆分的标签,Backspace 会整个删除它,撤销可将其恢复。提示框仍然发送字符串:onSubmit 收到类似 [@label](type:value) 的文本,fromText 可将其还原为 token。Token 输入框本身也是一个免费组件。
import { ComposerPanel } from "@/components/application/composer-panel/composer-panel";import { fromText } from "@/components/base/token-input/token-input";
const triggers = [ { char: "@", type: "file", title: "Files", items: files }, { char: "/", type: "command", title: "Commands", boundary: "start", tone: "accent", items: commands },];
<ComposerPanel triggers={triggers} onSubmit={(text) => { // "Review [@sidebar.tsx](file:components/sidebar.tsx)" const value = fromText(text); // text and { type, value, label } tokens send(value); }}/>接线
提示是一个文本区域,一次增长一行,最多十行。 Enter 发送,Shift+Enter 换行; onSubmit 接收文本,并且该字段在不受控制时会自行清除。 disabled 当转弯飞行时,发送变灰,并且 inputRef 到达焦点区域。
const [draft, setDraft] = useState("");const inputRef = useRef<HTMLTextAreaElement>(null);
<ComposerPanel value={draft} onValueChange={setDraft} onSubmit={(message) => send(message)} // Enter sends, Shift+Enter breaks the line disabled={waiting} placeholder="Hi, what do you need today?" inputRef={inputRef}/>附件
同一张卡片在提示上方带有一条 56 像素的文件图块,每个图块在文件落地时都会绘制上传环。磁贴、条带和顺序上传队列都有自己的页面。