Powerduck Cloud
تحوّل Powerduck Cloud ملف OpenAPI إلى شيء قابل للمشاركة. أضف مواصفتك واختر ما تريد عرضه، ثم شارك روابط ثابتة للتوثيق المعروض وخادم MCP مُدار. بلا استضافة ذاتية ولا تشغيل أي شيء.
تنقل Cloud إلى الويب سير العمل نفسه في عميل سطح المكتب، القائم على عقد API والمدعوم بالذكاء الاصطناعي، ليستخدمه أعضاء الفريق ومستخدمو API. تتضمن خطة Free استضافة الوثائق وMCP ضمن حصصها، بينما تزيد الخطط المدفوعة السعة وتضيف مصادر Git والنطاقات المخصصة. أما API الخاصة بتطبيقك فتستمر في العمل على خادمك الخلفي.
التدفّق
- إضافة المواصفة — ملف أو مستودع Git أو رابط. يمكنك بدء التدفّق من الموقع وتسجيل الدخول عند النشر دون إعادة الرفع.
- اختيار العرض. العمليات مفعَّلة فرادى؛ لا يتغيّر الملف الأصلي.
- فتح رابط التوثيق فوراً — التوثيق مفعَّل افتراضياً. تبقى نقطة MCP معطّلة حتى تريد تقديم أدوات للوكلاء: مفتاح تبديل.
- التحكم بالوصول. إضافة كلمة مرور عرض وتاريخ انتهاء، إضافة مفتاح وصول MCP مستقل للوكلاء.
- النشر والمشاركة. انشر المنتجات النهائية للنسخة الحالية: الروابط تعمل، والتحكم المتقدم على بُعد نقرة.
- البقاء محدّثاً. كل تغيير ينشئ نسخة جديدة للمقارنة/التراجع، وتتزامن مصادر Git مع التحديثات.
- إدارة دورة الحياة. الإيقاف المؤقت والاستئناف والأرشفة ورؤية الحالة والنسخة والمصدر بنظرة.
ما تحصل عليه
- رابط توثيق ثابت — مقروء بعد النسخ الجديدة.
- نقطة MCP مُدارة — يكتشف وكلاء الذكاء الخارجيون العمليات المختارة ويستدعونها.
- عرض لكل عملية — استبعاد الواجهات الداخلية/غير المكتملة من السطح العام.
- تحكم بالوصول — كلمة مرور العرض، الانتهاء، مفتاح وصول MCP.
- سجل النسخ — المقارنة والتراجع؛ لا يُستبدَل الأصل أبداً.
- مزامنة Git — تعكس تحديثات المستودع كنسخ مستضافة جديدة.
- نطاقات مخصصة — تجربة العلامة مع ضبط المسار الفرعي.
مستند واحد، نسخ متعددة
كل تعديل ينشئ نسخة جديدة بدل الاستبدال، للمقارنة والتراجع وإعادة توليد التوثيق/MCP لحالة محددة. التوثيق وMCP مرتبطان دائماً بمستند ونسخة محددين، لا بـ«الحالة الحالية» المبهمة.
لماذا قد لا يفتح رابط
يعمل رابط التوثيق أو MCP عند توفر ثلاثة أمور، ويُظهر مساحة المستند كل واحدة ويبرز أول شرط ناقص.
- المستند نشط — الإيقاف المؤقت يُنزِل التوثيق وMCP معاً.
- النمط المُشارَك نشط — مفتاح لكل نمط للتوثيق وMCP (التوثيق مفعَّل افتراضياً، MCP معطّل افتراضياً).
- المنتج الحالي منشور — يُبنى تلقائياً بعد إضافة نسخة أو تغيير العرض، غالباً بلا إجراء؛ نشر يدوي كاحتياط.
تعمل فحوص الوصول — كلمة مرور العرض، الانتهاء، مفتاح وصول MCP — فوق هذه الثلاثة.
تسجيل الدخول والانتماء
سجّل الدخول بـGoogle أو GitHub. بعد مصافحة OAuth، تُصدِر Powerduck جلستها الخاصة في ملف تعريف ارتباط HttpOnly آمن، ولا يُعَد رمز المزوّد هوية طويلة الأمد. كل شيء ينتمي إلى منظمة؛ تُنشَأ منظمة شخصية تلقائياً للمشاركة الجماعية لاحقاً دون إعادة تصميم.
وحدة التحكم
- Dashboard — إضافة المواصفات ورؤية المستندات الأخيرة بروابط سريعة وإجراءات تشغيل/إيقاف.
- Projects — تنظيم المستندات.
- مساحة المستند — الحالة والتوثيق وMCP والعمليات المعروضة والنسخ والمصدر والنطاقات في تبويبات واضحة.
- Billing — حالة الاشتراك والطلبات منفصلة.
- Hub — نشر واستكشاف التوثيق وخوادم MCP العامة.
- Settings وActivity — الملف الشخصي والتفضيلات وسجل التدقيق.
يستخدم القرّاء العامون عارض مستندات مخصصًا ولا يحتاجون إلى إنشاء حساب Powerduck. إذا ضُبطت كلمة مرور للعرض، فعليهم إدخالها. كلمة مرور العرض مستقلة عن تسجيل الدخول إلى حساب.
السحابة مقابل عميل سطح المكتب
| عميل سطح المكتب | السحابة | |
|---|---|---|
| التشغيل | جهازك | مستضاف |
| النموذج | ترخيص دائم، شراء لمرة واحدة | خطة مجانية واشتراكات مدفوعة |
| النتيجة | مفتاح ترخيص (يظهر مرة) | صلاحيات بحسب الخطة، دون مفتاح ترخيص |
| متى | محلي، دون اتصال، نطاق كامل | المشاركة والنشر عبر الإنترنت |
المنتجان متكاملان. توفر Cloud خطة Free، وتُشترى اشتراكات Cloud المدفوعة وتراخيص سطح المكتب كلٌّ على حدة. راجع الفوترة.