# @aglyn/plugins-marketplace 中文文档

规范地址：https://npmcn.com/package/%40aglyn/plugins-marketplace/

版本：1\.19\.0
npm 元数据更新时间：2026-11-07T13:59:06.804Z
中文译文更新时间：2026-11-06T10:06:16.245Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40aglyn/plugins-marketplace
原文对照：https://npmcn.com/package/%40aglyn/plugins-marketplace/?lang=original
项目主页：https://aglyn.com/
源码仓库：https://github.com/aglyn/aglyn

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

- 包体积（解压后）：6.3 MB，549 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：15 个
- peer 依赖：next ^16\.3\.3，react ^19\.2\.8，firebase ^13\.0\.0，@mui/material ^9\.3\.1，firebase-admin ^14\.3\.0，@mui/x-data-grid ^9\.12\.0
- 首次发布：2026-09-20T23:53:37.875Z
- 最新版本发布：2026-11-07T13:59:06.470Z
- 近 30 天下载量：9804（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：162（近 12 个月 162 个）

## 中文简介

Aglyn的市场插件:浏览、安装、更新和发布控制台的市场列表,以及这些行动背后的服务器路径。 如果您运行 Aglyn 控制台, 并想要其中的市场, 请安装它; 它是第一 党

## 安装

```sh
npm install @aglyn/plugins-marketplace
```

也可以使用：`pnpm add @aglyn/plugins-marketplace`、`yarn add @aglyn/plugins-marketplace`、`bun add @aglyn/plugins-marketplace`

## README

# @aglyn/plugins-市场

Aglyn的市场插件:浏览、安装、更新和发布控制台的市场列表,以及这些行动背后的服务器路径。 如果您运行 Aglyn 控制台并想要其中的市场, 请安装它 ; 它是一个第一党的插件, 不是一个独立的库 .

> 从Aglyn monorepo出版到npm. 随后的版本 [语义版本](https://semver.org/)。 。 。 .

## 安装

```
npm install @aglyn/plugins-marketplace
```

同伴依赖性 : `react`, (中文(简体) ), `@mui/material`, (中文(简体) ), `firebase`, (中文(简体) ), `next`,以及 `firebase-admin` 用于服务器条目.

## 里面有什么东西

**在一个出版的网站上.** 无所自取. 列表所安装的内容(一个组件,站点模板,版式,主题,数据集计划,电子邮件模板,电子邮件启动器或插件)被复制到站点自己的收藏中,并通过正常的管道来制作,所以没有单独的站点捆绑.

**控制台** (单位:千美元)`registerMarketplaceConsole`,则 `console` 书记官长 `plugins.config.json`) (中文(简体) ). 市场枢纽 `/[orgSlug]/marketplace` 是一个 `orgNavItems` 条目,由控制台的通用 Org 插件路由服务:浏览、安装、许可证和销售部分。 报告和审查队列是 `staffPages`。在不是市场主控台页面上,它吸收控制台在不导入插件的情况下生成的部件槽:

-   `hostArtifactPublish`: 某个控制台页面所持有的(布局、主题、站点模板)的发布对话框.
-   `orgPluginInstalls`: 工作空间安装的市场插件, 在其插件页面上.
-   `pluginInstallStatus`:一个安装是否运行其安装页面上最新的可安装版本.
-   `pluginSiteSet`:一个安装适用于哪个站点.
-   `sitePluginConnections`: 站点连接到服务 已安装的插件的表单声明( 连接、 选择、 同步、 断开) , 在站点的页面上 .
-   `staffOverview`:最近采购和退款-退款回收队列,关于工作人员概况.
-   `templateGallery`:一个站点模板库的“Marketplace模板”架,通过 `install-template`。 。 。 .
-   `templateInstallStatus`: 在安装其模板的库行上“ 更新可用” , 重排 `install-template`。 。 。 .

它宣布 `templateSource` 内 `plugins.config.json`页:1 `source.type` 它的模板安装了邮票, 和"市场"徽章 一个网站的图书馆显示它.

它还登记a `rating` 自定义字段类型( e)`registerCustomFieldType`) 有星形输入.

**服务器** (单位:千美元)`registerMarketplaceConsoleApi`,则 `consoleApi` 登记员,出口自 `@aglyn/plugins-marketplace/server`) (中文(简体) ). 注册路线 `registerPluginApiRoute` 下划线 `marketplace` 前缀 :

-   安装 : `marketplace/install`, (中文(简体) ), `install-plugin`, (中文(简体) ), `install-layout`, (中文(简体) ), `install-template`, (中文(简体) ), `install-theme`, (中文(简体) ), `install-dataset-schema`, (中文(简体) ), `install-email-starter`, (中文(简体) ), `install-email-template`,以及 `update-artifact` 用于将已安装的复制件与更新的已出版版本相核对.
-   发布 : `marketplace/publish`, (中文(简体) ), `publish-plugin`, (中文(简体) ), `publish-layout`, (中文(简体) ), `publish-template`, (中文(简体) ), `publish-theme`, (中文(简体) ), `publish-dataset-schema`, (中文(简体) ), `publish-email-starter`, (中文(简体) ), `publish-email-template`, (中文(简体) ), `publisher-profile`, (中文(简体) ), `verification-request`。 。 。 .
-   名单: `marketplace/listing-versions`, (中文(简体) ), `preview-image`, (中文(简体) ), `reviews`, (中文(简体) ), `report`。 。 。 .
-   付费名单: `marketplace/pay` (在控制台上,在工作空间的卡 在文件中), `marketplace/checkout` (主机页面,保留至今的链接), `marketplace/connect` 财务报告和审定财务报表 `marketplace/publisher-standing`,加上平台上一个处理器,向webhook计费(`registerBillingWebhookHandler`) (中文(简体) ).

服务器条目还登记了服务器侧面 `rating` 字段类型,因此其验证器运行在没有客户端加载插件的写入路径上.

从其服务器声明中,它也会为另一个插件回答平台的 kill switch(`registerPluginRevocationReader`, (中文(简体) ), `plugin-revocations`:列表的撤销,运动发送路径在寄出从列表中安装的设计之前读取.

将复制件存放在另一个插件存储器的上市类型是: `install-dataset-schema`, (中文(简体) ), `publish-dataset-schema` 财务报告和审定财务报表 `update-artifact` 保持上市,它的门, 购买,出处的印花和清点 `@aglyn/aglyn/plugin-manager/plugin-artifact-types` (数据插件保存) `datasetSchema`) (中文(简体) ). 在部署中没有主人的情况下,门拒绝(`501`,或 `503` 当被宣布的主人没有开始),在写出任何内容之前.

**从 `.`**

-   `registerMarketplaceConsole`, (中文(简体) ), `BUNDLE_ID` (单位:千美元)`'marketplace'`) (中文(简体) ).
-   `MarketplaceBrowse`, (中文(简体) ), `HostPluginsCard`, (中文(简体) ), `PluginSiteSetPanel` 编辑 `useMarketplaceActions` 钩子,与控制台的上市和出版商路线共享.
-   市场模式: `MarketplaceListing`, (中文(简体) ), `MarketplacePublisherProfile`, (中文(简体) ), `InstallPin`, (中文(简体) ), `ARTIFACT_TYPE_LABELS`, (中文(简体) ), `listingArtifactLabel`, (中文(简体) ), `installTargetsFor`, (中文(简体) ), `resolveInstallPlan`, (中文(简体) ), `resolvePluginInstallState`, (中文(简体) ), `resolveUninstallTargets`, (中文(简体) ), `validateListingContent`, (中文(简体) ), `validatePublisherProfileContent`, (中文(简体) ), `isValidPublisherHandle`,以及文物更新帮助者 `planArtifactUpdate` 财务报告和审定财务报表 `applyArtifactUpdate`。 。 。 .

## 使用量

该插件通过 Aglyn 的插件管理器加载: 控制台生成的加载器显示导入软件包并调用在 `plugins.config.json`。在启动时,电线插件用手拨打一次的应用程序:

```ts
// console, client side
import { registerMarketplaceConsole } from '@aglyn/plugins-marketplace'
registerMarketplaceConsole()

// console, server side
import { registerMarketplaceConsoleApi } from '@aglyn/plugins-marketplace/server'
registerMarketplaceConsoleApi()
```

从根导入模型助手 :

```ts
import {
  listingArtifactLabel,
  validateListingContent,
  type MarketplaceListing,
} from '@aglyn/plugins-marketplace'
```

## 怎样才合适

一个插件软件包( E)`scope:plugin`) (中文(简体) ). 取决于核心`@aglyn/aglyn`(a) 租户包(`@aglyn/tenant-runtime`, (中文(简体) ), `@aglyn/tenant-data-admin`, (中文(简体) ), `@aglyn/tenant-feature-instance`)和通用软件 `@aglyn/shared-*` 软件包。 它不导入其他插件: 在页面上绘制已安装的市场插件的元素属于 `@aglyn/plugins-mui`,两者通过核心登记册相会。 核心从不导入此包;控制台通过装载器的列表和上方的槽到达.

## 许可证

阿帕奇2.0 (英语). 资料来源: [https://github.com/aglyn/aglyn/tree/main/libs/plugins/ 市场](https://github.com/aglyn/aglyn/tree/main/libs/plugins/marketplace)

## 常见问题

### @aglyn/plugins-marketplace 是什么？

Aglyn的市场插件:浏览、安装、更新和发布控制台的市场列表,以及这些行动背后的服务器路径。 如果您运行 Aglyn 控制台, 并想要其中的市场, 请安装它; 它是第一 党

### 如何安装 @aglyn/plugins-marketplace？

在项目目录运行 npm install @aglyn/plugins-marketplace，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：next（^16\.3\.3）、react（^19\.2\.8）、firebase（^13\.0\.0）、@mui/material（^9\.3\.1）、firebase-admin（^14\.3\.0）、@mui/x-data-grid（^9\.12\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @aglyn/plugins-marketplace 支持 TypeScript 吗？

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

### @aglyn/plugins-marketplace 支持 ESM 还是 CommonJS？

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

### @aglyn/plugins-marketplace 可以商用吗？

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

### @aglyn/plugins-marketplace 的下载量有多少？

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

### @aglyn/plugins-marketplace 还在维护吗？

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