# @epam/ai-dial-react-file-manager 中文文档

规范地址：https://npmcn.com/package/%40epam/ai-dial-react-file-manager/

版本：0\.4\.3
npm 元数据更新时间：2026-11-16T13:33:37.124Z
中文译文更新时间：2026-11-16T13:34:07.975Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40epam/ai-dial-react-file-manager
原文对照：https://npmcn.com/package/%40epam/ai-dial-react-file-manager/?lang=original
项目主页：https://github.com/epam/ai-dial-react-file-manager#readme
源码仓库：https://github.com/epam/ai-dial-react-file-manager

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：352 kB，74 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.2\.0
- 运行依赖：2 个
- peer 依赖：react ^19\.2\.5，react-dom ^19\.2\.5，ag-grid-react ^35\.2\.1，ag-grid-community ^35\.2\.1，@epam/ai-dial-ui-kit ^0\.16\.0
- 首次发布：2026-08-04T10:16:40.181Z
- 最新版本发布：2026-11-16T13:33:36.771Z
- 近 30 天下载量：24620（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：85（近 12 个月 85 个）

## 中文简介

对应 AI DIAL 接口的文件管理器包

## 安装

```sh
npm install @epam/ai-dial-react-file-manager
```

也可以使用：`pnpm add @epam/ai-dial-react-file-manager`、`yarn add @epam/ai-dial-react-file-manager`、`bun add @epam/ai-dial-react-file-manager`

## README

# AI DIAL 反应文件管理器

`@epam/ai-dial-react-file-manager` 是用于重用的文件管理器 AI DIAL接口. 共享控制和设计符号来自 `@epam/ai-dial-ui-kit`; 文件树, 文件操作, 上传流程, 选择, 冲突解决,以及文件管理特定样式在此软件包中存在.

该软件包仅供无害环境管理使用,用于提供反应应用程序 他们自己的坚持和后端整合 通过召回.

## 特征

-   带有树、面包屑和网格视图的文件和文件夹导航
-   上传、下载、复制、移动、重命名、删除和冲突解决流程
-   受控制和不受控制的导航和选择状态
-   可配置的行动、验证、元数据和权限管理钩
-   响应式布局和可重复使用的独立文件管理组件

## 兼容性

| 文件管理器 | 艾尔·迪亚勒·基特 | 反应 | AG 网格 | 模块格式 |
| --- | --- | --- | --- | --- |
| 目前的发展部门 | `0.14.0-dev.12` | `^19.2.5` | `^35.2.1` | 无害环境管理 |

## 安装

将软件包及其对等依赖性一起安装 :

```bash
npm install @epam/ai-dial-react-file-manager @epam/ai-dial-ui-kit \
  ag-grid-community ag-grid-react react react-dom
```

`@tabler/icons-react` 不再在该列表中: 此套件导入 图标将自己设置,因此它作为依附物进行运输,npm为您安装(参见 [以电子邮件/ai-dial-chat#8719](https://github.com/epam/ai-dial-chat/issues/8719)) (中文(简体) ). AG Grid 保持对等点 —— 网格引擎每个主机需要一个副本, 或其 模块注册中断——UI Kit、设计-系统也中断 一个主机直接用单通制成.

首先导入 UI Kit 样式表, 然后导入文件管理器样式表 :

```ts
import '@epam/ai-dial-ui-kit/styles.css';
import '@epam/ai-dial-react-file-manager/styles.css';
```

## 使用量

```tsx
import {
  DialFileManager,
  DialFileNodeType,
  type DialFile,
} from '@epam/ai-dial-react-file-manager';

const files: DialFile[] = [
  {
    id: 'documents',
    folderId: 'documents',
    name: 'Documents',
    path: '/Documents',
    nodeType: DialFileNodeType.FOLDER,
    items: [],
  },
];

export const Files = () => (
  <DialFileManager
    items={files}
    defaultPath="/Documents"
    onPathChange={(path) => console.info(path)}
  />
);
```

`DialFileManager` 管理互动状态并呼叫消费者提供 处理者坚持不懈。 消耗性申请仍然负责 装入项目、调用后端 API、处理错误并更新 `items` 手术结束后的道具 .

常见的集成回调包括:

-   `onPathChange` 财务报告和审定财务报表 `onSelectedPathsChange`
-   `onUploadFiles`, (中文(简体) ), `onUploadArchive`,以及 `onValidateUpload`
-   `onUploadValidationError`,以显示上传拒绝(超大或 不支持的文件)在主机自己的UI中,而不是内置消息
-   `onCopyFiles`, (中文(简体) ), `onMoveToFiles`,以及 `onDeleteFiles`
-   `onDownloadFiles`, (中文(简体) ), `onUnshareFiles`,以及 `onRemoveFilesAccess`
-   `onManagePermissions`, (中文(简体) ), `onPreview`,以及 `onOpenInNewTab`

## 公共 API

主要出口为: `DialFileManager`。该套件还输出:

-   `FileManagerProvider` 财务报告和审定财务报表 `useFileManagerContext`
-   `DialDestinationFolderPopup` 财务报告和审定财务报表 `DialFoldersTree`
-   文件模型、权限、资源类型和选择模式
-   文件管理动作、标签、触发视图和列定义
-   导出部件所使用的公共选项和道具类型

所有支助的公共出口申报于 `src/index.ts`。 。 。 .

## 地方发展

安装 npm 依赖性并运行完整的本地验证 :

```bash
npm ci
npm run typecheck
npm run lint
npm run test
npm run build
```

以 :

```bash
npm run storybook
```

## 出版

出版仅限于项目维护者. 构建软件包并检查 启动发布前 npm 归档 :

```bash
npm run build
npm run publish:dry
```

发布自动化负责指定版本和npm dist-tag. 不直接从特性分支发布.

## 版本

套装如下 [语义版本](https://semver.org/)更改为 导出需要消费者更改的组件、类型、行为或样式 作为断开更改处理,必须在 `CHANGELOG.md`。 。 。 .

## 捐款

见 [捐款额](https://npmcn.com/package/%40epam/ai-dial-react-file-manager/CONTRIBUTING.md) 促进发展和拉动请求 准则.

## 警卫

请如本报告所述,私下报告脆弱性 [警卫](https://npmcn.com/package/%40epam/ai-dial-react-file-manager/SECURITY.md)。 。 。 .

## 许可证

凭 [Apache 许可证 2.0](https://npmcn.com/package/%40epam/ai-dial-react-file-manager/LICENSE)。 。 。 .

## 常见问题

### @epam/ai-dial-react-file-manager 是什么？

对应 AI DIAL 接口的文件管理器包

### 如何安装 @epam/ai-dial-react-file-manager？

在项目目录运行 npm install @epam/ai-dial-react-file-manager，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19\.2\.5）、react-dom（^19\.2\.5）、ag-grid-react（^35\.2\.1）、ag-grid-community（^35\.2\.1）、@epam/ai-dial-ui-kit（^0\.16\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @epam/ai-dial-react-file-manager 支持 TypeScript 吗？

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

### @epam/ai-dial-react-file-manager 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @epam/ai-dial-react-file-manager 需要什么版本的 Node\.js？

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

### @epam/ai-dial-react-file-manager 可以商用吗？

@epam/ai-dial-react-file-manager 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @epam/ai-dial-react-file-manager 的下载量有多少？

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

### @epam/ai-dial-react-file-manager 还在维护吗？

最新版本 0\.4\.3 发布于 2026/11/16（今天）；至今共发布 85 个版本，其中过去 12 个月发布了 85 个；首次发布于 2026/08/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

