# @dutchiesdk/ecommerce-extensions-sdk 中文文档

规范地址：https://npmcn.com/package/%40dutchiesdk/ecommerce-extensions-sdk/

版本：0\.50\.0
npm 元数据更新时间：2026-11-02T17:00:40.948Z
中文译文更新时间：2026-11-13T00:50:32.287Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40dutchiesdk/ecommerce-extensions-sdk
原文对照：https://npmcn.com/package/%40dutchiesdk/ecommerce-extensions-sdk/?lang=original
项目主页：https://github.com/GetDutchie/ecommerce-extensions-sdk#readme
源码仓库：https://github.com/GetDutchie/ecommerce-extensions-sdk

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

- 包体积（解压后）：165 kB，82 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：0 个
- peer 依赖：react ^17\.0\.0 \|\| ^18\.0\.0，react-dom ^17\.0\.0 \|\| ^18\.0\.0，react-shadow ^20\.5\.0
- 首次发布：2025-06-12T16:06:42.029Z
- 最新版本发布：2026-11-02T17:00:40.774Z
- 近 30 天下载量：5876（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：63（近 12 个月 41 个）

## 中文简介

[![npm](https://img.shields.io/npm/v/@dutchiesdk/ecommerce-extensions-sdk)](https://www.npmjs.com/package/@dutchiesdk/ecommerce-extensions-sdk)

## 安装

```sh
npm install @dutchiesdk/ecommerce-extensions-sdk
```

也可以使用：`pnpm add @dutchiesdk/ecommerce-extensions-sdk`、`yarn add @dutchiesdk/ecommerce-extensions-sdk`、`bun add @dutchiesdk/ecommerce-extensions-sdk`

## README

# @dutchiesdk/电子商务扩展-sdk

[![npm](https://img.shields.io/npm/v/@dutchiesdk/ecommerce-extensions-sdk)](https://www.npmjs.com/package/@dutchiesdk/ecommerce-extensions-sdk)

反应 SDK 用于自定义商店前端扩展 **荷兰电子商务方案** 平台。 它提供 `useDataBridge()` 钩和辅助类型/组件 提供您输入的扩展组件访问医务室数据、卡车状态、用户 信息,导航动作,以及合成数据加载器.

> **阿尔法发布** ——此SDK目前为α并会被突破变化.

## 所需资源

-   节点.js 18.0.0
-   反应 ^17.0.0 或 ^18.0.0 / 反应-度 ^17.0.0 或 ^18.0.0
-   反应-阴影 ^20.5.0
-   A 类 **荷兰提供的发展环境** 光是SDK还不够 构建/部署扩展。 联系人 **[合作伙伴@dutchie.com](mailto:partners@dutchie.com)** 请求代理伙伴 访问.

## 安装

```bash
npm install @dutchiesdk/ecommerce-extensions-sdk
# or
pnpm add @dutchiesdk/ecommerce-extensions-sdk
```

## 快速启动

```tsx
import React from "react";
import {
  useDataBridge,
  RemoteBoundaryComponent,
  DataBridgeVersion,
} from "@dutchiesdk/ecommerce-extensions-sdk";

const MyExtension: RemoteBoundaryComponent = () => {
  const { dataLoaders, actions, location, user, cart } = useDataBridge();

  return (
    <div>
      <h1>Welcome to {location?.name}</h1>
      <p>Cart items: {cart?.items.length || 0}</p>
    </div>
  );
};

MyExtension.DataBridgeVersion = DataBridgeVersion;

export default MyExtension;
```

## 完整文档

完整的指南——建筑,数据桥,完整的API参考(hoks, 组件、上下文、类型、数据接口(动作、数据加载器、数据类型), 扩展开发指南、自定义产品卡、元/SEO、事件处理器、最佳 实践和实例——生活在:

**👉 [docs.dutchie.com/dutchie-core-docs/dutchie-电子商务-亲斯德克](https://docs.dutchie.com/dutchie-core-docs/dutchie-ecommerce-pro-sdk)**

另见 [`@dutchiesdk/ecommerce-sdk-cli`](https://www.npmjs.com/package/@dutchiesdk/ecommerce-sdk-cli) dev 服务器、 主题生成器和提供 AI 编码的 MCP 服务器的软件包 助理直接搜索这些文件.

## 更改日志

发布注释自动发布到 [更改日志](https://docs.dutchie.com/dutchie-core-docs/dutchie-ecommerce-pro-sdk/changelog) 文档中的页.

## 支助

-   联系您的荷兰机构伙伴代表,或 **[合作伙伴@dutchie.com](mailto:partners@dutchie.com)**
-   📚 [docs.dutchie.com (英语)](https://docs.dutchie.com/dutchie-core-docs/dutchie-ecommerce-pro-sdk)

## 许可证

麻省理工学院——由荷兰人制作

## 常见问题

### 如何安装 @dutchiesdk/ecommerce-extensions-sdk？

在项目目录运行 npm install @dutchiesdk/ecommerce-extensions-sdk，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^17\.0\.0 \|\| ^18\.0\.0）、react-dom（^17\.0\.0 \|\| ^18\.0\.0）、react-shadow（^20\.5\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @dutchiesdk/ecommerce-extensions-sdk 支持 TypeScript 吗？

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

### @dutchiesdk/ecommerce-extensions-sdk 支持 ESM 还是 CommonJS？

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

### @dutchiesdk/ecommerce-extensions-sdk 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @dutchiesdk/ecommerce-extensions-sdk 可以商用吗？

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

### @dutchiesdk/ecommerce-extensions-sdk 的下载量有多少？

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

### @dutchiesdk/ecommerce-extensions-sdk 还在维护吗？

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