 wanghanlin
|
20d9a889ac
|
fix(sdk): 流式零内容时降级路径未渲染答案，界面永久停在「正在思考...」
问题：第三方页面反馈「对话框一直显示正在思考...，但控制台里请求与响应数据都正常」。
定位：服务端这次的流式响应只回了「开场 role 帧 + finish_reason=stop 帧 + [DONE]」三个控制帧、
零内容（服务端成因见后一个提交）。SDK 的 sendStreamMessage 在 onDone 里发现零内容时确实会
降级再发一次同步 /ai/chat，但该分支只写 `chatRequest(...).then(resolve)` —— 既不渲染气泡也不
收掉 loading；而 produceAIReply 的 streaming 分支把「渲染气泡 + 收 loading」全权委托给了
onChunk 回调，这条路径拿不到 onChunk。结果同步拿到的答案被静默丢弃、loading 永不消失。
- 降级路径补齐 hideLoading + renderAIBubble（复用 dom.ts 已有实现，终态与非流式分支一致）
- 同一函数另一处同类出口：首个 token 之前点「停止生成」时 loading 同样不会被收，且会把一条
空 AI 消息写进历史。补 hideLoading；并在 produceAIReply 加守卫：aiContent 为空串时不 push、
不落库、不派发 csk:newMessage（避免历史里多出空气泡）
- 流式零内容时上报 onError code=stream_empty，不再静默；README 补该错误码与触发方式说明
验证：用逐字复刻线上那 3 帧的 mock 流驱动真实 SDK（puppeteer）——降级拿到的答案被正常渲染成
气泡、「正在思考...」消失、onError 收到 stream_empty，请求序列与线上 HAR 一致；正常带内容的流
不受影响（errors 为空、syncFallbackCalls=0）；首 token 前中止时 loading 消失且历史无空消息。
client 单测 92 个全绿。
（static/sdk/test.html 仅两条 link 顺序变化，hash 未变，属构建产物顺序抖动）
|
2 weeks ago |
|
wanghanlin
|
5a553ec813
|
feat(sdk): SDK 内置 Token 自动刷新，支持每请求前向宿主取 Token
问题：SDK Token 默认仅 2 小时有效，而 SDK 此前没有任何刷新入口 —— token 只能
在 init() 时传一次、只存内存，收到 401 只回调 onError 报错，想换 Token 只能
destroy() 重建整个 DOM，第三方页面长时间挂载必然掉线。
取 Token 的四种触发方式（client/src/token.ts）
- 临期主动刷新：阈值取「总寿命 10% 与 5 分钟」的较小值，需传 expiresIn
- 每请求前取：tokenStrategy: 'always'，每个受保护请求发出前都向宿主取一次，
完全不推算过期时间（该模式下不排定时器、不认「返回同一 Token」的静默窗口）
- 401 兜底重试：换一次 Token 后自动重试原请求，UI 上不会闪错误
- 手动入口：ChatbotSDK.setToken(token, expiresIn?) / refreshToken()
取 Token 的两种来源（二选一，getToken 回调优先并明确告警）
- getToken 回调：由宿主实现，可复用其请求封装与鉴权头
- tokenUrl 地址：SDK 直接 GET，兼容 {token,expiresIn} 与
{success,token,expiresIn,roles}；用 credentials: 'same-origin'（同源带
Cookie、跨域不带，避免把宿主站点 Cookie 泄露给别的域）
两者都让 API Key 留在宿主服务端，不进浏览器；后端零改动。
关键实现约束（均有单测覆盖）
- 临期阈值必须自适应：后端 clampExpirationMillis 允许的最短 ttl 恰为 300s，
固定 5 分钟会让它永远处于临期态，定时器延迟算成 0 退化成秒级无限刷新循环
- expiresIn 只做 24h 上界钳制、绝不做下界，避免把「只剩 20s 的 Token」当成
300s 而带着已过期 Token 发请求（上界同时防 setTimeout 溢出与毫秒误传）
- provider 调用自带 10s 超时，refreshPromise 在 finally 无条件清空：宿主回调
永不 settle 时，挂起会经 single-flight 传染给后续所有受保护请求
- setToken 自增 generation 但不碰 refreshPromise：既防止在途刷新返回的旧值
覆盖宿主刚推来的新值，又不破坏 single-flight
- 刷新失败统一进 60s 熔断窗口（判断在 refreshNow 内，不在 ensureFresh），窗口
内请求照常发出、由 401 兜底，避免宿主取 Token 挂死时每个请求多等一次超时
- isProtectedPath 改用 URL.pathname 判定并与后端 SdkAuthFilter.shouldNotFilter
逐字对齐；顺带修掉旧实现 endsWith('/feedback') 遇 query 参数漏注入、
/attachment/upload 注入了 Token 却不享受 401 处理的两处不一致
- 401 透明重试对写请求（POST /feedback、/attachment/upload、DELETE 会话）安全，
依据是 SdkAuthFilter 的 401 全部发生在 chain.doFilter 之前（401 ⇒ 业务逻辑
未执行）；该前提已写入代码注释与 CLAUDE.md，改过滤器时需重新评估
顺带修复
- chat.ts：首 token 前点「停止生成」会反而多发一个同步 /ai/chat 请求
- tests/config.test.ts：2 条断言早已因窗口默认值改动而变红（不修平的话
npm test 无法充当回归门）
- 文档：修正 width 默认值 380->500、enableRag 默认值 false->true、roleId 幽灵
参数、「仅 console.error 输出」（控制台日志早已全量关闭）等过时描述，并补齐
token/expiresIn/getToken/tokenStrategy/tokenUrl 全部鉴权参数
验证
- client 单测 92 个全绿（新增 token.test.ts 60 个 + config 新增 9 个），
npx tsc --noEmit 通过
- npm run build（SDK）与 frontend npm run build 均通过，
mvn clean package -P prod 构建成功
- 浏览器端未实测（按项目惯例由用户在 IDEA 启动服务，避免抢占 9090 端口），
面板已加 TTL 输入与 tokenStrategy 选择开关供手工验证
|
2 weeks ago |
|
wanghanlin
|
9fe3ee6828
|
fix(sdk): 修复历史会话不显示图片附件
- MessageConverter 落库时持久化多模态 Media 到 metadata._media
- ConversationService 历史消息接口提取 _media 为顶层 images 字段
- SDK 前端历史映射补齐 images，复用 renderUserBubble 附件渲染
|
1 month ago |
|
wanghanlin
|
d5d392aca4
|
feat(sdk): 支持图片上传与多模态对话
SDK 前端新增图片附件上传与多模态对话能力，输入区新增附件按钮与图片预览，新增 allowImageUpload 配置项；/attachment/upload 鉴权改由 SdkAuthFilter 承担（移除方法级 @PreAuthorize），JwtAuthFilter/SecurityConfig 同步放行
|
1 month ago |
|
wanghanlin
|
83964afcfc
|
refactor(client): 外围组件原生化并清理死代码，缩小 SDK 体积
- t-select/t-dialog/t-alert/t-tag/t-button 替换为原生 DOM，删 5 条组件 import 与 omi 直接依赖，min 版缩小约 212KB
- 清理死代码：images.d.ts、失效测试、dist 残留、getMessages、死类型、showAdminPanel、未用 i18n key、t-tag 死 CSS
- 修复 i18n 缺失 confirm/cancel 翻译与自绘确认框 ESC 冲突
|
2 months ago |
|
wanghanlin
|
da031c6ff0
|
fix(client): 修复重新生成清空历史，优化引用来源/推荐问题与历史滚动
- 重新生成改为调用后端会话截断接口，同步前后端数据，避免历史回复被清空
- 引用来源折叠开关与推荐问题改用 t-button，风格对齐 ChatActionbar 操作栏
- 历史消息渲染后延迟滚动到底部，修复停在滚动条中间的问题
|
2 months ago |
|
wanghanlin
|
e23b70ffca
|
feat(client): SDK 界面重构改用 TDesign Web Components 组件
- 聊天核心：消息气泡/输入框/操作栏/加载态改用 t-chat-message/t-chat-sender/t-chat-action/t-chat-loading
- 外围 UI：知识库下拉/推荐问题/离线横幅改用 t-select/t-tag/t-alert
- Markdown 渲染由 t-chat-item 内置 cherry-markdown 承担，移除自研 marked 渲染器与 marked.min.js
- 构建管线：引入 tdesign-web-components@1.2.10 按需打包，mermaid 用本地 stub 替换省约 1.2MB
- 清理重构后死代码与死样式（escapeHtml/getLocale/appendStreamingCaret/offlineBannerEl 等）
- 同步更新测试面板断言（T3/T6/T10 适配 t-chat-sender）与 README/CLAUDE.md
|
2 months ago |
|
wanghanlin
|
b5abf32530
|
迁移到 TDesign 架构时漏掉了文档上传路由和菜单入口
|
2 months ago |
|
wanghanlin
|
bfb5a66393
|
AI回复增加推荐问题功能
|
2 months ago |
|
wanghanlin
|
532994ba20
|
chatsdk清空对话按钮改为新对话
|
2 months ago |
|
wanghanlin
|
527d9e71b7
|
AI 对话执行链路流程图
|
2 months ago |
|
wanghanlin
|
a2950be98f
|
修复 SSE 流式回答每词独占一行的 bug
|
3 months ago |
|
wanghanlin
|
0bc4b66e93
|
入口图标改造 + SDK 瘦身
|
3 months ago |
pyx
|
a6ba72053f
|
优化 SDK RAG 默认开启逻辑并调整测试页配置
|
3 months ago |
|
wanghanlin
|
cdaff49533
|
优化前端操作交互体验。
ai大模型配置错误不影响启动服务。
去除后台系统提示词，直接使用前端角色设定提示词。
|
3 months ago |
|
wanghanlin
|
f7eb0bfaf1
|
feat(P0): 完成阶段一全部需求 — 混合检索/内容安全/用户反馈/FAQ精准匹配
P0-001 混合检索+重排序引擎:
- HybridSearchService 支持 VECTOR/KEYWORD/HYBRID 三种检索模式
- RrfFusion RRF 融合算法 (k=60)
- RerankerService 支持 DashScope + OpenAI 兼容多提供商
- vector_store 新增 content_tsvector 列 + GIN 索引 + 触发器
- DocSearch.js 增加检索模式下拉选择
P0-004 内容安全过滤:
- ContentSafetyService DFA 字典树引擎（volatile + copy-on-write 线程安全）
- ContentSafetyAdvisor BaseAdvisor 实现，输入/输出双向审核
- SensitiveWordService 敏感词 CRUD + 批量导入 + 字典树热加载
- SensitiveWordManager.js 前端管理组件
P0-002 用户反馈系统:
- MessageFeedbackService upsert 语义反馈提交 + 统计 API
- ChatPanel.js 添加 👍/👎 反馈按钮
- Chat SDK handleFeedback() 对接后端 POST /feedback
- ConversationService 导出集成反馈信息
P0-003 意图识别+FAQ精准匹配:
- IntentRouter LLM 意图分类（FAQ/RAG/CHITCHAT）
- FaqMatchEngine 三级匹配（精确→关键词→向量语义，阈值 0.85）
- FaqService FAQ CRUD + 异步向量化
- FaqManager.js 前端管理（CRUD + 批量导入/导出 + 启用/禁用）
共享变更:
- DatabaseInitConfig 新增 5 张表 + 全文检索初始化
- api.js 新增反馈/敏感词/FAQ API 封装
- app.js 注册 SensitiveWordManager + FaqManager 组件
- application.yml 新增 knowledge.faq.semantic-threshold 配置
|
3 months ago |
|
wanghanlin
|
bc334a92b1
|
SDK 新增 6 项功能完善（类型导出/窗口配置/错误回调/测试/分组/通知）
1. 类型导出：tsconfig 开启 declaration，新增 build:types 脚本，index.ts re-export 公开类型
2. 窗口高度可配置 + 记忆位置：height 配置项（默认 520，最小 300），拖拽位置 localStorage 持久化
3. 错误监控回调：新增 onError/onReady/onMessage 三个生命周期回调
4. 自动化测试：引入 Vitest，4 个测试文件共 67 个用例（markdown/config/i18n/utils）
5. 会话分组：历史面板按今天/昨天/本周/更早分组渲染
6. 声音/桌面通知：Web Audio API 合成提示音 + Notification API 桌面通知
|
3 months ago |
|
wanghanlin
|
476e34f704
|
ChatSDK完善客服 SDK 的页面样式与交互功能。两轮共落地 13 项改进（快捷问题、暗色模式、停止生成、消息反馈、a11y等）
增加开发、生产配置文件
增加部署文档DEPLOY.md
|
3 months ago |
|
wanghanlin
|
cfe6fea93e
|
ChatSDK重写了 SDK 的视觉与交互
|
3 months ago |
|
wanghanlin
|
5714d01cbb
|
ChatSDK可在对话历史中选定继续会话
|
3 months ago |
|
wanghanlin
|
cfc1ca8650
|
ChatSDK P1/P2 功能已全部实现并修复了三个核心 bug（integrateId→roleId 映射、chatId
自动管理、对话历史从后端加载）
|
3 months ago |
|
wanghanlin
|
c4af6699cf
|
把嵌入模型支持从仅千问扩展到多厂商。前端限制、后端自动覆盖
|
3 months ago |
|
wanghanlin
|
1406c20f07
|
新增客户端工程-chatSDK
|
3 months ago |
