العمل على دراغي

البناء والبنية

التشغيل من المصدر، وتنظيم الشيفرة، والحدّان.

التشغيل من المصدر

npm install
npm run electron:dev

Vite وElectron معًا مع إعادة تحميل حيّة، على المنفذ 5173. وعملية Vite متبقّية تحتجز ذلك المنفذ فيفشل التشغيل التالي: أنهِها أولًا.

npm run check

فحص الأنواع والتدقيق ونحو 1,900 اختبار في ثوانٍ. وCI ينفّذ الأمر نفسه. و npm run electron:build يكتب مثبِّتًا في dist-electron/.

كيف نُظِّمت الشيفرة

المجلد	ما فيه
`electron/`	العملية الرئيسة: النوافذ وIPC وSQLite وحارس الملفات وgit والمتصفح وخوادم MCP والتحديثات
`src/agent/`	حلقة استدعاء الأدوات المتدفّقة، والأذونات، والضغط
`src/chat/`	قائمة الرسائل والفروق والموافقات وحلقة السياق
`src/tools/`	تعريفات الأدوات والسجل الذي تعيش فيه
`src/voice/`	الالتقاط والكشف وتبادل الأدوار والنطق

الحدّان

electron/preload.cjs هو حدّ الأمان. لا وصول للعارض إلى Node، ولا يصل إلى نظام الملفات والشبكة وقاعدة البيانات إلا عبر ما يُكشف هناك. وإضافة دالة إليه فعل مقصود.

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

الأعراف

التعليقات تشرح «لماذا» لا «ماذا»، وسطران على الأكثر
اللغات الاثنتا عشرة تبقى متوازية، ويحرس ذلك اختبار
كل عملية فرعية تمرّ عبر مساعدات التشغيل بلا نافذة
رسائل الإيداع سطر واحد

البقية في CONTRIBUTING.md، والإبلاغ عن ثغرة في SECURITY.md.