Fish Audio لوكلاء البرمجة بالذكاء الاصطناعي: llms.txt وMCP والمهارات (Skills)

توفر Fish Audio الآن ثلاث واجهات أصلية مصممة لوكلاء الذكاء الاصطناعي — llms.txt للتنقل، وخادم Docs MCP للبحث المباشر في واجهة برمجة التطبيقات (API)، ومهارات Claude Code القابلة للتثبيت لتوليد الكود مع إعطاء الأولوية لعدم الاتصال بالإنترنت. إليك ما يفعله كل منها، وسبب أهميته، وكيفية إعداده في أقل من خمس دقائق.

مايو 2026 | أدوات وكلاء Fish Audio متاحة الآن عبر llms.txt وMCP والمهارات

---

تُكتب معظم وثائق المطورين للبشر. فهي تفترض أنك تفتح متصفحًا، وتقرأ دليلًا، وتنسخ مقتطفًا، ثم تعود إلى محرر الكود الخاص بك. سير العمل هذا جيد عندما تعمل بمفردك، لكنه ينهار في اللحظة التي يكون فيها وكيل البرمجة الخاص بك هو من يقوم بالقراءة.

يحتاج وكلاء البرمجة بالذكاء الاصطناعي — Claude Code وCursor وCodex وWindsurf وقائمة متزايدة من الآخرين — إلى توثيق صديق لنماذج اللغة الكبيرة (LLM) بتنسيق مختلف تمامًا. هم لا يتصفحون؛ بل يجلبون البيانات. لا يلقون نظرة سريعة على العناوين؛ بل يحللون البنية. وعندما تمتلئ نافذة السياق، يصبح التوثيق غير المنظم مجرد ضجيج يزاحم الكود.

لقد رأينا هذا بأنفسنا. المطورون الذين يدمجون Fish Audio في خطوط إنتاج LLM استمروا في مواجهة نفس الفئة من الأخطاء: وكلاء البرمجة يولدون كود مصادقة لنقطة نهاية خاطئة، أو يسحبون معرفات نماذج قديمة من بيانات التدريب، أو ينشئون حمولات WebSocket بناءً على مخطط (schema) قديم. لم تكن المشكلة في واجهة برمجة التطبيقات (API) — بل في عدم وجود طريقة موثوقة للوكلاء للوصول إلى توثيق حديث ومنظم وقت التوليد.

توفر Fish Audio الآن ثلاث واجهات مخصصة لحل هذه المشكلة: llms.txt لتنقل وكلاء الذكاء الاصطناعي، وخادم Docs MCP للبحث المباشر في التوثيق، و مهارات الوكيل (Agent Skills) لتوليد الكود مع إعطاء الأولوية لعدم الاتصال. تطلق Fish Audio الثلاثة كميزات من الدرجة الأولى للمطورين — كل واحدة قابلة للاستخدام بشكل مستقل، ومصممة جميعًا للعمل معًا كطبقة توثيق أصلية لأي سير عمل لوكيل البرمجة.

هل تستخدم Fish Audio بالفعل؟ اجلب https://docs.fish.audio/llms.txt ووجه وكيلك إليه الآن — لا يلزم تكوين إضافي. ابدأ في لوحة المطورين ←

---

llms.txt: كيف يتنقل وكلاء الذكاء الاصطناعي في وثائقك

ما هو llms.txt؟

llms.txt هو معيار مفتوح ناشئ يمنح وكلاء الذكاء الاصطناعي فهرسًا نظيفًا ومنظمًا لأهم محتويات الموقع الإلكتروني. كما هو محدد في llmstxt.org، التنسيق عبارة عن ملف Markdown يتم وضعه في جذر النطاق — وهو قائمة منسقة من الروابط مع أوصاف قصيرة، منظمة في فئات ذات معنى.

فكر فيه كملف robots.txt لنماذج اللغة الكبيرة (LLMs) — إلا أنه بدلًا من إخبار الوكلاء بما يجب تجنبه، يخبرهم llms.txt بالضبط من أين يبدأون. تستخدم Fish Audio ملف llms.txt لمنح وكلاء البرمجة نقطة دخول منظمة وقليلة الضجيج إلى توثيق واجهة برمجة التطبيقات الخاصة بها.

تحتوي معظم مواقع التوثيق على مئات الصفحات. عندما يسحب وكيل البرمجة موقع توثيق كامل بشكل عشوائي، فإنه يهدر توكنات (tokens) نافذة السياق في محتوى غير ذي صلة بالمهمة — مثل إدخالات سجل التغييرات، أو نقاط النهاية المهملة، أو النصوص التسويقية. يعمل ملف llms.txt المنسق جيدًا على تصفية ذلك إلى مجموعة من نقاط الدخول عالية الجودة، مما يعني استجابات أسرع، وتكاليف توكنات أقل، وتوليد كود أكثر دقة.

يحدد المعيار أيضًا llms-full.txt — وهو متغير أوسع يتضمن محتوى صفحات كاملًا للوكلاء الذين يحتاجون إلى سياق أعمق. كلاهما بتنسيق Markdown بسيط، والذي يمكن لكل نموذج لغة كبير تحليله دون أي معالجة مسبقة.

ملفات llms.txt و llms-full.txt الخاصة بـ Fish Audio

تنشر Fish Audio نسختين، كلاهما متاح بدون مصادقة:

docs.fish.audio/llms.txt — فهرس منسق وقليل الضجيج منظم في ست فئات: ابدأ هنا، مواصفات واجهة برمجة التطبيقات، واجهة REST API الأساسية، حزم أدوات المطورين (SDKs)، أدلة المنتج، ووثائق التشغيل. يبدأ الملف برابط "بداية سريعة للوكيل" ومسار مباشر لدليل وكلاء البرمجة بالذكاء الاصطناعي، بحيث يمكن لأي وكيل توجيه نفسه في عملية جلب واحدة. يشير كل رابط إلى ملف .md — وليس HTML — بحيث يقوم الوكلاء بتحليل المحتوى مباشرة دون الحاجة لتجريد وسوم HTML.

docs.fish.audio/llms-full.txt — نسخة أوسع تتضمن مرجع المشاعر الكامل، وجميع صفحات SDK، وكل نقاط نهاية REST و WebSocket، وأدلة ممتدة لاستنساخ الصوت، والبث المباشر، والتحكم في الفونيمات عبر اللغات الإنجليزية والصينية واليابانية.

إليك مثال مبسط لملف llms.txt يوضح البنية التي تستخدمها Fish Audio:

# Fish Audio

> فهرس التوثيق الرسمي لواجهات برمجة تطبيقات Fish Audio، وSDKs، والنماذج،
> واستنساخ الصوت، والبث المباشر، والاستضافة الذاتية.

## ابدأ هنا
- [Agent Quickstart]: نقطة دخول بأقل قدر من الضجيج لوكلاء الذكاء الاصطناعي
- [Quick Start]: قم بتوليد أول صوت ذكاء اصطناعي لك في أقل من 5 دقائق
- [AI Coding Agents]: توصيل مساعدي البرمجة عبر MCP

## واجهة REST API الأساسية
- [Text to Speech Endpoint]: تحويل النص إلى كلام
- [Speech to Text Endpoint]: تحويل الصوت إلى نص
- [WebSocket TTS Streaming]: البث المباشر عبر WebSocket
...

شهد معيار llms.txt اعتمادًا سريعًا عبر أدوات المطورين والبنية التحتية للذكاء الاصطناعي — حيث قامت شركات بما في ذلك Anthropic Claude وPerplexity وCloudflare وVercel وCursor وElevenLabs وCoinbase بالفعل بنشر تطبيقاتها الخاصة. تشحن Fish Audio تطبيقًا منظمًا بالكامل عبر llms.txt وMCP ومهارات الوكيل القابلة للتثبيت — كل طبقة قابلة للاستخدام بشكل مستقل ومصممة للعمل معًا. قسم "ابدأ هنا" مصمم خصيصًا لمنح وكلاء البرمجة شجرة قرار، وليس مجرد قائمة روابط.

كيف يستخدمه الوكيل في الممارسة العملية

عندما تطلب من وكيل برمجة "تنفيذ تحويل النص إلى كلام (TTS) من Fish Audio في Python"، يقوم الوكيل المهيأ جيدًا بجلب llms.txt أولاً، ويحدد الصفحات ذات الصلة (Python SDK، نقطة نهاية TTS، المصادقة)، ويسحب تلك الصفحات كملفات Markdown، ويولد الكود من التوثيق الحالي — وليس من بيانات التدريب التي قد تكون قديمة منذ أشهر.

هذا الأمر أكثر أهمية مما يبدو. فمخططات واجهة برمجة التطبيقات (API schemas) تتغير. ويتم إهمال معرفات النماذج. وتتطور صيغة وسوم المشاعر بين أجيال النماذج. بدون جلب مباشر للتوثيق، يقوم الوكيل بتوليد كود بناءً على لقطة من واجهة برمجة التطبيقات قد لا تعمل بعد الآن.

يمنح نهج الملفين للوكلاء مسار تصعيد طبيعي: ابدأ بـ llms.txt للحصول على فهرس مركز ومنخفض التوكنات؛ ثم انتقل إلى llms-full.txt عندما تتطلب المهمة سياقًا أعمق مثل مرجع المشاعر الكامل أو سلوك البث في الحالات الخاصة.

هل تقوم بالبناء باستخدام Fish Audio بالفعل؟ وجه وكيل البرمجة الخاص بك إلى docs.fish.audio/llms.txt وتوقف عن توليد استدعاءات واجهة برمجة تطبيقات قديمة. ابدأ في لوحة المطورين ←

---

Docs MCP: بحث مباشر في واجهة برمجة التطبيقات لوكلاء البرمجة

ما هو MCP؟

MCP (Model Context Protocol) هو بروتوكول مفتوح يسمح لوكلاء البرمجة بالذكاء الاصطناعي مثل Claude Code وCursor بجلب التوثيق المباشر والبيانات الخارجية أثناء توليد الكود — دون مغادرة المحرر.

تستخدم Fish Audio بروتوكول MCP لعرض توثيق واجهة برمجة التطبيقات الكامل الخاص بها كطبقة استرجاع في الوقت الفعلي داخل وكلاء البرمجة. عند توصيل خادم Fish Audio MCP، يمكن لوكيلك الإجابة على أسئلة مثل "ما هي وسوم المشاعر التي تدعمها Fish Audio؟" أو "ما هو حد معدل الطلبات (rate limit) لنقطة نهاية TTS؟" من خلال جلب الإجابة الحالية من التوثيق المنشور، بدلاً من الاعتماد على بيانات التدريب التي قد تكون قديمة.

إعداد خادم Fish Audio MCP

خادم Fish Audio Docs MCP متاح في https://docs.fish.audio/mcp. يستغرق الإعداد أمرًا واحدًا فقط.

إعداد MCP: دليل خطوة بخطوة

يستخدم الشرح التالي Claude Code كمثال. يدعم خادم MCP الخاص بـ Fish Audio أيضًا Cursor و Windsurf — راجع روابط الإعداد الخاصة بكل محرر أدناه.

الخطوة 1 — تشغيل أمر التثبيت

افتح سطر الأوامر في مجلد مشروعك وقم بتشغيل:

claude mcp add --transport http fish-audio --scope project https://docs.fish.audio/mcp

سيؤدي هذا إلى إنشاء ملف تكوين .mcp.json في جذر مشروعك. تعني علامة --scope project أن الخادم متاح لكل من يعمل في هذا المشروع مباشرة.

الخطوة 2 — التحقق من الاتصال

claude mcp list

يجب أن ترى fish-audio في قائمة الخوادم المكونة. إذا لم يظهر، فتأكد من أنك تقوم بتشغيل الأمر داخل مجلد المشروع.

الخطوة 3 — الاختبار

اسأل Claude Code مباشرة: "ما هي نماذج Fish Audio المتاحة حاليًا؟" أو "كيف يمكنني المصادقة مع واجهة برمجة تطبيقات Fish Audio؟" إذا كان خادم MCP متصلاً، فسيقوم Claude Code بجلب الإجابة من التوثيق المباشر بدلاً من الاعتماد على بيانات التدريب.

المشكلات الشائعة:

إذا لم يظهر الخادم في claude mcp list ، فتأكد من تثبيت أحدث إصدار من Claude Code. إذا كنت تفضل أن يكون الخادم متاحًا في جميع مشاريعك بدلاً من مشروع واحد فقط، فاستبدل --scope project بـ --scope user.

هل أنت جديد في واجهة برمجة تطبيقات Fish Audio؟ ابدأ بـ مقدمة API ← لفهم المصادقة ونقاط النهاية وتنسيقات الاستجابة قبل توصيل خادم MCP.

Claude Code (مرجع سريع):

claude mcp add --transport http fish-audio --scope project https://docs.fish.audio/mcp

يؤدي هذا إلى إنشاء ملف .mcp.json في جذر مشروعك. تحقق من الاتصال:

claude mcp list
# يجب أن ترى: fish-audio

Cursor: يتم الإعداد عبر لوحة الأوامر (command palette). راجع دليل إعداد Cursor ←

Windsurf: يتم الإعداد عبر File > Preferences > Windsurf Settings. راجع دليل إعداد Windsurf ←

بمجرد الاتصال، سيكون لدى وكيل البرمجة الخاص بك وصول في الوقت الفعلي إلى:

• مرجع واجهة برمجة تطبيقات REST الكامل مع جميع المعاملات ومخططات الاستجابة
• أدلة Python و JavaScript SDK وأمثلة عمل
• أفضل الممارسات لاستنساخ الصوت والبث المباشر
• مقارنة النماذج وجداول الأسعار الحالية وحدود معدل الطلبات
• أدلة استكشاف الأخطاء وإصلاحها لمشكلات الدمج الشائعة

ما يمكنك سؤاله بمجرد الاتصال

تم تصميم خادم Fish Audio MCP للاستعلامات باللغة الطبيعية داخل المحرر الخاص بك. إليك بضعة أمثلة:

نظرًا لأن خادم MCP يستخدم الاسترداد المباشر من التوثيق المنشور، فإن الإجابات تعكس أحدث مرجع متاح لواجهة برمجة التطبيقات. عندما تطلق Fish Audio نموذجًا جديدًا أو تحدث نقطة نهاية، يراها وكيلك في الاستعلام التالي.

الأمان: يوفر خادم MCP وصولاً للقراءة فقط إلى التوثيق العام. لا يتم نقل أي مفاتيح API عبر الاتصال. تستخدم جميع الطلبات بروتوكول HTTPS. لا يتم تخزين أي استعلامات أو بيانات استخدام.

لا تستخدم Fish Audio بعد؟ ابدأ مجانًا ← — أضف خادم MCP في أقل من 30 ثانية وقم بتوليد تكاملات TTS تعمل مباشرة من التوثيق المباشر.

---

مهارات الوكيل (Agent Skills): تعليمات API مع إعطاء الأولوية لعدم الاتصال لأكثر من 50 وكيل برمجة

ما هي مهارات الوكيل؟

مهارات الوكيل هي مجموعات تعليمات قابلة لإعادة الاستخدام لوكلاء البرمجة — وهي ملفات SKILL.md منظمة تخبر الوكيل بالضبط بكيفية التعامل مع مهمة محددة، دون الحاجة إلى جلب التوثيق المباشر وقت التوليد.

تحتوي كل مهارة على اسم، ووصف، وتعليمات خطوة بخطوة يتبعها الوكيل تلقائيًا عند ظهور مهمة مطابقة.

يتم تثبيت المهارات في دليل المهارات المحلي للوكيل. يختلف المسار الدقيق حسب الوكيل — على سبيل المثال، يستخدم Claude Code المسار ~/.claude/skills/ عالميًا أو .claude/skills/ لكل مشروع. بمجرد تثبيتها، يقرأ الوكيل المهارة دون أي مطالبة إضافية. لا حاجة لخادم MCP. ولا حاجة لاستدعاء الشبكة وقت التوليد.

يحدد نظام مهارات الوكيل المفتوح (الذي تديره Vercel Labs) المواصفات ويوفر أداة سطر أوامر — npx skills — لتثبيت المهارات وتحديثها وإدارتها. يدعم حاليًا أكثر من 50 وكيلاً، بما في ذلك Claude Code وCodex وCursor وWindsurf وOpenCode وGemini CLI وGitHub Copilot.

تثبيت مهارة Fish Audio

تنشر Fish Audio مهارة وكيل جاهزة تغطي واجهة برمجة تطبيقات REST و WebSocket بالكامل: المصادقة، كل نقطة نهاية في مخطط OpenAPI، قواعد ترميز MessagePack مقابل JSON مقابل multipart، إعداد الحوار متعدد المتحدثين، وبروتوكول بث WebSocket.

npx skills add https://docs.fish.audio --skill fish-audio-api

يتم تثبيت المهارة في الدليل المحلي لوكيلك. بمجرد تثبيتها، حاول سؤال وكيل البرمجة الخاص بك:

• "استدعِ واجهة برمجة تطبيقات Fish Audio TTS باستخدام curl"
• "قم ببث TTS عبر WebSocket في Python"
• "أعدد حوارًا متعدد المتحدثين مع وسوم المشاعر مثل [happy] و [sad]"
• "ولد كلاماً باستخدام S2 بأسلوب [whispering]"

للقائمة الكاملة لوسوم المشاعر المدعومة وعناصر التحكم المتقدمة في الأداء، راجع دليل التحكم الدقيق في Fish Audio S2 ←

هل تبني مشروعًا متعدد الشخصيات؟ راجع تحويل النص إلى كلام بأصوات متعددة ← للحصول على دليل إعداد عملي.

توفر المهارة الاصطلاحات — ويتبعها الوكيل دون جلب التوثيق أولاً.

للتثبيت لوكيل محدد:

# لـ Claude Code فقط
npx skills add https://docs.fish.audio --skill fish-audio-api -a claude-code

# لـ Codex فقط
npx skills add https://docs.fish.audio --skill fish-audio-api -a codex

# لجميع الوكلاء المكتشفين مرة واحدة
npx skills add https://docs.fish.audio --skill fish-audio-api --all

قم بتشغيل npx skills --help للحصول على القائمة الكاملة لأعلام الوكلاء المدعومين.

MCP مقابل المهارات: أيهما يجب أن تستخدم؟

كلتا الأداتين تجعلان وكيل البرمجة الخاص بك أكثر دقة مع Fish Audio. إنهما محسنان لسيناريوهات مختلفة.

القاعدة العملية: استخدم MCP للبحث في التوثيق المباشر والاستعلامات الاستكشافية. استخدم المهارات لتوليد كود موثوق وذي أولوية لعدم الاتصال في الأنماط المعروفة.

في معظم إعدادات الإنتاج، من المنطقي استخدام كليهما. تتعامل المهارة مع الأنماط المعيارية — المصادقة، استدعاءات TTS الأساسية، إعداد WebSocket — دون الحاجة لرحلة عبر الشبكة. ويتعامل MCP مع الأسئلة التي لم تتوقعها: معاملات النماذج الجديدة، حدود معدل الطلبات المحدثة، والحالات الخاصة في بروتوكول البث.

---

لماذا تقصر الوثائق التقليدية أمام وكلاء الذكاء الاصطناعي

تم تحسين توثيق واجهة برمجة التطبيقات التقليدي لتصفح البشر. يحتاج وكلاء البرمجة بالذكاء الاصطناعي إلى شيء مختلف: فهارس منظمة، Markdown قليل الضجيج، ومسارات استرجاع مباشرة تقلل من التوليدات القديمة وتوكنات السياق المهدرة.

تم تصميم معظم توثيق واجهة برمجة التطبيقات لسير عمل محدد: يفتح المطور متصفحًا، ويبحث عن نقطة النهاية التي يحتاجها، ويقرأ الصفحة، وينسخ مقتطفًا. لقد عمل سير العمل هذا جيدًا لسنوات.

الافتراض الكامن وراءه — وهو أن القارئ إنسان لديه متصفح — يستحق الفحص الآن. وكلاء البرمجة بالذكاء الاصطناعي لا يستخدمون المتصفحات. بل يجلبون المحتوى الخام، ويحللونه، ويولدون الكود مما يسترجعونه. البنية التحتية التي تجعل الوثائق قابلة للقراءة للبشر — قوائم التنقل، أشرطة البحث، HTML المعالج، الوسائط المدمجة — تضيف احتكاكًا للوكلاء بدلاً من إزالته.

تتسبب بضعة أنماط محددة في معظم المشاكل:

HTML كتنسيق أساسي. يمكن للوكلاء تقنيًا تحليل HTML، ولكنه يحتوي على كمية كبيرة من العلامات الهيكلية التي لا صلة لها بالمهمة — وسوم التنسيق، والبرمجيات (scripts)، وعناصر التنقل. صفحة مكونة من 10,000 حرف من HTML قد تحتوي على 2,000 حرف فقط من التوثيق الفعلي. هذه الفجوة لها تكلفة حقيقية عندما تكون نوافذ السياق محدودة.

لا توجد نقطة دخول واضحة. موقع توثيق يحتوي على 200 صفحة لا يعطي الوكيل أي إشارة حول من أين يبدأ. بدون فهرس منظم، إما أن يسحب الوكلاء الكثير من المحتوى (إهدار التوكنات) أو يسحبون الصفحات الخاطئة (توليد كود غير صحيح).

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

لا يعد أي من هذا نقدًا لكيفية بناء التوثيق — فقد تم بناؤه للجمهور المناسب في ذلك الوقت. السؤال العملي الآن هو: مع تحول وكلاء البرمجة بالذكاء الاصطناعي إلى جزء كبير من كيفية تفاعل المطورين مع واجهات برمجة التطبيقات، هل يعمل توثيق وكيل الذكاء الاصطناعي الخاص بك لكلا الجمهورين؟

إن ملف llms.txt وخادم MCP ومهارات الوكيل من Fish Audio هي إجابتنا على هذا السؤال — ثلاث طبقات تجعل نفس التوثيق يعمل كوثائق API قابلة للقراءة من قبل البشر ووثائق قابلة للقراءة من قبل الذكاء الاصطناعي لنماذج اللغة الكبيرة ووكلاء البرمجة على حد سواء.

---

الصورة الكاملة: كيف يعمل الثلاثة معًا

إليك كيف يبدو الإعداد الكامل للطبقات الثلاث في سير عمل حقيقي:

1. يفتح الوكيل مشروعك ويواجه مهمة Fish Audio. يجلب ملف llms.txt أولاً — ليحصل على خريطة منظمة لجميع الوثائق الصديقة لـ LLM قبل سحب الصفحات الفردية. تكلفة التوكنات: ضئيلة. وقت التوجيه: عملية جلب واحدة.

2. يولد الوكيل الكود. إذا كانت مهارة fish-audio-api مثبتة، فإنه يعتمد على اصطلاحات المهارة للمصادقة وتنسيق الترميز وبروتوكول البث — لا حاجة لجلب التوثيق للأنماط المعيارية. يتطابق المخرج مع مواصفات واجهة برمجة التطبيقات من المرة الأولى.

3. يحتاج الوكيل للتحقق من شيء محدد — معرف نموذج حالي، حد معدل الطلبات، أو صيغة وسم مشاعر لـ S2. يقوم بالاستعلام من خادم MCP ويحصل على الإجابة مباشرة من التوثيق المنشور — مما يقلل من مخاطر التوليدات القديمة أو غير الصحيحة.

والنتيجة هي وكيل برمجة يولد تكاملات Fish Audio دقيقة من المحاولة الأولى، مع تقليل المراجعات ذهابًا وإيابًا وعدم التخمين بشأن ما إذا كانت نقطة النهاية أو معرف النموذج قد تغير منذ التدريب.

أطلق ميزات الصوت بشكل أسرع مع وثائق أصلية للوكلاء. ثبت مهارة Fish Audio مرة واحدة وأعد استخدام أنماط TTS الآمنة للإنتاج عبر كل مشروع. قم بتوصيل خادم MCP واجعل وكيل البرمجة الخاص بك يقرأ الوثائق بنفسه.

إعداد MCP ← · تثبيت المهارة ← · ابدأ في لوحة المطورين ←