منصوبے کے بارے میں

# 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) طریقہ کار کو اپنایا ہے۔ > ⚠️ **اس پیکج میں میکانزم کی نقل کی گئی ہے، مواد کی نہیں۔** روٹنگ، نظم و ضبط اور ٹولز مکمل طور پر خود مختار ہیں (Clone کریں → `cp -RL` کریں → چلائیں)۔ تاہم، *حوالہ جاتی لائبریری* ذاتی نوعیت کی ہے—چند اہم وسائل `~/Desktop/Design/...` اور `~/resources/design-references.md` کی طرف اشارہ کرتے ہیں، جو نجی اثاثے ہیں اور ریپوزٹری کے ساتھ فراہم نہیں کیے جاتے۔ نئے مشین پر، یہ بیک چین (web_search + dembrandt + بلٹ ان علامتی نظم و ضبط) پر گر جائیں گے۔ مکمل ذاتی حوالہ جات کے لیے ان ڈائریکٹریز کو خود کاپی کریں؛ ان کے بغیر، یہ پیکج "علامتی نظم و ضبط + ویب تحقیق" ڈیزائن ایجنٹ کے طور پر کام کر سکتا ہے۔ ## شامل اجزاء | جزو | کردار | | --- | --- | | [`plugins/design-router/`](plugins/design-router/) | تعیناتی ٹول Cordis پلگ ان (6 ریڈ آنلی ٹولز + 1 لوکل لاگ رائٹر، بغیر کسی بیرونی رن ٹائم انحصار کے) | | [`presets/my-agent/`](presets/my-agent/) | DSH ایجنٹ سیٹنگز (`agent.cordis.yml` + `preset.yml`): تہہ دار روٹنگ کردار (مرحلہ → شاخ → مرحلہ) ہر مرحلے کی تصدیقی گیٹ کے ساتھ | | [`skills/design-references/`](skills/design-references/) | مرحلہ/شاخ روٹنگ اسکل (مرحلہ تقسیم → A پروڈکٹ / B مواد / C عمومی → پانچ مراحل)، DSH مطابقت پذیر | | [`skills/hallmark/`](skills/hallmark/) | اینٹی AI سپلاؤس ایکزیکیوشن اسکل ([nutlope/hallmark](https://github.com/nutlope/hallmark) سے MIT اپ اسٹریم کاپی؛ `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 — تعیناتی ٹولز [my-pi-skills](https://github.com/haohaiHuang/my-pi-skills) کے `extensions/design-router` سے منتقل کیا گیا (pi ایکسٹینشن → DSH Cordis پلگ ان)۔ `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 3-D انڈیکس + بیک چین + ذرائع؛ لیبل اسٹائل بکٹ آؤٹ پٹ) | "مجھے اس قدم میں کیا دیکھنا چاہیے؟" | | `design_route <need>` | ضروریات کے کلیدی الفاہد کو تجویز کردہ اسٹائل بکٹ کمبو میں نقش کریں (بنیادی لازمی + ثانوی حسب ضرورت) + ہر بکٹ کے نمائندہ وسائل | مرحلہ 1 تحقیق (ہوموجنائزیشن کے خلاف روٹنگ) | | `design_diversity <c1> <c2> <c3>` | مشین 3 امیدواروں کے درمیان تنوع کی جانچ (ہیو فیملی / فونٹ ٹون / ذرائع بکٹ)، پاس/فیل | | `design_quality <report\|query>` | ذرائع کی معیار کی علامتوں کو ریکارڈ/کور کریں (کامیابی کی شرح / دوبارہ کام کی شرح / دستیابی—موضوعی، ذائقے پر مبنی نہیں)؛ لوکل لاگ، git میں نہیں | | `design_audit <target>` | مشین سپلاؤس گیٹ (علامتی مشین ذیلی سیٹ) + انٹرفیس CS-* 8 قواعد + مرحلہ 4 اسکین + وارث موازنہ | | `design_contrast <target>` | WCAG 2.1 + APCA تقریباً تضاد | ### 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 ریڈ آنلی + 1 لوکل لاگ رائٹر) ├── 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 | hallmark `slop-test.md` (مشین ذیلی سیٹ) | | انٹرفیس 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 (فونٹ وزن/راؤنڈڈ کور سپر اسپیسیفیکیشن) | design-references workflow.md | ### برقراری - `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 # ── ریپوزٹری کے ساتھ فراہم شدہ (Clone → Run)── # 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. پلگ ان سورس کوڈ (git مینجمنٹ کے لیے ریپوزٹری روٹ ڈائریکٹری plugins/ میں برقرار رکھا جاتا ہے) # سیٹنگز نسبی پاتھ './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/ # اینٹی AI سپلاؤس اسکل (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 وغیرہ) |各自 اپ اسٹریم ریپوزٹری | صرف لنک حوالہ (بندل نہیں؛ ذرائع URL [`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 پلگ انز کی فہرست