# AI 助手配方

> 向写代码的助手提一个请求，就能用加密货币出售 API、SaaS 套餐、应用、机器人或 MCP 工具。

让助手“让大家用 USDC 购买 API 额度” — 它就应该做对：先用测试模式、签名 Webhook、付款交付后才开通访问。这些配方就是教它这样做的。每个配方都由同一来源生成 Claude Code 技能、Cursor 规则和 `AGENTS.md` 说明，外加一个可运行的小应用。它们不需要付我们任何费用：只是你项目里的文件，用你自己的密钥调用 Perly Pay。

| 配方 | 出售什么 | 技能 | 示例 |
| --- | --- | --- | --- |
| [API 额度](https://pay.perly.io/docs/recipe-api-credits.md) | 预付额度，按请求扣减 | `sell-credits` | `api-credits` (Hono) |
| [SaaS 订阅](https://pay.perly.io/docs/recipe-saas-subscription.md) | 月度套餐，按账单续订 | `sell-subscription` | `saas-subscription` (Next.js) |
| [许可证密钥](https://pay.perly.io/docs/recipe-license-keys.md) | 凭密钥解锁的应用或插件 | `sell-license-keys` | `license-keys` (Node CLI) |
| [Telegram 机器人](https://pay.perly.io/docs/recipe-telegram-bot.md) | 付费命令、角色、群组 | `sell-bot-access` | `telegram-bot` (Node) |
| [付费 MCP 服务器](https://pay.perly.io/docs/recipe-paid-mcp-server.md) | MCP 工具，按调用扣额度 | `paid-mcp-tools` | `paid-mcp-server` (MCP SDK) |

另外还有三个技能：`add-crypto-checkout` 用于任何一次性销售，`verify-webhooks` 为每个框架写出正确的 Webhook 路由，`test-and-go-live` 用于模拟付款和切换到真实资金。

## Claude Code

```bash
claude plugin marketplace add volodymyrslipak/perly-pay-ai && claude plugin install perly-pay@perly
```

然后用平常的话提要求，或调用技能：`/perly-pay:sell-credits`。

## Cursor

把插件中的 `cursor/rules/*.mdc` 复制到你项目的 `.cursor/rules/`。`perly-pay.mdc` 包含规则；每个配方都有自己的文件，对话涉及它时才会载入。

## AGENTS.md

把插件中的 `AGENTS-snippet.md` 粘贴到你的 `AGENTS.md`（Codex、Jules、Copilot、Zed、Cursor 等都会读取）。它位于 `BEGIN perly-pay` 和 `END perly-pay` 之间，所以更新时会整体替换。

## 任何助手

面向任何助手的技能列在 `/.well-known/skills/index.json` 中，每个文档页面也有 Markdown 版 — 在地址后加 `.md`，或在 `/llms-full.txt` 中一次读完全部。

## 每个配方都遵守的原则

- 先用测试模式：`sk_test_…` 密钥和 `invoices.simulate`。不动用真实资金。
- 密钥留在你的服务器上，放在 `PERLY_PAY_SECRET_KEY` 中。你分发的应用校验许可证时完全不需要密钥。
- 只凭 `invoice.fulfilled` 或 `entitlements.check` 开通访问 — 绝不凭从付款页返回，也绝不凭 `invoice.paid`。
- Webhook 在原始请求体上校验，每个事件只处理一次。
- 所有可能重复的操作都用幂等键，例如扣减额度。
- 金额以分为单位，USD 或 EUR。绝不用浮点小数。
- 绝不自动扣款：续订和充值都是账单，由买家从自己的钱包支付。