@epam/ai-dial-react-file-manager

中文文档
0.4.3发布于 2026/11/16Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 2.5万

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

中文使用文档
文档目录11 节
  1. 特征
  2. 兼容性
  3. 安装
  4. 使用量
  5. 公共 API
  6. 地方发展
  7. 出版
  8. 版本
  9. 捐款
  10. 警卫
  11. 许可证

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无害环境管理

安装

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

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) (中文(简体) ). AG Grid 保持对等点 —— 网格引擎每个主机需要一个副本, 或其 模块注册中断——UI Kit、设计-系统也中断 一个主机直接用单通制成.

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

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

使用量

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 依赖性并运行完整的本地验证 :

npm ci
npm run typecheck
npm run lint
npm run test
npm run build

以 :

npm run storybook

出版

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

npm run build
npm run publish:dry

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

版本

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

捐款

见 捐款额 促进发展和拉动请求 准则.

警卫

请如本报告所述,私下报告脆弱性 警卫。 。 。 .

许可证

凭 Apache 许可证 2.0。 。 。 .

版本与发布记录

@epam/ai-dial-react-file-manager 共发布 85 个版本,首次发布于 2026/08/04;过去 12 个月发布了 85 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.4.3latest2026/11/16今天
0.5.0-dev.4development2026/11/16今天
0.4.22026/11/16今天
0.5.0-dev.32026/11/16今天
0.5.0-dev.22026/11/0510 天前
0.4.12026/11/0510 天前

其他发布通道:0.1-rc → 0.1.0-rc.0,0.2-rc → 0.2.0-rc.1,0.3-rc → 0.3.0-rc.0,0.4-rc → 0.4.0-rc.0,development → 0.5.0-dev.4。

关于 @epam/ai-dial-react-file-manager 的常见问题

@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 和提交记录判断。