أدلة DeepSeek Harness

يفشل التثبيت على إصدار Node قديم

الجواب أولاً: يحتاج DeepSeek Harness إلى Node.js ^22.19.0 أو >=24.0.0. أوقات التشغيل الأقدم تفشل مع npx وأحياناً بتحذير node-domexception.

1. تشغيل node -v وتأكد من النطاق.
2. ثبّت بناء 22.19+ أو 24+ من موزّع Node الذي تستخدمه.
3. افتح طرفية جديدة حتى يتحدّث PATH.
4. إعادة المحاولة npx @deepseek-ai/[email protected] web.

يصلح 0.1.2-rc.1 أيضاً الإقلاع وHMR على Node 24.0-24.11.1. تثبيت الإصدارات في صفحة التنزيل.

يفشل dsh web بـ EACCES على المنفذ 3080

الجواب أولاً: على Windows غالباً Hyper-V أو WSL2 أو Docker يحجز المنفذ، وليس خطأ صلاحيات ملف.

1. اقرأ نطاق المنافذ المحجوز على المضيف. إن وقع 3080 فيه فلا تستخدم chmod.
2. أوقف المستهلك (مبدّل Hyper-V أو WSL2 أو Docker) أو اختر منفذاً آخر بعلم dsh في ملاحظات إصدارك.
3. تأكد أن العنوان المطبوع ما يزال loopback. لا تربط الواجهة بواجهة عامة.
4. إن حُمّلت الصفحة وأعادت واجهات 403 فأنت خارج قائمة Host الموثوقة. ابقَ على 127.0.0.1.

إصلاح ACL لعازل Windows

الجواب أولاً: قد يقفل @deepseek-ai/dsh-sandbox-windows-acl المنشئ خارج TEMP تحت C:\Windows\Temp أو يفشل بـ SetNamedSecurityInfoW error 5 على مساحة يملكها BUILTIN\Administrators.

1. تحقق مما إذا كان TMP/TEMP على مستوى الجهاز C:\Windows\Temp وما إذا كان تجاوز المستخدم فارغاً.
2. اضبط HKCU TMP وTEMP على مجلد تملكه، مثلاً تحت ملفك الشخصي. أعد تشغيل الطرفية.
3. أنشئ مساحة يملكها مستخدمك لا Administrators. تجنّب جذور الأقراص مثل D:\.
4. أعد استدعاء pwsh داخل العازل. إن عمل danger-full-access فقط فالمشكلة ACL لا النموذج.

مسح مجلد Temp في Windows بعد منح قد يكسر workspace-write حتى تعيد سياسة temp. انظر سياسة sandbox and حدود العازل.

workspace-invalid-path مع أسماء مجلدات صينية

الجواب أولاً: منتقي مجلدات Win32 قد يقص مسارات فيها محارف مثل 开 أو 一 فيرى dsh ENOENT.

1. يتضمّن 0.1.2-rc.1 إصلاحاً لهذا القص. ثبّته إن كنت ما تزال على 0.1.1-rc.2.
2. إن تعذّرت الترقية فاختر مسار مساحة بأسماء ASCII.
3. لا تختر جذر قرص. يفشل session.create بـ EPERM وتبقى New Session فارغة.

ERR_MODULE_NOT_FOUND بعد pnpm install

الجواب أولاً: تثبيت الـ CLI المنشور بـ pnpm هو السبب الشائع لفشل مدخل ui-plan واختفاء @deepseek-ai/cordis-plugin-group.

1. استخدم npx أو npm للحزمة المنشورة.
2. استخدم pnpm فقط داخل نسخة المصدر بعد pnpm install and pnpm run build.
3. إن سحب plugin add أحدث 0.0.1-rc.1 بينما الـ CLI 0.1.1-rc.2 فثبّت إصدار الإضافة على قطار الـ CLI.

SEC_E_NO_CREDENTIALS داخل عازل Windows

الجواب أولاً: قد يكسر العازل HTTPS عبر Schannel (curl وPowerShell و.NET) بينما يعمل HTTP العادي وعملاء OpenSSL.

1. أعد الإنتاج خارج العازل. إن عمل HTTPS هناك فمخزن شهادات المضيف سليم.
2. فضّل عملاء لا يستخدمون Schannel داخل العازل أو نفّذ الجلب خارج workspace-write بعد موافقة صريحة.
3. لا تعتبر هذا دليلاً على تعطيل سياسة الملفات. الشبكة خارج SandboxMode.

الترقية تخفي عناوين الجلسات أو تمنع الإقلاع

الجواب أولاً: 0.1.2-alpha.5 و0.1.2-rc.1 يصلحان انحداراً عند الترقية من 0.1.1-rc.2 أو 0.1.2-alpha.3.

1. ثبّت 0.1.2-rc.1 إن احتجت خط 0.1.2.
2. إن وجب تصدير بيانات جلسة SQLite فافعل ذلك على بناء أقدم من 0.1.2-alpha.3. أُزيلت الخلفية ولم تُحذف الملفات.
3. أبقِ DSH_HOME قابلاً للتخلص أثناء اختبار الترقية.

تحذيرات مضاد الفيروسات

الجواب أولاً: dsh حزمة npm موقّعة تشغّل Node وقد تطلق صدفاً. الماسحات الاستدلالية تعلّم هذا النمط.

1. تأكد أنك شغّلت @deepseek-ai/dsh لا اسماً شبيهاً.
2. قارن shasum الأرشيف المثبّت بالقيم في ملاحظات SHA والتوقيع.
3. استعد Node أو المجلدات المؤقتة المحجورة فقط بعد ذلك الفحص.

أفضل ممارسات التشغيل الأول

1. ابدأ في مجلد فارغ قابل للتخلص لا مجلد المنزل أو monorepo عميل.
2. أبقِ workspace-write وask. لا تبدأ بـ danger-full-access.
3. ثبّت الإصدار. npx بلا تثبيت يتبع latest وما يزال 0.1.1-rc.2.
4. راجع الإضافات وخوادم MCP وSkills وHooks قبل التنفيذ.
5. أبقِ بيانات الاعتماد خارج المساحة إن كان قراءة عملية بنفس المستخدم غير مقبولة. عازل الملفات يقيّد الكتابة لا القراءة.

تنزيل DeepSeek Harness