@epam/ai-dial-ui-kit

中文文档
0.16.3发布于 2026/11/16Apache-2.0TypeScriptESM + CJS构建来源已验证近 30 天下载 4.4万

用于构建与 React 的 AI DIAL 接口的现代 UI 工具包

中文使用文档
文档目录29 节
  1. 目录
  2. 重点
  3. 页:1
  4. QQ 快速启动
  5. 先决条件
  6. 安装
  7. 基本用途
  8. 可选: Markdown 组件 CSS
  9. 发展
  10. 控制下拉菜单
  11. 先决条件
  12. 开发设置
  13. 运行测试
  14. 项目结构
  15. QQ 主题和自定义
  16. 公共类名称
  17. * 无障碍
  18. 只命名图标控件
  19. 目标规模(WCAG 2.5.5,AA级)
  20. · 故事本
  21. 故事
  22. 文档
  23. 项目使用量
  24. 树摇
  25. QQ AI 代理 MCP 服务器
  26. 捐款
  27. • 警卫
  28. 许可证
  29. 有关项目

艾尔·迪亚勒·基特

AI-DIAL-UI-KIT project logo

AI DIAL UI Kit是一个已准备好的 React 组件库,旨在精简您的开发过程. 它的特点是收集一些基础组件,如按钮,输入,滴出等,以及更多——使您能够不费力地再利用元素,快速而容易地再利用.

npm version License: Apache 2.0 TypeScript React

目录

重点

  • 🎨 统一用户体验: Ui Kit 的使用有助于整个 AI DIAL 应用程序的设计一致性
  • ⚡ 现代堆栈: 以最新的React、 TypeScript、 Vite 和 Tailwind CSS 构建
  • 🎨 高度定制: 具有CSS自定义属性的深度主题能力
  • 🧪 测试合格: 与Vitest和React测试库进行综合测试覆盖(70%+)
  • 📚 故事书准备:包括交互式文件和发展操场
  • 🛠️ 开发者经验: 利用ESLint和Prettier来维护代码质量
  • 📦 分发准备:作为国家防范机制一揽子计划部署,以方便融入

页:1

探索我们的组件及其在互动中的用途 故事书文档。 。 。 .

QQ 快速启动

先决条件

  • 节点.js >= 22.2.0
  • 时间:

安装

npm install @epam/ai-dial-ui-kit

基本用途

import { DialPrimaryButton } from '@epam/ai-dial-ui-kit';
import '@epam/ai-dial-ui-kit/styles.css';

function App() {
  return (
    <div>
      <DialPrimaryButton onClick={() => alert('Hello AI DIAL!')} />
    </div>
  );
}

可选: Markdown 组件 CSS

如果你正在使用这个 MarkdownEditor (装入 LazyMarkdownEditor),您需要从全球导入应用程序中所需的 CSS 文件(例如,在您的根版式或主要入口):

import '@uiw/react-markdown-preview/markdown.css';
import '@uiw/react-md-editor/markdown-editor.css';

这样做可以确保每个应用程序装入CSS一次,而不是与每个组件实例捆绑,减少捆绑大小.

发展

控制下拉菜单

ButtonDropdown 接受控件 open 编号 : onOpenChange 或无控制 defaultOpen。 。 dropdownProps 转发搜索、放置和菜单大小 选项 Dropdown设置 iconAfter={null} 仅用于图标触发; 否则 默认切夫龙跟随有效的开放状态.

DropdownItem.subMenuOpen 财务报告和审定财务报表 onSubMenuOpenChange 让主机保留活动 整个演示文稿的子菜单变化。 关闭它们保存默认值 不受控制的行为。 已打开的子菜单恢复对挂载的焦点, 而 工具包拥有箭头导航、RTL布置、逃生和焦点返回. renderSubMenu 可以提供自定义内容而不包含占位符 children. 转发叶片 iconAfter 与现有残疾/危险状态并列.

先决条件

  • 节点.js >= 22.2.0
  • 时间:
  • 图形

开发设置

  1. 清除还原

    git clone https://github.com/epam/ai-dial-ui-kit.git
    cd ai-dial-ui-kit
    
  2. 安装依赖关系

    npm install
    
  3. 启动开发环境

    # Start Storybook for component development
    npm run storybook
    
    # Run tests in watch mode
    npm run test -- --watch
    
    # Start Vite dev server
    npm run dev
    

运行测试

# Run all tests with coverage
npm run test

项目结构

src/
├── components/          # React components
│   ├── Button/         # Example component
│   │   ├── Button.tsx
│   │   ├── Button.spec.tsx
│   │   └── Button.stories.tsx
│   └── ...
├── styles/             # Global styles and Tailwind configuration
│   ├── buttons.scss
│   ├── typography.scss
│   └── tailwind-entry.scss
├── types/              # TypeScript type definitions
└── index.ts            # Main entry point

QQ 主题和自定义

库使用CSS自定义属性进行综合主题. 覆盖这些变量以匹配您的品牌 :

:root {
  /* Background layers */
  --bg-layer-0: #000000;
  --bg-layer-1: #0C101D;
  --bg-layer-2: #171B21;
  
  /* Text colors */
  --text-primary: ##EEF1F7;
  --text-secondary: #9CA3AF;
  --text-tertiary: #6B7280;
   ...
}

完整的变量列表可供使用 这里

2.0控件的角光度也是一样的。 每个默认 完全圆形的药丸 按钮的船,所以没有设置 保持库存 听着:

:root {
  --radius-control: 12px; /* Button at standard and large size */
  --radius-control-small: 8px; /* Button at ElementSize.Small */
  --radius-control-icon: 9999px; /* IconButton, ToggleIconButton — any size */
}

绑定并只使用图标的按钮可按目的读取单独的变量:一种设计 想要平方动作按钮通常仍然想要其图标按钮圆形.

这些是默认的,而不是覆盖的: a rounded-* 函数传递给单个 通过控制 className 仍然赢,因为消费者的公用事业 在此软件包样式表之后发布 .

重叠堆叠

重叠在端端的门户中渲染 <body>,所以他们堆起对 主机自己的固定而粘糊糊的染色体——一个头,一个副工作表,一个嵌入式 重叠。 他们坐在一个由变数驱动的四步梯上:

层工具z-index构成部分
弹出z-popupvar(--z-overlay, 52)Popup 二代人的背景
浮动面板z-floating--z-overlay +1 键Dropdown 财务报告和审定财务报表 Select 上面,子菜单, Calendar
交互式小组讨论z-interactive-tooltip--z-overlay +2 键InteractiveTooltip
工具提示z-tooltip--z-overlay + 3 个Tooltip,两代人

要将每个覆盖在主机层上方, 请设置一次底座 :

:root {
  --z-overlay: 1000; /* popup 1000, dropdown 1001, interactive tooltip 1002, tooltip 1003 */
}

每层都是固定的台阶 所以升起底座 重新排序 : 弹出处上方仍会打开下拉和工具提示 上面的下行触发它。 设定变量打开 :root,或者在 类 a ThemeScope 重新应用到它的门户覆盖上——一个门户逃脱任何 其它的包装,所以只设置一个没有达到覆盖的值 .

单个重叠仍可自行移动:a z-* 已传递给 a Dropdown是因为 listClassName页:1 Popup是因为 overlayClassName,一个 InteractiveTooltip是因为 contentClassName 或一个 Calendar是因为 panelClassName 代替地层本身的阶梯 而不是降落在地上,因为 mergeClasses 知道梯子公用事业是z指数.

公共类名称

一些主机需要重塑道具无法到达的部件的一部分——即: 隐藏菜单行列表、 行的半径、 图标的护身符 触发。 该工具包自己的班级是Tailwind公用事业公司和当地的散货舱, 因此,一个能到达他们的宿主, 最终在选择者 打破下一个 升级 : [class*='_selectedItem_'], (中文(简体) ), > div:nth-child(2) > button, (中文(简体) ), [role='none'][aria-label='dropdown'] ——最后一个是无障碍 作为简单的英语字符串,它不是一个本地化的主机可以依赖的 无论是.

因此,每个设计系统2.0组件在元件上划出一个稳定的等级 这画它。 它们是作为记录出口的:

import { DIAL_KIT_CLASS } from '@epam/ai-dial-ui-kit';

DIAL_KIT_CLASS.menuItem; // 'dial-kit-menuitem'
.dial-kit-dropdown-list {
  padding-block: 0;
}

.dial-kit-menuitem {
  border-radius: 8px;
}

没有 dist/index.css 选择它们:它们没有申报它们 拥有并仅作为选择者存在,所以主机规则不需要 !important 它会 否则不需要。 重命名一个,或者移动到不同的元素,是一个 打破变化并经历迁移指南进程.

反馈和现状

密钥类元素
spinnerdial-kit-spinner这个 role="status" 一个根 Spinner
progressBardial-kit-progress-barA的最外层元素 ProgressBar ——它的包装,或者没有标签或读出时的音轨
skeletondial-kit-skeleton一个的根 Skeleton
notificationdial-kit-notification这个 Notification 表面,包括每个土司和分节信息包装
noDataContentdial-kit-no-data-content空状态根 NoDataContent
loginScreendial-kit-login-screen这个 section 一个根 LoginScreen
stateScreendial-kit-state-screen这个 section 一个根 StateScreen
liveRegiondial-kit-live-region永远挂起的包 LiveRegion,或 announced. 国家 CaptionText 编号 : ErrorText
transferQueuedial-kit-transfer-queue这个 role="status" 专题小组讨论会 TransferQueue: 页眉、行和集合栏

文本

密钥类元素
highlightdial-kit-highlightA 的文本元素 Highlight
captionTextdial-kit-caption-text字段下的标题行
errorTextdial-kit-error-text其错误变体中的说明,添加到 captionText
labeldial-kit-label这个 Label 根,将它包起来 label 元素及其信息按钮
labelledTextdial-kit-labelled-text一个的根 LabelledText,将其标题和值包裹

集装箱

密钥类元素
stepsdial-kit-steps这个 ol 一个根 Steps
cardShelldial-kit-card-shell这个 article a 要素 CardShell
analyticsCarddial-kit-analytics-card一个的根 AnalyticsCard
analyticsBardial-kit-analytics-bar一个的根 AnalyticsBar,叠叠或内置
analyticsBarGroupdial-kit-analytics-bar-group一个的根 AnalyticsBarGroup它的手风琴
analyticsHistogramdial-kit-analytics-histogram一个的根 AnalyticsHistogram
collapsibleSidebardial-kit-collapsible-sidebar这个 aside a 要素 CollapsibleSidebar
resizableContainerdial-kit-resizable-containerA 内的内容框 ResizableContainer调整框架大小
resizeHandledial-kit-resize-handle这个 role="separator" a 要素 ResizeHandle
popupdial-kit-popup这个 role="dialog" 专题小组讨论会 Popup
bottomSheetdial-kit-bottom-sheet这个 role="dialog" 专题小组讨论会 BottomSheet
bottomSheetOverlaydial-kit-bottom-sheet-overlay一、背景 BottomSheet,它主持小组讨论
sideDrawerdial-kit-side-drawer这个 role="dialog" 专题小组讨论会 SideDrawer,打开或关闭
confirmationPopupdial-kit-confirmation-popupA 类 ConfirmationPopup面板,添加剂 popup
accordiondial-kit-accordion一个的根 Accordion
folderPathdial-kit-folder-path面包屑的根部 一种 FolderPath
breadcrumbsdial-kit-breadcrumbs这个 nav a 要素 Breadcrumbs 线索
breadcrumbsItemdial-kit-breadcrumbs-item其一段: 绘制标签的链接、 按钮或跨度

菜单和封面

密钥类元素
dropdowndial-kit-dropdown扳机包装 a Dropdown
dropdownListdial-kit-dropdown-list这个 role="none" 子菜单列表。 两代人
dropdownSearchdial-kit-dropdown-searchA 项列表上方的搜索行 searchable Dropdown
menuItemdial-kit-menuitem一个倒行:一个倒行项目,一个 Select 选项,子菜单触发器或子程序
menuItemCheckdial-kit-menuitem-check选中的跟踪检查 MenuItemMark.Check 横行
tooltipdial-kit-tooltip一个气泡 Tooltip
interactiveTooltipdial-kit-interactive-tooltip一个小组 InteractiveTooltip
ellipsisTooltipdial-kit-ellipsis-tooltipA 的文本元素 EllipsisTooltip,这也是它的触发

字段

密钥类元素
searchdial-kit-search这个 Search 字段框,添加到 dial-kit-input
passwordInputdial-kit-password-input这个 PasswordInput 字段框,添加到 dial-kit-input
numberInputdial-kit-number-input这个 NumberInput 字段框,添加到 dial-kit-input
tagInputdial-kit-tag-input这个 TagInput 字段框,添加到 dial-kit-input
autocompleteTagInputdial-kit-autocomplete-tag-input这个 AutocompleteTagInput 字段框,添加到 dial-kit-input
selectdial-kit-select一个的根 Select
inlineSelectdial-kit-inline-select一个的触发按钮 InlineSelect
calendardial-kit-calendar一个的根 Calendar,在每个模式下
schemaRendererdial-kit-schema-renderer一个的根 SchemaRenderer
schemaRendererSectiondial-kit-schema-renderer-section一个相撞 SchemaRenderer 区名片,任何深度
fileDropzonedial-kit-file-dropzone降水面积 FileDropzone
fileIcondial-kit-file-icon一个的根 FileIcon:glyph或spinner, 和共享徽章
fileNamedial-kit-file-name排队 FileName: 其类型图标、名称和任何细节
folderNamedial-kit-folder-name这个 FileName 单行 FolderName,添加剂 fileName
sharedEntityIndicatordial-kit-shared-entity-indicator一个徽章 SharedEntityIndicator,包括a FileIcon
badgedial-kit-badge一个的根 Badge:标签框,带有其图标
avatardial-kit-avatar一个的根 Avatar:图像,或替换它的首字母框
entityIdentitydial-kit-entity-identity一个根行 EntityIdentity: 图标、类型标签、名称和版本
selectedEntityCarddial-kit-selected-entity-card一个边框卡 SelectedEntityCard,而不是同样持有错误的包装
formSectiondial-kit-form-section这个 section 一个根 FormSection: 标题行、描述和内容
radioGroupPopupFielddial-kit-radio-group-popup-field一个的根 RadioGroupPopupField

控件

密钥类元素
switchdial-kit-switch排队 Switch: 控件及其标签
checkboxdial-kit-checkbox排队 Checkbox
checkboxBoxdial-kit-checkbox-box装饰盒 a CheckboxBox 绘图
radiodial-kit-radio排队 Radio
radioGroupdial-kit-radio-group一个的根 RadioGroup
segmentedControldial-kit-segmented-control这个 role="radiogroup" 轨道 a SegmentedControl
segmentedControlItemdial-kit-segmented-control-item其中一个部分
tabsdial-kit-tabsA的最外层元素 Tabs ——标题包,或没有标签时的标签列表 sectionLabel
tabListdial-kit-tab-list这个 role="tablist" 里面,无论是方向
tabdial-kit-tab里面有一个标签
tabSelecteddial-kit-tab-selected选择的标签, 无论是方向
tabsSectionLabeldial-kit-tabs-section-label这个 sectionLabel 标题a Tabs
tagdial-kit-tagA 类 Tag 避孕药,包括 TagInput'行数
filterChipsdial-kit-filter-chips这个 role="group" 单行 FilterChips;其芯片携带 dial-kit-tag
toggleIconButtondial-kit-toggle-icon-buttonA 类 ToggleIconButton,添加剂 dial-kit-base-icon-button
toggleChipdial-kit-toggle-chip这个 <button aria-pressed> 页:1 ToggleChip
closeButtondial-kit-close-buttonA 类 CloseButton,添加剂 dial-kit-base-icon-button
infoButtondial-kit-info-button一个 InfoButton,添加剂 dial-kit-base-icon-button
buttonDropdowndial-kit-button-dropdown包装 a ButtonDropdown

没有条目的部件,为什么

故意没有2.0个组件,因为主机会 目标已包含一个稳定的类别 :

构成部分已经瞄准了
Button 及其6个可变包装dial-kit-base-button (加上每变种类,例如: dial-kit-primary-solid-button(中文(简体) )
IconButton 及其五个可变包装dial-kit-base-icon-button
FabButtondial-kit-fab-button
Inputdial-kit-input
Textareadial-kit-textarea
Sliderdial-kit-slider
MarkdownEditordial-kit-markdown-editor
Griddial-kit-grid (以 GRID_ROOT_CLASS(中文(简体) )

5个没有自己的因素,通过什么解决 它们使: ThemeScope 联合国 display: contents 包装器, MultiSelectTags (单位:千美元)Tags),(c), TooltipContainer 编号 : TooltipTrigger,以及 ErrorBoundary (数量) LiveRegion 倒计时 StateScreen) (中文(简体) ).

取而代之的是两个相邻的元素通过道具得到,并继续是: Dropdown浮动面板取出 listClassName,则a Popup背景情况 带 overlayClassName。 。 。 .

* 无障碍

只命名图标控件

DialFabButton, (中文(简体) ), DialIconButton,以及 IconButton 因此,他们需要 明确易取名称。 过 aria-label; 如果您只通过一个字符串 tooltipProps.tooltip,则用作标签。 不依赖工具提示 单独传送名称——工具提示 aria-describedby 在包装元素上着陆 而不是在控制, 和工具提示完全压制 在移动.

InfoButton 名称本身来自 caption 出于同样的原因。 传个短 aria-label 当标题是完整的句子时,该名称仍可扫描.

目标规模(WCAG 2.5.5,AA级)

标准大小的按钮在40×40时渲染,但显示 44x44指针目标 通过 dial-kit-enhanced-target 工具,以透明方式增加目标 伪相相. 可见控件不变,所以布局保持其已有 度量衡。 WCAG 2.5.5 测量接受指向动作的区域,而不是 可见的装饰.

44px 目标控制太小,无法清除邻国的使用 dial-kit-minimum-target 相反,它应用相同的伪元素在 AA级最低为24×24 (WCAG 2.5.8.

这些控制是 有记录的例外情况 并符合AA级(2.5.8、24×24),但 非自动取款机 :

控制权大小为什么它被排除在外
ElementSize.Small 变体24x24 (中文(简体) )44px 目标上架 10px 每边, 并会在密集工具栏中重叠相邻的控制
ButtonAppearance.Link内容2.5.5规定的豁免 内入 例外; 扩展后将会与副本相重叠
DialCloseButton图标大小渲染器 h-auto w-auto,因此其目标跟随呼叫者的图标大小
DialInfoButton, (中文(简体) ), InfoButton24x24 (中文(简体) )固定的小额支付,与小变体相同的重叠制约
标准2.0字段( Y)Input, (中文(简体) ), Select, (中文(简体) ), RadioGroupPopupField(中文(简体) )40px高个指针目标横跨全字段宽度,但保持4px相差44个垂直;高度是共享形式设计符号,而不是每个控制选择. .dial-kit-input 剪接它的外溢,所以伪元素 也无法生长目标
Tag 删除按钮已交付 16x16达到24x24通过 dial-kit-minimum-target;44px目标将超过每侧14px并吞入相邻的标记 a TagInput 横行
可点击 Tag高32平方圆一个44px目标将每边挂上6px并吞入过滤行相邻的芯片;标记已经比两个轴上24px宽
ToggleChip高32平方圆与可点击的药片相同 Tag:44px目标会每边挂出6px并吞下相邻的切行芯片;芯片已经比两轴上24px宽
Radio 圆已交付 20x20达到24x24通过 dial-kit-minimum-target44px目标将覆盖每边12px,吞下相邻的标签。 点击标签会选择收音机, 因此实际目标范围更广
Checkbox 选项框已交付 20x20达到24x24通过 dial-kit-minimum-target44px目标将覆盖每边12px,吞下相邻的标签。 点击标签切换复选框, 因此实际目标更宽
Slider 音轨行24px 高个指针目标横跨整个轨道宽度,但只有24px高;一行44px会给滑动器所坐入的每一个形式增加20px的死地空间,拇指被拖取而未被取出
Breadcrumbs 段链接内容2.5.5规定的豁免 内入 例外——一段是一行案文中的文本链接,扩大段将与其相重叠
Breadcrumbs 溢出按钮已交付 16x16达到24x24通过 dial-kit-minimum-target;44px目标会超过每侧14px,并吞入其两侧的分块入入内径
SegmentedControl 部分高32平方圆从相邻的40px轨道中坐入4px,所以44px目标会将每侧6px挂上并吞入相邻的区段;区段已经比两轴上24px宽
ResizeHandle8px 宽指针条手柄必须精确地坐到面板边界上,这样一个44px宽的条会吞下其两侧的内容——对控制至关重要. 这是一种焦点 separator,因此调整大小也可以从键盘中取出并带有箭头键
ResizableContainer 调整手柄大小10px 宽指针条手柄必须精确地坐到面板边界上,这样一个44px宽的条会吞下其两侧的内容——对控制至关重要. 这是一种焦点 separator,因此调整大小也可以从键盘中取出并带有箭头键

如果您需要达到, 请给周围空间至少20px 个小变量控制 特定布局中的AAA,或者取而代之使用标准大小.

· 故事本

故事书是一个方便的图书馆,用于记录和发展UI组件.

故事

要运行完全互动的故事手册 :

开发模式

npm run storybook
# Open http://localhost:6006

生产建设

npm run build-storybook

生产开始

npx http-server ./storybook-static
# Open http://127.0.0.1:8080/

文档

只运行文档 :

开发模式

npm run storybook-docs
# Open http://localhost:54800/

生产建设

npm run build-storybook-docs

生产开始

npx http-server ./storybook-static
# Open http://127.0.0.1:8080/

故事书规定:

  • 交互式组件文档
  • * 视觉测试操场
  • * 无障碍测试工具
  • 适应性设计测试
  • * 组件隔离

项目使用量

Next.js 一体化
  1. 安装软件包 。 反应是唯一的同伴,你必须提供的一切 包里装的,它自己装的.
npm install @epam/ai-dial-ui-kit
npm install react react-dom

仅在使用 Markdown 编辑器的情况下添加编辑器包 (单位:千美元)LazyMarkdownEditor) (中文(简体) ). 这是一个可选的对等者,所以 npm install 保持安静 没有它,而工具箱只有在编辑器实际挂载时才到达:

npm install @uiw/react-md-editor
  1. 项目根版式中的导入样式 :
// app/layout.tsx
import "@epam/ai-dial-ui-kit/styles.css";
  1. 用法实例
// app/page.tsx
"use client";
import { DialPrimaryButton } from "@epam/ai-dial-ui-kit";

export default function Home() {
  return (
    <div className="w-full h-full flex flex-col gap-3 items-center justify-center">
      <h1>Test library</h1>
      <DialPrimaryButton onClick={() => alert('Hello AI DIAL!')} />
    </div>
  );
}

树摇

只导入所需的组件 :

// ✅ Good - Tree shakable imports
import { DialPrimaryButton, DialInput } from '@epam/ai-dial-ui-kit';
import '@epam/ai-dial-ui-kit/styles.css'; // Import styles separately

// ❌ Avoid - Imports entire library
import * as UIKit from '@epam/ai-dial-ui-kit';

QQ AI 代理 MCP 服务器

AI DIAL UI Kit包括一个内置的 MCP( 模式上下文协议) 服务器 使人工智能代理人能够按程序发现组件、类型、钩子和公用事业。 这使得AI助手可以在不产生幻觉的情况下生成准确,类型安全的组件代码.

构成部分成果排名 首先生成 2.0 ——当前设计系统,导出时无 Dial 前缀——和每个遗产 Dial* 元件在 2. 0 替换时点出,所以代理默认降落在正确的组件上.

关于设置、配置和详细资源,见 MCP 服务器指南。 。 。 .

捐款

我们欢迎捐款! 请看我们的 贡献指南 详细情况如下:

  • 代码样式准则
  • 测试要求
  • 请求程序

• 警卫

如果你发现安全漏洞 请参考我们 安全政策。 。 。 .

许可证

Apache 2.0 (英语) - 看这个 自由主义 详细文件.


由 Q 制作 EPAM 系统

版本与发布记录

@epam/ai-dial-ui-kit 共发布 889 个版本,首次发布于 2025/09/18;过去 12 个月发布了 721 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.16.3latest2026/11/16今天
0.17.0-dev.11development2026/11/16今天
0.17.0-dev.102026/11/142 天前
0.16.22026/11/142 天前
0.17.0-dev.92026/11/142 天前
0.17.0-dev.82026/11/132 天前

其他发布通道:next → 0.9.0-rc.40,release-0.14 → 0.14.3,development → 0.17.0-dev.11。

关于 @epam/ai-dial-ui-kit 的常见问题

@epam/ai-dial-ui-kit 是什么?

用于构建与 React 的 AI DIAL 接口的现代 UI 工具包

如何安装 @epam/ai-dial-ui-kit?

在项目目录运行 npm install @epam/ai-dial-ui-kit,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^19.2.5)、react-dom(^19.2.5)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。它还提供命令行工具 ai-dial-ui-kit-mcp,可以用 npx ai-dial-ui-kit-mcp 直接运行。

@epam/ai-dial-ui-kit 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@epam/ai-dial-ui-kit 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@epam/ai-dial-ui-kit 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.2.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@epam/ai-dial-ui-kit 可以商用吗?

@epam/ai-dial-ui-kit 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@epam/ai-dial-ui-kit 的下载量有多少?

根据 npm 官方下载统计,@epam/ai-dial-ui-kit 在 2026/10/14 – 2026/11/12 这 30 天内被下载 44,466 次,日均约 1,482 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@epam/ai-dial-ui-kit 还在维护吗?

最新版本 0.16.3 发布于 2026/11/16(今天);至今共发布 889 个版本,其中过去 12 个月发布了 721 个;首次发布于 2025/09/18。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。