إنتقل إلى المحتوى الرئيسي

الإعدادات

تغطي إعدادات عميل سطح المكتب مظهر التطبيق وطريقة إرسال الطلبات. تُبقَى تفضيلات التطبيق منفصلة عن تغييرات مستند الواجهة: تبديل المظهر أو إعداد وكيل لا يعدّل العقد.

المظهر​

  • السمة — التبديل بين الفاتح والداكن (theme.get، theme.set)؛ يُطبَّق التغيير على التطبيق كله ويُحفَظ.
  • لغة الواجهة — اختر من عشر لغات أو اتبع النظام تلقائياً.
English (US)简体中文繁體中文
日本語한국어Français
DeutschEspañolPortuguês (Brasil)
العربية

تُعرَض العربية من اليمين إلى اليسار. خيار auto يتبع لغة النظام.

سلوك الطلبات​

تتحكم هذه الإعدادات في الطلبات الصادرة في مساحة العمل والسيناريوهات.

  • مهلة الطلب (requestTimeoutMs) — بالمللي ثانية؛ 0 تعني بلا حد.
  • SSL الصارم (strictSSL) — التحقق من شهادة TLS؛ يُوقَف للخوادم الموقَّعة ذاتياً أو غير الموثوقة.
  • اتباع التحويلات (followRedirects) وأقصى تحويلات (maxRedirects).
  • إصدار HTTP (protocolVersion) — http1، http2، auto.
  • تعطيل ملفات الارتباط (disableCookies) — يوقف إدارة ملفات ارتباط الطلب.

الوكيل​

اضبط وكيلاً صادراً عبر وضع (off، system، custom).

  • off — بلا وكيل.
  • system — اتبع وكيل نظام التشغيل.
  • custom — استخدم رابط وكيل، مع اسم مستخدم وكلمة مرور وقائمة استثناء اختيارية.

تقبل قائمة الاستثناء المضيفين والأنماط (مثل localhost,127.0.0.1، مضيفين بنجوم). كلمة مرور الوكيل قابلة للكتابة لا القراءة وتُمسَح بقيمة فارغة.

TLS وشهادات العميل​

للبيئات ذات الثقة المخصصة أو TLS المتبادل:

  • CA مخصصة — فعّل وحدّد مسار شهادة CA للوثوق بجذر داخلي أو موقَّع ذاتياً.
  • شهادة العميل (mTLS) — اضبط لكل مضيف شهادة: زوج شهادة/مفتاح أو PFX، مع عبارة مرور اختيارية؛ يحدّد النطاقَ المضيفُ والمنفذ.

يمكن إضافة الشهادات أو حذفها بالمعرّف أو إفراغها كلياً. عبارات مرور الشهادات للكتابة فقط ولا تُرجَع.

الطرفية المدمجة​

يضم التطبيق لوحة طرفية في الأسفل.

  • terminal.open يعرض اللوحة؛ مع {"cwd":"document"} تُفتَح في مجلد المستند الحالي، الذي يحلّه المضيف إلى مسار مطلق حقيقي.
  • terminal.run يكتب وينفّذ أمر صدفة صريحاً بعد بطاقة تأكيد.

لا يُنفَّذ أمر إلا بطلبك الصريح؛ عرض اللوحة لا ينفّذ شيئاً.

إجراءات الملفات والصدفة​

  • shell.revealFile — يعرض المستند الحالي (أو مساراً) في مدير الملفات.
  • shell.openPath — يفتح ملفاً بالتطبيق الافتراضي.
  • shell.openExternal — يفتح صفحة خارجية في متصفح النظام.

تستخدم صفحات Powerduck الرسمية أداة رابط خاصة (app.officialLink) لعرض بطاقة في المحادثة دون مغادرة التطبيق.

أمثلة كود العميل​

لكل عملية، يمكن للمساعد توليد كود عميل قابل للتشغيل (clientcode.generate)، يُعرَض على بطاقة كود مع منتقى لغة ومكتبة: C وC# وGo وJava وJavaScript وNode وKotlin وPHP وPython وRuby وRust وshell وSwift وغيرها. يظهر الكود على بطاقة لا في المحادثة.

تغيير الإعدادات عبر المساعد​

تُعالَج الطلبات على مستوى التطبيق — تبديل المظهر/اللغة، إعداد وكيل، تجاهل أخطاء الشهادات، تغيير إصدار HTTP — بأدوات الإعدادات، لا كمسألة تصميم واجهة. تغييرات الإعدادات تطلب تأكيداً قبل التطبيق.

انظر أيضاً: الذكاء الاصطناعي والنماذج、مساحة الطلب.