Lighthouse AI SDK 适配 KiKi 集成更新说明

Lighthouse AI SDK 适配 KiKi 集成更新说明

Lighthouse AI SDK 适配 KiKi 集成更新说明

1\\. 版本概览

本次更新实现了 Lighthouse AI SDK 与腾讯云 KiKi 容器的深度集成，面向使用 tea-app-cvm 和 lighthouse 业务的用户，提供更统一的 AI 助手交互体验。您现在可以通过 KiKi 浮窗直接使用 AI 助手，无需业务方自行维护浮窗组件，同时支持跨路由保留对话上下文，避免频繁重建会话。

2\\. 新增能力

• 统一交互容器

AI 助手入口全面接入 KiKi 容器，支持悬浮/侧边/全屏等多种展示模式，提供拖拽、缩放、主题切换等操作功能。

• 跨路由会话保持

在腾讯云控制台切换路由时，AI 助手对话上下文将常驻容器，避免传统模式下因页面切换导致的会话中断。

• 字段无缝迁移

业务方原有传入的配置字段（如 handlerShortTermEmphasisPrompt）可直接复用，无需修改字段名称或结构。

• 统一操作入口

「新对话」「历史会话」等核心操作按钮由 KiKi 容器统一渲染，确保操作界面一致性。

3\\. 体验优化

• 消除双层浮窗问题

通过强制启用 displayType='embedded' 模式，彻底解决原 SDK 浮窗与 KiKi 容器叠加导致的双重关闭按钮和界面冲突问题。

• 动态样式持久化

修复 SDK 内部 UI 工具动态注入的 CSS 样式在路由切换后失效的问题，确保跨路由操作时视觉元素完整保留。

4\\. 升级建议

1. 入口迁移

在业务页面初始化阶段调用 api.addCVMTab(opts) 挂载 tab，按钮点击事件改为调用 api.show() 激活容器。

1. 状态管理

优先采用路径 A（推荐）推动 SDK 维护方升级支持 perInstance scope，确保多 tab 并发时的数据隔离。

1. 样式修复

检查 SDK 中所有动态注入 CSS 的位置，统一添加 data-role="global" 属性以避免路由切换导致的样式失效。。