From cfc1ca8650d4905ed187b98ab532f00440bdebe0 Mon Sep 17 00:00:00 2001
From: wanghanlin <1533525126@qq.com>
Date: Fri, 26 Jun 2026 16:44:58 +0800
Subject: [PATCH] =?UTF-8?q?=20ChatSDK=20P1/P2=20=E5=8A=9F=E8=83=BD?=
=?UTF-8?q?=E5=B7=B2=E5=85=A8=E9=83=A8=E5=AE=9E=E7=8E=B0=E5=B9=B6=E4=BF=AE?=
=?UTF-8?q?=E5=A4=8D=E4=BA=86=E4=B8=89=E4=B8=AA=E6=A0=B8=E5=BF=83=20bug?=
=?UTF-8?q?=EF=BC=88integrateId=E2=86=92roleId=20=E6=98=A0=E5=B0=84?=
=?UTF-8?q?=E3=80=81chatId=20=20=20=E8=87=AA=E5=8A=A8=E7=AE=A1=E7=90=86?=
=?UTF-8?q?=E3=80=81=E5=AF=B9=E8=AF=9D=E5=8E=86=E5=8F=B2=E4=BB=8E=E5=90=8E?=
=?UTF-8?q?=E7=AB=AF=E5=8A=A0=E8=BD=BD=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
client/README.md | 361 ++--
client/dist/chatbot-sdk.js | 1715 +++++++++++++++--
client/dist/chatbot-sdk.js.map | 2 +-
client/dist/chatbot-sdk.min.js | 2 +-
client/dist/chatbot-sdk.min.js.map | 2 +-
client/src/api.ts | 437 ++++-
client/src/chat.ts | 346 +++-
client/src/config.ts | 23 +-
client/src/dom.ts | 275 ++-
client/src/i18n.ts | 152 ++
client/src/index.ts | 98 +-
client/src/logger.ts | 72 +-
client/src/markdown.ts | 212 ++
client/src/styles.ts | 362 ++++
client/src/types.ts | 68 +-
src/main/resources/static/sdk/chatbot-sdk.js | 1715 +++++++++++++++--
.../resources/static/sdk/chatbot-sdk.js.map | 2 +-
.../resources/static/sdk/chatbot-sdk.min.js | 2 +-
.../static/sdk/chatbot-sdk.min.js.map | 2 +-
src/main/resources/static/sdk/test.html | 681 ++-----
20 files changed, 5192 insertions(+), 1337 deletions(-)
create mode 100644 client/src/i18n.ts
create mode 100644 client/src/markdown.ts
diff --git a/client/README.md b/client/README.md
index 18d5bde..2f22246 100644
--- a/client/README.md
+++ b/client/README.md
@@ -1,6 +1,6 @@
# ChatbotSDK — 前端对接文档
-> P0 核心链路已完成 | 构建时间：2026-06-25 | 版本：1.0.0
+> P0 核心链路 ✅ | P1 体验增强 ✅ | P2 运营完善 ✅ | 版本：1.2.0 | 更新日期：2026-06-26
---
@@ -12,7 +12,7 @@
@@ -20,70 +20,21 @@
引入后在页面右下角出现悬浮客服按钮，点击即可对话。
-### 集成到现有项目
-
-SDK 产物位于 `client/dist/` 目录：
-
-| 文件 | 大小 | 说明 |
-|------|------|------|
-| `chatbot-sdk.js` | 47KB | 未压缩开发版（含 sourcemap） |
-| `chatbot-sdk.min.js` | 22KB | 压缩生产版（gzip ~8KB） |
-
-**部署路径：** 将 `.min.js` 文件上传到后端 `static/sdk/` 目录或任意 CDN。
-
----
-
-## 二、SDKConfig 完整参数
-
-| 参数 | 类型 | 必传 | 默认值 | 说明 |
-|------|------|------|--------|------|
-| `integrateId` | `string` | ✅ | — | 集成标识 → 后端 `chatId` + 数据隔离 key |
-| `requestDomain` | `string` | ✅ | — | 后端 API 域名（如 `https://ai.example.com`） |
-| `userId` | `string` | ❌ | — | 宿主用户标识 → 后端 `accountId` |
-| `roleId` | `number` | ❌ | — | 客服角色 ID |
-| `categoryId` | `number` | ❌ | — | 默认知识库分类 |
-| `showCategorySwitch` | `boolean` | ❌ | `false` | 是否显示知识库下拉 |
-| `title` | `string` | ❌ | `"AI 智能助手"` | 弹窗标题 |
-| `width` | `number` | ❌ | `380` | 弹窗宽度(px)，移动端自适应 |
-| `position` | `string` | ❌ | `"right-bottom"` | 悬浮按钮位置：`left-bottom` \| `right-bottom` |
-| `primaryColor` | `string` | ❌ | `"#4F46E5"` | 主色调（适用于按钮/用户气泡/链接） |
-| `launcherIcon` | `string` | ❌ | SVG 图标 | 悬浮按钮图标（URL 或 SVG 字符串） |
-| `showClear` | `boolean` | ❌ | `true` | 是否显示清空对话按钮 |
-| `showAdminPanel` | `boolean` | ❌ | `false` | 是否显示管理面板 |
-| `streaming` | `boolean` | ❌ | `true` | 是否启用 SSE 流式输出 |
-| `locale` | `string` | ❌ | `"zh-CN"` | 界面语言（预留） |
-| `debug` | `boolean` | ❌ | `true` | 是否输出调试日志 |
-
----
-
-## 三、公开 API
-
-| 方法 | 说明 |
-|------|------|
-| `ChatbotSDK.init(config)` | 初始化 SDK |
-| `ChatbotSDK.destroy()` | 销毁实例（清理 DOM + 样式 + 事件） |
-| `ChatbotSDK.open()` | 打开聊天窗口 |
-| `ChatbotSDK.close()` | 关闭聊天窗口 |
-| `ChatbotSDK.toggle()` | 切换窗口显示/隐藏 |
-| `ChatbotSDK.clearHistory()` | 清空当前会话 |
-
----
-
-## 四、完整接入示例
+### 完整配置接入
```html
```
+### 集成到现有项目
+
+SDK 产物位于 `client/dist/` 目录：
+
+| 文件 | 大小 | 说明 |
+|------|------|------|
+| `chatbot-sdk.js` | 93KB | 未压缩开发版（含 sourcemap） |
+| `chatbot-sdk.min.js` | 45KB | 压缩生产版（gzip ~15KB） |
+
+**部署路径：** 将 `.min.js` 文件上传到后端 `static/sdk/` 目录或任意 CDN。
+
---
-## 五、参数映射关系
+## 二、SDKConfig 完整参数
-SDK 入参与后端 API 参数对照：
+| 参数 | 类型 | 必传 | 默认值 | 阶段 | 说明 |
+|------|------|------|--------|------|------|
+| `integrateId` | `string \| number` | ✅ | — | P0 | 集成标识 → 后端 `roleId`（客服角色 ID，决定 AI 人设和知识库范围） |
+| `requestDomain` | `string` | ✅ | — | P0 | 后端 API 域名 |
+| `userId` | `string` | ❌ | — | P0 | 宿主用户标识 → 后端 `accountId` |
+| `roleId` | `number` | ❌ | — | P0 | 客服角色 ID |
+| `categoryId` | `number` | ❌ | — | P1 | 默认知识库分类 |
+| `showCategorySwitch` | `boolean` | ❌ | `false` | P1 | 是否显示知识库下拉切换 |
+| `title` | `string` | ❌ | `"AI 智能助手"` | P0 | 弹窗标题 |
+| `width` | `number` | ❌ | `380` | P0 | 弹窗宽度(px) |
+| `position` | `string` | ❌ | `"right-bottom"` | P0 | 悬浮按钮位置 |
+| `primaryColor` | `string` | ❌ | `"#4F46E5"` | P0 | 主色调 |
+| `launcherIcon` | `string` | ❌ | SVG 图标 | P0 | 悬浮按钮图标 |
+| `showClear` | `boolean` | ❌ | `true` | P0 | 是否显示清空按钮 |
+| `streaming` | `boolean` | ❌ | `true` | P0 | 是否启用 SSE 流式输出 |
+| `locale` | `string` | ❌ | `"zh-CN"` | P2 | 界面语言：`zh-CN` / `en` |
+| `debug` | `boolean` | ❌ | `true` | P0 | 是否输出调试日志 |
-| SDK 入参 | 后端参数 | 说明 |
-|----------|----------|------|
-| `integrateId` | `chatId` | 会话标识 + 数据隔离 key |
-| `userId` | `accountId` | 宿主用户标识 |
-| `roleId` | `roleId` | 客服角色 ID |
-| `categoryId` | `categoryId` | 知识库分类过滤 |
+---
+
+## 三、公开 API
+
+| 方法 | 阶段 | 说明 |
+|------|------|------|
+| `ChatbotSDK.init(config)` | P0 | 初始化 SDK |
+| `ChatbotSDK.destroy()` | P0 | 销毁实例（清理 DOM + 样式 + 事件） |
+| `ChatbotSDK.open()` | P0 | 打开聊天窗口 |
+| `ChatbotSDK.close()` | P0 | 关闭聊天窗口 |
+| `ChatbotSDK.toggle()` | P0 | 切换窗口显示/隐藏 |
+| `ChatbotSDK.clearHistory()` | P0 | 清空当前会话 |
---
-## 六、对接的后端接口
+## 四、P1 体验增强功能
-### 同步对话
-```
-GET /ai/assistant_app/chat/sync
- ?message={message}
- &chatId={integrateId}
- &accountId={userId}
- &roleId={roleId}
+### 4.1 SSE 流式打字机效果
+
+默认开启（`streaming: true`），AI 回复逐字输出，支持：
+- 流式追加到气泡，实时滚动到底部
+- 流中断兜底：保留已接收内容 + 灰色提示
+- 无流内容时自动降级为同步请求
+
+### 4.2 Markdown 渲染
+
+AI 回复支持 Markdown 格式渲染，包括：
+- 代码块（深色背景 ` ``` ` 语法）
+- 行内代码（`` `code` ``）
+- 标题（`##` `###` 等）
+- 粗体（`**text**`）、斜体（`*text*`）、删除线（`~~text~~`）
+- 有序/无序列表
+- 链接（`[text](url)`，仅允许 http/https 协议）
+- 引用块（`>` ）
+- 水平线（`---`）
+
+> **XSS 安全**：所有非代码块内容先转义 HTML，再转换 Markdown 语法为安全 HTML 标签。代码块内容同样转义。
+
+### 4.3 知识库联动
+
+开启 `showCategorySwitch: true` 后，输入区上方出现知识库分类下拉框：
+
+```html
+ChatbotSDK.init({
+ integrateId: 'my-app',
+ requestDomain: 'https://ai.example.com',
+ showCategorySwitch: true, // 显示分类下拉框
+ categoryId: 5, // 默认选中分类
+});
```
-### SSE 流式对话
+- 选择分类后，后续对话自动走 RAG 增强接口（`/ai/assistant_app/chat/rag/sse`）
+- 选择「全部分类」则走普通流式接口
+- 分类数据从 `/category/tree` 接口动态加载，支持树形缩进显示
+
+### 4.4 RAG 引用来源展示
+
+使用 RAG 对话后，AI 气泡底部自动展示引用来源卡片：
+
```
-GET /ai/assistant_app/chat/sse
- ?message={message}
- &chatId={integrateId}
- &accountId={userId}
- &roleId={roleId}
+┌─────────────────────────────────┐
+│ 📚 3 条参考来源 ▼ │
+├─────────────────────────────────┤
+│ 员工手册.pdf │
+│ 员工可以享受年假... │
+│ 员工手册.pdf · 分块 #3 · 85% │
+│ │
+│ HR制度.md │
+│ 年假计算规则如下... │
+│ HR制度.md · 分块 #1 · 72% │
+└─────────────────────────────────┘
```
-### RAG 增强对话（P1 阶段启用）
+- 默认折叠，只显示标题行，点击展开/折叠
+- 显示文档名称、摘要、来源文件、分块编号、相关度
+- 来源数据从 `/ai/assistant_app/rag/sources` 接口获取
+
+---
+
+## 五、P2 运营完善功能
+
+### 5.1 多语言国际化
+
+支持 `zh-CN`（中文）和 `en`（英文）两种语言：
+
+```html
+ChatbotSDK.init({
+ integrateId: 'my-app',
+ requestDomain: 'https://ai.example.com',
+ locale: 'en', // 英文界面
+});
```
-GET /ai/assistant_app/chat/rag/sse
- ?message={message}
- &chatId={integrateId}
- &categoryId={categoryId}
- &rewriteStrategy=REWRITE
+
+国际化覆盖范围：
+- 弹窗标题、输入框占位符、发送按钮
+- 最小化/关闭按钮提示
+- 清空对话按钮及确认弹窗
+- Loading 状态文字
+- 所有错误提示（网络/超时/服务器/跨域等）
+- 知识库下拉框默认选项
+- RAG 引用来源标题
+- 历史会话面板文本
+
+### 5.2 会话管理面板
+
+弹窗头部新增时钟图标按钮，点击展开历史会话面板：
+- 展示当前用户的历史会话列表（从 `/conversation/list` 接口获取）
+- 支持导出会话（下载文本文件）
+- 支持删除会话（二次确认）
+- 空状态提示
+
+### 5.3 控制台日志体系
+
+SDK 全流程结构化日志，带 `[ChatbotSDK]` 前缀：
+
+| 生命周期 | 日志内容 |
+|----------|---------|
+| `init()` | `初始化完成 integrateId={} requestDomain={}` |
+| `sendMessage()` | `发送消息 integrateId={} length={}` |
+| `收到回复` | `AI 回复 integrateId={} length={} duration={}ms` |
+| `流式完成` | `流式回复完成 integrateId={} length={} duration={}ms` |
+| `请求失败` | `请求失败 integrateId={} status={} message={}` |
+| `clearHistory()` | `清空会话 integrateId={}` |
+| `destroy()` | `销毁实例 integrateId={}` |
+| `分类切换` | `切换知识库分类 categoryId={}` |
+
+- `config.debug = false` 关闭 info/warn 日志，error 始终输出
+- 内置性能计时器，自动记录 AI 回复耗时
+
+---
+
+## 六、对接的后端接口
+
+### P0 — 基础对话
+```
+GET /ai/assistant_app/chat/sync
+GET /ai/assistant_app/chat/sse
```
-### RAG 引用来源（P1 阶段启用）
+### P1 — 知识库联动
```
-GET /ai/assistant_app/rag/sources
- ?message={message}
- &chatId={integrateId}
- &categoryId={categoryId}
+GET /ai/assistant_app/chat/rag/sse # RAG 增强流式对话
+GET /ai/assistant_app/rag/sources # RAG 引用来源
+GET /category/tree # 分类树（下拉框数据源）
+GET /category/list # 分类列表
```
-### 分类列表（P1 阶段启用）
+### P2 — 会话管理
```
-GET /category/list
-GET /category/tree
+GET /conversation/list # 会话列表
+GET /conversation/{id}/messages # 会话消息
+DELETE /conversation/{id} # 删除会话
+GET /conversation/{id}/export # 导出会话
```
---
-## 七、CSS 命名空间隔离
+## 七、参数映射关系
+
+**核心映射（SDK → 后端）：**
+
+| SDK 入参 | 后端参数 | 说明 |
+|----------|----------|------|
+| `integrateId` | `roleId` | 客服角色 ID（决定 AI 人设和知识库检索范围） |
+| `userId` | `accountId` | 客户账号 ID（账号可绑定角色，绑定后服务端覆盖 roleId） |
+| （自动管理） | `chatId` | 对话 ID（自动从 `/conversation/list` 获取或生成，格式 `sdk_时间戳_随机串`） |
+
+**chatId 自动管理逻辑：**
+1. SDK 初始化时，查询 `/conversation/list?accountId={userId}&roleId={integrateId}`
+2. 有匹配会话 → 使用最新会话的 `conversationId` 作为 `chatId`
+3. 无匹配会话 → 自动生成新 `chatId`（格式：`sdk_时间戳_随机串`）
+4. `chatId` 缓存在 localStorage（key: `csk_chatId_{integrateId}_{userId}`）
+5. `clearHistory()` 会生成新的 `chatId`，开始全新对话
+
+---
+
+## 八、CSS 命名空间隔离
所有 DOM 元素的 class/id 均使用 `csk-` 前缀，不会与宿主页面样式冲突：
@@ -173,13 +273,15 @@ GET /category/tree
| 消息区 | `#csk-messages` `.csk-messages` |
| 输入框 | `#csk-input` `.csk-input` |
| 发送按钮 | `#csk-send-btn` `.csk-send-btn` |
+| 知识库下拉 | `#csk-category-select` `.csk-category-select` |
+| 历史面板 | `.csk-history-panel` |
| 样式标签 | `style[data-csk-sdk]` |
z-index 分层：悬浮按钮 9998，弹窗 9999。
---
-## 八、localStorage 缓存
+## 九、localStorage 缓存
缓存 key 格式：`csk_history_{integrateId}`
@@ -191,7 +293,8 @@ z-index 分层：悬浮按钮 9998，弹窗 9999。
"id": "uuid",
"role": "user|ai",
"content": "消息内容",
- "timestamp": 1700000000000
+ "timestamp": 1700000000000,
+ "sources": []
}
],
"updatedAt": 1700000000000
@@ -201,40 +304,39 @@ z-index 分层：悬浮按钮 9998，弹窗 9999。
- 消息上限 200 条，超出自动裁剪最早 50 条
- 按 `integrateId` 隔离，不同接入方互不影响
- `init()` 时自动恢复历史消息
-- `clearHistory()` 清空本地缓存
+- RAG 引用来源同步缓存到 `sources` 字段
---
-## 九、错误处理
+## 十、错误处理
所有错误不抛异常、不阻塞宿主页面，仅 `console.error` 输出。
-| 错误场景 | 提示信息 |
-|----------|----------|
-| 缺失 `integrateId` | `integrateId 是必传参数` |
-| 缺失 `requestDomain` | `requestDomain 是必传参数` |
-| 非法 URL | `requestDomain 不是合法的 URL 格式` |
-| 网络断开 | `网络连接失败，请检查网络` |
-| 请求超时 | `请求超时，请稍后重试`（超时时间 30s） |
-| HTTP 401 | `鉴权失败，请联系管理员` |
-| HTTP 403 | `无访问权限，请联系管理员配置` |
-| HTTP 500 | `服务器异常，请稍后重试` |
-| 跨域阻断 | `跨域请求被拦截，请联系管理员将当前域名加入 API 白名单` |
-| localStorage 满 | `localStorage 空间不足，会话历史保存失败` |
+| 错误场景 | 中文提示 | 英文提示 |
+|----------|---------|---------|
+| 网络断开 | 网络连接失败，请检查网络 | Network connection failed |
+| 请求超时 | 请求超时，请稍后重试 | Request timed out |
+| HTTP 500 | 服务器异常，请稍后重试 | Server error |
+| 跨域阻断 | 跨域请求被拦截... | CORS request blocked... |
+| HTTP 401 | 鉴权失败，请联系管理员 | Authentication failed |
+| HTTP 403 | 无访问权限 | Access denied |
+| 流中断 | 回复被中断 | Response interrupted |
---
-## 十、技术栈
+## 十一、技术栈
- **语言**：TypeScript → ES2017
- **打包**：Rollup → IIFE 格式
- **压缩**：Terser
+- **Markdown**：内置轻量级渲染器（零外部依赖）
+- **国际化**：内置 i18n 字典
- **浏览器兼容**：Chrome 70+, Firefox 70+, Safari 13+, Edge 79+
-- **产物大小**：`.min.js` ~22KB（gzip ~8KB）
+- **产物大小**：`.min.js` ~45KB（gzip ~15KB）
---
-## 十一、开发与构建
+## 十二、开发与构建
```bash
# 进入 SDK 工程目录
@@ -258,17 +360,16 @@ client/
│ ├── index.ts # 入口：window.ChatbotSDK 挂载
│ ├── types.ts # TypeScript 类型定义
│ ├── config.ts # 配置解析 + 参数校验
-│ ├── logger.ts # 日志模块
+│ ├── logger.ts # 日志模块（P2 增强：计时+生命周期）
│ ├── storage.ts # localStorage 封装
-│ ├── api.ts # HTTP 封装 + SSE 流式
-│ ├── dom.ts # DOM 构建 + 拖拽
-│ ├── styles.ts # CSS 注入 + 主题定制
-│ ├── chat.ts # 对话核心
+│ ├── api.ts # HTTP 封装 + SSE 流式 + P1 RAG + P2 会话
+│ ├── dom.ts # DOM 构建 + 拖拽 + P1 来源/分类 + P2 面板
+│ ├── styles.ts # CSS 注入 + 主题 + P1 Markdown/来源 + P2 面板
+│ ├── chat.ts # 对话核心 + P1 Markdown/RAG + P2 i18n
+│ ├── markdown.ts # P1 轻量级 Markdown 渲染器
+│ ├── i18n.ts # P2 多语言国际化
│ └── utils.ts # UUID、防抖、XSS 转义
├── dist/ # 构建产物
-│ ├── chatbot-sdk.js
-│ ├── chatbot-sdk.min.js
-│ └── *.map
├── package.json
├── tsconfig.json
├── rollup.config.js
@@ -277,23 +378,25 @@ client/
---
-## 十二、P0 → P1 → P2 路线图
+## 十三、功能路线图
| 阶段 | 状态 | 内容 |
|------|------|------|
| **P0 核心链路** | ✅ 已完成 | 项目骨架、配置校验、样式注入、悬浮按钮+弹窗、HTTP 通信、对话核心、本地缓存、打包构建 |
-| **P1 体验增强** | 🔜 待开发 | SSE 流式打字机效果、知识库下拉切换、RAG 引用来源展示、UI 全配置化、Markdown 渲染、弹窗拖拽 |
-| **P2 运营完善** | 🔜 待开发 | 会话管理面板、控制台日志体系、多语言国际化、知识库管理嵌入 |
+| **P1 体验增强** | ✅ 已完成 | SSE 流式打字机、Markdown 渲染、知识库下拉切换、RAG 引用来源展示、UI 全配置化、弹窗拖拽 |
+| **P2 运营完善** | ✅ 已完成 | 多语言国际化（zh-CN/en）、控制台日志体系、会话管理面板（列表/导出/删除） |
+| **可选扩展** | 🔜 待定 | 知识库管理嵌入（`showAdminPanel`）、更多语言、主题皮肤 |
---
-## 十三、验证测试
+## 十四、验证测试
访问 `http://localhost:9090/sdk/test.html` 运行自动化验证。
-测试覆盖：
-1. ✅ `window.ChatbotSDK` 全局挂载
-2. ✅ 配置校验（必传参数 + 默认值 + 错误提示）
-3. ✅ DOM 挂载（悬浮按钮 + 弹窗 + 输入框 + 样式注入）
-4. ✅ localStorage 缓存读写
-5. ✅ 与后端 API 的实际对话（需后端运行）
+测试覆盖（22 个用例）：
+
+| 编号 | 阶段 | 功能 |
+|------|------|------|
+| T1-T13 | P0 | 全局挂载、参数校验、DOM 创建、open/close、默认值、主题色、位置、destroy、缓存、API 对话 |
+| T14-T19 | P1 | Markdown 样式、知识库分类切换、RAG 来源样式、RAG SSE 接口、RAG 来源接口、分类树接口 |
+| T20-T22 | P2 | 多语言国际化、会话管理面板、会话列表接口 |
diff --git a/client/dist/chatbot-sdk.js b/client/dist/chatbot-sdk.js
index 23eb255..8273324 100644
--- a/client/dist/chatbot-sdk.js
+++ b/client/dist/chatbot-sdk.js
@@ -7,14 +7,16 @@ var ChatbotSDK = (function () {
function setDebug(enabled) {
debugEnabled = enabled;
}
+ /** 性能计时器 */
+ const timers = {};
const logger = {
- /** 普通信息日志 */
+ /** 普通信息日志（受 debug 开关控制） */
info(msg, data) {
if (debugEnabled) {
console.log(PREFIX, msg, data !== undefined ? data : '');
}
},
- /** 警告日志 */
+ /** 警告日志（受 debug 开关控制） */
warn(msg, data) {
if (debugEnabled) {
console.warn(PREFIX, msg, data !== undefined ? data : '');
@@ -24,6 +26,60 @@ var ChatbotSDK = (function () {
error(msg, data) {
console.error(PREFIX, msg, data !== undefined ? data : '');
},
+ /** 开始计时 */
+ time(label) {
+ timers[label] = Date.now();
+ },
+ /** 结束计时并输出日志 */
+ timeEnd(label, prefix) {
+ const start = timers[label];
+ if (start !== undefined) {
+ const duration = Date.now() - start;
+ delete timers[label];
+ if (debugEnabled) {
+ const msg = prefix ? `${prefix} ${duration}ms` : `${label} ${duration}ms`;
+ console.log(PREFIX, msg);
+ }
+ return duration;
+ }
+ return 0;
+ },
+ /** 生命周期日志：init */
+ lifecycleInit(integrateId, requestDomain) {
+ this.info(`初始化完成 integrateId=${integrateId} requestDomain=${requestDomain}`);
+ },
+ /** 生命周期日志：destroy */
+ lifecycleDestroy(integrateId) {
+ this.info(`销毁实例 integrateId=${integrateId}`);
+ },
+ /** 生命周期日志：sendMessage */
+ lifecycleSend(integrateId, length) {
+ this.info(`发送消息 integrateId=${integrateId} length=${length}`);
+ this.time(`send_${integrateId}`);
+ },
+ /** 生命周期日志：收到回复 */
+ lifecycleReply(integrateId, length) {
+ const duration = this.timeEnd(`send_${integrateId}`, 'AI 回复');
+ this.info(`AI 回复 integrateId=${integrateId} length=${length} duration=${duration}ms`);
+ },
+ /** 生命周期日志：请求失败 */
+ lifecycleError(integrateId, status, message) {
+ this.timeEnd(`send_${integrateId}`);
+ this.error(`请求失败 integrateId=${integrateId} status=${status} message=${message}`);
+ },
+ /** 生命周期日志：清空会话 */
+ lifecycleClear(integrateId) {
+ this.info(`清空会话 integrateId=${integrateId}`);
+ },
+ /** 生命周期日志：流式回复完成 */
+ lifecycleStreamDone(integrateId, length) {
+ const duration = this.timeEnd(`send_${integrateId}`, '流式回复');
+ this.info(`流式回复完成 integrateId=${integrateId} length=${length} duration=${duration}ms`);
+ },
+ /** 生命周期日志：知识库切换 */
+ lifecycleCategoryChange(categoryId) {
+ this.info(`切换知识库分类 categoryId=${categoryId}`);
+ },
};
/** 默认悬浮按钮 SVG 图标（客服对话气泡） */
@@ -36,14 +92,15 @@ var ChatbotSDK = (function () {
*/
function parseConfig(raw) {
var _a, _b, _c, _d, _e, _f;
- // 校验必传参数：integrateId
- if (!raw.integrateId || typeof raw.integrateId !== 'string' || raw.integrateId.trim() === '') {
- logger.error('integrateId 是必传参数，请检查 init() 调用。示例：ChatbotSDK.init({ integrateId: "my-app", requestDomain: "https://api.example.com" })');
+ // 校验必传参数：integrateId（对应后端 roleId）
+ if (!raw.integrateId || (typeof raw.integrateId !== 'string' && typeof raw.integrateId !== 'number')
+ || (typeof raw.integrateId === 'string' && raw.integrateId.trim() === '')) {
+ logger.error('integrateId 是必传参数（对应后端 roleId 客服角色 ID），请检查 init() 调用。示例：ChatbotSDK.init({ integrateId: 1, requestDomain: "https://api.example.com" })');
return null;
}
// 校验必传参数：requestDomain
if (!raw.requestDomain || typeof raw.requestDomain !== 'string' || raw.requestDomain.trim() === '') {
- logger.error('requestDomain 是必传参数，请检查 init() 调用。示例：ChatbotSDK.init({ integrateId: "my-app", requestDomain: "https://api.example.com" })');
+ logger.error('requestDomain 是必传参数，请检查 init() 调用。示例：ChatbotSDK.init({ integrateId: 1, requestDomain: "https://api.example.com" })');
return null;
}
// 校验 requestDomain 是否为合法 URL 格式
@@ -54,12 +111,13 @@ var ChatbotSDK = (function () {
logger.error(`requestDomain 不是合法的 URL 格式：${raw.requestDomain}。请提供完整的域名，如 https://api.example.com`);
return null;
}
+ // integrateId 统一转为字符串（后端 roleId 为 Long，但 query param 传字符串也可接收）
+ const integrateIdStr = String(raw.integrateId).trim();
// 填充默认值
const config = {
- integrateId: raw.integrateId.trim(),
+ integrateId: integrateIdStr,
requestDomain: raw.requestDomain.replace(/\/+$/, ''), // 去掉末尾斜杠
userId: raw.userId,
- roleId: raw.roleId,
categoryId: raw.categoryId,
showCategorySwitch: (_a = raw.showCategorySwitch) !== null && _a !== void 0 ? _a : false,
title: raw.title || 'AI 智能助手',
@@ -72,11 +130,140 @@ var ChatbotSDK = (function () {
streaming: (_e = raw.streaming) !== null && _e !== void 0 ? _e : true,
locale: raw.locale || 'zh-CN',
debug: (_f = raw.debug) !== null && _f !== void 0 ? _f : true,
+ chatId: '', // 初始为空，由 chatId 初始化流程填充
};
- logger.info(`配置解析完成 integrateId=${config.integrateId} requestDomain=${config.requestDomain}`);
+ logger.info(`配置解析完成 integrateId(=roleId)=${config.integrateId} userId(=accountId)=${config.userId || '(未设置)'} requestDomain=${config.requestDomain}`);
return config;
}
+ /**
+ * 多语言国际化模块 - i18n 字典 + 翻译函数
+ */
+ /** 语言包字典 */
+ const dictionaries = {
+ 'zh-CN': {
+ // 头部
+ title: 'AI 智能助手',
+ minimize: '最小化',
+ close: '关闭',
+ // 输入区
+ placeholder: '输入您的问题...',
+ send: '发送',
+ // 消息
+ loading: '正在思考...',
+ stream_interrupted: '回复被中断',
+ stream_unstable: '网络不稳定，内容可能不完整',
+ // 知识库
+ category_placeholder: '选择知识库分类',
+ category_all: '全部分类',
+ category_load_error: '加载分类失败',
+ source_title: '参考来源',
+ source_count: '{n} 条参考来源',
+ source_loading: '加载来源中...',
+ // 清空/管理
+ clear: '清空对话',
+ clear_confirm: '确定清空所有对话记录？',
+ // 历史会话
+ history_title: '历史会话',
+ history_empty: '暂无历史会话',
+ history_load_error: '加载会话列表失败',
+ history_delete_confirm: '确定删除该会话？',
+ history_export: '导出',
+ history_delete: '删除',
+ // 错误提示
+ error_network: '网络连接失败，请检查网络',
+ error_timeout: '请求超时，请稍后重试',
+ error_server: '服务器异常，请稍后重试',
+ error_cors: '跨域请求被拦截，请联系管理员将当前域名加入 API 白名单',
+ error_auth: '鉴权失败，请联系管理员',
+ error_forbidden: '无访问权限，请联系管理员配置',
+ error_not_found: '请求的资源不存在',
+ error_rate_limit: '请求过于频繁，请稍后重试',
+ error_unavailable: '服务暂不可用，请稍后重试',
+ error_unknown: '请求发生未知错误',
+ error_send: '发送失败，请稍后重试',
+ error_stream_unsupported: '浏览器不支持流式读取',
+ },
+ 'en': {
+ // Header
+ title: 'AI Assistant',
+ minimize: 'Minimize',
+ close: 'Close',
+ // Input
+ placeholder: 'Type your question...',
+ send: 'Send',
+ // Messages
+ loading: 'Thinking...',
+ stream_interrupted: 'Response interrupted',
+ stream_unstable: 'Network unstable, content may be incomplete',
+ // Knowledge base
+ category_placeholder: 'Select category',
+ category_all: 'All categories',
+ category_load_error: 'Failed to load categories',
+ source_title: 'Sources',
+ source_count: '{n} source(s)',
+ source_loading: 'Loading sources...',
+ // Clear/Management
+ clear: 'Clear chat',
+ clear_confirm: 'Clear all conversation history?',
+ // History
+ history_title: 'History',
+ history_empty: 'No conversations yet',
+ history_load_error: 'Failed to load conversations',
+ history_delete_confirm: 'Delete this conversation?',
+ history_export: 'Export',
+ history_delete: 'Delete',
+ // Errors
+ error_network: 'Network connection failed',
+ error_timeout: 'Request timed out, please try again',
+ error_server: 'Server error, please try again later',
+ error_cors: 'CORS request blocked. Please contact admin to whitelist your domain',
+ error_auth: 'Authentication failed, please contact admin',
+ error_forbidden: 'Access denied, please contact admin',
+ error_not_found: 'Resource not found',
+ error_rate_limit: 'Too many requests, please try again later',
+ error_unavailable: 'Service temporarily unavailable',
+ error_unknown: 'Unknown request error',
+ error_send: 'Failed to send, please try again',
+ error_stream_unsupported: 'Browser does not support streaming',
+ },
+ };
+ /** 当前语言 */
+ let currentLocale = 'zh-CN';
+ /**
+ * 设置当前语言
+ */
+ function setLocale(locale) {
+ if (dictionaries[locale]) {
+ currentLocale = locale;
+ }
+ else {
+ // 尝试匹配语言前缀（如 zh -> zh-CN）
+ const prefix = locale.split('-')[0];
+ const matched = Object.keys(dictionaries).find(k => k.startsWith(prefix));
+ if (matched) {
+ currentLocale = matched;
+ }
+ // 未匹配则保持默认 zh-CN
+ }
+ }
+ /**
+ * 获取翻译文本
+ * @param key 翻译 key
+ * @param params 插值参数，如 { n: 3 } 替换 {n}
+ */
+ function t(key, params) {
+ const dict = dictionaries[currentLocale] || dictionaries['zh-CN'];
+ let text = dict[key] || dictionaries['zh-CN'][key] || key;
+ // 简单插值替换：{n} → 实际值
+ if (params) {
+ for (const [k, v] of Object.entries(params)) {
+ text = text.replace(`{${k}}`, String(v));
+ }
+ }
+ return text;
+ }
+
/** 请求超时时间（毫秒） */
const REQUEST_TIMEOUT = 30000;
let currentConfig = null;
@@ -84,6 +271,16 @@ var ChatbotSDK = (function () {
function setApiConfig(config) {
currentConfig = config;
}
+ /** 更新当前 chatId（对话 ID） */
+ function updateChatId(chatId) {
+ if (currentConfig) {
+ currentConfig.chatId = chatId;
+ }
+ }
+ /** 获取当前 chatId */
+ function getChatId() {
+ return (currentConfig === null || currentConfig === void 0 ? void 0 : currentConfig.chatId) || '';
+ }
/** 构建完整请求 URL，自动防御双斜杠 */
function buildUrl(path) {
if (!currentConfig) {
@@ -93,36 +290,72 @@ var ChatbotSDK = (function () {
const cleanPath = path.startsWith('/') ? path : `/${path}`;
return `${domain}${cleanPath}`;
}
- /** 构建同步对话请求 URL */
+ /**
+ * 安全设置可选参数：仅当 value 非空时追加
+ */
+ function setIfPresent(params, key, value) {
+ if (value === undefined || value === null)
+ return;
+ if (typeof value === 'string' && value.trim() === '')
+ return;
+ params.set(key, String(value));
+ }
+ // ==================== 对话接口 URL 构建 ====================
+ /**
+ * 构建同步对话请求 URL
+ * - integrateId → roleId
+ * - userId → accountId
+ * - chatId → 自动管理的对话 ID
+ */
function buildChatUrl(message) {
const params = new URLSearchParams();
params.set('message', message);
- params.set('chatId', currentConfig.integrateId);
+ params.set('chatId', currentConfig.chatId);
+ // integrateId 映射为 roleId
+ setIfPresent(params, 'roleId', currentConfig.integrateId);
+ // userId 映射为 accountId
setIfPresent(params, 'accountId', currentConfig.userId);
- setIfPresent(params, 'roleId', currentConfig.roleId);
- setIfPresent(params, 'categoryId', currentConfig.categoryId);
return buildUrl(`/ai/assistant_app/chat/sync?${params.toString()}`);
}
- /** 构建 SSE 流式请求 URL */
- function buildChatSSEUrl(message) {
+ /**
+ * 构建 SSE 流式请求 URL
+ */
+ function buildChatSSEUrl(message, categoryId) {
const params = new URLSearchParams();
params.set('message', message);
- params.set('chatId', currentConfig.integrateId);
+ params.set('chatId', currentConfig.chatId);
+ setIfPresent(params, 'roleId', currentConfig.integrateId);
setIfPresent(params, 'accountId', currentConfig.userId);
- setIfPresent(params, 'roleId', currentConfig.roleId);
- setIfPresent(params, 'categoryId', currentConfig.categoryId);
+ setIfPresent(params, 'categoryId', categoryId !== null && categoryId !== void 0 ? categoryId : currentConfig.categoryId);
return buildUrl(`/ai/assistant_app/chat/sse?${params.toString()}`);
}
/**
- * 安全设置可选参数：仅当 value 非空时追加，数字类型直接转字符串
+ * 构建 RAG 增强流式请求 URL
*/
- function setIfPresent(params, key, value) {
- if (value === undefined || value === null)
- return;
- if (typeof value === 'string' && value.trim() === '')
- return;
- params.set(key, String(value));
+ function buildChatRAGSSEUrl(message, categoryId) {
+ const params = new URLSearchParams();
+ params.set('message', message);
+ params.set('chatId', currentConfig.chatId);
+ params.set('rewriteStrategy', 'REWRITE');
+ setIfPresent(params, 'roleId', currentConfig.integrateId);
+ setIfPresent(params, 'accountId', currentConfig.userId);
+ setIfPresent(params, 'categoryId', categoryId !== null && categoryId !== void 0 ? categoryId : currentConfig.categoryId);
+ return buildUrl(`/ai/assistant_app/chat/rag/sse?${params.toString()}`);
+ }
+ /**
+ * 构建 RAG 引用来源请求 URL
+ */
+ function buildRagSourcesUrl(message, categoryId) {
+ const params = new URLSearchParams();
+ params.set('message', message);
+ params.set('chatId', currentConfig.chatId);
+ params.set('rewriteStrategy', 'REWRITE');
+ setIfPresent(params, 'roleId', currentConfig.integrateId);
+ setIfPresent(params, 'accountId', currentConfig.userId);
+ setIfPresent(params, 'categoryId', categoryId !== null && categoryId !== void 0 ? categoryId : currentConfig.categoryId);
+ return buildUrl(`/ai/assistant_app/rag/sources?${params.toString()}`);
}
+ // ==================== HTTP 基础封装 ====================
/** 带超时的 fetch 封装 */
async function safeFetch(url, options = {}, timeout = REQUEST_TIMEOUT) {
const controller = new AbortController();
@@ -133,12 +366,12 @@ var ChatbotSDK = (function () {
}
catch (err) {
if (err instanceof DOMException && err.name === 'AbortError') {
- throw new CskError('请求超时，请稍后重试', 'timeout');
+ throw new CskError(t('error_timeout'), 'timeout');
}
if (err instanceof TypeError && err.message.includes('Failed to fetch')) {
- throw new CskError('跨域请求被拦截，请联系管理员将当前域名加入 API 白名单', 'cors');
+ throw new CskError(t('error_cors'), 'cors');
}
- throw new CskError('网络连接失败，请检查网络', 'network');
+ throw new CskError(t('error_network'), 'network');
}
finally {
clearTimeout(timer);
@@ -152,77 +385,67 @@ var ChatbotSDK = (function () {
this.type = type;
}
}
- /** 根据 HTTP 状态码返回对应的中文错误消息 */
+ /** 根据 HTTP 状态码返回对应的国际化错误消息 */
function getHttpErrorMessage(status) {
switch (status) {
- case 401:
- return '鉴权失败，请联系管理员';
- case 403:
- return '无访问权限，请联系管理员配置';
- case 404:
- return '请求的资源不存在';
- case 429:
- return '请求过于频繁，请稍后重试';
- case 500:
- return '服务器异常，请稍后重试';
+ case 401: return t('error_auth');
+ case 403: return t('error_forbidden');
+ case 404: return t('error_not_found');
+ case 429: return t('error_rate_limit');
+ case 500: return t('error_server');
case 502:
- case 503:
- return '服务暂不可用，请稍后重试';
- default:
- return `请求失败（状态码 ${status}）`;
+ case 503: return t('error_unavailable');
+ default: return `${t('error_unknown')}（${status}）`;
}
}
+ // ==================== 对话请求 ====================
/**
* 同步对话请求
*/
async function chatRequest(message) {
const url = buildChatUrl(message);
- const startTime = Date.now();
- logger.info(`发送消息 integrateId=${currentConfig.integrateId} length=${message.length}`);
+ logger.lifecycleSend(currentConfig.integrateId, message.length);
try {
const response = await safeFetch(url);
if (!response.ok) {
const errorMsg = getHttpErrorMessage(response.status);
- logger.error(`请求失败 integrateId=${currentConfig.integrateId} status=${response.status} message=${errorMsg}`);
+ logger.lifecycleError(currentConfig.integrateId, String(response.status), errorMsg);
throw new CskError(errorMsg, `http_${response.status}`);
}
const text = await response.text();
- const duration = Date.now() - startTime;
- logger.info(`AI 回复 integrateId=${currentConfig.integrateId} length=${text.length} duration=${duration}ms`);
+ logger.lifecycleReply(currentConfig.integrateId, text.length);
return text;
}
catch (err) {
- if (err instanceof CskError) {
+ if (err instanceof CskError)
throw err;
- }
- logger.error(`请求异常 integrateId=${currentConfig.integrateId}`, err);
- throw new CskError('请求发生未知错误', 'unknown');
+ logger.lifecycleError(currentConfig.integrateId, 'unknown', String(err));
+ throw new CskError(t('error_unknown'), 'unknown');
}
}
/**
* SSE 流式对话请求
- * @param message 用户消息
- * @param onChunk 每次收到文本片段的回调
- * @param onDone 流结束时的回调
- * @param onError 发生错误时的回调
+ * @param useRag 是否使用 RAG 增强对话
+ * @param categoryId 知识库分类 ID
*/
- async function chatSSERequest(message, onChunk, onDone, onError) {
+ async function chatSSERequest(message, onChunk, onDone, onError, categoryId, useRag) {
var _a;
- const url = buildChatSSEUrl(message);
- const startTime = Date.now();
+ const url = useRag
+ ? buildChatRAGSSEUrl(message, categoryId)
+ : buildChatSSEUrl(message, categoryId);
let totalText = '';
- logger.info(`发送流式消息 integrateId=${currentConfig.integrateId} length=${message.length}`);
+ logger.lifecycleSend(currentConfig.integrateId, message.length);
try {
- const response = await safeFetch(url, {}, REQUEST_TIMEOUT * 2); // SSE 超时更长
+ const response = await safeFetch(url, {}, REQUEST_TIMEOUT * 2);
if (!response.ok) {
const errorMsg = getHttpErrorMessage(response.status);
- logger.error(`流式请求失败 integrateId=${currentConfig.integrateId} status=${response.status} message=${errorMsg}`);
+ logger.lifecycleError(currentConfig.integrateId, String(response.status), errorMsg);
onError(new CskError(errorMsg, `http_${response.status}`));
return;
}
const reader = (_a = response.body) === null || _a === void 0 ? void 0 : _a.getReader();
if (!reader) {
- onError(new CskError('浏览器不支持流式读取', 'stream_unsupported'));
+ onError(new CskError(t('error_stream_unsupported'), 'stream_unsupported'));
return;
}
const decoder = new TextDecoder('utf-8', { stream: true });
@@ -230,22 +453,15 @@ var ChatbotSDK = (function () {
try {
while (true) {
const { done, value } = await reader.read();
- if (done) {
+ if (done)
break;
- }
- // 解码并追加到 buffer
buffer += decoder.decode(value, { stream: true });
- // 按行解析 SSE 数据
const lines = buffer.split('\n');
- // 最后一行可能不完整，保留到下次
buffer = lines.pop() || '';
for (const line of lines) {
const trimmed = line.trim();
- if (!trimmed || trimmed.startsWith(':')) {
- // 跳过空行和 SSE 注释
+ if (!trimmed || trimmed.startsWith(':'))
continue;
- }
- // 解析 "data: xxx" 格式
if (trimmed.startsWith('data:')) {
const data = trimmed.substring(5).trim();
if (data) {
@@ -254,17 +470,14 @@ var ChatbotSDK = (function () {
}
}
else if (trimmed === '[DONE]') {
- // 流结束标记（OpenAI 风格，此处做兼容）
break;
}
else if (!trimmed.startsWith('event:') && !trimmed.startsWith('id:') && !trimmed.startsWith('retry:')) {
- // 可能是 Flux 裸文本格式（无 data: 前缀）
totalText += trimmed;
onChunk(trimmed);
}
}
}
- // 处理 buffer 中剩余的数据
if (buffer.trim()) {
const trimmed = buffer.trim();
if (trimmed.startsWith('data:')) {
@@ -281,9 +494,8 @@ var ChatbotSDK = (function () {
}
}
catch (readErr) {
- // 流中断不丢已接收的文本
if (totalText.length > 0) {
- onChunk('\n\n[网络不稳定，内容可能不完整]');
+ onChunk('\n\n' + t('stream_unstable'));
}
else {
throw readErr;
@@ -292,8 +504,7 @@ var ChatbotSDK = (function () {
finally {
reader.releaseLock();
}
- const duration = Date.now() - startTime;
- logger.info(`流式回复完成 integrateId=${currentConfig.integrateId} length=${totalText.length} duration=${duration}ms`);
+ logger.lifecycleStreamDone(currentConfig.integrateId, totalText.length);
onDone();
}
catch (err) {
@@ -301,11 +512,206 @@ var ChatbotSDK = (function () {
onError(err);
}
else {
- logger.error(`流式请求异常 integrateId=${currentConfig.integrateId}`, err);
- onError(new CskError('网络连接失败，请检查网络', 'network'));
+ logger.lifecycleError(currentConfig.integrateId, 'unknown', String(err));
+ onError(new CskError(t('error_network'), 'network'));
}
}
}
+ // ==================== P1: 知识库分类 ====================
+ /**
+ * 获取知识库分类树
+ */
+ async function fetchCategoryTree() {
+ const url = buildUrl('/category/tree');
+ try {
+ const response = await safeFetch(url);
+ if (!response.ok)
+ throw new CskError(getHttpErrorMessage(response.status), `http_${response.status}`);
+ const json = await response.json();
+ if (json.success && Array.isArray(json.data)) {
+ logger.info(`加载分类树成功 count=${json.data.length}`);
+ return json.data;
+ }
+ return [];
+ }
+ catch (err) {
+ if (err instanceof CskError)
+ logger.error(`加载分类树失败: ${err.message}`);
+ else
+ logger.error('加载分类树失败', err);
+ return [];
+ }
+ }
+ /**
+ * 获取 RAG 引用来源
+ */
+ async function fetchRagSources(message, categoryId) {
+ const url = buildRagSourcesUrl(message, categoryId);
+ try {
+ const response = await safeFetch(url);
+ if (!response.ok)
+ throw new CskError(getHttpErrorMessage(response.status), `http_${response.status}`);
+ const json = await response.json();
+ if (json.success && Array.isArray(json.data)) {
+ logger.info(`获取引用来源 count=${json.data.length}`);
+ return json.data;
+ }
+ return [];
+ }
+ catch (err) {
+ logger.error('获取引用来源失败', err);
+ return [];
+ }
+ }
+ /**
+ * 获取会话列表
+ */
+ async function fetchConversationList(page = 1, size = 20, accountId, roleId) {
+ let path = `/conversation/list?page=${page}&size=${size}`;
+ if (accountId)
+ path += `&accountId=${encodeURIComponent(accountId)}`;
+ if (roleId)
+ path += `&roleId=${encodeURIComponent(roleId)}`;
+ const url = buildUrl(path);
+ try {
+ const response = await safeFetch(url);
+ if (!response.ok)
+ throw new CskError(getHttpErrorMessage(response.status), `http_${response.status}`);
+ const json = await response.json();
+ return {
+ list: json.success && Array.isArray(json.data) ? json.data : [],
+ total: json.total || 0,
+ pages: json.pages || 0,
+ };
+ }
+ catch (err) {
+ logger.error('加载会话列表失败', err);
+ return { list: [], total: 0, pages: 0 };
+ }
+ }
+ /**
+ * 获取会话消息
+ */
+ async function fetchConversationMessages(conversationId) {
+ const url = buildUrl(`/conversation/${conversationId}/messages`);
+ try {
+ const response = await safeFetch(url);
+ if (!response.ok)
+ throw new CskError(getHttpErrorMessage(response.status), `http_${response.status}`);
+ const json = await response.json();
+ return {
+ messages: json.success && Array.isArray(json.data) ? json.data : [],
+ total: json.total || 0,
+ };
+ }
+ catch (err) {
+ logger.error('加载会话消息失败', err);
+ return { messages: [], total: 0 };
+ }
+ }
+ /**
+ * 删除会话
+ */
+ async function deleteConversation(conversationId) {
+ const url = buildUrl(`/conversation/${conversationId}`);
+ try {
+ const response = await safeFetch(url, { method: 'DELETE' });
+ if (!response.ok)
+ throw new CskError(getHttpErrorMessage(response.status), `http_${response.status}`);
+ const json = await response.json();
+ logger.info(`删除会话 id=${conversationId} success=${json.success}`);
+ return json.success || false;
+ }
+ catch (err) {
+ logger.error('删除会话失败', err);
+ return false;
+ }
+ }
+ /**
+ * 导出会话 URL
+ */
+ function getConversationExportUrl(conversationId) {
+ return buildUrl(`/conversation/${conversationId}/export`);
+ }
+ // ==================== chatId 自动初始化 ====================
+ /**
+ * 初始化 chatId：查询后端已有会话，找到则复用，否则生成新的
+ *
+ * 逻辑：
+ * 1. 先查 localStorage 缓存的 chatId（同一 integrateId + userId 可能复用）
+ * 2. 查 /conversation/list?accountId=X&roleId=Y 看是否有匹配的会话
+ * 3. 有会话 → 使用最新会话的 conversationId 作为 chatId
+ * 4. 无会话 → 自动生成 chatId（格式：sdk_timestamp_random）
+ */
+ async function initChatId() {
+ if (!currentConfig)
+ return '';
+ // 1. 先尝试从 localStorage 恢复
+ const cachedChatId = loadCachedChatId(currentConfig.integrateId, currentConfig.userId);
+ if (cachedChatId) {
+ currentConfig.chatId = cachedChatId;
+ logger.info(`从缓存恢复 chatId=${cachedChatId}`);
+ return cachedChatId;
+ }
+ // 2. 查询后端会话列表
+ try {
+ const result = await fetchConversationList(1, 5, currentConfig.userId, currentConfig.integrateId);
+ if (result.list.length > 0) {
+ // 使用最新会话的 conversationId 作为 chatId
+ const latestConv = result.list[0];
+ const chatId = latestConv.conversationId || latestConv.chatId || '';
+ if (chatId) {
+ currentConfig.chatId = chatId;
+ saveCachedChatId(currentConfig.integrateId, currentConfig.userId, chatId);
+ logger.info(`从后端恢复会话 chatId=${chatId} messageCount=${latestConv.messageCount}`);
+ return chatId;
+ }
+ }
+ }
+ catch (err) {
+ logger.warn('查询后端会话列表失败，将生成新 chatId', err);
+ }
+ // 3. 生成新的 chatId
+ const newChatId = generateChatId();
+ currentConfig.chatId = newChatId;
+ saveCachedChatId(currentConfig.integrateId, currentConfig.userId, newChatId);
+ logger.info(`生成新 chatId=${newChatId}`);
+ return newChatId;
+ }
+ /** 生成 chatId（格式：sdk_timestamp_random） */
+ function generateChatId() {
+ const random = typeof crypto !== 'undefined' && crypto.randomUUID
+ ? crypto.randomUUID().substring(0, 8)
+ : Math.random().toString(36).substring(2, 10);
+ return `sdk_${Date.now()}_${random}`;
+ }
+ /** localStorage key 格式 */
+ function chatIdStorageKey(integrateId, userId) {
+ return `csk_chatId_${integrateId}${userId ? '_' + userId : ''}`;
+ }
+ /** 从 localStorage 加载 chatId */
+ function loadCachedChatId(integrateId, userId) {
+ try {
+ return localStorage.getItem(chatIdStorageKey(integrateId, userId)) || '';
+ }
+ catch (_a) {
+ return '';
+ }
+ }
+ /** 保存 chatId 到 localStorage */
+ function saveCachedChatId(integrateId, userId, chatId) {
+ try {
+ if (chatId) {
+ localStorage.setItem(chatIdStorageKey(integrateId, userId), chatId);
+ }
+ else {
+ localStorage.removeItem(chatIdStorageKey(integrateId, userId));
+ }
+ }
+ catch (_a) {
+ // localStorage 不可用则忽略
+ }
+ }
let styleElement = null;
/** CSS 变量：将配置中的主题色转换为 CSS 自定义属性 */
@@ -601,6 +1007,366 @@ var ChatbotSDK = (function () {
color: #DC2626;
}
+/* ========== P1: 知识库分类下拉 ========== */
+.csk-category-bar {
+ display: flex;
+ align-items: center;
+ padding: 6px 12px;
+ border-top: 1px solid #E5E7EB;
+ background: #F9FAFB;
+ gap: 8px;
+}
+.csk-category-bar__label {
+ font-size: 12px;
+ color: #6B7280;
+ white-space: nowrap;
+}
+.csk-category-select {
+ flex: 1;
+ padding: 5px 8px;
+ border: 1px solid #E5E7EB;
+ border-radius: 6px;
+ font-size: 12px;
+ color: #374151;
+ background: #fff;
+ outline: none;
+ cursor: pointer;
+ font-family: inherit;
+ transition: border-color 0.2s;
+ max-width: 200px;
+}
+.csk-category-select:focus {
+ border-color: var(--csk-primary);
+}
+
+/* ========== P1: RAG 引用来源卡片 ========== */
+.csk-sources {
+ margin-top: 8px;
+ border: 1px solid #E5E7EB;
+ border-radius: 8px;
+ overflow: hidden;
+ font-size: 12px;
+ max-width: 100%;
+}
+.csk-sources__header {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 8px 12px;
+ background: #F9FAFB;
+ cursor: pointer;
+ user-select: none;
+ transition: background 0.15s;
+}
+.csk-sources__header:hover {
+ background: #F3F4F6;
+}
+.csk-sources__title {
+ display: flex;
+ align-items: center;
+ gap: 4px;
+ font-weight: 500;
+ color: #374151;
+}
+.csk-sources__arrow {
+ transition: transform 0.2s;
+ color: #9CA3AF;
+}
+.csk-sources--collapsed .csk-sources__arrow {
+ transform: rotate(-90deg);
+}
+.csk-sources__body {
+ border-top: 1px solid #E5E7EB;
+ padding: 0;
+}
+.csk-sources--collapsed .csk-sources__body {
+ display: none;
+}
+.csk-source-item {
+ padding: 8px 12px;
+ border-bottom: 1px solid #F3F4F6;
+ transition: background 0.15s;
+}
+.csk-source-item:last-child {
+ border-bottom: none;
+}
+.csk-source-item:hover {
+ background: #F9FAFB;
+}
+.csk-source-item__name {
+ font-weight: 500;
+ color: #1F2937;
+ margin-bottom: 2px;
+}
+.csk-source-item__snippet {
+ color: #6B7280;
+ line-height: 1.4;
+ overflow: hidden;
+ text-overflow: ellipsis;
+ display: -webkit-box;
+ -webkit-line-clamp: 2;
+ -webkit-box-orient: vertical;
+}
+.csk-source-item__meta {
+ font-size: 11px;
+ color: #9CA3AF;
+ margin-top: 2px;
+}
+
+/* ========== P1: Markdown 渲染样式 ========== */
+.csk-msg--ai .csk-msg__bubble .csk-md-p {
+ margin: 0 0 8px;
+}
+.csk-msg--ai .csk-msg__bubble .csk-md-p:last-child {
+ margin-bottom: 0;
+}
+.csk-msg--ai .csk-msg__bubble .csk-md-h1,
+.csk-msg--ai .csk-msg__bubble .csk-md-h2,
+.csk-msg--ai .csk-msg__bubble .csk-md-h3,
+.csk-msg--ai .csk-msg__bubble .csk-md-h4,
+.csk-msg--ai .csk-msg__bubble .csk-md-h5,
+.csk-msg--ai .csk-msg__bubble .csk-md-h6 {
+ margin: 12px 0 6px;
+ font-weight: 600;
+ line-height: 1.3;
+}
+.csk-msg--ai .csk-msg__bubble .csk-md-h1 { font-size: 20px; }
+.csk-msg--ai .csk-msg__bubble .csk-md-h2 { font-size: 17px; }
+.csk-msg--ai .csk-msg__bubble .csk-md-h3 { font-size: 15px; }
+.csk-msg--ai .csk-msg__bubble .csk-md-h4 { font-size: 14px; }
+
+.csk-md-code-block {
+ background: #1E293B;
+ color: #E2E8F0;
+ padding: 12px 14px;
+ border-radius: 8px;
+ overflow-x: auto;
+ margin: 8px 0;
+ font-size: 13px;
+ line-height: 1.5;
+ font-family: 'SF Mono', 'Consolas', 'Menlo', monospace;
+}
+.csk-md-code-block code {
+ background: none;
+ padding: 0;
+ border-radius: 0;
+ font-size: inherit;
+ color: inherit;
+}
+.csk-md-inline-code {
+ background: #E5E7EB;
+ color: #DC2626;
+ padding: 1px 6px;
+ border-radius: 4px;
+ font-size: 13px;
+ font-family: 'SF Mono', 'Consolas', 'Menlo', monospace;
+}
+.csk-msg--ai .csk-msg__bubble .csk-md-ul,
+.csk-msg--ai .csk-msg__bubble .csk-md-ol {
+ padding-left: 20px;
+ margin: 6px 0;
+}
+.csk-msg--ai .csk-msg__bubble .csk-md-ul li,
+.csk-msg--ai .csk-msg__bubble .csk-md-ol li {
+ margin-bottom: 4px;
+}
+.csk-md-blockquote {
+ border-left: 3px solid var(--csk-primary);
+ padding-left: 12px;
+ margin: 8px 0;
+ color: #6B7280;
+}
+.csk-md-link {
+ color: var(--csk-primary);
+ text-decoration: none;
+}
+.csk-md-link:hover {
+ text-decoration: underline;
+}
+.csk-md-hr {
+ border: none;
+ border-top: 1px solid #E5E7EB;
+ margin: 12px 0;
+}
+
+/* ========== P2: 会话管理面板 ========== */
+.csk-history-btn {
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ width: 32px;
+ height: 32px;
+ border: none;
+ background: transparent;
+ color: #fff;
+ cursor: pointer;
+ border-radius: 6px;
+ transition: background 0.15s;
+}
+.csk-history-btn:hover {
+ background: rgba(255, 255, 255, 0.2);
+}
+.csk-history-panel {
+ position: absolute;
+ top: 48px;
+ left: 0;
+ right: 0;
+ bottom: 0;
+ background: #fff;
+ z-index: 10;
+ display: flex;
+ flex-direction: column;
+ overflow: hidden;
+}
+.csk-history-panel--hidden {
+ display: none;
+}
+.csk-history-panel__header {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 12px 16px;
+ border-bottom: 1px solid #E5E7EB;
+ background: #F9FAFB;
+}
+.csk-history-panel__title {
+ font-size: 14px;
+ font-weight: 600;
+ color: #1F2937;
+}
+.csk-history-panel__back {
+ display: flex;
+ align-items: center;
+ gap: 4px;
+ padding: 4px 10px;
+ border: 1px solid #E5E7EB;
+ border-radius: 6px;
+ background: #fff;
+ color: #374151;
+ font-size: 12px;
+ cursor: pointer;
+ transition: all 0.15s;
+}
+.csk-history-panel__back:hover {
+ background: #F3F4F6;
+}
+.csk-history-panel__list {
+ flex: 1;
+ overflow-y: auto;
+ padding: 8px;
+}
+.csk-history-panel__list::-webkit-scrollbar {
+ width: 4px;
+}
+.csk-history-panel__list::-webkit-scrollbar-thumb {
+ background: #E5E7EB;
+ border-radius: 2px;
+}
+.csk-history-item {
+ display: flex;
+ align-items: center;
+ justify-content: space-between;
+ padding: 10px 12px;
+ border-radius: 8px;
+ cursor: pointer;
+ transition: background 0.15s;
+ margin-bottom: 4px;
+}
+.csk-history-item:hover {
+ background: #F3F4F6;
+}
+.csk-history-item__info {
+ flex: 1;
+ min-width: 0;
+}
+.csk-history-item__id {
+ font-size: 13px;
+ font-weight: 500;
+ color: #1F2937;
+ overflow: hidden;
+ text-overflow: ellipsis;
+ white-space: nowrap;
+}
+.csk-history-item__meta {
+ font-size: 11px;
+ color: #9CA3AF;
+ margin-top: 2px;
+}
+.csk-history-item__actions {
+ display: flex;
+ gap: 4px;
+ margin-left: 8px;
+ opacity: 0;
+ transition: opacity 0.15s;
+}
+.csk-history-item:hover .csk-history-item__actions {
+ opacity: 1;
+}
+.csk-history-action {
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ width: 28px;
+ height: 28px;
+ border: none;
+ border-radius: 6px;
+ cursor: pointer;
+ font-size: 12px;
+ transition: all 0.15s;
+}
+.csk-history-action--export {
+ background: #EFF6FF;
+ color: #2563EB;
+}
+.csk-history-action--export:hover {
+ background: #DBEAFE;
+}
+.csk-history-action--delete {
+ background: #FEF2F2;
+ color: #DC2626;
+}
+.csk-history-action--delete:hover {
+ background: #FEE2E2;
+}
+.csk-history-panel__empty {
+ display: flex;
+ flex-direction: column;
+ align-items: center;
+ justify-content: center;
+ padding: 40px 20px;
+ color: #9CA3AF;
+ font-size: 13px;
+ text-align: center;
+}
+.csk-history-panel__empty-icon {
+ font-size: 32px;
+ margin-bottom: 8px;
+ opacity: 0.5;
+}
+.csk-history-panel__loading {
+ display: flex;
+ align-items: center;
+ justify-content: center;
+ padding: 20px;
+ color: #9CA3AF;
+ font-size: 13px;
+}
+.csk-history-panel__loadmore {
+ display: block;
+ width: 100%;
+ padding: 10px;
+ border: none;
+ background: #F9FAFB;
+ color: #6B7280;
+ font-size: 12px;
+ cursor: pointer;
+ text-align: center;
+ transition: background 0.15s;
+}
+.csk-history-panel__loadmore:hover {
+ background: #F3F4F6;
+}
+
/* ========== 移动端适配 ========== */
@media (max-width: 480px) {
.csk-window {
@@ -658,6 +1424,17 @@ var ChatbotSDK = (function () {
return v.toString(16);
});
}
+ /** XSS 转义 - 防止用户输入中的 HTML 注入 */
+ function escapeHtml(text) {
+ const map = {
+ '&': '&',
+ '<': '<',
+ '>': '>',
+ '"': '"',
+ "'": ''',
+ };
+ return text.replace(/[&<>"']/g, (ch) => map[ch] || ch);
+ }
/** 防抖函数 */
function debounce(fn, delay) {
let timer = null;
@@ -715,10 +1492,15 @@ var ChatbotSDK = (function () {
titleEl.textContent = config.title;
const actions = document.createElement('div');
actions.className = 'csk-header__actions';
+ // 历史会话按钮（P2）
+ const historyBtn = document.createElement('button');
+ historyBtn.className = 'csk-history-btn';
+ historyBtn.setAttribute('title', t('history_title'));
+ historyBtn.innerHTML = ``;
// 最小化按钮
const minimizeBtn = document.createElement('button');
minimizeBtn.className = 'csk-header__btn csk-header__btn--minimize';
- minimizeBtn.setAttribute('title', '最小化');
+ minimizeBtn.setAttribute('title', t('minimize'));
minimizeBtn.innerHTML = ``;
minimizeBtn.addEventListener('click', () => {
windowEl.classList.add('csk-window--hidden');
@@ -726,11 +1508,12 @@ var ChatbotSDK = (function () {
// 关闭按钮
const closeBtn = document.createElement('button');
closeBtn.className = 'csk-header__btn csk-header__btn--close';
- closeBtn.setAttribute('title', '关闭');
+ closeBtn.setAttribute('title', t('close'));
closeBtn.innerHTML = ``;
closeBtn.addEventListener('click', () => {
windowEl.classList.add('csk-window--hidden');
});
+ actions.appendChild(historyBtn);
actions.appendChild(minimizeBtn);
actions.appendChild(closeBtn);
header.appendChild(titleEl);
@@ -739,35 +1522,93 @@ var ChatbotSDK = (function () {
const messagesContainer = document.createElement('div');
messagesContainer.id = 'csk-messages';
messagesContainer.className = 'csk-messages';
+ // === 会话管理面板（P2，默认隐藏） ===
+ const historyPanel = document.createElement('div');
+ historyPanel.className = 'csk-history-panel csk-history-panel--hidden';
+ historyPanel.innerHTML = `
+
+
+ `;
+ messagesContainer.appendChild(historyPanel);
+ // 历史面板返回按钮
+ const backBtn = historyPanel.querySelector('#csk-history-back');
+ if (backBtn) {
+ backBtn.addEventListener('click', () => {
+ historyPanel.classList.add('csk-history-panel--hidden');
+ });
+ }
+ // 历史按钮点击
+ historyBtn.addEventListener('click', (e) => {
+ e.stopPropagation();
+ const isHidden = historyPanel.classList.contains('csk-history-panel--hidden');
+ historyPanel.classList.toggle('csk-history-panel--hidden');
+ if (isHidden) {
+ // 触发自定义事件，通知加载会话列表
+ windowEl.dispatchEvent(new CustomEvent('csk:loadHistory'));
+ }
+ });
+ // === 知识库分类下拉框（P1） ===
+ let categorySelect = null;
+ if (config.showCategorySwitch) {
+ const categoryBar = document.createElement('div');
+ categoryBar.className = 'csk-category-bar';
+ const categoryLabel = document.createElement('span');
+ categoryLabel.className = 'csk-category-bar__label';
+ categoryLabel.textContent = '📚';
+ categorySelect = document.createElement('select');
+ categorySelect.id = 'csk-category-select';
+ categorySelect.className = 'csk-category-select';
+ categorySelect.innerHTML = ``;
+ // onChange 触发自定义事件
+ categorySelect.addEventListener('change', () => {
+ const selectedId = categorySelect.value;
+ windowEl.dispatchEvent(new CustomEvent('csk:categoryChange', {
+ detail: { categoryId: selectedId ? Number(selectedId) : undefined }
+ }));
+ });
+ categoryBar.appendChild(categoryLabel);
+ categoryBar.appendChild(categorySelect);
+ // 插入到 messages 和 inputArea 之间
+ windowEl.appendChild(header);
+ windowEl.appendChild(messagesContainer);
+ windowEl.appendChild(categoryBar);
+ }
+ else {
+ windowEl.appendChild(header);
+ windowEl.appendChild(messagesContainer);
+ }
// === 输入区 ===
const inputArea = document.createElement('div');
inputArea.className = 'csk-input-area';
const inputEl = document.createElement('textarea');
inputEl.id = 'csk-input';
inputEl.className = 'csk-input';
- inputEl.setAttribute('placeholder', '输入您的问题...');
+ inputEl.setAttribute('placeholder', t('placeholder'));
inputEl.setAttribute('rows', '1');
inputEl.setAttribute('autofocus', '');
const sendBtn = document.createElement('button');
sendBtn.id = 'csk-send-btn';
sendBtn.className = 'csk-send-btn';
- sendBtn.setAttribute('title', '发送');
+ sendBtn.setAttribute('title', t('send'));
sendBtn.setAttribute('disabled', 'true');
sendBtn.innerHTML = ``;
inputArea.appendChild(inputEl);
inputArea.appendChild(sendBtn);
- // === 组装 ===
- windowEl.appendChild(header);
- windowEl.appendChild(messagesContainer);
windowEl.appendChild(inputArea);
// 清空按钮（可选）
let clearBtn = null;
if (config.showClear) {
clearBtn = document.createElement('button');
clearBtn.className = 'csk-clear-btn';
- clearBtn.textContent = '清空对话';
+ clearBtn.textContent = t('clear');
clearBtn.style.display = 'none'; // 初始隐藏，有消息后才显示
- // 插入到 messages 之后、inputArea 之前
+ // 插入到 categoryBar/inputArea 之前
windowEl.insertBefore(clearBtn, inputArea);
}
// === Loading 动画 ===
@@ -800,6 +1641,8 @@ var ChatbotSDK = (function () {
inputEl,
sendBtn,
clearBtn,
+ categorySelect,
+ historyPanel,
showLoading,
hideLoading,
};
@@ -864,13 +1707,19 @@ var ChatbotSDK = (function () {
container.appendChild(wrapper);
return wrapper;
}
- /** 渲染 AI 消息气泡 */
- function renderAIBubble(container, text, timestamp) {
+ /** 渲染 AI 消息气泡（支持 Markdown） */
+ function renderAIBubble(container, text, timestamp, renderMd) {
const wrapper = document.createElement('div');
wrapper.className = 'csk-msg csk-msg--ai';
const bubble = document.createElement('div');
bubble.className = 'csk-msg__bubble';
- bubble.textContent = text;
+ // 支持 Markdown 渲染，传入渲染函数则使用，否则纯文本
+ if (renderMd) {
+ bubble.innerHTML = renderMd(text);
+ }
+ else {
+ bubble.textContent = text;
+ }
const time = document.createElement('div');
time.className = 'csk-msg__time';
time.textContent = formatTime(timestamp);
@@ -894,6 +1743,132 @@ var ChatbotSDK = (function () {
container.appendChild(wrapper);
return { wrapper, bubble };
}
+ // ==================== P1: RAG 引用来源渲染 ====================
+ /** 渲染 RAG 引用来源卡片 */
+ function renderSources(wrapper, sources) {
+ // 移除已有的来源卡片
+ const existing = wrapper.querySelector('.csk-sources');
+ if (existing)
+ existing.remove();
+ if (!sources || sources.length === 0)
+ return;
+ const sourcesEl = document.createElement('div');
+ sourcesEl.className = 'csk-sources csk-sources--collapsed';
+ // 头部
+ const header = document.createElement('div');
+ header.className = 'csk-sources__header';
+ const titleSpan = document.createElement('span');
+ titleSpan.className = 'csk-sources__title';
+ titleSpan.textContent = `📚 ${t('source_count', { n: sources.length })}`;
+ const arrow = document.createElement('span');
+ arrow.className = 'csk-sources__arrow';
+ arrow.textContent = '▼';
+ header.appendChild(titleSpan);
+ header.appendChild(arrow);
+ // 点击折叠/展开
+ header.addEventListener('click', () => {
+ sourcesEl.classList.toggle('csk-sources--collapsed');
+ });
+ // 内容
+ const body = document.createElement('div');
+ body.className = 'csk-sources__body';
+ for (const src of sources) {
+ const item = document.createElement('div');
+ item.className = 'csk-source-item';
+ const name = document.createElement('div');
+ name.className = 'csk-source-item__name';
+ name.textContent = src.title || src.sourceName || '未知文档';
+ if (src.snippet) {
+ const snippet = document.createElement('div');
+ snippet.className = 'csk-source-item__snippet';
+ snippet.textContent = src.snippet;
+ item.appendChild(snippet);
+ }
+ const meta = document.createElement('div');
+ meta.className = 'csk-source-item__meta';
+ const metaParts = [];
+ if (src.sourceName)
+ metaParts.push(src.sourceName);
+ if (src.chunkIndex !== undefined)
+ metaParts.push(`分块 #${src.chunkIndex}`);
+ if (src.score !== undefined)
+ metaParts.push(`相关度 ${(src.score * 100).toFixed(0)}%`);
+ meta.textContent = metaParts.join(' · ');
+ item.appendChild(name);
+ item.appendChild(meta);
+ body.appendChild(item);
+ }
+ sourcesEl.appendChild(header);
+ sourcesEl.appendChild(body);
+ // 插入到气泡和时间戳之间
+ const timeEl = wrapper.querySelector('.csk-msg__time');
+ if (timeEl) {
+ wrapper.insertBefore(sourcesEl, timeEl);
+ }
+ else {
+ wrapper.appendChild(sourcesEl);
+ }
+ }
+ /** 渲染会话列表 */
+ function renderHistoryList(listEl, items, onExport, onDelete, emptyText) {
+ listEl.innerHTML = '';
+ if (items.length === 0) {
+ const empty = document.createElement('div');
+ empty.className = 'csk-history-panel__empty';
+ empty.innerHTML = `
+ 💬
+ ${t('history_empty')}
+ `;
+ listEl.appendChild(empty);
+ return;
+ }
+ for (const item of items) {
+ const el = document.createElement('div');
+ el.className = 'csk-history-item';
+ const info = document.createElement('div');
+ info.className = 'csk-history-item__info';
+ const idEl = document.createElement('div');
+ idEl.className = 'csk-history-item__id';
+ idEl.textContent = item.chatId || item.id;
+ const metaEl = document.createElement('div');
+ metaEl.className = 'csk-history-item__meta';
+ const metaParts = [];
+ if (item.messageCount !== undefined)
+ metaParts.push(`${item.messageCount} 条消息`);
+ if (item.lastMessageTime)
+ metaParts.push(item.lastMessageTime);
+ else if (item.createdAt)
+ metaParts.push(item.createdAt);
+ metaEl.textContent = metaParts.join(' · ');
+ info.appendChild(idEl);
+ info.appendChild(metaEl);
+ const actionsEl = document.createElement('div');
+ actionsEl.className = 'csk-history-item__actions';
+ // 导出按钮
+ const exportBtn = document.createElement('button');
+ exportBtn.className = 'csk-history-action csk-history-action--export';
+ exportBtn.setAttribute('title', t('history_export'));
+ exportBtn.innerHTML = ``;
+ exportBtn.addEventListener('click', (e) => {
+ e.stopPropagation();
+ onExport(item.id);
+ });
+ // 删除按钮
+ const deleteBtn = document.createElement('button');
+ deleteBtn.className = 'csk-history-action csk-history-action--delete';
+ deleteBtn.setAttribute('title', t('history_delete'));
+ deleteBtn.innerHTML = ``;
+ deleteBtn.addEventListener('click', (e) => {
+ e.stopPropagation();
+ onDelete(item.id);
+ });
+ actionsEl.appendChild(exportBtn);
+ actionsEl.appendChild(deleteBtn);
+ el.appendChild(info);
+ el.appendChild(actionsEl);
+ listEl.appendChild(el);
+ }
+ }
/** 滚动消息区到底部 */
function scrollToBottom(container) {
container.scrollTop = container.scrollHeight;
@@ -972,15 +1947,208 @@ var ChatbotSDK = (function () {
}
}
+ /**
+ * 轻量级 Markdown 渲染器 - 无外部依赖，XSS 安全
+ *
+ * 支持：代码块、行内代码、标题、粗体、斜体、列表、链接、引用、段落
+ * 策略：先转义 HTML，再转 Markdown 为安全 HTML 标签
+ */
+ /** 代码块占位符前缀 */
+ const CODE_BLOCK_PREFIX = '\x00CODEBLOCK_';
+ /** 行内代码占位符前缀 */
+ const INLINE_CODE_PREFIX = '\x00INLINECODE_';
+ /**
+ * 渲染 Markdown 文本为安全 HTML
+ * @param text Markdown 源文本
+ * @returns 安全 HTML 字符串
+ */
+ function renderMarkdown(text) {
+ if (!text || typeof text !== 'string')
+ return '';
+ // 1. 提取代码块（防止内部 Markdown 被处理）
+ const codeBlocks = [];
+ let processed = text;
+ // 提取围栏代码块 ```
+ processed = processed.replace(/```(\w*)\n([\s\S]*?)```/g, (_match, lang, code) => {
+ const idx = codeBlocks.length;
+ const escapedCode = escapeHtml(code.trimEnd());
+ const langClass = lang ? ` class="language-${escapeHtml(lang)}"` : '';
+ codeBlocks.push(`${escapedCode}
`);
+ return `${CODE_BLOCK_PREFIX}${idx}\x00`;
+ });
+ // 2. 提取行内代码
+ const inlineCodes = [];
+ processed = processed.replace(/`([^`\n]+)`/g, (_match, code) => {
+ const idx = inlineCodes.length;
+ inlineCodes.push(`${escapeHtml(code)}`);
+ return `${INLINE_CODE_PREFIX}${idx}\x00`;
+ });
+ // 3. 转义剩余 HTML（代码块和行内代码已安全处理）
+ processed = escapeHtml(processed);
+ // 4. 还原代码块和行内代码占位符（它们已经是安全 HTML）
+ processed = restorePlaceholders(processed, CODE_BLOCK_PREFIX, codeBlocks);
+ processed = restorePlaceholders(processed, INLINE_CODE_PREFIX, inlineCodes);
+ // 5. 逐行处理 Markdown 语法
+ const lines = processed.split('\n');
+ const result = [];
+ let inList = false;
+ let listType = ''; // 'ul' 或 'ol'
+ let inBlockquote = false;
+ let paragraphBuffer = [];
+ for (let i = 0; i < lines.length; i++) {
+ const line = lines[i];
+ // 代码块已在占位符还原阶段处理，直接输出
+ if (line.includes(CODE_BLOCK_PREFIX) || line.includes('')) {
+ flushParagraph();
+ closeList();
+ closeBlockquote();
+ result.push(line);
+ continue;
+ }
+ // 标题
+ const headingMatch = line.match(/^(#{1,6})\s+(.+)/);
+ if (headingMatch) {
+ flushParagraph();
+ closeList();
+ closeBlockquote();
+ const level = headingMatch[1].length;
+ result.push(`${headingMatch[2]}`);
+ continue;
+ }
+ // 引用
+ const quoteMatch = line.match(/^>\s?(.*)/);
+ if (quoteMatch) {
+ flushParagraph();
+ closeList();
+ if (!inBlockquote) {
+ inBlockquote = true;
+ result.push('');
+ }
+ result.push(`${inlineFormat(quoteMatch[1])}
`);
+ continue;
+ }
+ else if (inBlockquote) {
+ closeBlockquote();
+ }
+ // 无序列表
+ const ulMatch = line.match(/^[\-\*]\s+(.+)/);
+ if (ulMatch) {
+ flushParagraph();
+ closeBlockquote();
+ if (!inList || listType !== 'ul') {
+ closeList();
+ inList = true;
+ listType = 'ul';
+ result.push('' : '');
+ inList = false;
+ listType = '';
+ }
+ }
+ /** 关闭引用块 */
+ function closeBlockquote() {
+ if (inBlockquote) {
+ result.push('
');
+ inBlockquote = false;
+ }
+ }
+ }
+ /** 还原占位符为安全 HTML */
+ function restorePlaceholders(text, prefix, replacements) {
+ return text.replace(new RegExp(escapeRegex(prefix) + '(\\d+)\x00', 'g'), (_m, idx) => {
+ return replacements[parseInt(idx)] || '';
+ });
+ }
+ /** 转义正则特殊字符 */
+ function escapeRegex(str) {
+ return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+ }
+
let config$1 = null;
let messages = [];
let messagesContainer$1 = null;
let inputEl$1 = null;
let sendBtn$1 = null;
let clearBtn$1 = null;
+ let categorySelect$1 = null;
+ let historyPanel$1 = null;
let showLoadingFn$1 = null;
let hideLoadingFn$1 = null;
let isSending = false;
+ /** 当前选中的知识库分类 ID */
+ let currentCategoryId;
+ /** 当前是否使用 RAG 对话 */
+ let useRag = false;
/**
* 初始化对话模块
*/
@@ -990,41 +2158,84 @@ var ChatbotSDK = (function () {
inputEl$1 = dom.inputEl;
sendBtn$1 = dom.sendBtn;
clearBtn$1 = dom.clearBtn;
+ categorySelect$1 = dom.categorySelect;
+ historyPanel$1 = dom.historyPanel;
showLoadingFn$1 = dom.showLoading;
hideLoadingFn$1 = dom.hideLoading;
+ // 初始化知识库分类
+ currentCategoryId = cfg.categoryId;
+ useRag = !!cfg.categoryId || !!cfg.showCategorySwitch;
// 绑定发送事件
bindSendEvents();
- // 恢复历史消息
- const history = loadMessages(cfg.integrateId);
- if (history.length > 0) {
- messages = history;
- renderHistory();
+ // 加载知识库分类下拉框
+ if (cfg.showCategorySwitch && categorySelect$1) {
+ loadCategories();
+ }
+ }
+ /**
+ * 初始化 chatId 并加载对话历史
+ * 异步流程：查后端会话 → 恢复 chatId → 加载历史消息
+ */
+ async function initChatHistory() {
+ if (!config$1 || !messagesContainer$1)
+ return;
+ // 1. 初始化 chatId（从后端获取已有会话或自动生成）
+ await initChatId();
+ // 2. 尝试从后端加载对话历史
+ await loadHistoryFromBackend();
+ // 3. 如果后端无历史，尝试从 localStorage 恢复
+ if (messages.length === 0) {
+ const cached = loadMessages(config$1.integrateId);
+ if (cached.length > 0) {
+ messages = cached;
+ renderHistory();
+ logger.info(`从本地缓存恢复 ${cached.length} 条消息`);
+ }
+ }
+ }
+ /**
+ * 从后端加载对话历史
+ */
+ async function loadHistoryFromBackend() {
+ if (!config$1 || !messagesContainer$1)
+ return;
+ const chatId = getChatId();
+ if (!chatId)
+ return;
+ try {
+ const result = await fetchConversationMessages(chatId);
+ if (result.messages.length > 0) {
+ // 将后端消息转换为 ChatMessage 格式
+ messages = result.messages.map((msg, idx) => ({
+ id: uuid(),
+ role: msg.messageType === 'USER' ? 'user' : 'ai',
+ content: msg.content,
+ timestamp: new Date(msg.createTime).getTime(),
+ }));
+ renderHistory();
+ logger.info(`从后端加载 ${messages.length} 条历史消息`);
+ // 同步到 localStorage
+ saveMessages(config$1.integrateId, messages);
+ }
+ }
+ catch (err) {
+ logger.warn('从后端加载历史消息失败', err);
}
}
/** 绑定发送相关事件 */
function bindSendEvents() {
if (!inputEl$1 || !sendBtn$1)
return;
- // 发送按钮点击
- sendBtn$1.addEventListener('click', () => {
- handleSend();
- });
- // 输入框键盘事件：回车发送 / Shift+Enter 换行
+ sendBtn$1.addEventListener('click', () => handleSend());
inputEl$1.addEventListener('keydown', (e) => {
if (e.key === 'Enter' && !e.shiftKey) {
e.preventDefault();
handleSend();
}
});
- // 输入框内容变化时启用/禁用发送按钮
- inputEl$1.addEventListener('input', () => {
- updateSendBtnState();
- });
- // 清空按钮
+ inputEl$1.addEventListener('input', () => updateSendBtnState());
if (clearBtn$1) {
- clearBtn$1.addEventListener('click', () => {
- handleClear();
- });
+ clearBtn$1.addEventListener('click', () => handleClear());
}
}
/** 更新发送按钮状态 */
@@ -1046,30 +2257,23 @@ var ChatbotSDK = (function () {
const text = inputEl$1.value.trim();
if (text === '')
return;
- // 清空输入框
inputEl$1.value = '';
updateSendBtnState();
- // 自动调整 textarea 高度
inputEl$1.style.height = 'auto';
isSending = true;
updateSendBtnState();
+ // 确保 chatId 已初始化
+ if (!config$1.chatId) {
+ await initChatId();
+ }
// 1. 渲染用户气泡
const userTimestamp = now();
- if (messagesContainer$1) {
+ if (messagesContainer$1)
renderUserBubble(messagesContainer$1, text, userTimestamp);
- }
- const userMsg = {
- id: uuid(),
- role: 'user',
- content: text,
- timestamp: userTimestamp,
- };
+ const userMsg = { id: uuid(), role: 'user', content: text, timestamp: userTimestamp };
messages.push(userMsg);
- // 显示清空按钮
- if (clearBtn$1 && messages.length > 0) {
+ if (clearBtn$1 && messages.length > 0)
clearBtn$1.style.display = 'inline-flex';
- }
- // 滚动到底部
if (messagesContainer$1)
scrollToBottom(messagesContainer$1);
// 2. 显示 loading
@@ -1081,40 +2285,31 @@ var ChatbotSDK = (function () {
try {
let aiContent;
const aiTimestamp = now();
+ const shouldUseRag = useRag && (currentCategoryId !== undefined || config$1.categoryId !== undefined);
if (config$1.streaming) {
- // 流式输出：气泡由 sendStreamMessage 内部的 onChunk 回调创建
- aiContent = await sendStreamMessage(text, aiTimestamp);
+ aiContent = await sendStreamMessage(text, aiTimestamp, shouldUseRag);
}
else {
- // 同步请求：需要在此渲染 AI 气泡
aiContent = await chatRequest(text);
}
- // 4. 隐藏 loading（流式模式在 onChunk 中已隐藏，此处做兜底）
if (hideLoadingFn$1)
hideLoadingFn$1();
- // 5. 非流式模式：在此渲染 AI 气泡；流式模式气泡已在 stream 回调中创建
if (!config$1.streaming && messagesContainer$1) {
- renderAIBubble(messagesContainer$1, aiContent, aiTimestamp);
+ renderAIBubble(messagesContainer$1, aiContent, aiTimestamp, renderMarkdown);
}
- const aiMsg = {
- id: uuid(),
- role: 'ai',
- content: aiContent,
- timestamp: aiTimestamp,
- };
+ const aiMsg = { id: uuid(), role: 'ai', content: aiContent, timestamp: aiTimestamp };
messages.push(aiMsg);
- // 6. 保存到 localStorage
saveMessages(config$1.integrateId, messages);
- // 7. 滚动到底部
if (messagesContainer$1)
scrollToBottom(messagesContainer$1);
+ // RAG 引用来源
+ if (shouldUseRag)
+ fetchAndRenderSources(text, aiMsg);
}
catch (err) {
- // 隐藏 loading
if (hideLoadingFn$1)
hideLoadingFn$1();
- // 渲染错误提示
- const errMsg = err instanceof CskError ? err.message : '发送失败，请稍后重试';
+ const errMsg = err instanceof CskError ? err.message : t('error_send');
if (messagesContainer$1) {
const errorBubble = document.createElement('div');
errorBubble.className = 'csk-msg csk-msg--ai';
@@ -1133,93 +2328,190 @@ var ChatbotSDK = (function () {
}
}
/** 流式发送消息 */
- async function sendStreamMessage(text, aiTimestamp) {
+ async function sendStreamMessage(text, aiTimestamp, shouldUseRag) {
return new Promise((resolve, reject) => {
let bubbleEl = null;
- let wrapperEl = null;
let accumulated = '';
let streamStarted = false;
- chatSSERequest(text,
- // onChunk
- (chunk) => {
+ chatSSERequest(text, (chunk) => {
accumulated += chunk;
if (!streamStarted && messagesContainer$1) {
- // 隐藏 loading，创建空 AI 气泡
if (hideLoadingFn$1)
hideLoadingFn$1();
- const { wrapper, bubble } = createEmptyAIBubble(messagesContainer$1, aiTimestamp);
- wrapperEl = wrapper;
+ const { bubble } = createEmptyAIBubble(messagesContainer$1, aiTimestamp);
bubbleEl = bubble;
streamStarted = true;
}
- if (bubbleEl) {
+ if (bubbleEl)
bubbleEl.textContent = accumulated;
- }
if (messagesContainer$1)
scrollToBottom(messagesContainer$1);
- },
- // onDone
- () => {
- // 如果流没有产生任何内容，回退同步请求
+ }, () => {
if (!streamStarted && accumulated === '') {
- chatRequest(text)
- .then((content) => resolve(content))
- .catch(reject);
+ chatRequest(text).then(resolve).catch(reject);
return;
}
+ if (bubbleEl && accumulated)
+ bubbleEl.innerHTML = renderMarkdown(accumulated);
resolve(accumulated);
- },
- // onError
- (error) => {
+ }, (error) => {
if (accumulated.length > 0) {
- // 有部分内容，保留并添加提示
- if (bubbleEl) {
- bubbleEl.textContent = accumulated + '\n\n[回复被中断]';
- }
+ if (bubbleEl)
+ bubbleEl.innerHTML = renderMarkdown(accumulated + '\n\n' + t('stream_interrupted'));
resolve(accumulated);
}
else {
reject(error);
}
- });
+ }, currentCategoryId, shouldUseRag);
});
}
+ /** 获取并渲染 RAG 引用来源 */
+ async function fetchAndRenderSources(message, aiMsg) {
+ try {
+ const sources = await fetchRagSources(message, currentCategoryId);
+ if (sources.length > 0) {
+ const ragSources = sources.map(s => {
+ var _a, _b;
+ return ({
+ documentId: s.documentId || '',
+ title: s.title || '',
+ sourceName: s.sourceName || '',
+ chunkIndex: (_a = s.chunkIndex) !== null && _a !== void 0 ? _a : 0,
+ score: (_b = s.score) !== null && _b !== void 0 ? _b : 0,
+ snippet: s.snippet || '',
+ });
+ });
+ aiMsg.sources = ragSources;
+ if (messagesContainer$1) {
+ const lastAiMsg = messagesContainer$1.querySelector('.csk-msg--ai:last-of-type');
+ if (lastAiMsg)
+ renderSources(lastAiMsg, ragSources);
+ }
+ if (config$1)
+ saveMessages(config$1.integrateId, messages);
+ }
+ }
+ catch (err) {
+ logger.warn('获取引用来源失败', err);
+ }
+ }
+ /** 加载知识库分类到下拉框 */
+ async function loadCategories() {
+ if (!categorySelect$1)
+ return;
+ try {
+ const tree = await fetchCategoryTree();
+ if (tree.length === 0)
+ return;
+ categorySelect$1.innerHTML = ``;
+ const addOptions = (nodes, indent = 0) => {
+ for (const node of nodes) {
+ const option = document.createElement('option');
+ option.value = String(node.id);
+ option.textContent = `${' '.repeat(indent)}${node.name}`;
+ if (currentCategoryId !== undefined && String(node.id) === String(currentCategoryId))
+ option.selected = true;
+ categorySelect$1.appendChild(option);
+ if (node.children && node.children.length > 0)
+ addOptions(node.children, indent + 1);
+ }
+ };
+ addOptions(tree);
+ logger.info(`知识库分类加载成功 count=${tree.length}`);
+ }
+ catch (err) {
+ logger.error(t('category_load_error'), err);
+ }
+ }
/** 渲染历史消息 */
function renderHistory() {
if (!messagesContainer$1)
return;
- // 清空容器
- messagesContainer$1.innerHTML = '';
+ const historyPanelEl = messagesContainer$1.querySelector('.csk-history-panel');
+ const msgs = messagesContainer$1.querySelectorAll('.csk-msg, .csk-loading');
+ msgs.forEach(el => el.remove());
for (const msg of messages) {
if (msg.role === 'user') {
renderUserBubble(messagesContainer$1, msg.content, msg.timestamp);
}
else {
- renderAIBubble(messagesContainer$1, msg.content, msg.timestamp);
+ const wrapper = renderAIBubble(messagesContainer$1, msg.content, msg.timestamp, renderMarkdown);
+ if (msg.sources && msg.sources.length > 0)
+ renderSources(wrapper, msg.sources);
}
}
scrollToBottom(messagesContainer$1);
- // 显示清空按钮
- if (clearBtn$1 && messages.length > 0) {
+ if (clearBtn$1 && messages.length > 0)
clearBtn$1.style.display = 'inline-flex';
+ if (historyPanelEl && !messagesContainer$1.contains(historyPanelEl)) {
+ messagesContainer$1.appendChild(historyPanelEl);
}
}
- /** 清空对话历史 */
+ /** 清空对话历史（生成新 chatId） */
function handleClear() {
if (!config$1)
return;
- if (!confirm('确定清空所有对话记录？')) {
+ if (!confirm(t('clear_confirm')))
return;
- }
messages = [];
if (messagesContainer$1) {
- messagesContainer$1.innerHTML = '';
+ const msgs = messagesContainer$1.querySelectorAll('.csk-msg, .csk-loading');
+ msgs.forEach(el => el.remove());
}
- if (clearBtn$1) {
+ if (clearBtn$1)
clearBtn$1.style.display = 'none';
- }
clearMessages(config$1.integrateId);
- logger.info(`清空会话 integrateId=${config$1.integrateId}`);
+ // 生成新的 chatId，开始新会话
+ const newId = generateNewChatId();
+ updateChatId(newId);
+ saveCachedChatId(config$1.integrateId, config$1.userId, newId);
+ logger.lifecycleClear(config$1.integrateId);
+ logger.info(`新 chatId=${newId}`);
+ }
+ /** 生成新 chatId */
+ function generateNewChatId() {
+ const random = typeof crypto !== 'undefined' && crypto.randomUUID
+ ? crypto.randomUUID().substring(0, 8)
+ : Math.random().toString(36).substring(2, 10);
+ return `sdk_${Date.now()}_${random}`;
+ }
+ /** 设置当前知识库分类 */
+ function setCategory(categoryId) {
+ currentCategoryId = categoryId;
+ useRag = categoryId !== undefined;
+ logger.lifecycleCategoryChange(categoryId !== null && categoryId !== void 0 ? categoryId : '全部');
+ }
+ // ==================== 会话管理面板 ====================
+ /** 加载会话列表并渲染 */
+ async function loadHistoryConversations() {
+ if (!historyPanel$1 || !config$1)
+ return;
+ const listEl = historyPanel$1.querySelector('#csk-history-list');
+ if (!listEl)
+ return;
+ listEl.innerHTML = `加载中...
`;
+ try {
+ const result = await fetchConversationList(1, 50, config$1.userId, config$1.integrateId);
+ const items = result.list.map(c => ({
+ id: c.conversationId || c.chatId || '',
+ chatId: c.conversationId || c.chatId || '',
+ messageCount: c.messageCount,
+ lastMessageTime: c.lastMessageTime,
+ createdAt: c.firstMessageTime || c.createdAt,
+ }));
+ renderHistoryList(listEl, items, (id) => { window.open(getConversationExportUrl(id), '_blank'); }, async (id) => {
+ if (!confirm(t('history_delete_confirm')))
+ return;
+ const ok = await deleteConversation(id);
+ if (ok)
+ loadHistoryConversations();
+ });
+ }
+ catch (err) {
+ logger.error(t('history_load_error'), err);
+ listEl.innerHTML = `⚠
${t('history_load_error')}
${s}
`),`${M}${o}\0`});const r=[];t=t.replace(/`([^`\n]+)`/g,(n,e)=>{const t=r.length;return r.push(`${E(e)}`),`${z}${t}\0`}),t=E(t),t=q(t,M,e),t=q(t,z,r);const o=t.split("\n"),s=[];let i=!1,a="",c=!1,l=[];for(let n=0;n')){u(),p(),m(),s.push(e);continue}const t=e.match(/^(#{1,6})\s+(.+)/);if(t){u(),p(),m();const n=t[1].length;s.push(`${t[2]}`);continue}const r=e.match(/^>\s?(.*)/);if(r){u(),p(),c||(c=!0,s.push('')),s.push(`${d(r[1])}
`);continue}c&&m();const h=e.match(/^[\-\*]\s+(.+)/);if(h){u(),m(),i&&"ul"===a||(p(),i=!0,a="ul",s.push('')),s.push(`- ${d(h[1])}
`);continue}const g=e.match(/^\d+\.\s+(.+)/);g?(u(),m(),i&&"ol"===a||(p(),i=!0,a="ol",s.push('')),s.push(`- ${d(g[1])}
`)):""!==e.trim()?/^(\*{3,}|-{3,}|_{3,})$/.test(e.trim())?(u(),p(),m(),s.push('
')):(p(),m(),l.push(d(e))):(u(),p())}return u(),p(),m(),s.join("\n");function d(n){return n=(n=(n=(n=(n=(n=n.replace(/\*\*(.+?)\*\*/g,"$1")).replace(/__(.+?)__/g,"$1")).replace(/\*(.+?)\*/g,"$1")).replace(/(?$1")).replace(/~~(.+?)~~/g,"$1")).replace(/\[([^\]]+)\]\(([^)]+)\)/g,(n,e,t)=>`${e}`)}function u(){l.length>0&&(s.push(`${l.join("
")}
`),l=[])}function p(){i&&(s.push("ul"===a?"
":""),i=!1,a="")}function m(){c&&(s.push("
"),c=!1)}}function q(n,e,t){return n.replace(new RegExp(e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")+"(\\d+)\0","g"),(n,e)=>t[parseInt(e)]||"")}let j,H=null,R=[],U=null,P=null,O=null,W=null,K=null,V=null,J=null,X=null,Y=!1,G=!1;function Q(n,e){H=n,U=e.messagesContainer,P=e.inputEl,O=e.sendBtn,W=e.clearBtn,K=e.categorySelect,V=e.historyPanel,J=e.showLoading,X=e.hideLoading,j=n.categoryId,G=!!n.categoryId||!!n.showCategorySwitch,function(){if(!P||!O)return;O.addEventListener("click",()=>en()),P.addEventListener("keydown",n=>{"Enter"!==n.key||n.shiftKey||(n.preventDefault(),en())}),P.addEventListener("input",()=>nn()),W&&W.addEventListener("click",()=>function(){if(!H)return;if(!confirm(i("clear_confirm")))return;if(R=[],U){U.querySelectorAll(".csk-msg, .csk-loading").forEach(n=>n.remove())}W&&(W.style.display="none");B(H.integrateId);const n=function(){const n="undefined"!=typeof crypto&&crypto.randomUUID?crypto.randomUUID().substring(0,8):Math.random().toString(36).substring(2,10);return`sdk_${Date.now()}_${n}`}();e=n,a&&(a.chatId=e),b(H.integrateId,H.userId,n),r.lifecycleClear(H.integrateId),r.info(`新 chatId=${n}`);var e}())}(),n.showCategorySwitch&&K&&async function(){if(!K)return;try{const n=await async function(){const n=c("/category/tree");try{const e=await d(n);if(!e.ok)throw new u(p(e.status),`http_${e.status}`);const t=await e.json();return t.success&&Array.isArray(t.data)?(r.info(`加载分类树成功 count=${t.data.length}`),t.data):[]}catch(n){return n instanceof u?r.error(`加载分类树失败: ${n.message}`):r.error("加载分类树失败",n),[]}}();if(0===n.length)return;K.innerHTML=``;const e=(n,t=0)=>{for(const r of n){const n=document.createElement("option");n.value=String(r.id),n.textContent=`${" ".repeat(t)}${r.name}`,void 0!==j&&String(r.id)===String(j)&&(n.selected=!0),K.appendChild(n),r.children&&r.children.length>0&&e(r.children,t+1)}};e(n),r.info(`知识库分类加载成功 count=${n.length}`)}catch(n){r.error(i("category_load_error"),n)}}()}async function Z(){if(H&&U&&(await f(),await async function(){if(!H||!U)return;const n=(null==a?void 0:a.chatId)||"";if(!n)return;try{const e=await async function(n){const e=c(`/conversation/${n}/messages`);try{const n=await d(e);if(!n.ok)throw new u(p(n.status),`http_${n.status}`);const t=await n.json();return{messages:t.success&&Array.isArray(t.data)?t.data:[],total:t.total||0}}catch(n){return r.error("加载会话消息失败",n),{messages:[],total:0}}}(n);e.messages.length>0&&(R=e.messages.map((n,e)=>({id:v(),role:"USER"===n.messageType?"user":"ai",content:n.content,timestamp:new Date(n.createTime).getTime()})),tn(),r.info(`从后端加载 ${R.length} 条历史消息`),D(H.integrateId,R))}catch(n){r.warn("从后端加载历史消息失败",n)}}(),0===R.length)){const n=function(n){try{const e=localStorage.getItem(L(n));if(!e)return[];const t=JSON.parse(e);return t&&Array.isArray(t.messages)?(r.info(`加载历史消息 integrateId=${n} count=${t.messages.length}`),t.messages):[]}catch(n){return r.warn("加载会话历史失败",n),[]}}(H.integrateId);n.length>0&&(R=n,tn(),r.info(`从本地缓存恢复 ${n.length} 条消息`))}}function nn(){if(!O||!P)return;P.value.trim().length>0&&!Y?O.removeAttribute("disabled"):O.setAttribute("disabled","true")}async function en(){if(!P||!H||Y)return;const n=P.value.trim();if(""===n)return;P.value="",nn(),P.style.height="auto",Y=!0,nn(),H.chatId||await f();const e=I();U&&$(U,n,e);const t={id:v(),role:"user",content:n,timestamp:e};R.push(t),W&&R.length>0&&(W.style.display="inline-flex"),U&&F(U),J&&J(),U&&F(U);try{let e;const t=I(),o=G&&(void 0!==j||void 0!==H.categoryId);e=H.streaming?await async function(n,e,t){return new Promise((r,o)=>{let s=null,a="",c=!1;h(n,n=>{if(a+=n,!c&&U){X&&X();const{bubble:n}=function(n,e){const t=document.createElement("div");t.className="csk-msg csk-msg--ai";const r=document.createElement("div");r.className="csk-msg__bubble",r.innerHTML="";const o=document.createElement("div");return o.className="csk-msg__time",o.textContent=N(e),t.appendChild(r),t.appendChild(o),n.appendChild(t),{wrapper:t,bubble:r}}(U,e);s=n,c=!0}s&&(s.textContent=a),U&&F(U)},()=>{c||""!==a?(s&&a&&(s.innerHTML=T(a)),r(a)):m(n).then(r).catch(o)},n=>{a.length>0?(s&&(s.innerHTML=T(a+"\n\n"+i("stream_interrupted"))),r(a)):o(n)},j,t)})}(n,t,o):await m(n),X&&X(),!H.streaming&&U&&S(U,e,t,T);const s={id:v(),role:"ai",content:e,timestamp:t};R.push(s),D(H.integrateId,R),U&&F(U),o&&async function(n,e){try{const t=await g(n,j);if(t.length>0){const n=t.map(n=>{var e,t;return{documentId:n.documentId||"",title:n.title||"",sourceName:n.sourceName||"",chunkIndex:null!==(e=n.chunkIndex)&&void 0!==e?e:0,score:null!==(t=n.score)&&void 0!==t?t:0,snippet:n.snippet||""}});if(e.sources=n,U){const e=U.querySelector(".csk-msg--ai:last-of-type");e&&A(e,n)}H&&D(H.integrateId,R)}}catch(n){r.warn("获取引用来源失败",n)}}(n,s)}catch(n){X&&X();const e=n instanceof u?n.message:i("error_send");if(U){const n=document.createElement("div");n.className="csk-msg csk-msg--ai";const t=document.createElement("div");t.className="csk-msg__bubble",t.style.color="#DC2626",t.textContent=`⚠ ${e}`,n.appendChild(t),U.appendChild(n)}r.error(`发送失败 integrateId=${H.integrateId}`,n)}finally{Y=!1,nn()}}function tn(){if(!U)return;const n=U.querySelector(".csk-history-panel");U.querySelectorAll(".csk-msg, .csk-loading").forEach(n=>n.remove());for(const n of R)if("user"===n.role)$(U,n.content,n.timestamp);else{const e=S(U,n.content,n.timestamp,T);n.sources&&n.sources.length>0&&A(e,n.sources)}F(U),W&&R.length>0&&(W.style.display="inline-flex"),n&&!U.contains(n)&&U.appendChild(n)}async function rn(){if(!V||!H)return;const n=V.querySelector("#csk-history-list");if(n){n.innerHTML='加载中...
';try{const e=await k(1,50,H.userId,H.integrateId);!function(n,e,t,r){if(n.innerHTML="",0===e.length){const e=document.createElement("div");return e.className="csk-history-panel__empty",e.innerHTML=`\n 💬
\n ${i("history_empty")}
\n `,void n.appendChild(e)}for(const o of e){const e=document.createElement("div");e.className="csk-history-item";const s=document.createElement("div");s.className="csk-history-item__info";const a=document.createElement("div");a.className="csk-history-item__id",a.textContent=o.chatId||o.id;const c=document.createElement("div");c.className="csk-history-item__meta";const l=[];void 0!==o.messageCount&&l.push(`${o.messageCount} 条消息`),o.lastMessageTime?l.push(o.lastMessageTime):o.createdAt&&l.push(o.createdAt),c.textContent=l.join(" · "),s.appendChild(a),s.appendChild(c);const d=document.createElement("div");d.className="csk-history-item__actions";const u=document.createElement("button");u.className="csk-history-action csk-history-action--export",u.setAttribute("title",i("history_export")),u.innerHTML='',u.addEventListener("click",n=>{n.stopPropagation(),t(o.id)});const p=document.createElement("button");p.className="csk-history-action csk-history-action--delete",p.setAttribute("title",i("history_delete")),p.innerHTML='',p.addEventListener("click",n=>{n.stopPropagation(),r(o.id)}),d.appendChild(u),d.appendChild(p),e.appendChild(s),e.appendChild(d),n.appendChild(e)}}(n,e.list.map(n=>({id:n.conversationId||n.chatId||"",chatId:n.conversationId||n.chatId||"",messageCount:n.messageCount,lastMessageTime:n.lastMessageTime,createdAt:n.firstMessageTime||n.createdAt})),n=>{window.open(c(`/conversation/${n}/export`),"_blank")},async n=>{if(!confirm(i("history_delete_confirm")))return;await async function(n){const e=c(`/conversation/${n}`);try{const t=await d(e,{method:"DELETE"});if(!t.ok)throw new u(p(t.status),`http_${t.status}`);const o=await t.json();return r.info(`删除会话 id=${n} success=${o.success}`),o.success||!1}catch(n){return r.error("删除会话失败",n),!1}}(n)&&rn()})}catch(e){r.error(i("history_load_error"),e),n.innerHTML=`⚠
${i("history_load_error")}
加载中...
`;
+
+ try {
+ const result = await fetchConversationList(1, 50, config.userId, config.integrateId);
+ const items: HistoryItemData[] = result.list.map(c => ({
+ id: c.conversationId || c.chatId || '',
+ chatId: c.conversationId || c.chatId || '',
+ messageCount: c.messageCount,
+ lastMessageTime: c.lastMessageTime,
+ createdAt: c.firstMessageTime || c.createdAt,
+ }));
+
+ renderHistoryList(
+ listEl,
+ items,
+ (id: string) => { window.open(getConversationExportUrl(id), '_blank'); },
+ async (id: string) => {
+ if (!confirm(t('history_delete_confirm'))) return;
+ const ok = await deleteConversation(id);
+ if (ok) loadHistoryConversations();
+ }
+ );
+ } catch (err) {
+ logger.error(t('history_load_error'), err);
+ listEl.innerHTML = `⚠
${t('history_load_error')}