@fv-ui/ai-chat 1.9.4 → 1.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -563,6 +563,8 @@ blob 光晕(FvBlobHalo,基础组件):多色模糊「色团」氛围光——内
563
563
  | suggestions | AiChatSuggestion[] | [] | 空态建议列表(Prompts 项,key 必填;空态快捷条为胶囊形态,description 不显示) |
564
564
  | suggestionsWrap | boolean | true | 空态建议换行模式(true 自动换行;false 不换行,超出横向滚动) |
565
565
  | welcomeLayout | 'horizontal' \| 'vertical' | 'horizontal' | 空态欢迎页布局(透传 AiMessages→Welcome):horizontal 横排(默认)/ vertical 纵排(悬浮窗等窄宽场景) |
566
+ | showRefreshSuggestions | boolean | false | 空态建议区底部是否渲染「换一批」按钮(透传 AiMessages→Welcome;组件只上抛 @refresh-suggestions 事件,轮换数据由消费方处理) |
567
+ | refreshSuggestionsText | string | '' | 「换一批」按钮文案(透传 AiMessages→Welcome;缺省回落 locale `welcome.refreshSuggestions`) |
566
568
  | followupStyle | 'list' \| 'chips' | 'list' | 追问建议展示样式(透传 AiMessages→AiMessage):'list' 纵向列表一行一条,渲染在回答操作区下方,顶部浅灰分隔线 + 「追问」标题(不加粗,与正文同色,字号随正文,标题文案经语言包 `aiMessage.followupsTitle` 自定义),条目 100% 宽、下划线分隔(浅灰,末条不出线)、字号随正文、文案次级灰,历史消息同样渲染;'chips' 为旧横向气泡形态(换行铺排,无标题)。**正文打字效果完成后才渲染**(流式 suggestions 事件到达不显示,落定+打完字整体浮现) |
567
569
  | features | AiChatFeatures | {} | 特性开关 { artifacts?, tts?, queue?, continueGenerate?, fullscreenEditor? }(当前仅 artifacts 生效);artifacts 传 `true` 用默认配置,传对象 `{ width?, minWidth?, maxWidth?, autoOpen?, codeBlockTrigger? }` 自定义:宽度三参控面板尺寸(默认 420px/360px/60%),autoOpen(默认 true)检测到代码块自动弹面板,codeBlockTrigger(默认 true)在消息 html/svg 代码块右上角显示「预览」按钮、点击打开对应面板 |
568
570
  | allowAttachments | boolean | false | 开启输入区附件上传(回形针在操作栏左侧与提交按钮同行,已选列表在输入框上方;只传附件不输文字也可提交) |
@@ -592,6 +594,7 @@ blob 光晕(FvBlobHalo,基础组件):多色模糊「色团」氛围光——内
592
594
  | feedback-change | (message, action: 'LIKE' \| 'DISLIKE' \| 'CLEAR') 评价提交成功(乐观落定后触发;message.feedback 已更新),宿主可埋点/联动 |
593
595
  | feedback-error | (message: string) 评价提交失败(钩子 reject/返回错误文案;乐观更新已回滚,message 为错误文案) |
594
596
  | scroll | (event) 消息区滚动(原生 scroll 事件透传;空态无滚动容器不触发) |
597
+ | refresh-suggestions | () 空态建议区「换一批」点击(透传 Welcome→AiMessages;消费方监听后自行更换建议数据) |
595
598
 
596
599
  | Slot | 说明 |
597
600
  | --- | --- |
@@ -600,6 +603,8 @@ blob 光晕(FvBlobHalo,基础组件):多色模糊「色团」氛围光——内
600
603
  | user-name / assistant-name | 自定义用户/助手名称(作用域 { message },优先于同名 props) |
601
604
  | welcome-name / welcome-description / welcome-icon | 单独配置欢迎页主标题/描述/吉祥物(转发 Welcome 同名插槽;优先于 title 等默认文案) |
602
605
  | welcome-suggestions | 单独配置欢迎页建议区(整体替换默认 Prompts 快捷条;建议渲染在文案下方与文案同列) |
606
+ | refresh-suggestions | 单独配置欢迎页「换一批」按钮(整体替换默认按钮;替换后点击行为由消费方自管,组件不再自动触发事件) |
607
+ | suggestions-footer | 欢迎页建议区底部追加内容(与「换一批」按钮同行,单独使用时也渲染底部容器) |
603
608
  | empty | 覆盖空态整区 |
604
609
  | scroll-button | 自定义滚到底部悬浮按钮整块(作用域 { scrollToBottom, awayFromBottom };覆盖后内置按钮与显隐逻辑均由插槽内容接管) |
605
610
  | scroll-button-icon | 仅自定义悬浮按钮图标内容(按钮本体/显隐不变) |
@@ -638,6 +643,8 @@ blob 光晕(FvBlobHalo,基础组件):多色模糊「色团」氛围光——内
638
643
  | suggestions | AiMessagesSuggestion[] | [] | 空态建议列表 |
639
644
  | suggestionsTitle | string | '' | 空态建议区标题 |
640
645
  | suggestionsWrap | boolean | true | 空态建议换行模式(true 自动换行;false 不换行,超出横向滚动) |
646
+ | showRefreshSuggestions | boolean | false | 空态建议区底部是否渲染「换一批」按钮(透传 Welcome;组件只上抛 @refresh-suggestions 事件,轮换数据由消费方处理) |
647
+ | refreshSuggestionsText | string | '' | 「换一批」按钮文案(透传 Welcome;缺省回落 locale `welcome.refreshSuggestions`) |
641
648
  | scrollThreshold | number | 100 | 用户上滚免打扰阈值(px):距底不超过该值视为「钉在底部」,流式期间自动跟随滚动 |
642
649
  | showScrollButton | boolean | true | 显示滚到底部悬浮按钮(空态不渲染) |
643
650
  | scrollButtonThreshold | number | 100 | 距底超过该值(px)才显示滚到底部悬浮按钮 |
@@ -668,12 +675,15 @@ blob 光晕(FvBlobHalo,基础组件):多色模糊「色团」氛围光——内
668
675
  | message-file-click | (file, message) 点击消息附件 chips(透传 AiMessage;图片类默认打开内置放大预览,文档类宿主自行下载) |
669
676
  | feedback-change / feedback-error | 评价提交成功(message, action)/ 失败(错误文案;透传 AiMessage,语义见 AiChat) |
670
677
  | scroll | (event) 滚动容器滚动(原生 scroll 事件透传;空态无滚动容器不触发) |
678
+ | refresh-suggestions | () 空态建议区「换一批」点击(透传 Welcome;消费方监听后自行更换建议数据) |
671
679
 
672
680
  | Slot | 说明 |
673
681
  | --- | --- |
674
682
  | empty | 覆盖空态整区 |
675
683
  | welcome-name / welcome-description / welcome-icon | 单独配置欢迎页主标题/描述/吉祥物(转发 Welcome 同名插槽) |
676
684
  | welcome-suggestions | 单独配置欢迎页建议区(整体替换默认 Prompts 快捷条) |
685
+ | refresh-suggestions | 单独配置欢迎页「换一批」按钮(整体替换默认按钮;替换后点击行为由消费方自管) |
686
+ | suggestions-footer | 欢迎页建议区底部追加内容(与「换一批」按钮同行) |
677
687
  | scroll-button | 自定义滚到底部悬浮按钮整块(作用域 { scrollToBottom, awayFromBottom };覆盖后内置按钮与显隐逻辑均由插槽内容接管) |
678
688
  | scroll-button-icon | 仅自定义悬浮按钮图标内容(按钮本体/显隐不变) |
679
689
  | message-avatar / message-actions | 透传给每条 AiMessage(message-avatar 优先于细分头像插槽) |
@@ -882,6 +892,8 @@ Props 按用途分四组:
882
892
  | suggestions | AiChatSuggestion[] | [] | 空态建议列表(建议池属宿主业务,库内不做抽样) |
883
893
  | suggestionsTitle | string | '' | 空态建议标题 |
884
894
  | suggestionsWrap | boolean | true | 空态建议换行模式 |
895
+ | showRefreshSuggestions | boolean | false | 空态建议区底部「换一批」按钮(透传 FvAiChat;组件只上抛 @refresh-suggestions 事件) |
896
+ | refreshSuggestionsText | string | '' | 「换一批」按钮文案(缺省回落 locale) |
885
897
  | typing | boolean \| { step?; interval? } | true | 打字机 |
886
898
  | collapsible | boolean | true | 思考链长文案展开/收起开关 |
887
899
  | showTime | boolean | true | 显示消息时间 |
@@ -914,10 +926,12 @@ Props 按用途分四组:
914
926
  | round-complete | 一轮回复完成(父层延时刷新会话列表标题/活跃时间) |
915
927
  | error | (err) 生成/懒创建失败(错误上抛,toast 留给宿主) |
916
928
  | message-complete / attachment-exceed / attachment-uploaded / message-file-click / feedback-change / feedback-error | FvAiChat 事件透传(载荷语义同 AiChat) |
929
+ | refresh-suggestions | () 空态建议区「换一批」点击(透传 FvAiChat;消费方监听后自行更换建议数据) |
917
930
 
918
931
  | Slot | 说明 |
919
932
  | --- | --- |
920
933
  | empty / welcome-name / welcome-description / welcome-icon / welcome-suggestions | FvAiChat 空态插槽透传 |
934
+ | refresh-suggestions / suggestions-footer | 欢迎页「换一批」按钮替换 / 建议区底部追加内容(透传 FvAiChat) |
921
935
  | user-avatar / assistant-avatar / user-name / assistant-name / message-avatar / message-actions | FvAiChat 消息插槽透传(作用域同 AiChat) |
922
936
  | sender-prefix | 输入区前缀(转发 FvAiChat #prefix) |
923
937
 
@@ -965,7 +979,8 @@ const open = ref(false) // 两个 v-model 接同一 ref
965
979
  | mode | 'drawer' \| 'floating' | 'drawer' | 面板形态:抽屉(贴侧全屏高,拖 header 超 100px 转悬窗并就地接管)/ 悬窗(独立定高,可拖 header 移动;拖到左/右视口缘持续 0.5s 出抽屉吸附预览,松开即吸附为对应侧抽屉并同步内部贴靠侧) |
966
980
  | floatingHeight | string | ''(视口高 - 上下留白 - 80) | 悬窗模式高度(css 值;drawer 模式忽略) |
967
981
  | showModeToggle | boolean | false | 显示头部「抽屉/悬窗」模式切换按钮;隐藏时仍可拖 header 超 100px 转悬窗、悬窗贴边吸附回抽屉 |
968
- | storageKey | string | 'fv-ai-chat-widget' | 宽度记忆 storage key:以 `!` 结尾视为完整 key,否则作前缀拼 `-width`;空串禁用记忆 |
982
+ | storageKey | string | 'fv-ai-chat-widget' | 宽度/位置记忆 storage key:以 `!` 结尾视为完整 key,否则作前缀拼 `-width`/`-position`;空串禁用记忆 |
983
+ | rememberPosition | boolean | true | 悬窗位置记忆总开关:开启时悬窗拖动/调宽落定持久化 left/top、挂载进悬窗时回灌(越界夹回视口内);关闭时位置读写全跳过(宽度记忆不受影响,仍只看 storageKey) |
969
984
  | keepAlive | boolean | true | 关闭保活:关闭仅隐藏(v-show),实例/对话树原样保留,再开不重渲染、不重拉历史;设 false 则关闭即销毁(v-if),每次打开重建 |
970
985
  | maximizable | boolean | true | 支持最大化:头部显示最大化按钮(关闭按钮左侧);最大化占满视口、头部头像/标题/历史/新对话/模式按钮收敛(标识由侧栏品牌行承担),FvAiSessionSidebar 升为根级全高覆盖(盖住 header 左列,logo 不重复),欢迎页转大屏横排 |
971
986
  | title | string | '' | 头部标题(空时回落 locale AI 名称) |
@@ -973,7 +988,7 @@ const open = ref(false) // 两个 v-model 接同一 ref
973
988
  | service | FvAiSessionService | (必填) | 会话数据服务(透传 Panel 与 Sidebar) |
974
989
  | adapter | ChatAdapter | (必填) | 聊天适配器(透传 Panel) |
975
990
  | sessionId | string | '' | 当前会话 id(缺省内部 DRAFT 编排;传入则受控优先) |
976
- | placeholder / suggestions / suggestionsTitle / suggestionsWrap / typing / collapsible / showTime / theme / locale / toolStepLabel | | | FvAiChatPanel 同名 props 透传 |
991
+ | placeholder / suggestions / suggestionsTitle / suggestionsWrap / showRefreshSuggestions / refreshSuggestionsText / typing / collapsible / showTime / theme / locale / toolStepLabel | | | FvAiChatPanel 同名 props 透传 |
977
992
  | allowAttachments / accept / attachmentLimit / uploadAttachment / resolveFileUrl / feedbackHandler | | | FvAiChatPanel 附件/评价钩子透传 |
978
993
  | detailLimit / historyLimit | number | 100 / 50 | 首屏 detail / 「加载更早」每次条数(透传 Panel) |
979
994
 
@@ -989,11 +1004,13 @@ const open = ref(false) // 两个 v-model 接同一 ref
989
1004
  | open / close | 面板打开 / 关闭(受控 modelValue 由 false→true / true→false 时上抛) |
990
1005
  | session-change | (sessionId) 内部会话切换(选中会话/新对话/删除切草稿/回退上一次对话;宿主可选监听对账) |
991
1006
  | session-created / round-complete / error / message-complete / attachment-exceed / attachment-uploaded / message-file-click / feedback-change / feedback-error | FvAiChatPanel 事件透传(载荷语义同 AiChatPanel) |
1007
+ | refresh-suggestions | () 空态建议区「换一批」点击(透传 Panel;消费方监听后自行更换建议数据) |
992
1008
 
993
1009
  | Slot | 说明 |
994
1010
  | --- | --- |
995
1011
  | header-avatar / header-title / header-actions | Widget 头部:替换头像 / 替换标题 / 在标题与默认按钮之间追加自定义按钮(交互可配合 `newChat()`/`switchToPrevious()`) |
996
1012
  | empty / welcome-name / welcome-description / welcome-icon / welcome-suggestions | 原样转发 FvAiChatPanel 空态插槽 |
1013
+ | refresh-suggestions / suggestions-footer | 欢迎页「换一批」按钮替换 / 建议区底部追加内容(原样转发 FvAiChatPanel) |
997
1014
  | user-avatar / assistant-avatar / user-name / assistant-name / message-avatar / message-actions / sender-prefix | 原样转发 FvAiChatPanel 消息/输入区插槽(作用域同 AiChatPanel) |
998
1015
 
999
1016
  | Ref | 说明 |
@@ -1028,7 +1045,9 @@ const open = ref(false) // 两个 v-model 接同一 ref
1028
1045
  | position | 'right' \| 'left' | | **废弃**(兼容保留):未传 placement 时按 `bottom-{position}` 推导;与 placement 同传以 placement 为准(dev 警告) |
1029
1046
  | offsetX / offsetY | number | 回落 offset | 距角横/纵轴留白(px,分轴设置) |
1030
1047
  | offset | number | 24 | 距角双轴统一留白(px 简写;offsetX/offsetY 优先) |
1031
- | draggable | boolean | true | 悬浮态可拖动改位(仅 floating+interactive 时生效):pointer 手势拖动,全程钳制视口内不出窗;落定后内联 left/top 接管 placement 贴角,位移不足 4px 仍视为点击 |
1048
+ | draggable | boolean | true | 悬浮态可拖动改位(仅 floating+interactive 时生效):pointer 手势拖动,全程钳制视口内不出窗;落定后内联 left/top 接管 placement 贴角,位移不足 4px 仍视为点击;落定位置经 storageKey 持久化、下次挂载回灌(见 storageKey/rememberPosition) |
1049
+ | storageKey | string | 'fv-ai-launcher' | 拖动位置记忆 storage key:以 `!` 结尾视为完整 key,否则作前缀拼 `-position`;空串禁用记忆 |
1050
+ | rememberPosition | boolean | true | 拖动位置记忆总开关:开启时拖动落定持久化、挂载回灌(越界夹回视口内);关闭时位置读写全跳过 |
1032
1051
  | size | number | 42 | 按钮直径(px) |
1033
1052
  | zIndex | number | 2000 | 悬浮形态层叠层级(仅 floating 生效;经 CSS 变量 `--fv-launcher-z-index` 下发):宿主固定布局件(topbar/侧栏/tagsView 等)同量级或更高时抬层,避免被盖住 |
1034
1053
  | ariaLabel | string | '' | 无障碍标签(空时回落 locale `aiChatPanel.launcher`;interactive 时生效) |
@@ -1042,7 +1061,7 @@ const open = ref(false) // 两个 v-model 接同一 ref
1042
1061
  | --- | --- |
1043
1062
  | update:modelValue | 点击后激活态取反 |
1044
1063
  | click | (MouseEvent) 原生点击 |
1045
- | drag-end | ({ left, top }) 拖动落定(钳制后的视口坐标;仅 draggable 生效的悬浮态) |
1064
+ | drag-end | ({ left, top }) 拖动落定(钳制后的视口坐标;仅 draggable 生效的悬浮态;默认同时持久化位置记忆) |
1046
1065
 
1047
1066
  | Slot | 说明 |
1048
1067
  | --- | --- |