SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor · آخر تحديث في 2026-11-06

كيفية إعداد dsh: مفاتيح API والنماذج والمسارات

تعرف على مسار ملفات إعدادات dsh في لينكس وكيفية ربط مفتاح DeepSeek API أو خادم Ollama المحلي. اكتشف مكان تخزين الأسرار والبيانات التي يتم إرسالها خارج جهازك في كل وضع.

موضع احتفاظ dsh بإعداده

يحتفظ dsh (DeepSeek Harness) ببيانات الـharness ضمن $DSH_HOME، التي تكون قيمتها الافتراضية ~/.dsh، ويقرأ إعدادات الوكلاء المشتركة من جذر منفصل هو $DSH_AGENTS_HOME، الذي تكون قيمته الافتراضية ~/.agents. يُكتب كل ما تضبطه في Web UI هناك على هيئة ملفات نصية عادية. عند نقل إعداداتك إلى خادم آخر، انسخ home الخاص بالـharness وأي تعليمات ومهارات عامة من جذر الوكلاء المشترك.

تحمل أربعة مسارات الإعدادات الرئيسية للـharness والأسرار وسجلات الجلسات.

  • يحتوي ~/.dsh/profiles/<profile>/cordis.patch.yml على الإعدادات التي تكتبها Web UI لذلك الملف التعريفي، بما في ذلك مسارات المزوّد والنموذج. يشغّل dsh web الملف التعريفي web، ولذلك يكون الملف هو ~/.dsh/profiles/web/cordis.patch.yml.
  • يحتوي ~/.dsh/.credentials.yaml على الأسرار. لا تحتفظ الإعدادات إلا بمرجع إلى بيانات اعتماد، ولذلك تكون قيمة المفتاح نفسها في ملف واحد.
  • يحتوي ~/.dsh/profiles/ على الملفات التعريفية المسماة، ويحتوي ~/.dsh/sessions/ على سجلات الجلسات المحفوظة.
  • يمثّل ~/.dsh/cordis.patch.yml طبقة التصحيحات الخاصة بك. تُطبَّق هذه الطبقة فوق الإعداد المضمّن لكل ملف تعريفي، وتكون لها أولوية على ملف الملف التعريفي. لذلك يُرفض تعديل Web UI الذي ستتجاوزه هذه الطبقة بدلاً من حفظه.

يبقى جذر الوكلاء المشترك خارج $DSH_HOME لأن أدوات وكلاء أخرى تستخدمه. يقرأ dsh التعليمات العامة للمستخدم من ~/.agents/AGENTS.md، ويفحص ~/.agents/skills/ بحثاً عن المهارات؛ اضبط DSH_AGENTS_HOME لنقل هذا الجذر.

كانت الإصدارات الأقدم تحتفظ بهذه الإعدادات في ~/.dsh/settings.yaml. أما الإصدارات الحالية فتستورد هذا الملف مرة واحدة إلى الملف التعريفي النشط وتعيد تسميته إلى settings.yaml.imported، ولذلك فإن الدليل الأقدم الذي يطلب منك تعديل settings.yaml يشير الآن إلى ملف لم يعد dsh يقرأه.

تنشر DeepSeek الـharness كإصدار معاينة للمطورين بترخيص MIT، ويذكر README أنه ستحدث تغييرات قد تكسر التوافق. تتطابق أسماء الحقول والمسارات في هذا الدليل مع وثائق المستودع الحالية، التي جرى التحقق منها في 5 نوفمبر 2026. قارنها بوثائق الإصدار الذي ثبّتَّه قبل نسخ الإعدادات من أي دليل، بما في ذلك هذا الدليل، لأن إصدار المعاينة قد يعيد تسمية العناصر بين الإصدارات.

الحد الأدنى الصريح للوصول إلى أول مخرَج

يحتاج dsh إلى Node.js 24.9 أو أحدث. في 5 November 2026، يحدّد ملف package.json الخاص به >=24.9.0، لذلك فإن سلسلة الإصدارات 22 غير مدعومة. كما أن Node 24.0 إلى 24.8 غير كافٍ. تحقّق من الإصدار أولاً، لأن عدم تطابق الإصدار يفشل عند بدء التشغيل، وتبدو رسالة الخطأ كأنها تشير إلى حزمة تالفة.

node -v
npx @deepseek-ai/dsh web

ينزّل npx الحزمة من سجل npm ويبدأ Web UI على http://127.0.0.1:3080. ويربط عنوان loopback، ما يعني أن المنفذ لا يمكن الوصول إليه من جهاز آخر حتى عندما يسمح جدارك الناري بذلك. على VPS، مرّر الاتصال عبر SSH بدلاً من فتح المنفذ 3080 للإنترنت. إذا كان عنوان URL المطبوع هو الجزء المربك، يشرح سبب بدء dsh على ذلك العنوان ما الذي يحميه ربط loopback وما لا يحميه.

ssh -N -L 3080:127.0.0.1:3080 you@your-server

افتح http://127.0.0.1:3080 على حاسوبك المحمول، ثم انتقل إلى Settings وModels. تحتوي بطاقة DeepSeek على حقل واحد لمفتاح API. الصق المفتاح من platform.deepseek.com واحفظه. يصبح مسار النموذج قابلاً للاستخدام فوراً، من دون إعادة تشغيل، لأن الخادم قيد التشغيل يخزّن بيانات الاعتماد ويحل المرجع مباشرة. يشرح الوصول إلى Web UI الخاص بـdsh على خادم بعيد حالة النفق وReverse Proxy، بينما يشرح تثبيت DeepSeek Harness على VPS إعداد الخادم الذي يفترضه هذا الدليل.

بعد الحفظ، افحص ما أنشأه التطبيق.

ls -la ~/.dsh
stat -c '%a %n' ~/.dsh/.credentials.yaml

من المفترض أن ترى .credentials.yaml وprofiles/، مع وجود إعدادات Web UI في profiles/web/cordis.patch.yml. وقد يحتوي الدليل الرئيسي الذي أنشأه إصدار أقدم أيضاً على settings.yaml.imported. إذا طبع stat وضعاً غير 600، فنفّذ chmod 600 ~/.dsh/.credentials.yaml. يتيح ملف بيانات اعتماد قابل للقراءة من المجموعة الوصول إلى مفتاحك للحسابات الموجودة في تلك المجموعة، بينما يتيح الملف القابل للقراءة عالمياً الوصول إليه لكل حساب آخر على الخادم.

لأول تشغيل من دون متصفح، يكفي أمر واحد.

npx @deepseek-ai/dsh --profile headless "summarise the files in this directory"

يشغّل ملف التعريف headless جلسة واحدة ويطبع الإجابة النهائية.

متغيرات البيئة أو ملف الإعداد

يمكن لـdsh حل مفتاح من بيانات الاعتماد المحفوظة أو من القيم البديلة في البيئة.

يقبل موفّر الكتالوج (DeepSeek وAnthropic وOpenAI وبقية القائمة المضمّنة) المفتاح عبر صفحة Models، أو يستخدم القيمة البديلة المدعومة في البيئة عندما لا توفّر بيانات الاعتماد المحفوظة مفتاحاً. تُوضع القيمة في ~/.dsh/.credentials.yaml، ولا تتضمن إعداداتك سوى مرجع إليها. لا تعرض Web UI المفتاح مرة أخرى بعد حفظه.

يمكن لموفّر مخصص تسمية مرجع بيانات اعتماد باستخدام apiKeyEnv، وهو يدعم أيضاً القيم البديلة في البيئة. هذا هو الشكل الذي توضحه الوثائق لإدخال في تصحيح ملف تعريف مثل ~/.dsh/profiles/web/cordis.patch.yml.

- id: llm-pi-ai
  config:
    providers:
      my-gateway:
        apiKeyEnv: GATEWAY_API_KEY
        api: openai-completions
        baseURL: https://gateway.example/v1
        models:
          - id: legacy-chat
          - id: vision-preview
            input: [text, image]

أضف موفّراً واحداً أولاً عبر Web UI، ثم افتح cordis.patch.yml الخاص بملف التعريف وانسخ البنية التي كتبها. أثناء المعاينة المخصصة للمطورين، يكون التداخل هو الجزء الأكثر عرضة للتغيير، ويكون الملف الذي كتبته application للتو محدثاً دائماً.

يُحل apiKeyEnv عبر مخزن بيانات الاعتماد: تكون الأولوية للملف المحفوظ، ثم لبيئة التشغيل، ثم .env في الدليل الذي استُدعيت منه العملية، ثم $DSH_HOME/.env. لا يكون المفتاح الذي صُدّر في جلسة تفاعلية فقط مرئياً لوحدة systemd، ولذلك يعيد الإعداد نفسه الذي يعمل عند كتابة dsh web يدوياً القيمة MISSING_CREDENTIAL عند تشغيله كخدمة، ما لم يوجد مصدر آخر لبيانات الاعتماد. امنح الوحدة ملفها الخاص.

[Service]
EnvironmentFile=/etc/dsh/dsh.env

احتفظ بهذا الملف بالوضع 600، واجعله مملوكاً للمستخدم الذي تعمل الخدمة باسمه.

اختيار النماذج والمعرّف الذي لا يمكنك إعادة تسميته

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

معرّف الموفّر دائم. تشير إليه الطلبات والجلسات المحفوظة والإعدادات الافتراضية للنماذج ومراجع بيانات الاعتماد، لذلك لا يوجد زر لإعادة تسميته. يتطلب تغييره إنشاء موفّر جديد وحذف الموفّر القديم. اختر اسماً يمكنك استخدامه على المدى الطويل: local-ollama بدلاً من test2.

تكون النماذج المخصصة التي لا ترث إمكانية التعامل مع الصور مخصّصة للنص فقط، ما لم تعلن خلاف ذلك. أضف input: [text, image] إلى إدخال النموذج للإعلان عن دعم الصور، أو عيّن defaultInput على مستوى route كقيمة احتياطية للنماذج التي لا يصفها الكتالوج. في route الخاص بـDeepSeek، يُعدّ النموذج الذي لا يعلن عن modalities مخصّصاً للنص فقط، لذلك اختر إدخالاً من الكتالوج يدعم الصور (deepseek-flash افتراضياً) قبل إرفاق صورة. ويُرفض إرسال صورة إلى نموذج لا يعلن دعم الصور قبل إرسال أي شيء.

وجّه dsh إلى نقطة نهاية محلية لإبقاء التعليمات البرمجية على الخادم

يوفّر Ollama واجهة API متوافقة مع OpenAI على http://127.0.0.1:11434/v1. يتصل dsh بأي عنوان أساسي متوافق مع OpenAI عبر موفّر مخصّص، لذلك يتصل البرنامجان مباشرةً من دون طبقة وسيطة. أعدّ خادم النموذج أولاً: يشرح استضافة LLM ذاتياً باستخدام Ollama على VPS خطوات التثبيت وسحب النموذج.

تحقق من استجابة نقطة النهاية قبل تعديل dsh.

ollama list
curl -s http://127.0.0.1:11434/v1/models

يطبع ollama list الوسم الدقيق لكل نموذج سحبته. انسخ هذه السلسلة. يعرض curl النماذج نفسها بتنسيق JSON. تعني القائمة الفارغة أن Ollama قيد التشغيل من دون نماذج مسحوبة. يعني Connection refused أن Ollama لا يعمل أو لا يستمع على 11434.

اختر نموذجاً يعمل على هذا الجهاز. يوفّر خادم Ollama الذي سجّلت الدخول إليه نماذج سحابية أيضاً عبر العنوان المحلي نفسه. يعمل وسم سحابي مثل gemma4:cloud على خوادم Ollama، لذلك تغادر تعليماتك الجهاز، رغم أن dsh لا يتصل إلا بـ127.0.0.1.

أضف الموفّر الآن إلى تصحيح ملف التعريف. أدخل قيمة غير فارغة لمفتاح API في هذا الإعداد؛ إذ يتجاهلها خادم Ollama المحلي.

- id: llm-pi-ai
  config:
    providers:
      local-ollama:
        apiKeyEnv: OLLAMA_API_KEY
        api: openai-completions
        baseURL: http://127.0.0.1:11434/v1
        models:
          - id: <the exact tag printed by ollama list>

صدّر المتغير بحيث تتمكن عملية dsh من رؤيته.

sudo install -d -m 700 /etc/dsh
printf 'OLLAMA_API_KEY=ollama\n' | sudo tee /etc/dsh/dsh.env
sudo chmod 600 /etc/dsh/dsh.env

تغطي ثلاثة أخطاء معظم محاولات الإعداد هذه. يعني MISSING_CREDENTIAL أن المرجع الذي يحدده apiKeyEnv لم يُحل إلى أي قيمة، لذلك افحص بيانات الاعتماد المحفوظة وبيئة التشغيل، وليس الطرفية فقط. يعني UNKNOWN_MODEL أن id لا يطابق أي نموذج مُعدّ، لذلك قارنه مع ollama list حرفاً بحرف، بما في ذلك الوسم الذي يلي النقطتين. ينتج الخطأ 401 عند جلب النماذج المتاحة من اكتشاف النماذج، الذي يستدعي GET /models على عنوانك الأساسي. تحتاج نقاط النهاية التي لا توفّر هذا المسار إلى إدخال نماذجها يدوياً.

هناك مشكلة أخرى في العنوان الأساسي. لا تحذف /v1 منه؛ وإلا ستصل الطلبات إلى مسارات لا يوفّرها Ollama، فتُرجع الاستدعاءات الخطأ 404 ولا يعمل النموذج. هذه اللاحقة جزء من الواجهة المتوافقة مع OpenAI وليست مجرد نص إضافي.

إذا كان Ollama يعمل على جهاز آخر، يصبح عنوان ذلك الجهاز هو العنوان الأساسي، ثم تعبر تعليماتك الشبكة بنص واضح عبر HTTP العادي. أبقه على المضيف نفسه، أو ضعه خلف TLS (أمان طبقة النقل) مع المصادقة: تأمين نقطة نهاية Ollama المكشوفة.

ما الذي يغادر الجهاز في كل وضع

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

تُرفق الإصدارات الحالية أيضاً لاحقة غير مرفوعة من سجل أحداث الجلسة بالطلبات عبر محوّل DeepSeek الأصلي، بما في ذلك البوابات المهيّأة، بشكل افتراضي، في حقل منفصل هو dsh_session_log. لا يرى النموذج هذه البيانات، لكن وجهة الطلب تستلمها. عطّل ذلك من Settings، General ("Upload Session Log when using the official model API")، أو اضبط enabled: false في الإضافة session-log-deepseek. لا تتحكم مفاتيح القياس عن بُعد أدناه في هذا الرفع.

ترسل الملفات التعريفية المضمّنة أيضاً أسماء حزم الإضافات النشطة وإصداراتها عبر محوّل DeepSeek الأصلي في حقل منفصل هو dsh_plugin_packages. اضبط enabled: false على plugin-package-inventory-deepseek لإيقاف هذه المساهمة.

عند استخدام موفّر آخر من الكتالوج أو بوابة شركة، تُرسل البيانات نفسها إلى ذلك المورّد بدلاً من ذلك. يحدد عنوان URL الأساسي الوجهة بدقة.

عند استخدام نقطة نهاية محلية، يُرسل طلب النموذج إلى 127.0.0.1:11434، لكن عنوان loopback وحده لا يبقيه داخل الجهاز. توضح وثائق Ollama ما يلي: "To use cloud models through this server, sign in to Ollama," ولذلك فإن اختيار نموذج سحابي عبر الخادم المحلي نفسه يرسل مطالباتك وشيفرتك إلى سحابة Ollama. لا يبقى طلب النموذج على الجهاز إلا عندما يعمل النموذج نفسه محلياً. ومع ذلك، تعبر الشبكة ثلاثة أشياء. ينزّل npx الحزمة من سجل npm. ويمكن لأي أداة يشغّلها الوكيل الوصول إلى الإنترنت بنفسها، بما في ذلك خوادم MCP (بروتوكول سياق النموذج) التي وصلتها؛ ويشرح تشغيل خوادم MCP على VPS ذلك بالتفصيل. تنتمي الإضافة إلى الفئة نفسها، لأن تثبيتها يشغّل شيفرة مؤلف آخر بصلاحيات وكيلك، ولذلك يجدر التحقق مما يمكن للإضافة الوصول إليه قبل تثبيتها. وينطبق الأمر نفسه على القياس عن بُعد، الذي تسمح الإصدارات الحالية بتصديره إلى DeepSeek عند إرسال ملاحظات، سواء استخدمت نموذجاً محلياً أو مستضافاً.

يقتصر القياس عن بُعد على الملاحظات بشكل افتراضي. يحدد DSH_TELEMETRY_MODE الوضع، وفي الإعداد الأساسي المضمّن حالياً تؤدي القيمة غير المعيّنة أو الفارغة إلى FEEDBACK_ONLY. في هذا الوضع، لا يصرّح النشاط العادي بالتقاط أي بيانات للقياس عن بُعد. عند إرسال ملاحظات مكتوبة، أو إنشاء تقييم أو تعديله، أو تعديل ملاحظة، أو سحب ملاحظات، يصرّح dsh بتصدير بادئة سجل الجلسة التي لم يسلّمها المصدّر بعد، عبر حدث الملاحظات ومع تضمين السياق الموروث، إلى https://dsh-otel-collector.deepseeksvc.com/v1/logs. لا يوجد ضمان لوصول البيانات كاملة: يُرفض الحدث الكبير جداً من دون اقتطاع، وقد تبقى البادئات الكبيرة غير مرسلة جزئياً عند خروج CLI. ويمكن للدفعات المصرّح بها مواصلة الإرسال من دون تفاعل آخر أو استدعاء جديد للنموذج. يذكر ملف README الخاص بالقياس عن بُعد أن هذا ينطبق "for all users and providers"، لذا لا يؤدي تشغيل النموذج محلياً إلى تعطيله. لا ينشئ DISABLED أي وسيلة نقل لـOpenTelemetry (OTel). لم يعد FULL مقبولاً: تُرفض أي قيمة غير هاتين القيمتين مع unsupported mode. وقد يحمل تصدير الملاحظات نص الرسائل، ووسائط الأدوات ونتائجها، ومسارات مساحة العمل؛ لذلك تعامل مع الملاحظات على أنها تصريح بإرسال بادئة الجلسة إلى DeepSeek.

لإيقاف حازم لا يعتمد على ضبط سلسلة الوضع بشكل صحيح، اضبط DSH_TELEMETRY_DISABLED=1. تُعد أي قيمة غير فارغة إلغاء اشتراك ملزماً، بما في ذلك 0 وfalse، وتُقرأ قبل بدء التشغيل، لذلك لا يمكن لشيفرة المشروع إعادة تفعيله أثناء الجلسة. عنوان المجمّع الافتراضي هو dsh-otel-collector.deepseeksvc.com؛ ويتجاوزه DSH_TELEMETRY_OTLP_URL.

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

sudo ss -tnp | grep -i node

عند تشغيل نموذج محلي، تستخدم حركة النموذج منفذ loopback رقم 11434، لكن الاتصالات العامة قد تأتي أيضاً من الأدوات من دون إرسال أي ملاحظات. تتضمن الملفات التعريفية المضمّنة البحث على الويب والجلب، ولا يقيّد إعداد الصلاحيات الافتراضي الوصول إلى الشبكة. حدّد كل وجهة عامة قبل نسبتها إلى القياس عن بُعد؛ فالاعتماد على التوقيت وحده لا يثبت أن الاتصال هو تصدير الملاحظات. وقد تفوّت هذه اللقطة أيضاً الاتصالات القصيرة. يغطي هذا الفحص عملية dsh فقط: تخرج حركة النموذج السحابي من خادم Ollama، لذا تحقّق أيضاً من أن id ليس وسم سحابة. وينبغي تحديد أي شيء آخر قبل المتابعة. يجري ما يرسله وكيل البرمجة إلى الجهة المشغّلة الفحص نفسه مع أدوات تشغيل أخرى، ويشرح كيفية قراءة النتيجة.

أين يجب ألا تضع الأسرار

  • سجل أوامر الصدفة (Shell history). يُكتب export DEEPSEEK_API_KEY=sk-... بصيغة نص صريح في ~/.bash_history، ويبقى هناك لفترة طويلة بعد تغيير المفتاح. ابدأ الأمر بمسافة عند ضبط HISTCONTROL=ignorespace، أو تجنّب الصدفة واكتب القيمة مباشرة في ملف بصلاحية 600.
  • ملفات الإعداد (dotfiles) المرفوعة. أي مفتاح في ~/.bashrc أو ~/.zshrc يصبح على بعد git add واحد من مستودع عام إذا كنت تحفظ ملفات الإعداد في git. نفّذ git grep -I -n 'sk-' في ذلك المستودع قبل إجراء الـ push.
  • ملفات تصحيح الإعدادات (Profile patch files). استخدم apiKeyEnv للمزودات المخصصة بحيث يحتوي cordis.patch.yml على اسم متغير بدلاً من السر. تُنسخ ملفات الإعداد في تقارير المشكلات ومحادثات الدعم، بينما لا تُنسخ ملفات الاعتمادات.
  • مخرجات env ولقطات شاشة الطرفية. أي أمر يطبع البيئة بالكامل سيطبع المفتاح معها.
  • النسخ الاحتياطية. يستحق ~/.dsh النسخ الاحتياطي، لكن .credentials.yaml الموجود بداخله هو سر نشط. استثنِ ذلك الملف، أو قم بتشفير الأرشيف.

هذه القواعد لا تقتصر على dsh، ويغطي الرابط إبقاء الأسرار خارج ملفات env في Compose المشكلة نفسها على جانب الحاويات في الخادم ذاته.

التعامل مع إصدارات المعاينة للمطورين

ثبّت إصدار البرنامج الذي اختبرته، لأن إصدار المعاينة قد يغير مفتاح إعداد في تحديث فرعي، مما يؤدي إلى فشل مزود الخدمة في التحميل. إذا رفض التثبيت المثبّت البدء، أو استمر npx في تقديم إصدار لم تطلبه، فإن أخطاء التثبيت والإصدار التي تنتجها المعاينة تغطي ذاكرة التخزين المؤقت لـ npx وإصدار npm المرفق مع Node. احتفظ بملف cordis.patch.yml الرئيسي وملفات التصحيح الموجودة تحت profiles/ ضمن نظام التحكم في الإصدارات، مع استبعاد ملف بيانات الاعتماد، لتتمكن من رؤية ما تغير بعد الترقية.

يساعد استخدام رايتين (flags) عند عدم عمل الملف الشخصي (profile) كما هو متوقع. يطبع --dump-default-config الإعدادات الافتراضية المجمعة دون تشغيل البرنامج، ويطبع --dump-config الإعدادات المجمعة لملفك الشخصي بالطريقة نفسها. تتيح لك مقارنة الاثنين معرفة ما غيرته طبقة التصحيح الخاصة بك فعلياً، وهو أسرع من قراءة الطبقات يدوياً.

dsh --profile web --dump-config

عندما يتعطل شيء ما بعد الترقية، نفذ ذلك أولاً. سيظهر المفتاح الذي نُقل بين الإصدارات كفرع مفقود في ملف التفريغ (dump)، ويكون الإصلاح عبارة عن تعديل سطر واحد بدلاً من إعادة التثبيت.

FAQ

أين يخزّن dsh مفتاح DeepSeek API؟

في $DSH_HOME/.credentials.yaml، وهو ~/.dsh/.credentials.yaml ما لم تضبط DSH_HOME بنفسك. تكتب صفحة Models المفتاح هناك، ولا تحتوي إعداداتك إلا على مرجع إليه، لذلك يبقى السر في ملف واحد. تحقق من الوضع باستخدام stat -c '%a %n' ~/.dsh/.credentials.yaml واضبطه على 600 إذا كان أكثر انفتاحاً من ذلك. يمكن لمزوّد مخصص تجنّب الملف بالكامل عبر تسمية متغير بيئة باستخدام apiKeyEnv.

كيف أجعل dsh يستخدم نموذجاً محلياً بدلاً من DeepSeek API؟

أضف مزوّداً مخصصاً يكون عنوانه الأساسي هو نقطة النهاية المحلية المتوافقة مع OpenAI. بالنسبة إلى Ollama، يكون ذلك http://127.0.0.1:11434/v1، مع api: openai-completions ونموذج id منسوخاً تماماً من ollama list. أدخل قيمة غير فارغة لمفتاح API في هذا الإعداد؛ إذ يتجاهلها خادم Ollama المحلي. تأكد من أن نقطة النهاية تستجيب باستخدام curl -s http://127.0.0.1:11434/v1/models قبل تعديل أي إعدادات لـdsh، لأن نقطة النهاية المتوقفة والإعداد الخاطئ ينتجان أخطاء متشابهة.

هل يرسل dsh شيفرتي إلى أي مكان افتراضياً؟

نعم، عند استخدام نموذج مستضاف. يكون طلبك ومحتوى الملفات التي قرأها الوكيل ضمن طلب API المرسل إلى ذلك المزوّد. كما تحمل الطلبات المرسلة عبر محوّل DeepSeek الأصلي، بما فيها الطلبات التي تمر عبر بوابات مهيّأة، لاحقة سجل الجلسة افتراضياً إلى أن تعطل رفعها من Settings, General. عند استخدام نموذج يشغّله Ollama محلياً، يُرسل الطلب إلى loopback ويبقى على الجهاز. لكن نموذجاً سحابياً مثل gemma4:cloud يمرّره إلى سحابة Ollama عبر عنوان loopback نفسه. يمكن للبحث والـfetch المدمجين على الويب، والأدوات الأخرى، والإضافات الاتصال بالخدمات العامة بشكل مستقل عن الملاحظات. القياس عن بُعد قناة منفصلة: في الإصدارات الحالية، يحل DSH_TELEMETRY_MODE إلى FEEDBACK_ONLY عند عدم ضبطه، لذلك تسمح الملاحظات بتصدير بادئة سجل الجلسة عبر ذلك الحدث، بما في ذلك السياق الموروث، لكل مزوّد، بما في ذلك النماذج المحلية. لا يُضمن التسليم، ويمكن أن تستمر عمليات الرفع المصرّح بها بعد التفاعل مع الملاحظات. اضبطه على DISABLED لمنع أي مُصدّر، أو اضبط DSH_TELEMETRY_DISABLED=1 لتمكين إلغاء الاشتراك الذي يُقرأ قبل بدء التشغيل.

لماذا يعرض dsh الخطأ MISSING_CREDENTIAL رغم ضبط المتغير؟

لأن المرجع الذي يحدده apiKeyEnv يجب أن يُحلّ من مصادر بيانات الاعتماد في dsh. تُعطى الأولوية لبيانات الاعتماد المحفوظة، ثم لبيئتي .env و$DSH_HOME/.env في الدليل الذي استُخدم للتشغيل. لا يصل المتغير المُصدَّر في shell إلى خدمة systemd، أو جلسة مستخدم آخر، أو عملية بدأت قبل تصديره. ضع القيمة في EnvironmentFile مع ضبط الوضع على 600 للوحدة، أو صدّرها في shell نفسه الذي يبدأ dsh. تحقق مما تحتفظ به العملية قيد التشغيل فعلياً باستخدام sudo tr '\0' '\n' < /proc/$(pgrep -f dsh | head -1)/environ.

ما إصدار Node.js الذي يحتاج إليه dsh؟

يحتاج إلى Node.js 24.9 أو أحدث، وفقاً لملف package.json في المستودع بتاريخ 5 November 2026. لم يعد خط الإصدار 22 مدعوماً، كما أن Node 24.0 إلى 24.8 غير كافٍ. شغّل node -v قبل أي شيء آخر، لأن فشل بدء التشغيل الناتج عن بيئة تشغيل غير مدعومة يبدو كأنه تثبيت معطّل، ويدفع المستخدمين إلى إعادة تثبيت الحزمة بدلاً من بيئة التشغيل.

هل كان هذا المقال مفيدًا؟