AI 小鲸

更新日志 ​

v2.1.4-beta.9 ​

优化 ​

  • show() 会话就绪 Promise：await show() 在 sessionList 加载完成后 resolve；loadRecentSessionOnMount 为 true 时还会等待最近会话选定或创建完成。面板仍立即打开，初始化在后台进行；失败时 Promise reject，并触发 sdk-error（apiName: 'init'）
  • requestOptions 响应式落地：headers / data 支持普通对象、零参函数、ref、computed；外层 requestOptions 可为 MaybeRefOrGetter（AIBlueking / ChatBot / useChatBootstrap），整体替换后后续请求自动生效，切换 token 或租户无需重建组件
  • data 按 HTTP 方法分流：POST/PUT/PATCH/DELETE 合并进 body；GET/HEAD/OPTIONS 合并进 query（params）；body 为 FormData / Blob 等非 plain object 时跳过合并并输出警告
  • @blueking/chat-helper：新增 resolveRequestValue、MaybeRequestValue 类型，在 requestData 拦截器层统一解析
  • useChatBootstrap 初始化并发：initialize() 复用进行中的 Promise；retry / updateConfig 使用 initGeneration 丢弃过期初始化结果，避免 URL 切换后旧请求写回 READY 状态

文档 ​

v2.1.4-beta.8 ​

新功能 ​

  • requestOptions 响应式增强：headers / data 支持普通对象、函数、ref、computed；外层 requestOptions 也可为 ref / computed，替换后后续请求自动生效。data 对 POST/PUT/PATCH/DELETE 写入 body，对 GET/HEAD/OPTIONS 自动转为 query 参数。能力在 @blueking/chat-helper 的 requestData 层统一实现，小鲸与直接使用 chat-helper 的业务均可受益
  • Standalone 子入口（@blueking/ai-blueking/standalone）：内联 Vue 3 runtime 与 chat-x，供非 Vue 宿主（React、Angular、纯 HTML 等）通过 mountAIBlueking、mountChatBot 挂载小鲸，无需宿主安装 Vue
  • 导出同源 h、render、createApp，支持自定义 VNode / 侧栏渲染；提供 updateProps、expose / getExpose、unmount 等挂载句柄 API
  • 构建产物：dist/standalone/（ES / UMD / IIFE），IIFE 全局名 AIBluekingStandalone

文档 ​

v2.1.4-beta.7 ​

新功能 ​

  • 侧栏 Tab 自定义渲染：ChatBot / AIBlueking 支持 getSideRenderComponent、getSideTabRenderComponent、onCustomTabChange，用于自定义 FlowAgent 节点详情等内容区与 Tab 标签；未传 onCustomTabChange 时，Flow 节点 Tab 仍走内置 getFlowAgentTaskNodeInfo
  • 导出类型 GetSideRenderComponent、GetSideTabRenderComponent、OnCustomTabChange

文档 ​

v2.1.4-beta.6 ​

新功能 ​

  • 蓝鲸行内富文本：AI 消息支持 ::bk{属性}正文:/bk:: 语法，在安全白名单内渲染颜色、加粗、斜体、背景色、字号（1–72px），无需开启 HTML 解析
  • 行内正文仍支持标准 Markdown（加粗、链接、行内代码等）

变更 ​

  • Markdown 渲染不再解析任意 HTML 标签；行内样式请使用蓝鲸行内富文本语法，详见 蓝鲸行内富文本

文档 ​

v2.1.4-beta.2 ​

新功能 ​

  • 消息自定义渲染: 支持在 AI 对话中嵌入自定义组件，包括图表、iframe、表单等任意自定义内容
  • 新增 parseCustomBlocks 工具函数，将消息内容解析为文本块与自定义组件块的混合列表
  • 通过 #message 插槽集成自定义渲染器，业务方可灵活扩展组件类型
  • 支持混合展示文本与多个自定义组件，AI 可在一条消息中输出多种组件

文档 ​

v2.0.0-beta.1 ​

重大变更 ​

  • 三层模块化架构: 从单体组件重构为 ai-blueking + chat-x + chat-helper 三个独立包
  • 新增 ChatBot 组件: 可独立使用的轻量聊天组件
  • Manager 模式: 引入 6 个业务管理器，提高代码可维护性和可扩展性
  • AG-UI 流式协议: 基于 AGUIProtocol 的全新流式响应处理
  • TypeScript 全覆盖: 所有组件和 SDK 均提供完整类型定义

新功能 ​

  • ChatBot 组件支持独立模式和集成模式
  • AIBlueking 组件支持悬浮球、拖拽、划词选择
  • useChatBootstrap 自动初始化生命周期
  • 消息分享功能（内置 + 自定义两种模式）
  • 批量删除会话 (batchDeleteSessions)
  • 会话重命名 (renameSession)
  • 消息反馈系统（like/unlike + 原因选择）
  • 文件上传支持
  • 提示词（/ 触发）和资源（@ 触发）快捷输入
  • 快捷操作支持表单字段配置

包结构 ​

包名说明
@blueking/ai-blueking业务集成层，提供 AIBlueking 和 ChatBot 组件
@blueking/chat-xUI 组件层，提供 ChatInput、MessageContainer 等原子组件
@blueking/chat-helper核心 SDK 层，提供 useChatHelper、AGUIProtocol 等

迁移指南 ​

从 v1.x 迁移请参考 迁移指南。

v1.3.2 2026-01-09 ​

新功能 ​

  • 快捷指令新增 alias 字段，支持显示与原始名称不同的别名
  • 组件级别新增 fillBack 和 fillRegx 字段，支持更细粒度的文本填充控制
  • 新增 agentInfo 属性暴露，可通过组件 ref 访问智能体的完整配置信息

优化 ​

  • 划词弹窗支持从智能体配置的 conversationSettings.enableWordSelectionPopup 动态控制
  • 优化划词选择的事件监听器管理，使用 watch 动态添加/移除监听器
  • 移除 motion-v 动画库依赖，简化输入框组件渲染逻辑，提升性能
  • 重构问候语高度计算逻辑，优化输入框位置的联动计算

修复 ​

  • 修复从历史会话恢复时会话切换的状态问题
  • 修复输入框在某些情况下定位不准确的问题

v1.3.1 2026-01-06 ​

新功能 ​

  • 核心架构重构：提取聊天核心逻辑到独立的 use-chat-core composable
  • 新增 use-iframe-drag-resize composable，优化 iframe 内的拖拽和调整大小体验
  • Props 类型系统增强：新增独立的 Props 类型定义和默认值配置模块
  • 快捷方式编辑功能修复：支持 shortcut 消息的编辑和重新发送
  • 新增 init-session-finished 事件

优化 ​

  • 优化快捷方式功能，动态合并当前快捷方式与原始快捷方式数据
  • 重构模板条件判断顺序，编辑模式优先于显示模式
  • 更新 dayjs 和 markdown-it 依赖版本

修复 ​

  • 修复 shortcut 消息编辑功能无法显示的问题
  • 修复 useChatCore 中 TypeScript 类型定义问题

v1.3.0 2025-12-12 ​

重要提醒

小鲸 1.3.0 版本必须与后端 SDK 版本 1.0.5.post3 或更高版本匹配使用。

新功能 ​

  • 新增分享会话功能，支持选择对话内容进行分享
  • dropdownMenuConfig.showShare 默认启用
  • 新增 Cmd/Ctrl + I 快捷键，支持快速切换面板显示/隐藏
  • 快捷指令支持动态更新

优化 ​

  • 修复 iframe 上拖拽失效的问题
  • 修复 HTTP 协议下剪切板操作失败的问题
  • 改进 Vue2 样式兼容性

v1.2.9 2025-10-23 ​

新功能 ​

  • 优化小鲸指令配置，支持 simple 配置模式
  • 无权限页面优化，添加权限检查机制
  • 新增 showCompressionIcon、showMoreIcon、defaultChatInputPosition、maxWidth 等 props 配置项

v1.2.8 2025-10-17 ​

重要提醒

小鲸 1.2.8 版本必须与后端 SDK 版本 1.0.0b48 或更高版本匹配使用。

新功能 ​

  • 新增会话创建参数配置
  • 新增 feedback 功能，优化反馈交互体验
  • 新增 iconRender 支持以自定义图标渲染
  • 优化 markdown-viewer 组件的 cite 文本处理
  • 新增更新位置和大小的功能

v1.2.7 2025-10-14 ​

新功能 ​

  • 新增 hideDefaultTrigger 属性，支持隐藏默认触发按钮
  • 新增 dropdownMenuConfig 属性，自定义会话操作下拉菜单
  • 新增 placeholder 属性，自定义输入框占位符
  • handleShow 方法新增 forceNewSession 参数
  • 新增 updatePosition、updateSize、updatePositionAndSize 方法
  • 新增 drag-stop、resize-stop、dragging、resizing 事件
  • 历史会话面板新增时间分组

v1.2.6 2025-09-18 ​

重要提醒

小鲸 1.2.6 版本必须与后端 SDK 版本 1.0.0b42 或更高版本匹配使用。

新功能 ​

  • 新增 setCiteText 方法，支持编程式设置引用文本
  • 群聊咨询用户名支持
  • 动态群聊名称生成

v1.2.5 2025-09-12 ​

新功能 ​

  • 新增 loadRecentSessionOnMount 属性
  • 新增 403 错误页面支持
  • 新增人工反馈功能
  • 新增选择模式功能

v1.2.4 2025-09-03 ​

新功能 ​

  • 新增 beforeRequest 钩子支持
  • 划选过滤增强，改进划选文本检测逻辑
  • 新增 hide 属性，支持动态控制快捷操作表单组件的显示/隐藏
  • 新增 shortcutFilter 属性，支持根据选中文本内容动态过滤快捷操作

v1.2.3 2025-08-12 ​

新功能 ​

  • 新增会话自动命名功能
  • 增强快捷指令功能，支持自定义表单交互
  • 新增 extCls 属性

v1.2.2 2025-08-06 ​

新功能 ​

  • 新增编程式会话管理 API
  • 新增 addNewSession、updateSessionName、switchToSession、getSessionList 方法
  • 新增 initialSessionCode 和 autoSwitchToInitialSession 属性

v1.2.0 2025-07-30 ​

新功能 ​

  • 新增自定义表单输入功能
  • 快捷操作接口从 ShortCut 升级为 IShortcut
  • 新增 components 组件配置

破坏性变更 ​

  • 快捷操作接口由 ShortCut 更改为 IShortcut
  • 快捷操作改为将表单数据发送到后端，需要后端适配

v1.1.0 2025-07-07 ​

新功能 ​

  • 多会话管理功能
  • 动态标题显示
  • 新增 showHistoryIcon 和 showNewChatIcon 属性

破坏性变更 ​

  • 会话管理架构重构，后端 SDK 需要更新至最新版

v1.0.0 2025-05-27 ​

新功能 ​

  • 全新架构设计
  • 增强的界面适配能力
  • 优化交互体验

破坏性变更 ​

  • 不再暴露 sendChat 方法，请使用 sendMessage
  • 预设对话内容不再支持 defaultMessages，需在平台配置

v0.5.0 2025-03-28 ​

新功能 ​

  • 全新 UI 设计，界面彻底重构
  • 支持窗口拖拽和调整大小
  • 新增 Nimbus 支持，内置弹出式交互
  • 新增预设提示词列表功能

All Rights Reserved. 腾讯蓝鲸 版权所有

Copyright © 2025 Blueking