# @gorgo/medusa-integration 中文文档

规范地址：https://npmcn.com/package/%40gorgo/medusa-integration/

版本：2\.0\.0
npm 元数据更新时间：2026-11-12T16:51:30.943Z
中文译文更新时间：2026-11-17T06:14:07.519Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40gorgo/medusa-integration
原文对照：https://npmcn.com/package/%40gorgo/medusa-integration/?lang=original
项目主页：https://gorgojs.com/medusa-integration-module
源码仓库：https://github.com/gorgojs/medusa-integrations

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

- 包体积（解压后）：1.8 MB，261 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：^22\.23\.4 \|\| ^24\.22\.1 \|\| \>=26\.12\.1
- 运行依赖：2 个
- peer 依赖：@medusajs/ui ^4\.1\.16，@medusajs/cli ^2\.21\.0，@medusajs/deps ^2\.21\.0，@medusajs/icons ^2\.21\.0，@medusajs/medusa ^2\.21\.0，react-router-dom ^6\.30\.4 \|\| ^7\.0\.0，@medusajs/admin-sdk ^2\.21\.0，@medusajs/dashboard ^2\.21\.0，@medusajs/framework ^2\.21\.0，@medusajs/test-utils ^2\.21\.0
- 首次发布：2026-07-15T08:24:40.516Z
- 最新版本发布：2026-11-12T16:51:30.429Z
- 近 30 天下载量：5748（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：32（近 12 个月 32 个）

## 中文简介

美杜莎综合单元

## 安装

```sh
npm install @gorgo/medusa-integration
```

也可以使用：`pnpm add @gorgo/medusa-integration`、`yarn add @gorgo/medusa-integration`、`bun add @gorgo/medusa-integration`

## README

[![Integration Module logo](https://raw.githubusercontent.com/gorgojs/medusa-integrations/refs/heads/main/assets/integration-medusa-logo.svg)](https://docs.gorgojs.com/medusa-modules/integration)

# 美杜莎综合模块

[文档](https://docs.gorgojs.com/medusa-modules/integration)  
允许任何插件或提供商声明其选项并将管理员存储在管理器中的 Medusa 模块 `medusa-config` 编辑和不调用.  
[读取](https://github.com/gorgojs/medusa-integrations/blob/HEAD/packages/modules/integration/README-ru.md)

  

 [![Medusa](https://img.shields.io/badge/Medusa-%5E2.21.0-blue?logo=medusa)](https://medusajs.com/)[![Medusa](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/gorgojs/medusa-integrations/main/.badges/medusa-integration.json&logo=checkmarx) ](https://github.com/gorgojs/medusa-integrations/actions/workflows/update-medusa-version.yml)[![npm version](https://img.shields.io/npm/v/@gorgo/medusa-integration.svg?logo=npm&label=npm)](https://www.npmjs.com/package/@gorgo/medusa-integration)

[![Support Chat on Telegram](https://img.shields.io/badge/Telegram-Support_Chat-0088cc?logo=telegram&style=social)](https://t.me/gorgojs_chat)

[![Medusa.js Chat on Telegram](https://img.shields.io/badge/Telegram-Medusa.js_Dev_Community_Chat-0088cc?logo=telegram&style=social)](https://t.me/medusajs_chat)

[![Watch the Integration Module demo video](https://static.gorgojs.com/videos/integration/demo/integration-demo-en-poster-play.794aa69b.webp)](https://static.gorgojs.com/videos/integration/demo/integration-demo-en.d5c59eb2.mp4)

[观看演示视频](https://static.gorgojs.com/videos/integration/demo/integration-demo-en.d5c59eb2.mp4)

## 什么是整合模块

集成模块允许任何插件声明其选项,并存储管理员配置为 **整合** 在管理者,没有 `medusa-config` 编辑和不调用。 该模块负责UI,存储,加密和验证.

集成模块对于任何需要可配置设置的美杜莎开发者建筑插件,提供者,或自定义模块都是有用的,例如API密钥,证书,模式,或webhooks,但谁宁愿不手建设置UI页面,数据层,以及每个模块的验证.

## 特征

-   **管理员设置管理 :** 设置在 **设置 − 集成** 节,无 `medusa-config`/env 编辑和不调用.
-   **任何插件、 提供者或模块 :** 工作涉及支付、实现、企业资源规划、通知、内容和其他扩展.
-   **声明说明`defineIntegration`:** 对选项,设置部分,验证,和连接测试的单一描述.
-   **灵活打字和验证:** 输入字段( O)`string`, (中文(简体) ), `url`, (中文(简体) ), `email`, (中文(简体) ), `uuid`, (中文(简体) ), `number`, (中文(简体) ), `boolean`, (中文(简体) ), `enum`, (中文(简体) ), `json`),具有每选项和截面规则,有条件的能见度,并只读字段. 在运行时,插件会得到一个被打出,被解密的对象. 不完全或被禁用的设置永远不会解析,所以插件永远不会得到未填充的草稿.
-   **加密机密 :** 标记字段 `secret` 被加密(AES-256-GCM),永远不能到达浏览器.
-   **多个实例 :** 同一提供者可以被配置不止一次. 例如,对于同一第三方服务中的若干账户.
-   **连接测试 :** 对照第三方服务从行政主管处对证书进行核查.
-   **更改历史 :** 模块记录了修改集成设置和时间的字段 。 您可以搜索并过滤管理员中的历史, 而秘密值永远不会到达它 .
-   **广泛的UI :** 区段可以重新排序([布局计算器](https://docs.medusajs.com/resources/admin-components/components/layout-composer)) (中文(简体) ). 如果生成的段落不够, 您可以使用自定义部件为您的选项执行任何 UI .
-   **整合目录 :** 行政官从"高尔高目录"中展示了整合情况. 加上你的,做一个 [拉请求](https://github.com/gorgojs/medusa-integrations#contribution)。 。 。 .

## 可用的整合

 [![ApiShip logo](https://raw.githubusercontent.com/gorgojs/medusa-integrations/refs/heads/main/catalog/icons/apiship.svg)](https://www.npmjs.com/package/@gorgo/medusa-fulfillment-apiship)**飞船**  
履行 [@gorgo/medusa-fulfillment-apiship (英语)](https://www.npmjs.com/package/@gorgo/medusa-fulfillment-apiship)

 [![T-Kassa logo](https://raw.githubusercontent.com/gorgojs/medusa-integrations/refs/heads/main/catalog/icons/tkassa.svg)](https://www.npmjs.com/package/@gorgo/medusa-payment-tkassa)**T银行的T-Kassa**  
付款 · [校对:soup](https://www.npmjs.com/package/@gorgo/medusa-payment-tkassa)

 [![YooKassa logo](https://raw.githubusercontent.com/gorgojs/medusa-integrations/refs/heads/main/catalog/icons/yookassa.svg)](https://www.npmjs.com/package/@gorgo/medusa-payment-yookassa)**刘克萨**  
付款 · [@gorgo/medusa-pay-yookassa (英语)](https://www.npmjs.com/package/@gorgo/medusa-payment-yookassa)

 [![Robokassa logo](https://raw.githubusercontent.com/gorgojs/medusa-integrations/refs/heads/main/catalog/icons/robokassa.svg)](https://www.npmjs.com/package/@gorgo/medusa-payment-robokassa)**罗布卡萨**  
付款 · [校对:soup](https://www.npmjs.com/package/@gorgo/medusa-payment-robokassa)

 [![Stripe logo](https://raw.githubusercontent.com/gorgojs/medusa-integrations/refs/heads/main/catalog/icons/stripe.svg)](https://www.npmjs.com/package/@gorgo/medusa-payment-stripe)**条纹**  
付款 · [@gorgo/medusa-pay-stripe (英语)](https://www.npmjs.com/package/@gorgo/medusa-payment-stripe)

 [![PayPal logo](https://raw.githubusercontent.com/gorgojs/medusa-integrations/refs/heads/main/catalog/icons/paypal.svg)](https://www.npmjs.com/package/@gorgo/medusa-payment-paypal)**付费页**  
付款 · [校对:soup](https://www.npmjs.com/package/@gorgo/medusa-payment-paypal)

 [![Authorize.net logo](https://raw.githubusercontent.com/gorgojs/medusa-integrations/refs/heads/main/catalog/icons/authorizenet.svg)](https://www.npmjs.com/package/@gorgo/medusa-payment-authorizenet)**授权. net**  
付款 · [校对:soup](https://www.npmjs.com/package/@gorgo/medusa-payment-authorizenet)

 [![Mollie logo](https://raw.githubusercontent.com/gorgojs/medusa-integrations/refs/heads/main/catalog/icons/mollie.svg)](https://www.npmjs.com/package/@gorgo/medusa-payment-mollie)**摩利语Name**  
付款 · [@gorgo/medusa-pay-mollie (英语)](https://www.npmjs.com/package/@gorgo/medusa-payment-mollie)

 [![1C logo](https://raw.githubusercontent.com/gorgojs/medusa-integrations/refs/heads/main/catalog/icons/1c.svg)](https://docs.gorgojs.com/medusa-integrations/1c-enterprise)**1C:企业**  
\* ERP [@gorgo-store/medusa-erp-1c (英语)](https://docs.gorgojs.com/medusa-integrations/1c-enterprise)

 [![1C logo](https://raw.githubusercontent.com/gorgojs/medusa-integrations/refs/heads/main/catalog/icons/1c.svg)](https://www.npmjs.com/package/@gorgo/medusa-1c)**1C: 企业目录**  
\* ERP [校对:soup](https://www.npmjs.com/package/@gorgo/medusa-1c)

任何插件都可以使用整合模块,参见 [文档](https://docs.gorgojs.com/medusa-modules/integration)。 。 。 .

## 支持社区

有问题或想法吗? 加入Telegram 支持聊天 [@gorgojs 聊天](https://t.me/gorgojs_chat)

在Telegram上与其他 Medusa 开发者连接 [@medusajs 聊天](https://t.me/medusajs_chat)

这个 [维修](https://docs.gorgojs.com/resources/maintenance) 页面解释我们如何测试、更新和修正模块.

## 所需资源

-   美杜莎 v2.21.0 或 后期
-   节点.js v22.23.4或后(22.x),v24.22.1或后(24.x),或v26.12.1或后

## 安装

```bash
yarn add @gorgo/medusa-integration
# or
npm install @gorgo/medusa-integration
```

## 配置

将模块注册到 `medusa-config.ts` 与您安装的插件的提供者, 例如 T- Kassa :

```ts
module.exports = defineConfig({
  plugins: [
    {
      resolve: "@gorgo/medusa-integration",
      options: {
        encryptionKey: process.env.INTEGRATION_ENCRYPTION_KEY,
        providers: [
          {
            resolve: "@gorgo/medusa-payment-tkassa/providers/integration-tkassa",
            id: "tkassa-1",
            options: {},
          },
        ],
      },
    },
  ],
})
```

该模块将整合及其变化历史保存在自己的表格中. 安装或更新后运行迁移 :

```bash
yarn medusa db:migrate
# or
npx medusa db:migrate
```

一旦迁移运行,则重新启动服务器. 每一个注册的融合都出现在Medusa Admin中 **设置 − 集成**。 。 。 .

## 环境变量

-   **`INTEGRATION_ENCRYPTION_KEY`** - 密码句你通过作为 `encryptionKey` 选项。 模块生成加密选项的密钥 `secret: true` 从它。 设置为长随机字符串, 例如输出 `openssl rand -hex 32`. 一个有秘密选项的供应商没有它就无法工作.
-   **`GORGO_LICENSE`** – Gorgo仪表板的项目密钥. 只有付费的Gorgo插件需要它. 模块在背景中检查他们的许可证, 并永远不屏蔽服务器启动 。 见 [安装付费插件](https://docs.gorgojs.com/licensing/install)。 。 。 .

## 文档

完整的安装、配置和使用指南可在 [戈尔戈文献网站](https://docs.gorgojs.com/medusa-modules/integration)。 。 。 .

## 许可证

凭 [MIT 许可证](https://npmcn.com/package/%40gorgo/medusa-integration/LICENSE)。 。 。 .

## 常见问题

### @gorgo/medusa-integration 是什么？

美杜莎综合单元

### 如何安装 @gorgo/medusa-integration？

在项目目录运行 npm install @gorgo/medusa-integration，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@medusajs/ui（^4\.1\.16）、@medusajs/cli（^2\.21\.0）、@medusajs/deps（^2\.21\.0）、@medusajs/icons（^2\.21\.0）、@medusajs/medusa（^2\.21\.0）、react-router-dom（^6\.30\.4 \|\| ^7\.0\.0）、@medusajs/admin-sdk（^2\.21\.0）、@medusajs/dashboard（^2\.21\.0）、@medusajs/framework（^2\.21\.0）、@medusajs/test-utils（^2\.21\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @gorgo/medusa-integration 支持 TypeScript 吗？

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

### @gorgo/medusa-integration 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @gorgo/medusa-integration 需要什么版本的 Node\.js？

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

### @gorgo/medusa-integration 可以商用吗？

@gorgo/medusa-integration 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gorgo/medusa-integration 的下载量有多少？

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

### @gorgo/medusa-integration 还在维护吗？

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

