# @agentpickup/server 中文文档

规范地址：https://npmcn.com/package/%40agentpickup/server/

版本：0\.8\.0
npm 元数据更新时间：2026-11-04T22:46:07.347Z
中文译文更新时间：2026-11-09T21:28:35.627Z
软件包许可：FSL-1\.1-ALv2

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

原始 npm 页面：https://www.npmjs.com/package/%40agentpickup/server
原文对照：https://npmcn.com/package/%40agentpickup/server/?lang=original
项目主页：https://github.com/dav3trad3r/agentpickup#readme
源码仓库：https://github.com/dav3trad3r/agentpickup

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

- 包体积（解压后）：427 kB，69 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.13
- 运行依赖：11 个
- 首次发布：2026-11-03T03:09:14.742Z
- 最新版本发布：2026-11-04T22:46:07.186Z
- 近 30 天下载量：1718（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）

## 中文简介

代理付款的取款层:x402,MPP,UCP(+AP2),ACP和卡通取出入;一签QR取款机通过;扫描后交接并结算.

## 安装

```sh
npm install @agentpickup/server
```

也可以使用：`pnpm add @agentpickup/server`、`yarn add @agentpickup/server`、`bun add @agentpickup/server`

## README

# @ agentpickup/ 服务器

代理付款的皮卡层。 一个人或AI代理在网上购买并用卡支付(Stripe), USDC(x402),或通过MPP、UCP(具有AP2授权)或ACP的 " 花边 " 共同付款。 店铺 邮件发送一个签名的QR, 工作人员扫描它在柜台, 并移交命令。 一张牌是 ;不放秀或退款.

店员和工作人员只看过店名,颜色和电子邮件地址.

```ts
import { createCollect, SqliteStore, resendMailer } from "@agentpickup/server";
import { generateSigningKeyPem } from "@agentpickup/core";

const pickup = createCollect({
  baseUrl: "https://orders.yourshop.com",
  merchant: { name: "Corner Café", brandColor: "#9a3412", fromEmail: "Corner Café <orders@yourshop.com>" },
  catalog: [{ id: "flat-white", name: "Flat white", priceCents: 450 }],
  payments: {
    card: { secretKey: process.env.STRIPE_KEY!, captureMode: "hold" },
    x402: { payTo: process.env.WALLET!, network: "eip155:8453" },
  },
  store: new SqliteStore("./data/pickup.db"),
  mailer: resendMailer({ apiKey: process.env.RESEND_KEY! }),
  signingKeyPem: process.env.PASS_SIGNING_KEY!, // generateSigningKeyPem()
  staffKey: process.env.STAFF_KEY,
});

// pickup.app is a Hono app: mount it, or call pickup.app.fetch from any runtime with Request/Response.
```

`createVenueHost` 在一个安装上运行许多场地,每个地点 `/v/<slug>` 拥有自己的菜单 付款 员工钥匙 和正方形连接器,管理通过一个行政API, 秘密封存在休息。 它还出版公众刊物 目录在 `/directory/v1/shops`代理商在某个卖他们想要的东西的人附近找到商店,包括 登记其上市的其他网站的商店`POST /directory/v1/listings`;每个代理 Pickup 商店服务 其所属机构 `/.well-known/agentpickup.json`) (中文(简体) ). 与 `signup`广场销售商在 `/connect` (与广场签约) `/seller`· ; `fxToUsdCents()` 允许AUD的场地定价和其他货币使用USDC.

连接器在屏幕上发布了工作人员已经使用的命令: `squareConnector` 用于平方 POS(菜单和 地点的标志、地址、小时和地图位置;支付货单;准备和收集两种方式) 一个连接器 API 位于 `/connect/v1` 任何其他平台都可以合并起来对抗.

第一个邮件是收据。 与 `qrEmail: "when-ready"` 标出命令后, 接应QR 准备就绪;默认是在收据中。 电子邮件通过 `cloudflareMailer` (云浮电子邮件发送)或 `resendMailer`,带有简洁的文字部分,回复商店,和 `cappedMailer` 公开演示.

存储为 `SqliteStore` (一个文件)或 `PostgresStore` (任何 pg 类客户端 : `pg`, 霓虹, Supabase), 或 你们自己 `Store`. 以其他货币计价的商店通过 `payments.x402.toUsdCents`,以及 `payments.x402.refunds` 通过主持人支付USDC的不亮相。 特工也可以订购和支付 一通电话 `<shop>/api/x402/order`,地址不变,所以x402目录如PayAI的罐头 列出商店.

节点22.13或以后(使用) `node:sqlite`) (中文(简体) ). 完整配置、路线和协议注释 : [github.com/dav3trad3r/代理接货](https://github.com/dav3trad3r/agentpickup)。 。 。 .

许可证:FSL-1.1-ALv2. 免费使用、运行和自主办自己的商店或平台;不提供 竞争的产品。 每次放出都会在出船两年后变成Apache-2.0.

## 常见问题

### @agentpickup/server 是什么？

代理付款的取款层:x402,MPP,UCP\(\+AP2\),ACP和卡通取出入;一签QR取款机通过;扫描后交接并结算\.

### 如何安装 @agentpickup/server？

在项目目录运行 npm install @agentpickup/server，或使用 pnpm add / yarn add / bun add。

### @agentpickup/server 支持 TypeScript 吗？

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

### @agentpickup/server 支持 ESM 还是 CommonJS？

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

### @agentpickup/server 需要什么版本的 Node\.js？

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

### @agentpickup/server 可以商用吗？

@agentpickup/server 使用 FSL-1\.1-ALv2 许可。声明的许可为 FSL-1\.1-ALv2，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @agentpickup/server 的下载量有多少？

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

### @agentpickup/server 还在维护吗？

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