@aglyn/plugins-marketplace

中文文档
1.19.0发布于 2026/11/07Apache-2.0TypeScriptES Module构建来源已验证近 30 天下载 9804

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

中文使用文档
文档目录5 节
  1. 安装
  2. 里面有什么东西
  3. 使用量
  4. 怎样才合适
  5. 许可证

@aglyn/plugins-市场

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

从Aglyn monorepo出版到npm. 随后的版本 语义版本。 。 。 .

安装

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。在启动时,电线插件用手拨打一次的应用程序:

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

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

从根导入模型助手 :

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/ 市场

版本与发布记录

@aglyn/plugins-marketplace 共发布 162 个版本,首次发布于 2026/09/21;过去 12 个月发布了 162 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
1.19.0latest2026/11/07今天
1.18.02026/11/07今天
1.17.02026/11/07今天
1.16.02026/11/07今天
1.15.22026/11/061 天前
1.15.12026/11/061 天前

其他发布通道:beta → 1.0.0-beta.296。

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