@agentscope-ai/design 1.0.13 → 1.0.15-rc.0

package/llms/components/commonComponents/CollapsePanel/index.zh-CN.llms.txt

@@ -0,0 +1,69 @@
+
+
+<DemoTitle title="CollapsePanel" desc="折叠面板">
+#### API
+
+| 属性名 | 描述 | 类型 | 默认值 | 
+|--------|--------|--------|--------|
+| collapsedHeight | 收起状态下显示的内容高度 | number | 0 | 
+| expandedHeight | 展开状态下的内容高度，设置后内容超出时可滚动，不设置则自适应内容高度 | number | 300 | 
+| title | 面板标题 | string \| React.ReactNode | "" | 
+| expandOnPanelClick | 是否允许点击整个面板进行展开 | boolean | false | 
+| extra | 面板右侧内容 | React.ReactNode |  | 
+| children | 面板内容 | React.ReactNode |  | 
+| defaultExpanded | 是否默认展开 | boolean | false | 
+| classNames | 语义化的classNames | Partial> |  | 
+| styles | 语义化的styles | Partial<
+    Record
+  > |  | 
+
+
+
+## antd API
+
+通用属性参考：[通用属性](/docs/react/common-props)
+
+### Collapse
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| accordion | 手风琴模式 | boolean | false |  | 
+| activeKey | 当前激活 tab 面板的 key | string[] \| string  |  |  | 
+| bordered | 带边框风格的折叠面板 | boolean | true |  | 
+| collapsible | 所有子面板是否可折叠或指定可折叠触发区域 | header | - | 4.9.0 | 
+| defaultActiveKey | 初始化选中面板的 key | string[] \| string | - |  | 
+| destroyOnHidden | 销毁折叠隐藏的面板 | boolean | false | 5.25.0 | 
+| expandIcon | 自定义切换图标 | (panelProps) => ReactNode | - |  | 
+| expandIconPosition | 设置图标位置 | start | - | 4.21.0 | 
+| ghost | 使折叠面板透明且无边框 | boolean | false | 4.4.0 | 
+| size | 设置折叠面板大小 | large | middle | 5.2.0 | 
+| onChange | 切换面板的回调 | function | - |  | 
+| items | 折叠项目内容 |  | - | 5.6.0 | 
+
+
+### ItemType
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| classNames | 语义化结构 className |  | - | 5.21.0 | 
+| collapsible | 是否可折叠或指定可折叠触发区域 | header | - |  | 
+| forceRender | 被隐藏时是否渲染 body 区域 DOM 结构 | boolean | false |  | 
+| key | 对应 activeKey | string \| number | - |  | 
+| label | 面板标题 | ReactNode | - | - | 
+| showArrow | 是否展示当前面板上的箭头（为 false 时，collapsible 不能设为 icon） | boolean | true |  | 
+| styles | 语义化结构 style |  | - | 5.21.0 | 
+
+
+### Collapse.Panel
+
+<!-- prettier-ignore -->
+<Container type="warning" title="已废弃">
+版本 >= 5.6.0 时请使用 items 方式配置面板。
+</Container>
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| collapsible | 是否可折叠或指定可折叠触发区域 | header | - | 4.9.0 (icon: 4.24.0) | 
+| forceRender | 被隐藏时是否渲染 body 区域 DOM 结构 | boolean | false |  | 
+| header | 面板标题 | ReactNode | - |  | 
+| key | 对应 activeKey | string \| number | - |  | 
+| showArrow | 是否展示当前面板上的箭头（为 false 时，collapsible 不能设为 icon） | boolean | true |  | 

package/llms/components/commonComponents/DatePicker/index.zh-CN.llms.txt

@@ -0,0 +1,221 @@
+
+
+<DemoTitle title="DatePicker" desc="输入或选择时间的控件。">
+#### API
+
+<AntdApiRef url="https://ant.design/components/date-picker-cn/#api"></AntdApiRef>
+
+
+## antd API
+
+通用属性参考：[通用属性](/docs/react/common-props)
+
+日期类组件包括以下五种形式。
+
+
+- DatePicker
+- DatePicker[picker="month"]
+- DatePicker[picker="week"]
+- DatePicker[picker="year"]
+- DatePicker[picker="quarter"] (4.1.0 新增)
+- RangePicker
+
+### 国际化配置
+
+默认配置为 en-US，如果你需要设置其他语言，推荐在入口处使用我们提供的国际化组件，详见：[ConfigProvider 国际化](https://ant.design/components/config-provider-cn/)。
+
+如有特殊需求（仅修改单一组件的语言），请使用 locale 参数，参考：[默认配置](https://github.com/ant-design/ant-design/blob/master/components/date-picker/locale/example.json)。
+
+
+```jsx
+// 默认语言为 en-US，如果你需要设置其他语言，推荐在入口文件全局设置 locale
+// 确保还导入相关的 dayjs 文件，否则所有文本的区域设置都不会更改（例如范围选择器月份）
+import locale from 'antd/locale/zh_CN';
+import dayjs from 'dayjs';
+
+import 'dayjs/locale/zh-cn';
+
+dayjs.locale('zh-cn');
+
+<ConfigProvider locale={locale}>
+  <DatePicker defaultValue={dayjs('2015-01-01', 'YYYY-MM-DD')} />
+</ConfigProvider>;
+```
+
+
+<!-- prettier-ignore -->
+<Container type="warning">
+在搭配 Next.js 的 App Router 使用时，注意在引入 dayjs 的 locale 文件时加上 `'use client'`。这是由于 Ant Design 的组件都是客户端组件，在 RSC 中引入 dayjs 的 locale 文件将不会在客户端生效。
+</Container>
+### 共同的 API
+
+以下 API 为 DatePicker、 RangePicker 共享的 API。
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| allowClear | 自定义清除按钮 | boolean \| { clearIcon?: ReactNode } | true | 5.8.0: 支持对象类型 | 
+| autoFocus | 自动获取焦点 | boolean | false |  | 
+| className | 选择器 className | string | - |  | 
+| dateRender | 自定义日期单元格的内容，5.4.0 起用  | function(currentDate: dayjs, today: dayjs) => React.ReactNode | - | < 5.4.0 | 
+| cellRender | 自定义单元格的内容 | (current: dayjs, info: { originNode: React.ReactElement,today: DateType, range?: 'start' \| 'end', type: PanelMode, locale?: Locale, subType?: 'hour' \| 'minute' \| 'second' \| 'meridiem' }) => React.ReactNode | - | 5.4.0 | 
+| components | 自定义面板 | Record | - | 5.14.0 | 
+| defaultOpen | 是否默认展开控制弹层 | boolean | - |  | 
+| disabled | 禁用 | boolean | false |  | 
+| disabledDate | 不可选择的日期 | (currentDate: dayjs, info: { from?: dayjs, type: Picker }) => boolean | - | info | 
+| format | 设置日期格式，为数组时支持多格式匹配，展示以第一个为准。配置参考  |  |  |  | 
+| order | 多选、范围时是否自动排序 | boolean | true | 5.14.0 | 
+| preserveInvalidOnBlur | 失去焦点是否要清空输入框内无效内容 | boolean | false | 5.14.0 | 
+| getPopupContainer | 定义浮层的容器，默认为 body 上新建 div | function(trigger) | - |  | 
+| inputReadOnly | 设置输入框为只读（避免在移动设备上打开虚拟键盘） | boolean | false |  | 
+| locale | 国际化配置 | object |  |  | 
+| minDate | 最小日期，同样会限制面板的切换范围 | dayjs | - | 5.14.0 | 
+| maxDate | 最大日期，同样会限制面板的切换范围 | dayjs | - | 5.14.0 | 
+| mode | 日期面板的状态（ | time | - |  | 
+| needConfirm | 是否需要确认按钮，为  | boolean | - | 5.14.0 | 
+| nextIcon | 自定义下一个图标 | ReactNode | - | 4.17.0 | 
+| open | 控制弹层是否展开 | boolean | - |  | 
+| panelRender | 自定义渲染面板 | (panelNode) => ReactNode | - | 4.5.0 | 
+| picker | 设置选择器类型 | date | date | quarter | 
+| placeholder | 输入框提示文字 | string \| [string, string] | - |  | 
+| placement | 选择框弹出的位置 | bottomLeft | bottomLeft |  | 
+| prefix | 自定义前缀 | ReactNode | - | 5.22.0 | 
+| prevIcon | 自定义上一个图标 | ReactNode | - | 4.17.0 | 
+| presets | 预设时间范围快捷选择, 自  | { label: React.ReactNode, value: Dayjs \| (() => Dayjs) }[] | - |  | 
+| size | 输入框大小， | large | - |  | 
+| status | 设置校验状态 | 'error' \| 'warning' | - | 4.19.0 | 
+| style | 自定义输入框样式 | CSSProperties | {} |  | 
+| suffixIcon | 自定义的选择框后缀图标 | ReactNode | - |  | 
+| superNextIcon | 自定义  | ReactNode | - | 4.17.0 | 
+| superPrevIcon | 自定义  | ReactNode | - | 4.17.0 | 
+| variant | 形态变体 | outlined | outlined | 5.13.0 \|  | 
+| onOpenChange | 弹出日历和关闭日历的回调 | function(open) | - |  | 
+| onPanelChange | 日历面板切换的回调 | function(value, mode) | - |  | 
+
+
+### 共同的方法
+
+| 名称 | 描述 | 版本 | 
+|--------|--------|--------|
+| blur() | 移除焦点 |  | 
+| focus() | 获取焦点 |  | 
+
+
+### DatePicker
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| defaultPickerValue | 默认面板日期，每次面板打开时会被重置到该日期 |  | - | 5.14.0 | 
+| defaultValue | 默认日期，如果开始时间或结束时间为  |  | - |  | 
+| disabledTime | 不可选择的时间 | function(date) | - |  | 
+| format | 展示的日期格式，配置参考  |  | YYYY-MM-DD |  | 
+| multiple | 是否为多选，不支持  | boolean | false | 5.14.0 | 
+| pickerValue | 面板日期，可以用于受控切换面板所在日期。配合  |  | - | 5.14.0 | 
+| renderExtraFooter | 在面板中添加额外的页脚 | (mode) => React.ReactNode | - |  | 
+| showNow | 显示当前日期时间的快捷选择 | boolean | - |  | 
+| showTime | 增加时间选择功能 | Object \| boolean |  |  | 
+| showTime.defaultValue | 设置用户选择日期时默认的时分秒， |  | dayjs() |  | 
+| showWeek | DatePicker 下展示当前周 | boolean | false | 5.14.0 | 
+| value | 日期 |  | - |  | 
+| onChange | 时间发生变化的回调 | function(date: dayjs, dateString: string) | - |  | 
+| onOk | 点击确定按钮的回调 | function() | - |  | 
+| onPanelChange | 日期面板变化时的回调 | function(value, mode) | - |  | 
+
+
+### DatePicker[picker=year]
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| defaultValue | 默认日期 |  | - |  | 
+| format | 展示的日期格式，配置参考  |  | YYYY |  | 
+| multiple | 是否为多选 | boolean | false | 5.14.0 | 
+| renderExtraFooter | 在面板中添加额外的页脚 | () => React.ReactNode | - |  | 
+| value | 日期 |  | - |  | 
+| onChange | 时间发生变化的回调，发生在用户选择时间时 | function(date: dayjs, dateString: string) | - |  | 
+
+
+### DatePicker[picker=quarter]
+
+`4.1.0` 新增。
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| defaultValue | 默认日期 |  | - |  | 
+| format | 展示的日期格式，配置参考  |  | YYYY-\QQ |  | 
+| multiple | 是否为多选 | boolean | false | 5.14.0 | 
+| renderExtraFooter | 在面板中添加额外的页脚 | () => React.ReactNode | - |  | 
+| value | 日期 |  | - |  | 
+| onChange | 时间发生变化的回调，发生在用户选择时间时 | function(date: dayjs, dateString: string) | - |  | 
+
+
+### DatePicker[picker=month]
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| defaultValue | 默认日期 |  | - |  | 
+| format | 展示的日期格式，配置参考  |  | YYYY-MM |  | 
+| multiple | 是否为多选 | boolean | false | 5.14.0 | 
+| renderExtraFooter | 在面板中添加额外的页脚 | () => React.ReactNode | - |  | 
+| value | 日期 |  | - |  | 
+| onChange | 时间发生变化的回调，发生在用户选择时间时 | function(date: dayjs, dateString: string) | - |  | 
+
+
+### DatePicker[picker=week]
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| defaultValue | 默认日期 |  | - |  | 
+| format | 展示的日期格式，配置参考  |  | YYYY-wo |  | 
+| multiple | 是否为多选 | boolean | false | 5.14.0 | 
+| renderExtraFooter | 在面板中添加额外的页脚 | (mode) => React.ReactNode | - |  | 
+| value | 日期 |  | - |  | 
+| onChange | 时间发生变化的回调，发生在用户选择时间时 | function(date: dayjs, dateString: string) | - |  | 
+| showWeek | DatePicker 下展示当前周 | boolean | true | 5.14.0 | 
+
+
+### RangePicker
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| allowEmpty | 允许起始项部分为空 | [boolean, boolean] | [false, false] |  | 
+| cellRender | 自定义单元格的内容。 | (current: dayjs, info: { originNode: React.ReactElement,today: DateType, range?: 'start' \| 'end', type: PanelMode, locale?: Locale, subType?: 'hour' \| 'minute' \| 'second' \| 'meridiem' }) => React.ReactNode | - | 5.4.0 | 
+| dateRender | 自定义日期单元格的内容，5.4.0 起用  | function(currentDate: dayjs, today: dayjs) => React.ReactNode | - | < 5.4.0 | 
+| defaultPickerValue | 默认面板日期，每次面板打开时会被重置到该日期 |  | - | 5.14.0 | 
+| defaultValue | 默认日期 |  | - |  | 
+| disabled | 禁用起始项 | [boolean, boolean] | - |  | 
+| disabledTime | 不可选择的时间 | function(date: dayjs, partial:  | - | info.from | 
+| format | 展示的日期格式，配置参考  |  | YYYY-MM-DD HH:mm:ss |  | 
+| id | 设置输入框  | { start?: string, end?: string } | - | 5.14.0 | 
+| pickerValue | 面板日期，可以用于受控切换面板所在日期。配合  |  | - | 5.14.0 | 
+| presets | 预设时间范围快捷选择，自  | { label: React.ReactNode, value: (Dayjs \| (() => Dayjs))[] }[] | - |  | 
+| renderExtraFooter | 在面板中添加额外的页脚 | () => React.ReactNode | - |  | 
+| separator | 设置分隔符 | React.ReactNode |  |  | 
+| showTime | 增加时间选择功能 | Object\|boolean |  |  | 
+| showTime.defaultValue | 设置用户选择日期时默认的时分秒， |  | [dayjs(), dayjs()] |  | 
+| value | 日期 |  | - |  | 
+| onCalendarChange | 待选日期发生变化的回调。 | function(dates: [dayjs, dayjs], dateStrings: [string, string], info: { range: | - |  | 
+| onChange | 日期范围发生变化的回调 | function(dates: [dayjs, dayjs], dateStrings: [string, string]) | - |  | 
+| onFocus | 聚焦时回调 | function(event, { range: 'start' \| 'end' }) | - | range | 
+| onBlur | 失焦时回调 | function(event, { range: 'start' \| 'end' }) | - | range | 
+
+
+#### formatType
+
+
+```typescript
+import type { Dayjs } from 'dayjs';
+
+type Generic = string;
+type GenericFn = (value: Dayjs) => string;
+
+export type FormatType =
+  | Generic
+  | GenericFn
+  | Array
+  | {
+      format: string;
+      type?: 'mask';
+    };
+```
+
+
+注意：`type` 定义为 `5.14.0` 新增。

package/llms/components/commonComponents/Descriptions/index.zh-CN.llms.txt

@@ -0,0 +1,37 @@
+
+
+<DemoTitle title="Descriptions" desc="展示多个只读字段的组合">
+#### API
+
+<AntdApiRef url="https://ant.design/components/descriptions-cn/#api"></AntdApiRef>
+
+
+## antd API
+
+通用属性参考：[通用属性](/docs/react/common-props)
+
+### Descriptions
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| bordered | 是否展示边框 | boolean | false |  | 
+| colon | 配置  | boolean | true |  | 
+| column | 一行的  | number \|  | 3 |  | 
+| extra | 描述列表的操作区域，显示在右上方 | ReactNode | - | 4.5.0 | 
+| items | 描述列表项内容 |  | - | 5.8.0 | 
+| layout | 描述布局 | horizontal | horizontal |  | 
+| size | 设置列表的大小。可以设置为  | default | - |  | 
+| title | 描述列表的标题，显示在最顶部 | ReactNode | - |  | 
+| classNames | 语义化结构 class |  | - | 5.23.0 | 
+| styles | 语义化结构 style |  | - | 5.23.0 | 
+
+
+### DescriptionItem
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| label | 内容的描述 | ReactNode | - |  | 
+| span | 包含列的数量（ | number\|  | 1 | screens: 5.9.0 | 
+
+
+span 是 Description.Item 的数量。 span={2} 会占用两个 DescriptionItem 的宽度。当同时配置 `style` 和 `labelStyle`（或 `contentStyle`）时，两者会同时作用。样式冲突时，后者会覆盖前者。

package/llms/components/commonComponents/Drawer/index.zh-CN.llms.txt

@@ -0,0 +1,62 @@
+
+
+<DemoTitle title="Drawer" desc="从页面一侧滑入的操作面板，用于承载临时界面内容。">
+#### API
+
+| 属性名 | 描述 | 类型 | 默认值 | 
+|--------|--------|--------|--------|
+| showDivider | 是否显示分割线 | boolean | true | 
+
+##### Drawer.Confirm - 带按钮的抽屉
+
+| 属性名 | 描述 | 类型 | 默认值 | 
+|--------|--------|--------|--------|
+| footer | 自定义底部内容 | React.ReactNode |  | 
+| onOk | 点击确定回调 | () => void |  | 
+| okText | 确认按钮文字 | string |  | 
+| okButtonProps | 确认按钮属性 | ButtonProps |  | 
+| onCancel | 点击取消回调 | () => void |  | 
+| cancelText | 取消按钮文字 | string |  | 
+| cancelButtonProps | 取消按钮属性 | ButtonProps |  | 
+| info | 底部额外内容 | React.ReactNode |  | 
+
+<AntdApiRef url="https://ant.design/components/drawer-cn/#api"></AntdApiRef>
+
+
+## antd API
+
+通用属性参考：[通用属性](/docs/react/common-props)
+
+<!-- prettier-ignore -->
+<Container type="warning" title="注意">
+v5 使用 `rootClassName` 与 `rootStyle` 来配置最外层元素样式。原 v4 `className` 与 `style` 改至配置 Drawer 窗体样式以和 Modal 对齐。
+</Container>
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| autoFocus | 抽屉展开后是否将焦点切换至其 DOM 节点 | boolean | true | 4.17.0 | 
+| afterOpenChange | 切换抽屉时动画结束后的回调 | function(open) | - |  | 
+| className | Drawer 容器外层 className 设置，如果需要设置最外层，请使用 rootClassName | string | - |  | 
+| classNames | 语义化结构 className |  | - | 5.10.0 | 
+| closeIcon | 自定义关闭图标。5.7.0：设置为  | ReactNode |  |  | 
+| destroyOnHidden | 关闭时销毁 Drawer 里的子元素 | boolean | false | 5.25.0 | 
+| extra | 抽屉右上角的操作区域 | ReactNode | - | 4.17.0 | 
+| footer | 抽屉的页脚 | ReactNode | - |  | 
+| forceRender | 预渲染 Drawer 内元素 | boolean | false |  | 
+| getContainer | 指定 Drawer 挂载的节点， | HTMLElement \| () => HTMLElement \| Selectors \| false | body |  | 
+| height | 高度，在  | string \| number | 378 |  | 
+| keyboard | 是否支持键盘 esc 关闭 | boolean | true |  | 
+| mask | 是否展示遮罩 | boolean | true |  | 
+| maskClosable | 点击蒙层是否允许关闭 | boolean | true |  | 
+| placement | 抽屉的方向 | top | right |  | 
+| push | 用于设置多层 Drawer 的推动行为 | boolean \| { distance: string \| number } | { distance: 180 } | 4.5.0+ | 
+| rootStyle | 可用于设置 Drawer 最外层容器的样式，和  | CSSProperties | - |  | 
+| size | 预设抽屉宽度（或高度），default  | 'default' \| 'large' | 'default' | 4.17.0 | 
+| style | 设计 Drawer 容器样式，如果你只需要设置内容部分请使用  | CSSProperties | - |  | 
+| styles | 语义化结构 style |  | - | 5.10.0 | 
+| title | 标题 | ReactNode | - |  | 
+| loading | 显示骨架屏 | boolean | false | 5.17.0 | 
+| open | Drawer 是否可见 | boolean | - | 
+| width | 宽度 | string \| number | 378 |  | 
+| zIndex | 设置 Drawer 的  | number | 1000 |  | 
+| onClose | 点击遮罩层或左上角叉或取消按钮的回调 | function(e) | - |  | 
+| drawerRender | 自定义渲染抽屉 | (node: ReactNode) => ReactNode | - | 5.18.0 | 

package/llms/components/commonComponents/Dropdown/index.zh-CN.llms.txt

@@ -0,0 +1,149 @@
+
+
+<DemoTitle title="Dropdown" desc="向下弹出的列表。">
+#### API
+
+<AntdApiRef url="https://ant.design/components/dropdown-cn/#api"></AntdApiRef>
+
+
+## antd API
+
+通用属性参考：[通用属性](/docs/react/common-props)
+
+### Dropdown
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| arrow | 下拉框箭头是否显示 | boolean \| { pointAtCenter: boolean } | false |  | 
+| autoAdjustOverflow | 下拉框被遮挡时自动调整位置 | boolean | true | 5.2.0 | 
+| autoFocus | 打开后自动聚焦下拉框 | boolean | false | 4.21.0 | 
+| disabled | 菜单是否禁用 | boolean | - |  | 
+| destroyOnHidden | 关闭后是否销毁 Dropdown | boolean | false | 5.25.0 | 
+| popupRender | 自定义弹出框内容 | (menus: ReactNode) => ReactNode | - | 5.25.0 | 
+| getPopupContainer | 菜单渲染父节点。默认渲染到 body 上，如果你遇到菜单滚动定位问题，试试修改为滚动的区域，并相对其定位。 | (triggerNode: HTMLElement) => HTMLElement | () => document.body |  | 
+| menu | 菜单配置项 |  | - | 4.24.0 | 
+| overlayClassName | 下拉根元素的类名称 | string | - |  | 
+| overlayStyle | 下拉根元素的样式 | CSSProperties | - |  | 
+| placement | 菜单弹出位置： | string | bottomLeft |  | 
+| trigger | 触发下拉的行为，移动端不支持 hover | Array< | [ |  | 
+| open | 菜单是否显示，小于 4.23.0 使用  | boolean | - | 4.23.0 | 
+| onOpenChange | 菜单显示状态改变时调用，点击菜单按钮导致的消失不会触发。小于 4.23.0 使用  | (open: boolean, info: { source: 'trigger' \| 'menu' }) => void | - | info.source | 
+
+
+### Dropdown.Button
+
+属性与 Dropdown 的相同。还包含以下属性：
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| buttonsRender | 自定义左右两个按钮 | (buttons: ReactNode[]) => ReactNode[] | - |  | 
+| loading | 设置按钮载入状态，和  | boolean \| { delay: number, icon: ReactNode } | false | icon: 5.23.0 | 
+| danger | 设置危险按钮 | boolean | - | 4.23.0 | 
+| icon | 右侧的 icon | ReactNode | - |  | 
+| size | 按钮大小，和  | large | middle |  | 
+| type | 按钮类型，和  | primary | default |  | 
+| onClick | 点击左侧按钮的回调，和  | (event: React.MouseEvent) => void | - |  | 
+
+
+## 注意
+
+请确保 `Dropdown` 的子元素能接受 `onMouseEnter`、`onMouseLeave`、`onFocus`、`onClick` 事件。
+## antd API
+
+### Menu
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| defaultOpenKeys | 初始展开的 SubMenu 菜单项 key 数组 | string[] | - |  | 
+| defaultSelectedKeys | 初始选中的菜单项 key 数组 | string[] | - |  | 
+| expandIcon | 自定义展开图标 | ReactNode \|  | - | 4.9.0 | 
+| forceSubMenuRender | 在子菜单展示之前就渲染进 DOM | boolean | false |  | 
+| inlineCollapsed | inline 时菜单是否收起状态 | boolean | - |  | 
+| inlineIndent | inline 模式的菜单缩进宽度 | number | 24 |  | 
+| items | 菜单内容 |  | - | 4.20.0 | 
+| mode | 菜单类型，现在支持垂直、水平、和内嵌模式三种 | vertical | vertical |  | 
+| multiple | 是否允许多选 | boolean | false |  | 
+| openKeys | 当前展开的 SubMenu 菜单项 key 数组 | string[] | - |  | 
+| overflowedIndicator | 用于自定义 Menu 水平空间不足时的省略收缩的图标 | ReactNode |  |  | 
+| selectable | 是否允许选中 | boolean | true |  | 
+| selectedKeys | 当前选中的菜单项 key 数组 | string[] | - |  | 
+| style | 根节点样式 | CSSProperties | - |  | 
+| subMenuCloseDelay | 用户鼠标离开子菜单后关闭延时，单位：秒 | number | 0.1 |  | 
+| subMenuOpenDelay | 用户鼠标进入子菜单后开启延时，单位：秒 | number | 0 |  | 
+| theme | 主题颜色 | light | light |  | 
+| triggerSubMenuAction | SubMenu 展开/关闭的触发行为 | hover | hover |  | 
+| onClick | 点击 MenuItem 调用此函数 | function({ item, key, keyPath, domEvent }) | - |  | 
+| onDeselect | 取消选中时调用，仅在 multiple 生效 | function({ item, key, keyPath, selectedKeys, domEvent }) | - |  | 
+| onOpenChange | SubMenu 展开/关闭的回调 | function(openKeys: string[]) | - |  | 
+| onSelect | 被选中时调用 | function({ item, key, keyPath, selectedKeys, domEvent }) | -   |  | 
+
+
+更多属性查看 [rc-menu](https://github.com/react-component/menu#api)
+
+### ItemType
+
+type ItemType = [MenuItemType](#menuitemtype) | [SubMenuType](#submenutype) | [MenuItemGroupType](#menuitemgrouptype) | [MenuDividerType](#menudividertype);
+
+#### MenuItemType
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| danger | 展示错误状态样式 | boolean | false |  | 
+| disabled | 是否禁用 | boolean | false |  | 
+| extra | 额外节点 | ReactNode | - | 5.21.0 | 
+| icon | 菜单图标 | ReactNode | - |  | 
+| key | item 的唯一标志 | string | - |  | 
+| label | 菜单项标题 | ReactNode | - |  | 
+| title | 设置收缩时展示的悬浮标题 | string | - |  | 
+
+
+#### SubMenuType
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| children | 子菜单的菜单项 |  | - |  | 
+| disabled | 是否禁用 | boolean | false |  | 
+| icon | 菜单图标 | ReactNode | - |  | 
+| key | 唯一标志 | string | - |  | 
+| label | 菜单项标题 | ReactNode | - |  | 
+| popupClassName | 子菜单样式， | string | - |  | 
+| popupOffset | 子菜单偏移量， | [number, number] | - |  | 
+| onTitleClick | 点击子菜单标题 | function({ key, domEvent }) | - |  | 
+| theme | 设置子菜单的主题，默认从 Menu 上继承 | light | - |  | 
+
+
+#### MenuItemGroupType
+
+定义类型为 `group` 时，会作为分组处理:
+
+
+```ts
+const groupItem = {
+  type: 'group', // Must have
+  label: 'My Group',
+  children: [],
+};
+```
+
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| children | 分组的菜单项 |  | - |  | 
+| label | 分组标题 | ReactNode | - |  | 
+
+
+#### MenuDividerType
+
+菜单项分割线，只用在弹出菜单内，需要定义类型为 `divider`：
+
+
+```ts
+const dividerItem = {
+  type: 'divider', // Must have
+};
+```
+
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| dashed | 是否虚线 | boolean | false |  | 

package/llms/components/commonComponents/Empty/index.zh-CN.llms.txt

@@ -0,0 +1,40 @@
+
+
+<DemoTitle title="Empty" desc="用于空状态的占位图形展示。">
+## API
+
+| 属性名 | 描述 | 类型 | 默认值 | 
+|--------|--------|--------|--------|
+| type | 空状态类型 | \| 'noData'
+    \| 'networkError'
+    \| '404'
+    \| 'arrears'
+    \| 'desktopOnly'
+    \| 'noAudio'
+    \| 'noImage'
+    \| 'noVideo'
+    \| 'noAccess'
+    \| 'error'
+    \| 'noModel'
+    \| 'noApp'
+    \| 'success'
+    \| 'failed'
+    \| 'inProgress'
+    \| 'stayTuned' | 'noData' | 
+| texture | 是否显示纹理 | boolean | true | 
+| image | 图片地址 | string | 默认是no data的图片 | 
+| imageStyle | 图片样式 | React.CSSProperties |  | 
+| title | 标题内容 | React.ReactNode |  | 
+| description | 自定义描述内容 | React.ReactNode |  | 
+| onOk | ok按钮的点击事件 | (e: React.MouseEvent) => void |  | 
+| okText | ok按钮的文本 | React.ReactNode |  | 
+| okType | ok按钮的类型 | SparkButtonProps['type'] | 'primary' | 
+| okButtonProps | ok按钮的props | SparkButtonProps |  | 
+| children | 自定义空状态的内容 | React.ReactNode |  | 
+| className | 自定义空状态的类名 | string |  | 
+| style | 自定义空状态的样式 | React.CSSProperties |  | 
+| size | 自定义空状态的大小 | React.CSSProperties['width'] |  | 
+
+
+<AntdApiRef url="https://ant.design/components/empty-cn/#api"></AntdApiRef>
+

package/llms/components/commonComponents/FloatButton/index.zh-CN.llms.txt

@@ -0,0 +1,51 @@
+
+
+<DemoTitle title="FloatButton" desc="用于网站上的全局功能；无论浏览到何处都可以看见的按钮。">
+#### API
+
+<AntdApiRef url="https://ant.design/components/float-button-cn/#api"></AntdApiRef>
+
+
+## antd API
+
+通用属性参考：[通用属性](/docs/react/common-props)
+
+自 `antd@5.0.0` 版本开始提供该组件。
+
+### 共同的 API
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| icon | 自定义图标 | ReactNode | - |  | 
+| description | 文字及其它内容 | ReactNode | - |  | 
+| tooltip | 气泡卡片的内容 | ReactNode \|  | - | TooltipProps: 5.25.0 | 
+| type | 设置按钮类型 | default | default |  | 
+| shape | 设置按钮形状 | circle | circle |  | 
+| onClick | 点击按钮时的回调 | (event) => void | - |  | 
+| href | 点击跳转的地址，指定此属性 button 的行为和 a 链接一致 | string | - |  | 
+| target | 相当于 a 标签的 target 属性，href 存在时生效 | string | - |  | 
+| htmlType | 设置  | submit | button | 5.21.0 | 
+| badge | 带徽标数字的悬浮按钮（不支持  |  | - | 5.4.0 | 
+
+
+### FloatButton.Group
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| shape | 设置包含的 FloatButton 按钮形状 | circle | circle |  | 
+| trigger | 触发方式（有触发方式为菜单模式） | click | - |  | 
+| open | 受控展开，需配合 trigger 一起使用 | boolean | - |  | 
+| closeIcon | 自定义关闭按钮 | React.ReactNode |  |  | 
+| placement | 自定义菜单弹出位置 | top | top | 5.21.0 | 
+| onOpenChange | 展开收起时的回调，需配合 trigger 一起使用 | (open: boolean) => void | - |  | 
+| onClick | 点击按钮时的回调（仅在菜单模式中有效） | (event) => void | - | 5.3.0 | 
+
+
+### FloatButton.BackTop
+
+| 参数 | 说明 | 类型 | 默认值 | 版本 | 
+|--------|--------|--------|--------|--------|
+| duration | 回到顶部所需时间（ms） | number | 450 |  | 
+| target | 设置需要监听其滚动事件的元素 | () => HTMLElement | () => window |  | 
+| visibilityHeight | 滚动高度达到此参数值才出现 BackTop | number | 400 |  | 
+| onClick | 点击按钮的回调函数 | () => void | - |  |