showAvatar 显示头像列;没有 avatar 时显示名称首字母。
- 在宿主维护 provider 的流式状态,再映射到
status。 id 用对话存储中的稳定 id,不用数组下标。- 助手输出保持
markdown 开启;不可信的 Markdown 在数据边界清洗。 - 推理、工具调用、附件与来源用
parts 描述,不要往 content 里塞 HTML。
| 属性名 | 类型 | 默认值 | 说明 |
|---|
messages | AiElementMessage[] | 必填 | 对话数据,按顺序渲染。 |
markdown | boolean | true | 用 TxMarkdownView 渲染正文。 |
compact | boolean | false | 收紧消息间距。 |
emptyText | string | 'No messages yet' | 没有可渲染消息时的空状态文案。 |
showAvatar | boolean | false | 为每条消息显示头像列。 |
typingLabel | string | - | 转发给每条消息:输入中指示器的可访问名称。 |
| 事件名 | 参数 | 说明 |
|---|
open-source | (source: AiSourceItem) | 转发自被点击来源所在的消息。 |
| 插槽名 | Props | 说明 |
|---|
empty | - | 替换内置空状态。 |
default / avatar / markdown-renderer / tool-result | 同 TxAiMessage | 转发给每条 TxAiMessage。 |
| 属性名 | 类型 | 默认值 | 说明 |
|---|
message | AiElementMessage | 必填 | 单条消息。 |
markdown | boolean | true | 用 TxMarkdownView 渲染正文;false 时按纯文本保留换行。 |
compact | boolean | false | 紧凑行距与更小的头像。 |
showAvatar | boolean | false | 显示头像。 |
typingLabel | string | 'AI is typing' | 输入中指示器的可访问名称。 |
| 事件名 | 参数 | 说明 |
|---|
open-source | (source: AiSourceItem) | 点击 sources 片段中的来源时触发,默认跳转已阻止。 |
| 插槽名 | Props | 说明 |
|---|
default | { message } | 替换正文区域,用于工具卡片、附件或自定义渲染。 |
avatar | { message } | showAvatar 开启时替换头像。 |
markdown-renderer | { part, message, streaming } | 替换 text 片段的渲染;只有流式消息的最后一个文本片段 streaming 为真。 |
tool-result | { part } | 替换 tool-call 片段在 done 后的结果区。 |
| 字段 | 类型 | 默认值 | 说明 |
|---|
id | string | 必填 | 稳定 key。 |
role | 'user' | 'assistant' | 'system' | 'tool' | 必填 | 视觉与语义角色。 |
content | string | 必填 | 文本或 Markdown 源。 |
createdAt | number | string | Date | - | 宿主的时间戳。 |
name | string | - | 显示名称;缺省为 You / AI / Tool / System。 |
avatar | string | - | 头像图片 URL。 |
status | 'pending' | 'streaming' | 'complete' | 'error' | - | 消息生命周期状态。 |
parts | AiMessagePart[] | - | 非空时按顺序渲染这些片段,取代 content。 |
type AiMessagePart =
| { type: 'text', text: string } // markdown-renderer 插槽或 TxMarkdownView
| { type: 'reasoning', text: string, done?: boolean, durationMs?: number } // TxReasoningDisclosure
| AiToolCallPart // type: 'tool-call',由 TxToolCallCard 渲染
| { type: 'attachment', attachments: AiAttachment[] } // 只读的 TxAttachmentTray
| { type: 'sources', sources: AiSourceItem[] } // TxSources
content 为空的消息不渲染,带 parts 或 status 为 pending、streaming 时除外。- 这类空消息若没有
parts,显示输入中指示器。 TxAiConversation 是 aria-live="polite" 区域:追加的消息会被播报,不抢焦点。
- 源码:
packages/tuffex/packages/components/src/ai-elements/。
查看源码packages/tuffex/packages/components/src/ai-elements/index.ts