عن المشروع

# Design-Agent — مساحة عمل وكيل التصميم DSH هذه حزمة كاملة قابلة لإعادة الإنتاج لوكيل تصميم مبنية على [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness)، وتتضمن إعداد `my-agent`، ومهارة توجيه `design-references` (نسخة مكيفة لـ DSH)، ومكوّن أدوات حتمي `design-router`. تم بناء هذا المشروع من خلال ترقية وكيل تصميم قائم على HTML واعتماد منهجية [design-references](https://github.com/haohaiHuang/my-pi-skills/tree/main/skills/design-references). > ⚠️ **تعيد هذه الحزمة إنتاج الآلية، وليس المحتوى.** التوجيه والانضباط والأدوات مكتفية ذاتيًا بالكامل (استنساخ ← `cp -RL` ← تشغيل). لكن *المكتبة المرجعية* شخصية — تشير عدة موارد رئيسية إلى `~/Desktop/Design/...` و`~/resources/design-references.md`، وهذه الأصول الخاصة غير مرفقة مع المستودع. على جهاز جديد، ستتحول هذه إلى سلسلة احتياطية (`web_search` + `dembrandt` + انضباط العلامة المميزة المدمج). لاستكمال مجموعة مراجعك الشخصية، انسخ هذه الدلائل بنفسك؛ بدونها، لا تزال هذه الحزمة تعمل كوكيل تصميم "انضباط العلامة المميزة + بحث ويب". ## المحتويات | المكوّن | الدور | | --- | --- | | [`plugins/design-router/`](plugins/design-router/) | مكوّن Cordis للأدوات الحتمية (6 أدوات للقراءة فقط + كاتب سجلات محلي واحد، بدون تبعيات تشغيل خارجية) | | [`presets/my-agent/`](presets/my-agent/) | إعداد وكيل DSH (`agent.cordis.yml` + `preset.yml`): دور توجيه ثلاثي المستويات (مرحلة ← فرع ← مرحلة) مع بوابات تأكيد لكل مرحلة | | [`skills/design-references/`](skills/design-references/) | مهارة توجيه المراحل/الفروع (تقسيم المرحلة ← منتج أ / محتوى ب / عام ج ← خمس مراحل)، نسخة مكيفة لـ DSH | | [`skills/hallmark/`](skills/hallmark/) | مهارة تنفيذ مكافحة محتوى الذكاء الاصطناعي الرديء (نسخة MIT من [nutlope/hallmark](https://github.com/nutlope/hallmark)؛ رموز وأمثلة `site/` مدمجة في المهارة، مكتفية ذاتيًا) | > **متطلب إصدار DSH: `0.1.5-rc.1` أو أحدث.** تغيّر نمط مكوّن الدور في 0.1.5 (`text` ← `prefix` + `suffix`)؛ الإعدادات التي لا تزال تستخدم `text:` ستفشل في التحميل بسبب `$.prefix missing required value`. إعدادات هذا المستودع مبنية على نمط 0.1.5 وتستخدم سطرين تم تقديمهما في 0.1.5: `present` (`dsh-tool-present`، بيان التسليم) و`command-goal` (أمر `/goal`). ## plugins/design-router — الأدوات الحتمية منقولة من `extensions/design-router` في [my-pi-skills](https://github.com/haohaiHuang/my-pi-skills) (امتداد pi ← مكوّن Cordis لـ DSH). يتم تحميلها بواسطة إعداد `my-agent` عبر سطر **مسار نسبي** في `agent.cordis.yml` (مجلد `plugins/` في الإعداد هو رابط رمزي نسبي لمجلد `plugins/` في جذر المستودع، ويتم توسيعه عبر `cp -RL` عند التثبيت — بدون حاجة لمسارات مطلقة): ```yaml - id: design-router name: './plugins/design-router/index.mjs' ``` ### الأدوات | الأداة | الاستخدام | المرحلة | | --- | --- | --- | | `design_lookup <branch> <stage>` | الاستعلام عن سجل موارد التصميم (فهرس ثلاثي الأبعاد R/C/E/V + سلسلة احتياطية + مصدر؛ إخراج مجموعات أنماط موسومة) | "ما الذي يجب أن أراجعه في هذه الخطوة؟" | | `design_route <need>` | توجيه كلمات مفتاحية للاحتياج إلى مجموعات أنماط موصى بها (أساسي إلزامي + ثانوي حسب الحاجة) + موارد تمثيلية لكل مجموعة | مرحلة 1 البحث (توجيه ضد التجانس) | | `design_diversity <c1> <c2> <c3>` | فحص آلي لاختلاف 3 مرشحين (عائلات الألوان / نبرة الخط / مجموعات المصدر)، نجاح/فشل | مرحلة 1 قبل تقديم المرشحين (فحص ضد التجانس) | | `design_quality <report\|query>` | تسجيل/استعلام إشارات جودة المصدر (معدل نجاح الاستخراج / معدل إعادة العمل / إمكانية الوصول — موضوعي، ليس قائمًا على الذوق)؛ سجل محلي، ليس في git | تسجيل بعد مرحلة 4 / استهلاك تنازلي في مرحلة 1 | | `design_audit <target>` | بوابة آلة للرداءة (مجموعة فرعية آلية من العلامة المميزة) + قواعد واجهة CS-* الثمانية + فحص مرحلة 4 + مقارنة الوراثة | التحقق في مرحلة 4 | | `design_contrast <target>` | تباين تقريبي WCAG 2.1 + APCA | التحقق في مرحلة 4 | ### الاختلافات المقصودة عن نسخة pi - **إزالة** `design_research` (يستخدم DSH ledger-grep + مجسات refero + سلسلة احتياطية `web_search`) - **إزالة** `hallmark_study_fetch` (يستخدم DSH `dembrandt` / `defuddle` بدلاً منه) - **إزالة** حقن `before_agent_start` وأمر `/design-router` (آلية تحميل المهارات في DSH تغطي التوجيه) - **عدم الاعتماد على `@deepseek-ai/dsh-tools`** (وحدات مساحة العمل لا تستطيع حل دليل تثبيت dsh)؛ تعريفات الأدوات مبنية باستخدام JSON Schema خالص — صفر تبعيات تشغيل خارجية ### التخطيط ``` plugins/design-router/ ├── index.mjs # مدخل المكوّن: تسجيل 6 أدوات (5 للقراءة فقط + كاتب سجلات محلي واحد) ├── checks/ # فاحصات منقولة (TS→JS): طباعة/تخطيط/إمكانية وصول/نص/تباين/غش/قتل رداءة/أصول/أنواع │ └── kill-slop.test.mjs # اختبارات انحدار KS-* (node checks/kill-slop.test.mjs) └── data/ └── registry.json # شكل بيانات registry.md (91 موردًا × 9 توجيهات فروع) ``` ### تغطية البوابات الآلية يشغّل `design_audit` سبع وحدات فاحصة ويعيد قائمة مهام مرقمة بالبوابات: | العائلة | البوابة | المصدر | | --- | --- | --- | | رداءة Hallmark | 1/2/10/14/19/24/26/27/30/33/34/37/38a/39/40/41/46/47/50/51 | `slop-test.md` من hallmark (مجموعة فرعية آلية) | | واجهة CS-* | CS-1…CS-8 | ورقة غش interfaces.dev | | حركة EM-* | EM-2/3/5 (EM-1/7/8 مرتبطة بالبوابات 10/14/27) | emilkowalski/skills | | kill-ai-slop KS-* | KS-03/04/05/08/14 | نسخة kill-ai-slop | | طبقة الأصول DR-A* | DR-A1/DR-A2 | بوابات طبقة أصول Anshu (وجود شعار العلامة/الصور) | | design-references مرحلة 4 | DR-4 (أوزان الخط/أنصاف أقطار زائدة عن المواصفات) | workflow.md من design-references | ### الصيانة - `registry.md` هو **مصدر الحقيقة** (`~/.agents/skills/design-references/references/registry.md`)؛ بعد التعديل، شغّل `node plugins/design-router/scripts/build-registry.mjs` لإعادة توليد `data/registry.json` (+ بيانات إصدار `data/manifest.json`). **لا تعدّل registry.json يدويًا أبدًا.** - منطق الفاحصات يتبع `extensions/design-router/checks/` من المصدر (نقل TS→MJS)؛ بعد تحديثات المصدر، شغّل `node plugins/design-router/scripts/check-checks-sync.mjs /path/to/my-pi-skills/extensions/design-router/checks` للتحقق من تغطية البوابات — **ثم قارن ثوابت الفاحصات يدويًا**: تكافؤ أرقام البوابات لا يلتقط انحراف التفاصيل (مثل قائمة الخطوط الافتراضية الموسعة). اختبارات انحدار KS تلتقط هذا النوع من الانحراف. - بعد أي تغيير في الفاحصات: `node index.test.mjs` و`node checks/kill-slop.test.mjs`. ## إعادة الإنتاج لمرة واحدة (جهاز جديد) يعيد المستودع إنتاج **الآلية**: المكوّن + الإعداد + المهارات المكيفة لـ DSH كلها داخل المستودع (محتوى *المكتبة المرجعية* شخصي — انظر التحذير أعلى). ```bash # ── مرفق مع المستودع (استنساخ ← تشغيل) ── # 1. المهارات (design-references نسخة مكيفة لـ DSH؛ hallmark نسخة MIT من المصدر) cp -R skills/design-references ~/.agents/skills/ cp -R skills/hallmark ~/.agents/skills/ # 2. الإعداد (cp -RL يوسّع الروابط الرمزية النسبية للمكوّنات في presets/my-agent/ إلى نسخ مكتفية ذاتيًا — # بعد التثبيت، لا يعتمد الإعداد على مسارات المستودع ويمكن نسخه أو نقله بحرية) mkdir -p ~/.dsh/.agent-presets cp -RL presets/my-agent ~/.dsh/.agent-presets/ # 3. كود المكوّن (يبقى في مجلد plugins/ بجذر المستودع لإدارة git) # يشير الإعداد إليه عبر المسار النسبي './plugins/design-router/index.mjs': # presets/my-agent/plugins هو رابط رمزي نسبي لمجلد plugins/ في جذر المستودع، # وcp -RL يوسّعه إلى مجلد حقيقي — بدون تحرير مسارات على أي جهاز. # 4. التبعيات الخارجية (تبعيات ناعمة — تتحول لسلسلة احتياطية عند غيابها) npm install -g dembrandt # URL ← رموز تصميم (تحقق من مرشحي مرحلة 1) # defuddle: npm install -g defuddle # npm install -g @open-pencil/cli # اختياري: قراءة/تحويل/تحقق من ملفات تصميم .fig/.pen (تحويل إلى مهارات عائلة Figma / مراجعة يدوية) # ── مرفق ذاتيًا (اختيار شخصي؛ يتحول لسلسلة احتياطية عند غيابها) ── # 5. أصول محلية على الجهاز (ledger + مكتبة مراجع kami/zine/logo-generator) # بدونها، لا تزال هذه الحزمة تعمل — كوكيل تصميم "انضباط العلامة المميزة + web_search/dembrandt" — # لكن مجموعة المرشحين ستفقد اختياراتك الشخصية. ``` **ملاحظة**: سطر المكوّن في الإعداد يستخدم **مسارًا نسبيًا** (`./plugins/design-router/index.mjs`، و`presets/my-agent/plugins` كرابط رمزي نسبي يتم توسيعه عبر `cp -RL`)، لذا يحتاج الجهاز الجديد فقط إلى نسخ مجلد الإعداد — **بدون تحرير مسارات**. إذا أردت تجنب الروابط الرمزية، يمكنك نسخ `plugins/design-router/` إلى `presets/my-agent/plugins/` واستخدام `cp -R` عادي (النتيجة نفسها، فقط نسخة إضافية). ### هيكل المستودع ``` ├── plugins/design-router/ # مكوّن الأدوات الحتمية (6 أدوات، صفر تبعيات تشغيل) ├── presets/my-agent/ # إعداد DSH (agent.cordis.yml + preset.yml) ├── skills/ │ ├── design-references/ # مهارة التوجيه (نسخة مكيفة لـ DSH) │ └── hallmark/ # مهارة مكافحة رداءة الذكاء الاصطناعي (نسخة MIT من المصدر، مع أصول site/) ├── README.md # إنجليزي (أساسي) └── README.zh.md # صيني ``` ## محتوى الطرف الثالث وإسناد التراخيص يضم هذا المستودع محتوى الطرف الثالث التالي (مع الحفاظ على تراخيص/إسنادات المصدر): | المحتوى | المصدر | الترخيص | الموقع | | --- | --- | --- | --- | | مهارة hallmark + رموز وأمثلة `site/` | [nutlope/hallmark](https://github.com/nutlope/hallmark) | MIT (النص الكامل في [`skills/hallmark/LICENSE`](skills/hallmark/LICENSE)) | `skills/hallmark/` | | موارد التصميم الخارجية المشار إليها في السجل (kami/zine/logo-generator وغيرها) | مستودعات المصدر الخاصة بها | إشارات روابط فقط (غير مضمّنة؛ عناوين المصدر في [`registry.md`](skills/design-references/references/registry.md)) | — | كل المحتوى الآخر (`plugins/`، `presets/`، `skills/design-references/`) أصلي لهذا المستودع، بموجب [ترخيص MIT](LICENSE) (حقوق النشر © 2026 haohaiHuang). ## مشاريع ذات صلة - [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) — البنية التحتية التي تشغّل هذه الحزمة (`dsh`، كل شيء مكوّن) - [my-pi-skills](https://github.com/haohaiHuang/my-pi-skills) — مستودع المهارات الرئيسي (design-references / skill-router / vision) - [awesome-dsh-plugin](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) — قائمة مختارة من مكوّنات DSH