@fv-ui/ai-chat 1.6.1 → 1.7.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 CHANGED
@@ -83,7 +83,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
83
83
  | isTyping | boolean | — | 打字机模式样式钩子(透传占位) |
84
84
  | codeTriggerLangs | string[] | — | 代码块「预览」触发语言(fence 原始 lang 命中列表时注入预览按钮,点击行为由消费方事件委托实现) |
85
85
  | tableToolbar | boolean | true | 表格工具栏:表格上方注入复制(复制表格 markdown 源文本)/下载(导出 CSV,带 BOM)单图标按钮 |
86
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
86
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
87
87
 
88
88
  | Ref | 说明 |
89
89
  | --- | --- |
@@ -166,7 +166,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
166
166
  | backButtonPosition | { bottom?; left? } | {} | 回底按钮位置偏移 |
167
167
  | btnIconSize | number | 16 | 回底按钮图标尺寸 |
168
168
  | triggerIndices | 'only-last' \| 'all' \| number[] | 'only-last' | @complete 触发索引 |
169
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
169
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
170
170
 
171
171
  | Event | 说明 |
172
172
  | --- | --- |
@@ -190,7 +190,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
190
190
  | placeholder | string | '' | 占位文案(缺省回落语言包 sender.inputPlaceholder) |
191
191
  | autosize | { minRows?; maxRows? } | { minRows: 3, maxRows: 7 } | 自增高(行高 22px;默认 3 行起步,内容多时自动加高至最多 7 行后内部滚动;显式传 {} 退回固定单行) |
192
192
  | submitType | 'enter' \| 'shiftEnter' \| 'cmdOrCtrlEnter' \| 'altEnter' | 'enter' | 提交按键模式 |
193
- | loading | boolean | false | 加载态(发送键变停止键,输入区禁用) |
193
+ | loading | boolean | false | 加载态(发送键变停止键,输入区禁用;停止键出现后 600ms 降险窗口内不可停,吸收发送瞬间的快速连点) |
194
194
  | disabled | boolean | false | 禁用(阻断提交) |
195
195
  | readOnly | boolean | false | 只读 |
196
196
  | clearable | boolean | false | 显示清空按钮 |
@@ -206,13 +206,13 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
206
206
  | triggerPopoverPlacement | ElPopover placement | 'top-start' | 弹框位置 |
207
207
  | allowSpeech | boolean | false | 开启语音输入:麦克风按钮 → 录音条(波形+时长,Esc 取消)→ 确认后转写文本插入光标处;浏览器 SpeechRecognition 实时转写 |
208
208
  | allowEmptySubmit | boolean | false | 允许空内容提交(附件场景:只发文件不输文字) |
209
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
209
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
210
210
 
211
211
  | Event | 说明 |
212
212
  | --- | --- |
213
213
  | update:modelValue / change | 输入值变化 |
214
214
  | submit | (value) 提交(提交后内部清空) |
215
- | cancel | 点击停止按钮 |
215
+ | cancel | 点击停止按钮(loading 翻 true 后 600ms 内的点击被吞不发——防连点误停) |
216
216
  | trigger | (keyword, visible) 命中指令串 |
217
217
  | recording-change | 语音录制状态变化(预留) |
218
218
  | paste-file | (file) 粘贴文件 |
@@ -242,7 +242,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
242
242
  | userList | MentionUserInfo[] | [] | @ 触发的候选用户(id/name/avatar/pinyin) |
243
243
  | customTrigger | MentionCustomTrigger[] | [] | 自定义触发组 { dialogTitle, prefix, tagList } |
244
244
  | asyncMatchFun | (search) => Promise<MentionUserInfo[]> | — | 异步候选(存在时防抖 300ms,后端过滤) |
245
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(候选加载文案);内嵌 Sender 的文案经祖先注入(如 AiChat)或全局设置生效 |
245
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(候选加载文案);内嵌 Sender 的文案经祖先注入(如 AiChat)或全局设置生效 |
246
246
 
247
247
  事件:`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)。
248
248
 
@@ -274,7 +274,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
274
274
  | headerAnimationTimer | number | 300 | 头部过渡时长(ms) |
275
275
  | asyncMatchFun | (search) => Promise<EditorUser[]> | — | 异步 @ 候选(防抖 300ms) |
276
276
  | customDialog | boolean | false | 选择标签不自弹内置弹窗,仅上抛 show-select-dialog |
277
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
277
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
278
278
 
279
279
  | Event | 说明 |
280
280
  | --- | --- |
@@ -314,7 +314,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
314
314
  | buttonWidth | string | '' | 切换按钮区宽度 |
315
315
  | maxWidth | string | '' | 内容区最大宽度 |
316
316
  | color / backgroundColor | string | '' | 前景色 / 背景色 |
317
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
317
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
318
318
 
319
319
  | Event | 说明 |
320
320
  | --- | --- |
@@ -343,7 +343,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
343
343
  | direction | 'vertical' \| 'horizontal' | 'vertical' | 排列方向 |
344
344
  | collapsible | boolean | false | 工具步长文案展开/收起(超 3 行截断 + 行尾「展开」) |
345
345
  | showDuration | boolean | false | 显示工具步用时 description(text 步 description 不受影响) |
346
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
346
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
347
347
 
348
348
  | Slot | 说明 |
349
349
  | --- | --- |
@@ -407,8 +407,9 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
407
407
  | status | 'loading' \| 'success' \| 'error' | 'success' | loading:图标位换 spinner + 名称行下「上传中…」(卡内显示);error 红边 + 失败原因 |
408
408
  | errorText | string | '' | 失败原因红字(error 态展示于卡片下方,超宽截断 title 全文) |
409
409
  | imageSize | string | '' | 缩略图尺寸(width/height 同值) |
410
- | onDelete | () => void | — | 删除按钮回调 |
411
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
410
+ | onDelete | () => void | — | 删除按钮回调(按钮常驻右上角,hover 浮现) |
411
+ | onDownload | () => void | — | 下载回调:注入时右上角渲染下载按钮(28px hover 浮现,比删除按钮大一圈,垂直居中)。消息附件卡走此路(内置触发浏览器下载),输入区附件卡不注入 |
412
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
412
413
 
413
414
  | Slot | 说明 |
414
415
  | --- | --- |
@@ -428,7 +429,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
428
429
  | upload | (file, item) => Promise\<Partial\<AttachmentItem\> \| undefined \| void\> \| ... | — | 上传钩子(先传后发):选文件即调——入列即 loading,成功返回附件描述(含服务端附件 id)回填列表项置 success,失败(抛错/resolve 错误文案串)置 error 带失败原因(可重传再走钩子);缺省不调(纯本地待发列表,入列直接 success) |
429
430
  | disabled | boolean | false | 整体禁用(触发按钮不可点;生成中锁定输入场景,单飞行闸语义) |
430
431
  | layout | 'inline' \| 'triggerOnly' \| 'listOnly' | 'inline' | 布局:inline 回形针+列表+提示一行;triggerOnly 只渲染回形针按钮;listOnly 只渲染文件列表(拆分布局供整框组合:按钮进操作栏、列表进输入区上方) |
431
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
432
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
432
433
 
433
434
  | Event | 说明 |
434
435
  | --- | --- |
@@ -457,7 +458,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
457
458
  | active | string \| number(v-model:active) | undefined | 当前激活会话 key |
458
459
  | showBuiltInMenuType | 'hover' \| 'always' | 'hover' | 内置菜单按钮显隐方式 |
459
460
  | groupable | (a, b) => number | — | 分组排序比较器(缺省保持插入顺序) |
460
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
461
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
461
462
 
462
463
  | Event | 说明 |
463
464
  | --- | --- |
@@ -527,7 +528,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
527
528
  | resolveFileUrl | (file: ChatFile) => Promise\<string\> \| string | undefined | 附件地址解析钩子(鉴权取流):消息气泡渲染附件 url 前调用,返回可直渲地址(如 JWT fetch 换 blob objectURL);缺省原样使用 url(blob/dataURL/公开地址)。远端 url 解析结果组件内按 url 缓存 + 在途去重;解析失败回落原 url 不阻塞渲染 |
528
529
  | feedbackHandler | (message, action: 'LIKE' \| 'DISLIKE' \| 'CLEAR', comment?) => Promise\<unknown\> \| unknown | undefined | 消息评价提交钩子(透传 AiMessages→AiMessage;仅 assistant 最终回答行渲染 👍/👎,缺省不渲染按钮)。消费方在此接后端评价端点(如 Fv 系 POST /message/feedback):resolved 即成功;返回错误文案串/抛错触发 feedback-error(乐观更新已回滚);action=CLEAR 取消评价(comment 忽略)。交互语义:点击 👍 直接提交(不弹附言),点击 👎 弹**居中附言弹窗**(textarea ≤500 字 + 提交/跳过),再次点击当前态按钮发 CLEAR 取消评价(附言一并清空);👍↔👎 任意切换,后一次整体覆盖前一次(含附言);提交中按钮禁用防连点 |
529
530
  | theme | 'light' \| 'dark' \| 'auto' | 'light' | 主题(向 html 注入/移除 dark class) |
530
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(解析后注入整框后代) |
531
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(解析后注入整框后代) |
531
532
 
532
533
  **v-model:messages 半受控语义**:外部 `messages` 仅在 setup 时一次性深拷贝灌入(用于恢复历史);组件内部每次变更全量上抛 `update:messages`(同帧去抖),父组件需经 v-model 回写维持单向数据流;父组件后续直接改 prop **不会**回灌生效。
533
534
 
@@ -613,7 +614,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
613
614
  | resolveFileUrl | (file: ChatFile) => Promise\<string\> \| string | undefined | 附件地址解析钩子(透传 AiMessage;鉴权取流换可直渲地址,见 AiChat) |
614
615
  | followupStyle | 'list' \| 'chips' | 'list' | 追问建议展示样式(透传 AiMessage;默认 'list' 纵向列表,'chips' 旧横向气泡,见 AiChat) |
615
616
  | feedbackHandler | (message, action, comment?) => Promise\<unknown\> \| unknown | undefined | 消息评价提交钩子(透传 AiMessage;语义见 AiChat,缺省不渲染 👍/👎) |
616
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
617
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
617
618
 
618
619
  | Event | 说明 |
619
620
  | --- | --- |
@@ -653,7 +654,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
653
654
  | message | MessageNode | —(必填) | 消息节点 |
654
655
  | branch | AiMessageBranchInfo | undefined | 分支元数据 { count, index };缺省视为单分支 |
655
656
  | isLast | boolean | false | 是否当前链最后一条消息(由 AiMessages 注入)。**追问建议已不再限链尾**(历史消息同样渲染),本 prop 仅作透传兼容保留,不参与任何显隐判定 |
656
- | showActions | boolean | true | 显示复制/重生成(仅 assistant)。**待回答落定(status=done)才渲染**——生成中(pending/streaming)不出复制/重生成/评价等工具按钮;error 无正文也不出;分支切换器不受此门控 |
657
+ | showActions | boolean | true | 显示复制/重生成。assistant **待回答落定(status=done)才渲染**——生成中(pending/streaming)不出复制/重生成/评价等工具按钮;error 无正文也不出;user 仅有文案(content 非空)时才渲染复制按钮——纯附件无文字的消息复制的是一段空串,按钮无意义不出;分支切换器不受此门控 |
657
658
  | showBranchSwitch | boolean | true | 显示分支切换器(branch.count > 1 时) |
658
659
  | showUserAvatar | boolean | false | 显示用户头像(默认隐藏;false 时用户消息不渲染头像块) |
659
660
  | showUserName | boolean | false | 显示用户名称(默认隐藏;false 时用户消息不渲染头部名称行) |
@@ -675,7 +676,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
675
676
  | followupStyle | 'list' \| 'chips' | 'list' | 追问建议展示样式:'list'(默认)纵向列表一行一条,渲染在操作区(工具栏)下方,顶部灰色分隔线 + 灰色「追问」标题(经语言包 `aiMessage.followupsTitle` 自定义);'chips' 旧横向气泡形态(换行铺排,无标题)。assistant 消息带 suggestions 即渲染——历史消息同样显示,不再限链尾;流式 message_end 前禁用防误点 |
676
677
  | resolveFileUrl | (file: ChatFile) => Promise\<string\> \| string | undefined | 附件地址解析钩子:渲染附件 url 前调用,返回可直渲地址(如 JWT fetch 换 blob objectURL);缺省原样使用 url(blob/dataURL/公开地址),远端地址解析结果按 url 缓存 + 在途去重,失败回落原 url |
677
678
  | feedbackHandler | (message, action: 'LIKE' \| 'DISLIKE' \| 'CLEAR', comment?) => Promise\<unknown\> \| unknown | undefined | 消息评价提交钩子:仅 assistant 最终回答行(role=assistant 且 status=done,error/中断/生成中不渲染)渲染 👍/👎,缺省不渲染按钮。点击 👍 直接提交,点击 👎 弹**居中附言弹窗**(ElDialog,textarea ≤500 字 + 提交/跳过,点遮罩/ESC 关闭草稿保留、再点 👎 复填),再次点击当前态按钮发 CLEAR;乐观更新——先翻转 message.feedback 再调钩子,失败回滚并经 feedback-error 上抛,成功经 feedback-change 上抛;返回 resolved 即成功,返回错误文案串/抛错均视为失败。**弹窗标题/占位可自定义**(语言包 `aiMessage.feedback.dislikeTitle`/`dislikePlaceholder`;标题 `{name}` 占位渲染时替换为 assistantName,空串回落 defaultAssistantName) |
678
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
679
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
679
680
 
680
681
  > 用户消息操作区:恒渲染复制按钮,默认透明,鼠标移上消息(或键盘聚焦)时浮现(open-webui 交互)。
681
682
 
@@ -683,7 +684,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
683
684
  | --- | --- |
684
685
  | copy / regenerate / branch-change | (message) / (message) / (dir, message) |
685
686
  | followup-select | (item, message) 点击追问建议(item 为建议文本;assistant 消息带 suggestions 即渲染——历史消息同样显示,不限链尾;status 落 done 后可点;AiChat 内部已接住转 send,直接用 AiMessage 时的消费方需自行接管发送) |
686
- | file-click | (file, message) 点击附件:图片缩略图默认打开内置 ElImageViewer 放大(同消息多图轮播,url 经 resolveFileUrl 解析);文档附件渲染为 FilesCard 卡片(类型图标 + 名称/大小,复用输入区同款),点击上抛此事件由宿主下载 |
687
+ | file-click | (file, message) 点击附件:图片缩略图默认打开内置 ElImageViewer 放大(同消息多图轮播,url 经 resolveFileUrl 解析);文档附件渲染为 FilesCard 卡片(类型图标 + 名称/大小,复用输入区同款),卡片右上角 28px 下载按钮(hover 浮现)——点击内置触发浏览器下载(url 经 resolveFileUrl 解析),不触发本事件;点击卡片本体仅上抛本事件(无内置下载行为,宿主可埋点/接管) |
687
688
  | feedback-change | (message, action: 'LIKE' \| 'DISLIKE' \| 'CLEAR') 评价提交成功(乐观落定后触发;message.feedback 已更新,宿主可埋点/联动) |
688
689
  | feedback-error | (message: string) 评价提交失败(钩子 reject/返回错误文案;乐观更新已回滚,message 为错误文案) |
689
690
  | typing | 打字机输出中(流式期间节奏性触发) |
@@ -695,7 +696,7 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
695
696
  | assistant-avatar | 自定义助手头像(作用域 { status, message },status 为 thinking/done/error,可按状态换头像;优先于 assistantAvatar props;未传插槽且未传 assistantAvatar 时内置头像本身随状态切换) |
696
697
  | user-name | 自定义用户名称(作用域 { message };优先于 userName props) |
697
698
  | assistant-name | 自定义助手名称(作用域 { message };优先于 assistantName props) |
698
- | message-files | 自定义附件渲染(作用域 { message, files };默认:图片缩略图按钮(点击内置放大预览),文档 FilesCard 卡片(类型图标 + 名称/大小,复用输入区同款);user 消息只传附件无文字时不渲染空正文气泡) |
699
+ | message-files | 自定义附件渲染(作用域 { message, files };默认:图片缩略图按钮(点击内置放大预览),文档 FilesCard 卡片(类型图标 + 名称/大小,复用输入区同款,卡片右上 28px 下载按钮 hover 浮现可下载);user 消息只传附件无文字时不渲染空正文气泡) |
699
700
  | message-actions | 自定义操作区(作用域 { message }) |
700
701
 
701
702
  | Ref | 说明 |
@@ -711,7 +712,7 @@ Artifacts 预览面板(iframe 沙箱,从消息 ```html / ```svg 代码块提取)
711
712
  | --- | --- | --- | --- |
712
713
  | artifacts | AiArtifactItem[] | [] | artifact 列表 { key(必填), type: 'html'/'svg', content, title? } |
713
714
  | activeKey | string | '' | 当前展示的 key;为空时面板隐藏 |
714
- | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
715
+ | locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
715
716
 
716
717
  | Event | 说明 |
717
718
  | --- | --- |
@@ -729,17 +730,19 @@ Artifacts 预览面板(iframe 沙箱,从消息 ```html / ```svg 代码块提取)
729
730
  聊天编排:发送 → 流式回填 → 队列/重生成/续写。
730
731
 
731
732
  ```ts
732
- import { useChat, zhCN, enUS } from '@fv-ui/ai-chat' // zhCN/enUS:内置语言包(可换成自建包)
733
+ import { useChat, zhCN, en, ko, vi, zhHK } from '@fv-ui/ai-chat' // 内置语言包(可换成自建包)
734
+
735
+ const lang = ref<'zh-CN' | 'en' | 'ko' | 'vi' | 'zh-HK'>('zh-CN')
733
736
 
734
- const lang = ref<'zh-CN' | 'en-US'>('zh-CN')
737
+ const LOCALES = { 'zh-CN': zhCN, en, ko, vi, 'zh-HK': zhHK }
735
738
 
736
739
  const chat = useChat({
737
740
  adapter: () => OpenAIAdapter({ baseURL, apiKey }), // 实例或工厂;工厂每次 send 惰性取用
738
741
  models: () => selectedModels.value, // 数组或工厂;多模型并行生成兄弟分支
739
742
  initial: { messages, currentId }, // 恢复会话
740
743
  onToolEvent: (ev) => { /* Fv 系通用 tool{status},展示「正在查询库存…」*/ },
741
- // 语言包工厂:返回 LocaleMessages 包对象(zhCN/enUS 或自建包),非语言名字符串
742
- locale: () => (lang.value === 'en-US' ? enUS : zhCN)
744
+ // 语言包工厂:返回 LocaleMessages 包对象(内置包或自建包),非语言名字符串
745
+ locale: () => LOCALES[lang.value]
743
746
  })
744
747
  // chat: { send, stop, regenerate, continueGenerate, enqueue, queue, isLoading,
745
748
  // msgs, messages, currentId, chain }
@@ -771,7 +774,7 @@ const adapter = FvCommonAdapter({
771
774
  - `tool` 事件经 `onTool` → `useChat.onToolEvent` → `AiChat @tool-event` 上抛,消费方展示「正在查询库存…」等中间态
772
775
  - 追问建议(V58+):`suggestions` 事件(流式收尾 0..1 次,最后一个 delta 后、message_end 前,载荷 `{items: string[]}`)经可选 `onSuggestions` 上抛,`useChat` 回写 `MessageNode.suggestions`,AiMessage 对带 suggestions 的 assistant 消息渲染追问(默认纵向列表样式,`followupStyle='chips'` 切回横向气泡;历史消息同样渲染,不再限链尾);开关关闭/模型未产出/中断/失败无此事件;历史恢复用导出的 `parseSuggestions(raw)` 安全解析 `FvCommonMessage.suggestions`(JSON 数组原文透传,脏数据按无建议)
773
776
  - 消息评价(V58+):`FvCommonMessage.feedback`(LIKE/DISLIKE,未评价/旧数据恒 null)、`feedbackComment`(附言 ≤500 字)、`feedbackTime`(评价落库时间)三字段同款容错;历史恢复由消费方映射为 `MessageNode.feedback` 灌入展示;评价提交走独立端点(POST /message/feedback),不经本适配器——接 `AiChat` 的 `feedbackHandler` 钩子即可
774
- - 附件快照(1.4.1+):user 行 `FvCommonMessage.attachments`(id/originalName/type/suffix/sizeBytes/downloadUrl,旧数据/无附件恒 null),历史回放映射 `MessageNode.files` 渲染(图片缩略图 + 文档 FilesCard 卡片;downloadUrl 需鉴权取流时配 `resolveFileUrl` 钩子)
777
+ - 附件快照(1.4.1+):user 行 `FvCommonMessage.attachments`(id/originalName/type/suffix/sizeBytes/downloadUrl,旧数据/无附件恒 null),历史回放映射 `MessageNode.files` 渲染(图片缩略图 + 文档 FilesCard 卡片,卡片右上 28px 下载按钮 hover 浮现可下载;downloadUrl 需鉴权取流时配 `resolveFileUrl` 钩子,下载/预览均走解析后地址)
775
778
  - 配套 DTO 类型:`FvCommonSessionItem` / `FvCommonMessage` / `FvCommonSessionDetail` / `FvCommonMessagePage`(消费方直接调会话管理端点时用)
776
779
 
777
780
  ### useMessages(initial?)
@@ -858,14 +861,14 @@ const myAdapter: ChatAdapter = {
858
861
 
859
862
  ## 国际化(i18n)
860
863
 
861
- 内置 `zh-CN`(默认,零配置)与 `en-US` 两份语言包;所有组件文案(按钮 aria/tooltip、状态文案、MessageBox、错误提示、发给模型的续写 prompt)均从语言包读取。
864
+ 内置五份语言包:`zh-CN`(默认,零配置)、`en`、`ko`、`vi`、`zh-HK`;所有组件文案(按钮 aria/tooltip、状态文案、MessageBox、错误提示、发给模型的续写 prompt)均从语言包读取。
862
865
 
863
866
  ### 全局设置(推荐)
864
867
 
865
868
  ```ts
866
869
  import { configureLocale } from '@fv-ui/ai-chat'
867
870
 
868
- configureLocale('en-US') // 整库切英文;configureLocale('zh-CN') 切回
871
+ configureLocale('en') // 整库切英文;configureLocale('zh-CN') 切回,可选 'ko'/'vi'/'zh-HK'
869
872
  ```
870
873
 
871
874
  ### 组件级 prop
@@ -874,7 +877,7 @@ configureLocale('en-US') // 整库切英文;configureLocale('zh-CN') 切回
874
877
 
875
878
  ```vue
876
879
  <!-- 整包切换(优先级最高) -->
877
- <FvAiChat locale="en-US" ... />
880
+ <FvAiChat locale="en" ... />
878
881
 
879
882
  <!-- 部分覆盖:在当前生效语言上深合并,只改指定文案 -->
880
883
  <FvAiChat :locale="{ aiMessage: { regenerate: '重答' }, sender: { send: 'GO' } }" ... />
@@ -900,7 +903,9 @@ configureLocale(jaJP)
900
903
 
901
904
  ### 语言包 key 一览
902
905
 
903
- | 分组 | key | zh-CN | en-US |
906
+ 下表列出 zh-CN 与 en 两列对照;`ko`/`vi`/`zh-HK` 词条与之一一同构,详见语言包源文件 `src/locale/{ko,vi,zh-HK}.ts`。
907
+
908
+ | 分组 | key | zh-CN | en |
904
909
  | --- | --- | --- | --- |
905
910
  | 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 |
906
911
  | thinking | start / thinking / end / error / endWithTools / thinkingItem / thoughtDoneItem | 开始思考 / 思考中... / 思考完成 / 思考遇到问题 / 思考完成,使用 {n} 个工具 / 正在思考 / 思考完成 | Thinking / Thinking... / Thought complete / Something went wrong / Thought complete, used {n} tools / Thinking / Thought complete |
@@ -1001,7 +1006,7 @@ A:FvMarkdown 依赖浏览器 `window`(DOMPurify 消毒),不支持服务端首渲
1001
1006
 
1002
1007
  ## 类型与导出
1003
1008
 
1004
- 包入口导出全部组件、`useChat`/`useMessages`/`useXStream`/`useSend`/`XRequest`/`useRecord`、`OpenAIAdapter`、`FvCommonAdapter`(+ `FvCommonError` 及配套 DTO 类型)、`parseSuggestions`(追问建议 JSON 安全解析)、`createMessageTree`、`createLocalStorageAdapter`/`createMemoryAdapter`、`createSSEParser`、`configureLocale`/`zhCN`/`enUS`(国际化)及全部公共类型(`MessageNode`、`ChatAdapter`、`ChatFile`、`MessageFeedback`、`FeedbackHandler`、`MessageUsage`、`SSEEvent`、`LocaleMessages`、`LocaleInput`、`DeepPartialLocale` 等),消费方:
1009
+ 包入口导出全部组件、`useChat`/`useMessages`/`useXStream`/`useSend`/`XRequest`/`useRecord`、`OpenAIAdapter`、`FvCommonAdapter`(+ `FvCommonError` 及配套 DTO 类型)、`parseSuggestions`(追问建议 JSON 安全解析)、`createMessageTree`、`createLocalStorageAdapter`/`createMemoryAdapter`、`createSSEParser`、`configureLocale`/`zhCN`/`en`/`ko`/`vi`/`zhHK`(国际化)及全部公共类型(`MessageNode`、`ChatAdapter`、`ChatFile`、`MessageFeedback`、`FeedbackHandler`、`MessageUsage`、`SSEEvent`、`LocaleMessages`、`LocaleCode`、`LocaleInput`、`DeepPartialLocale` 等),消费方:
1005
1010
 
1006
1011
  ```ts
1007
1012
  import { FvAiChat, OpenAIAdapter, useChat } from '@fv-ui/ai-chat'