# @amboras-dev/aliexpress-dropshipping 中文文档

规范地址：https://npmcn.com/package/%40amboras-dev/aliexpress-dropshipping/

版本：1\.3\.2
npm 元数据更新时间：2026-11-02T15:44:34.768Z
中文译文更新时间：2026-11-06T10:37:09.193Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40amboras-dev/aliexpress-dropshipping
原文对照：https://npmcn.com/package/%40amboras-dev/aliexpress-dropshipping/?lang=original

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

- 包体积（解压后）：133 kB，24 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：next \>=15，react \>=18
- 首次发布：2026-08-03T04:20:06.272Z
- 最新版本发布：2026-11-02T15:44:34.535Z
- 近 30 天下载量：3454（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：6（近 12 个月 6 个）

## 中文简介

AliExpress Dropping 集成安博拉斯 - 存储前置飞行和管理员设置

## 安装

```sh
npm install @amboras-dev/aliexpress-dropshipping
```

也可以使用：`pnpm add @amboras-dev/aliexpress-dropshipping`、`yarn add @amboras-dev/aliexpress-dropshipping`、`bun add @amboras-dev/aliexpress-dropshipping`

## README

# @amboras-dev/ liext- 跳槽

安博拉斯AliExpress Dropship集成的存储前端软件包. 它输出出手推车前悬钩及其结果类型.

## 东西住的地方

AliExpress OAuth, 请求签名( MD5 for `/sync`,HMAC-SHA256为 `/rest/auth/token/*`),分类浏览、产品导入、订单转发和令牌刷新,在amboras-dev-orchestrator,下 `backend/src/modules/dropshipping`。 。 。 . 它们不是美杜莎后台的一部分.

唯一的美杜莎存储 API 路由是 `POST /store/aliexpress-dropshipping/preflight-cart`。 。 。 .

## 飞行前钩

存储前端取出集成导入 `useAliexpressPreflight` 从 `@amboras-dev/aliexpress-dropshipping/client`。 。 。 .

```ts
const { mutateAsync, isPending } = useAliexpressPreflight()
const result = await mutateAsync({ cartId })
```

钩子回来了 `{ mutateAsync, isPending }`。 。 。 . `mutateAsync` 决定: `PreflightResult` 并拒绝该路径以非-2xx状态响应. 断块支付时间 `result.ok` 是虚假的. 价格波动报告于 `result.warnings` 有代码 `PRICE_DRIFT` 绝不是一个阻塞项.

## 折旧出口

这些被保存下来,以避免中断发行,并在下个主要版本被删除. 平台上没有任何东西能消耗它们.

-   `AliExpressDropshippingSettingsForm` 及其道具. 它的模型为每家店AppKey/AppSecret,但真实流是平台应用键+商家OAuth.
-   `AliExpressPluginConfig`, (中文(简体) ), `AliExpressCategoryDto`, (中文(简体) ), `AliExpressProductSummaryDto`, (中文(简体) ), `AliExpressProductDto`, (中文(简体) ), `AliExpressProductVariantDto`, (中文(简体) ), `AliExpressImportResultDto`, (中文(简体) ), `AliExpressConnectionStatusDto`, (中文(简体) ), `AliExpressTestConnectionResult`, (中文(简体) ), `AliExpressReauthReason`。 。 。 . 他们描述的路线(状态,测试-连接,产品导入,配置更新)在美杜莎并不存在.

## 常见问题

### @amboras-dev/aliexpress-dropshipping 是什么？

AliExpress Dropping 集成安博拉斯 - 存储前置飞行和管理员设置

### 如何安装 @amboras-dev/aliexpress-dropshipping？

在项目目录运行 npm install @amboras-dev/aliexpress-dropshipping，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：next（\>=15）、react（\>=18）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @amboras-dev/aliexpress-dropshipping 支持 TypeScript 吗？

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

### @amboras-dev/aliexpress-dropshipping 支持 ESM 还是 CommonJS？

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

### @amboras-dev/aliexpress-dropshipping 可以商用吗？

@amboras-dev/aliexpress-dropshipping 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @amboras-dev/aliexpress-dropshipping 的下载量有多少？

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

### @amboras-dev/aliexpress-dropshipping 还在维护吗？

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