إلى المحتوى
Perly
ابدأابدأ مجانًا

الأدلة

وصفات لمساعدي الذكاء الاصطناعي

بِع واجهة API، أو خطة SaaS، أو تطبيقًا، أو بوتًا، أو أدوات MCP بالعملات المشفرة بطلب واحد إلى مساعد يكتب الكود.

افتح بصيغة Markdown

اطلب من مساعدك «دع الناس يشترون رصيد API بـ USDC» — ويجب أن ينفّذ ذلك بشكل صحيح: وضع الاختبار أولًا، وويب هوك موقّع، والوصول فقط بعد دفع مُنفَّذ. هذه الوصفات تعلّمه ذلك. كل وصفة مهارة لـ Claude Code، وقاعدة لـ Cursor، وكتلة لـ AGENTS.md من مصدر واحد، إضافة إلى تطبيق صغير يمكن تشغيله. لا تكلّفنا شيئًا: إنها ملفات في مشروعك تتصل بـ Perly Pay بمفتاحك أنت.

الوصفةماذا تبيعالمهارةالمثال
رصيد APIرصيد مدفوع مسبقًا، استهلاك لكل طلبsell-creditsapi-credits (Hono)
اشتراك SaaSخطة شهرية، تجديد بالفاتورةsell-subscriptionsaas-subscription (Next.js)
مفاتيح الترخيصتطبيق أو إضافة تُفتح بمفتاحsell-license-keyslicense-keys (Node CLI)
بوت Telegramأوامر مدفوعة، أدوار، مجموعاتsell-bot-accesstelegram-bot (Node)
خادم MCP مدفوعأدوات MCP، رصيد لكل استدعاءpaid-mcp-toolspaid-mcp-server (MCP SDK)

ومعها ثلاث مهارات أخرى: add-crypto-checkout لأي بيع لمرة واحدة، وverify-webhooks لمسار ويب هوك صحيح في كل إطار عمل، و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 أبدًا.
  • يُتحقق من الويب هوك على الجسم الخام، ويُعالَج كل حدث مرة واحدة.
  • مفاتيح عدم التكرار على كل ما قد يتكرر، مثل استهلاك الرصيد.
  • المبالغ بالسنتات، بالدولار الأمريكي أو اليورو. لا كسور عشرية عائمة أبدًا.
  • لا خصم تلقائي: التجديدات والشحنات فواتير يدفعها المشتري من محفظته.