@fv-ui/ai-chat 0.11.0 → 0.12.0
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 +100 -3
- package/dist/index.d.ts +224 -25
- package/dist/style.css +1 -1
- package/es/index.mjs +801 -350
- package/lib/index.js +802 -348
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -64,6 +64,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
64
64
|
| mdPlugins | PluginWithParams[] | — | 额外 markdown-it 插件 |
|
|
65
65
|
| highlight | (str, lang) => string | 内置 Prism | 自定义代码高亮 |
|
|
66
66
|
| isTyping | boolean | — | 打字机模式样式钩子(透传占位) |
|
|
67
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
67
68
|
|
|
68
69
|
| Ref | 说明 |
|
|
69
70
|
| --- | --- |
|
|
@@ -79,6 +80,8 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
79
80
|
| isMarkdown | boolean | false | 走 FvMarkdown 渲染(此时 suffix 不追加) |
|
|
80
81
|
| isFog | boolean \| { bgColor?; width? } | false | 打字中尾部雾化遮罩 |
|
|
81
82
|
| typing | boolean \| { step?; interval?; suffix? } | false | 开启打字机;对象形态可配步长/间隔/光标后缀 |
|
|
83
|
+
| codeTriggerLangs | string[] | — | 代码块「预览」触发语言(isMarkdown 模式透传 Markdown) |
|
|
84
|
+
| locale | LocaleInput | undefined | 语言包(透传内嵌 Markdown 的代码块「预览」按钮文案) |
|
|
82
85
|
|
|
83
86
|
| Event | 说明 |
|
|
84
87
|
| --- | --- |
|
|
@@ -144,6 +147,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
144
147
|
| backButtonPosition | { bottom?; left? } | {} | 回底按钮位置偏移 |
|
|
145
148
|
| btnIconSize | number | 16 | 回底按钮图标尺寸 |
|
|
146
149
|
| triggerIndices | 'only-last' \| 'all' \| number[] | 'only-last' | @complete 触发索引 |
|
|
150
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
147
151
|
|
|
148
152
|
| Event | 说明 |
|
|
149
153
|
| --- | --- |
|
|
@@ -183,6 +187,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
183
187
|
| triggerPopoverPlacement | ElPopover placement | 'top-start' | 弹框位置 |
|
|
184
188
|
| allowSpeech | boolean | false | 开启语音输入:麦克风按钮 → 录音条(波形+时长,Esc 取消)→ 确认后转写文本插入光标处;浏览器 SpeechRecognition 实时转写 |
|
|
185
189
|
| allowEmptySubmit | boolean | false | 允许空内容提交(附件场景:只发文件不输文字) |
|
|
190
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
186
191
|
|
|
187
192
|
| Event | 说明 |
|
|
188
193
|
| --- | --- |
|
|
@@ -218,6 +223,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
218
223
|
| userList | MentionUserInfo[] | [] | @ 触发的候选用户(id/name/avatar/pinyin) |
|
|
219
224
|
| customTrigger | MentionCustomTrigger[] | [] | 自定义触发组 { dialogTitle, prefix, tagList } |
|
|
220
225
|
| asyncMatchFun | (search) => Promise<MentionUserInfo[]> | — | 异步候选(存在时防抖 300ms,后端过滤) |
|
|
226
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(候选加载文案);内嵌 Sender 的文案经祖先注入(如 AiChat)或全局设置生效 |
|
|
221
227
|
|
|
222
228
|
事件:`update:modelValue` / `change` / `submit` / `cancel` / `trigger` / `recording-change` / `paste-file` / `update:triggerPopoverVisible` / `show-at-dialog`(弹层显隐);其余 props/事件经 `$attrs` 透传给 Sender,slot 经 forwardedSlots 显式转发(header/footer/prefix/action-list/trigger)。
|
|
223
229
|
|
|
@@ -249,6 +255,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
249
255
|
| headerAnimationTimer | number | 300 | 头部过渡时长(ms) |
|
|
250
256
|
| asyncMatchFun | (search) => Promise<EditorUser[]> | — | 异步 @ 候选(防抖 300ms) |
|
|
251
257
|
| customDialog | boolean | false | 选择标签不自弹内置弹窗,仅上抛 show-select-dialog |
|
|
258
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
252
259
|
|
|
253
260
|
| Event | 说明 |
|
|
254
261
|
| --- | --- |
|
|
@@ -287,6 +294,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
287
294
|
| buttonWidth | string | '' | 切换按钮区宽度 |
|
|
288
295
|
| maxWidth | string | '' | 内容区最大宽度 |
|
|
289
296
|
| color / backgroundColor | string | '' | 前景色 / 背景色 |
|
|
297
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
290
298
|
|
|
291
299
|
| Event | 说明 |
|
|
292
300
|
| --- | --- |
|
|
@@ -309,6 +317,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
309
317
|
| --- | --- | --- | --- |
|
|
310
318
|
| items | ThoughtChainItem[] | [] | 步骤项 { key, title?, status?: 'pending'/'success'/'loading'/'error', icon?, description? } |
|
|
311
319
|
| direction | 'vertical' \| 'horizontal' | 'vertical' | 排列方向 |
|
|
320
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
312
321
|
|
|
313
322
|
| Slot | 说明 |
|
|
314
323
|
| --- | --- |
|
|
@@ -358,6 +367,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
358
367
|
| status | 'loading' \| 'success' \| 'error' | 'success' | loading spinner / error 红边 |
|
|
359
368
|
| imageSize | string | '' | 缩略图尺寸(width/height 同值) |
|
|
360
369
|
| onDelete | () => void | — | 删除按钮回调 |
|
|
370
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
361
371
|
|
|
362
372
|
| Slot | 说明 |
|
|
363
373
|
| --- | --- |
|
|
@@ -375,6 +385,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
375
385
|
| count | number | 0 | 最大附件数(超出走 @exceed;0 不限) |
|
|
376
386
|
| beforeUpload | (file) => boolean \| Promise<boolean> | — | 上传前校验,返回 false 拦截 |
|
|
377
387
|
| layout | 'inline' \| 'triggerOnly' \| 'listOnly' | 'inline' | 布局:inline 回形针+列表+提示一行;triggerOnly 只渲染回形针按钮;listOnly 只渲染文件列表(拆分布局供整框组合:按钮进操作栏、列表进输入区上方) |
|
|
388
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
378
389
|
|
|
379
390
|
| Event | 说明 |
|
|
380
391
|
| --- | --- |
|
|
@@ -402,6 +413,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
402
413
|
| active | string \| number(v-model:active) | undefined | 当前激活会话 key |
|
|
403
414
|
| showBuiltInMenuType | 'hover' \| 'always' | 'hover' | 内置菜单按钮显隐方式 |
|
|
404
415
|
| groupable | (a, b) => number | — | 分组排序比较器(缺省保持插入顺序) |
|
|
416
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
405
417
|
|
|
406
418
|
| Event | 说明 |
|
|
407
419
|
| --- | --- |
|
|
@@ -451,11 +463,12 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
451
463
|
| placeholder | string | '' | 输入框占位 |
|
|
452
464
|
| senderShadow | boolean | true | 输入区阴影效果(透传 Sender 的 shadow) |
|
|
453
465
|
| suggestions | AiChatSuggestion[] | [] | 空态建议列表(Prompts 项,key 必填) |
|
|
454
|
-
| features | AiChatFeatures | {} | 特性开关 { artifacts?, tts?, queue?, continueGenerate?, fullscreenEditor? }(当前仅 artifacts 生效) |
|
|
466
|
+
| features | AiChatFeatures | {} | 特性开关 { artifacts?, tts?, queue?, continueGenerate?, fullscreenEditor? }(当前仅 artifacts 生效);artifacts 传 `true` 用默认配置,传对象 `{ width?, minWidth?, maxWidth?, autoOpen?, codeBlockTrigger? }` 自定义:宽度三参控面板尺寸(默认 420px/360px/60%),autoOpen(默认 true)检测到代码块自动弹面板,codeBlockTrigger(默认 true)在消息 html/svg 代码块右上角显示「预览」按钮、点击打开对应面板 |
|
|
455
467
|
| allowAttachments | boolean | false | 开启输入区附件上传(回形针在操作栏左侧与提交按钮同行,已选列表在输入框上方;只传附件不输文字也可提交) |
|
|
456
468
|
| accept | string | '' | 附件 input accept 属性(透传 Attachments),如 'image/*' |
|
|
457
469
|
| attachmentLimit | number | 0 | 附件数量上限(0 不限,超限走 @attachment-exceed) |
|
|
458
470
|
| theme | 'light' \| 'dark' \| 'auto' | 'light' | 主题(向 html 注入/移除 dark class) |
|
|
471
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(解析后注入整框后代) |
|
|
459
472
|
|
|
460
473
|
**v-model:messages 半受控语义**:外部 `messages` 仅在 setup 时一次性深拷贝灌入(用于恢复历史);组件内部每次变更全量上抛 `update:messages`(同帧去抖),父组件需经 v-model 回写维持单向数据流;父组件后续直接改 prop **不会**回灌生效。
|
|
461
474
|
|
|
@@ -514,6 +527,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
514
527
|
| assistantAvatar | string | '' | 助手头像图片 URL(透传 AiMessage;空串回落内置默认头像) |
|
|
515
528
|
| userName | string | '' | 用户名称(透传 AiMessage) |
|
|
516
529
|
| assistantName | string | '' | 助手名称(透传 AiMessage;空串回落「小维」) |
|
|
530
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
517
531
|
|
|
518
532
|
| Event | 说明 |
|
|
519
533
|
| --- | --- |
|
|
@@ -557,6 +571,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
557
571
|
|
|
558
572
|
> 用户消息操作区:恒渲染复制按钮,默认透明,鼠标移上消息(或键盘聚焦)时浮现(open-webui 交互)。
|
|
559
573
|
| autoCollapse | boolean | true | Thinking autoCollapse 透传 |
|
|
574
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
560
575
|
|
|
561
576
|
| Event | 说明 |
|
|
562
577
|
| --- | --- |
|
|
@@ -584,6 +599,7 @@ Artifacts 预览面板(iframe 沙箱,从消息 ```html / ```svg 代码块提取)
|
|
|
584
599
|
| --- | --- | --- | --- |
|
|
585
600
|
| artifacts | AiArtifactItem[] | [] | artifact 列表 { key(必填), type: 'html'/'svg', content, title? } |
|
|
586
601
|
| activeKey | string | '' | 当前展示的 key;为空时面板隐藏 |
|
|
602
|
+
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
587
603
|
|
|
588
604
|
| Event | 说明 |
|
|
589
605
|
| --- | --- |
|
|
@@ -601,11 +617,17 @@ Artifacts 预览面板(iframe 沙箱,从消息 ```html / ```svg 代码块提取)
|
|
|
601
617
|
聊天编排:发送 → 流式回填 → 队列/重生成/续写。
|
|
602
618
|
|
|
603
619
|
```ts
|
|
620
|
+
import { useChat, zhCN, enUS } from '@fv-ui/ai-chat' // zhCN/enUS:内置语言包(可换成自建包)
|
|
621
|
+
|
|
622
|
+
const lang = ref<'zh-CN' | 'en-US'>('zh-CN')
|
|
623
|
+
|
|
604
624
|
const chat = useChat({
|
|
605
625
|
adapter: () => OpenAIAdapter({ baseURL, apiKey }), // 实例或工厂;工厂每次 send 惰性取用
|
|
606
626
|
models: () => selectedModels.value, // 数组或工厂;多模型并行生成兄弟分支
|
|
607
627
|
initial: { messages, currentId }, // 恢复会话
|
|
608
|
-
onToolEvent: (ev) => { /* Fv 系通用 tool{status},展示「正在查询库存…」*/ }
|
|
628
|
+
onToolEvent: (ev) => { /* Fv 系通用 tool{status},展示「正在查询库存…」*/ },
|
|
629
|
+
// 语言包工厂:返回 LocaleMessages 包对象(zhCN/enUS 或自建包),非语言名字符串
|
|
630
|
+
locale: () => (lang.value === 'en-US' ? enUS : zhCN)
|
|
609
631
|
})
|
|
610
632
|
// chat: { send, stop, regenerate, continueGenerate, enqueue, queue, isLoading,
|
|
611
633
|
// msgs, messages, currentId, chain }
|
|
@@ -617,6 +639,7 @@ const chat = useChat({
|
|
|
617
639
|
- `continueGenerate(messageId?)`:以既有内容为前缀续写,增量追加到同一节点
|
|
618
640
|
- `enqueue(text, files?)`:生成中入队,完成后自动 flush 队首
|
|
619
641
|
- `onToolEvent`:适配器 `onTool` 回调的透传挂点(如 FvCommonAdapter 的 tool{status} 事件)
|
|
642
|
+
- `locale`:语言包工厂 `() => LocaleMessages`,惰性取用(与 adapter/models 工厂同语义);影响附件 system prompt、工具用时、续写 prompt 等发给后端的文案,缺省读全局设置,见[国际化](#国际化i18n)
|
|
620
643
|
|
|
621
644
|
### FvCommonAdapter(config)
|
|
622
645
|
|
|
@@ -718,6 +741,80 @@ const myAdapter: ChatAdapter = {
|
|
|
718
741
|
|
|
719
742
|
> 源码 SCSS 入口仅供源码依赖场景;npm 消费方推荐使用构建产物 `dist/style.css` + CSS 变量覆盖。
|
|
720
743
|
|
|
744
|
+
## 国际化(i18n)
|
|
745
|
+
|
|
746
|
+
内置 `zh-CN`(默认,零配置)与 `en-US` 两份语言包;所有组件文案(按钮 aria/tooltip、状态文案、MessageBox、错误提示、发给模型的续写 prompt)均从语言包读取。
|
|
747
|
+
|
|
748
|
+
### 全局设置(推荐)
|
|
749
|
+
|
|
750
|
+
```ts
|
|
751
|
+
import { configureLocale } from '@fv-ui/ai-chat'
|
|
752
|
+
|
|
753
|
+
configureLocale('en-US') // 整库切英文;configureLocale('zh-CN') 切回
|
|
754
|
+
```
|
|
755
|
+
|
|
756
|
+
### 组件级 prop
|
|
757
|
+
|
|
758
|
+
每个含文案的组件都有 `locale` prop,两种形态:
|
|
759
|
+
|
|
760
|
+
```vue
|
|
761
|
+
<!-- 整包切换(优先级最高) -->
|
|
762
|
+
<FvAiChat locale="en-US" ... />
|
|
763
|
+
|
|
764
|
+
<!-- 部分覆盖:在当前生效语言上深合并,只改指定文案 -->
|
|
765
|
+
<FvAiChat :locale="{ aiMessage: { regenerate: '重答' }, sender: { send: 'GO' } }" ... />
|
|
766
|
+
```
|
|
767
|
+
|
|
768
|
+
解析优先级:**组件 prop > 祖先 `<FvAiChat>` 注入 > 全局设置**。`<FvAiChat>` 会把解析结果注入整框后代(Sender/消息区/Artifacts 等),后代组件的 `locale` prop 仍可局部覆盖;单独使用基础组件(FvSender/FvConversations...)时 prop 缺省则读全局。
|
|
769
|
+
|
|
770
|
+
### 自建完整语言包
|
|
771
|
+
|
|
772
|
+
```ts
|
|
773
|
+
import { configureLocale, zhCN, type LocaleMessages } from '@fv-ui/ai-chat'
|
|
774
|
+
|
|
775
|
+
const jaJP: LocaleMessages = {
|
|
776
|
+
...zhCN,
|
|
777
|
+
common: { ...zhCN.common, send: '送信', copy: 'コピー' },
|
|
778
|
+
aiMessage: { ...zhCN.aiMessage, defaultAssistantName: 'アシスタント' }
|
|
779
|
+
// 未覆盖的 key 自动回落 zh-CN 值;建议展开全部 key 覆盖
|
|
780
|
+
}
|
|
781
|
+
configureLocale(jaJP)
|
|
782
|
+
```
|
|
783
|
+
|
|
784
|
+
`configureLocale` 的对象形态是**完整语言包**(定基准);组件 `locale` prop 的对象形态是**部分覆盖**(在基准上微调),两者语义有意不同。
|
|
785
|
+
|
|
786
|
+
### 语言包 key 一览
|
|
787
|
+
|
|
788
|
+
| 分组 | key | zh-CN | en-US |
|
|
789
|
+
| --- | --- | --- | --- |
|
|
790
|
+
| common | copy / delete / confirm / cancel / retry / close / preview / clear / stop / send / download / fullscreen / collapse / expand | 复制 / 删除 / 确定 / 取消 / 重传 / 关闭 / 预览 / 清空 / 停止 / 发送 / 下载 / 全屏 / 收起 / 展开 | Copy / Delete / OK / Cancel / Retry / Close / Preview / Clear / Stop / Send / Download / Fullscreen / Collapse / Expand |
|
|
791
|
+
| thinking | start / thinking / end / error | 开始思考 / 思考中... / 思考完成 / 思考遇到问题 | Thinking / Thinking... / Thought complete / Something went wrong |
|
|
792
|
+
| sender | clear / stop / send / speech / recordCancel / recordConfirm / micUnavailable | 清空 / 停止 / 发送 / 语音输入 / 取消录音 / 确认录音 / 无法访问麦克风 | Clear / Stop / Send / Voice input / Cancel recording / Confirm recording / Microphone unavailable |
|
|
793
|
+
| editorSender | clear / stop / send / inputPlaceholder / selectTagTitle / loading / tagTip | 清空 / 停止 / 发送 / 请输入 / 选择标签 / 加载中… / 填写内容后回车确认 | Clear / Stop / Send / Type something... / Select a tag / Loading... / Type and press Enter to confirm |
|
|
794
|
+
| attachments | add / retry | 添加附件 / 重传 | Add attachment / Retry |
|
|
795
|
+
| filesCard | remove | 删除 | Remove |
|
|
796
|
+
| conversations | menuLabel / rename / delete / renameTitle / renamePrompt / renamePlaceholder / deleteTitle / deleteConfirm | 会话操作 / 重命名 / 删除 / 重命名会话 / 请输入新的会话名称 / 请输入名称 / 删除会话 / 确定删除会话「{label}」吗?... | Conversation actions / Rename / Delete / Rename conversation / Enter a new conversation name / Enter a name / Delete conversation / Delete "{label}"? ... |
|
|
797
|
+
| scroll | toBottom | 滚动到底部 | Scroll to bottom |
|
|
798
|
+
| aiChat | modelPlaceholder / adapterMissing / generateFailed / exportUser / exportAssistant | 模型 / 未配置 adapter 或 baseURL / 生成失败 / 你 / 助手 | Model / Neither adapter nor baseURL is configured / Generation failed / You / Assistant |
|
|
799
|
+
| aiMessage | copy / regenerate / prevBranch / nextBranch / defaultUserName / defaultAssistantName / querying / queried / generateFailed | 复制 / 重新生成 / 上一分支 / 下一分支 / 你 / 小维 / 正在查询 / 已查询 / 生成失败 | Copy / Regenerate / Previous branch / Next branch / You / Assistant / Querying␣ / Queried␣ / Generation failed |
|
|
800
|
+
| aiArtifacts | copy / download / fullscreen / close | 复制 / 下载 / 全屏 / 关闭 | Copy / Download / Fullscreen / Close |
|
|
801
|
+
| chat | fileTag / fileImageTag / filesSystemPrompt / toolDuration / continuePrompt | [附件] {name} / (图片) / 用户随消息提供了以下文件:\n{files} / 用时 {s} / 请基于以上内容继续完成回答... | [File] {name} / ␣(image) / The user provided... / Took {s} / Continue completing... |
|
|
802
|
+
| errors | requestFailed / sessionIdMissing / noBody / generateFailed / recordUnsupported / speechError | 请求失败 / 缺少 sessionId(...) / 响应无 body / 生成失败 / 当前环境不支持音频录制 / 语音识别错误: {error} | Request failed / sessionId is missing... / Response has no body / Generation failed / Audio recording... / Speech recognition error: {error} |
|
|
803
|
+
|
|
804
|
+
占位符 `{label}`/`{name}`/`{files}`/`{s}`/`{error}` 由组件在渲染/构造时替换。`querying`/`queried` 英文值尾部带一个空格(与工具名直接拼接),`aiMessage.querying` 覆盖时请保留所需间距。
|
|
805
|
+
|
|
806
|
+
### 与 vue-i18n 共存
|
|
807
|
+
|
|
808
|
+
本库不依赖 vue-i18n。若项目已在用,把 LocaleMessages 挂进 vue-i18n messages 后引用其值传 prop 即可桥接:
|
|
809
|
+
|
|
810
|
+
```vue
|
|
811
|
+
<FvAiChat :locale="$tm('fvAiChat')" /> <!-- $tm 返回 fvAiChat 节点的对象作为语言包传入 -->
|
|
812
|
+
```
|
|
813
|
+
|
|
814
|
+
### 已落库数据不回溯
|
|
815
|
+
|
|
816
|
+
语言切换只影响之后的渲染与请求;已写入消息树的工具用时(`用时 1.2s`)、历史 error 文案保持产生时的语言。
|
|
817
|
+
|
|
721
818
|
## 暗色模式
|
|
722
819
|
|
|
723
820
|
`<FvAiChat theme="dark">` 或 `theme="auto"`(跟随 `prefers-color-scheme`):组件向 `<html>` 注入/移除 `dark` class,配合 element-plus 的暗色变量生效:
|
|
@@ -785,7 +882,7 @@ A:FvMarkdown 依赖浏览器 `window`(DOMPurify 消毒),不支持服务端首渲
|
|
|
785
882
|
|
|
786
883
|
## 类型与导出
|
|
787
884
|
|
|
788
|
-
包入口导出全部组件、`useChat`/`useMessages`/`useXStream`/`useSend`/`XRequest`/`useRecord`、`OpenAIAdapter`、`FvCommonAdapter`(+ `FvCommonError` 及配套 DTO 类型)、`createMessageTree`、`createLocalStorageAdapter`/`createMemoryAdapter`、`createSSEParser`
|
|
885
|
+
包入口导出全部组件、`useChat`/`useMessages`/`useXStream`/`useSend`/`XRequest`/`useRecord`、`OpenAIAdapter`、`FvCommonAdapter`(+ `FvCommonError` 及配套 DTO 类型)、`createMessageTree`、`createLocalStorageAdapter`/`createMemoryAdapter`、`createSSEParser`、`configureLocale`/`zhCN`/`enUS`(国际化)及全部公共类型(`MessageNode`、`ChatAdapter`、`ChatFile`、`MessageUsage`、`SSEEvent`、`LocaleMessages`、`LocaleInput`、`DeepPartialLocale` 等),消费方:
|
|
789
886
|
|
|
790
887
|
```ts
|
|
791
888
|
import { FvAiChat, OpenAIAdapter, useChat } from '@fv-ui/ai-chat'
|