نسخة الذكاء الاصطناعي (llms.txt)

تنشر ProxyHat نسخًا قابلة للقراءة آليًا من هذه الوثائق حتى يتمكّن مساعدو الذكاء الاصطناعي من قراءة API والاستدلال حوله مباشرةً. إذا كنت تستخدم Claude أو Cursor أو Codex أو أي أداة أخرى تعمل بنماذج LLM لبناء تكاملك، فسلّمها هذه الملفات لتحصل على صورة كاملة ودقيقة عن API دون تخمين.

أعطِ ذكاءك الاصطناعي واجهة API بأكملها

نقرة واحدة تنسخ الوثائق الكاملة مع مقدّمة قصيرة تشرح لمساعدك كيفية استخدامها — تمامًا كتثبيت مهارة. الصقها في محادثة جديدة وسيعرف الذكاء الاصطناعي واجهة ProxyHat API بأكملها.

يعمل مع Claude وChatGPT وCursor وCodex وGemini وأي مساعد آخر.

ملفان، واصطلاح واحد. تتبع ProxyHat اصطلاح llmstxt.org. الملف /llms.txt فهرس موجز ومنسّق يضم روابط إلى جميع صفحات الوثائق. أما /llms-full.txt فهو الوثائق بأكملها مسطّحةً في ملف Markdown واحد مكتفٍ بذاته — كل ما يحتاجه المساعد في لصقة واحدة.

الملفان

فهرس الروابط — ملف Markdown قصير يسرد كل صفحة من صفحات الوثائق مع ملخّص من سطر واحد وعنوان URL الخاص بها. صغير بما يكفي لإبقائه في سياق المساعد بشكل دائم؛ ويجلب النموذج الصفحات المفردة عند الحاجة.

https://docs.proxyhat.com/llms.txt

الوثائق الكاملة — جميع الصفحات مضمومة في مستند Markdown واحد. لا روابط لتتبّعها ولا حاجة إلى الجلب: الصقه مرة واحدة وسيعرف المساعد واجهة API بأكملها.

https://docs.proxyhat.com/llms-full.txt

كيفية استخدامه مع أداتك

هناك نهجان يصلحان في كل مكان:

الصقه. انقر على «نسخ للذكاء الاصطناعي» أعلاه (أو افتح https://docs.proxyhat.com/llms-full.txt وانسخ الملف بأكمله)، ثم الصقه في محادثة مساعدك أو في ملف سياق/قواعد. الخيار الأفضل عندما لا تستطيع أداتك الوصول إلى الإنترنت.
وجّهها إلى عنوان URL. أعطِ أداتك عنوان https://docs.proxyhat.com/llms.txt أو https://docs.proxyhat.com/llms-full.txt ودعها تجلبه بنفسها. الخيار الأفضل للأدوات التي تملك وصولًا إلى الويب أو إمكانية جلب الملفات.

ملاحظات خاصة بكل أداة

Claude / Claude Code — الصق محتوى llms-full.txt في المحادثة، أو أضِف عنوان URL إلى ملف CLAUDE.md في مشروعك لتلتقطه كل جلسة. كما يستطيع Claude Code جلب العنوان مباشرةً عبر أدوات الويب لديه.
Codex — ضع عنوان URL أو المحتوى المنسوخ في ملف AGENTS.md (أو في الموجّه) ليرجع إليه الوكيل أثناء كتابة تكاملك.
Cursor — أضِف https://docs.proxyhat.com/llms-full.txt ضمن Settings → Indexing & Docs (Add new doc)، أو الصق الملف في .cursorrules / قاعدة مشروع.
Kimi — الصق محتوى llms-full.txt في المحادثة، أو شارك عنوان URL واطلب منه قراءة الملف أولًا.
OpenCode — أشِر إلى عنوان URL في ملف إعدادات/قواعد الوكيل لديك، أو الصق الملف الكامل في السياق.
أي LLM آخر — القاعدة نفسها: استخدم زر «نسخ للذكاء الاصطناعي»، أو الصق محتوى llms-full.txt في مساعدك، أو وجّه أداتك إلى العناوين أعلاه.

ما الذي سيتعلمه الذكاء الاصطناعي

من هذه الملفات يحصل المساعد على كل ما يلزمه لكتابة تكامل يعمل فعلًا، بما في ذلك:

عنوان URL الأساسي — تُرسَل جميع الطلبات إلى https://api.proxyhat.com/v1.
المصادقة — كيفية الحصول على مفتاح API وإرساله بالصيغة Authorization: Bearer <key>.
نموذج المستخدمين الفرعيين — كيف يرتبط المستخدمون الفرعيون والمجموعات والإعدادات المسبقة بالوصول إلى البروكسي.
سلاسل اتصال البروكسي — قواعد بناء اسم المستخدم (الدولة والجلسة والتدوير واستهداف مرشِّح الذكاء الاصطناعي) وكيفية بناء سلسلة اتصال جاهزة للاستخدام أو جلبها.
مسار إعادة البيع — توفير البروكسيات وإدارتها نيابةً عن عملائك.
أشكال الاستجابات — أي نقاط النهاية تستخدم الغلاف القياسي {success, payload, meta, errors, description} وأيها يعيد كائنات مسطّحة، مع أسماء الحقول الحقيقية في كل موضع.

محدَّث دائمًا. يُولَّد الملفان من المصدر نفسه الذي تُولَّد منه الصفحات التي تقرأها الآن، لذا يبقى المساعد الذي يعتمد عليهما متزامنًا مع API الفعلي. وعند الشك، فضّل llms-full.txt — فهو كامل ومكتفٍ بذاته.