@blueking/ai-ui-sdk 0.4.1-beta.9 → 0.4.2

package/README.md

@@ -1,290 +1,2258 @@
 # @blueking/ai-ui-sdk
 
-蓝鲸 AI UI SDK 是一个用于快速构建 AI 聊天界面的 Vue 3 组件库。该 SDK 提供了一系列易用的 Hooks 和工具，帮助开发者轻松集成 AI 对话、内容总结、样式管理等功能。
+蓝鲸 AI UI SDK（Vue 3），提供资源卡片、搜索栏、数据集、Markdown、表格等业务组件，以及 Hooks、HTTP、类型与工具方法。
+
+当前版本：`0.4.1-beta.18`
 
 ## 安装
 
-```bash
-npm install @blueking/ai-ui-sdk
-# 或
-yarn add @blueking/ai-ui-sdk
-```
+```bash
+npm install @blueking/ai-ui-sdk
+# 或
+yarn add @blueking/ai-ui-sdk
+```
+
+### Peer Dependencies
+
+请确保宿主项目已安装（版本参考 `package.json`）：
+
+- `vue` ^3.5
+- `vue-router` ^4
+- `bkui-vue`
+- `tdesign-vue-next`
+- `@toast-ui/editor`、`@toast-ui/editor-plugin-code-syntax-highlight`
+- `@blueking/ediatable`、`@blueking/xss-filter`
+- `dayjs`、`katex`、`prismjs`、`tippy.js`
+
+## 子路径导出
+
+本包通过子路径导出，**无根路径默认入口**，请按需引入：
+
+| 子路径 | 说明 |
+|--------|------|
+| `@blueking/ai-ui-sdk/components` | 公开组件 + `renderAuthDialog` |
+| `@blueking/ai-ui-sdk/hooks` | 通用 Hooks |
+| `@blueking/ai-ui-sdk/https` | 资源 HTTP Hooks |
+| `@blueking/ai-ui-sdk/types` | TypeScript 类型 |
+| `@blueking/ai-ui-sdk/enums` | 枚举 |
+| `@blueking/ai-ui-sdk/events` | 全局事件总线 |
+| `@blueking/ai-ui-sdk/constants` | 常量 |
+| `@blueking/ai-ui-sdk/util` | 工具函数 |
+| `@blueking/ai-ui-sdk/transforms` | API ↔ 前端模型转换 |
+| `@blueking/ai-ui-sdk/style` | 样式 CSS |
+| `@blueking/ai-ui-sdk/g-utilities-manifest` | g-utilities manifest |
+
+```ts
+import { RenderAgentCard, RenderHeader } from '@blueking/ai-ui-sdk/components';
+import { useStyle, useClickProxy } from '@blueking/ai-ui-sdk/hooks';
+import { useAgentHttp } from '@blueking/ai-ui-sdk/https';
+import { ResourceCardType, Module } from '@blueking/ai-ui-sdk/enums';
+```
+
+## 快速开始
+
+```ts
+import { useStyle, useClickProxy } from '@blueking/ai-ui-sdk/hooks';
+
+// 应用入口调用一次，注入 SDK 全局样式
+useStyle();
+
+// 如需代码块折叠 / 全屏 / 复制 / 下载等点击代理
+useClickProxy();
+```
+
+---
+
+## 组件 API
+
+以下组件均从 `@blueking/ai-ui-sdk/components` 引入。每个组件均按以下四块说明，**各自单独成段**：
+
+- **Props**：属性表；无则写「无」
+- **Events**：事件表；无则写「无」
+- **Expose**：方法表；无则写「无」
+- **Slots**：插槽表；无则写「无」
+
+> 约定：`required`（✓）表示必传；其余为可选。类型名来自 `@blueking/ai-ui-sdk/types` / `enums`。
+
+### 目录
+
+- [基础 UI](#基础-ui)
+- [Agent](#agent)
+- [资源卡片](#资源卡片)
+- [搜索栏](#搜索栏)
+- [操作与内容](#操作与内容)
+- [数据集](#数据集)
+- [弹窗与关联](#弹窗与关联)
+- [Markdown](#markdown)
+- [命令式 API](#命令式-api)
+
+---
+
+### 基础 UI
+
+#### RenderAutoHeightTextarea
+
+自适应高度文本域。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| modelValue | `string` | | | 绑定值 |
+| placeholder | `string` | | | 占位文案 |
+| height | `number` | ✓ | | 初始高度 |
+| maxHeight | `number` | | `400` | 最大高度 |
+| focusShowHeight | `boolean` | | `false` | 聚焦时展开高度 |
+| disabled | `boolean` | | | 禁用 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| update:modelValue | `(val: string)` | v-model |
+| input | `(val: string, event?: KeyboardEvent)` | 输入 |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderAutoRefresh
+
+自动刷新间隔选择。
+
+**Props**
+
+无
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| update | `()` | 触发刷新（含定时） |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderCheckbox
+
+自定义复选框。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| checked | `boolean` | ✓ | | 是否选中 |
+| indeterminate | `boolean` | | | 半选 |
+| disabled | `boolean` | | | 禁用 |
+| title | `string` | | | 标题 |
+| suffixTitle | `string` | | | 后缀标题 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| change | `(checked: boolean)` |
+| update:checked | `(checked: boolean)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderChooseTag
+
+标签选择器。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| modelValue | `string[][]` | ✓ | | 已选标签 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| module | `Module` | ✓ | | 所属模块 |
+| multiple | `boolean` | | | 多选 |
+| spaceId | `string` | | | 空间 ID |
+| isDataset | `boolean` | | | 数据集场景 |
+| isEnabledCreateTag | `boolean` | | | 允许新建标签 |
+| disabled | `boolean` | | | 禁用 |
+| popoverOptions | `Record<string, unknown>` | | | Popover 配置 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| update:modelValue | `(value: string[][])` |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderDropdown
+
+基于 Tippy 的下拉容器。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| placement | `Placement` | | `'bottom-start'` | 弹出位置 |
+| arrow | `boolean` | | `false` | 箭头 |
+| theme | `'light' \| 'light-border' \| 'material' \| 'translucent'` | | `'light'` | 主题 |
+| animation | `'fade' \| 'shift-away' \| 'shift-toward' \| 'scale' \| 'perspective'` | | `'shift-away'` | 动画 |
+| delay | `number \| [number \| null, number \| null]` | | `[0, 100]` | 延迟 |
+| maxWidth | `number \| string` | | `'none'` | 最大宽度 |
+| disabled | `boolean` | | `false` | 禁用 |
+| beforeHide | `(instance: Instance) => boolean` | | | 隐藏前钩子 |
+| tippyOptions | `Partial<Props>` | | | Tippy 透传配置 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| show / hide / mount / shown / hidden | `(instance: Instance)` |
+
+**Expose**
+
+| 方法 | 说明 |
+|------|------|
+| show() | 显示下拉 |
+| hide() | 隐藏下拉 |
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| trigger | — | 触发器 |
+| content | — | 下拉内容 |
+
+---
+
+#### RenderFileTypeIcon
+
+文件类型图标。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| type | `string` | ✓ | 文件类型 |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderGenerateTag
+
+资源生成类型标签。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| generateType | `EnumCharacter` | | | 生成类型 |
+| module | `Module` | | | 模块 |
+| isPublic | `boolean` | | | 是否公开 |
+| showTips | `boolean` | | `true` | 展示提示 |
+| spaceId | `string` | | | 空间 ID |
+| spaces | `ISpace[]` | | | 空间列表 |
+| height | `number \| string` | | `16` | 高度 |
+| fontSize | `number \| string` | | `12` | 字号 |
+| padding | `number \| string` | | `2` | 内边距 |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderHeader
+
+资源页头部（标题 / 分组 Tab）。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| title | `string` | | 标题 |
+| groupType | `GroupType` | | 当前分组 |
+| loading | `boolean` | | 加载中 |
+| tabs | `{ id: GroupType; name: string; number: number; tooltip?: string }[]` | | Tab 列表 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| update:groupType | `(val: GroupType)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| title | — | 自定义标题 |
+| title-right | — | 标题右侧 |
+| action-right | — | 操作区右侧 |
+
+---
+
+#### RenderImage
+
+带默认图回退的图片。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| url | `string` | ✓ | 图片地址 |
+| size | `number` | ✓ | 尺寸 |
+| defaultUrl | `string` | | 失败回退图 |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderSearchEmpty
+
+空态 / 无搜索结果。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| search | `T` | | 当前搜索条件 |
+| scene | `'page' \| 'part'` | | 展示场景 |
+| description | `string` | | 描述文案 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| update:search | `(data: T)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderSearchSelect
+
+增强搜索选择。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| data | `ISearchSelectItem[]` | ✓ | | 筛选项配置 |
+| modelValue | `T` | ✓ | | 绑定值 |
+| placeholder | `string` | | | 占位 |
+| validateValues | `ValidateValue` | | | 校验 |
+| getMenuList | `Function` | | | 菜单列表 |
+| isShowTagSearch | `boolean` | | | 展示标签搜索 |
+| apiPrefix | `string` | | | API 前缀 |
+| spaceId | `string` | | | 空间 ID |
+| module | `Module` | | | 模块 |
+| fuzzyKey | `string` | | `'fuzzy'` | 模糊搜索字段名 |
+| isFuzzyEnabled | `boolean` | | `true` | 是否启用模糊搜索 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| update:modelValue | `(value: T)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderSelectPlusExtension
+
+Select 扩展「去新建」。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 |
+|------|------|------|--------|
+| text | `string` | | `'去新建'` |
+| icon | `string` | | |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderTags
+
+多行标签溢出展示。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 |
+|------|------|------|--------|
+| tagNames | `string[][]` | ✓ | |
+| height | `number \| string` | | `16` |
+| fontSize | `number \| string` | | `10` |
+| padding | `number \| string` | | `4` |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderResourceVersion
+
+资源版本标签。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 |
+|------|------|------|--------|
+| version | `string` | | |
+| height | `number \| string` | | `16` |
+| fontSize | `number \| string` | | `10` |
+| padding | `number \| string` | | `4` |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderResourceInfo
+
+资源元信息展示。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| type | `ResourceCardType` | ✓ | 卡片类型 |
+| updatedBy | `string` | ✓ | 更新人 |
+| updatedAt | `string` | ✓ | 更新时间 |
+| code | `string` | | 编码 |
+| id | `number` | | ID |
+| spaceId | `string` | | 空间 ID |
+| appliedBy | `string` | | 申请人 |
+| appliedAt | `string` | | 申请时间 |
+| spaces | `ISpace[]` | | 空间列表 |
+| version | `string` | | 版本 |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderTTable
+
+TDesign 增强表格封装。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| columns | `ITTableCol<T>[]` | ✓ | | 列配置 |
+| tableData | `T[]` | ✓ | | 表格数据 |
+| rowKey | `string` | ✓ | | 行唯一键 |
+| isLoading | `boolean` | | | 加载中 |
+| pagination | `IPagination` | | | 分页 |
+| layout | `string[]` | | 有分页时为 `['total','limit','list']` | 分页布局 |
+| containerHeight | `string` | | | 容器高度 |
+| search | `S` | | | 搜索条件 |
+| rowClassName | `string \| string[] \| Record \| ((row, index) => ...)` | | | 行 class |
+| height | `string` | | | 表格高度 |
+| paginationBorder | `boolean` | | | 分页边框 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| sort-change | `(config, val)` |
+| page-change | `(val: number)` |
+| page-size-change | `(val: number)` |
+| select-change | `(keys, selectedRowData: T[])` |
+| row-click / row-mouseenter | `(row: T)` |
+| row-mouseleave | `()` |
+| update:search | `(search: S)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| expandedRow | `{ row: T }` | 展开行内容 |
+
+---
+
+#### RenderTagTree
+
+资源标签树。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| module | `Module` | ✓ | 模块 |
+| subModule | `Module` | ✓ | 子模块 |
+| tagName | `string` | ✓ | 标签名 |
+| apiPrefix | `string` | ✓ | API 前缀 |
+| tagId | `number` | | 标签 ID |
+| groupType | `GroupType` | | 分组 |
+| generateType | `EnumCharacter` | | 生成类型 |
+| spaceId | `string` | | 空间 ID |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| update:tag-id | `(tagId: number)` |
+| update:tagName | `(tagName: string)` |
+
+**Expose**
+
+| 方法 | 说明 |
+|------|------|
+| handleGetTagsTree() | 重新拉取标签树 |
+
+**Slots**
+
+无
+
+---
+
+#### RenderTree
+
+通用异步树。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| data | `T[]` | ✓ | | 树数据 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| keyName | `keyof T` | ✓ | | 节点主键字段 |
+| search | `S` | | | 搜索条件 |
+| spaceId | `string` | | | 空间 ID |
+| selectedId | `string \| number` | | | 选中节点 |
+| loadingIds | `(string \| number)[]` | | | 加载中节点 |
+| openedIds | `(string \| number)[]` | | | 展开节点 |
+| permissionActionIds | `(string \| number)[]` | | | 权限相关 ID |
+| chooseCheck | `(data: T) => Promise<boolean>` | | `() => Promise.resolve(true)` | 选中前校验 |
+| isNodeHasChildren | `(data: T) => boolean` | | | 是否有子节点 |
+| isNodeHasPermission | `(data: T) => boolean` | | `() => true` | 是否有权限 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| update:selectedId | `(value: string \| number)` |
+| update:loadingIds / update:openedIds | `(value: (string \| number)[])` |
+| select / async-load | `(node: T)` |
+| update:search | `(value: S)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| default | `(data: T)` | 节点内容 |
+
+---
+
+### Agent
+
+#### RenderAgentDownload
+
+智能体下载按钮。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| apiPrefix | `string` | ✓ | API 前缀 |
+| agent | `IAgent` | | 智能体 |
+| spaceId | `string` | | 空间 ID |
+| disabled | `boolean` | | 禁用 |
+| disabledText | `string` | | 禁用提示 |
+| needSaveBeforeDownload | `boolean` | | 下载前需保存 |
+| text | `boolean` | | 是否展示文字 |
+| size | `'' \| 'small'` | | 尺寸 |
+| validate | `() => Promise<unknown>` | | 下载前校验 |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderAgentSearch
+
+智能体列表搜索栏。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| search | `IAgentListParam` | ✓ | 搜索条件 |
+| apiPrefix | `string` | ✓ | API 前缀 |
+| memberUrl | `string` | ✓ | 成员搜索 URL |
+| isShowAllSearchOptions | `boolean` | | 展示全部筛选项 |
+| isShowTagSearch | `boolean` | | 展示标签搜索 |
+| spaceId | `string` | | 空间 ID |
+| module | `Module` | | 模块 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| update:search | `(search: IAgentListParam)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderAgentShare
+
+智能体分享入口。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| agent | `IAgent` | ✓ | 智能体 |
+| apiPrefix | `string` | ✓ | API 前缀 |
+| showIcon | `boolean` | | 展示图标 |
+| spaceId | `string` | | 空间 ID |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderAgentType
+
+智能体类型标签（单智能体 / 流程）。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 |
+|------|------|------|--------|
+| type | `AgentType` | ✓ | |
+| height | `number \| string` | | `16` |
+| fontSize | `number \| string` | | `10` |
+| padding | `number \| string` | | `4` |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+### 资源卡片
+
+以下卡片组件各自列出完整 Props，不再用「共性」省略。
+
+#### RenderAgentCard
+
+智能体资源卡片。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| agent | `T extends IAgent \| IApplicationAgent` | ✓ | | 智能体数据 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| commands | `IAgentCommand[]` | | | 指令列表 |
+| originAgentId | `number` | | | 来源智能体 ID |
+| checked | `boolean` | | | 是否选中 |
+| multiple | `boolean` | | | 是否多选 |
+| disabled | `boolean` | | | 是否禁用 |
+| isShowOperation | `boolean` | | | 是否展示操作 |
+| groupType | `GroupType` | | | 分组类型 |
+| isShowCheckbox | `boolean` | | | 是否展示复选框 |
+| spaceId | `string` | | | 空间 ID |
+| spaces | `ISpace[]` | | | 空间列表 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| defaultIcon | `string` | | | 默认图标 |
+| showGenerateType | `boolean` | | | 是否展示生成类型 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| delete | `(agent: T)` | 删除 |
+| choose | `(agent: T)` | 选择 |
+| edit | `(agent: T)` | 编辑 |
+| success-delete | `()` | 删除成功 |
+| success-restore | `()` | 恢复成功 |
+| update:commands | `(commands: IAgentCommand[])` | 指令更新 |
+| navigate | `(route: ISdkNavigateAction)` | 导航 |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| pre-actions | — | 操作区前置内容 |
+
+---
+
+#### RenderAgentCommandCard
+
+智能体指令卡片。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| command | `IAgentCommand` | ✓ | | 指令 |
+| agent | `IAgent` | ✓ | | 所属智能体 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| disabled | `boolean` | | | 是否禁用 |
+| checked | `boolean` | | | 是否选中 |
+| isShowOperation | `boolean` | | | 是否展示操作 |
+| spaces | `ISpace[]` | | | 空间列表 |
+| defaultIcon | `string` | | | 默认图标 |
+| showGenerateType | `boolean` | | | 是否展示生成类型 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| choose | `(command: IAgentCommand)` | 选择 |
+| delete | `(command: IAgentCommand)` | 删除 |
+| edit | `(command: IAgentCommand)` | 编辑 |
+| edit-alias | `(command: IAgentCommand)` | 编辑别名 |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| pre-actions | — | 操作区前置内容 |
+
+---
+
+#### RenderKnowledgeCard
+
+知识资源卡片。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| knowledge | `T extends IKnowledge` | ✓ | | 知识数据 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| commands | `IAgentCommand[]` | | | 指令列表 |
+| originAgentId | `number` | | | 来源智能体 ID |
+| disabled | `boolean` | | | 是否禁用 |
+| showDeleteTips | `boolean` | | | 是否展示删除提示 |
+| checked | `boolean` | | | 是否选中 |
+| multiple | `boolean` | | | 是否多选 |
+| isShowOperation | `boolean` | | | 是否展示操作 |
+| isShowCheckbox | `boolean` | | | 是否展示复选框 |
+| spaces | `ISpace[]` | | | 空间列表 |
+| showGenerateType | `boolean` | | | 是否展示生成类型 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| choose | `(knowledge: T)` | 选择 |
+| delete | `(knowledge: T)` | 删除 |
+| navigate | `(value: ISdkNavigateAction)` | 导航 |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| pre-actions | — | 操作区前置内容 |
+
+---
+
+#### RenderKnowledgebaseCard
+
+知识库卡片。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| knowledgebase | `T extends IKnowledgebase \| IApplicationKnowledgebase` | ✓ | | 知识库数据 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| commands | `IAgentCommand[]` | | | 指令列表 |
+| originAgentId | `number` | | | 来源智能体 ID |
+| disabled | `boolean` | | | 是否禁用 |
+| showDeleteTips | `boolean` | | | 是否展示删除提示 |
+| checked | `boolean` | | | 是否选中 |
+| multiple | `boolean` | | | 是否多选 |
+| isShowOperation | `boolean` | | | 是否展示操作 |
+| isShowCheckbox | `boolean` | | | 是否展示复选框 |
+| isClickToView | `boolean` | | | 点击是否查看 |
+| spaceId | `string` | | | 空间 ID |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| spaces | `ISpace[]` | | | 空间列表 |
+| showGenerateType | `boolean` | | | 是否展示生成类型 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| delete | `(knowledgebase: T)` | 删除 |
+| choose | `(knowledgebase: T)` | 选择 |
+| view | `(knowledgebase: T)` | 查看 |
+| success-delete | `()` | 删除成功 |
+| navigate | `(value: ISdkNavigateAction)` | 导航 |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| pre-actions | — | 操作区前置内容 |
+
+---
+
+#### RenderLlmCard
+
+LLM 模型卡片。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| model | `T extends IModel` | ✓ | | 模型数据 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| commands | `IAgentCommand[]` | | | 指令列表 |
+| originAgentId | `number` | | | 来源智能体 ID |
+| disabled | `boolean` | | | 是否禁用 |
+| showDeleteTips | `boolean` | | | 是否展示删除提示 |
+| checked | `boolean` | | | 是否选中 |
+| isShowOperation | `boolean` | | | 是否展示操作 |
+| spaceId | `string` | | | 空间 ID |
+| spaces | `ISpace[]` | | | 空间列表 |
+| selfHostUrl | `string` | ✓ | | 自建地址 |
+| externalUrl | `string` | ✓ | | 外部地址 |
+| models | `IModel[]` | ✓ | | 模型列表 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| showGenerateType | `boolean` | | | 是否展示生成类型 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| success-delete | `()` | 删除成功 |
+| choose | `(model: T)` | 选择 |
+| toggle-like | `(model: T)` | 点赞 |
+| toggle-dislike | `(model: T)` | 点踩 |
+| navigate | `(value: ISdkNavigateAction)` | 导航 |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| pre-actions | — | 操作区前置内容 |
+
+---
+
+#### RenderMcpCard
+
+MCP 卡片。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| mcp | `T extends IMcp \| IApplicationMcp` | ✓ | | MCP 数据 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| commands | `IAgentCommand[]` | | | 指令列表 |
+| originAgentId | `number` | | | 来源智能体 ID |
+| disabled | `boolean` | | | 是否禁用 |
+| showDeleteTips | `boolean` | | | 是否展示删除提示 |
+| checked | `boolean` | | | 是否选中 |
+| multiple | `boolean` | | | 是否多选 |
+| isShowOperation | `boolean` | | | 是否展示操作 |
+| groupType | `GroupType` | | | 分组类型 |
+| isShowCheckbox | `boolean` | | | 是否展示复选框 |
+| isClickToView | `boolean` | | | 点击是否查看 |
+| spaceId | `string` | | | 空间 ID |
+| spaces | `ISpace[]` | | | 空间列表 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| defaultIcon | `string` | | | 默认图标 |
+| showGenerateType | `boolean` | | | 是否展示生成类型 |
+| approvalSettings | `IApprovalSetting[]` | | | 审批配置 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| success-delete | `()` | 删除成功 |
+| success-restore | `()` | 恢复成功 |
+| navigate | `(value: ISdkNavigateAction)` | 导航 |
+| edit | `(mcp: T)` | 编辑 |
+| choose | `(mcp: T)` | 选择 |
+| settings | `(mcp: T)` | 设置 |
+| view | `(mcp: T)` | 查看 |
+| delete | `(mcp: T)` | 删除 |
+| update:mcp | `(mcp: T)` | MCP 更新 |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| pre-actions | — | 操作区前置内容 |
+
+---
+
+#### RenderSelectedToolsInfo
+
+MCP 已选工具与审批信息。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| mcp | `T extends IMcp` | ✓ | | MCP 数据 |
+| approvalSettings | `IApprovalSetting[]` | ✓ | | 审批配置 |
+| disabled | `boolean` | | | 是否禁用 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| update:mcp | `(mcp: T)` | MCP 更新 |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderPromptCard
+
+Prompt 卡片。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| prompt | `T extends IPrompt \| IApplicationPrompt` | ✓ | | Prompt 数据 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| commands | `IAgentCommand[]` | | | 指令列表 |
+| originAgentId | `number` | | | 来源智能体 ID |
+| disabled | `boolean` | | | 是否禁用 |
+| showDeleteTips | `boolean` | | | 是否展示删除提示 |
+| checked | `boolean` | | | 是否选中 |
+| multiple | `boolean` | | | 是否多选 |
+| isShowOperation | `boolean` | | | 是否展示操作 |
+| isShowCheckbox | `boolean` | | | 是否展示复选框 |
+| isClickToView | `boolean` | | | 点击是否查看 |
+| spaceId | `string` | | | 空间 ID |
+| spaces | `ISpace[]` | | | 空间列表 |
+| defaultModelId | `string` | ✓ | | 默认模型 ID |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| showGenerateType | `boolean` | | | 是否展示生成类型 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| success-delete | `()` | 删除成功 |
+| toggle-like | `()` | 点赞切换 |
+| success-restore | `()` | 恢复成功 |
+| choose | `(prompt: T)` | 选择 |
+| delete | `(prompt: T)` | 删除 |
+| view | `(prompt: T)` | 查看 |
+| edit | `(prompt: T)` | 编辑 |
+| navigate | `(value: ISdkNavigateAction)` | 导航 |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| pre-actions | — | 操作区前置内容 |
+
+---
+
+#### RenderRoleCard
+
+角色 / Collection 卡片。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| role | `T extends ICollection \| IApplicationCollection` | ✓ | | 角色数据 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| commands | `IAgentCommand[]` | | | 指令列表 |
+| originAgentId | `number` | | | 来源智能体 ID |
+| disabled | `boolean` | | | 是否禁用 |
+| showDeleteTips | `boolean` | | | 是否展示删除提示 |
+| checked | `boolean` | | | 是否选中 |
+| multiple | `boolean` | | | 是否多选 |
+| isShowOperation | `boolean` | | | 是否展示操作 |
+| isShowCheckbox | `boolean` | | | 是否展示复选框 |
+| isClickToView | `boolean` | | | 点击是否查看 |
+| roleTypes | `ILLMPromptRole[]` | ✓ | | 角色类型列表 |
+| defaultModelId | `string` | ✓ | | 默认模型 ID |
+| spaceId | `string` | | | 空间 ID |
+| spaces | `ISpace[]` | | | 空间列表 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| showGenerateType | `boolean` | | | 是否展示生成类型 |
+| isSpaceManage | `boolean` | ✓ | | 是否空间管理 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| success-delete | `()` | 删除成功 |
+| success-edit | `()` | 编辑成功 |
+| success-restore | `()` | 恢复成功 |
+| edit | `(role: ICollection)` | 编辑 |
+| copy | `(role: ICollection)` | 复制 |
+| view | `(role: ICollection)` | 查看 |
+| choose | `(role: T)` | 选择 |
+| delete | `(role: T)` | 删除 |
+| navigate | `(value: ISdkNavigateAction)` | 导航 |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| pre-actions | — | 操作区前置内容 |
+
+---
+
+#### RenderSkillCard
+
+Skill 卡片。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| skill | `ISkill` | ✓ | | Skill 数据 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| disabled | `boolean` | | | 是否禁用 |
+| showDeleteTips | `boolean` | | | 是否展示删除提示 |
+| checked | `boolean` | | | 是否选中 |
+| multiple | `boolean` | | | 是否多选 |
+| isShowOperation | `boolean` | | | 是否展示操作 |
+| isShowCheckbox | `boolean` | | | 是否展示复选框 |
+| isClickToView | `boolean` | | | 点击是否查看 |
+| spaceId | `string` | | | 空间 ID |
+| spaces | `ISpace[]` | | | 空间列表 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| defaultIcon | `string` | | | 默认图标 |
+| showGenerateType | `boolean` | | | 是否展示生成类型 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| edit | `(skill: ISkill)` | 编辑 |
+| view | `(skill: ISkill)` | 查看 |
+| choose | `(skill: ISkill)` | 选择 |
+| install | `(skill: ISkill)` | 安装 |
+| update:skill | `(skill: ISkill)` | Skill 更新 |
+| success-delete | `()` | 删除成功 |
+| success-restore | `()` | 恢复成功 |
+| delete | `()` | 删除 |
+| success-download | `(downloadCount: number)` | 下载成功 |
+| show-scanner | `(content: string)` | 展示扫描内容 |
+| navigate | `(value: ISdkNavigateAction)` | 导航 |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| pre-actions | — | 操作区前置内容 |
+
+---
+
+#### RenderToolCard
+
+Tool 卡片。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| tool | `T extends ITool \| IApplicationTool` | ✓ | | Tool 数据 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| commands | `IAgentCommand[]` | | | 指令列表 |
+| originAgentId | `number` | | | 来源智能体 ID |
+| disabled | `boolean` | | | 是否禁用 |
+| showDeleteTips | `boolean` | | | 是否展示删除提示 |
+| checked | `boolean` | | | 是否选中 |
+| multiple | `boolean` | | | 是否多选 |
+| isShowOperation | `boolean` | | | 是否展示操作 |
+| isShowCheckbox | `boolean` | | | 是否展示复选框 |
+| isClickToView | `boolean` | | | 点击是否查看 |
+| spaceId | `string` | | | 空间 ID |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| spaces | `ISpace[]` | | | 空间列表 |
+| showGenerateType | `boolean` | | | 是否展示生成类型 |
+| approvalSettings | `IApprovalSetting[]` | | | 审批配置 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| success-delete | `()` | 删除成功 |
+| success-restore | `()` | 恢复成功 |
+| show-edit | `(tool: T)` | 编辑 |
+| show-debug | `(tool: T)` | 调试 |
+| view | `(tool: T)` | 查看 |
+| choose | `(tool: T)` | 选择 |
+| settings | `(tool: T)` | 设置 |
+| navigate | `(value: ISdkNavigateAction)` | 导航 |
+| update:tool | `(value: ITool)` | Tool 更新 |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| pre-actions | — | 操作区前置内容 |
+
+---
+
+#### RenderApprovalStrategyPopover
+
+审批策略配置 Popover。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| approvalSettings | `IApprovalSetting[]` | ✓ | | 审批配置列表 |
+| approvalEnabled | `boolean` | | | 是否启用审批 |
+| approvalStrategyId | `string` | | | 策略 ID |
+| toolName | `string` | | | 工具名 |
+| disabled | `boolean` | | | 是否禁用 |
+| disabledText | `string` | | | 禁用文案 |
+| placement | `string` | | | 弹出位置 |
+| extCls | `string` | | | 额外 class |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| confirm | `(data: IApprovalSettingValue)` | 确认配置 |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+### 搜索栏
+
+以下搜索组件均通过 `update:search` 双向绑定搜索条件。`RenderAgentSearch` 见 [Agent](#agent) 章节。
+
+#### RenderRoleSearch
+
+Collection 搜索栏。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| search | `ICollectionListParam` | ✓ | | 搜索条件 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| memberUrl | `string` | ✓ | | 成员搜索 URL |
+| isShowAllSearchOptions | `boolean` | | | 展示全部筛选项 |
+| isShowTagSearch | `boolean` | | | 展示标签搜索 |
+| spaceId | `string` | | | 空间 ID |
+| module | `Module` | | | 模块 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| update:search | `(search: ICollectionListParam)` | 搜索条件变更 |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderPromptSearch
+
+Prompt 搜索栏。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| search | `IPromptsParams` | ✓ | | 搜索条件 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| memberUrl | `string` | ✓ | | 成员搜索 URL |
+| isShowAllSearchOptions | `boolean` | | | 展示全部筛选项 |
+| isShowTagSearch | `boolean` | | | 展示标签搜索 |
+| spaceId | `string` | | | 空间 ID |
+| module | `Module` | | | 模块 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| update:search | `(search: IPromptsParams)` | 搜索条件变更 |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderSkillSearch
+
+Skill 搜索栏。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| search | `ISkillListParam` | ✓ | | 搜索条件 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| memberUrl | `string` | ✓ | | 成员搜索 URL |
+| isShowTagSearch | `boolean` | | | 展示标签搜索 |
+| spaceId | `string` | | | 空间 ID |
+| module | `Module` | | | 模块 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| update:search | `(search: ISkillListParam)` | 搜索条件变更 |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderToolSearch
+
+Tool 搜索栏。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| search | `IToolsParam` | ✓ | | 搜索条件 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| memberUrl | `string` | ✓ | | 成员搜索 URL |
+| isShowAllSearchOptions | `boolean` | | | 展示全部筛选项 |
+| isShowTagSearch | `boolean` | | | 展示标签搜索 |
+| spaceId | `string` | | | 空间 ID |
+| module | `Module` | | | 模块 |
 
-## 主要功能
-
-### 1. 聊天功能 (useChat)
-
-`useChat` Hook 提供完整的聊天会话管理能力，包括发送消息、接收回复、管理会话状态等功能。
-
-#### 基本用法
-
-```typescript
-import { useChat } from '@blueking/ai-ui-sdk';
-
-const {
-  currentSession,       // 当前会话信息
-  sessionContents,      // 会话内容列表
-  sendChat,             // 发送消息方法
-  stopChat,             // 停止生成方法
-  setCurrentSession,    // 设置当前会话
-  currentSessionLoading,// 当前会话加载状态
-  reGenerateChat,       // 重新生成回复
-  reSendChat,           // 重新发送消息
-  deleteChat,           // 删除消息
-} = useChat({
-  // 可选回调函数
-  handleStart: (sessionCode, sessionContent) => {
-    // 开始生成回复时的回调
-  },
-  handleText: (sessionCode, sessionContent) => {
-    // 接收到文本时的回调
-  },
-  handleEnd: (sessionCode, sessionContent) => {
-    // 生成完成时的回调
-  },
-  // 请求配置
-  requestOptions: {
-    url: 'https://your-api-endpoint.com',
-    headers: { /* 自定义请求头 */ }
-  }
-});
-
-// 设置当前会话
-setCurrentSession({
-  sessionCode: 'session-1',
-  sessionName: 'My Chat',
-  model: 'gpt-3.5',
-});
-
-// 发送消息
-sendChat({
-  message: '你好，AI 助手',
-  cite: '可选的引用内容',
-});
-
-// 停止生成回复
-stopChat('session-1');
-```
+**Events**
 
-### 2. 内容总结 (useSummary)
-
-`useSummary` Hook 提供文本内容自动总结功能。
-
-```typescript
-import { useSummary } from '@blueking/ai-ui-sdk';
-
-const { summary } = useSummary({
-  handleStart: () => {
-    // 开始总结时的回调
-  },
-  handleEnd: (summaryText) => {
-    // 总结完成时的回调，返回总结文本
-  },
-  handleError: (message, code) => {
-    // 出错时的回调
-  }
-});
-
-// 使用总结功能
-summary({
-  content: '需要总结的长文本内容...',
-  url: 'https://your-summary-api.com',
-  headers: { /* 自定义请求头 */ },
-  model: 'gpt-3.5', // 可选的模型指定
-});
-```
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| update:search | `(search: IToolsParam)` | 搜索条件变更 |
 
-### 3. 点击代理 (useClickProxy)
+**Expose**
 
-`useClickProxy` Hook 提供全局点击事件代理，用于处理代码块展开/收起、全屏显示、复制代码、下载文件等功能。
+无
 
-```typescript
-import { useClickProxy } from '@blueking/ai-ui-sdk';
+**Slots**
 
-// 在组件挂载前添加全局点击代理，卸载前自动移除
-useClickProxy();
-```
+无
 
-### 4. 样式管理 (useStyle)
+---
 
-`useStyle` Hook 用于引入和管理 SDK 所需的全局样式。在应用入口处调用一次即可。
+#### RenderMcpSearch
 
-```typescript
-import { useStyle } from '@blueking/ai-ui-sdk';
+MCP 搜索栏。
 
-// 引入全局样式
-useStyle();
-```
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| search | `IMcpListParam` | ✓ | | 搜索条件 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| memberUrl | `string` | ✓ | | 成员搜索 URL |
+| isShowAllSearchOptions | `boolean` | | | 展示全部筛选项 |
+| isShowTagSearch | `boolean` | | | 展示标签搜索 |
+| spaceId | `string` | | | 空间 ID |
+| module | `Module` | | | 模块 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| update:search | `(search: IMcpListParam)` | 搜索条件变更 |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderKnowledgeSearch
+
+知识搜索栏。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| search | `IKnowledgeListParam['searchbox']` | ✓ | | 搜索条件 |
+| memberUrl | `string` | ✓ | | 成员搜索 URL |
+| isSimple | `boolean` | | | 简洁模式 |
+| isShowStatus | `boolean` | | | 展示状态筛选 |
+| isShowTagSearch | `boolean` | | | 展示标签搜索 |
+| apiPrefix | `string` | | | API 前缀 |
+| spaceId | `string` | | | 空间 ID |
+| module | `Module` | | | 模块 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| update:search | `(search: IKnowledgeListParam['searchbox'])` | 搜索条件变更 |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderKnowledgebaseSearch
+
+知识库搜索栏。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| search | `IKnowledgebaseListParam` | ✓ | | 搜索条件 |
+| memberUrl | `string` | ✓ | | 成员搜索 URL |
+| isShowAllSearchOptions | `boolean` | | | 展示全部筛选项 |
+| isShowTagSearch | `boolean` | | | 展示标签搜索 |
+| apiPrefix | `string` | | | API 前缀 |
+| spaceId | `string` | | | 空间 ID |
+| module | `Module` | | | 模块 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| update:search | `(search: IKnowledgebaseListParam)` | 搜索条件变更 |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderKnowledgeIcon
+
+知识路径类型图标。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| data | `{ id?: number; pathType?: KnowledgePathType; fileType?: string }` | | | 图标数据 |
+| size | `string` | | `'12'` | 尺寸 |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+### 操作与内容
+
+#### RenderRoleActions
+
+角色 / Collection 卡片操作区。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| role | `ICollection` | ✓ | | 角色 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| defaultModelId | `string` | ✓ | | 默认模型 ID |
+| spaceId | `string` | | | 空间 ID |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| isSpaceManage | `boolean` | ✓ | | 是否空间管理 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| success-delete | `()` | 删除成功 |
+| success-restore | `()` | 恢复成功 |
+| edit | `(role: ICollection)` | 编辑 |
+| navigate | `(value: ISdkNavigateAction)` | 导航 |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderRoleContent
+
+角色 / Collection 内容预览。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| role | `ICollection` | ✓ | | 角色 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| roleTypes | `ILLMPromptRole[]` | ✓ | | 角色类型列表 |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderPromptActions
+
+Prompt 卡片操作区。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| prompt | `IPrompt` | ✓ | | Prompt |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| defaultModelId | `string` | ✓ | | 默认模型 ID |
+| spaceId | `string` | | | 空间 ID |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| success-delete | `()` | 删除成功 |
+| success-restore | `()` | 恢复成功 |
+| edit | `(val: IPrompt)` | 编辑 |
+| navigate | `(value: ISdkNavigateAction)` | 导航 |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderPromptContent
+
+Prompt 内容展示。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| content | `string` | ✓ | | 内容文本 |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderSkillActions
+
+Skill 卡片操作区。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| skill | `ISkill` | ✓ | | Skill |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+| spaceId | `string` | | | 空间 ID |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| edit | `(skill: ISkill)` | 编辑 |
+| install | `(skill: ISkill)` | 安装 |
+| success-delete | `()` | 删除成功 |
+| success-restore | `()` | 恢复成功 |
+| success-download | `(downloadCount: number)` | 下载成功 |
+| navigate | `(value: ISdkNavigateAction)` | 导航 |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderSkillIcons
+
+Skill 图标区。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| skill | `ISkill` | ✓ | | Skill |
+| type | `ResourceCardType` | ✓ | | 卡片类型 |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderSkillInstall
+
+Skill 安装弹窗。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| isShow | `boolean` | ✓ | | 是否展示 |
+| selectedSkill | `ISkill` | ✓ | | 选中的 Skill |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| spaceId | `string` | | | 空间 ID |
+
+**Events**
+
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| update:isShow | `(value: boolean)` | 显隐变更 |
+
+**Expose**
+
+无
+
+**Slots**
 
-## 类型定义
-
-SDK 提供了丰富的类型定义，以支持 TypeScript 开发。
-
-### 会话类型
-
-```typescript
-// 会话信息
-interface ISession {
-  sessionCode: string;     // 会话编码
-  sessionName: string;     // 会话名称
-  model: string;           // 使用的模型
-  roleInfo?: {             // 角色信息（可选）
-    collectionId: number;
-    collectionName: string;
-    content: ISessionPrompt[];
-    variables: any[];
-  };
-}
-
-// 会话内容
-interface ISessionContent {
-  id?: number;             // 内容ID
-  role: SessionContentRole;// 角色类型
-  content: string;         // 内容文本
-  status?: SessionContentStatus; // 状态
-  sessionCode: string;     // 所属会话编码
-  cite?: string;           // 引用内容
-  time?: string;           // 时间戳
-}
-
-// 快捷方式
-interface ShortCut {
-  label: string;           // 显示文本
-  key: string;             // 唯一标识
-  prompt: string;          // 提示词模板
-  icon?: string;           // 图标（可选）
-}
+无
+
+---
+
+### 数据集
+
+#### RenderDataset
+
+数据集路由出口，仅渲染 `<router-view />`。
+
+**Props**
+
+无
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderDatasetList
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| apiPrefix | `string` | ✓ | API 前缀 |
+| spaceId | `string` | | 空间 ID |
+| isInternal | `boolean` | | 内部场景 |
+| reviewDataset | `boolean` | | 审核模式 |
+| namePlaceholder | `string` | | 名称占位 |
+| codePlaceholder | `string` | | 编码占位 |
+| memberUrl | `string` | | 成员搜索 URL |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| navigate | `(value: ISdkNavigateAction)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderDatasetDetail
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| apiPrefix | `string` | ✓ | API 前缀 |
+| datasetId | `number` | ✓ | 数据集 ID |
+| spaceId | `string` | | 空间 ID |
+| isInternal | `boolean` | | 内部场景 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| navigate | `(value: ISdkNavigateAction)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderDatasetDetailOriginData
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| apiPrefix | `string` | ✓ | API 前缀 |
+| datasetId | `number` | ✓ | 数据集 ID |
+| spaceId | `string` | | 空间 ID |
+| manageDataset | `boolean` | | 管理权限 |
+| reviewDataset | `boolean` | | 审核权限 |
+| isInternal | `boolean` | | 内部场景 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| update | `()` |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+### 弹窗与关联
+
+#### RenderResourceDialog
+
+资源选择弹窗。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| isShow | `boolean` | ✓ | 是否展示 |
+| module | `Module` | ✓ | 资源模块 |
+| defaultModelId | `string` | ✓ | 默认模型 |
+| roleTypes | `ILLMPromptRole[]` | ✓ | 角色类型 |
+| spaceId | `string` | ✓ | 空间 ID |
+| memberUrl | `string` | ✓ | 成员 URL |
+| username | `string` | ✓ | 当前用户 |
+| spaces | `ISpace[]` | ✓ | 空间列表 |
+| apiPrefix | `string` | ✓ | API 前缀 |
+| title | `string` | | 标题 |
+| tools | `ITool[]` | | 已选 Tool |
+| mcps | `IMcp[]` | | 已选 MCP |
+| knowledges | `IKnowledge[]` | | 已选知识 |
+| knowledgebases | `IKnowledgebase[]` | | 已选知识库 |
+| agents | `IAgent[]` | | 已选智能体 |
+| roles | `ICollection[]` | | 已选角色 |
+| prompts | `IPrompt[]` | | 已选 Prompt |
+| skills | `ISkill[]` | | 已选 Skill |
+| agentId | `number` | | 关联智能体 ID |
+| agentCode | `string` | | 关联智能体编码 |
+| agentType | `AgentType` | | 关联智能体类型 |
+| canApply | `boolean` | | 是否可申请 |
+| multiple | `boolean` | | 是否多选 |
+| showTagSearch | `boolean` | | 是否展示标签搜索 |
+| showSpace | `boolean` | | 是否展示空间 |
+| showGenerateType | `boolean` | | 是否展示生成类型 |
+| defaultIcon | `string` | | 默认图标 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| update:isShow | `(isShow: boolean)` |
+| confirm | `({ tools, mcps, knowledges, knowledgebases, agents, roles, prompts, skills })` |
+| navigate | `(value: ISdkNavigateAction)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| pre-action | — | 操作区前置内容 |
+
+---
+
+#### RenderReference
+
+资源引用关系弹层。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| isShow | `boolean` | ✓ | 是否展示 |
+| module | `Module` | ✓ | 模块 |
+| apiPrefix | `string` | ✓ | API 前缀 |
+| id | `number` | | 资源 ID |
+| name | `string` | | 资源名 |
+| spaceId | `string` | | 空间 ID |
+| spaceName | `string` | | 空间名 |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| update:isShow | `(val: boolean)` |
+| navigate | `(value: ISdkNavigateAction)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderRelateAgent
+
+关联至智能体。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| resourceType | `Module` | ✓ | | 资源类型 |
+| resource | `IAgent \| IMcp \| ISkill \| IModel \| ITool \| IKnowledgebase \| IPrompt \| ICollection` | ✓ | | 资源 |
+| apiPrefix | `string` | ✓ | | API 前缀 |
+| disabled | `boolean` | | | 禁用 |
+| disabledText | `string` | | `''` | 禁用文案 |
+| text | `boolean` | | `true` | 展示文字 |
+| boundary | `string` | | | 边界 |
+| placement | `string` | | `'right'` | 弹出位置 |
+| spaceId | `string` | | | 空间 ID |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| navigate | `(value: ISdkNavigateAction)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+| 插槽 | 参数 | 说明 |
+|------|------|------|
+| trigger | `{ handleShow }` | 触发器（作用域插槽） |
+
+---
+
+### Markdown
+
+#### RenderMarkdownEdit
+
+Toast UI Markdown 编辑器。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 |
+|------|------|------|--------|
+| modelValue | `string` | | |
+| placeholder | `string` | | |
+| height | `string` | | `'500px'` |
+| disabled | `boolean` | | |
+| fontSize | `string` | | `'14px'` |
+| backgroundColor | `string` | | `'#fff'` |
+| mode | `'markdown' \| 'wysiwyg'` | | `'wysiwyg'` |
+| isSimpleToolbar | `boolean` | | `false` |
+
+**Events**
+
+| 事件 | 参数 |
+|------|------|
+| update:modelValue | `(value: string)` |
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+#### RenderMarkdown
+
+Toast UI Markdown 只读预览。
+
+**Props**
+
+| 属性 | 类型 | 必填 | 默认值 |
+|------|------|------|--------|
+| value | `string` | | |
+| previewBackground | `string` | | `'#fff'` |
+| padding | `string` | | `'12px 16px'` |
+
+**Events**
+
+无
+
+**Expose**
+
+无
+
+**Slots**
+
+无
+
+---
+
+### 命令式 API
+
+#### renderAuthDialog
+
+动态挂载权限申请弹窗（非 Vue 组件）。
+
+```ts
+import { renderAuthDialog } from '@blueking/ai-ui-sdk/components';
+
+renderAuthDialog(perm: IPermissionApplyData, cancelCallback?: Function): void
 ```
 
-### 枚举值
-
-```typescript
-// 会话内容角色
-enum SessionContentRole {
-  Ai = 'ai',               // AI 回复
-  User = 'user',           // 用户消息
-  System = 'system',       // 系统消息
-  // ... 更多角色类型
-}
-
-// 会话内容状态
-enum SessionContentStatus {
-  Fail = 'fail',           // 失败
-  Loading = 'loading',     // 加载中
-  Success = 'success',     // 成功
-}
+---
+
+## Hooks
+
+从 `@blueking/ai-ui-sdk/hooks` 引入。
+
+| Hook | 参数 | 返回 / 说明 |
+|------|------|-------------|
+| `useStyle` | — | 副作用注入 SDK CSS，入口调用一次 |
+| `useClickProxy` | `disabledClassName?: string` | 全局点击代理（折叠 / 全屏 / 复制 / 下载） |
+| `useFormLeaveConfirm` | — | `{ handleInitFormLeaveConfirm, handleFormLeaveConfirm }` |
+| `usePermission` | `apiPrefix, spaceId?: Ref<string>, backgroundColor?` | `{ handleMouseEnter, handleMouseMove, handleMouseLeave, handleMouseClick, handleCheckPermission }` |
+| `useMemberHttp` | — | `{ getMemberList(memberUrl, search) }` |
+| `useTTable` | — | `{ isLoading, initHook, sort, handleSortChange, triggerApi, pagination, resetPagination, tableData, handlePageChange, handlePageSizeChange }` |
+| `useEllipsisTooltip` | — | `{ handleInitEllipsisTooltip }` |
+| `useCommonHttp` | `apiPrefix, spaceId?: Ref<string>` | `{ getTagTree }` |
+| `useLoadingVersion` | — | `{ loading, startLoading }`（`startLoading` 返回结束函数） |
+| `useCollection` | `roleTypes: ILLMPromptRole[]` | Collection 展示辅助方法集合 |
+| `useScrollLoad` | `{ targetCls, defaultPageSize?, triggerApi, handleDataLoaded?, handleDataUpdated?, abort? }` | `{ isLoading, datas, handleInitData, handleInitDataImmediately, handleRefreshData, handleRefreshDataWithoutLoading, scrollLoadMore }` |
+| `useClickoutside` | — | `{ handleInitClickoutside(wrapClassName, callback) }` |
+
+---
+
+## HTTPS Hooks
+
+从 `@blueking/ai-ui-sdk/https` 引入。统一签名多为 `(apiPrefix: string, spaceId?: Ref<string>)`。
+
+| Hook | 主要方法 |
+|------|----------|
+| `useAgentHttp` | `getAgentList`、`getAgent`、`debugAgent`、`updateAgent`、`deleteAgent`、`restoreAgent`、`getRelatedAgentCommands`、`resourceApply`、`getAgentCount`、`getAgentReferringAgents`、`getAgentMcpPermission` |
+| `useCollectionHttp` | `getCollections`、`getCollectionCount`、`deleteCollection`、`restoreCollection`、`getCollectionReferringAgents`、`parseCollection`、`parseCollectionVariable` |
+| `useCredentialHttp` | `getCredentialReferenceList` |
+| `useKnowledgeHttp` | `getKnowledgebases`、`getKnowledges`、`getKnowledgebaseCount`、`getKnowledgeCount`、`getKnowledgebaseReferringAgents` |
+| `useMcpHttp` | `getMcpList`、`deleteMcp`、`getMcpConfig`、`restoreMcp`、`getMcpCount`、`getMcpReferringAgents`、`getMcpInstallGuide`、`getMcpInstallTargets` |
+| `useSkillHttp` | `getSkillList`、`getSkillCount`、`getSkillReferringAgents`、`deleteSkill`、`downloadSkill`、`restoreSkill`、安装/指南相关、`getSkillBuildLog` |
+| `useSpaceHttp` | `getResourceAuthorizedSpaces`、`removeApplyResources`、`getUsableSpaces` |
+| `useMarketHttp` | `downloadMarketSkill` |
+| `useLlmHttp` | `getModels`、`cancelModelLikeOrDislike`、`submitModelLikeOrDislike`、`getLLMReferringAgents` |
+| `useMetaHttp` | `nameValidator`、`codeValidator`、`getTags`、`plusTag`、`checkTag` |
+| `usePromptHttp` | `getPrompts`、`togglePromptLike`、`deletePrompt`、`restorePrompt`、`getPromptCount` |
+| `useToolHttp` | `getTools`、`deleteTool`、`restoreTool`、`getToolCount`、`getToolReferringAgents` |
+| `useDatasetHttp` | 数据集 CRUD、数据项、审核、标签等 |
+
+---
+
+## Events / Enums / Constants / Util / Transforms
+
+### Events（`@blueking/ai-ui-sdk/events`）
+
+```ts
+import { addEventListener, removeEventListener, emitEvent } from '@blueking/ai-ui-sdk/events';
+import { EventType } from '@blueking/ai-ui-sdk/enums';
+
+addEventListener(EventType.Error, (data) => { /* ... */ });
 ```
 
-## 完整示例
+当前内置事件：`EventType.Error`。
+
+### 常用枚举（`@blueking/ai-ui-sdk/enums`）
+
+| 枚举 | 取值示例 |
+|------|----------|
+| `ResourceCardType` | `full` / `choose` / `info` / `application` / `record` / `market` |
+| `GroupType` | `all` / `space` / `user` / `deleted` |
+| `Module` | knowledgebase / knowledge / prompt / tool / collection / agent / mcp / skill … |
+| `AgentType` | `single` / `flow` |
+| `EnumCharacter` | `all` / `system` / `user` / `public` / `space` |
+| `SdkNavigateActionType` | 各模块导航动作 |
+
+### Constants
 
-下面是一个完整的使用示例，展示了如何在 Vue 3 组件中集成 SDK：
+- `MAX_PAGE_SIZE = 10000`
+- `TEN_SECONDS = 10000`
+- `MODULE_NAME`：`Module` → 中文名映射
+
+### Util / Transforms / Types
+
+- `util`：文件处理、拷贝、下载、防抖节流、`uuid`、`deepMerge`、Markdown XSS 相关辅助等
+- `transforms`：各资源 `transferXxxApi2Xxx` / `transferXxx2XxxApi`
+- `types`：按域导出 `agent` / `mcp` / `skill` / `tool` / `knowledge` / `dataset` / `prompt` / `collection` 等类型
+
+---
+
+## 使用示例
 
 ```vue
 <template>
-  <div class="chat-container">
-    <!-- 消息列表 -->
-    <div class="message-list">
-      <div v-for="message in sessionContents" :key="message.id" class="message">
-        <div class="avatar">
-          {{ message.role === 'user' ? '👤' : '🤖' }}
-        </div>
-        <div class="content">{{ message.content }}</div>
-      </div>
-    </div>
-    
-    <!-- 输入框 -->
-    <div class="input-area">
-      <input 
-        v-model="inputMessage" 
-        @keyup.enter="handleSend"
-        placeholder="请输入消息..."
-      />
-      <button @click="handleSend" :disabled="currentSessionLoading">
-        {{ currentSessionLoading ? '生成中...' : '发送' }}
-      </button>
-      <button v-if="currentSessionLoading" @click="handleStop">停止</button>
-    </div>
+  <RenderHeader
+    title="智能体"
+    v-model:group-type="groupType"
+    :tabs="tabs"
+  />
+  <RenderAgentSearch
+    v-model:search="search"
+    :api-prefix="apiPrefix"
+    :member-url="memberUrl"
+    :space-id="spaceId"
+  />
+  <div class="card-list">
+    <RenderAgentCard
+      v-for="agent in agents"
+      :key="agent.id"
+      :agent="agent"
+      :type="ResourceCardType.Full"
+      :api-prefix="apiPrefix"
+      :space-id="spaceId"
+      @navigate="handleNavigate"
+      @success-delete="refresh"
+    />
   </div>
 </template>
 
 <script setup lang="ts">
 import { ref } from 'vue';
-import { useChat, useStyle, useClickProxy } from '@blueking/ai-ui-sdk';
+import {
+  RenderHeader,
+  RenderAgentSearch,
+  RenderAgentCard,
+} from '@blueking/ai-ui-sdk/components';
+import { useStyle } from '@blueking/ai-ui-sdk/hooks';
+import { ResourceCardType, GroupType } from '@blueking/ai-ui-sdk/enums';
+import type { IAgent, IAgentListParam, ISdkNavigateAction } from '@blueking/ai-ui-sdk/types';
 
-// 引入全局样式
 useStyle();
 
-// 添加点击代理
-useClickProxy();
+const apiPrefix = '/api';
+const memberUrl = '/member';
+const spaceId = ref('');
+const groupType = ref(GroupType.All);
+const search = ref<IAgentListParam>({});
+const agents = ref<IAgent[]>([]);
+const tabs = [
+  { id: GroupType.All, name: '全部', number: 0 },
+];
 
-// 初始化聊天功能
-const {
-  currentSession,
-  sessionContents,
-  sendChat,
-  stopChat,
-  setCurrentSession,
-  currentSessionLoading,
-} = useChat({
-  handleStart: () => {
-    console.log('开始生成回复');
-  },
-  handleEnd: () => {
-    console.log('回复生成完成');
-  },
-  requestOptions: {
-    url: 'https://your-chat-api.com',
-  }
-});
-
-// 设置当前会话
-setCurrentSession({
-  sessionCode: 'session-' + Date.now(),
-  sessionName: '新对话',
-  model: 'gpt-3.5',
-});
-
-const inputMessage = ref('');
-
-// 发送消息
-const handleSend = () => {
-  if (!inputMessage.value.trim()) return;
-  
-  sendChat({
-    message: inputMessage.value,
-  });
-  
-  inputMessage.value = '';
+const handleNavigate = (action: ISdkNavigateAction) => {
+  // 处理 SDK 导航动作
 };
 
-// 停止生成
-const handleStop = () => {
-  if (currentSession.value?.sessionCode) {
-    stopChat(currentSession.value.sessionCode);
-  }
+const refresh = () => {
+  // 刷新列表
 };
 </script>
 ```
 
 ## 注意事项
 
-1. 确保在应用中只调用一次 `useStyle()` 以避免样式重复注入
-2. `useClickProxy()` 应在组件挂载前调用，会自动在组件卸载时移除事件监听
-3. 发送消息前必须通过 `setCurrentSession()` 设置当前会话
-4. 所有网络请求需要在 `requestOptions` 中配置正确的 API 地址
-
-## 高级功能
-
-SDK 还提供了以下高级功能：
-
-- 支持引用上下文进行提问
-- 支持快捷操作菜单配置
-- 支持代码块的展开/收起、全屏显示、复制、下载
-- 支持响应内容的重新生成和删除
-- 支持会话内容的自动滚动
+1. 通过**子路径**引入模块，不要依赖根路径默认导出。
+2. `useStyle()` 建议在应用入口只调用一次，避免样式重复注入。
+3. `useClickProxy()` 会在挂载时注册、卸载时移除全局点击监听。
+4. 卡片类组件的 `navigate` 事件需由宿主完成实际路由跳转。
+5. 类型与枚举请从 `@blueking/ai-ui-sdk/types`、`@blueking/ai-ui-sdk/enums` 引入。
 
 ## 版本兼容性
 
-- 需要 Vue 3.x
-- TypeScript 4.x 或更高版本
-- 现代浏览器（Chrome, Firefox, Safari, Edge）
+- Vue 3.x
+- TypeScript 4.x+
+- 现代浏览器（Chrome / Firefox / Safari / Edge）