@fv-ui/ai-chat 0.4.0 → 0.7.0

package/README.md

@@ -437,8 +437,16 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
 | title | string | '' | 顶栏标题(同时作空态欢迎页名称) |
 | showHeader | boolean | false | 显示顶栏(标题 + 模型选择器;models 多选选择器在顶栏内,需开启才可见) |
 | centerWelcome | boolean | true | 空态居中:未开始对话时欢迎内容与输入区整体垂直居中,首条消息后输入区恢复固定底部 |
+| showScrollButton | boolean | true | 显示滚到底部悬浮按钮(透传 AiMessages;距底超过 scrollButtonThreshold 时出现) |
+| scrollButtonThreshold | number | 100 | 滚到底部悬浮按钮显示阈值(px,透传 AiMessages) |
 | showUserAvatar | boolean | true | 显示用户头像(false 时用户消息不渲染头像;助手头像不受影响) |
 | showUserName | boolean | true | 显示用户名称(false 时用户消息不渲染头部名称行;助手名称不受影响) |
+| showAssistantAvatar | boolean | true | 显示助手头像(false 时助手消息不渲染头像;用户头像不受影响) |
+| showAssistantName | boolean | true | 显示助手名称(false 时助手消息不渲染头部名称行;用户名称不受影响) |
+| userAvatar | string | '' | 用户头像图片 URL(空串回落内置图标;`user-avatar` 插槽优先) |
+| assistantAvatar | string | '' | 助手头像图片 URL(空串回落内置图标;`assistant-avatar` 插槽优先) |
+| userName | string | '' | 用户名称(空串回落「你」;`user-name` 插槽优先) |
+| assistantName | string | '' | 助手名称(空串回落「助手」;`assistant-name` 插槽优先) |
 | placeholder | string | '' | 输入框占位 |
 | senderShadow | boolean | true | 输入区阴影效果(透传 Sender 的 shadow) |
 | suggestions | AiChatSuggestion[] | [] | 空态建议列表(Prompts 项,key 必填) |
@@ -461,8 +469,12 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
 
 | Slot | 说明 |
 | --- | --- |
-| message-avatar / message-actions | 透传给 AiMessages(作用域见 AiMessage) |
+| message-avatar / message-actions | 透传给 AiMessages(作用域见 AiMessage;message-avatar 优先于细分头像插槽) |
+| user-avatar / assistant-avatar | 自定义用户/助手头像(无作用域,优先于同名 props) |
+| user-name / assistant-name | 自定义用户/助手名称(作用域 { message },优先于同名 props) |
 | empty | 覆盖空态整区 |
+| scroll-button | 自定义滚到底部悬浮按钮整块(作用域 { scrollToBottom, awayFromBottom };覆盖后内置按钮与显隐逻辑均由插槽内容接管) |
+| scroll-button-icon | 仅自定义悬浮按钮图标内容(按钮本体/显隐不变) |
 | sender-prefix | 输入区前缀 |
 
 | Ref | 说明 |
@@ -489,10 +501,18 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
 | suggestions | AiMessagesSuggestion[] | [] | 空态建议列表 |
 | suggestionsTitle | string | '' | 空态建议区标题 |
 | scrollThreshold | number | 40 | 吸底阈值(px):距底不超过该值才自动跟随 |
+| showScrollButton | boolean | true | 显示滚到底部悬浮按钮(空态不渲染) |
+| scrollButtonThreshold | number | 100 | 距底超过该值(px)才显示滚到底部悬浮按钮 |
 | showActions | boolean | true | 显示消息操作按钮(复制/重生成) |
 | showBranchSwitch | boolean | true | 显示分支切换器 |
 | showUserAvatar | boolean | true | 显示用户头像(助手头像不受影响) |
 | showUserName | boolean | true | 显示用户名称(助手名称不受影响) |
+| showAssistantAvatar | boolean | true | 显示助手头像(用户头像不受影响) |
+| showAssistantName | boolean | true | 显示助手名称(用户名称不受影响) |
+| userAvatar | string | '' | 用户头像图片 URL(透传 AiMessage) |
+| assistantAvatar | string | '' | 助手头像图片 URL(透传 AiMessage) |
+| userName | string | '' | 用户名称(透传 AiMessage) |
+| assistantName | string | '' | 助手名称(透传 AiMessage) |
 
 | Event | 说明 |
 | --- | --- |
@@ -501,7 +521,11 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
 | Slot | 说明 |
 | --- | --- |
 | empty | 覆盖空态整区 |
-| message-avatar / message-actions | 透传给每条 AiMessage |
+| scroll-button | 自定义滚到底部悬浮按钮整块(作用域 { scrollToBottom, awayFromBottom };覆盖后内置按钮与显隐逻辑均由插槽内容接管) |
+| scroll-button-icon | 仅自定义悬浮按钮图标内容(按钮本体/显隐不变) |
+| message-avatar / message-actions | 透传给每条 AiMessage(message-avatar 优先于细分头像插槽) |
+| user-avatar / assistant-avatar | 自定义用户/助手头像(无作用域,优先于同名 props) |
+| user-name / assistant-name | 自定义用户/助手名称(作用域 { message },优先于同名 props) |
 
 | CSS 变量 | 默认 | 说明 |
 | --- | --- | --- |
@@ -523,6 +547,12 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
 | showBranchSwitch | boolean | true | 显示分支切换器(branch.count > 1 时) |
 | showUserAvatar | boolean | true | 显示用户头像(false 时用户消息不渲染头像块) |
 | showUserName | boolean | true | 显示用户名称(false 时用户消息不渲染头部名称行) |
+| showAssistantAvatar | boolean | true | 显示助手头像(false 时助手消息不渲染头像块) |
+| showAssistantName | boolean | true | 显示助手名称(false 时助手消息不渲染头部名称行) |
+| userAvatar | string | '' | 用户头像图片 URL(空串回落内置图标) |
+| assistantAvatar | string | '' | 助手头像图片 URL(空串回落内置图标) |
+| userName | string | '' | 用户名称(空串回落「你」) |
+| assistantName | string | '' | 助手名称(空串回落「助手」) |
 
 > 用户消息操作区:恒渲染复制按钮,默认透明,鼠标移上消息(或键盘聚焦)时浮现(open-webui 交互)。
 | autoCollapse | boolean | true | Thinking autoCollapse 透传 |
@@ -533,7 +563,11 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
 
 | Slot | 说明 |
 | --- | --- |
-| message-avatar | 自定义头像(作用域 { message }) |
+| message-avatar | 自定义头像(作用域 { message };优先于细分头像插槽,两条角色消息均生效) |
+| user-avatar | 自定义用户头像(无作用域;优先于 userAvatar props) |
+| assistant-avatar | 自定义助手头像(无作用域;优先于 assistantAvatar props) |
+| user-name | 自定义用户名称(作用域 { message };优先于 userName props) |
+| assistant-name | 自定义助手名称(作用域 { message };优先于 assistantName props) |
 | message-files | 自定义附件渲染(作用域 { message, files }) |
 | message-actions | 自定义操作区(作用域 { message }) |
 

package/dist/index.d.ts

@@ -132,7 +132,7 @@ declare var __VLS_1$9: {};
 declare var __VLS_10$1: {};
 declare var __VLS_12$1: {};
 declare var __VLS_14: {};
-declare var __VLS_32: {};
+declare var __VLS_32$1: {};
 type __VLS_Slots$e = {} & {
     avatar?: (props: typeof __VLS_1$9) => any;
 } & {
@@ -142,7 +142,7 @@ type __VLS_Slots$e = {} & {
 } & {
     content?: (props: typeof __VLS_14) => any;
 } & {
-    footer?: (props: typeof __VLS_32) => any;
+    footer?: (props: typeof __VLS_32$1) => any;
 };
 declare const __VLS_base$e: vue.DefineComponent<__VLS_Props$f, {
     interrupt: typeof interrupt;
@@ -257,7 +257,7 @@ declare var __VLS_13: {
     item: BubbleListItemProps;
     index: number;
 };
-declare var __VLS_16: {
+declare var __VLS_16$1: {
     item: BubbleListItemProps;
     index: number;
 };
@@ -274,7 +274,7 @@ type __VLS_Slots$d = {} & {
 } & {
     header?: (props: typeof __VLS_13) => any;
 } & {
-    content?: (props: typeof __VLS_16) => any;
+    content?: (props: typeof __VLS_16$1) => any;
 } & {
     loading?: (props: typeof __VLS_19$1) => any;
 } & {
@@ -367,7 +367,7 @@ declare function blur$2(): void;
 declare function openHeader$2(): void;
 declare function closeHeader$2(): void;
 declare var __VLS_1$8: {};
-declare var __VLS_3$2: {};
+declare var __VLS_3$3: {};
 declare var __VLS_5: {};
 declare var __VLS_52: {
     keyword: string;
@@ -378,7 +378,7 @@ declare var __VLS_134: {};
 type __VLS_Slots$c = {} & {
     header?: (props: typeof __VLS_1$8) => any;
 } & {
-    'body-top'?: (props: typeof __VLS_3$2) => any;
+    'body-top'?: (props: typeof __VLS_3$3) => any;
 } & {
     prefix?: (props: typeof __VLS_5) => any;
 } & {
@@ -713,7 +713,7 @@ declare function chatState(): {
 declare function openHeader(): void;
 declare function closeHeader(): void;
 declare var __VLS_1$7: {};
-declare var __VLS_3$1: {};
+declare var __VLS_3$2: {};
 declare var __VLS_19: {
     nodeId: string;
 };
@@ -722,7 +722,7 @@ declare var __VLS_80: {};
 type __VLS_Slots$a = {} & {
     header?: (props: typeof __VLS_1$7) => any;
 } & {
-    prefix?: (props: typeof __VLS_3$1) => any;
+    prefix?: (props: typeof __VLS_3$2) => any;
 } & {
     'tag-tip'?: (props: typeof __VLS_19) => any;
 } & {
@@ -820,16 +820,16 @@ type __VLS_Props$a = {
 /** 切换门控:start 起始态不可切换;thinking 中可展开查看思考流,end/error 后可自由收起展开 */
 declare function toggle(): void;
 declare var __VLS_1$6: {};
-declare var __VLS_36: {};
-declare var __VLS_38: {};
+declare var __VLS_36$1: {};
+declare var __VLS_38$1: {};
 declare var __VLS_51: {};
 declare var __VLS_53: {};
 type __VLS_Slots$9 = {} & {
     'status-icon'?: (props: typeof __VLS_1$6) => any;
 } & {
-    label?: (props: typeof __VLS_36) => any;
+    label?: (props: typeof __VLS_36$1) => any;
 } & {
-    arrow?: (props: typeof __VLS_38) => any;
+    arrow?: (props: typeof __VLS_38$1) => any;
 } & {
     error?: (props: typeof __VLS_51) => any;
 } & {
@@ -876,12 +876,12 @@ type __VLS_Props$9 = {
     /** 排列方向:vertical 纵向(带连接线)/ horizontal 横向 */
     direction?: 'vertical' | 'horizontal';
 };
-declare var __VLS_45: {
+declare var __VLS_45$1: {
     item: ThoughtChainItem;
     index: number;
 };
 type __VLS_Slots$8 = {} & {
-    content?: (props: typeof __VLS_45) => any;
+    content?: (props: typeof __VLS_45$1) => any;
 };
 declare const __VLS_base$8: vue.DefineComponent<__VLS_Props$9, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {}, string, vue.PublicProps, Readonly<__VLS_Props$9> & Readonly<{}>, {
     items: ThoughtChainItem[];
@@ -1113,19 +1113,19 @@ declare function deleteConfirm(key: string | number): Promise<void>;
 declare var __VLS_1$2: {
     group: string;
 };
-declare var __VLS_3: {
+declare var __VLS_3$1: {
     item: ConversationItem;
     active: boolean;
 };
-declare var __VLS_31: {
+declare var __VLS_31$1: {
     item: ConversationItem;
 };
 type __VLS_Slots$3 = {} & {
     'group-title'?: (props: typeof __VLS_1$2) => any;
 } & {
-    item?: (props: typeof __VLS_3) => any;
+    item?: (props: typeof __VLS_3$1) => any;
 } & {
-    menu?: (props: typeof __VLS_31) => any;
+    menu?: (props: typeof __VLS_31$1) => any;
 };
 declare const __VLS_base$3: vue.DefineComponent<__VLS_Props$4, {
     handleMenuCommand: typeof handleMenuCommand;
@@ -1392,6 +1392,20 @@ interface ChatFile {
     /** 附件类别,缺省按 'file' 处理 */
     type?: 'image' | 'file';
 }
+/**
+ * 工具调用轨迹步骤(det-oms 风格):流式 tool 事件与历史 tool 行展开后的单步。
+ * status 与 ThoughtChain 链项一致(loading 转圈/success 勾/error 叉)。
+ */
+interface ToolStepItem {
+    /** 步骤唯一标识(流式 `${toolName}-${序号}`;历史回放由消费方生成) */
+    key: string;
+    /** 展示名(流式经 toolStepLabel 转换后的工具名) */
+    title?: string;
+    /** 步骤状态;缺省视为 loading */
+    status?: 'pending' | 'loading' | 'success' | 'error';
+    /** 补充描述(历史回放的用时/返回量等次要信息) */
+    description?: string;
+}
 /** 树形消息节点(同构 open-webui 会话消息:parentId/childrenIds 构成分支树) */
 interface MessageNode {
     id: string;
@@ -1399,6 +1413,8 @@ interface MessageNode {
     content: string;
     /** 思考链全文(流式期间由包装层追加) */
     reasoning?: string;
+    /** 工具调用轨迹(det-oms 流式 tool 事件累积/历史 tool 行展开;AiMessage 以 ThoughtChain 渲染) */
+    toolSteps?: ToolStepItem[];
     /** 附件列表 */
     files?: ChatFile[];
     /** 多模型对话中的模型序号(open-webui 语义) */
@@ -1470,6 +1486,10 @@ type __VLS_Props$3 = {
     suggestionsTitle?: string;
     /** 用户上滚免打扰阈值(px):距底不超过该值才自动吸底 */
     scrollThreshold?: number;
+    /** 显示滚到底部悬浮按钮 */
+    showScrollButton?: boolean;
+    /** 距底超过该像素(px)才显示滚到底部悬浮按钮 */
+    scrollButtonThreshold?: number;
     /** 显示消息操作按钮 */
     showActions?: boolean;
     /** 显示分支切换器 */
@@ -1478,6 +1498,18 @@ type __VLS_Props$3 = {
     showUserAvatar?: boolean;
     /** 显示用户名称(助手名称不受影响) */
     showUserName?: boolean;
+    /** 显示助手头像(用户头像不受影响) */
+    showAssistantAvatar?: boolean;
+    /** 显示助手名称(用户名称不受影响) */
+    showAssistantName?: boolean;
+    /** 用户头像图片 URL(透传 AiMessage) */
+    userAvatar?: string;
+    /** 助手头像图片 URL(透传 AiMessage) */
+    assistantAvatar?: string;
+    /** 用户名称(透传 AiMessage) */
+    userName?: string;
+    /** 助手名称(透传 AiMessage) */
+    assistantName?: string;
 };
 declare function scrollToBottom(smooth?: boolean): void;
 /** 回到顶部:与 scrollToBottom 同款 try/catch 回落(happy-dom 旧版 scrollTo(options) 可能缺实现) */
@@ -1486,15 +1518,40 @@ declare var __VLS_1$1: {};
 declare var __VLS_26: {
     message: MessageNode;
 };
-declare var __VLS_29: {
+declare var __VLS_29$1: {
     message: MessageNode;
 };
+declare var __VLS_32: {};
+declare var __VLS_35: {};
+declare var __VLS_38: {
+    message: MessageNode;
+};
+declare var __VLS_41: {
+    message: MessageNode;
+};
+declare var __VLS_49: {
+    scrollToBottom: typeof scrollToBottom;
+    awayFromBottom: boolean;
+};
+declare var __VLS_65: {};
 type __VLS_Slots$2 = {} & {
     empty?: (props: typeof __VLS_1$1) => any;
 } & {
     'message-avatar'?: (props: typeof __VLS_26) => any;
 } & {
-    'message-actions'?: (props: typeof __VLS_29) => any;
+    'message-actions'?: (props: typeof __VLS_29$1) => any;
+} & {
+    'user-avatar'?: (props: typeof __VLS_32) => any;
+} & {
+    'assistant-avatar'?: (props: typeof __VLS_35) => any;
+} & {
+    'user-name'?: (props: typeof __VLS_38) => any;
+} & {
+    'assistant-name'?: (props: typeof __VLS_41) => any;
+} & {
+    'scroll-button'?: (props: typeof __VLS_49) => any;
+} & {
+    'scroll-button-icon'?: (props: typeof __VLS_65) => any;
 };
 declare const __VLS_base$2: vue.DefineComponent<__VLS_Props$3, {
     scrollToBottom: typeof scrollToBottom;
@@ -1518,9 +1575,17 @@ declare const __VLS_base$2: vue.DefineComponent<__VLS_Props$3, {
     showBranchSwitch: boolean;
     showUserAvatar: boolean;
     showUserName: boolean;
+    showAssistantAvatar: boolean;
+    showAssistantName: boolean;
+    userAvatar: string;
+    assistantAvatar: string;
+    userName: string;
+    assistantName: string;
     suggestions: AiMessagesSuggestion[];
     suggestionsTitle: string;
     scrollThreshold: number;
+    showScrollButton: boolean;
+    scrollButtonThreshold: number;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$3: __VLS_WithSlots$2<typeof __VLS_base$2, __VLS_Slots$2>;
 declare const _default$3: typeof __VLS_export$3;
@@ -1561,12 +1626,30 @@ type __VLS_Props$2 = {
     showHeader?: boolean;
     /** 空态居中:未开始对话时欢迎内容与输入区整体垂直居中,首条消息后恢复输入区固定底部 */
     centerWelcome?: boolean;
+    /** 显示滚到底部悬浮按钮(透传 AiMessages;距底超过 scrollButtonThreshold 时出现) */
+    showScrollButton?: boolean;
+    /** 滚到底部悬浮按钮显示阈值(px,透传 AiMessages) */
+    scrollButtonThreshold?: number;
     /** 显示用户头像(false 时用户消息不渲染头像;助手头像不受影响) */
     showUserAvatar?: boolean;
     /** 显示用户名称(false 时用户消息不渲染头部名称行;助手名称不受影响) */
     showUserName?: boolean;
+    /** 显示助手头像(false 时助手消息不渲染头像;用户头像不受影响) */
+    showAssistantAvatar?: boolean;
+    /** 显示助手名称(false 时助手消息不渲染头部名称行;用户名称不受影响) */
+    showAssistantName?: boolean;
+    /** 用户头像图片 URL(空串回落内置图标;user-avatar 插槽可整体覆盖) */
+    userAvatar?: string;
+    /** 助手头像图片 URL(空串回落内置图标;assistant-avatar 插槽可整体覆盖) */
+    assistantAvatar?: string;
+    /** 用户名称(空串回落「你」;user-name 插槽可整体覆盖) */
+    userName?: string;
+    /** 助手名称(空串回落「助手」;assistant-name 插槽可整体覆盖) */
+    assistantName?: string;
     /** 输入框占位 */
     placeholder?: string;
+    /** 工具名 → 步骤展示名(透传 useChat toolStepLabel,流式工具轨迹步骤的 title) */
+    toolStepLabel?: (toolName: string) => string;
     /** 输入区阴影效果(透传 Sender;关闭传 false) */
     senderShadow?: boolean;
     /** 空态建议列表 */
@@ -1602,15 +1685,40 @@ declare var __VLS_27: {
     message: MessageNode;
 };
 declare var __VLS_30: {};
-declare var __VLS_66: {};
+declare var __VLS_33$1: {};
+declare var __VLS_36: {
+    message: MessageNode;
+};
+declare var __VLS_39: {
+    message: MessageNode;
+};
+declare var __VLS_42: {};
+declare var __VLS_45: {
+    scrollToBottom: (smooth?: boolean) => void;
+    awayFromBottom: boolean;
+};
+declare var __VLS_48: {};
+declare var __VLS_84: {};
 type __VLS_Slots$1 = {} & {
     'message-avatar'?: (props: typeof __VLS_24) => any;
 } & {
     'message-actions'?: (props: typeof __VLS_27) => any;
 } & {
-    empty?: (props: typeof __VLS_30) => any;
+    'user-avatar'?: (props: typeof __VLS_30) => any;
+} & {
+    'assistant-avatar'?: (props: typeof __VLS_33$1) => any;
+} & {
+    'user-name'?: (props: typeof __VLS_36) => any;
+} & {
+    'assistant-name'?: (props: typeof __VLS_39) => any;
+} & {
+    empty?: (props: typeof __VLS_42) => any;
+} & {
+    'scroll-button'?: (props: typeof __VLS_45) => any;
 } & {
-    'sender-prefix'?: (props: typeof __VLS_66) => any;
+    'scroll-button-icon'?: (props: typeof __VLS_48) => any;
+} & {
+    'sender-prefix'?: (props: typeof __VLS_84) => any;
 };
 declare const __VLS_base$1: vue.DefineComponent<__VLS_Props$2, {
     sendMessage: typeof sendMessage;
@@ -1652,11 +1760,20 @@ declare const __VLS_base$1: vue.DefineComponent<__VLS_Props$2, {
     messages: MessageNode[];
     showUserAvatar: boolean;
     showUserName: boolean;
+    showAssistantAvatar: boolean;
+    showAssistantName: boolean;
+    userAvatar: string;
+    assistantAvatar: string;
+    userName: string;
+    assistantName: string;
     suggestions: AiChatSuggestion[];
+    showScrollButton: boolean;
+    scrollButtonThreshold: number;
     models: string[];
     adapter: ChatAdapter;
     showHeader: boolean;
     centerWelcome: boolean;
+    toolStepLabel: (toolName: string) => string;
     senderShadow: boolean;
     features: AiChatFeatures;
     allowAttachments: boolean;
@@ -1692,25 +1809,53 @@ type __VLS_Props$1 = {
     showUserAvatar?: boolean;
     /** 显示用户名称(false 时用户消息不渲染头部名称行;助手侧不受影响) */
     showUserName?: boolean;
+    /** 显示助手头像(false 时助手消息不渲染头像块;用户侧不受影响) */
+    showAssistantAvatar?: boolean;
+    /** 显示助手名称(false 时助手消息不渲染头部名称行;用户侧不受影响) */
+    showAssistantName?: boolean;
+    /** 用户头像图片 URL(空串回落内置图标;细分插槽可整体覆盖) */
+    userAvatar?: string;
+    /** 助手头像图片 URL(空串回落内置图标;细分插槽可整体覆盖) */
+    assistantAvatar?: string;
+    /** 用户名称(空串回落「你」;细分插槽可整体覆盖) */
+    userName?: string;
+    /** 助手名称(空串回落「助手」;细分插槽可整体覆盖) */
+    assistantName?: string;
     /** Thinking autoCollapse 透传 */
     autoCollapse?: boolean;
 };
 declare var __VLS_1: {
     message: MessageNode;
 };
-declare var __VLS_25: {
+declare var __VLS_3: {};
+declare var __VLS_16: {};
+declare var __VLS_29: {
+    message: MessageNode;
+};
+declare var __VLS_31: {
+    message: MessageNode;
+};
+declare var __VLS_33: {
     message: MessageNode;
     files: ChatFile[];
 };
-declare var __VLS_44: {
+declare var __VLS_57: {
     message: MessageNode;
 };
 type __VLS_Slots = {} & {
     'message-avatar'?: (props: typeof __VLS_1) => any;
 } & {
-    'message-files'?: (props: typeof __VLS_25) => any;
+    'user-avatar'?: (props: typeof __VLS_3) => any;
+} & {
+    'assistant-avatar'?: (props: typeof __VLS_16) => any;
+} & {
+    'user-name'?: (props: typeof __VLS_29) => any;
+} & {
+    'assistant-name'?: (props: typeof __VLS_31) => any;
+} & {
+    'message-files'?: (props: typeof __VLS_33) => any;
 } & {
-    'message-actions'?: (props: typeof __VLS_44) => any;
+    'message-actions'?: (props: typeof __VLS_57) => any;
 };
 declare const __VLS_base: vue.DefineComponent<__VLS_Props$1, {
     message: vue.ComputedRef<MessageNode>;
@@ -1729,6 +1874,12 @@ declare const __VLS_base: vue.DefineComponent<__VLS_Props$1, {
     showBranchSwitch: boolean;
     showUserAvatar: boolean;
     showUserName: boolean;
+    showAssistantAvatar: boolean;
+    showAssistantName: boolean;
+    userAvatar: string;
+    assistantAvatar: string;
+    userName: string;
+    assistantName: string;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export$1: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default$1: typeof __VLS_export$1;
@@ -1893,6 +2044,8 @@ interface UseChatOptions {
         toolName: string;
         status: 'start' | 'done';
     }) => void;
+    /** 工具名 → 步骤展示名(流式 toolSteps 的 title;缺省原样使用 toolName) */
+    toolStepLabel?: (toolName: string) => string;
 }
 /** 待发送队列项 */
 interface QueueItem {
@@ -1942,4 +2095,4 @@ declare function createMessageTree(initial?: {
 declare const version = "0.1.0";
 
 export { DetOmsChatAdapter, DetOmsError, _default as FvAiArtifacts, _default$2 as FvAiChat, _default$1 as FvAiMessage, _default$3 as FvAiMessages, _default$5 as FvAttachments, _default$f as FvBubble, _default$e as FvBubbleList, _default$4 as FvConversations, _default$b as FvEditorSender, _default$6 as FvFilesCard, _default$h as FvMarkdown, _default$c as FvMentionSender, _default$7 as FvPrompts, _default$d as FvSender, _default$a as FvThinking, _default$9 as FvThoughtChain, _default$g as FvTypewriter, _default$8 as FvWelcome, OpenAIAdapter, XRequest, createLocalStorageAdapter, createMemoryAdapter, createMessageTree, createSSEParser, useChat, useMessages, useRecord, useSend, useXStream, version };
-export type { AdapterChatMessage, AiArtifactItem, AiChatFeatures, AiChatSuggestion, AiMessageBranchInfo, AiMessagesSuggestion, BranchDirection, ChatAdapter, ChatAdapterHandlers, ChatAdapterRequest, ChatFile, DetOmsChatAdapterConfig, DetOmsMessage, DetOmsMessagePage, DetOmsSendBody, DetOmsSessionDetail, DetOmsSessionItem, DetOmsToolEvent, MessageNode, MessageNodeInput, MessageRole, MessageStatus, MessageTree, MessageUsage, OpenAIAdapterConfig, QueueItem, RawUsage, SSEEvent, SSEParser, SendOptions, StorageAdapter, ToolCallItem, UseChatOptions, UseChatReturn, UseMessagesReturn, UseRecordReturn, UseSendReturn, UseXStreamReturn };
+export type { AdapterChatMessage, AiArtifactItem, AiChatFeatures, AiChatSuggestion, AiMessageBranchInfo, AiMessagesSuggestion, BranchDirection, ChatAdapter, ChatAdapterHandlers, ChatAdapterRequest, ChatFile, DetOmsChatAdapterConfig, DetOmsMessage, DetOmsMessagePage, DetOmsSendBody, DetOmsSessionDetail, DetOmsSessionItem, DetOmsToolEvent, MessageNode, MessageNodeInput, MessageRole, MessageStatus, MessageTree, MessageUsage, OpenAIAdapterConfig, QueueItem, RawUsage, SSEEvent, SSEParser, SendOptions, StorageAdapter, ToolCallItem, ToolStepItem, UseChatOptions, UseChatReturn, UseMessagesReturn, UseRecordReturn, UseSendReturn, UseXStreamReturn };