@fv-ui/ai-chat 1.11.0 → 2.0.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 +153 -12
- package/dist/index.d.ts +489 -2303
- package/dist/style.css +1 -1
- package/es/index.mjs +8156 -4496
- package/lib/index.js +8186 -4513
- package/package.json +81 -80
package/README.md
CHANGED
|
@@ -1,11 +1,13 @@
|
|
|
1
1
|
# @fv-ui/ai-chat
|
|
2
2
|
|
|
3
|
-

|
|
4
4
|

|
|
5
5
|

|
|
6
6
|
|
|
7
7
|
基于 Vue 3 + Element Plus 的 AI 对话组件库,复刻 element-plus-x 与 open-webui 对话框:从底层气泡、发送框、Markdown 渲染,到上层的对话整框(`<FvAiChat>`)、分支树消息、Artifacts 预览,一次给全。
|
|
8
8
|
|
|
9
|
+
> 分层:纯逻辑(消息树/适配器协议/SSE 解析/编排 composables/语言包)抽在 [`@fv-ui/ai-chat-core`](../ai-chat-core)(零 EP/零 DOM/零 fetch,平台能力经 PlatformBridge 注入);本包为 Web UI 层,入口默认注入 web 桥,公共 API 全部经 core re-export。
|
|
10
|
+
|
|
9
11
|
- 14 个基础组件(Bubble/Sender/Markdown/Thinking/...)自由拼装
|
|
10
12
|
- 对话应用层整框 `<FvAiChat>`:顶栏模型多选、消息列表、分支切换、Artifacts 面板、发送停止一体化
|
|
11
13
|
- 树形消息模型(同构 open-webui):一条提问可挂多个模型回答,分支可切换、可重生成
|
|
@@ -69,6 +71,20 @@ export default defineConfig({
|
|
|
69
71
|
|
|
70
72
|
说明:仅 Vite **dev** 需要;生产 `build` 走 Rollup 管线会自动把 GIF 复制进产物并重写路径,不受影响。UMD(`<script>` 直用 `lib/index.js`)不涉及。
|
|
71
73
|
|
|
74
|
+
### 浏览器 `<script>` 直用(UMD)
|
|
75
|
+
|
|
76
|
+
`lib/index.js` 为 UMD 单文件,自包含 `@fv-ui/ai-chat-core`(纯逻辑层已内联,1.11.1 起不再要求页面预挂 `FvAiChatCore`/`FvAiChatCorePlatformWeb` 全局);页面仍需先引入 peerDeps:
|
|
77
|
+
|
|
78
|
+
```html
|
|
79
|
+
<script src="https://unpkg.com/vue@3"></script>
|
|
80
|
+
<script src="https://unpkg.com/element-plus"></script>
|
|
81
|
+
<script src="https://unpkg.com/@element-plus/icons-vue"></script>
|
|
82
|
+
<script src="/path/to/@fv-ui/ai-chat/lib/index.js"></script>
|
|
83
|
+
<link rel="stylesheet" href="/path/to/@fv-ui/ai-chat/dist/style.css">
|
|
84
|
+
```
|
|
85
|
+
|
|
86
|
+
全局变量:`window.FvAiChat`(组件/composable/类型值)。
|
|
87
|
+
|
|
72
88
|
## 基础组件层 API
|
|
73
89
|
|
|
74
90
|
### FvMarkdown
|
|
@@ -451,7 +467,9 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
451
467
|
|
|
452
468
|
### Conversations
|
|
453
469
|
|
|
454
|
-
会话列表(按 group 分组)。
|
|
470
|
+
会话列表(按 group 分组)。列表超长(>2×virtualThreshold)且显式传入 `virtual-disabled="false"` 时启用内部自滚虚拟滚动,按行高裁剪视口外行;缺省关闭——消费方把滚动交给外层容器(如 el-scrollbar)时根节点不滚动,scroll 事件永不触发,虚拟化会永久截断列表。启用须保证组件根自身可滚动(或 height 受限)。
|
|
471
|
+
|
|
472
|
+
滚动由外层共享容器接管时(如侧栏多实例平铺在一个 el-scrollbar 内),改用 `external-scroll` 外部滚动窗口化:消费方把容器 `scroll-top`/`viewport-height` 与本列表在容器内容中的偏移 `offset-top` 作为 props 下发,组件按相对视口位置裁剪窗口,根节点不自滚、以 spacer 撑满总高(保证共享容器内后续区块偏移稳定);`viewport-height` 未测量(0)时不渲染行,待消费方测量后下发。
|
|
455
473
|
|
|
456
474
|
| Prop | 类型 | 默认 | 说明 |
|
|
457
475
|
| --- | --- | --- | --- |
|
|
@@ -459,12 +477,23 @@ Markdown 渲染(Sanitized by DOMPurify),内置 Prism 代码高亮与 KaTeX。
|
|
|
459
477
|
| active | string \| number(v-model:active) | undefined | 当前激活会话 key |
|
|
460
478
|
| showBuiltInMenuType | 'hover' \| 'always' | 'hover' | 内置菜单按钮显隐方式 |
|
|
461
479
|
| groupable | (a, b) => number | — | 分组排序比较器(缺省保持插入顺序) |
|
|
480
|
+
| loading | boolean | false | 下一页加载中(loading 时触底不再触发 load-more) |
|
|
481
|
+
| hasMore | boolean | false | 是否还有更早分页(缺省 false 不触发 load-more) |
|
|
482
|
+
| rowHeight | number | 32 | 行高(虚拟滚动按 行数×行高 计算总高与窗口) |
|
|
483
|
+
| virtualThreshold | number | 8 | 视口上下各多渲染的缓冲行数 |
|
|
484
|
+
| virtualDisabled | boolean | true | 内部自滚虚拟滚动开关(opt-in;缺省关闭。外部滚动容器接管时根节点不滚,scroll 永不触发,虚拟化会截断列表;启用须保证根自身可滚动) |
|
|
485
|
+
| externalScroll | boolean | false | 外部滚动窗口化:滚动由外层共享容器接管,窗口由 scrollTop/viewportHeight/offsetTop 驱动(优先于 virtualDisabled;spacer 撑满总高) |
|
|
486
|
+
| scrollTop | number | 0 | 外层滚动容器的 scrollTop(容器内容坐标系;仅 externalScroll) |
|
|
487
|
+
| viewportHeight | number | 0 | 外层滚动容器视口高度(仅 externalScroll;0=未测量,不渲染行) |
|
|
488
|
+
| offsetTop | number | 0 | 本列表在外层容器内容中的偏移(首条目距容器内容顶;仅 externalScroll) |
|
|
462
489
|
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en'/'ko'/'vi'/'zh-HK' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
463
490
|
|
|
464
491
|
| Event | 说明 |
|
|
465
492
|
| --- | --- |
|
|
466
493
|
| update:active / change | 选中会话(key / item) |
|
|
467
494
|
| menu-command | ({ item, command: 'rename'/'delete', value? }) 菜单指令;rename 确认后带新名称 |
|
|
495
|
+
| load-more | 滚动到底且 hasMore && !loading 时触发(组件根节点自身滚动;外层接管滚动时由消费方自行判定触底) |
|
|
496
|
+
| update:selectedKeys | 多选模式已选 key 集合(v-model:selectedKeys) |
|
|
468
497
|
|
|
469
498
|
| Slot | 说明 |
|
|
470
499
|
| --- | --- |
|
|
@@ -850,11 +879,17 @@ const sidebarRef = ref()
|
|
|
850
879
|
| service | FvAiSessionService | (必填) | 会话数据服务(宿主注入;archive 可选,未实现时隐藏归档 tab 与菜单项) |
|
|
851
880
|
| activeId | string | (必填) | 当前会话 id(草稿哨兵 DRAFT_SESSION_ID 或真实 id) |
|
|
852
881
|
| v-model:collapsed | boolean | false | 收起态(默认展开);收起态窄条竖排「展开 + 新建 + 搜索」三个图标按钮 |
|
|
853
|
-
| pageSize | number |
|
|
882
|
+
| pageSize | number | 30 | 列表分页大小 |
|
|
854
883
|
| searchable | boolean | true | 显示搜索框(后端标题模糊匹配,输入防抖 400ms,清空即恢复) |
|
|
855
884
|
| brandName | string | 'Gizmo' | 品牌名称 |
|
|
856
885
|
| brandIcon | string | 内置品牌头像 | 品牌徽章图片 URL(默认内置 fvai-avatar.svg) |
|
|
857
886
|
| locale | LocaleInput(string \| 对象) | undefined | 语言包:'zh-CN'/'en-US' 整包或部分文案对象(优先于祖先注入与全局设置) |
|
|
887
|
+
| searchContent | boolean | true | 启用内容搜索(弹窗形态,搜索标题+会话内容;service.search 未实现时自动降级为原输入框标题搜索) |
|
|
888
|
+
| searchPlaceholder | string | '' | 列表搜索框 placeholder(仅未启用内容搜索的输入框形态) |
|
|
889
|
+
| searchContentPlaceholder | string | '' | 内容搜索弹窗输入框 placeholder(缺省回落 locale.sessionSidebar.contentPlaceholder) |
|
|
890
|
+
| searchHistoryEnabled | boolean | true | 是否启用搜索历史功能(点击选中搜索结果时才记录;localStorage 持久化,最多 10 条,去重) |
|
|
891
|
+
| searchHistoryKey | string | 'fv-ai-search-history' | 搜索历史 localStorage 存储 key(多实例/多业务场景可自定义隔离) |
|
|
892
|
+
| searchHistoryPinned | boolean | false | 搜索历史是否常驻弹窗底部(true 常驻;false 仅输入为空时展示在结果区上方) |
|
|
858
893
|
|
|
859
894
|
| Event | 说明 |
|
|
860
895
|
| --- | --- |
|
|
@@ -875,6 +910,51 @@ const sidebarRef = ref()
|
|
|
875
910
|
| refresh() | 静默刷新列表(不打 loading 遮罩;供父层在懒创建落库/首轮回复完成后调,刷新标题/活跃时间) |
|
|
876
911
|
| reload() | 重载首页列表(与内部首载同路径) |
|
|
877
912
|
|
|
913
|
+
### AiSearchModal
|
|
914
|
+
|
|
915
|
+
内容搜索弹窗(FvAiSearchModal):侧栏/悬浮窗共用的独立组件,一般经 AiSessionSidebar 的搜索入口唤起,也可单独使用。输入防抖 400ms 检索,标题命中 + 会话内容命中分组展示;点击选中结果上抛事件给宿主。
|
|
916
|
+
|
|
917
|
+
```vue
|
|
918
|
+
<script setup lang="ts">
|
|
919
|
+
import { ref } from 'vue'
|
|
920
|
+
import { FvAiSearchModal } from '@fv-ui/ai-chat'
|
|
921
|
+
import type { FvAiSessionService } from '@fv-ui/ai-chat'
|
|
922
|
+
|
|
923
|
+
const service: FvAiSessionService = { /* 宿主胶水,见下节 */ } as FvAiSessionService
|
|
924
|
+
const visible = ref(false)
|
|
925
|
+
</script>
|
|
926
|
+
|
|
927
|
+
<template>
|
|
928
|
+
<FvAiSearchModal
|
|
929
|
+
v-model="visible"
|
|
930
|
+
:service="service"
|
|
931
|
+
@select="(s, kw) => console.log('标题命中', s, kw)"
|
|
932
|
+
@content-select="(hit, kw) => console.log('内容命中', hit, kw)"
|
|
933
|
+
/>
|
|
934
|
+
</template>
|
|
935
|
+
```
|
|
936
|
+
|
|
937
|
+
| Prop | 类型 | 默认 | 说明 |
|
|
938
|
+
| --- | --- | --- | --- |
|
|
939
|
+
| v-model | boolean | (必填) | 弹窗显隐 |
|
|
940
|
+
| service | FvAiSessionService | (必填) | 会话数据服务(search/list 必填;search 未实现时调用方不应挂载) |
|
|
941
|
+
| pageSize | number | 20 | 内容分页大小 |
|
|
942
|
+
| locale | LocaleInput | undefined | 语言配置 |
|
|
943
|
+
| placeholder | string | '' | 输入框占位(缺省回落 locale.sessionSidebar.contentPlaceholder) |
|
|
944
|
+
| searchHistoryEnabled | boolean | true | 是否启用搜索历史功能(点击选中搜索结果时才记录;localStorage 持久化,最多 10 条,去重) |
|
|
945
|
+
| searchHistoryKey | string | 'fv-ai-search-history' | 搜索历史 localStorage 存储 key |
|
|
946
|
+
| searchHistoryPinned | boolean | false | 搜索历史是否常驻弹窗底部(true 常驻;false 仅输入为空时展示) |
|
|
947
|
+
|
|
948
|
+
| Event | 说明 |
|
|
949
|
+
| --- | --- |
|
|
950
|
+
| update:modelValue | (v: boolean) 弹窗显隐同步 |
|
|
951
|
+
| select | (session: FvCommonSessionItem, keyword: string) 标题命中(会话行)点击 |
|
|
952
|
+
| content-select | (hit: FvAiSearchHit, keyword: string) 内容命中点击 |
|
|
953
|
+
|
|
954
|
+
| Ref | 说明 |
|
|
955
|
+
| --- | --- |
|
|
956
|
+
| reset() | 清空输入与结果(宿主在「退出搜索状态」时调用) |
|
|
957
|
+
|
|
878
958
|
### AiChatPanel
|
|
879
959
|
|
|
880
960
|
对话面板(FvAiChatPanel,无头设计:会话状态/标题由侧栏表达,面板只承担对话):内嵌 FvAiChat + 会话历史加载 + 草稿懒创建。「加载更早」按钮悬浮消息区顶部(仅已拉详情且贴顶时出现),按 seq 游标向前翻页合并。
|
|
@@ -979,7 +1059,7 @@ Props 按用途分四组:
|
|
|
979
1059
|
|
|
980
1060
|
### AiChatWidget
|
|
981
1061
|
|
|
982
|
-
悬浮对话面板(FvAiChatWidget):Teleport 到 body,双形态——`drawer` 抽屉(默认:贴 position 侧全屏高,`offsetTop`/`offsetBottom` 各自留白)/ `floating` 悬窗(独立窗口,高度默认视口高 - 上下留白 - 80,可拖 header 自由移动,整窗限视口内不出界);宽度可经拖拽手柄调整(`minWidth`~`maxWidth`,默认 450~640px;抽屉仅内缘一个手柄,悬窗左右两缘均可调,拖左缘时窗口同步平移、右缘不动),拖拽落定经 localStorage 记忆(`storageKey` 自定义)。头部左侧「头像 + AI 名称」(默认内置品牌头像),右侧图标按钮均带 tooltip:「历史会话 + 新对话 + 模式切换 + 最大化 + 关闭」(模式切换按钮默认隐藏,`showModeToggle` 开启;隐藏时仍可拖 header 超 100px 转悬窗、悬窗贴边吸附回抽屉);点历史会话图标在对话区覆盖式下拉(层挂在 body 内,header 露出不遮挡;顶部「返回」工具条收层,内嵌 FvConversations:「今天/以往」分组 + hover 菜单重命名/删除 +
|
|
1062
|
+
悬浮对话面板(FvAiChatWidget):Teleport 到 body,双形态——`drawer` 抽屉(默认:贴 position 侧全屏高,`offsetTop`/`offsetBottom` 各自留白)/ `floating` 悬窗(独立窗口,高度默认视口高 - 上下留白 - 80,可拖 header 自由移动,整窗限视口内不出界);宽度可经拖拽手柄调整(`minWidth`~`maxWidth`,默认 450~640px;抽屉仅内缘一个手柄,悬窗左右两缘均可调,拖左缘时窗口同步平移、右缘不动),拖拽落定经 localStorage 记忆(`storageKey` 自定义)。头部左侧「头像 + AI 名称」(默认内置品牌头像),右侧图标按钮均带 tooltip:「历史会话 + 新对话 + 模式切换 + 最大化 + 关闭」(模式切换按钮默认隐藏,`showModeToggle` 开启;隐藏时仍可拖 header 超 100px 转悬窗、悬窗贴边吸附回抽屉);点历史会话图标在对话区覆盖式下拉(层挂在 body 内,header 露出不遮挡;顶部「返回」工具条收层,内嵌 FvConversations:「今天/以往」分组 + hover 菜单重命名/删除 + 触底分页,打开即拉取,点行切会话;service 实现文件夹方法(listFolders/moveSessions 等)时历史层自动切文件夹分组——文件夹行(图标/计数/三点菜单重命名/删除)+ 未分组平铺,会话可单条/批量移动到文件夹,与侧栏同口径);主体内嵌 FvAiChatPanel(常规态 welcomeLayout 固定 vertical、centerWelcome 固定 false 窄宽形态:欢迎页贴上、输入区贴底,建议列表为 FAQ 式行列表——行间细分隔线、行尾箭头指示、hover 底色对称淡入淡出)。**最大化**(`maximizable`,默认 true;关闭按钮左侧按钮,亦经 `toggleMaximize()` 编程式切换):inset 0 占满视口的覆盖态,退出后回到进入前的 drawer/floating 原形态;最大化态头部收敛(头像/标题/历史/新对话/模式切换隐藏,标识由侧栏品牌行承担,仅留还原/关闭;关闭面板即退出最大化,再开回常规形态),FvAiSessionSidebar 升为根级全高覆盖(选中/新建/删除/搜索/归档全能力,service/locale/品牌透传;默认收起为 44px 悬浮窄条、可展开 260px,对话区经 padding-left 让位/收回),Panel 欢迎页转横排 + 垂直居中,限宽三参回库默认 1160/1200/780px 聚焦中栏,建议列表转大屏胶囊横排;拖拽/调宽/头部按钮随态禁用。面板底带主色角部微光渐变(科技感,亮暗两态;暗色下透明度升档 + 边框调亮 + 投影加深,面板与同色系页面背景可分层)。会话编排收在内部:草稿哨兵起步、session-created 换真实 id 并刷历史列表、round-complete 延时 2.5s 刷列表。**关闭保活**(`keepAlive`,默认 true):关闭仅隐藏(v-show),实例/对话树原样保留,再开不重渲染、不重拉历史。
|
|
983
1063
|
|
|
984
1064
|
```vue
|
|
985
1065
|
<script setup lang="ts">
|
|
@@ -1104,6 +1184,23 @@ const open = ref(false) // 两个 v-model 接同一 ref
|
|
|
1104
1184
|
| default | 整体替换按钮内容(光晕层恒在,内容铺在光晕之上;存在时 #icon 不渲染) |
|
|
1105
1185
|
| icon | 覆盖按钮图标(默认内置品牌头像矢量图,圆形裁切铺满) |
|
|
1106
1186
|
|
|
1187
|
+
### FvAiFolderDialog(文件夹弹窗)
|
|
1188
|
+
|
|
1189
|
+
侧栏/悬浮窗历史层内部共用的文件夹弹窗,双形态:`name`(新建/重命名,输入框带 30 字上限与非空校验)与 `move`(会话移动,文件夹列表 + 关键字筛选,「未分组」恒在)。已公开导出,宿主可复用做同款交互。
|
|
1190
|
+
|
|
1191
|
+
| Prop | 类型 | 默认 | 说明 |
|
|
1192
|
+
| --- | --- | --- | --- |
|
|
1193
|
+
| visible | boolean | — | v-model:visible 显隐 |
|
|
1194
|
+
| mode | 'name' \| 'move' | — | 弹窗形态 |
|
|
1195
|
+
| title | string | 按 mode 取 locale | 标题(name 模式生效;move 恒用「移动到」) |
|
|
1196
|
+
| initialName | string | '' | name 模式回显值(重命名时传当前名) |
|
|
1197
|
+
| folders | FvAiFolder[] | [] | move 模式候选文件夹(未分组恒在列,不在此数组) |
|
|
1198
|
+
| locale | LocaleInput | undefined | 语言包 |
|
|
1199
|
+
|
|
1200
|
+
| Event | 说明 |
|
|
1201
|
+
| --- | --- |
|
|
1202
|
+
| confirm | name 模式:({ name });move 模式:({ folderId: string \| null })(null=移到未分组) |
|
|
1203
|
+
|
|
1107
1204
|
### FvAiSessionService(会话数据服务)
|
|
1108
1205
|
|
|
1109
1206
|
会话数据服务接口:宿主实现后经 prop 注入 FvAiSessionSidebar / FvAiChatPanel / FvAiChatWidget。库内不内置网络实现;错误提示(toast)由宿主胶水层统一承担(库对 service 失败:侧栏静默、面板空态重建)。
|
|
@@ -1117,31 +1214,67 @@ import type { FvAiSessionService, FvAiSessionPage, FvAiMessagePage } from '@fv-u
|
|
|
1117
1214
|
DRAFT_SESSION_ID // '__draft__'
|
|
1118
1215
|
|
|
1119
1216
|
interface FvAiSessionService {
|
|
1120
|
-
/** 会话列表(分页,updatedTime DESC;status 筛选与 keyword
|
|
1121
|
-
|
|
1217
|
+
/** 会话列表(分页,updatedTime DESC;status 筛选与 keyword 搜索正交同传;
|
|
1218
|
+
* folderId 三态过滤:不传/null=全部;0=仅未分组;>0=仅该文件夹) */
|
|
1219
|
+
list(q: { pageNum: number; pageSize: number; status?: 'ACTIVE' | 'ARCHIVED'; keyword?: string; folderId?: string | number | null }): Promise<FvAiSessionPage>
|
|
1122
1220
|
/** 新建会话,返回新会话 id */
|
|
1123
1221
|
create(): Promise<string>
|
|
1124
1222
|
/** 会话详情消息(尾部 limit 条,seq 升序) */
|
|
1125
1223
|
detail(sessionId: string, limit?: number): Promise<FvCommonMessage[]>
|
|
1126
|
-
/**
|
|
1127
|
-
|
|
1224
|
+
/**
|
|
1225
|
+
* 历史消息翻页(游标形态;q 兼容旧数字签名,等价 { cursor: q, direction: 'earlier' }):
|
|
1226
|
+
* - earlier(cursor):加载更早,取比首行 seq 早的 limit 条(游标 → 后端 beforeSeq)
|
|
1227
|
+
* - later(cursor):加载更新,取比末行 seq 新的 limit 条(游标 → 后端 afterSeq)
|
|
1228
|
+
* 游标取返回窗口边界行 seq(勿算术翻页);hasMore=false 即对应方向到头。
|
|
1229
|
+
* 首屏定位(锚不在 detail 窗口)走 historyAround(aroundSeq),勿用本方法
|
|
1230
|
+
*
|
|
1231
|
+
* 宿主实现经 normalizeHistoryQuery(q, limit) 归一化后按 direction 分流
|
|
1232
|
+
* beforeSeq/afterSeq;**AiChatPanel 消费侧约定**:earlier 传数字(兼容已发布
|
|
1233
|
+
* 的旧宿主实现),later 传游标对象
|
|
1234
|
+
*/
|
|
1235
|
+
history(
|
|
1236
|
+
sessionId: string,
|
|
1237
|
+
q: { cursor: number; direction: 'earlier' | 'later'; limit?: number } | number,
|
|
1238
|
+
limit?: number
|
|
1239
|
+
): Promise<FvAiMessagePage>
|
|
1128
1240
|
/** 重命名 */
|
|
1129
1241
|
rename(args: { sessionId: string; title: string }): Promise<void>
|
|
1130
1242
|
/** 删除 */
|
|
1131
1243
|
remove(sessionId: string): Promise<void>
|
|
1132
1244
|
/** 归档/恢复(可选;未实现时侧栏隐藏归档 tab 与菜单项) */
|
|
1133
1245
|
archive?(args: { sessionId: string; archived: boolean }): Promise<void>
|
|
1246
|
+
/** 文件夹列表(可选;createdTime 升序,ACTIVE 口径 sessionCount/ungroupedCount) */
|
|
1247
|
+
listFolders?(): Promise<FvAiFolderListResult>
|
|
1248
|
+
/** 新建文件夹(可选),返回 folderId;30016 重名 / 30018 超上限由宿主映射
|
|
1249
|
+
* (库内 locale 预留 duplicateFolderName/folderLimitExceeded 文案,宿主胶水
|
|
1250
|
+
* 可经 useLocaleDict 取用或自行映射错误码 toast) */
|
|
1251
|
+
createFolder?(name: string): Promise<string>
|
|
1252
|
+
/** 重命名文件夹(可选) */
|
|
1253
|
+
renameFolder?(args: { folderId: string; name: string }): Promise<void>
|
|
1254
|
+
/** 删除文件夹(可选;逻辑删,其中会话退回未分组,不级联删消息) */
|
|
1255
|
+
removeFolder?(folderId: string): Promise<void>
|
|
1256
|
+
/** 批量移动会话(可选;1~100,整体成败;folderId null/0=未分组)。
|
|
1257
|
+
* listFolders+moveSessions 均实现时侧栏启用文件夹模式(explorer 分组/CRUD/移动) */
|
|
1258
|
+
moveSessions?(args: { sessionIds: string[]; folderId?: string | null }): Promise<void>
|
|
1259
|
+
/** 内容搜索(可选;未实现时侧栏自动降级为纯标题搜索) */
|
|
1260
|
+
search?(q: { keyword: string; pageNum: number; pageSize: number }): Promise<FvAiSearchPage>
|
|
1261
|
+
/** 以锚点为中心开窗(可选;定位锚不在 detail 窗口时由面板调用) */
|
|
1262
|
+
historyAround?(sessionId: string, aroundSeq: number, limit?: number): Promise<FvAiAroundPage>
|
|
1134
1263
|
}
|
|
1135
1264
|
|
|
1136
1265
|
// 归一化形状(宿主 IPage 格式由胶水转换)
|
|
1137
1266
|
interface FvAiSessionPage { items: FvCommonSessionItem[]; hasMore: boolean }
|
|
1138
1267
|
interface FvAiMessagePage { messages: FvCommonMessage[]; hasMore: boolean }
|
|
1268
|
+
// 文件夹(单层、用户私有)
|
|
1269
|
+
interface FvAiFolder { folderId: string; name: string; createdTime?: string; sessionCount?: number }
|
|
1270
|
+
interface FvAiFolderListResult { folders: FvAiFolder[]; ungroupedCount?: number }
|
|
1139
1271
|
```
|
|
1140
1272
|
|
|
1141
1273
|
宿主胶水示例(det-oms 风格:list/create/detail/history/rename/remove 转发到宿主 httpRequest,并把后端 IPage 归一化为 { items, hasMore };**错误 toast 由胶水层承担**):
|
|
1142
1274
|
|
|
1143
1275
|
```ts
|
|
1144
1276
|
import { ElMessage } from 'element-plus'
|
|
1277
|
+
import { normalizeHistoryQuery } from '@fv-ui/ai-chat'
|
|
1145
1278
|
import type { FvAiSessionService } from '@fv-ui/ai-chat'
|
|
1146
1279
|
|
|
1147
1280
|
/** 宿主统一请求封装(JSON 返回;非 2xx/业务错误码直接 reject) */
|
|
@@ -1155,8 +1288,16 @@ export const sessionService: FvAiSessionService = {
|
|
|
1155
1288
|
create: () => httpRequest<{ id: string }>('/ai-chat/session/create').then((r) => r.id),
|
|
1156
1289
|
detail: (sessionId, limit = 100) =>
|
|
1157
1290
|
httpRequest('/ai-chat/session/detail', { sessionId, limit }),
|
|
1158
|
-
history: async (sessionId,
|
|
1159
|
-
|
|
1291
|
+
history: async (sessionId, q) => {
|
|
1292
|
+
// 旧签名宿主可只认数字 beforeSeq 入参(等价 { cursor: beforeSeq, direction: 'earlier' });
|
|
1293
|
+
// 新版消费方始终传 { cursor, direction, limit? } 游标对象,勿算术翻页
|
|
1294
|
+
const { cursor, direction, limit = 50 } = normalizeHistoryQuery(q)
|
|
1295
|
+
const page = await httpRequest('/ai-chat/session/history', {
|
|
1296
|
+
sessionId,
|
|
1297
|
+
beforeSeq: direction === 'earlier' ? cursor : undefined,
|
|
1298
|
+
afterSeq: direction === 'later' ? cursor : undefined,
|
|
1299
|
+
limit
|
|
1300
|
+
})
|
|
1160
1301
|
return { messages: page.records, hasMore: page.records.length >= limit }
|
|
1161
1302
|
},
|
|
1162
1303
|
rename: (args) => httpRequest('/ai-chat/session/rename', args),
|
|
@@ -1169,7 +1310,7 @@ export const sessionService: FvAiSessionService = {
|
|
|
1169
1310
|
|
|
1170
1311
|
### mapHistoryToNodes / sessionToConversationItem(历史回放映射)
|
|
1171
1312
|
|
|
1172
|
-
|
|
1313
|
+
`@fv-ui/ai-chat-core` 的 historyMapper 模块导出的两个纯映射函数(Fv 系后端消息行 → MessageNode 树 / FvConversations 项;经 `@fv-ui/ai-chat` 包出口 re-export,亦可直接 `import ... from '@fv-ui/ai-chat-core'`),独立使用时的签名:
|
|
1173
1314
|
|
|
1174
1315
|
```ts
|
|
1175
1316
|
import { mapHistoryToNodes, sessionToConversationItem, type AiChatT } from '@fv-ui/ai-chat'
|
|
@@ -1262,7 +1403,7 @@ const adapter = FvCommonAdapter({
|
|
|
1262
1403
|
|
|
1263
1404
|
### useXStream()
|
|
1264
1405
|
|
|
1265
|
-
SSE 流消费:`startStream({ readableStream, transformStream? })`、`cancel()`、`data: Ref<SSEEvent[]>`、`error`、`isLoading
|
|
1406
|
+
SSE 流消费:`startStream({ stream | readableStream, transformStream?, decodeText? })`、`cancel()`、`data: Ref<SSEEvent[]>`、`error`、`isLoading`。`readableStream` 为基线期 API 形参的兼容别名(与 `stream` 二选一,同时给时 `stream` 优先);web 端直接把 `ReadableStream<Uint8Array>` 传入即可(自带 `[Symbol.asyncIterator]` 既是字节源),uni-app 端传 async generator(直接产 string 不经解码)。内部完成 `\r\n`/跨 chunk 边界归一化与流末多字节残码冲刷。
|
|
1266
1407
|
|
|
1267
1408
|
### useSend() / XRequest
|
|
1268
1409
|
|