@cloud-ru/ds-ai-suggestion-panel

中文文档
1.0.8发布于 2026/11/11Apache-2.0TypeScriptESM + CJS近 30 天下载 3266

(笑声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声).

中文使用文档
文档目录15 节
  1. Когда
  2. Анатомия
  3. 大小( 默认) s (中文(简体) )
  4. Размеры
  5. Состояния
  6. # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #…
  7. Установка
  8. Примеры
  9. Базовый
  10. Загрузка
  11. Кнопка
  12. 道具
  13. Смотри
  14. Адаптивность
  15. Как

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岁.

Размеры

import { AiSuggestionPanel, SIZE } from '@cloud-ru/ds-ai-suggestion-panel';

const ITEMS = [
  { value: 'alert-reason', label: 'Почему сработал алерт?' },
  { value: 'vm-traffic', label: 'Где посмотреть трафик ВМ?' },
];

export function Sizes() {
  return (
    <div style={{ display: 'flex', flexDirection: 'column', gap: 12, alignItems: 'flex-start' }}>
      <AiSuggestionPanel items={ITEMS} size={SIZE.S} />
      <AiSuggestionPanel items={ITEMS} size={SIZE.M} />
    </div>
  );
}

Состояния

  • 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}你觉得呢.

Установка

pnpm add @cloud-ru/ds-ai-suggestion-panel
import { AiSuggestionPanel, SIZE } from '@cloud-ru/ds-ai-suggestion-panel';

Примеры

Базовый

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢

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<string>();
  const selectedLabel = ITEMS.find(item => item.value === selected)?.label;

  return (
    <div style={{ display: 'flex', flexDirection: 'column', gap: 12, alignItems: 'flex-start' }}>
      <AiSuggestionPanel items={ITEMS} onItemClick={setSelected} />
      <Typography variant='body' size='s'>
        {selectedLabel ? `Выбран вопрос: ${selectedLabel}` : 'Нажмите на вопрос'}
      </Typography>
    </div>
  );
}

Загрузка

装入 装入

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<string>();

  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 <AiSuggestionPanel items={items} onItemClick={setPendingValue} />;
}

Кнопка

{\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}结束 {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}

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 <Button label='Показать подсказки' view='outline' appearance='neutral' onClick={() => setVisible(true)} />;
  }

  return <AiSuggestionPanel items={ITEMS} onClose={() => setVisible(false)} />;
}

道具

AiSug建议小组

Prop类型默认说明
classNamestring—— 说(原始内容存档于2018-09-29). CSS-класс.
data-test-idstring—— 说
docsUrlstringhttps://cloud.ru/docs/ai_assistant_cloudia/ug/index{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你说什么.
innerRefRef<HTMLDivElement>—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
itemsAiSuggestionPanelItem—— 说Вопросы. {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你还好吧
со.
layoutPresetsAiSuggestionPanelLayoutDefaults | LayoutPresets—— 说Переопределение(пресетов)mobile, (中文(简体) ), desktop,(...) ) для size。 。 。 .
onClose(() => void)—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢? {\fn华文仿宋\fs16\1cHD1D1D1}好! {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
onItemClick((value: string) => void)—— 说[永久失效連結] (中文(简体) ).
onLogoClick(() => void)—— 说{\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}吉加(英语:.
size"m" | "s"—— 说校对:Soup s - 32岁, m ——40岁. По s移动 m。 。 。 .
QQ 桌面; 移动 QQ layoutPresets.mobile。 。 。 .

建议 小组项目

Prop类型默认说明
disabledboolean | undefined—— 说(原始内容存档于2018-10-11). QQ: нажатие.
labelstring—— 说Текст. {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
loadingboolean | undefined—— 说Вопрос:после也
нажатие. Состояние.
valuestring—— 说Идентификатор; приходит; приходит onItemClick。 。 。 .

助理建议小组

Prop类型默认说明
size"m" | "s"—— 说Размер.
  • Size =: "m" | "s"

Смотри

  • @cloud-ru/ds-ai-suggestion {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢.
  • @cloud-ru/ds-ai-button-giga - Giga, из собрана логотипа.

Адаптивность

AiSuggestionPanel -=YTET -伊甸园字幕组=- 翻译: {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 @cloud-ru/ds-adaptive {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢 layoutType нет.

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 m ???????????????????????????????????????????.

Проп桌面移动
sizesm

- 手机 - 电话 AI_SUGGESTION_PANEL_LAYOUT_PRESETS。 。 。 .

Как

{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}我.. layoutPresets[layout] ( AI_SUGGESTION_PANEL_LAYOUT_PRESETS → (=桌面-значение)базовый.

import { AiSuggestionPanel } from '@cloud-ru/ds-ai-suggestion-panel'

// Явный проп задаёт desktop-значение, на mobile полоса остаётся размера m
<AiSuggestionPanel items={items} size='m' />

// Оставить размер s на mobile
<AiSuggestionPanel items={items} layoutPresets={{ mobile: { size: 's' } }} />

版本与发布记录

@cloud-ru/ds-ai-suggestion-panel 共发布 35 个版本,首次发布于 2026/10/20;过去 12 个月发布了 35 个版本。

版本发布日期距今
1.0.8latest2026/11/11今天
1.0.8-preview-e8fe6b56.0preview2026/11/11今天
1.0.8-preview-c0e895ed.02026/11/11今天
1.0.8-preview-90b10112.02026/11/11今天
1.0.8-preview-fd7dd437.02026/11/101 天前
1.0.8-preview-9a75a2a9.02026/11/101 天前

关于 @cloud-ru/ds-ai-suggestion-panel 的常见问题

@cloud-ru/ds-ai-suggestion-panel 是什么?

(笑声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声) (掌声).

如何安装 @cloud-ru/ds-ai-suggestion-panel?

在项目目录运行 npm install @cloud-ru/ds-ai-suggestion-panel,或使用 pnpm add / yarn add / bun add。

@cloud-ru/ds-ai-suggestion-panel 支持 TypeScript 吗?

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

@cloud-ru/ds-ai-suggestion-panel 支持 ESM 还是 CommonJS?

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

@cloud-ru/ds-ai-suggestion-panel 可以商用吗?

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

@cloud-ru/ds-ai-suggestion-panel 的下载量有多少?

根据 npm 官方下载统计,@cloud-ru/ds-ai-suggestion-panel 在 2026/10/10 – 2026/11/08 这 30 天内被下载 3,266 次,日均约 109 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@cloud-ru/ds-ai-suggestion-panel 还在维护吗?

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