# @cloud-ru/ds-ai-suggestion-panel 中文文档
规范地址：https://npmcn.com/package/%40cloud-ru/ds-ai-suggestion-panel/
版本：1\.0\.8
npm 元数据更新时间：2026-11-11T15:05:58.631Z
中文译文更新时间：2026-11-11T21:37:30.508Z
软件包许可：Apache-2\.0
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40cloud-ru/ds-ai-suggestion-panel
原文对照：https://npmcn.com/package/%40cloud-ru/ds-ai-suggestion-panel/?lang=original
项目主页：https://github.com/cloud-ru-tech/snack-v2/tree/master/packages/ai-suggestion-panel
源码仓库：https://github.com/cloud-ru-tech/snack-v2
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：518 kB，83 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：12 个
- 首次发布：2026-10-19T16:42:18.278Z
- 最新版本发布：2026-11-11T15:05:58.307Z
- 近 30 天下载量：3266（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 35 个）
## 中文简介
(笑声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声).
## 安装
```sh
npm install @cloud-ru/ds-ai-suggestion-panel
```
也可以使用：`pnpm add @cloud-ru/ds-ai-suggestion-panel`、`yarn add @cloud-ru/ds-ai-suggestion-panel`、`bun add @cloud-ru/ds-ai-suggestion-panel`
## README
# AiSug建议小组
`@cloud-ru/ds-ai-suggestion-panel` {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080} - - {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080} - {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080} - {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080} - {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080} - {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}.
Полоса:пользователь也. {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你说什么? 盖加.
## Когда
- Рядом:алерт也.
- {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢.
Когда **не** нужен:
- 说吧
- {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢 `@cloud-ru/ds-ai-field-request`。 。 。 .
- {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢
- используйте `AiSuggestionSimple` из `@cloud-ru/ds-ai-suggestion`。 。 。 .
{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢.
## Анатомия
校对:Soup
- \- Giga - открывает на ассистента ассистента ассистента ассистента ассистента `onLogoClick`。 。 。 .
- {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢 `items`{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢.
- {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1} - {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1} - - {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1} - - - {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1}.
- {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得怎么样? Показывается,если也 `onClose`。 。 。 .
### 大小( 默认) `s`(中文(简体) )
- `s` - высота 32.
- `m` ——40岁.
### Размеры
```tsx
import { AiSuggestionPanel, SIZE } from '@cloud-ru/ds-ai-suggestion-panel';
const ITEMS = [
{ value: 'alert-reason', label: 'Почему сработал алерт?' },
{ value: 'vm-traffic', label: 'Где посмотреть трафик ВМ?' },
];
export function Sizes() {
return (
);
}
```
### Состояния
- `disabled` - подписьнажатиене.
- `loading` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你觉得呢.
Hover, 按下 \\ 焦点 \\ CSS (`:hover`, (中文(简体) ), `:active`, (中文(简体) ), `:focus-visible`) (中文(简体) ). {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得怎样.
### \# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢? {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # {\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢.
## Установка
```bash
pnpm add @cloud-ru/ds-ai-suggestion-panel
```
```ts
import { AiSuggestionPanel, SIZE } from '@cloud-ru/ds-ai-suggestion-panel';
```
## Примеры
### Базовый
{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你觉得呢
```tsx
import { AiSuggestionPanel } from '@cloud-ru/ds-ai-suggestion-panel';
import { Typography } from '@cloud-ru/ds-typography';
import { useState } from 'react';
const ITEMS = [
{ value: 'alert-reason', label: 'Почему сработал алерт?' },
{ value: 'vm-monitoring', label: 'Как настроить мониторинг всех ВМ?' },
{ value: 'vm-traffic', label: 'Где посмотреть трафик ВМ?' },
{ value: 'alert-vm-off', label: 'Как создать алерт, если ВМ выключена?' },
{ value: 'vm-metrics', label: 'Какие проблемы видны по метрикам ВМ?' },
];
export function Basic() {
const [selected, setSelected] = useState();
const selectedLabel = ITEMS.find(item => item.value === selected)?.label;
return (
{selectedLabel ? `Выбран вопрос: ${selectedLabel}` : 'Нажмите на вопрос'}
);
}
```
### Загрузка
装入 装入
```tsx
import { AiSuggestionPanel, AiSuggestionPanelItem } from '@cloud-ru/ds-ai-suggestion-panel';
import { useEffect, useState } from 'react';
const QUESTIONS: AiSuggestionPanelItem[] = [
{ value: 'alert-reason', label: 'Почему сработал алерт?' },
{ value: 'vm-monitoring', label: 'Как настроить мониторинг всех ВМ?' },
{ value: 'vm-traffic', label: 'Где посмотреть трафик ВМ?' },
];
/** Время «ответа ассистента» в демо. */
const ANSWER_DELAY_MS = 2000;
export function LoadingFlow() {
const [pendingValue, setPendingValue] = useState();
useEffect(() => {
if (!pendingValue) return;
const timer = setTimeout(() => setPendingValue(undefined), ANSWER_DELAY_MS);
return () => clearTimeout(timer);
}, [pendingValue]);
const items = QUESTIONS.map(question => ({ ...question, loading: question.value === pendingValue }));
return ;
}
```
### Кнопка
{\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1}结束 {\\fn黑体\\fs20\\shad2\\2aH82\\3aH20\\4aH33\\fscx95\\3cH592001\\be1}
```tsx
import { AiSuggestionPanel } from '@cloud-ru/ds-ai-suggestion-panel';
import { Button } from '@cloud-ru/ds-button';
import { useState } from 'react';
const ITEMS = [
{ value: 'alert-reason', label: 'Почему сработал алерт?' },
{ value: 'vm-traffic', label: 'Где посмотреть трафик ВМ?' },
];
export function WithClose() {
const [visible, setVisible] = useState(true);
if (!visible) {
return