安装指南

安装

npm

npm install @bdky/aaas-pilot-kit-react-widget

yarn

yarn add @bdky/aaas-pilot-kit-react-widget

pnpm

pnpm add @bdky/aaas-pilot-kit-react-widget

依赖说明

Widget 组件库依赖以下 peer dependencies：

依赖	版本要求	说明
react	>=17.0.0	React 核心
react-dom	>=17.0.0	React DOM
@bdky/aaas-pilot-kit-react	>=1.0.0	底层 SDK（自动安装）

关于底层 SDK

@bdky/aaas-pilot-kit-react 会作为 Widget 的依赖自动安装，你无需单独安装。但如果需要直接使用底层 Hooks，可以从 Widget 包重新导出：

// 从 Widget 包导入底层 Hooks
import {
    useAaaSPilotKit,
    useAaaSPilotKitEvents,
    useConversationList
} from '@bdky/aaas-pilot-kit-react-widget';

样式导入

Widget 组件自带样式，会随组件自动加载，无需手动导入 CSS。

如果你需要使用 CSS 变量进行主题定制，可以显式导入变量文件：

// 可选：显式导入 CSS 变量（用于主题定制）
import '@bdky/aaas-pilot-kit-react-widget/styles';

TypeScript 支持

Widget 组件库使用 TypeScript 编写，提供完整的类型定义：

import type {
    IPilotKitProps,
    IPilotKitRef,
    IConversationListProps,
    IControlPanelProps,
    VariantType
} from '@bdky/aaas-pilot-kit-react-widget';

浏览器兼容性

浏览器	最低版本
Chrome	74+
Firefox	90+
Safari	14.1+
Edge	79+
iOS Safari	14.1+
Android Chrome	74+

下一步

• 快速开始 - 5 分钟搭建完整示例