بنِ وأطلِق مجموعة مواقع ذكاء اصطناعي مركّزة على الكلمات المفتاحية باستخدام shipwords

شنو كيدير shipwords

shipwords هو إطار مفتوح المصدر ومرخّص برخصة MIT، كيسمح بتشغيل مجموعة ديال مواقع الصور والفيديو بالذكاء الاصطناعي فوق Cloudflare، مع موقع مخصّص لكل كلمة مفتاحية. القدرات المشتركة بحال الحسابات، والأداء، والرصيد، والتوليد بالذكاء الاصطناعي كتتطبّق مرة وحدة فالإطار، بينما كل موقع يقدر يكون عندو الصفحات، والهوية البصرية، والنطاق، وقاعدة البيانات، والتخزين، وحساب الأداء ديالو.

كل موقع هو تطبيق TanStack Start وReact 19 خدام فوق Cloudflare Worker خاص بيه، مع D1 وR2 وWorkflows. هاد الفصل كيخليك تطلق المواقع، وتحدّثها، ولا تحيدها بشكل مستقل، مع الاستفادة من التحسينات اللي كتدخل للنواة المشتركة فعمليات النشر الجاية.

أهم المزايا

• تسجيل الدخول بحساب Google أو بالإيميل، مع صفحات الحساب.
• دعم Stripe وPayPal، بما فيه باقات الرصيد، والاشتراكات، والطلبات، والاسترجاعات، والنزاعات.
• إشعارات بالإيميل ومحاولات مجانية للزوار، مع حدود لمكافحة الإساءة باستعمال reCAPTCHA v3.
• صفحات الخصوصية، والشروط، والاسترجاع، وDMCA.
• أدوات SEO وGEO، بما فيها sitemap.xml وrobots.txt وllms.txt.
• نظام توليد مبني على سير العمل، بحالات مهام كتسير فجهة وحدة، واسترجاع تلقائي للرصيد ديال المهام الفاشلة.
• تكامل مع Yir API لنماذج بحال GPT Image وNano Banana وSeedream وFLUX وSeedance وVeo وKling وWan.
• خدمة upstream وهمية للتطوير المحلي بلا مفتاح ديال API النموذج.
• تركيب اختياري للفيديو باستعمال حاوية ffmpeg.

المتطلبات الأولية

قبل ما تبدا، ثبّت Node 24، كيف ما محدد فملف .nvmrc ديال المستودع، وفعّل Corepack باش تكون نسخة pnpm المطلوبة متاحة:

corepack enable

فـ Windows، استعمل Git Bash ولا WSL. حساب Cloudflare وحساب Stripe ولا PayPal ضروريين ملي تكون واجد للنشر وقبول الأداءات. ماشي ضروريين للإعداد المحلي الأساسي.

ثبّت المستودع

دير fork ولا clone للمستودع، ومن بعد ثبّت التبعيات ديالو:

pnpm install

أنشئ موقع جديد

استعمل مولّد المواقع باش تنشئ موقع من القالب الكامل ديال مواقع الذكاء الاصطناعي. المعطى الأول كيولي هو المجلد داخل sites/، والنطاق كيتسجّل فإعدادات الموقع:

pnpm new-site my-tool --domain my-tool.com
pnpm install

الموقع اللي كيتولّد فيه الصفحة الرئيسية، والأسعار، ومسارات الحساب وتسجيل الدخول، وصفحات السياسات، وملفات sitemap.xml وrobots.txt وllms.txt القياسية. عاود شغّل pnpm install باش تثبّت تبعيات الموقع الجديد.

إعداد الأسرار المحلية

خلّي الأسرار المحلية خارج المستودع. أنشئ مجلد الإعدادات، ونسخ ملف متغيرات المثال ديال الموقع اللي تولّد، وربط إعدادات worktree:

mkdir -p ~/.config/shipwords
cp sites/my-tool/.dev.vars.example ~/.config/shipwords/my-tool.dev.vars
pnpm setup:worktree

الإعدادات النموذجية مصمّمة باش تخدم مباشرة فالتطوير المحلي. أكواد تسجيل الدخول بالإيميل كيبانو فطرفية خادم التطوير، والحسابات الجديدة كيتعطاها رصيد التسجيل، والتوليد كيستعمل upstream الوهمي ملي كتكون UPSTREAM_MOCK=1. بهاد الطريقة تقدر تجرّب التطبيق بلا مفتاح ديال API النموذج.

زيد التوليد الحقيقي

باش تدير طلبات حقيقية للنماذج، زِد مفتاح Yir API وطفّي upstream الوهمي بتغيير UPSTREAM_MOCK.

جرّب الأداءات

باش تجرّب شراء الرصيد، زِد مفتاح اختبار ديال Stripe كيبدا بـ sk_test_. من مجلد الموقع، شغّل أداة تحويل webhooks ديال المستودع باش يقدر التطوير المحلي يستقبل أحداث Stripe:

node ../../tools/stripe-listen.mjs

كود الأداء المشترك مصمّم باش يتعامل مع أحداث الأداء المتكررة ولا اللي وصلات بترتيب مختلف، والأداءات المزدوجة، والاسترجاعات ديال المهام الفاشلة.

إعداد تسجيل الدخول الاختياري ودخول الزوار

المحاولات المجانية للزوار كتحتاج مفاتيح reCAPTCHA. بلا هاد المفاتيح، خاص الزوار يسجلو الدخول قبل أول عملية توليد. تسجيل الدخول بحساب Google اختياري؛ إلا فعّلتو، أنشئ عميل Google OAuth واستعمل http://localhost:<port> كأصل مسموح به. تسجيل الدخول بالإيميل كيخدم بلا Google OAuth.

شغّل الموقع محلياً

دخل للموقع اللي تولّد، أنشئ ملفات قاعدة البيانات المحلية، طبّق الترحيلات المحلية، وشغّل خادم التطوير:

cd sites/my-tool
pnpm db:generate && pnpm db:migrate:local
pnpm dev

حلّ الرابط المحلي اللي كيطبعه خادم التطوير. تقدر تجرّب المصادقة بالإيميل، وإنشاء الحساب، والرصيد، والتوليد الوهمي باستعمال الإعدادات النموذجية.

استعمل أوامر المستودع

معظم الأوامر تقدر تحددها لموقع معيّن ولا تستعملها لفحوصات المستودع كامل:

pnpm new-site <dir> --domain <domain>
pnpm list-sites
pnpm setup:worktree
pnpm --filter "./sites/<site>" dev
pnpm --filter "./sites/<site>" check
pnpm check:packages
pnpm check:template
pnpm lint && pnpm test:tools

الأمر list-sites كيبني لائحة المواقع انطلاقاً من كود وREADME ديال كل موقع. الأمر check ديال الموقع كيدير فحص الأنواع، والبناء، وفحوصات التشغيل. فحوصات الحزم كتغطي النواة المشتركة وحزم jobs، بينما فحوصات القالب والأدوات كتعاون تلقى المشاكل قبل الإطلاق.

بني موقع باستعمال وكيل للبرمجة بالذكاء الاصطناعي

إلا كنت عارف من قبل الكلمة المفتاحية اللي باغي تستهدف، فالمستودع كيدعم سير عمل موجّه بالوكيل. فـ Claude Code ولا Codex ولا Cursor، عطِيه تعليمات الوكيل ديال المستودع وطلب منو يبني الموقع:

Read shipwords.dev/llms.txt and build a site for "<your keyword>"

الوكيل يگدر ينسخ المستودع، ينشئ الموقع، ويشغلو محلياً. القواعد ديال وكلاء البرمجة بالذكاء الاصطناعي موثقة فـ AGENTS.md. إلا كنت محتاج أفكار على الكلمات المفتاحية الجديدة، المشروع المنفصل new-term-radar كيراقب المصطلحات الجديدة ديال الذكاء الاصطناعي فـ X وHugging Face وGitHub وخرائط المواقع.

خصّص السلوك المتقدم ديال الموقع

استعمل بيئة التشغيل المشتركة ديال التوليد

الحزمة packages/jobs كتوفر بيئة تشغيل مبنية على سير العمل، وواجهة للمحوّل العلوي، ومحوّل Yir، ومصدر علوي محلي وهمي، وزيد عليهم تركيب اختياري باستعمال ffmpeg. خلّي سلوك التوليد الخاص بالموقع فإعدادات الموقع، واستعمل بيئة التشغيل المشتركة لمعالجة المهام والتعامل مع استرجاع المبالغ.

حدّد حدود تكلفة التوليد

استدعاءات النماذج عبر Yir كتتحاسب على كل طلب. الحد الأقصى لتكلفة كل مهمة متحدد فـ site.models.ts. راجع هاد الحدود قبل ما تفعّل التوليد الحقيقي، باش تكون الأثمنة ديال الموقع وسلوك الرصيد متوافقين مع أقصى تكلفة عند المزوّد العلوي.

درس مثال الفيديو

إلى كان الموقع مركز على الفيديو، شوف sites/tinydeskai-example. هادا هو المصدر الكامل ديال Tiny Desk AI، وكيبيّن خانات الصور، وتحرير الفيديو فمرّة وحدة، والتحقق من المخرجات، وتركيب ffmpeg، وصفحات المحتوى. سير العمل ديالو كيحوّل مقطع انتشر بزاف لقالب يقدرو الزوار يستعملوه بالصور اللي كيرفعو.

خلّي المواقع مستقلة

كل موقع كيتنشر بوحدو، وعندو قاعدة البيانات والتخزين وحساب الأداء الخاص به. هاد البنية كتخليك تحسّن النواة المشتركة مرّة وحدة، وتنشر التحديث فالمواقع اللي بغيتي، بلا ما تربط بين إطلاقها أو إيقافها.

وجّد للإنتاج

ملي يخدم الموقع محلياً، تبع دليل إطلاق الموقع باش تعرف مسار الإنتاج. حسب حساب تكلفة النطاق، واستعمال Cloudflare، ومصاريف معالجة الأداء، وطلبات نماذج Yir. مواقع الفيديو اللي كتلصق المقاطع ببعضياتها كتستعمل Cloudflare Containers وكتحتاج لخطة Workers Paid.

قبل الإطلاق، تأكد من المصادقة ديال الموقع، وwebhooks ديال الأداء، وسلوك الرصيد، وفشل التوليد، واسترجاع المبالغ، وصفحات السياسات، وملفات SEO، وإعدادات التحليلات. المستودع كيوفر حتى توثيق للبنية والتطوير المحلي باش تلقى تفاصيل أعمق على الإعدادات.

الخلاصة

shipwords كيوفر أساس عملي لإطلاق مواقع متعددة ديال الذكاء الاصطناعي مركزة على الكلمات المفتاحية، بلا ما تعاود تبني المصادقة، والفوترة، والأرصدة، وسير عمل التوليد، ودعم SEO لكل مشروع. بدا بالقالب، واستعمل المزوّد العلوي الوهمي فالاختبار المحلي، وزد المزوّدين الحقيقيين ملي تكون واجد، ونشّر كل موقع سالِي بوحدو على Cloudflare.