پروجیکٹ کا تعارف
dsh-jailbreak-workflow، جس کا پلگ اِن پیکیج @xiaoso/dsh-workflow-lite ہے، DeepSeek Harness کے لیے ایک سافٹ ورک فلو پلگ اِن ہے۔ یہ آپ کو کینوس پر کام کے مراحل ترتیب دینے، پھر پورے عمل کو ایک منصوبہ جاتی پرامپٹ میں کمپائل کرنے کی اجازت دیتا ہے، جسے موجودہ سیشن کا ماڈل منصوبے کے مطابق چلاتا ہے۔
یہ ترتیب وار عمل، متوازی عمل، انضمام، مشروط شاخیں، لوپ اور واپسی کو سپورٹ کرتا ہے۔ رابطوں کے ساتھ کوئی بھی شرط منسلک کی جا سکتی ہے، اس لیے یہ صرف سادہ خطی کاموں کے لیے نہیں بلکہ پیچیدہ منطق، جیسے “جائزہ ناکام ہو تو ترمیم کے لیے واپس جائیں” یا “شرط پوری ہونے کے بعد ختم کریں”، کے اظہار کے لیے بھی موزوں ہے۔
پلگ اِن میں خود کوئی ایگزیکیوشن انجن نہیں ہے اور نہ ہی اضافی شیڈولنگ سروس درکار ہے۔ مراحل کی ترتیب، شرائط کا فیصلہ اور کام کی تکمیل سب موجودہ سیشن کا ماڈل انجام دیتا ہے۔
بنیادی طریقۂ کار
ایک مکمل ورک فلو تین مراحل میں چلتا ہے:
- ڈیزائن: کینوس پر مراحل شامل کریں، ہر مرحلے کے لیے پرامپٹ لکھیں، اور رابطوں کے ذریعے عمل کی ترتیب، شاخوں اور لوپ کی وضاحت کریں۔
- کمپائل: پلگ اِن کینوس کو ایک منصوبہ جاتی پرامپٹ میں منظم کرتا ہے، جس میں مراحل کی ترتیب، لوپ کی شرائط، ان پٹ وسائل اور متوقع نتائج بیان ہوتے ہیں۔
- عمل درآمد: ماڈل منصوبہ پڑھ کر خود فیصلہ کرتا ہے کہ کام براہِ راست مکمل کرنا ہے، ذیلی ایجنٹ کو دینا ہے یا ٹیم منظم کرنی ہے، اور پیش رفت کو کینوس پر واپس ہم وقت ساز کرتا ہے۔
اس ڈیزائن کا مرکزی نکتہ ورک فلو کے اظہار اور ماڈل کے عمل کو الگ رکھنا ہے: کینوس منصوبے کی واضح وضاحت کرتا ہے، جبکہ ماڈل منصوبے کو سمجھ کر نافذ کرتا ہے۔
اہم خصوصیات
- کینوس ایڈیٹنگ: مراحل اور رابطوں کو گھسیٹ کر رکھیں، کامیاب یا ناکام شاخیں اور لوپ بنائیں، اور ایک کلک سے لے آؤٹ منظم کریں۔
- وسائل کی ترتیب: ہر مرحلے کے لیے پڑھنے یا لکھنے کی مطلوبہ فائلیں، فولڈرز، ویب سائٹس اور Skill متعین کریں۔
- عمل درآمد سے پہلے سوالات: چلانے سے پہلے صارف سے ضروری معلومات حاصل کریں، پھر جوابات کو منصوبے کے ساتھ ماڈل کو بھیجیں۔
- ماڈل کے ذریعے ایڈیٹنگ: گفتگو میں براہِ راست ماڈل سے ورک فلو بنانے یا تبدیل کرنے کو کہیں؛ تبدیلیاں کینوس پر ہم وقت ساز ہو جائیں گی۔
- عمل درآمد کی حالت: کینوس پر حقیقی وقت کی پیش رفت، ہر مرحلے کا خلاصہ اور حالت دیکھیں، اور حالت تبدیل کر کے ماڈل کو مطلع کریں۔
- ورژن مینجمنٹ: ورژن محفوظ کریں، وضاحت شامل کریں، فرق کا موازنہ کریں اور سابقہ ورژن پر جائیں۔
- درآمد اور برآمد: ورک فلو، منتخب ورژن، فائلوں اور Skill کو
.wflite.zipمیں پیکیج کریں۔ - Skill کے طور پر برآمد: کسی ورژن کو
SKILL.md، کام کی تفصیل اور متعلقہ وسائل پر مشتمل Skill میں کمپائل کریں، جسے ڈاؤن لوڈ یا~/.agents/skillsمیں انسٹال کیا جا سکتا ہے۔ - ورک فلو مرکز: مختلف سیشنز کے عمل درآمد ریکارڈ، ورک فلو، ورژنز، یادداشت اور پلگ اِن کی ترتیبات کو مرکزی طور پر منظم کریں۔
- دو لسانی معاونت اور تھیمز: چینی، انگریزی اور متعدد ہلکے و گہرے تھیمز سپورٹ کرتا ہے۔
انسٹالیشن سے پہلے تیاری
یہ پلگ اِن DeepSeek Harness 0.2.0 اور 0.2.1، بشمول متعلقہ پری ویو ورژنز مثلاً 0.2.1-rc.2، کے ساتھ مطابقت رکھتا ہے۔ ویب ورژن استعمال کرنے کے لیے Node.js 22 یا اس سے جدید ورژن بھی درکار ہے۔
پروجیکٹ ابھی تجرباتی مرحلے میں ہے، اس لیے آئندہ ورژنز میں خصوصیات اور ڈیٹا فارمیٹ غیر مطابقت پذیر طور پر تبدیل ہو سکتے ہیں۔ اہم ورک فلو کو بروقت برآمد کر کے ورژن محفوظ رکھنے کی تجویز ہے۔
ویب ورژن میں پلگ اِن انسٹال کریں
ٹرمینل کھولیں، پلگ اِن کو DeepSeek Harness کے Web پروفائل میں شامل کریں، پھر ویب ورژن شروع کریں:
dsh plugin --profile web add @xiaoso/dsh-workflow-lite
dsh webشروع ہونے کے بعد سیشن صفحے پر جائیں۔ انسٹالیشن کامیاب ہونے کی صورت میں صفحے کے اوپر “ورک فلو” ٹیب ظاہر ہوگا۔
ڈیسک ٹاپ ورژن میں پلگ اِن انسٹال کریں
- DeepSeek Harness کی سائیڈ بار میں “پلگ اِنز” کھولیں۔
- “پلگ اِن شامل کریں” منتخب کریں، پھر “تھرڈ پارٹی پلگ اِن انسٹال کریں” پر کلک کریں۔
@xiaoso/dsh-workflow-liteدرج کریں اور انسٹالیشن کی تصدیق کریں۔- DeepSeek Harness دوبارہ شروع کریں۔
- سیشن صفحے پر جائیں اور تصدیق کریں کہ اوپر “ورک فلو” ٹیب ظاہر ہو رہا ہے۔
بنیادی استعمال 1: ماڈل سے ورک فلو بنوائیں
سب سے آسان طریقہ یہ ہے کہ گفتگو میں کام کے مراحل اور فیصلے کی شرائط کو قدرتی زبان میں بیان کریں۔ مثال کے طور پر:
ایک ورک فلو بنائیں: پہلے کوڈ لکھیں، پھر جائزہ لیں؛ اگر جائزہ ناکام ہو تو واپس جا کر درست کریں، زیادہ سے زیادہ تین ادوار تک۔ماڈل اس بنیاد پر مراحل بنائے گا، جائزے کی شاخوں کو جوڑے گا اور لوپ ترتیب دے گا؛ کینوس پر نتیجہ بھی ہم وقت ساز دکھایا جائے گا۔ چلانے سے پہلے درج ذیل چیزیں جانچیں:
- کیا ہر مرحلے کا پرامپٹ واضح ہے۔
- کیا “کامیاب” اور “ناکام” شاخیں درست نوڈز سے جڑی ہیں۔
- کیا لوپ کے لیے واضح اختتامی شرط یا زیادہ سے زیادہ تعداد مقرر ہے۔
- کیا ان پٹ فائلیں اور آؤٹ پٹ مقام درست ترتیب دیے گئے ہیں۔
اطمینان کے بعد اوپر دائیں جانب “عمل درآمد” پر کلک کریں، یا گفتگو میں ماڈل سے اس ورک فلو کو براہِ راست چلانے کو کہیں۔
بنیادی استعمال 2: ورک فلو دستی طور پر بنائیں
- “ورک فلو” ٹیب کھولیں اور نیا ورک فلو بنائیں۔
- بائیں جانب موجود مراحل کی فہرست سے مطلوبہ مراحل گھسیٹ کر کینوس پر رکھیں۔
- ہر مرحلے کے لیے ماڈل کو دیا جانے والا پرامپٹ لکھیں۔
- رابطوں کے ذریعے عمل کی ترتیب متعین کریں، اور ضرورت کے مطابق شرائط، شاخیں یا لوپ شامل کریں۔
- مراحل کے ساتھ پڑھی یا لکھی جانے والی فائلیں، فولڈرز، ویب سائٹس یا Skill منسلک کریں۔
- “عمل درآمد” پر کلک کریں، یا گفتگو میں ماڈل سے موجودہ ورک فلو چلانے کو کہیں۔
مثال: دوبارہ کام کے لوپ والا مواد کا عمل
کسی مواد سے متعلق کام کو “معلومات جمع کرنا”، “ابتدائی مسودہ بنانا”، “معیار جانچنا” اور “ابتدائی مسودے میں ترمیم کرنا” کے چار مراحل میں تقسیم کیا جا سکتا ہے۔ معیار کی جانچ کامیاب ہو تو عمل ختم ہو جائے؛ ناکام ہونے کی صورت میں ترمیم کے مرحلے پر جائیں، پھر معیار کی جانچ کی طرف واپس آئیں۔ چونکہ اصل فیصلہ ماڈل کرتا ہے، اس لیے جانچ کے مرحلے کا پرامپٹ کامیابی کے معیار کو واضح طور پر بیان کرے۔
جانچیں کہ آیا ابتدائی مسودہ درج ذیل شرائط پوری کرتا ہے:
1. نتائج کو مواد سے حمایت حاصل ہے؛
2. ساخت مکمل ہے؛
3. واضح تکرار موجود نہیں؛
4. “کامیاب” یا “ناکام” لکھیں اور وجہ بیان کریں۔کسی بھی لوپ والے عمل کے لیے بہتر ہے کہ پرامپٹ یا ورک فلو کی شرط میں زیادہ سے زیادہ ادوار شامل کیے جائیں، تاکہ ماڈل مسلسل دوبارہ کام نہ کرتا رہے۔
عمل درآمد کی پیش رفت دیکھیں
“ورک فلو کی ترتیبات” کھولیں اور “چلنے کی حالت ریکارڈ کریں” فعال کریں۔ اس کے بعد ہر عمل درآمد کے لیے الگ ریکارڈ بنے گا اور کینوس پیش رفت کے ساتھ اپ ڈیٹ ہوگا۔ آپ ہر مرحلے کا خلاصہ دیکھ سکتے ہیں، مرحلے کی حالت تبدیل کر سکتے ہیں اور ماڈل کو مطلع کر سکتے ہیں۔
ورک فلو، ورژنز اور ہر سیشن کے عمل درآمد ریکارڈ کینوس کے اوپری بائیں جانب موجود “ورک فلو مرکز” میں یکجا کیے جاتے ہیں۔ سابقہ عمل درآمد کا جائزہ لینے یا ورژن تبدیل کرنے کے لیے پہلے یہی مقام استعمال کریں۔
پاتھ ویری ایبلز کا درست استعمال
وسائل کے راستے اور آؤٹ پٹ کی بنیادی ڈائریکٹری دو ویری ایبلز کو سپورٹ کرتی ہے: {workflow} اور {instance}۔ ان کا مناسب استعمال مشین سے متعلق مطلق راستوں کو ورک فلو میں لکھنے سے بچاتا ہے۔
{workflow}：ورک فلو کے مشترکہ وسائل کی ڈائریکٹری
یہ ویری ایبل فائل یا فولڈر کے وسائل کے راستے میں لکھا جا سکتا ہے، مثلاً:
{workflow}/refs/notes.mdعمل درآمد کے وقت اسے موجودہ ورک فلو کی اپنی ڈائریکٹری سے بدل دیا جائے گا، جس کا طے شدہ مقام تقریباً یہ ہے:
~/.dsh/workflow-lite/assets/<ورک فلو کا نام>/یہ ڈائریکٹری عمل درآمد کے ورک اسپیس کے ساتھ تبدیل نہیں ہوتی۔ ورک فلو کا نام تبدیل کرنے یا اسے برآمد کرنے پر بھی اسے ساتھ ہی سنبھالا جاتا ہے، اس لیے یہ حوالہ جاتی مواد، ٹیمپلیٹس اور ورک فلو میں طویل مدت تک استعمال ہونے والی فائلوں کے لیے موزوں ہے۔ سابقہ ورژنز میں موجود {assets}/… بھی قابل استعمال ہے؛ ورک فلو کھولتے وقت اسے خودکار طور پر {workflow}/… میں تبدیل کر دیا جائے گا۔
{instance}：ایک بار کے عمل درآمد کی مثال کی ڈائریکٹری
یہ ویری ایبل “ورک فلو کی ترتیبات” میں آؤٹ پٹ کی بنیادی ڈائریکٹری کے لیے استعمال ہوتا ہے۔ طے شدہ ترتیب کی مثال:
.workflow-lite/runs/{instance}/outچلتے وقت {instance} کو موجودہ عمل درآمد کی مثال کی ID سے بدل دیا جائے گا، جس سے ہر عمل درآمد کا آؤٹ پٹ الگ محفوظ ہوگا۔ یہ متعدد ادوار کے نتائج محفوظ کرنے اور ان کا موازنہ کرنے والے کاموں کے لیے موزوں ہے۔
موجودہ ورک فلو درآمد کریں
پروجیکٹ کے منتظمین نے ایک علیحدہ dsh-workflows ورک فلو مجموعہ فراہم کیا ہے۔ اس میں موجود .wflite.zip فائل ڈاؤن لوڈ کرنے کے بعد اسے “ورک فلو مرکز” سے درآمد کیا جا سکتا ہے۔
درآمدی پیکیج میں ورک فلو، مخصوص ورژن، متعلقہ فائلیں اور Skill شامل ہو سکتے ہیں۔ پلگ اِن درآمد سے پہلے ہر جزو کا انسٹالیشن مقام دکھائے گا؛ آگے بڑھنے سے پہلے راستوں کی تصدیق کرنے کی تجویز ہے۔
README میں فراہم کردہ “آرمر توڑنے” کا ورک فلو 15 مراحل پر مشتمل تحقیقی پائپ لائن کی مثال ہے، جس میں پروب ٹیسٹ، انکار کے نمونوں کا تجزیہ، حسب ضرورت مواد کی تیاری، API کی توثیق اور فائل آؤٹ پٹ شامل ہیں۔ اس نوعیت کے کسی بھی تحقیقی ورک فلو کا استعمال کرتے وقت یقینی بنائیں کہ ہدف، ڈیٹا کے ذرائع اور ٹیسٹ کا طرزِ عمل قابل اطلاق قوانین، پلیٹ فارم کے قواعد اور اجازت کی حدود کے مطابق ہوں۔
کینوس ڈسپلے اور فائل پیش نظارہ
تجرباتی کینوس ڈسپلے کی خصوصیت بورڈز، تصاویر، دستاویزات، لاگز، جدولوں اور فولڈرز کو براہِ راست کینوس پر دکھا سکتی ہے اور عمل درآمد کے دوران خودکار طور پر اپ ڈیٹ ہو سکتی ہے۔ لوپ والے کام میں ہر دور کے نتائج بھی دوبارہ دیکھے اور ان کا موازنہ کیے جا سکتے ہیں۔
مثال کے وسائل Markdown، HTML صفحات، تصاویر اور فولڈرز کا پیش نظارہ سپورٹ کرتے ہیں۔ HTML صفحات کو مسلسل اپ ڈیٹ ہونے والے بورڈ کے طور پر بھی استعمال کیا جا سکتا ہے، جبکہ فولڈرز کو دو طرفہ پینل میں براؤز کیا جاتا ہے۔ چونکہ یہ خصوصیت ابھی تجرباتی مرحلے میں ہے، اس لیے طویل مدتی مطابقت کے ڈیزائن کو موجودہ ڈیٹا فارمیٹ پر منحصر نہیں کرنا چاہیے۔
ورک فلو کی یادداشت
“یادداشت” ایک تجرباتی خصوصیت ہے، جو کامیاب طریقوں اور پیش آنے والے مسائل کو Skill میں منظم کرتی ہے تاکہ آئندہ عمل درآمد میں ان سے رہنمائی لی جا سکے۔ آپ کسی خاص مرحلے کے لیے الگ سے یادداشت فعال کر سکتے ہیں، یا مراحل کی فہرست کے “بنیادی” گروپ سے “یادداشت” نوڈ گھسیٹ کر لا سکتے ہیں تاکہ پورا ورک فلو ایک ہی یادداشت استعمال کرے۔
ہر یادداشت ایک Skill فولڈر سے متعلق ہوتی ہے، جس میں “فوری راستہ” اگلی بار زیادہ آسان عمل درآمد کا طریقہ درج کرنے کے لیے استعمال ہوتا ہے۔ عمل درآمد کے دوران ہر مرحلہ اپنا تجربہ جواب میں لکھتا ہے؛ ورک فلو ختم ہونے کے بعد ماڈل اسے یکجا کرتا ہے۔
یادداشت کی خصوصیت کی حدود
- جب متعدد مثالیں بیک وقت ایک ہی یادداشت میں تبدیلی کرتی ہیں تو کوئی لاک موجود نہیں ہوتا؛ بعد میں لکھی گئی معلومات پہلے لکھی گئی معلومات کو بدل دیتی ہیں۔
- Skill کو دوبارہ برآمد کر کے اوور رائٹ انسٹال کرنے سے پہلے سے انسٹال شدہ Skill میں جمع شدہ یادداشت بھی اوور رائٹ ہو جاتی ہے۔
- ابتدائی بار بار عمل درآمد کے تجربات میں مستقل رفتار میں اضافہ نہیں دیکھا گیا؛ “فوری راستہ” شامل کرنے کا حقیقی اثر مزید ورک فلو کی توثیق کا محتاج ہے۔
اگر زیادہ پیچیدہ اور قابل کنٹرول طویل مدتی تجربہ مینجمنٹ درکار ہو تو README پرامپٹ کے ساتھ “وسائل” استعمال کر کے اسے خود نافذ کرنے کی تجویز دیتا ہے۔
اعلیٰ سطحی عملی تجاویز
مراحل کے پرامپٹس کو قابل تصدیق بنائیں
صرف “نتیجہ جانچیں” نہ لکھیں۔ فیصلہ کرنے کے معیار، پڑھے جانے والے ان پٹس، آؤٹ پٹ فارمیٹ اور کامیابی یا ناکامی کی صورت میں کیے جانے والے اقدامات درج کریں۔ ماڈل کو انہی معلومات کی بنیاد پر شرائط کا فیصلہ کرنا ہوگا۔
لوپ کی حدود مقرر کریں
لوپ کے رابطے دوبارہ کام کی منطق کا اظہار کر سکتے ہیں، لیکن بہتر ہے کہ زیادہ سے زیادہ ادوار، رکنے کی شرط اور ناکامی کے بعد کا طریقہ بھی مقرر کیا جائے۔ اس سے لامحدود لوپ یا بار بار ترمیم کے خطرے کو کم کیا جا سکتا ہے۔
مشترکہ وسائل اور عمل درآمد کے آؤٹ پٹ میں فرق رکھیں
ٹیمپلیٹس، حوالہ جاتی مواد اور طویل مدتی فائلیں {workflow} کے تحت رکھیں؛ ہر عمل درآمد سے بننے والی رپورٹس، لاگز اور درمیانی نتائج کو ایسی ڈائریکٹری میں رکھیں جس میں {instance} شامل ہو۔ اس طرح برآمد کرنا بھی آسان ہوگا اور متعدد عمل درآمد کا موازنہ بھی کیا جا سکے گا۔
اہم تبدیلیوں سے پہلے ورژن محفوظ کریں
پرامپٹس، رابطوں کی شرائط یا وسائل کے راستے تبدیل کرنے سے پہلے ورژن محفوظ کریں اور وضاحت شامل کریں۔ مسئلہ پیش آنے پر ورژن کے فرق کا موازنہ کیا جا سکتا ہے یا براہِ راست سابقہ ورژن پر واپس جایا جا سکتا ہے۔
پورٹیبلٹی بہتر بنانے کے لیے Skill کے طور پر برآمد کریں
اگر ہدف کے ماحول میں پلگ اِن انسٹال نہیں کیا جا سکتا تو مستحکم ورژن کو Skill میں کمپائل کریں۔ برآمد شدہ مواد میں SKILL.md، ہر مرحلے کی کام کی تفصیل اور پیکیج کی گئی فائلیں و Skill شامل ہوتے ہیں، جنہیں آزاد وسائل کے طور پر استعمال کیا جا سکتا ہے۔
تجرباتی خصوصیات احتیاط سے استعمال کریں
کینوس ڈسپلے اور ورک فلو کی یادداشت کا رویہ اور ڈیٹا فارمیٹ تبدیل ہو سکتا ہے۔ اہم پروجیکٹس کے لیے برآمدی پیکیج، اہم فائلیں اور ورژن کی وضاحت محفوظ رکھیں، اور واحد نقل کو صرف تجرباتی اسٹوریج کے ڈھانچے میں نہ رکھیں۔
خلاصہ
dsh-jailbreak-workflow پیچیدہ کاموں کو ایک بصری کینوس میں تبدیل کرتا ہے، پھر اسے منصوبہ جاتی پرامپٹ میں مرتب کرکے موجودہ سیشن میں DeepSeek Harness کے ماڈل کو عمل درآمد کے لیے فراہم کرتا ہے۔ آپ ایک سادہ "تیار کریں—جانچیں—دوبارہ کام کریں" کے عمل سے شروع کر سکتے ہیں، اور بتدریج وسائل، پاتھ متغیرات، رن ریکارڈز، ورژن مینجمنٹ اور Skill ایکسپورٹ شامل کر سکتے ہیں۔ "پلگ اِن منصوبہ مرتب کرتا ہے، جبکہ ماڈل حقیقی شیڈولنگ کرتا ہے" کے اصول کو سمجھنا مستحکم ورک فلو ڈیزائن کرنے کی کلید ہے۔