ZIAForge واپرائيندڙ رهنمائي

شروعاتي قدم

ZIAForge بحث، رٿابندي، عمل درآمد ۽ تصديق کي هڪ ئي ٽاسڪ ۾ رکي ٿو. Git پروجيڪٽ لاءِ Code چونڊيو، يا عام فولڊر ۾ دستاويزن، تحقيق ۽ ٻين نتيجن لاءِ Work چونڊيو.

هڪ الڳ پروجيڪٽ ۾ ننڍڙي ٽاسڪ سان شروع ڪريو. جيڪڏهن توهان مقامي CLI چونڊيو ٿا، ته ان کي پهريان انسٽال ڪريو ۽ ٽرمينل ۾ ان جي پنهنجي اڪائونٽ سان سائن ان ٿيو. متبادل طور تي، هڪ API ڪنيڪشن ترتيب ڏيو. هڪ CLI سبسڪرپشن ۽ ادا ڪيل API الڳ ڪنيڪشن جا طريقا آهن؛ ZIAForge توهان کي سائن ان نٿو ڪري يا انهن جي وچ ۾ ڪريڊٽس منتقل نٿو ڪري.

1. سيٽنگس کوليو ۽ ورڪ اسپيس فولڊر ۽ ٻولي چيڪ ڪريو. ائباؤٽ هلندڙ بلڊ جي صحيح سڃاڻپ ڏيکاري ٿو.
2. Code لاءِ، سائڊبار ۾ هڪ Git مخزن شامل ڪريو. Work لاءِ، ٽاسڪ ٺاهڻ وقت هڪ الڳ فولڊر چونڊيو.
3. CLI، ماڊل، دليل سازي ڪوشش ۽ پهچ جي سطح سان هڪ پريسيٽ محفوظ ڪريو. توهان محفوظ ڪيل پريسيٽ کانسواءِ سڌو سنئون ڪسٽم پڻ چونڊي سگهو ٿا.
4. هڪ ٽاسڪ ٺاهيو، ان جو رستو، ڪردار ۽ دستي يا پاڻمرادو پيش رفت چونڊيو. شروع ڪرڻ کان اڳ چونڊن جو جائزو وٺو.

لاڳاپيل هدايتون: پروجيڪٽ جو جائزو · مهيا ڪندڙ جي مطابقت.

صحيح ڊيسڪ ٽاپ پيڪيج انسٽال ڪريو

پنهنجي آپريٽنگ سسٽم ۽ CPU آرڪيٽيڪچر لاءِ هڪ پيڪيج چونڊيو: x64 يا arm64. بلڊ پائپ لائن macOS DMG/ZIP، Windows NSIS انسٽالر/ZIP، ۽ Linux DEB/RPM/AppImage/tar.gz/ZIP فارميٽس تيار ڪري سگهي ٿي. ٺاهيل فائل يا ڪراس بلڊ ان ڳالهه جو ثبوت ناهي ته ان جو انسٽالر ۽ مقامي UI توهان جي مشين تي پاس ٿي ويا آهن؛ ان رليز جي تصديقي رڪارڊ جو مطالعو ڪريو.

Electron 44 استعمال ڪندڙ macOS بلڊز لاءِ macOS 13 يا بعد وارو ورزن گهربل آهي. ايپل سلڪان تي arm64 پيڪيج ۽ انٽيل لاءِ x64 پيڪيج استعمال ڪريو. مٽائڻ کان اڳ پراڻي ايپ کي مڪمل طور بند ڪريو. پريويو پيڪيجز غير صحيح ٿيل ۽ غير نوٽرائز ٿيل ٿي سگهن ٿا؛ ڊولپمينٽ آرٽيفيڪٽ کي صحيح ٿيل پبلڪ رليز نه سمجهو.

Windows کي گڏيل Electron ورزن پاران سپورٽ ٿيندڙ آپريٽنگ سسٽم ۽ PATH ۾ دستياب Git جي ضرورت آهي. مطابقت رکندڙ آرڪيٽيڪچر چونڊيو. هڪ اڻ تصديق ٿيل پريويو وٽ Authenticode سرٽيفڪيشن نه هوندو آهي. پورٽيبل ZIP کي پوري ايپليڪيشن ڊائريڪٽري ۽ رن ٽائيم فائلون برقرار رکڻ گهرجن، نه رڳو ان جي هلندڙ فائل.

Linux کي مطابقت رکندڙ گرافڪل ڊيسڪ ٽاپ، Electron پاران گهربل سسٽم لائبريريز، ۽ Git جي ضرورت آهي. انڪرپٽ ٿيل ڪنٽرول سڃاڻپ لاءِ، ڪم ڪندڙ سيڪريٽ سروس فراهم ڪريو جيئن ته gnome-libsecret يا KWallet؛ غير محفوظ basic_text بئڪ اينڊ قبول نه ڪيو ويو آهي. هيڊ لیس/ڪنٽينر جا اسموڪ ثبوت هر ڊيسڪ ٽاپ يا ڊسٽريبيوشن جي تصديق نٿا ڪن.

DEB کي apt install ./file.deb ذريعي انسٽال ڪريو، يا پنهنجي ڊسٽريبيوشن جي پيڪيج مئنيجر ذريعي هڪ RPM انسٽال ڪريو. هڪ AppImage کي هلائڻ جي اجازت ۽ مناسب FUSE سپورٽ جي ضرورت آهي؛ --appimage-extract-and-run هڪ متبادل آهي جتي اها سپورٽ هجي. tar.gz ۽ ZIP پيڪيجز کي انهن جي سمورين رن ٽائيم فائلن سان ان پيڪ ڪريو. پيڪيج تبديل ڪرڻ وقت واپرائيندڙ ڊيٽا ۽ ايپليڪيشن فائلن کي الڳ الڳ رکو.

سورس مان تيار ڪرڻ لاءِ، Node 24، Git ۽ npm ci استعمال ڪريو، بشمول عام Electron انسٽالر. نيٽو ري بلڊز لاءِ پليٽ فارم اوزار گهربل آهن: macOS تي Xcode ڪمانڊ لائن اوزار؛ Windows تي MSVC C++، Windows SDK ۽ Python؛ Linux تي ڪمپلائر، make، Python، pkg-config ۽ گهربل پيڪيجنگ اوزار. صحيح حڪمن ۽ موجوده پليٽ فارم حدن لاءِ PLATFORM_BUILDS.md جي پيروي ڪريو.

رليز ورزن مرڪزي طور تي محفوظ ڪيا ويا آهن ۽ پيداوار اڻ بدليل آهي. هڪ CI تصديقي بلڊ شايع ٿيل انسٽالر نه آهي. سورس آرڪائيوز ۾ سورس، لاڪ فائل، دستاويز ۽ اسڪرپٽ شامل آهن؛ انحصار، سڃاڻپ جا تفصيل، واپرائيندڙ پروفائلز ۽ خانگي تحقيق خارج ٿيل آهن. ڪامياب x64 بلڊ مان ڪڏهن به مقامي ARM يا Windows تصديق جو اندازو نه لڳايو.

لاڳاپيل هدايتون: پليٽ فارم پيڪيجز، ضرورتون ۽ تصديق جون حدون · بلڊ سڃاڻپ ۽ رليز چڪاسون.

Code: پنج رستا

Auto گنجائش جو جائزو وٺي ٿو: هڪ سادو سوال شايد هڪ جواب سان ختم ٿي وڃي، جڏهن ته وڏي ٽاسڪ کي تياري جي ضرورت آهي. هڪ بگ ٺاهيو سبب جي جاچ ڪري ٿو ۽ سڌاري جي تياري ڪري ٿو. وضاحتون پهريان ٽيڪنيڪل حل سان شروع ٿئي ٿو؛ گهرجون پهريان ضرورتن ۽ قبوليت جي معيار سان شروع ٿئي ٿو.

ملٽي ماڊل کوجنا، ڊيزائن، نفاذ ۽ نظرثاني لاءِ الڳ حوالي استعمال ڪري ٿو. روٽ جي نالي کي مختلف مهيا ڪندڙن جي ضرورت ناهي: هر ڪردار توهان جي چونڊيل پريسيٽ يا ڪسٽم ڪنفيگريشن استعمال ڪري ٿو.

هڪ Worktree ٽاسڪ جي Git تبديلين کي الڳ ڪري ٿو. برانچ چونڊيل چيڪ آئوٽ ۾ ڪم ڪري ٿي. شروع ڪرڻ کان اڳ پروجيڪٽ، برانچ ۽ ماڊل چيڪ ڪريو؛ ٽاسڪ جي وضاحت عام چيٽ ڏانهن پڻ نه موڪلي ويندي آهي.

اڻ فيصل ٿيل پراڊڪٽ يا ٽيڪنيڪل چونڊن واري خيال لاءِ، گهرجون پهريان استعمال ڪريو ۽ بحث ۾ بنياد تيار ڪريو. Auto درخواست جي درجه بندي ڪري ٿو؛ هي هر ننڍڙي جملي کي فوري طور تي لاڳو ڪرڻ جو حڪم ناهي. مسودو محفوظ ڪريو ماڊل سان رابطو ڪرڻ کان سواءِ درخواست برقرار رکي ٿو؛ شروع ڪريو محفوظ ڪري ٿو ۽ انتظام ڪيل وهڪري کي هڪ ڀيرو هلائي ٿو. هڪ کان چار ٽاسڪ ڪاپيون آزاد تخليق IDs ۽ ڪردار سيٽنگون رکن ٿيون.

لاڳاپيل هدايتون: Code ورڪ فلو معاهدو · Code پرامپٽ پروفائلز.

Forge بحث

شروع ڪريو مرڪزي بحث کولي ٿو. قدرتي طور تي جواب ڏيو، جوابي سوال پڇو، رڪاوٽون شامل ڪريو ۽ ٽيڪنيڪل چونڊن تي بحث ڪريو. گفتگو ۽ سوال ٽاسڪ سان گڏ رهن ٿا.

متن موڪلڻ ڪنهن دستاويز کي قبول نٿو ڪري يا نئين نفاذ واري منصوبي جي اجازت نٿو ڏئي. نفاذ دوران وضاحت پهريان منظم موڙ کي روڪي ٿي ۽ متاثر ٿيل دائري جو ٻيهر جائزو وٺي ٿي. اڳ ۾ ئي قبول ٿيل قدم اندر ڪنهن سوال جو جواب ان قدم کي جاري رکي سگهي ٿو.

ڄاڻي واڻي بنياد تي ٻيهر نظرثاني ڪرڻ لاءِ، گهرجون، وضاحتون يا رٿابندي چونڊيو. هڪ نئين ورزن لاءِ انحصار ڪندڙ فيصلن جي نئين سر قبوليت جي ضرورت آهي. مڪمل ٿيل قدم ۽ انهن جا ثبوت باقي رهن ٿا؛ تبديل ٿيل اڻ پوريون مرحلا تاريخ ۾ رهن ٿا.

منظم ڪيل فيز سيشنز کليل چيٽ کان مختلف هوندا آهن. ورڪ فلو جي ملڪيت واري سيشن ڏانهن دستي پرامپٽ موڪلڻ بدران Forge بحث استعمال ڪريو.

لاڳاپيل هدايتون: Forge بحث معاهدو.

دستاويز ۽ فيصلا

هڪ دستاويز کوليو، ان جي ورزن جي چڪاس ڪريو ۽ ضرورت پوڻ تي ترميمون ڪريو. بحث ذريعي ترميمون پيش ڪرڻ هڪ نئون ورزن پيدا ڪري ٿو؛ رپورٽون ۽ تصديق ٿيل نتيجا ماضيءَ جي اثر سان ٻيهر نٿا لکيا وڃن.

تجويز ڪيل منصوبي کي قبول ڪرڻ کان اڳ، ترتيب، هدايتون، قبوليت جو معيار ۽ تصديق جا حڪم ترميم ڪريو. اهي ڪنڪريٽ ڪمانڊس مجاز ڪريو جن کي توهان سمجهو ٿا: اهي ٽاسڪ فولڊر ۾ هلون ٿا. ملٽي ماڊل پنهنجي دستاويزن ۽ هدايتن ۾ تفصيلن سان گڏ، هڪ مڪمل ٽاسڪ نفاذ وارو قدم تجويز ڪري ٿو.

منظور ڪريو هڪ الڳ سوچيل سمجهيل فيصلو آهي. Auto سوالن يا ضرورتن، وضاحتن ۽ منصوبن جي قبوليت کي نظرانداز نٿو ڪري. هڪ ٻاهرين طور تبديل ٿيل دستاويز پراڻي منظوري کي ٻيهر استعمال نٿو ڪري سگهي.

تياري جون فائلون آرٽيفيڪٽس طور ظاهر ٿين ٿيون. انهن جو ورزن، پيدا ڪندڙ فيز ۽ هيش انهن کي هڪ نتيجي سان ڳنڍين ٿا. Code دستاويز ورڪ ٽري کان ٻاهر رکيا وڃن ٿا ۽ پاڻمرادو ڪمٽ ۾ داخل نه ٿيندا آهن.

قبول ڪرڻ کان اڳ دستاويز ۽ ڏيکاريل فيصلو ٻنهي جي چڪاس ڪريو. قبوليت موجوده گيٽ ID، منصوبي جي نظرثاني ۽ برقرار رکيل دستاويز هيشن کي پابند ڪري ٿي. تبديلين جي درخواست ڪريو جڏهن گنجائش يا ثبوت غلط هجي. جيڪڏهن ڪو فيصلو پراڻو ٿي ويو آهي، نئين چونڊ ڪرڻ کان اڳ محفوظ ڪيل حالت ٻيهر لوڊ ڪريو؛ تبديل ٿيل فائل اڳئين ورزن تحت قبول نٿي ڪري سگهجي.

لاڳاپيل هدايتون: ورڪ فلو گيٽس ۽ دستاويز ورزن.

نفاذ ۽ نظرثاني

ٽو-ڊو اصل قدم، موجوده ڪوشش، تصديق ۽ نظرثاني جا نتيجا ڏيکاري ٿو. هڪ ايجنٽ جو ”ٿي ويو“ چوڻ ڪنهن قدم کي مڪمل نٿو ڪري: منصوبي جو گهربل ثبوت موجود هجڻ لازمي آهي.

مينوئل موڊ اهل قدمن جي وچ ۾ روڪي ٿو. Auto تصديق ٿيل قدمن کي اڳتي وڌائي ٿو ۽ محدود ٻيهر ڪوششن جي اجازت ڏئي ٿو. کان پوءِ روڪيو هميشه هڪ چيڪ پوائنٽ ٺاهي ٿو. روڪيو ورڪ فلو جي سرگرم ڪم کي روڪي ٿو؛ هڪ پينل بند ڪرڻ ان کي نٿو روڪي.

هڪ خود مختيار مبصر فائلن ۽ تصديق جي نتيجن سان هڪ الڳ حوالو استعمال ڪري ٿو. هر گهربل رڪاوٽ واري دريافت کي حل ڪيو وڃي؛ گهڻا مبصر هڪ رڪاوٽ واري غلطي کي ووٽ ذريعي ختم نٿا ڪن.

ملٽي ماڊل ۾، نتيجن کي درست ڪرڻ لاءِ واضح فيصلي جي ضرورت آهي. هڪ سڌارو خاموشيءَ سان ٻي نظرثاني شروع نٿو ڪري: ٻيهر نظرثاني ڪريو هڪ نئون چڪر کولي ٿو. نظرثاني رايا نفاذ کي ٻيهر ورجائڻ کان سواءِ ڪوآرڊينيٽر جي نظرثاني جي درخواست ڪري سگهن ٿا.

مڪمل ٿيل قدم خاموشيءَ سان تبديل نٿا ڪري سگهجن. TDD سان، ريڊ کي متوقع سبب جي ڪري واقعي ناڪام ٿيڻ گهرجي، پوءِ گرين کي پاس ٿيڻ گهرجي. محدود ڪوششون بي انتها ٻيهر ڪوششن کي روڪين ٿيون.

سيٽنگس → نظرثاني ٽيمون ۾ آزاد CLI/API نظرثاني ڪندڙ محفوظ ڪريو، پوءِ Code يا Work ۾ ٽيم چونڊيو. مبصر متوازي طور تي هلن ٿا، جنهن کان پوءِ ٽيم جو رپورٽ آرڪيٽيڪٽ اچي ٿو. توهان هڪ محفوظ ڪيل ٽيم کان سواءِ پڻ آزاد مبصر ترتيب ڏئي سگهو ٿا. رپورٽ آرڪيٽيڪٽ صرف گمنام منظم رپورٽون وصول ڪري ٿو، بغير ڪنهن پروجيڪٽ فائلن يا اوزارن جي؛ هن اڪيلائي لاءِ في الحال Claude Code يا API جي ضرورت آهي.

هر نفاذ واري قدم کي هڪ قابل عمل چڪاس، گهربل آزاد نظرثاني، يا ٻنهي جي ضرورت آهي. تياري وارا مرحلا ان جي بدران تصديق ٿيل نتيجا ۽ آرٽيفيڪٽ رسيدون رکن ٿا؛ اهي اهو ظاهر نٿا ڪن ته عمل درآمد ٽيسٽ هليا هئا. هڪ ڪمانڊ صرف تڏهن ڪامياب ٿئي ٿو جڏهن ان جي اصل نڪرڻ واري حيثيت ۽ پنهنجي پروسيس جي صفائي جي تصديق ڪئي وڃي. TDD لاءِ هڪ ريڊ چڪاس نفاذ ۽ گرين تصديق کان اڳ عام طور تي ناڪام ٿيڻ گهرجي؛ هڪ گم ٿيل ايگزيڪيوٽيبل يا ٽائيم آئوٽ صحيح ريڊ نتيجو نه آهي.

ڊفالٽ سرڪٽ بريڪر هڪ قدم تي ٽن ناڪام ڪوششن کان پوءِ يا مجموعي طور پنجاهه ڪوششن کان پوءِ روڪين ٿا. رڪاوٽ هڪ ڪوشش کي استعمال ڪري ٿي پر اها پاڻ ناڪام ڪوشش طور شمار نٿي ٿئي. حدون ۽ مڪمل ٿيل ثبوت ٻيهر شروع ٿيڻ تي به باقي رهن ٿا؛ ٻيهر ڪوشش ڪريو انهن کي ري سيٽ نٿو ڪري. ٻي ڪوشش جي اجازت ڏيڻ کان اڳ برقرار رکيل ناڪامي پڙهو.

لاڳاپيل هدايتون: تصديق ۽ نظرثاني.

متوازي نظرثاني ٽيمون ۽ رپورٽ آرڪيٽيڪٽ

سيٽنگس → نظرثاني ٽيمون کوليو ۽ هڪ ٽيم محفوظ ڪريو. آزاد نظرثاني ڪندڙ انهن جي پنهنجي CLI يا API، ماڊل، دليل سازي ڪوشش ۽ مهارت سان شامل ڪريو، پوءِ هڪ رپورٽ آرڪيٽيڪٽ چونڊيو. ٽاسڪ جي نظرثاني ڪنفيگريشن ۾ ٽيم چونڊيو. هڪ ايگزيڪيوٽر پريسيٽ پڻ هڪ نظرثاني ڪندڙ پاران استعمال ٿي سگهي ٿو، ۽ ڪسٽم دستياب رهي ٿو؛ آزاد ڪردار اڃا به الڳ حوالا رکن ٿا.

مبصر ساڳئي ٽاسڪ جي ثبوت تي متوازي طور هلن ٿا. هر گهربل رپورٽ، غلطي ۽ فيصلو برقرار رکيو وڃي ٿو. آرڪيٽيڪٽ مبصرن جي نالن، ماڊل يا فراهم ڪندڙ جي سڃاڻپ، اصل ٽاسڪ جي مواد، ريپوزٽري جي رسائي يا اوزارن کان سواءِ گمنام نمبر واريون رپورٽون وصول ڪري ٿو. اهو رپورٽن جو مقابلو ڪري ٿو ۽ هڪ منظم فيصلو واپس ڪري ٿو؛ اهو سورس جو نئون جائزو نٿو وٺي.

هڪ رڪاوٽ واري دريافت يا گهربل مبصر جي رد عمل کي اڪثريتي راءِ يا آرڪيٽيڪٽ جي ترجيح ذريعي معاف نٿو ڪري سگهجي. گم ٿيل يا غلط نموني جون رپورٽون منظوري کي روڪين ٿيون. قبول ڪرڻ يا سڌارن جي اجازت ڏيڻ کان اڳ انفرادي نتيجن ۽ مجموعي فيصلي جي چڪاس ڪريو. محفوظ ڪيل ٽيم هلائڻ لاءِ مقرر ۽ منجمد آهي؛ ان جي پريسيٽ ۾ ترميم مڪمل ٿيل ثبوت کي ٻيهر نٿي لکي.

رڳو-رپورٽ آرڪيٽيڪٽ في الحال سهڪار يافته Claude يا API ٽول-فري ترتيبون استعمال ڪري ٿو. Codex ۽ Antigravity مبصر طور دستياب رهن ٿا پر هن الڳ آرڪيٽيڪٽ ڪردار لاءِ ان وقت تائين رد ڪيا ويا آهن جيستائين هڪ تصديق ٿيل ٽول-فري معاهدو موجود نه هجي. رڳو هڪ پرامپٽ جنهن ۾ ”ڪي به اوزار نه آهن“ چيل هجي ڪافي ناهي.

لاڳاپيل هدايتون: ٽائپ ٿيل ٽيم ڪنفيگريشن · نظرثاني گڏ ڪرڻ.

ايجنٽ جون مهارتون ۽ پرامپٽ پاليسي

هڪ ماڊل عملدرآمد جو انجن آهي؛ هڪ مهارت هدايتي پروفائل آهي. بغير ڪنهن شامل ڪيل مهارت لاءِ ڪوبه نه چونڊيو، ڊفالٽ گائيڊ لاءِ معياري، لاڳاپيل بلٽ ان گائيڊ لاءِ Auto، يا چونڊيل گائيڊز ۽ پنهنجي محدود هدايتن لاءِ مينوئل چونڊيو. پريسيٽس چونڊ برقرار رکي سگهن ٿا.

اصل ڪيٽلاگ عام ڪوڊنگ، آرڪيٽيڪچر، سيڪيورٽي، اعتبار، ڪارڪردگي، ٽيسٽنگ ۽ انٽرفيس استعمال پذيري کي ڍڪي ٿو. Auto گائيڊ چونڊڻ لاءِ دستياب ٽاسڪ/قدم متن استعمال ڪري ٿو؛ اهو ڳجهي طور تي ٻئي ماڊل کي ڪال نٿو ڪري يا ماهر هجڻ جي تصديق نٿو ڪري. عمل درآمد جي منصوبي کي قبول ڪرڻ کان اڳ منصوبابندي جي تجويزن جي چڪاس ۽ تبديلي ڪري سگهجي ٿي.

نظرثاني جون مهارتون ڌيان ڇڪائڻ ۾ مدد ڪن ٿيون پر ڪڏهن به آزاد ثبوت، رسائي جي حدن يا منظم فيصلي جي جاءِ نٿيون وٺن. ڪسٽم هدايتن کي ٽاسڪ جي گنجائش جو حصو سمجهو: انهن کي دستاويز جي قبوليت، ٽول پاليسي، تصديق يا مبصر جي ناڪامين کي نظرانداز ڪرڻ لاءِ استعمال نه ڪريو.

لاڳاپيل هدايتون: اصل پرامپٽ ڪيٽلاگ.

Work: سوال کان دستاويز تائين

Work کي Git جي ضرورت ناهي. ڊفالٽ هڪ الڳ ٽاسڪ فولڊر ٺاهي ٿو؛ ڪسٽم مقامي چونڊيندڙ ذريعي موجود فولڊر کي چونڊي ٿو. مسودو محفوظ ڪريو بغير انفرنس جي سيٽنگون ذخيرو ڪري ٿو؛ شروع ڪريو پهريون مرحلو هلائي ٿو.

Auto سڌو سنئون جواب ڏئي ٿو يا حقيقي ٽو-ڊوز سان هڪ مناسب منصوبو تجويز ڪري ٿو. برين اسٽارم ideas.md ٺاهي ٿو ان کان اڳ جو توهان وڌيڪ خيال يا تشخيص چونڊيو. ريسرچ findings.md، ذريعا ۽ حدون برقرار رکي ٿي. لکو مقصد کان ۽، جڏهن مفيد هجي، outline.md کان تفصيلي دستاويز يا draft.md ڏانهن وڌي ٿو؛ ترميمون اڳوڻن ورزن کي برقرار رکن ٿيون.

مقامي چونڊيندڙ ذريعي فائل انپٽس چونڊيو ۽ انهن جو حوالو @ سان ڏيو. ايپ انهن کي اڻ بدليل ٽاسڪ انپٽس طور ڪاپي ڪري ٿي ۽ هلڻ کان اڳ انهن جي سڃاڻپ جي تصديق ڪري ٿي. ڊفالٽ هڪ ايپليڪيشن جي ملڪيت وارو ٽاسڪ فولڊر ٺاهي ٿو؛ ڪسٽم فولڊر تائين پهچ هڪ محفوظ ڪيل مالڪ جي اجازت آهي. هڪ محفوظ ڪيل، اڻ شروع ٿيل مسودو پنهنجو فولڊر تبديل ڪري سگهي ٿو.

آزاد ايگزيڪيوٽر سيٽنگن سان 1–4 ڪاپيون ٺاهيو. اوورليپنگ فولڊر استعمال ڪندڙ ٽاسڪ هڪ ئي وقت نٿا لکي سگهن. هي تعاون ZIAForge آپريشنز تي لاڳو ٿئي ٿو، نه ڪي ٻاهرين نامعلوم پروگرامن تي.

ڊيپ برين اسٽارم ڊفالٽ طور ٽي آزاد ڪارڪن مقرر ڪري ٿو ۽ اٺ تائين سهڪار ڪري ٿو. انهن جي ترتيب ۽ ترتيبون چونڊيو، جنهن ۾ الڳ حوالي سان هڪ پريسيٽ جو ٻيهر استعمال شامل آهي. ورڪر جا سوال پنهنجي اصل کي برقرار رکن ٿا؛ خراب نموني رپورٽن کي هڪ فارميٽ جي مرمت جي ڪوشش ملي ٿي. جزوي ناڪامي متفقه ڪاميابي طور پيش ڪرڻ بدران واضح رهي ٿي.

ڊيپ برقرار رکيل ورڪر رپورٽن کي brainstorm_report.md ۾ گڏ ڪري ٿو ۽ هميشه صارف جي فيصلي لاءِ پڇي ٿو. هڪ ننڍو فالو اپ ڪوآرڊينيٽر ذريعي رپورٽ تي نظرثاني ڪري ٿو؛ هڪ وڏي تبديلي منجمد ڪارڪنن جو ٻيو دور شروع ڪري ٿي. آرٽيفيڪٽس پنهنجا ورزن رکن ٿا.

مقرر ڪيل ڪردار ٽاسڪ ٺاهڻ يا مسودي جي واضح بچت تي منجمد ٿين ٿا. پهرين ڪال کان پوءِ، صرف پاڻمرادو/دستي پيش رفت تبديل ٿي سگهي ٿي؛ مختلف ڪردار يا ماڊل سيٽنگن لاءِ نئون ٽاسڪ استعمال ڪريو. عالمي پريسيٽ ۾ ترميم ڪرڻ بعد وارن مرحلن کي خاموشيءَ سان تبديل نٿو ڪري.

مينوئل موڊ اهل مرحلن جي وچ ۾ روڪي ٿو، جنهن ۾ هڪ اهم رائيٽ آئوٽ لائن شامل آهي. Auto انهي آئوٽ لائن ذريعي جاري رهي سگهي ٿو. سوال، تجويز ڪيل قابل عمل منصوبا، برين اسٽارم هدايت ۽ ڊيپ رپورٽ جو جائزو Auto ۾ به واضح فيصلا رهن ٿا. صرف هڪ حوالو اهو ثابت نٿو ڪري ته برائوزنگ ٿي هئي، ۽ صرف هڪ برقرار رکيل بائنري فائل ان جي رينڊرنگ کي ثابت نٿي ڪري.

لاڳاپيل هدايتون: Work موڊز ۽ فيصلا.

پريسيٽس، ماڊلز ۽ پهچ

هڪ پريسيٽ CLI/API، ماڊل، دليل سازي ڪوشش ۽ اجازت ناما محفوظ ڪري ٿو. چيٽ جي فوٽر ۾ پريسيٽ، CLI، ماڊل ۽ آپشنز جا حصا آهن. ڪسٽم پريسيٽ کانسواءِ ڪم ڪري ٿو؛ پريسيٽ ٺاهيو موجوده چونڊ کي محفوظ ڪري ٿو.

ڪيٽلاگ چونڊيل انسٽال ٿيل CLI يا API مان اچي ٿو جتي اها سپورٽ هجي. ريفريش چونڊ کي تبديل ڪرڻ کان سواءِ لسٽ کي اپڊيٽ ڪري ٿو. جيڪڏهن دريافت دستياب نه آهي، هڪ واضح ماڊل ID داخل ڪريو؛ فراهم ڪندڙ کي اڃا به ان جي حمايت ڪرڻ گهرجي. دليل سازي جون سطحون ماڊل ۽ CLI تي ڀاڙين ٿيون. فراهم ڪندڙ جو ڊفالٽ واضح none ٽوڪن کان مختلف آهي.

تبديليون رڳو بئڪ اينڊ جي مڃتا کان پوءِ لاڳو ڪريو. فعال واري يا غير خالي قطار دوران تبديلي محدود آهي. مسودا ۽ ڏسڻ ۾ ايندڙ تاريخ برقرار رهن ٿا، پر فراهم ڪندڙن کي تبديل ڪرڻ انهن جي خانگي اندروني حالت کي منتقل نٿو ڪري.

Forge ۾، ڪردار جو ليبل اهميت رکي ٿو: تياري هڪ الڳ پلانر استعمال ڪري سگهي ٿي. فوٽر ڏيکاريل ڪردار کي تبديل ڪري ٿو؛ مبصر ۽ مددگار ورڪ فلو سيٽنگن ۾ چونڊيا ويا آهن. اڳ ۾ تصديق ٿيل نفاذ لاءِ پاليسي لاڪ ٿي سگهي ٿي.

اجازت ناما فراهم ڪندڙن جي وچ ۾ مختلف هوندا آهن. رڳو پڙهو ۽ ورڪ اسپيس لکو دستياب آهن جتي اڊاپٽر انهن جي حمايت ڪري ٿو. Antigravity مقامي CLI سيٽنگون يا واضح طور تي چونڊيل مڪمل پهچ استعمال ڪري ٿو. مڪمل پهچ هڪ سينڊ باڪس ناهي.

مهارت پرامپٽ جي رهنمائي شامل ڪري ٿي، نه ڪو ٻيو ماڊل يا اجازت نامو. پريسيٽس ۽ ڪردار ڪوبه نه، معياري، Auto ۽ مينوئل جي حمايت ڪن ٿا. Auto اضافي ماڊل ڪال کانسواءِ قدم واري متن مان پروفائلز چونڊي ٿو؛ مينوئل چار خاصيتن ۽ ڪسٽم هدايتن تائين قبول ڪري ٿو. پلانر پاران تجويز ڪيل تفويضن کي منصوبي کي قبول ڪرڻ کان اڳ ترميم ڪري سگهجي ٿو.

دستي طور تي داخل ٿيل ماڊل ID يا ڪوشش توهان جي چونڊ رهي ٿي، پر فراهم ڪندڙ ان کي رد ڪري سگهي ٿو. عالمي پريسيٽ ۾ ترميم ڪرڻ هلندڙ چيٽ يا قبول ٿيل منصوبي کي اڳوڻي اثر سان تبديل نٿو ڪري. بيڪار گفتگو کي ڄاڻي واڻي تبديل ڪرڻ لاءِ، ان جا پنهنجا ڪنفيگريشن ڪنٽرول استعمال ڪريو ۽ مڃتا جو انتظار ڪريو. هڪ غير فعال آپشن کي صلاحيت يا لائف سائيڪل جي حد طور پڙهڻ گهرجي، محفوظ ڪيل JSON ۾ ترميم ڪري ان کي نظرانداز نه ڪيو وڃي.

لاڳاپيل هدايتون: فراهم ڪندڙ صلاحيتون.

چيٽس، روڪيو ۽ قطار

کليل ٽيب، تازو ۽ مسودا هڪ ئي ٽاسڪ جا حصا آهن. هڪ ٽيب کي بند ڪرڻ ان کي کليل مان هٽائي ٿو پر تازو ۾ محفوظ رکي ٿو ۽ ان جي فراهم ڪندڙ عمل يا سنڀاليل ورڪ فلو کي نٿو روڪي. تاريخ ڳوليو، چيٽ ٻيهر کوليو يا تاريخ مينيو مان سڀ اضافي ٽيب بند ڪريو.

روڪيو موجوده واري کي روڪي ٿو. ايندڙ موڪليو کان اڳ روڪڻ جي عمل مڪمل ٿيڻ جو انتظار ڪريو: مداخلت جو اعتراف پروسيس مڪمل ٿيڻ نه آهي. توهان ان دوران ايندڙ مسودو لکي سگهو ٿا.

عام چيٽ ۾، قطار بعد جي درخواست کي موجوده مسودي کان الڳ محفوظ ڪري ٿي. قطار رکو اڳتي ترسيل کي روڪي ٿو. روڪيو ۽ ٻاهر نڪرو قطار کي روڪين ٿا. ٻيهر شروع ڪرڻ کان پوءِ، پهريان بحال ڪريو، پوءِ واضح طور تي قطار جاري رکو.

غير يقيني جو مطلب آهي ته ترسيل نامعلوم آهي. اهڙو پيغام پاڻمرادو ٻيهر نه موڪليو ويندو آهي: تاريخ چيڪ ڪريو، جيڪڏهن مناسب هجي ته متن ڪاپي ڪريو ۽ قطار ڪيل شي کي خارج ڪريو. ان کي ٻيهر موڪلڻ هڪ نئين سوچيل سمجهيل درخواست آهي.

منظم ڪيل فيز چيٽس پنهنجو ورڪ فلو استعمال ڪن ٿيون، نه ڪي عام قطار. اسٽيج جي پيروي موجوده مرحلي کي ڏيکاري ٿو؛ دستي طور ٻيو ٽيب چونڊڻ پيروي ڪرڻ بند ڪري ٿو. CLI لاگز جواب کان الڳ تشخيص ڏيکارين ٿا.

مارڪ ڊائون جواب عنوان، لسٽون، جدول، لنڪس ۽ ڪوڊ بلاڪس ڏيکارين ٿا. ٽول ڪارڊ ۽ CLI تشخيص جواب کان الڳ رهن ٿا. ماڊل پاران رپورٽ ڪيل سوچ ۽ ٽوڪن ميٽرڪس صرف تڏهن ظاهر ٿين ٿا جڏهن فراهم ڪندڙ اصل ۾ انهن کي ظاهر ڪري؛ اينيميشن مان پرائيويٽ دليل سازي يا استعمال جو اندازو نه لڳايو.

غير يقيني موڪل يا قطار جي وصولي کان پوءِ، تاريخ چيڪ ڪريو ۽ جتي پيشڪش هجي رڳو ساڳي برقرار رکيل درخواست کي ٻيهر ڪوشش ڪريو. قطار جي رسيد جو مطلب آهي ته اسٽوريج شي کي قبول ڪيو آهي، اهو نه ته انفرنس مڪمل ٿي ويو آهي. غير يقيني قطار ٿيل شي کي رڳو واضح برطرفي طور هٽايو؛ اهو پهريان کان پهچايو ويو پرامپٽ واپس نٿو وٺي سگهي.

لاڳاپيل هدايتون: پائيدار پيغام قطار.

فائلون، Git ۽ مڪمل ٿيڻ

فائلون ٽاسڪ فولڊر ڏيکاري ٿو. نتيجن کي ضرورتن سان ڀيٽيو، دستاويز کوليو ۽ فرقن جي چڪاس ڪريو. هڪ بائنري فائل کي برقرار رکڻ ان جي ٽارگيٽ ايپليڪيشن ۾ درست رينڊرنگ جو ثبوت نه آهي.

Git رڪارڊ ٿيل نتيجن سان حيثيت، تبديليون ۽ آپريشن مهيا ڪري ٿو. ڪمٽ، مرج ۽ پُش ڊفالٽ طور دستي آهن؛ پاڻمرادو آپريشنز هڪ مڪمل تصديق ٿيل منصوبي لاءِ الڳ چونڊون آهن.

تصديق ۽ اشاعت جي وچ ۾ ڪم ڪندڙ فائلن کي تبديل نه ڪريو: منظوري صحيح بائيٽس سان ڳنڍيل آهي. تضاد، ناڪام پُش ۽ نامعلوم آپريشن جا نتيجا ترقي کي روڪين ٿا جيستائين هڪ واضح فيصلو نه ڪيو وڃي. Auto خاموشيءَ سان شايع ڪرڻ جي اجازت نٿو ڏئي.

Work ڪي به Git برانچون پيدا نٿو ڪري ۽ ان جي ڪا به Git حتمي صورت نه آهي. چونڊيل فولڊر مان گهربل دستاويز رکو، جن ۾ ورزن ۽ ذريعا شامل آهن.

فائل ايڊيٽر ايڪسٽينشن ذريعي نحو، ڳولا ۽ مٽاسٽا، اڻ ٺاهيل تاريخ، قطار ويڙهڻ ۽ في ٽيب مسودا مهيا ڪري ٿو. بچت سهڪار رکندڙ UTF-8/UTF-16 انڪوڊنگ کي محفوظ ڪري ٿي ۽ ٻاهرين ترميم جي تضادن کي رد ڪري ٿي. ٻين انڪوڊنگن ۽ بائنري مواد کي ٻاهرين ايڊيٽر جي ضرورت آهي. اڻ محفوظ مسودا ايپليڪيشن کي نڪرڻ کان روڪين ٿا جيستائين مالڪ انهن کي محفوظ يا خارج نه ڪري.

مڪمل نحو 8 MiB تائين فعال آهي. وڏيون ٽيڪسٽ فائلون 256 KiB ونڊوز ۾ کليون ٿيون؛ 8–64 MiB بنا نحو جي واضح طور مڪمل لوڊ ٿي سگهن ٿيون. 64 MiB کان مٿي ونڊو ايڊيٽنگ ۽ محدود ايندڙ ميچ ڳولا استعمال ڪريو. هي هڪ محدود وڏي فائل موڊ آهي، نه ڪي من ماني وڏن دستاويزن لاءِ Sublime Text جي برابري.

فولڊر کوليو رڳو خاموشيءَ سان اصل مخزن کولڻ بدران موجوده ٽاسڪ يا برانچ/ورڪ ٽري حوالو استعمال ڪري ٿو. هڪ فائل قطار ان فائل جي پيرنٽ ڊائريڪٽري کي ظاهر ڪري سگهي ٿي. رستا بئڪ اينڊ پاران رجسٽر ٿيل ٽاسڪ گرانٽس جي مقابلي ۾ چڪاسيا وڃن ٿا. بائنري فائلون سادي متن وانگر ايڊٽ ڪرڻ لائق نه آهن؛ انهن جو ٽارگيٽ ڏسندڙ استعمال ڪريو ۽ اصل بائيٽس برقرار رکو.

ورڪ ٽري هٽائڻ هڪ الڳ محفوظ ڪيل عمل آهي. ان کي هٽائڻ کان اڳ ڳنڍيل منظم سيشن ۽ ٽرمينل ختم ڪريو، بشمول اهي سيشن جيڪي بيڪار آهن. محفوظ ڪيل Git نتيجي ۽ بحالي واري حالت جي چڪاس ڪريو؛ ٽاسڪ رڪارڊ کي ڊليٽ ڪرڻ غير ڪمٽ ٿيل ڪم کي محفوظ طريقي سان برقرار رکڻ جو متبادل ناهي.

لاڳاپيل هدايتون: ٽائپ ٿيل ايڊيٽر معاهدو · Git پاليسيون.

API ڪنيڪشنز

ڪنيڪشنز واضح طور تي چونڊيل OpenAI سان مطابقت رکندڙ اينڊپوائنٽ شامل ڪري ٿو. هڪ نالو، بنيادي URL، ماڊل، ۽ ضرورت پوڻ تي هڪ ڪنجي داخل ڪريو. ڪيترن ئي سرورن کي اهڙي بنيادي URL جي ضرورت هوندي آهي جيڪا /v1 تي ختم ٿئي؛ پنهنجي اينڊپوائنٽ دستاويزن جو مطالعو ڪريو.

لوپ بيڪ HTTP کانسواءِ HTTPS لازمي آهي. URL اندر لڪيل سڃاڻپ کانسواءِ هڪ سادو اينڊپوائنٽ استعمال ڪريو. ڪنجيون سهڪار رکندڙ OS انڪرپشن استعمال ڪن ٿيون ۽ UI ڏانهن واپس نه موڪليون وينديون آهن. اينڊپوائنٽ تبديل ڪرڻ تي ان جي ڪنجي ٻيهر داخل ڪرڻ ضروري آهي. ڪنجي واري خاني کي خالي ڇڏڻ سان محفوظ ٿيل ڪنجي قائم رهي ٿي؛ محفوظ ڪيل ڪنجي هٽايو ان کي واضح طور تي ختم ڪري ٿو.

API ڪالون CLI سبسڪرپشن استعمال نٿيون ڪن. اوزار ۽ ماڊل مقامي سيشنز کان مختلف هوندا آهن، ۽ ڪامياب ماڊل دريافت انفرنس جو ثبوت ناهي. ٽوڪن جو استعمال صرف تڏهن ظاهر ٿئي ٿو جڏهن فراهم ڪندڙ اصل ۾ ان کي واپس موڪلي.

سڃاڻپ جا تفصيل ٽاسڪ جي متن يا پريسيٽ هدايتن بدران ڪنيڪشنز ۾ رکو. صرف-پڙهڻ وارا مبصر رڳو پنهنجا مجاز API فائل اوزار وصول ڪن ٿا؛ رپورٽ آرڪيٽيڪٽ وٽ ڪي به اوزار نه هوندا آهن. غير سهڪار يافته ٽول ڪالز خاموشيءَ سان هلڻ بدران رد ٿي وينديون آهن. سرور دليل سازي پيرا ميٽرز، ٽول سپورٽ، ۽ ماڊل لسٽنگ ۾ مختلف ٿين ٿا؛ غلطي کي پنهنجي اينڊپوائنٽ جي پنهنجي معاهدي سان ڀيٽيو.

لاڳاپيل هدايتون: API ڪنيڪشنز.

سيٽنگون، ٻوليون ۽ محفوظ ري سيٽ

عام سيٽنگون ورڪ اسپيس، انٽرفيس ٻولي ۽ ڊفالٽ چونڊينديون آهن. ڪنيڪشنز API اينڊپوائنٽس کي منظم ڪري ٿو. پريسيٽس ۽ نظرثاني ٽيمون ڪردار جي ڪنفيگريشن کي برقرار رکن ٿيون. ريموٽ ڪنٽرول مقامي سڃاڻپ، سرور جي گنجائش ۽ مالڪ جي اجازت نامن کي منظم ڪري ٿو؛ اپڊيٽس رليز جو ذريعو/چينل سنڀالي ٿو. ائباؤٽ هلندڙ بلڊ جي صحيح سڃاڻپ ڏيکاري ٿو.

انٽرفيس جي ٻولي پرامپٽ جي ٻولي ۽ دستاويزن جي نظرثاني واري حيثيت کان الڳ آهي. پراڊڪٽ جا نالا، ڪمانڊ آئي ڊيز، فائيل ايڪسٽينشنز، فراهم ڪندڙ ماڊل آئي ڊيز ۽ واپرائيندڙ پاران ٺاهيل نالا سڃاڻپ ڪندڙ طور ئي رهن ٿا. جڏهن موجوده ترجمو موجود هجي ته مدد (Help) چونڊيل انٽرفيس ٻوليءَ تي عمل ڪري ٿي؛ مشين سان ٿيل ترجمن تي ليبل لڳايو وڃي ٿو ۽ انگريزي ئي مستند حوالو رهي ٿي.

Save کليل ترتيب کي لاڳو ڪري ٿو. ڊيٽابيس ريسيٽ يا فيڪٽري ريسيٽ ايپليڪيشن جو ميٽا ڊيٽا هٽائي سگهي ٿو؛ ڄاڻي واڻي ريسيٽ استعمال ڪرڻ کان اڳ فائلن ۽ هڪ آزمايل بيڪ اپ کي محفوظ رکو. اهي آپريشنز مقامي مالڪ جا عمل آهن. ڪنهن ناڪام ورڪ فلو يا خراب ٿيل رڪارڊ جي جاچ پڙتال لاءِ انهن کي شارٽ ڪٽ طور استعمال نه ڪريو.

لاڳاپيل هدايتون: مقامي بنائڻ جون هدايتون · ڊيٽا جي بحالي.

مدد واري اسسٽنٽ کان پڇو

مدد (Help) کوليو، ان جي اسسٽنٽ پينل ۾ هڪ محفوظ ڪيل ڳنڍيل پريسيٽ چونڊيو ۽ ZIAForge بابت پڇو. جواب موجوده مستند انگريزي گائيڊ ۽ توهان جي چونڊيل انٽرفيس ٻولي استعمال ڪن ٿا. سيڪشن ريفرنس جا بٽڻ لاڳاپيل عنوان کولي ڇڏين ٿا، ته جيئن توهان وضاحت جو اصل حوالي سان مقابلو ڪري سگهو.

هي مددگار 100 محفوظ ڪيل اندراجن ۽ 3 MiB تائين هڪ الڳ خانگي گفتگو رکندو آهي. 12,000 اکرن تائين جو سوال لکو؛ Send سوال پڇي ٿو، Stop توهان جي سوال کي موجود رکندي فعال جواب رد ڪري ٿو، ۽ Clear هيءَ مدد جي گفتگو هٽائي ٿو. توهان جو اڻ موڪليل ڊرافٽ ۽ پريسيٽ چونڊ ساڳئي ايپ سيشن ۾ مدد کولڻ يا بند ڪرڻ بعد به محفوظ رهن ٿا، پر ڊرافٽ ڊسڪ تي محفوظ نٿو ٿئي. اسسٽنٽ ايپليڪيشن ڪمانڊون نٿو موڪلي، ورڪ فلو کي نٿو تبديل ڪري يا ڪو گيٽ منظور نٿو ڪري. مليل مشورو ڪنهن ڪم، اڪائونٽ يا ٻاهرين ڪنيڪشن جي لائيو تصديق ناهي.

Claude Code ۽ API مدد جا سيشن سپورٽ ٿيل نو-ٽولز (no-tools) پاليسي لاڳو ڪن ٿا. مقامي Codex ۽ Antigravity مدد سيشنز لاءِ مقامي مالڪ وٽ اڳ ئي موجود نيٽو ڪمپيوٽر جي اجازت هجڻ لازمي آهي. جيڪڏهن اها بند آهي، ته ايپ ڪنهن ٻئي فراهم ڪندڙ کي چونڊڻ بدران اڳواٽ شرط جي وضاحت ڪري ٿي. رڳو مالڪ ان کي مقامي ڪنٽرول سيٽنگز ۾ فعال ڪري سگهي ٿو؛ مددگار پاڻ ان کي فعال نٿو ڪري سگهي.

Codex مدد ريڊ-اونلي سينڊ باڪس استعمال ڪري ٿي ۽ ٽول-اپروول جي درخواستن کي رد ڪري ٿي. Antigravity پلان موڊ ۽ پنهنجو نيٽو سينڊ باڪس فليگ استعمال ڪري ٿو. اهي نيٽو موڊز آپريٽنگ سسٽم جي قيد جي عالمگير ضمانت نه آهن. سورس-گائيڊ هيش جواب لاءِ استعمال ڪيل حوالي جي سڃاڻپ ڪري ٿو؛ هڪ پيدا ڪيل وضاحت اڃا به غلط ٿي سگهي ٿي، تنهنڪري عمل ڪرڻ کان اڳ ان جي لنڪ ٿيل سيڪشنز جو معائنو ڪريو. پراڻن جوابن تي نشان لڳايو ويندو آهي جڏهن انهن جو سورس-گائيڊ ورزن موجوده گائيڊ کان مختلف هوندو آهي.

لاڳاپيل هدايتون: مستند گائيڊ ۽ ترجمي جي سار سنڀال · ايپليڪيشن اسسٽنٽ ۽ اجازت ناما.

مددگار ۽ Telegram

مددگار چونڊيل پريسيٽ ۽ ساڳئي ايپليڪيشن ڪنٽرول API کي استعمال ڪري ٿو. حالت جو معائنو ڪرڻ جي اجازت ۽ آپريشنز انجام ڏيڻ جي اجازت الڳ الڳ آهن. ڪمانڊن ۽ نتيجن جو معائنو ڪريو: مددگار جو بيان ڪيل متن ڪنهن عمل جي مڪمل ٿيڻ جو ثبوت ناهي.

Telegram صرف مقامي مالڪ پاران فعال ڪيو ويندو آهي، جنهن لاءِ هڪ موجود بوٽ ٽوڪن ۽ هڪ عددي مالڪ ID گهربل آهي. ڪنٽرول انهي مالڪ جي ذاتي چيٽ لاءِ آهي. هڪ اڻ ترتيب ڏنل يا غير فعال بوٽ کي ايپليڪيشن جا پيغام نه ملڻ گهرجن.

بوٽ ٽوڪن کي عام چيٽ ۾ پيسٽ نه ڪريو. انضمام کي ترتيب ڏيڻ سان Telegram ڪنيڪشن جو ثبوت نٿو ملي ۽ نه ئي اهو پاڻمرادو بوٽ ٺاهي ٿو. اسڪرين شاٽس ۽ جوابن ۾ ورڪ اسپيس جو خانگي ڊيٽا شامل ٿي سگهي ٿو.

هڪ مددگار پريسيٽ چونڊيو ۽ ايپليڪيشن آپريشن جي اجازت معائني کان الڳ ڏيو. Codex ۽ Antigravity مددگار هلائڻ لاءِ مالڪ جي مقامي ڪمپيوٽر اجازت جي ضرورت آهي؛ اهي بغير اوزار واري API يا Claude سيشن سان خاموشي سان تبديل نٿا ڪيا وڃن. اسڪرين شاٽس مددگار جي گفتگو ۾ ڏيکاري سگهجن ٿا، پر موجوده ماڊل ان پٽ ۾ تصوير جو تجزيو شامل ناهي. صرف ان ڪري مددگار پاران تصوير جو معائنو ڪرڻ جو گمان نه ڪريو جو ان اها ڏيکاري هئي.

مددگار ٽائپ ٿيل اوزارن ذريعي خلاصن، ڪمن، چيٽس، ورڪ فلو حالت، پروسيس پس منظر ۽ ايپليڪيشن ونڊوز جو معائنو ڪري سگهي ٿو. اهو اجازت ڏنل عام سيٽنگز تبديل ڪري سگهي ٿو ۽ مجاز ايپليڪيشن آپريشنز شروع ڪري سگهي ٿو. اهو مقامي حق نٿو ڏئي سگهي، محفوظ ڪيل سڃاڻپ جا تفصيل نٿو پڌرا ڪري سگهي، روٽ ورڪ اسپيس جي اجازت دور دراز کان تبديل نٿو ڪري سگهي يا رڳو سهولت خاطر Forge گيٽ کي منظور نٿو ڪري سگهي.

لاڳاپيل هدايتون: ايپليڪيشن ڪنٽرول معاهدو.

پنهنجو ذاتي Telegram بوٽ هلايو

پنهنجو بوٽ ٺاهيو يا حاصل ڪريو، ان جي خانگي چيٽ شروع ڪريو، ۽ ان جو ٽوڪن ۽ پنهنجي عددي Telegram واپرائيندڙ جي ID مقامي ڪنٽرول سيٽنگز ۾ داخل ڪريو. انضمام کي رڳو تڏهن فعال ڪريو جڏهن توهان جو ارادو ايپ کي ڪنيڪٽ ڪرڻ جو هجي. مالڪ جي ID واپرائيندڙ جي سڃاڻپ آهي، نه ڪي ڪو واپرائيندڙ نالو يا بوٽ جي ID. صرف انهي ساڳئي خانگي چيٽ مان انهي واپرائيندڙ جا موڪليل پيغام قبول ڪيا وڃن ٿا.

هلندڙ ورزن، پروجيڪٽ/ٽاسڪ جي ڳڻپ ۽ ٽاسڪ جي حالتن جو جائزو وٺڻ لاءِ /start، /menu يا /status استعمال ڪريو. بٽڻ پروجيڪٽس، ٽاسڪس، اسڪرين شاٽ، مدد ۽ ٻولي کولين ٿا. لسٽون هر صفحي تي اٺ شيون ڏيکارين ٿيون، جن ۾ پوئتي، ريفريش، هوم ۽ اڳيان/پوئتي جي نيويگيشن موجود آهي. پروجيڪٽ جا بٽڻ ٽاسڪ لسٽ کي فلٽر ڪن ٿا. هڪ ٽاسڪ ڪارڊ ان جي محفوظ ڪيل ورڪ فلو پيش رفت، ماڊل/پريسيٽ ۽، جيڪڏهن هجن ته، التوا ۾ پيل سوال ڏيکاري ٿو.

کليل/تازيون گفتگوئون ۽ ورڪ فلو مرحلي جون چيٽس ڏسڻ لاءِ ڪم جون چيٽس کوليو. هر پريويو ڇهه تازا ترين واپرائيندڙ/مددگار پيغام ڏيکاري ٿو، جيڪي واضح طور تي هر هڪ 200 اکرن تائين مختصر ڪيل آهن. ذاتي سوچ (reasoning) نٿي ڏيکاري وڃي. هسٽري پڙهڻ سان فراهم ڪندڙ شروع نٿو ٿئي. پريويوز رڳو پڙهڻ لاءِ آهن: عام متن ۽ /ask TEXT اڃا به ايپليڪيشن اسسٽنٽ کي مخاطب ڪن ٿا، نه ڪڏهن اڻ سڌي طرح ان ٽاسڪ چيٽ کي جنهن کي توهان ڏسي رهيا آهيو.

Run / Continue موجوده Code يا Work ورڪ فلو کي ٻيهر پڙهي ٿو ۽ اهل محفوظ ڪيل ورڪ فلو شروع ڪري ٿو. Pause ان کي روڪڻ جي درخواست ڪري ٿو. انهن مان ڪو به گهرجن، وضاحت، رٿا، نظرثاني جا نتيجا يا سوال قبول نٿو ڪري؛ التوا ۾ پيل فيصلو هلائڻ کي روڪي ٿو. فيصلا ايپليڪيشن ۾ ڪريو، يا پنهنجي صحيح موجوده گيٽ ۽ نظرثاني سان واضح طور مجاز ٽائپ ٿيل ڪمانڊ استعمال ڪريو.

56 انٽرفيس ٻولين مان ڪا به ٻولي ان جي مقامي نالي سان چونڊڻ لاءِ Language يا /language استعمال ڪريو. هي ترجيح صرف هن بوٽ ۽ مالڪ لاءِ برقرار رهي ٿي. Use app language ان ترجيح کي ختم ڪري ٿو. اهو نه ايپليڪيشن جي ٻولي تبديل ڪري ٿو ۽ نه ئي رسائي جا اجازت ناما؛ اڳ موجود پيغام پاڻمرادو ٻيهر نٿا موڪليا وڃن.

نيويگيشن عام طور تي ساڳئي شايع ٿيل مينيو پيغام کي اپڊيٽ ڪري ٿي. بٽڻن جون اڻ پڌريون سڃاڻپون هونديون آهن جيڪي 15 منٽن کان پوءِ ختم ٿي وينديون آهن ۽ هڪ ڀيرو استعمال ٿي سگهن ٿيون؛ ڪارڊ تبديل ڪرڻ سان ان جا پراڻا بٽڻ باطل ٿي وڃن ٿا. ختم ٿيل، استعمال ٿيل، بي جوڙ پيغام وارا ۽ پوئين پروسيس جا بٽڻ ڪو عمل نٿا ڪري سگهن. مڪمل طور اڻ سڌري سگهندڙ پيغام نئين ڪارڊ سان تبديل ڪري سگهجي ٿو؛ اڻڄاتل نيٽ ورڪ خرابيءَ جي صورت ۾ نئين پيغام طور ٻيهر ڪوشش نٿي ڪئي وڃي.

فعال ٿيڻ تي پولر اڳوڻو رهيل ڪم ختم ڪري ٿو ۽ موڪلڻ کان اڳ اپڊيٽ جي قبوليت رڪارڊ ڪري ٿو ته جيئن مداخلت ٿيل ڪمانڊون وري شروع ٿيڻ تي پاڻمرادو ٻيهر نه هلن. هي ورجاءَ کي روڪي ٿو؛ اهو مڪمل ٿيڻ جي ضمانت نٿو ڏئي. ڪنهن خرابي کان پوءِ ڄاڻي واڻي نئون ڪم جاري ڪرڻ کان اڳ حيثيت/پس منظر چڪاسيو. ڪم جي حيثيت بابت پاڻمرادو اطلاع موجود نه آهن.

واضح ڪمانڊون دستياب رهن ٿيون: /projects، /tasks، /task TASK_ID، /run TASK_ID، /pause TASK_ID، /screenshot ۽ /ask TEXT. /new {JSON} ٽائپ ٿيل createTask ذريعي هڪ ڪم ٺاهي ٿو؛ /command {JSON} هڪ واضح ڪيٽلاگ ڪمانڊ موڪلي ٿو. دليلن جي بناوت پڙهڻ لاءِ لائيو ڪيٽلاگ ڏسو. ساڳي بيڪ اينڊ اٿارائيزيشن ۽ فولڊر جي اجازت لاڳو ٿئي ٿي جيڪا ايپليڪيشن ۾ آهي.

ايپ ڪڏهن به اسسٽنٽ کي محفوظ ڪيل بوٽ ٽوڪن جا ويليو نٿي موڪلي. ان هوندي به اسڪرين شاٽس، خلاصا ۽ گفتگو جو متن خانگي پروجيڪٽ جي معلومات تي مشتمل ٿي سگهن ٿا. جيڪڏهن بوٽ يا مالڪ جي اڪائونٽ تي وڌيڪ اعتبار نه رهي ته انضمام کي مقامي طور بند ڪريو. بوٽ فراهم ڪندڙ سان گڏ ليڪ ٿيل ٽوڪن کي تبديل ڪريو، پوءِ ان جي مقامي انڪرپٽ ٿيل ڪنفيگريشن کي اپڊيٽ ڪريو.

لاڳاپيل هدايتون: خانگي بوٽ ۽ ڪمانڊون.

صرف مالڪ واري مقامي ڪمپيوٽر جي اجازت

مقامي ڪمپيوٽر جي رسائي شروعات ۾ غير فعال هوندي آهي. صرف مالڪ ئي ان کي مقامي سيٽنگز → ريموٽ ڪنٽرول ۾ فعال ڪري سگهي ٿو. مددگار ۽ HTTP/MCP/Telegram ڪمانڊون پنهنجي لاءِ هي فليگ فعال نٿيون ڪري سگهن. جيڪڏهن ڪنهن آپريشن کان انڪار ڪيو وڃي، ته اسسٽنٽ کي گهرجي ته هو سيٽنگ جي وضاحت ڪري ۽ مالڪ کي فيصلو ڪرڻ ڏئي.

جڏهن واضح طور فعال ڪيو وڃي، ته computer.run هڪ ايگزيڪيوٽيبل، دليلن جي ايري (argument array) ۽ اختياري مطلق ڪم ڪندڙ ڊاريڪٽري قبول ڪري ٿو. اهو ڪا به شيل انٽرپوليشن استعمال نٿو ڪري، ان جي حد 30 سيڪنڊ آهي ۽ آئوٽ پٽ 1 MiB تائين محدود رکي ٿو. ڏنل اڻ موجود يا غلط ڊاريڪٽري رد ڪئي ويندي آهي؛ cwd ڇڏي ڏيڻ سان ايپ جي ملڪيت واري سيٽنگز ڊاريڪٽري استعمال ٿيندي آهي، HOME نه. Quit فعال ملڪيتي ڪمانڊن کي منسوخ ڪري ٿو ۽ انهن جي عمل جي صفائي جو انتظار ڪري ٿو.

ايپليڪيشن پڙهڻ/هلائڻ جي دائري ۽ مقامي رسائي جا فيصلا الڳ الڳ آهن. هڪ ورڪ ٽري اڻ ڇڏيل فراهم ڪندڙ جي فائيل سسٽم تائين پهچ کي محدود نٿي ڪري. ڪم کان پوءِ مقامي رسائي واپس وٺو جيڪڏهن ان جي ضرورت نه رهي هجي، ۽ مددگار جي بيان کي ثبوت سمجهڻ بدران ڪمانڊ جي رسيدن جو معائنو ڪريو.

لاڳاپيل هدايتون: صرف مالڪ لاءِ ڪنٽرول معاهدو.

برائوزر ۽ ريموٽ انسٽينسز

مقامي مالڪ سرور کي فعال ڪري ٿو ۽ ان جو پتو، پورٽ ۽ دائرو چونڊي ٿو: معائني لاءِ ريڊ يا عملن لاءِ آپريٽ. ڊفالٽ 127.0.0.1 پتو رڳو هن ڪمپيوٽر تي موجود آهي. 0.0.0.0 نيٽ ورڪ انٽرفيس تي ٻڌي ٿو؛ ان کي فعال ڪرڻ کان اڳ نيٽ ورڪ تائين پهچ جو جائزو وٺو.

هڪ برائوزر ٽوڪن لاگ ان کان پوءِ ساڳيو انٽرفيس کولي ٿو. ٽوڪنز کي عوامي لنڪس يا اسڪرين شاٽس ۾ شامل نه ڪريو. رڳو HTTP ٽريفڪ کي انڪرپٽ نٿو ڪري؛ غير محفوظ نيٽ ورڪ تي هڪ محفوظ چينل استعمال ڪريو.

مالڪ URL ۽ ٽوڪن ذريعي ٻين انسٽينسز کي ترتيب ڏئي ٿو. بيڪ اينڊ درخواستن کي پراڪسي ڪري ٿو؛ اهو انهن جا پروجيڪٽ مقامي مشين تي ڪاپي نٿو ڪري. هر عمل کان اڳ چونڊيل انسٽينس جي چڪاس ڪريو.

ٽائپ ڪيل ڪمانڊون ۽ واقعا ايپليڪيشن ڪنٽرول کڻندا آهن. ريڊ جو دائرو ڪمن ۾ تبديلي جو اختيار نٿو ڏئي. مقامي ڪمپيوٽر ڪنٽرول هڪ الڳ مقامي مالڪ جو فيصلو آهي ۽ شروعات ۾ غير فعال هوندو آهي.

برائوزر، Telegram ۽ ٻاهرين ايجنٽ ڪنٽرول لاءِ ايپ جو هلندڙ رهڻ ضروري آهي. هر انسٽينس جو پنهنجو ذاتي پروفائل، ٽاسڪ اسٽيٽ، ٽوڪن ۽ سرور پورٽ هوندو آهي. آزاد انسٽينسز جي وچ ۾ هڪ ئي وقت هڪ ئي پروفائل ٻيهر استعمال نه ڪريو. برائوزر جا واقعا ۽ ڪمانڊ جا جواب چونڊيل انسٽينس تائين محدود هوندا آهن؛ UI تبديل ڪرڻ سان فائيل ٻئي هنڌ منتقل نٿا ٿين يا مقامي لاگ ان ڪاپي نٿو ٿئي.

لاڳاپيل هدايتون: HTTP ۽ انسٽينس ڪنٽرول.

OpenClaw، Hermes ۽ ٻيا ٻاهرين ايجنٽ

تصديق ٿيل ايپليڪيشن ڪنٽرول API يا گڏيل MCP اسٽڊيو برج استعمال ڪريو. مقامي طور سرور فعال ڪريو، ريڊ يا آپريٽ چونڊيو ۽ هر ڪلائنٽ کي ان انسٽينس URL ۽ ٽوڪن سان ترتيب ڏيو. اسٽينڊ ايلون MCP برج هلائڻ لاءِ Node.js 22 يا نئون گهربل آهي؛ Electron ايپ توهان جو ايجنٽ ڪلائنٽ انسٽال نٿي ڪري. برائوزر URL ڪو اسٽريمنگ لائق HTTP MCP اينڊ پوائنٽ ناهي: ان کي اسٽڊيو برج ۾ ZIAFORGE_URL طور مهيا ڪريو.

اهو برج ziaforge_status، ziaforge_commands، ziaforge_command ۽ ziaforge_screenshot پيش ڪري ٿو. اسٽيٽس ۽ لائيو ڪمانڊ ڪيٽلاگ سان شروعات ڪريو، پوءِ چونڊيل ڪم لاءِ system.context پڙهو. ٽائپ ڪيل ڪمانڊون مقامي UI وانگر ساڳين نظرثاني، گيٽ، ٽاسڪ فولڊر ۽ صفائي جي چڪاسن تي عمل ڪن ٿيون.

لائيو ڪمانڊ ڪيٽلاگ ۾ documentation.guide، مستند انگريزي مدد، ان جي سورس پيٿ ۽ sourceSha256 شامل آهي. اندروني ايپليڪيشن معمار پنهنجي اوزارن ذريعي ساڳيو حوالو حاصل ڪري ٿو. هي پراڻن نوٽس تي ڀاڙڻ کان سواءِ ايجنٽن کي پوري پراڊڪٽ جو پس منظر مهيا ڪري ٿو؛ دستاويز ڪڏهن به رسائي نٿا ڏين يا موجوده انساني فيصلي جو متبادل نٿا بڻجن.

ايجنٽن کي هڪ مختصر انساني خيال مان ضرورتن، ٽيڪنيڪل فيصلن ۽ رٿابندي تي بحث ڪرڻ گهرجي. انهن کي واضح انساني گيٽس، چونڊيل ماڊلز، دستي/Auto پاليسي ۽ گهربل نظرثاني جو احترام ڪرڻ گهرجي. انهن کي منظوري پاڻ ايجاد نه ڪرڻ گهرجي، اڻ پڪين ڪمانڊن کي نئين ID هيٺ ٻيهر نه هلائڻ گهرجي، يا مالڪ جي ارادي کان سواءِ Git تبديليون شايع نه ڪرڻ گهرجن.

ڪيترن ئي انسٽاليشنز لاءِ ڪيترائي نالي وارا MCP سرور ترتيب ڏيو. انسٽينس تبديل ڪرڻ رڳو روٽنگ جو فيصلو آهي، نه ڪي هم وقت سازي (synchronization). OpenClaw ۽ Hermes جي ترتيب جا مثال AGENT_CONTROL.md ۾ آهن؛ انسٽال ٿيل ڪلائنٽ ورزن لاءِ مخصوص سيٽ اپ ۽ مطابقت لازمي چڪاسڻ گهرجي.

ٻاهريون requestId ڪيش صرف ايپ هلڻ دوران درخواستن جي هڪ محدود سيٽ مان نقل ختم ڪري ٿو. مستقل آپريشن پنهنجون سڃاڻپون استعمال ڪن ٿا: ڪم ٺاهڻ لاءِ createRequestId، ورڪ فلو فيصلن لاءِ commandId، پيغامن لاءِ clientMessageId ۽ operationId لاءِ Git تبديليون. اڻڄاتل تصديق کان پوءِ اصل سڃاڻپ ۽ پيلوڊ محفوظ رکو؛ ڄاڻي واڻي نئون ڪم جاري ڪرڻ کان اڳ محفوظ ڪيل حالت پڙهو.

لاڳاپيل هدايتون: MCP ڪلائنٽ جون هدايتون.

مقامي CLI ۽ خودڪار نظام جون حدون

ziaf ڊسچيپر ساڳئي هلندڙ ايپ ۽ محفوظ ڪيل ورڪ فلو کي ڪنٽرول ڪري ٿو. سورس مان، npm run ziaf -- list، npm run ziaf -- status --task TASK_ID --json، npm run ziaf -- start --task TASK_ID، يا npm run ziaf -- pause --task TASK_ID استعمال ڪريو. ڪامياب Start جي تصديق جو مطلب اهو ناهي ته ڪم مڪمل ٿي ويو آهي.

--until-success ڄاڻي واڻي محفوظ ڪيل ورڪ فلو لاءِ Auto کي فعال ڪري ٿو، پر سوال، نظرثاني، قبوليت جا گيٽس، حدون ۽ چيڪ پوائنٽس اڃا به لاڳو رهن ٿا. Ctrl+C مشاهدو ڪندڙ ڊسچيپر مان نڪري ٿو؛ اهو ايپليڪيشن ورڪ فلو کي پاڻمرادو بند نٿو ڪري. نڪرڻ وارن ڪوڊز، مقامي اينڊ پوائنٽ ۽ پروفائل جي سار سنڀال لاءِ CLI.md ڏسو.

خودڪار نظام (Automations) جو انٽرفيس هن وقت ڊسپلي جون وضاحتون ۽ مقامي هلائڻ وارا ڪائونٽر محفوظ ڪري ٿو. اهو ڪو تصديق ٿيل باقاعده شيڊيولر ناهي ۽ نه ئي اهو ثابت ڪري ٿو ته ڪو بيڪ گرائونڊ ماڊل ٽرن هلندو هو. اصل عمل لاءِ محفوظ ڪيل ورڪ فلو ڪنٽرولز، ziaf يا تصديق ٿيل API استعمال ڪريو ۽ انهن جي رسيدن جو معائنو ڪريو. مظاهري واري پينل کي غير نگراني ٿيل شيڊيولنگ نه سمجھو.

لاڳاپيل هدايتون: ڊسچيپر جون ڪمانڊون.

ورزن ۽ اپڊيٽس

About ۾ هلندڙ بلڪل صحيح ورزن ڏيکاريو وڃي ٿو. عوامي اپڊيٽس لاءِ هڪ قابل اعتماد GitHub رليز ريپوزٽري ۽ هڪ مستحڪم يا پريويو چينل گهربل آهي. چڪاس ڪرڻ، ڊائون لوڊ ڪرڻ ۽ انسٽال ڪرڻ جون الڳ الڳ حالتون آهن؛ ڪنهن خرابي جو مطلب اهو ناهي ته اپڊيٽ انسٽال ٿي وئي.

خودڪار تنصيب تصديق ٿيل (signed) macOS رليزز لاءِ آهي. غير تصديق ٿيل ڊولپمينٽ بلڊز هن طريقي سان پاڻمرادو انسٽال نٿا ٿين. هٿ سان تبديل ڪرڻ لاءِ، موجوده ايپ کي مڪمل طور بند ڪريو ۽ تصديق ٿيل آرٽيفئڪٽ استعمال ڪريو.

پاڻمرادو چڪاس فعال ٿيڻ تي ترت، ۽ پوءِ هر ڇهن ڪلاڪن بعد هلندي آهي.

مستحڪم پريويو رليزز کي خارج ڪري ٿو؛ پريويو ڊولپمينٽ رليزز جي پڻ اجازت ڏئي ٿو. هڪ ڪامياب چڪاس صرف دستياب رليز جي ميٽا ڊيٽا جي تصديق ڪري ٿي. ڊائون لوڊ ۽ تنصيب لاءِ پليٽ فارم پيڪيج ۽ ترتيب ڏنل رليز فيڊ گهربل آهي. Linux DEB پهچائڻ هڪ الڳ انسٽالر واٽ آهي؛ اهو گمان نه ڪريو ته هڪ DEB پاڻمرادو macOS اپڊيٽ واري طريقي ذريعي اپ گريڊ ٿي ويندو.

لاڳاپيل هدايتون: رليز جي تياري.

ٻيهر شروع ڪرڻ ۽ بحالي

macOS تي، مڪمل بند ڪرڻ لاءِ Quit / ⌘Q استعمال ڪريو. ونڊو بند ڪرڻ سان شايد ايپ هلندي رهي. ايپليڪيشن کي تبديل ڪرڻ کان اڳ پراڻي ورزن کي مڪمل طور بند ڪريو.

شروعات کان پوءِ، ساڳيو ڪم چونڊيو. هسٽري ۽ ڊرافٽس واپس اچي وڃن ٿا. Resume هڪ نيٽو/مقامي پس منظر کي بحال ڪري ٿو پر ڪو ڊرافٽ نٿو موڪلي، قطار کي اڻ روڪيل نٿو ڪري يا ڪنهن اڻڄاتل آپريشن کي ورجائڻ جو اختيار نٿو ڏئي.

جيڪڏهن ريڪوري نظر اچي، ته JSON کي هٿ سان ايڊٽ نه ڪريو. متاثر ٿيل دستاويز جي قسم جو معائنو ڪريو، اصل فائلون محفوظ رکو ۽ تصديق ٿيل بيڪ اپ چونڊيو. پراڻي قطار کي بحال ڪرڻ ان جي شين کي اڻ پڪو نشان لڳائي ٿو.

جڏهن پهچائڻ نامعلوم هجي، ته هڪ منظم ڪيل ورڪ فلو کي شايد نئين پس منظر لاءِ واضح اجازت جي ضرورت پوي. اڳوڻو ڪم ۽ ناڪام ڪوششون موجود رهن ٿيون؛ هڪ پڌرو انڪار ڪوڙي ڪاميابيءَ کان وڌيڪ محفوظ آهي.

ايپ جا سڀ انسٽينس بند هجڻ دوران ٽاسڪ فائيلن ۽ ايپ پروفائل جو بيڪ اپ وٺو. ڪاپي ڪيل فولڊر ڪو ٽيسٽ ٿيل بحال ٿيل ڊيٽا ناهي. جيڪڏهن بحالي توهان کان تصديق ٿيل بيڪ اپ چونڊڻ لاءِ پڇي، ته پوري خراب ٿيل فائيلن کي به محفوظ رکو. ڪنهن پراڻي ورڪ فلو يا قطار کي بحال ڪرڻ سان اڻ پڪي قياس يا Git عملن کي ورجائڻ جو اختيار نٿو ملي.

لاڳاپيل هدايتون: بحاليءَ جو معاهدو.

مسئلن جو حل

CLI نه مليو: عام ٽرمينل ۾ ان جي انسٽاليشن ۽ ورزن جي چڪاس ڪريو، پوءِ ZIAForge کي ٻيهر شروع ڪريو. ڪنهن ايگزيڪيوٽيبل جي موجودگي جو مطلب اهو ناهي ته توهان سائن ان ٿيل آهيو. فراهم ڪندڙ جو پنهنجو سائن ان جو طريقو استعمال ڪريو.

ماڊل دستياب ناهي يا تصديق ناڪام ٿي: دريافت کي ريفريش ڪريو، هڪ دستياب ID چونڊيو ۽ پنهنجو اڪائونٽ ۽ حدون چڪاسيو. اڻ پڪي درخواست کي ان جي هسٽري ڏسڻ کان اڳ نه ورجايو.

ورڪ فلو بند ٿي ويو: موجوده مرحلو، سوال، تصديق جي رسيد يا CLI لاگز کوليو. مخصوص سبب ڏسو: هڪ اڻ جوابيل سوال، ڪمانڊ، فولڊر جي اجازت يا ڪوشش جي حد. Continue ڪنهن ناڪام چڪاس کي ڪاميابي ۾ نٿو بدلائي سگهي.

فولڊر گم ٿي ويو يا تبديل ٿي ويو: اصل فولڊر تائين رسائي بحال ڪريو يا نئون ٽاسڪ ٺاهيو. ايپ کي HOME کان اڳتي نه وڌڻ گهرجي. جيڪڏهن توهان ڪنهن ٻئي cwd جو مشاهدو ڪريو ٿا، ته ٽرن کي روڪيو ۽ تشخيصي مواد محفوظ رکو.

رپورٽ لاءِ، About ورزن، روٽ، CLI/ماڊل، متوقع ۽ اصل رويو، هڪ اسڪرين شاٽ ۽ لاگ جو محفوظ اقتباس شامل ڪريو. راز، ذاتي مواد ۽ اھڙيون واٽون هٽايو جيڪي شايع نٿا ڪري سگهجن.

ريموٽ پيج دستياب ناهي: تصديق ڪريو ته مالڪ سرور فعال ڪيو آهي، ٻڌڻ وارو پتو ۽ پورٽ چڪاسيو، پوءِ صحيح انسٽينس ٽوڪن سان تصديق ڪريو. هڪ 401 تصديق ظاهر ڪري ٿو؛ هڪ رد ٿيل تبديلي ريڊ اسڪوپ يا رڳو مالڪ جي اختيار سبب ٿي سگهي ٿي. ٽوڪن تبديل ڪرڻ سان موجود برائوزر ڪلائنٽس بند ٿي وڃن ٿا. الڳ DevTools انسپيڪشن پورٽ کي ريموٽ ايپليڪيشن ڪنٽرول طور ظاهر نه ڪريو.

ايڊيٽر سيو کان انڪار: ڊرافٽ رکو، ڊسڪ تي موجوده فائيل جو معائنو ڪريو ۽ ٻاهرين تبديلي واري تڪرار کي حل ڪريو. ايپليڪيشن جو ميٽا ڊيٽا ٻيهر لکي موازني کي نظرانداز نه ڪريو. جيڪڏهن وڏي فائيل جي مڪمل لوڊنگ دستياب نه آهي، ته سپورٽ ٿيل ونڊو ايڊيٽنگ/سرچ يا ڪو ٻاهريون ايڊيٽر استعمال ڪريو.

Telegram دستياب ناهي: بوٽ ٽوڪن، عددي مالڪ، ذاتي چيٽ ۽ حيثيت جي مقامي طور تصديق ڪريو. هڪ مقابلو ڪندڙ ويب ھڪ يا پولر پولنگ کي روڪي سگهي ٿو؛ ZIAForge پاڻمرادو ويب ھڪ کي ڊليٽ نٿو ڪري يا ڪنهن ٻئي پولر تي قبضو نٿو ڪري. ڪنهن اڻڄاتل حد تي رد يا مداخلت ٿيل ڪمانڊون پاڻمرادو ٻيهر نٿيون هلايون وڃن.

لاڳاپيل هدايتون: ٽيسٽنگ ۽ تشخيص.

مسئلن جي رپورٽ ڏيو ۽ ثبوتن جو معائنو ڪريو

About مان هلندڙ صحيح بلڊ، OS/آرڪيٽيڪچر، ٽاسڪ موڊ، چونڊيل فراهم ڪندڙ/ماڊل ۽ مسئلي کي ٻيهر پيدا ڪندڙ مرحلا رڪارڊ ڪريو. متوقع نتيجو ۽ مليل نتيجو بيان ڪريو. سڄي ذاتي پروفائل جي بدران هڪ محفوظ اسڪرين شاٽ ۽ لاڳاپيل محفوظ ڪيل ڪمانڊ يا تصديق جي رسيد شامل ڪريو.

CLI لاگز، واقعن جا جرنل، ماڊل ٽرانسڪرپٽس، برائوزر ٽريسز ۽ اسڪرين شاٽس ذريعي سورس ڪوڊ، ذاتي واٽون يا ٽوڪنز ظاهر ٿي سگهن ٿا. شيئر ڪرڻ کان اڳ معائنو ڪريو ۽ حساس ڊيٽا هٽايو. لاگ مان مواد هٽائڻ جي ڪوشش ڪنهن اسڪرين شاٽ يا آرڪائيو کي شايع ڪرڻ لائق هجڻ جي تصديق نٿي ڪري.

حصو وٺندڙن لاءِ، qa:doctor ماحول/بلڊ جي سڃاڻپ پڙهي ٿو؛ qa:inspect فراهم ڪندڙ اسٽبس سان هڪ الڳ پروفائل کولي ٿو. هڪ فڪسچر ماڊل سان رابطو ڪرڻ کان سواءِ ٽيسٽ ڪيل ايپليڪيشن جي واٽ ثابت ڪري ٿو. لائيو نتيجا ڪڍڻ، Telegram ڪنيڪشن، مقامي Linux ڊيسڪ ٽاپ، دستخط ۽ پيڪيج ٿيل آرٽيفئڪٽ جون چڪاسون الڳ الڳ ثبوت آهن. ٻيهر تيار ٿيندڙ ڪمانڊن ۽ صفائي لاءِ TESTING.md ڏسو.

لاڳاپيل هدايتون: ثبوت جون ڪمانڊون.

مقامي ڊيٽا ۽ حدون

پروجيڪٽس، هسٽري، منصوبن، دستاويزن ۽ تشخيصي مواد ۾ خانگي متن ٿي سگهي ٿو. سورس ڪوڊ سان گڏ پروفائلز، خام ڪيپچرز، ڪنجيون يا مڪمل لاگز شايع نه ڪريو.

Linux تي، API، ڪنٽرول، Telegram ۽ انسٽينس جي تفصيلن کي محفوظ ڪرڻ لاءِ هڪ اڻ لاڪ ٿيل GNOME سيڪريٽ سروس يا KWallet گهربل آهي؛ ڪنهن سپورٽ ٿيل سيڪريٽ اسٽور کان سواءِ، ZIAForge Electron جي basic_text فال بيڪ جي بدران انهن رازن کي محفوظ ڪرڻ کان انڪار ڪري ٿو.

مقامي اسٽوريج جو مطلب اهو ناهي ته درخواستون رڳو توهان جي ڪمپيوٽر تي رهن ٿيون: چونڊيل CLI/API انهن کي پنهنجي فراهم ڪندڙ ڏانهن موڪلي ٿو. هڪ ورڪنگ فولڊر ۽ پروسيس جي نگراني ڪا OS جي الڳ ٿلڳ هجڻ واري حالت ناهي. چونڊيل اجازتن جو معائنو ڪريو.

ثبوتن جي قسمن ۾ فرق ڪريو: فڪسچرز بغير ڪنهن ماڊل جي ايپليڪيشن کي آزمائين ٿا؛ نيٽو لائيو هڪ حقيقي CLI/اڪائونٽ کي هلائي ٿو؛ پيڪيج ٿيل چڪاسون ڪنهن مخصوص آرٽيفئڪٽ جي تصديق ڪن ٿيون. هڪ ٽيسٽ پاس ڪرڻ ٻين جي ضمانت نٿو ڏئي.

ايپليڪيشن جو دائرو، هڪ ورڪ ٽري ۽ ريڊ-اونلي پرامپٽ آپريٽنگ سسٽم جي سخت پابندي کان مختلف آهن. Antigravity نظرثاني ڪندڙ/مددگار پاليسيون فائيل سسٽم جي ريڊ-اونلي رسائي کي زبردستي لاڳو ڪرڻ بدران گڏ ڪيل ورڪ اسپيس ثبوتن ۾ تبديلين کي سڃاڻن ٿيون. مقامي ڪمپيوٽر ڪنٽرول عام ايپ-ٽول جي حدن کان ٻاهر مالڪ پاران منظور ڪيل پروگرام هلائي ٿو؛ جڏهن ان جي ضرورت نه هجي ته ان کي بند ڪريو.

لاڳاپيل هدايتون: اصل ماخذ ۽ اشاعت.

هن اوپن سورس پروجيڪٽ کي سمجھو ۽ تبديل ڪريو

پهرين AGENTS.md ۽ CONTRIBUTING.md پڙهو، پوءِ موجوده سورس جي حدن لاءِ PROJECT_MAP.md ڏسو. لاڳو ڪيل ٽائپ ٿيل معاهدا ۽ موجوده ورڪ فلو/فراهم ڪندڙ جا دستاويز رويي کي هلائين ٿا. CONCEPT.md ۽ ARCHITECTURE.md جا ٽرمينل وارا ابتدائي حصا تاريخي ارادو بيان ڪن ٿا ۽ انهن کي موجوده رليز جا دعوا نه سمجهيو وڃي.

انگريزي مدد جو ماخذ docs/help/en.json آهي. تيار ڪيل USER_GUIDE.md يا website/guide.html کي هٿ سان تبديل نه ڪريو. اصل حصي کي تبديل ڪريو، متاثر ٿيل معاهدي کي اپڊيٽ ڪريو ۽ node scripts/help/generate.cjs هلايو. ايپ جي اندر مدد ساڳيو ماخذ پڙهي ٿي. حدن، اجازتن ۽ غير سهڪار واري واٽن سميت، اصل نفاذ سان اضافن جو جائزو وٺو.

سڀني 56 انٽرفيس ٻولين مان هر هڪ جي الڳ مدد واري حالت docs/help/locales.json ۾ موجود آهي. گم ٿيل يا نامڪمل مدد انگريزيءَ ڏانهن واپس رجوع ڪري ٿي. مڪمل مشين-ترجمو ٿيل متنن تي نشان لڳايو وڃي ٿو ۽ انهن کي انساني نظرثاني جي دعويٰ کان سواءِ انگريزي ماخذ هيش سان ڳنڍيو وڃي ٿو. هڪ انسان پاران نظرثاني ٿيل ترجمو پنهنجي نظرثاني ڪندڙ جو رڪارڊ پڻ رکي ٿو. هر ترجمي کي سيڪشن IDs، ڪارروايون، فائيل/ڪمانڊ سڃاڻپ ڪندڙ ۽ ٽيڪنيڪل حدون برقرار رکڻ گهرجن، صحيح طرف (direction) استعمال ڪرڻ گهرجي، ۽ جڏهن ان جو انگريزي ماخذ تبديل ٿئي ته ان کي نئين سر تيار ڪرڻ گهرجي.

شايع ڪرڻ کان اڳ، پراڻي جنريٽ ٿيل مواد، غلط لوڪيل اسڪيلفڊ يا ٽٽل مڪاني معاهدي لنڪس کي جانچڻ لاءِ node scripts/help/generate.cjs --check هلايو. UI ترجمي جون چڪاسون ۽ ايپليڪيشن رويي جون چڪاسون الڳ الڳ رهن ٿيون. HELP_MAINTENANCE.md حصو وٺندڙ ۽ AI جي اپڊيٽ جو طريقو ڏئي ٿو؛ دستاويزن کي ڪنهن اهڙي ٽيسٽ جي پاس ٿيڻ جي دعويٰ نه ڪرڻ گهرجي جيڪو هليو ئي نه هجي.

لاڳاپيل هدايتون: موجوده پروجيڪٽ جو نقشو · دستاويزن جي سار سنڀال · حصو وٺندڙن لاءِ هدايتون · ايجنٽ جون هدايتون.