@agentpickup/server

中文文档
0.8.0发布于 2026/11/05FSL-1.1-ALv2TypeScriptES Module近 30 天下载 1718

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

中文使用文档

@ agentpickup/ 服务器

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

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

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é <[email protected]>" },
  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/代理接货。 。 。 .

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

版本与发布记录

@agentpickup/server 共发布 10 个版本,首次发布于 2026/11/03;过去 12 个月发布了 10 个版本。

版本发布日期距今
0.8.0latest2026/11/054 天前
0.7.02026/11/036 天前
0.6.12026/11/036 天前
0.6.02026/11/036 天前
0.4.02026/11/036 天前
0.3.02026/11/036 天前

关于 @agentpickup/server 的常见问题

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