dsh-chrome

تفتح لوحة إدارة في Chrome وتطلب من وكيل البرمجة فحص خطأ فيها، لكن الوكيل لا يرى التبويب الذي تراه؛ فتعود إلى نسخ النصوص والروابط وطلبات الشبكة يدويًا. dsh-chrome يصل DeepSeek Harness بمتصفح Chrome المفتوح لديك: يعرض واجهة DSH في لوحة جانبية، وينقل سياق الصفحة، ويتيح قراءة طلبات HTTP أو التنقل والنقر عندما تطلب ذلك. قيمته أنه يجعل فحص واجهة الويب جزءًا من المحادثة نفسها، مع بقاء ضرورة مراجعة ما يقرأه الوكيل وما يفعله.

🧭 ما dsh-chrome وكيف تعمل؟

هي إضافة من Stuart Hu مكوّنة من جزأين: حزمة host تُسجَّل في ملف تعريف DSH، وامتداد Chrome من نوع Manifest V3 تحمّله يدويًا. تصل الإضافة بـdsh web المحلي؛ لوحة Chrome الجانبية تضم واجهة DSH، بينما تضيف الحزمة أدوات قراءة الصفحة والتقاط الطلبات والتحكم في التبويب. ليست إضافة Chrome مستقلة عن DSH، وليست هي مشروع YJSoooooo/dsh-chrome المشابه بالاسم.

🎯 كيف ستفيدك؟

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

🌟 الميزات وطريقة استخدامها

1. لوحة جانبية وسياق الصفحة الحالية

أين تجدها؟ انقر أيقونة dsh-chrome في شريط Chrome؛ تظهر واجهة dsh web داخل اللوحة. عند تبديل تبويب HTTP(S) نشط أو الانتقال بين صفحاته، يُرسل الرابط والعنوان ونص الصفحة إلى آخر جلسة DSH نشطة. يشمل ذلك تنقل تطبيقات الصفحة الواحدة، لكنه لا يُحفَّز بالتمرير وحده. تستطيع أيضًا طلب قراءة الصفحة الحالية عند الحاجة؛ القراءة عند الطلب أصغر من الحقن التلقائي.

الفائدة: لا تحتاج إلى لصق عنوان الصفحة ونصها كلما انتقلت إلى شاشة جديدة. انتبه: النص المنقول قد يحتوي بيانات تظهر لك داخل جلسة مسجلة؛ راجع الصفحة قبل فتحها مع الوكيل. الحقن التلقائي لا يشمل صفحات chrome:// وfile://.

2. التقاط طلبات HTTP عند الطلب

قل للوكيل صراحةً «التقط طلبات الشبكة لهذا التبويب»، ثم أعد تنفيذ الخطوة التي تريد تشخيصها. تبدأ browser_start_capture الالتقاط للتبويب النشط؛ وتعيد browser_capture_requests الطلبات الجديدة: الطريقة والرابط والحالة ومحتوى الطلب والاستجابة، دون رؤوس HTTP. يعرض Chrome أثناء ذلك شريط التنبيه بأن المتصفح قيد التصحيح، ويمكنك إيقاف الالتقاط من اللوحة.

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

3. فتح الصفحات والنقر بقيد على نية المستخدم

توفّر الحزمة أدوات مثل browser_navigate وbrowser_click وbrowser_open_tab. اكتب طلبًا واضحًا في رسالتك الحالية، مثل «افتح صفحة الاختبار وانقر زر الحفظ». تتحقق الحزمة من كلمات تدل على نية تصفح في دور المستخدم الحالي قبل الفعل المغير لحالة المتصفح؛ وإذا لم تجدها ترفض الأداة وتخبرك بما يلزم. لا يعني ذلك طلب موافقة منفصلًا لكل نقرة.

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

🪜 مثال استخدام خطوة بخطوة

مثال توضيحي غير مُنفذ: لديك صفحة دفع تجريبية تُظهر «تعذر الحفظ». شغّل dsh web، افتح الصفحة بحساب اختبار، وافتح اللوحة الجانبية. اسأل الوكيل عمّا يظهر في الصفحة. اطلب صراحةً بدء التقاط الشبكة في التبويب، ثم اضغط الزر بنفسك أو اطلب من الوكيل النقر عليه بوضوح. اطلب منه قراءة طلبات HTTP وتحديد الحالة وجزء الاستجابة ذي الصلة، ثم أوقف الالتقاط. راجع النتيجة بنفسك قبل أن تطلب تعديل الكود. لا تدخل بطاقات حقيقية أو رموز إنتاج في هذا السيناريو.

⚖️ ماذا تضيف مقارنة بالطريقة اليدوية؟

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

🚀 التثبيت والبدء

المتطلبات الموثقة في إصدار 0.1.3: dsh web يعمل محليًا، Chrome 118 أو أحدث، وNode.js 18 أو أحدث بحسب package.json. يتكون التثبيت من خطوتين منفصلتين:

dsh plugin --profile web add dsh-chrome
npx dsh-chrome install

الأمر الأول يسجل ملحقات DSH في ملف تعريف web؛ والثاني ينسخ ملفات امتداد Chrome إلى مسار مستخدم ثابت ويطبعه. افتح chrome://extensions، فعّل Developer mode، اختر Load unpacked وحدد المسار المطبوع؛ ثم انقر أيقونة الإضافة لفتح اللوحة. إذا لم يكن اسم ملف تعريفك web فبدله في الأمر الأول. لم أنفذ التثبيت هنا. راجع الكود والصلاحيات قبل تشغيل npx أو تحميل امتداد غير معبأ.

بعد تحديث الحزمة، أعد npx dsh-chrome install ثم Reload للامتداد في chrome://extensions كي تتطابق نسختا host والامتداد. للتحقق الأولي، ينبغي أن تعرض اللوحة حالة اتصال DSH لا تحذيرًا بأنه متوقف. لإزالة الجزأين: npx dsh-chrome uninstall ثم أزل الامتداد من Chrome، ونفذ dsh plugin --profile web remove dsh-chrome.

⚙️ الإعدادات والتوافق

العنوان الافتراضي لـdsh web هو http://127.0.0.1:3080، ويمكن تغييره من إعدادات اللوحة. يدعم المشروع Chrome 118+؛ لا توثق المصادر دعم Firefox أو Safari. تعمل أدوات الصفحة على التبويب النشط، عدا قائمة التبويبات وفتح تبويب جديد. لصفحات Chrome المحمية مثل chrome:// قد يلزم تشغيل المتصفح بمنفذ remote debugging 9222؛ لا تحتاج صفحات HTTP(S) العادية إلى ذلك. تشغيل منفذ التصحيح يزيد سطح الوصول، فلا تفعله لمجرد تثبيت الإضافة.

💰 التكلفة والنشاط

ترخيص الكود MIT. الحزمة نفسها لا توثق اشتراكًا أو API مدفوعًا؛ قد تترتب تكلفة منفصلة على نموذج الذكاء الذي تشغله في DSH. الاتصال بين الامتداد وdsh web محلي وفق README، لكن هذا لا يعني أن النموذج المستخدم يعمل محليًا أو أن بيانات الصفحة لا تغادر جهازك عبر إعدادات DSH. عند فحص المستودع بتاريخ 24 سبتمبر 2026 كان package.json وامتداد Chrome على 0.1.3، ويعرض GitHub 9 نجوم و4 تفرعات؛ هذه مؤشرات شعبية لا تقييمات أمان. يسجل CHANGELOG إصلاحات أمنية مهمة في 0.1.3، ولا تعرض صفحة Releases إصدارًا منشورًا؛ لم أتحقق من تاريخ آخر commit أو تنزيلات npm.

🔐 الخصوصية والصلاحيات والقيود

يطلب Manifest V3 صلاحيات sidePanel وscripting وtabs وactiveTab وstorage وdebugger وwebNavigation، مع وصول مضيف <all_urls>. هذه صلاحيات واسعة تناسب أداة تتحكم بمتصفحك، لكنها لا تناسب متصفحًا مليئًا بحسابات أو بيانات لا تريد كشفها للوكيل. إن احتجتها، استخدم ملف Chrome منفصلًا وحسابات اختبار كلما أمكن.

لا تُلتقط رؤوس Cookie وAuthorization بحسب README، وتُحجب القيم الشبيهة بالأسرار في الرابط والمحتوى افتراضيًا؛ لكن الحجب يعتمد أنماط أسماء مألوفة ويمكن أن يفوّت سرًا باسم غير معتاد أو في مسار URL. شهد إصدار سابق خللًا جعل محتوى الالتقاط يصل بلا تنقيح، ويذكر CHANGELOG إصلاحه في 0.1.3؛ لذلك لا تستخدم نسخة أقدم لهذا الغرض. الالتقاط يحتفظ بآخر 500 مدخلة؛ كل محتوى طلب/استجابة والصفحة المحقونة محدود بمليون حرف، والقراءة عند الطلب نحو 40 ألف حرف و400 رابط. رأس اللوحة الخاص بالإضافة بالصينية حاليًا، وإن كانت واجهة DSH المضمنة تتبع لغة DSH.

📚 المصادر وتاريخ التحقق

تحققت في 24 سبتمبر 2026 من README والمستودع الأصلي، package.json، Manifest الصلاحيات، سجل تغييرات 0.1.3، الترخيص وصفحة الإصدارات. الصور رسوم أصلية مبنية على هذه الوثائق؛ لم أختبر الأداة على متصفح فعلي.