Skip to main content
هذه الصفحة مُترجَمة آليًا بواسطة الذكاء الاصطناعي. النسخة الإنجليزية هي المرجع المعتمد.عرض النسخة الإنجليزية →
تم تصميم هذه التوثيقات لاستهلاكها من قبل أدوات الذكاء الاصطناعي وكذلك البشر. إذا كنت تبني باستخدام وكيل ترميز (Claude Code أو Cursor أو Windsurf أو Continue وغيرها) أو تشغيل RAG على التوثيقات، فإن الواجهات أدناه تتيح لك دمج توثيق Raydium دون أي كشط مخصص.

ما هو متاح

يقع زر Copy page وقائمة الروابط العميقة في الزاوية العلوية اليمنى من كل صفحة (بجانب عنوان الصفحة). كلاهما مدعوم بقائمة السياق الخاصة بمنصة التوثيق.

خادم MCP

يتيح خادم MCP (Model Context Protocol) لعملاء الذكاء الاصطناعي الاستعلام عن توثيق Raydium كأداة. بمجرد التكوين، يمكن لوكيلك أن يسأل “ابحث في توثيق Raydium عن معاملات addLiquidity” والحصول على إجابات موثوقة مع الاستشهاد بها.

Claude Code

بعد الإضافة، اطلب من Claude Code “البحث في توثيق Raydium عن X” وسيستخدم الأداة.

Cursor

أضف إلى إعدادات Cursor (Cmd/Ctrl + , → MCP):

Windsurf و Continue والعملاء العامين

يمكن لأي عميل متوافق مع MCP أن يشير إلى https://docs.raydium.io/mcp. وتلك النقطة النهائية هي سطح الاستكشاف — إذ يُرجع طلب GET تكوين الخادم (الاسم والإصدار والنقل والتعليمات وقائمة الأدوات)، فلا حاجة إلى ملف بيان منفصل ولا يُقدَّم أي ملف من هذا النوع.

ما يعرضه الخادم

يعرض خادم MCP لتوثيق Raydium أداة أساسية واحدة، search_docs(query: string)، والتي تُرجع أعلى المقاطع المصنفة للاستعلام مع عناوين URL الأساسية الخاصة بها. الوكيل مسؤول عن الاستشهاد بـ URL الذي استخدمه؛ نحن لا نتتبع أو نحد من معدل الطلب لكل وكيل.

llms.txt لـ RAG

llms.txt هو معيار ناشئ لـ “فهرس التوثيق الذي يمكن قراءته آليًا”. تنشر Raydium:
  • https://docs.raydium.io/llms.txt — قائمة مسطحة لكل صفحة مع العنوان وملخص سطر واحد، منظمة حسب الفصل.
  • https://docs.raydium.io/llms-full.txt — نص Markdown الكامل لكل صفحة، مسلسل، مع الحفاظ على حدود الصفحات كعناوين.
يتم إعادة إنشاء المتغير full عند كل نشر توثيق. اسحبه على جدول زمني (يومي كافٍ) أو اجلبه عند الطلب.

قائمة النقل لكل صفحة

تحتوي كل صفحة محتوى على قائمة سياق (أعلى اليمين، بجانب العنوان) مع هذه الإجراءات بنقرة واحدة:
  • Copy — انسخ الصفحة كـ Markdown عادي.
  • View as Markdown — افتح المصدر .md في علامة تبويب جديدة حتى تتمكن من حفظه.
  • Open in ChatGPT / Claude / Perplexity — حمّل محتوى الصفحة مسبقًا في موجه الدردشة للأداة المسماة.
  • Open in Cursor / VS Code — افتح مخزن مؤقت في محرر المسمى مع محتوى الصفحة.
هذه هي الواجهة الصحيحة عندما تريد أن تسأل نموذجًا سؤالاً حول صفحة واحدة دون إعداد MCP.

ملفات السياق المُعدّة مسبقًا لوكلاء الترميز

إذا كنت تدمج Raydium وتريد أن يكون لدى وكيلك المعرفة الأساسية الصحيحة من البداية، فأسقط هذه الملفات في مشروعك:

.cursorrules / .windsurfrules / موجه النظام للوكيل

احفظ باسم .cursorrules (Cursor) أو .windsurfrules (Windsurf) أو CLAUDE.md (Claude Code) — أو الصق في موجه النظام الخاص بوكيلك. يختلف اسم الملف والموقع الدقيق حسب إصدار الأداة، لذا تحقق من توثيق إعدادات أداتك إذا لم تلتقطه تلقائيًا.

قائمة السياق المثبتة

بالنسبة لوكلاء الترميز الذين يقبلون قائمة بصفحات “يجب تضمينها دائمًا”، هذه القائمة هي الحد الأدنى من السياق المفيد لمعظم تكاملات Raydium:
اضبط بناءً على المنتجات التي تدمجها.

وصفة الفهرسة

إذا كنت تبني RAG الخاص بك ولا تريد استخدام llms-full.txt، فإليك الوصفة الأساسية:
يتم تقديم كل صفحة في مسارها الأساسي مع إضافة لاحقة .md (على سبيل المثال /sdk-api/typescript-sdk → /sdk-api/typescript-sdk.md).

تحذيرات

  • لا تلصق الحالة الخاصة في الموجهات. خادم MCP يعرف فقط ما هو في التوثيق العام. لا يجب أن تدخل مفاتيح المحفظة وبيانات اعتماد RPC والأسرار المماثلة أبدًا إلى سياق الوكيل.
  • مخرجات الذكاء الاصطناعي ليست موثوقة. تهلوس النماذج بسهولة مقلقة حول عناوين البرامج وأسماء التعليمات وقوائم الحسابات. تحقق دائمًا من التوثيق و IDL قبل الوثوق بالمعاملات التي ينشئها الوكيل.
  • انجراف الإصدار. SDK v2 قبل 1.0؛ قد تصدر الوكلاء المدربة على الإصدارات الأقدم كودًا لا يتم تجميعه مقابل إصدارك المثبت. قم بتضمين إصدار SDK المثبت في موجه النظام الخاص بوكيلك.

مؤشرات

المصادر: