npm - @blueking/ai-ui-sdk - Versions diffs - 0.4.3-beta.10 → 0.4.3-beta.13 - Mend

@blueking/ai-ui-sdk 0.4.3-beta.10 → 0.4.3-beta.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (216) hide show

package/README.md CHANGED Viewed

@@ -1,2258 +1,2258 @@
-# @blueking/ai-ui-sdk
-蓝鲸 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
-```
-### 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` | | | 模块 |
-**Events**
-| 事件 | 参数 | 说明 |
-|------|------|------|
-| update:search | `(search: IToolsParam)` | 搜索条件变更 |
-**Expose**
-无
-**Slots**
-无
----
-#### RenderMcpSearch
-MCP 搜索栏。
-**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**
-无
----
-### 数据集
-#### 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
-```
----
-## 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
-- `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>
-  <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 {
-  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();
-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 handleNavigate = (action: ISdkNavigateAction) => {
-  // 处理 SDK 导航动作
-};
-const refresh = () => {
-  // 刷新列表
-};
-</script>
-```
-## 注意事项
-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）
+# @blueking/ai-ui-sdk
+蓝鲸 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
+```
+### 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` | | | 模块 |
+**Events**
+| 事件 | 参数 | 说明 |
+|------|------|------|
+| update:search | `(search: IToolsParam)` | 搜索条件变更 |
+**Expose**
+无
+**Slots**
+无
+---
+#### RenderMcpSearch
+MCP 搜索栏。
+**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**
+无
+---
+### 数据集
+#### 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
+```
+---
+## 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
+- `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>
+  <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 {
+  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();
+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 handleNavigate = (action: ISdkNavigateAction) => {
+  // 处理 SDK 导航动作
+};
+const refresh = () => {
+  // 刷新列表
+};
+</script>
+```
+## 注意事项
+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）