# @antelopejs/dms-media 中文文档

规范地址：https://npmcn.com/package/%40antelopejs/dms-media/

版本：0\.7\.1
npm 元数据更新时间：2026-11-04T22:26:10.572Z
中文译文更新时间：2026-11-08T01:00:10.743Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40antelopejs/dms-media
原文对照：https://npmcn.com/package/%40antelopejs/dms-media/?lang=original
项目主页：https://dms.antelopejs.com/docs/modules/media
源码仓库：https://github.com/AntelopeJS/dms-media

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

- 包体积（解压后）：2.8 MB，771 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：11 个
- 首次发布：2026-09-16T22:59:34.870Z
- 最新版本发布：2026-11-04T22:26:10.187Z
- 近 30 天下载量：1959（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：22（近 12 个月 22 个）

## 中文简介

藏羚羊JS DMS的媒体库:上传,文件夹有每文件夹权限,图像大小和光线编辑,并有"Finder"风格的探险家.

## 安装

```sh
npm install @antelopejs/dms-media
```

也可以使用：`pnpm add @antelopejs/dms-media`、`yarn add @antelopejs/dms-media`、`bun add @antelopejs/dms-media`

## README

# `@antelopejs/dms-media`

[![npm](https://img.shields.io/npm/v/@antelopejs/dms-media?style=for-the-badge&labelColor=000000&color=000000)](https://www.npmjs.com/package/@antelopejs/dms-media) [![License](https://img.shields.io/npm/l/@antelopejs/dms-media?style=for-the-badge&labelColor=000000&color=000000)](https://npmcn.com/package/%40antelopejs/dms-media/LICENSE) [![Discord](https://img.shields.io/badge/Discord-18181B?logo=discord&style=for-the-badge&color=000000)](https://discord.gg/g4pFt6eXqu) [![Documentation](https://img.shields.io/badge/Docs-18181B?style=for-the-badge&color=000000)](https://dms.antelopejs.com/docs/modules/media)

羚羊JS DMS的媒体库:上传,文件夹,图像大小和光线编辑.

![The Media library of the Helio demo: views and folders on the left, the six top-level folders in the middle](https://npmcn.com/package/%40antelopejs/dms-media/docs/images/captures/library.webp)

## 它会做什么

-   将图像,视频和文档以Finder风格的探索器进行组织,其中包含智能视图,搜索,拖放和批量动作.
-   将文件直接上传到项目的文件存储并自稳定发送 `/media/<id>/<name>` URLs (英语).
-   渲染器在第一次请求时命名了图像大小,其收成和旋转可以还原为原始.
-   应用基于 DMS 权限和角色的每文件夹权限.
-   添加一个 `AssetType` 窗体字段,从 [`@antelopejs/interface-dms-media`](https://github.com/AntelopeJS/dms-media/tree/main/packages/interface-dms-media)在你的页面上打开了图书馆.
-   让工程船文件夹和文件作为代码 `EnsureMediaFolder` 财务报告和审定财务报表 `ImportMediaAsset`,创造了一次,从未覆盖过成员的变化.

## 安装

从已加载的工程根端运行 AtelopeJS CLI `@antelopejs/dms` 和一个文件存储模块 :

```bash
ajs project modules add @antelopejs/dms-media
```

## 快开始

将模块的链接指向API的公开URL,并允许仪表板的出处,因为浏览器直接上传到存储处:

```ts
// antelope.config.ts
"dms-media": {
  source: { type: "package", package: "@antelopejs/dms-media", version: "^0.7.0" },
  config: {
    publicBaseUrl: "${@api.API_PUBLIC_BASE_URL}",
  },
},
api: {
  config: {
    cors: { allowedOrigins: ["https://dms.example.com"] },
  },
},
```

重新打开后端, 然后打开前端 **模块 QQ 媒体** (单位:千美元)`/modules/media/overview`) (中文(简体) ). 要让成员从自己的页面中选择文件,请添加一个资产字段:

```ts
import { AssetType } from "@antelopejs/interface-dms-media";

new AssetType({
  mimetypes: ["image/*"],
  binding: { id: "articles.cover", folderName: "Article covers", permissionsFromPage: ArticlesPage },
});
```

## 兼容性

| 软件包 | 支助 | 测试过 |
| --- | --- | --- |
| `@antelopejs/interface-api` | `>=0.3.0 <1.0.0` | `0.3.0` |
| `@antelopejs/interface-api-util` | `>=0.3.0 <1.0.0` | `0.3.0` |
| `@antelopejs/interface-core` | `>=0.4.0 <1.0.0` | `0.4.0` |
| `@antelopejs/interface-database` | `>=0.3.0 <1.0.0` | `0.3.0` |
| `@antelopejs/interface-database-decorators` | `>=0.2.0 <1.0.0` | `0.2.0` |
| `@antelopejs/interface-dms` | `>=0.12.0 <1.0.0` | `0.12.0` |
| `@antelopejs/interface-dms-media` | `>=0.3.0 <0.4.0` | `0.3.1` |
| `@antelopejs/interface-file-storage` | `>=0.1.6 <1.0.0` | `0.1.6` |

模块还需要一个执行 `@antelopejs/interface-dms` 区域,以及 `@antelopejs/dms-frontend` 区域中的渲染器,其前端模块宣布在 `engines["@antelopejs/dms-frontend"]` 联 合 国 `frontend-vue/package.json`编辑 `ajs dms` CLI拒绝用这个范围以外的渲染器来建造.

-   文件存储: a `@antelopejs/interface-file-storage` 执行,例如: `@antelopejs/file-storage-local`。 。 。 .

## 文档

-   [导言](https://dms.antelopejs.com/docs/modules/media/introduction)
-   [安装](https://dms.antelopejs.com/docs/modules/media/installation)
-   [配置](https://dms.antelopejs.com/docs/modules/media/configuration)
-   [使用量](https://dms.antelopejs.com/docs/modules/media/usage/overview)
-   [扩展](https://dms.antelopejs.com/docs/modules/media/extending)
-   [财务问题](https://dms.antelopejs.com/docs/modules/media/faq)

向导的消息来源 [`packages/dms-media/docs`](https://github.com/AntelopeJS/dms-media/tree/main/packages/dms-media/docs)模块将 `dms-media` Claude代码技巧 [`packages/dms-media/skills`](https://github.com/AntelopeJS/dms-media/tree/main/packages/dms-media/skills),在 `antelopeJs.skills`。 。 。 .

## 捐款

这个包裹住在 [`AntelopeJS/dms-media`](https://github.com/AntelopeJS/dms-media) pnpm 工作空间旁边 `@antelopejs/interface-dms-media`读取 [捐款额](https://github.com/AntelopeJS/dms-media/blob/main/CONTRIBUTING.md) 编辑 [仓库读取器](https://github.com/AntelopeJS/dms-media#contributing) 用于开发命令.

## 许可证

[阿帕奇 - 2.0](https://npmcn.com/package/%40antelopejs/dms-media/LICENSE)

## 常见问题

### @antelopejs/dms-media 是什么？

藏羚羊JS DMS的媒体库:上传,文件夹有每文件夹权限,图像大小和光线编辑,并有"Finder"风格的探险家\.

### 如何安装 @antelopejs/dms-media？

在项目目录运行 npm install @antelopejs/dms-media，或使用 pnpm add / yarn add / bun add。

### @antelopejs/dms-media 支持 TypeScript 吗？

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

### @antelopejs/dms-media 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @antelopejs/dms-media 可以商用吗？

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

### @antelopejs/dms-media 的下载量有多少？

根据 npm 官方下载统计，@antelopejs/dms-media 在 2026/10/06 – 2026/11/04 这 30 天内被下载 1,959 次，日均约 65 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @antelopejs/dms-media 还在维护吗？

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