ZIAForge صارف رہنما

پہلے اقدامات

ZIAForge بحث، منصوبہ بندی، نفاذ اور تصدیق کو ایک ہی ٹاسک میں رکھتا ہے۔ Git پروجیکٹ کے لیے Code منتخب کریں، یا کسی عام فولڈر میں دستاویزات، تحقیق اور دیگر نتائج کے لیے Work منتخب کریں۔

ایک الگ پروجیکٹ میں ایک چھوٹے کام سے آغاز کریں۔ اگر آپ مقامی CLI کا انتخاب کرتے ہیں، تو پہلے اسے انسٹال کریں اور ٹرمینل میں اس کے اپنے اکاؤنٹ سے سائن ان کریں۔ متبادل طور پر، ایک API کنکشن تشکیل دیں۔ ایک CLI سبسکرپشن اور بامعاوضہ API الگ الگ کنکشن کے طریقے ہیں؛ ZIAForge آپ کو سائن ان نہیں کرتا ہے اور نہ ہی ان کے درمیان کریڈٹ منتقل کرتا ہے۔

1. ترتیبات کھولیں اور ورک اسپیس فولڈر اور زبان چیک کریں۔ About چلنے والے بلڈ کی اصل شناخت دکھاتا ہے۔
2. Code کے لیے، سائڈبار میں ایک Git ریپوزٹری شامل کریں۔ Work کے لیے، ٹاسک بناتے وقت ایک الگ فولڈر منتخب کریں۔
3. کسی CLI، ماڈل، استدلال کی کوشش اور رسائی کی سطح کے ساتھ ایک پیش سیٹ محفوظ کریں۔ آپ محفوظ شدہ پیش سیٹ کے بغیر براہ راست Custom بھی منتخب کر سکتے ہیں۔
4. ایک ٹاسک بنائیں، اس کا روٹ، کردار اور دستی یا خودکار پیش رفت منتخب کریں۔ Start سے پہلے انتخابات کا جائزہ لیں۔

متعلقہ ہدایات: پروجیکٹ کا جائزہ · فراہم کنندہ کی مطابقت.

درست ڈیسک ٹاپ پیکج انسٹال کریں

اپنے آپریٹنگ سسٹم اور CPU آرکیٹیکچر کے لیے پیکج کا انتخاب کریں: x64 یا arm64۔ بلڈ پائپ لائن macOS DMG/ZIP، Windows NSIS انسٹالر/ZIP، اور Linux DEB/RPM/AppImage/tar.gz/ZIP فارمیٹس تیار کر سکتی ہے۔ تیار کردہ فائل یا کراس بلڈ اس بات کا ثبوت نہیں ہے کہ اس کا انسٹالر اور مقامی UI آپ کی مشین پر پاس ہو گیا ہے؛ اس ریلیز کے تصدیقی ریکارڈ سے رجوع کریں۔

Electron 44 استعمال کرنے والے macOS بلڈز کے لیے macOS 13 یا بعد کا ورژن درکار ہے۔ ایپل سلیکون (Apple Silicon) پر arm64 پیکج اور انٹیل (Intel) کے لیے x64 پیکج استعمال کریں۔ تبدیلی سے پہلے پرانی ایپ کو مکمل طور پر بند کریں۔ پیش نظارہ (Preview) پیکجز غیر دستخط شدہ اور غیر تصدیق شدہ ہو سکتے ہیں؛ کسی ترقیاتی نمونے (development artifact) کو دستخط شدہ عوامی ریلیز سمجھنے کی غلطی نہ کریں۔

Windows کو بنڈل شدہ Electron ورژن کے ذریعے تعاون یافتہ آپریٹنگ سسٹم اور PATH میں دستیاب Git کی ضرورت ہے۔ مماثل آرکیٹیکچر کا انتخاب کریں۔ غیر دستخط شدہ پیش نظارے کے پاس Authenticode سرٹیفیکیشن نہیں ہوتا ہے۔ پورٹیبل ZIP میں مکمل ایپلیکیشن ڈائرکٹری اور رن ٹائم فائلیں برقرار رہنی چاہئیں، نہ کہ صرف اس کی ایگزیکیوٹیبل۔

Linux کو ایک ہم آہنگ گرافیکل ڈیسک ٹاپ، Electron کے لیے درکار سسٹم لائبریریز، اور Git کی ضرورت ہے۔ خفیہ کردہ کنٹرول اسناد کے لیے، کام کرنے والی خفیہ سروس (Secret Service) فراہم کریں جیسے کہ gnome-libsecret یا KWallet؛ غیر محفوظ basic_text بیک اینڈ قابل قبول نہیں ہے۔ ہیڈ لیس/کنٹینر دھوئیں کے شواہد (smoke evidence) ہر ڈیسک ٹاپ یا ڈسٹری بیوشن کی تصدیق نہیں کرتے۔

DEB کو apt install ./file.deb کے ساتھ انسٹال کریں، یا اپنے ڈسٹری بیوشن کے پیکج مینیجر کے ذریعے RPM انسٹال کریں۔ ایک AppImage کے لیے ایگزیکیوٹ کرنے کی اجازت اور موزوں FUSE سپورٹ درکار ہے؛ جہاں تعاون دستیاب ہو وہاں --appimage-extract-and-run ایک متبادل ہے۔ tar.gz اور ZIP پیکجز کو ان کی تمام رن ٹائم فائلوں کے ساتھ نکالیں۔ پیکج کو تبدیل کرتے وقت صارف کا ڈیٹا اور ایپلیکیشن فائلوں کو الگ رکھیں۔

سورس سے بنانے کے لیے، Node 24، Git اور npm ci استعمال کریں، بشمول عام Electron انسٹالر۔ مقامی تعمیر نو (rebuilds) کے لیے پلیٹ فارم ٹولز درکار ہیں: macOS پر Xcode کمانڈ لائن ٹولز؛ Windows پر MSVC C++، Windows SDK اور Python؛ Linux پر مرتب کار (compiler)، make، Python، pkg-config اور مطلوبہ پیکیجنگ ٹولز۔ قطعی کمانڈز اور موجودہ پلیٹ فارم حدود کے لیے PLATFORM_BUILDS.md پر عمل کریں۔

ریلیز کے ورژن مرکزی طور پر مخصوص ہوتے ہیں اور آؤٹ پٹ ناقابل تغیر ہوتے ہیں۔ CI تصدیقی بلڈ شائع شدہ انسٹالر نہیں ہوتا ہے۔ سورس آرکائیوز میں سورس کوڈ، لاک فائل، دستاویزات اور اسکرپٹس شامل ہوتے ہیں؛ انحصار (dependencies)، اسناد، صارف کے پروفائلز اور نجی تحقیق کو خارج کر دیا جاتا ہے۔ کامیاب x64 بلڈ سے مقامی ARM یا Windows کی توثیق کا نتیجہ کبھی نہ نکالیں۔

متعلقہ ہدایات: پلیٹ فارم پیکجز، پیشگی ضروریات اور تصدیق کی حدود · بلڈ شناخت اور ریلیز کی جانچ.

Code: پانچ راستے

Auto دائرہ کار کا اندازہ لگاتا ہے: ایک سادہ سوال جواب کے ساتھ ختم ہو سکتا ہے، جبکہ ایک بڑے کام کے لیے تیاری درکار ہوتی ہے۔ Fix a bug وجہ کی جانچ کرتا ہے اور درستگی تیار کرتا ہے۔ Spec first تکنیکی حل کے ساتھ شروع ہوتا ہے؛ Requirements first ضروریات اور قبولیت کے معیار سے شروع ہوتا ہے۔

Multi-model تحقیق، ڈیزائن، نفاذ اور جائزے کے لیے الگ الگ سیاق و سباق استعمال کرتا ہے۔ روٹ کے نام کے لیے مختلف فراہم کنندگان کا ہونا ضروری نہیں ہے: ہر کردار آپ کی منتخب کردہ پیش سیٹ یا Custom ترتیب کو استعمال کرتا ہے۔

ایک Worktree ٹاسک کی Git تبدیلیوں کو الگ تھلگ رکھتا ہے۔ Branch منتخب کردہ چیک آؤٹ میں کام کرتی ہے۔ شروع کرنے سے پہلے پروجیکٹ، برانچ اور ماڈل کو چیک کریں؛ ٹاسک کی تفصیل عام چیٹ میں بھی نہیں بھیجی جاتی۔

کسی ایسے خیال کے لیے جس میں مصنوعات یا تکنیکی انتخاب حل طلب ہوں، Requirements first استعمال کریں اور بات چیت میں بنیاد تیار کریں۔ Auto درخواست کی درجہ بندی کرتا ہے؛ یہ ہر مختصر جملے کو فوری طور پر لاگو کرنے کا حکم نہیں ہے۔ Save draft کسی ماڈل سے رابطہ کیے بغیر درخواست کو محفوظ رکھتا ہے؛ Start منظم شدہ بہاؤ کو ایک بار محفوظ اور شروع کرتا ہے۔ ایک سے چار ٹاسک کاپیاں آزاد تخلیقی آئی ڈیز اور کردار کی ترتیبات رکھتی ہیں۔

متعلقہ ہدایات: Code ورک فلو معاہدہ · Code پرامپٹ پروفائلز.

Forge بحث

Start مرکزی بحث کا آغاز کرتا ہے۔ قدرتی طور پر جواب دیں، جوابی سوالات پوچھیں، پابندیاں شامل کریں اور تکنیکی انتخاب پر تبادلہ خیال کریں۔ گفتگو اور سوالات کام کے ساتھ ہی رہتے ہیں۔

متن بھیجنے سے کوئی دستاویز قبول نہیں ہوتی اور نہ ہی نفاذ کے کسی نئے منصوبے کی اجازت ملتی ہے۔ عمل درآمد کے دوران وضاحت پہلے منظم موڑ کو روکتی ہے اور متاثرہ دائرہ کار پر دوبارہ غور کرتی ہے۔ پہلے سے قبول شدہ مرحلے کے اندر کسی سوال کا جواب اس مرحلے کو جاری رکھ سکتا ہے۔

بنیاد پر جان بوجھ کر دوبارہ غور کرنے کے لیے، Requirements، Specification یا Planning کو منتخب کریں۔ نئے ورژن کے لیے منحصر فیصلوں کی نئی قبولیت درکار ہوتی ہے۔ مکمل شدہ اقدامات اور ان کے ثبوت باقی رہتے ہیں؛ منسوخ شدہ نامکمل مراحل سرگزشت میں رہتے ہیں۔

منظم شدہ مرحلہ وار سیشنز آزاد چیٹ سے مختلف ہوتے ہیں۔ ورک فلو کی ملکیت والے سیشن میں براہ راست دستی پرامپٹس بھیجنے کے بجائے Forge بحث کا استعمال کریں۔

متعلقہ ہدایات: Forge بحث کا معاہدہ.

دستاویزات اور فیصلے

کسی دستاویز کو کھولیں، اس کے ورژن کا معائنہ کریں اور ضرورت پڑنے پر ترامیم کریں۔ بات چیت کے ذریعے ترامیم جمع کرانے سے ایک نیا ورژن تیار ہوتا ہے؛ رپورٹس اور تصدیق شدہ نتائج ماضی کے اثر سے دوبارہ نہیں لکھے جاتے۔

تجویز کردہ منصوبے کو قبول کرنے سے پہلے، ترتیب، ہدایات، قبولیت کے معیار اور تصدیقی کمانڈز میں ترمیم کریں۔ ان ٹھوس کمانڈز کی توثیق کریں جنہیں آپ سمجھتے ہیں: وہ ٹاسک فولڈر میں چلتی ہیں۔ Multi-model پورے ٹاسک کے نفاذ کا ایک مرحلہ تجویز کرتا ہے، جس کی تفصیلات اس کی دستاویزات اور ہدایات میں ہوتی ہیں۔

Approve ایک الگ دانستہ فیصلہ ہے۔ Auto ضروریات، تصریحات اور منصوبوں کے سوالات یا قبولیت کو نظرانداز نہیں کرتا۔ بیرونی طور پر تبدیل شدہ دستاویز پرانی منظوری کو دوبارہ استعمال نہیں کر سکتی۔

تیاری کی فائلیں نمونے (artifacts) کے طور پر ظاہر ہوتی ہیں۔ ان کا ورژن، تیار کرنے والا مرحلہ اور ہیش انہیں نتیجے سے باندھتے ہیں۔ Code دستاویزات ورک ٹری سے باہر رکھی جاتی ہیں اور خودکار طور پر کمٹ میں داخل نہیں ہوتیں۔

قبول کرنے سے پہلے دستاویز اور ظاہر کردہ فیصلے دونوں کو چیک کریں۔ قبولیت موجودہ گیٹ ID، پلان پر نظرثانی اور برقرار رکھے گئے دستاویز کے ہیشز کو پابند کرتی ہے۔ جب دائرہ کار یا ثبوت غلط ہو تو تبدیلیوں کی درخواست کریں۔ اگر کوئی فیصلہ پرانا ہو گیا ہے، تو نیا انتخاب کرنے سے پہلے محفوظ شدہ حالت کو دوبارہ لوڈ کریں؛ تبدیل شدہ فائل کو پرانے ورژن کے تحت قبول نہیں کیا جا سکتا۔

متعلقہ ہدایات: ورک فلو گیٹس اور دستاویز کے ورژن.

نفاذ اور جائزہ

To-do حقیقی اقدامات، موجودہ کوشش، تصدیق اور جائزے کے نتائج دکھاتا ہے۔ کسی ایجنٹ کا "done" کہنا کسی مرحلے کو مکمل نہیں کرتا: منصوبے کا مطلوبہ ثبوت موجود ہونا ضروری ہے۔

Manual موڈ اہل مراحل کے درمیان رک جاتا ہے۔ Auto تصدیق شدہ مراحل کو آگے بڑھاتا ہے اور محدود دوبارہ کوششوں کی اجازت دیتا ہے۔ Stop after ہمیشہ ایک چیک پوائنٹ بناتا ہے۔ Pause ورک فلو کے فعال کام کو روک دیتا ہے؛ پینل بند کرنے سے یہ نہیں رکتا۔

ایک خودمختار ریویور فائلوں اور تصدیقی نتائج کے ساتھ الگ سیاق و سباق استعمال کرتا ہے۔ ہر مطلوبہ بلاک کرنے والے نتیجے کو حل کیا جانا چاہیے؛ متعدد ریویورز ووٹ کے ذریعے کسی بلاک کرنے والی غلطی کو ختم نہیں کر سکتے۔

Multi-model میں، نتائج کی اصلاح کے لیے ایک واضح فیصلے کی ضرورت ہوتی ہے۔ اصلاح خاموشی سے دوسرا جائزہ شروع نہیں کرتی: Review again ایک نیا چکر کھولتا ہے۔ جائزے کے تبصرے نفاذ کو دہرائے بغیر کوآرڈینیٹر سے نظرثانی کی درخواست کر سکتے ہیں۔

مکمل شدہ مراحل میں خاموشی سے ترمیم نہیں کی جا سکتی۔ TDD کے ساتھ، Red کو متوقع وجہ سے واقعی ناکام ہونا چاہیے، پھر Green کو پاس ہونا چاہیے۔ محدود کوششیں لامتناہی دوبارہ کوششوں کو روکتی ہیں۔

خودمختار CLI/API ریویورز کو Settings ← Review teams میں محفوظ کریں، پھر Code یا Work میں ٹیم کو منتخب کریں۔ ریویورز متوازی طور پر چلتے ہیں، جس کے بعد ٹیم کا رپورٹ آرکیٹیکٹ آتا ہے۔ آپ محفوظ شدہ ٹیم کے بغیر بھی خودمختار ریویورز تشکیل دے سکتے ہیں۔ رپورٹ آرکیٹیکٹ بغیر کسی پروجیکٹ فائل یا ٹولز کے صرف گمنام منظم رپورٹس حاصل کرتا ہے؛ اس علیحدگی کے لیے فی الحال Claude Code یا API درکار ہے۔

ہر نفاذ کے مرحلے کے لیے ایک قابل عمل جانچ، مطلوبہ آزادانہ جائزہ، یا دونوں درکار ہوتے ہیں۔ تیاری کے مراحل اس کے بجائے توثیق شدہ نتائج اور نمونے کی رسیدیں برقرار رکھتے ہیں؛ یہ ایسا دعویٰ نہیں کرتے کہ نفاذ کے ٹیسٹ چلائے گئے تھے۔ ایک کمانڈ صرف اس وقت کامیاب ہوتی ہے جب اس کی اصل ایگزٹ کیفیت اور ملکیتی عمل کی صفائی کی تصدیق ہو جائے۔ TDD کے لیے Red چیک کو نفاذ اور Green تصدیق سے پہلے معمول کے مطابق ناکام ہونا چاہیے؛ گمشدہ ایگزیکیوٹیبل یا ٹائم آؤٹ درست Red نتیجہ نہیں ہے۔

ڈیفالٹ سرکٹ بریکرز ایک قدم پر تین ناکام کوششوں یا مجموعی طور پر پچاس کوششوں کے بعد رک جاتے ہیں۔ مداخلت ایک کوشش استعمال کرتی ہے لیکن خود ناکام کوشش میں شمار نہیں ہوتی۔ حدود اور مکمل شدہ ثبوت دوبارہ شروع ہونے پر بھی برقرار رہتے ہیں؛ Retry انہیں دوبارہ ترتیب نہیں دیتا۔ دوسری کوشش کی اجازت دینے سے پہلے برقرار رکھی گئی ناکامی کو پڑھیں۔

متعلقہ ہدایات: تصدیق اور جائزہ.

متوازی جائزہ ٹیمیں اور رپورٹ آرکیٹیکٹ

Settings ← Review teams کھولیں اور ایک ٹیم محفوظ کریں۔ اپنے CLI یا API، ماڈل، استدلال کی کوشش اور تخصص کے ساتھ خودمختار جائزہ نگار شامل کریں، پھر ایک رپورٹ آرکیٹیکٹ کا انتخاب کریں۔ ٹاسک کی جائزہ کنفیگریشن میں ٹیم کا انتخاب کریں۔ ایک ایگزیکیوٹر پیش سیٹ بھی ریویور کے ذریعے استعمال کیا جا سکتا ہے، اور Custom بدستور دستیاب ہے؛ خودمختار کرداروں کے پاس اب بھی الگ الگ سیاق و سباق ہوتا ہے۔

ریویورز ایک ہی ٹاسک کے ثبوت پر متوازی طور پر چلتے ہیں۔ ہر مطلوبہ رپورٹ، نقص اور فیصلہ برقرار رکھا جاتا ہے۔ آرکیٹیکٹ ریویور کے نام، ماڈل یا فراہم کنندہ کی شناخت، اصل ٹاسک کے مواد، ریپوزٹری تک رسائی یا ٹولز کے بغیر گمنام نمبر والی رپورٹس حاصل کرتا ہے۔ یہ رپورٹس کا موازنہ کرتا ہے اور ایک منظم فیصلہ واپس کرتا ہے؛ یہ نیا سورس ریویو نہیں کرتا۔

کسی بلاک کرنے والے نتیجے یا مطلوبہ ریویور کے مسترد کرنے کو اکثریتی ووٹ یا آرکیٹیکٹ کی ترجیح کے ذریعے معاف نہیں کیا جا سکتا۔ گمشدہ یا غلط شکل والی رپورٹس منظوری کو روکتی ہیں۔ قبول کرنے یا تصحیح کی اجازت دینے سے پہلے انفرادی نتائج اور مجموعی فیصلے کا معائنہ کریں۔ محفوظ شدہ ٹیم کو رن کے لیے حتمی اور منجمد کر دیا جاتا ہے؛ اس کے پیش سیٹ میں ترمیم کرنے سے مکمل شدہ ثبوت دوبارہ نہیں لکھا جاتا۔

صرف رپورٹ تیار کرنے والا آرکیٹیکٹ فی الحال تعاون یافتہ Claude یا API بغیر ٹول والی ترتیبات کا استعمال کرتا ہے۔ Codex اور Antigravity بطور جائزہ نگار دستیاب رہتے ہیں لیکن اس الگ تھلگ آرکیٹیکٹ کے کردار کے لیے اس وقت تک مسترد کر دیے جاتے ہیں جب تک کہ کوئی تصدیق شدہ بغیر ٹول والا معاہدہ موجود نہ ہو۔ اکیلا یہ پرامپٹ کہنا کہ "no tools" کافی نہیں ہے۔

متعلقہ ہدایات: ٹائپ شدہ ٹیم کی ترتیب · جائزے کا مجموعہ.

ایجنٹ کی خصوصیات اور پرامپٹ پالیسی

ایک ماڈل ایگزیکیوشن انجن ہے؛ تخصص ایک ہدایاتی پروفائل ہے۔ بغیر کسی اضافی تخصص کے لیے None، ڈیفالٹ گائیڈ کے لیے Standard، متعلقہ بلٹ ان گائیڈ کے لیے Auto، یا منتخب گائیڈز اور اپنی محدود ہدایات کے لیے Manual کا انتخاب کریں۔ پیش سیٹ اس انتخاب کو برقرار رکھ سکتے ہیں۔

اصل کیٹلاگ عمومی کوڈنگ، فن تعمیر، سیکیورٹی، وشوسنییتا، کارکردگی، ٹیسٹنگ اور انٹرفیس کے استعمال کی سہولت کا احاطہ کرتا ہے۔ Auto گائیڈ منتخب کرنے کے لیے دستیاب ٹاسک/مرحلہ متن کا استعمال کرتا ہے؛ یہ خفیہ طور پر کسی دوسرے ماڈل کو کال نہیں کرتا اور نہ ہی مہارت کی تصدیق کرتا ہے۔ نفاذ کے منصوبے کو قبول کرنے سے پہلے منصوبہ بندی کی تجاویز کا معائنہ اور تبدیلی کی جا سکتی ہے۔

جائزے کی خصوصیات توجہ مرکوز کرنے میں مدد کرتی ہیں لیکن کبھی بھی آزاد ثبوت، رسائی کی حدود یا منظم فیصلے کی جگہ نہیں لیتیں۔ حسب ضرورت ہدایات کو ٹاسک کے دائرہ کار کا حصہ سمجھیں: انہیں دستاویز کی قبولیت، ٹول پالیسی، تصدیق یا ریویور کی ناکامیوں کو نظرانداز کرنے کے لیے استعمال نہ کریں۔

متعلقہ ہدایات: اصل پرامپٹ کیٹلاگ.

Work: سوال سے لے کر دستاویز تک

Work کے لیے Git درکار نہیں ہے۔ Default ایک الگ ٹاسک فولڈر بناتا ہے؛ Custom مقامی پکر کے ذریعے ایک موجودہ فولڈر کا انتخاب کرتا ہے۔ Save draft اندازے (inference) کے بغیر ترتیبات کو محفوظ کرتا ہے؛ Start پہلا مرحلہ چلاتا ہے۔

Auto براہ راست جواب دیتا ہے یا حقیقی To-dos کے ساتھ ایک مناسب منصوبہ تجویز کرتا ہے۔ Brainstorm مزید خیالات یا تشخیص کے انتخاب سے پہلے ideas.md بناتا ہے۔ Research findings.md، ذرائع اور حدود کو برقرار رکھتا ہے۔ Write ارادے سے اور، کارآمد ہونے پر، outline.md سے وضاحتی دستاویز یا draft.md کی طرف بڑھتا ہے؛ نظرثانی میں پچھلے ورژن برقرار رہتے ہیں۔

مقامی پکر کے ذریعے فائل ان پٹس منتخب کریں اور @ کے ساتھ ان کا حوالہ دیں۔ ایپ انہیں ناقابل تغیر ٹاسک ان پٹس کے طور پر کاپی کرتی ہے اور رن سے پہلے ان کی شناخت کی توثیق کرتی ہے۔ Default ایپلیکیشن کی ملکیت والا ٹاسک فولڈر بناتا ہے؛ Custom فولڈر تک رسائی ایک محفوظ شدہ مالک کی اجازت ہے۔ ایک محفوظ شدہ، غیر شروع شدہ مسودہ اپنا فولڈر تبدیل کر سکتا ہے۔

آزاد ایگزیکیوٹر ترتیبات کے ساتھ 1–4 کاپیاں بنائیں۔ اوورلیپنگ فولڈرز استعمال کرنے والے ٹاسک ایک ساتھ نہیں لکھ سکتے۔ یہ ہم آہنگی ZIAForge کے آپریشنز پر لاگو ہوتی ہے، صوابدیدی بیرونی پروگراموں پر نہیں۔

Deep Brainstorm ڈیفالٹ کے طور پر تین خودمختار کارکنوں پر مشتمل ہوتا ہے اور آٹھ تک کی حمایت کرتا ہے۔ ان کی ترتیب اور ترتیبات کا انتخاب کریں، بشمول الگ الگ سیاق و سباق میں پیش سیٹ کا دوبارہ استعمال۔ کارکنوں کے سوالات اپنی اصلیت برقرار رکھتے ہیں؛ ناقص رپورٹس کو فارمیٹ کی مرمت کی ایک کوشش ملتی ہے۔ جزوی ناکامی متفقہ کامیابی کے طور پر پیش کیے جانے کے بجائے نظر آتی رہتی ہے۔

Deep برقرار رکھی گئی کارکن رپورٹس کو brainstorm_report.md میں یکجا کرتا ہے اور ہمیشہ صارف سے فیصلے کے لیے کہتا ہے۔ ایک چھوٹا فالو اپ کوآرڈینیٹر کے ذریعے رپورٹ پر نظرثانی کرتا ہے؛ ایک بڑی تبدیلی منجمد کارکنوں کا ایک اور دور شروع کرتی ہے۔ نمونے (Artifacts) اپنے ورژن برقرار رکھتے ہیں۔

طے شدہ کردار ٹاسک کی تخلیق یا واضح مسودہ محفوظ کرنے پر منجمد ہو جاتے ہیں۔ پہلی کال کے بعد، صرف خودکار/دستی پیش رفت ہی تبدیل ہو سکتی ہے؛ مختلف کردار یا ماڈل کی ترتیبات کے لیے نیا کام استعمال کریں۔ عالمی پیش سیٹ میں ترمیم کرنے سے خاموشی سے بعد کے مراحل تبدیل نہیں ہوتے۔

Manual موڈ اہل مراحل کے درمیان رک جاتا ہے، بشمول ایک تفصیلی Write خاکہ۔ Auto اس خاکے کے ذریعے جاری رہ سکتا ہے۔ سوالات، مجوزہ قابل عمل منصوبے، Brainstorm سمت اور Deep رپورٹ کا جائزہ Auto میں بھی واضح فیصلے رہتے ہیں۔ صرف ایک حوالہ یہ ثابت نہیں کرتا کہ براؤزنگ ہوئی تھی، اور صرف ایک محفوظ شدہ بائنری فائل اس کی رینڈرنگ کو ثابت نہیں کرتی۔

متعلقہ ہدایات: Work کے طریقے اور فیصلے.

پیش سیٹ، ماڈلز اور رسائی

ایک پیش سیٹ CLI/API، ماڈل، استدلال کی کوشش اور اجازتوں کو محفوظ کرتا ہے۔ چیٹ کے فوٹر میں پیش سیٹ، CLI، ماڈل اور اختیارات کے حصے ہوتے ہیں۔ Custom بغیر پیش سیٹ کے کام کرتا ہے؛ Create preset موجودہ انتخاب کو محفوظ کرتا ہے۔

کیٹلاگ منتخب کردہ انسٹال شدہ CLI یا API سے حاصل ہوتا ہے جہاں سپورٹ موجود ہو۔ Refresh انتخاب کو تبدیل کیے بغیر فہرست کو اپ ڈیٹ کرتا ہے۔ اگر دریافت دستیاب نہ ہو، تو ایک واضح ماڈل ID درج کریں؛ فراہم کنندہ کے لیے اب بھی اس کی حمایت کرنا ضروری ہے۔ استدلال کی سطحیں ماڈل اور CLI پر منحصر ہوتی ہیں۔ فراہم کنندہ کا پہلے سے طے شدہ (default) واضح none ٹوکن سے الگ ہے۔

تبدیلیوں کا اطلاق صرف بیک اینڈ کی تصدیق کے بعد کریں۔ فعال باری یا غیر خالی قطار کے دوران تبدیلی محدود ہوتی ہے۔ مسودات اور نظر آنے والی سرگزشت باقی رہتی ہے، لیکن فراہم کنندگان کو تبدیل کرنے سے ان کی نجی اندرونی حالت منتقل نہیں ہوتی۔

Forge میں، کردار کا لیبل اہمیت رکھتا ہے: تیاری ایک الگ Planner استعمال کر سکتی ہے۔ فوٹر دکھائے گئے کردار کو تبدیل کرتا ہے؛ ریویورز اور ہیلپرز کا انتخاب ورک فلو کی ترتیبات میں کیا جاتا ہے۔ پہلے سے تصدیق شدہ نفاذ کی پالیسی مقفل ہو سکتی ہے۔

اجازتیں فراہم کنندگان کے درمیان مختلف ہوتی ہیں۔ Read only اور Workspace write وہاں دستیاب ہیں جہاں اڈاپٹر ان کی حمایت کرتا ہے۔ Antigravity مقامی CLI ترتیبات یا واضح طور پر منتخب کردہ مکمل رسائی کا استعمال کرتا ہے۔ مکمل رسائی کوئی سینڈ باکس نہیں ہے۔

تخصص (Specialization) پرامپٹ کی رہنمائی کا اضافہ کرتا ہے، کسی دوسرے ماڈل یا اجازت کا نہیں۔ پیش سیٹ اور کردار None، Standard، Auto اور Manual کو سپورٹ کرتے ہیں۔ Auto اضافی ماڈل کال کے بغیر مرحلہ وار متن سے پروفائلز منتخب کرتا ہے؛ Manual چار خصوصیات اور حسب ضرورت ہدایات تک قبول کرتا ہے۔ منصوبے کو قبول کرنے سے پہلے پلانر کے تجویز کردہ تفویضات میں ترمیم کی جا سکتی ہے۔

دستی طور پر درج کردہ ماڈل ID یا استدلال کی کوشش آپ کی پسند رہتی ہے، لیکن فراہم کنندہ اسے مسترد کر سکتا ہے۔ گلوبل پیش سیٹ میں ترمیم کرنے سے چلتی ہوئی چیٹ یا قبول شدہ پلان میں ماضی کے اثر سے کوئی تبدیلی نہیں آتی۔ کسی بیکار گفتگو کو دانستہ طور پر تبدیل کرنے کے لیے، اس کے اپنے کنفیگریشن کنٹرولز کا استعمال کریں اور اعتراف کا انتظار کریں۔ غیر فعال آپشن کو صلاحیت یا لائف سائیکل کی حد کے طور پر پڑھا جانا چاہیے، محفوظ شدہ JSON میں ترمیم کر کے نظرانداز نہیں کیا جانا چاہیے۔

متعلقہ ہدایات: فراہم کنندہ کی صلاحیتیں.

چیٹس، Stop اور قطار

کھلی ہوئی ٹیبز، Recent اور مسودات ایک ہی ٹاسک سے تعلق رکھتے ہیں۔ کسی ٹیب کو بند کرنے سے وہ Open سے ہٹ جاتی ہے لیکن Recent میں برقرار رہتی ہے اور اس کے فراہم کنندہ کے عمل یا منظم شدہ ورک فلو کو نہیں روکتی۔ سرگزشت تلاش کریں، چیٹ دوبارہ کھولیں یا ہسٹری مینو سے تمام اضافی ٹیبز بند کریں۔

Stop موجودہ باری کو روک دیتا ہے۔ اگلی بار Send کرنے سے پہلے رکنے کا عمل مکمل ہونے کا انتظار کریں: رکاوٹ کا اعتراف عمل کی تکمیل نہیں ہے۔ اس دوران آپ اگلا مسودہ ٹائپ کر سکتے ہیں۔

عام چیٹ میں، Queue بعد کی درخواست کو موجودہ مسودے سے الگ محفوظ کرتی ہے۔ Pause queue مزید ترسیل کو روک دیتی ہے۔ Stop اور Quit قطار کو موقوف کر دیتے ہیں۔ دوبارہ شروع کرنے کے بعد، پہلے Resume کریں، پھر واضح طور پر Continue queue کریں۔

Uncertain کا مطلب ہے کہ ترسیل نامعلوم ہے۔ ایسا پیغام خودکار طور پر دوبارہ نہیں بھیجا جاتا: سرگزشت کا معائنہ کریں، مناسب ہو تو متن کاپی کریں اور قطار میں موجود آئٹم کو خارج کر دیں۔ اسے دوبارہ بھیجنا ایک نئی دانستہ درخواست ہے۔

منظم شدہ مرحلہ وار چیٹس اپنے ورک فلو کو استعمال کرتی ہیں، عام قطار کو نہیں۔ Follow stage موجودہ مرحلہ دکھاتا ہے؛ دستی طور پر دوسری ٹیب منتخب کرنے سے پیروی رک جاتی ہے۔ CLI لاگز جواب سے الگ تشخیص دکھاتے ہیں۔

مارک ڈاؤن جوابات عنوانات، فہرستیں، جداول، لنکس اور فینسڈ کوڈ کو رینڈر کرتے ہیں۔ ٹول کارڈز اور CLI تشخیصات جواب سے الگ رہتے ہیں۔ ماڈل کی رپورٹ کردہ سوچ اور ٹوکن میٹرکس صرف اسی وقت ظاہر ہوتے ہیں جب فراہم کنندہ واقعی انہیں ظاہر کرے؛ اینیمیشن سے نجی استدلال یا استعمال کا قیاس نہ کریں۔

غیر یقینی ترسیل یا قطار کی تصدیق کے بعد، سرگزشت کا معائنہ کریں اور جہاں پیشکش کی جائے صرف اسی برقرار رکھی گئی درخواست کی دوبارہ کوشش کریں۔ قطار کی رسید کا مطلب ہے کہ اسٹوریج نے آئٹم کو قبول کر لیا ہے، یہ نہیں کہ استدلال مکمل ہو گیا۔ غیر یقینی قطار بند آئٹم کو صرف ایک واضح اخراج کے طور پر ہٹائیں؛ یہ پہلے سے پہنچائے گئے پرامپٹ کو واپس نہیں لے سکتا۔

متعلقہ ہدایات: پائیدار پیغام کی قطار.

فائلیں، Git اور تکمیل

Files ٹاسک کا فولڈر دکھاتی ہے۔ نتائج کا موازنہ ضروریات کے ساتھ کریں، دستاویزات کھولیں اور فرق (diffs) کا معائنہ کریں۔ کسی بائنری فائل کو برقرار رکھنا اس کی ٹارگٹ ایپلیکیشن میں درست رینڈرنگ کو ثابت نہیں کرتا۔

Git ریکارڈ شدہ نتائج کے ساتھ کیفیت، تبدیلیاں اور آپریشنز فراہم کرتا ہے۔ Commit، merge اور push ڈیفالٹ کے طور پر دستی ہیں؛ خودکار آپریشنز مکمل طور پر تصدیق شدہ منصوبے کے لیے الگ الگ انتخاب ہیں۔

تصدیق اور اشاعت کے درمیان ورکنگ فائلوں کو تبدیل نہ کریں: منظوری کا تعلق قطعی بائٹس سے ہے۔ تنازعات، ناکام پش اور نامعلوم آپریشن کے نتائج واضح فیصلے تک پیش رفت کو روک دیتے ہیں۔ Auto خاموشی سے اشاعت کی اجازت نہیں دیتا۔

Work کوئی Git شاخیں نہیں بناتا اور اس میں Git کی کوئی حتمی شکل نہیں ہوتی۔ منتخب کردہ فولڈر سے مطلوبہ دستاویزات رکھیں، بشمول ورژن اور ذرائع۔

فائل ایڈیٹر ایکسٹینشن کے لحاظ سے نحو، تلاش اور تبدیلی، کالعدم کرنے کی سرگزشت، لائن ریپنگ اور فی ٹیب مسودات فراہم کرتا ہے۔ محفوظ کرنے سے تعاون یافتہ UTF-8/UTF-16 انکوڈنگ برقرار رہتی ہے اور بیرونی ترمیم کے تنازعات کو مسترد کیا جاتا ہے۔ دیگر انکوڈنگز اور بائنری مواد کے لیے بیرونی ایڈیٹر کی ضرورت ہوتی ہے۔ غیر محفوظ شدہ مسودات اس وقت تک ایپلیکیشن کو Quit کرنے سے روکتے ہیں جب تک کہ مالک انہیں محفوظ یا ضائع نہ کر دے۔

مکمل نحو 8 MiB تک فعال ہے۔ بڑی ٹیکسٹ فائلیں 256 KiB ونڈوز میں کھلتی ہیں؛ 8–64 MiB کو بغیر نحو کے مکمل طور پر صریحاً لوڈ کیا جا سکتا ہے۔ 64 MiB سے اوپر ونڈو ایڈیٹنگ اور محدود اگلے میچ کی تلاش کا استعمال کریں۔ یہ ایک محدود بڑی فائل کا موڈ ہے، من مانی بڑی دستاویزات کے لیے سب لائیم ٹیکسٹ (Sublime Text) جیسی برابری نہیں۔

Open folder صرف اصل ریپوزٹری کو خاموشی سے کھولنے کے بجائے موجودہ ٹاسک یا برانچ/ورک ٹری سیاق و سباق کا استعمال کرتا ہے۔ فائل کی قطار اس فائل کی پیرنٹ ڈائرکٹری کو ظاہر کر سکتی ہے۔ رجسٹرڈ ٹاسک گرانٹس کے خلاف بیک اینڈ کے ذریعے راستوں کی توثیق کی جاتی ہے۔ بائنری فائلیں سادہ متن کے طور پر قابل تدوین نہیں ہیں؛ ان کا ٹارگٹ ویور استعمال کریں اور اصل بائٹس برقرار رکھیں۔

ورک ٹری کو ہٹانا ایک الگ محفوظ کارروائی ہے۔ اسے ہٹانے سے پہلے منسلک منظم سیشنز اور ٹرمینلز کو ختم کریں، بشمول وہ سیشنز جو بیکار ہیں۔ محفوظ شدہ Git نتیجے اور بحالی کی حالت کا معائنہ کریں؛ کسی ٹاسک ریکارڈ کو حذف کرنا غیر کمٹ شدہ کام کو محفوظ طریقے سے برقرار رکھنے کا متبادل نہیں ہے۔

متعلقہ ہدایات: ٹائپ شدہ ایڈیٹر کا معاہدہ · Git پالیسیاں.

API کنکشنز

Connections میں واضح طور پر منتخب کردہ OpenAI کے موافق اینڈ پوائنٹ کا اضافہ کیا جاتا ہے۔ ایک نام، بنیادی URL، ماڈل اور ضرورت پڑنے پر کلید درج کریں۔ بہت سے سرورز کے لیے بنیادی URL کا /v1 پر ختم ہونا ضروری ہوتا ہے؛ اپنے اینڈ پوائنٹ کی دستاویزات دیکھیں۔

لوپ بیک HTTP کے علاوہ HTTPS درکار ہے۔ ایسا سادہ اینڈ پوائنٹ استعمال کریں جس کے URL میں اسناد شامل نہ ہوں۔ کلیدیں تعاون یافتہ OS کی انکرپشن استعمال کرتی ہیں اور UI میں واپس نہیں دکھائی جاتیں۔ اینڈ پوائنٹ تبدیل کرنے پر اس کی کلید دوبارہ درج کرنا ضروری ہوتا ہے۔ کلید کے خانے کو خالی چھوڑنے سے محفوظ شدہ کلید برقرار رہتی ہے؛ Remove the saved key واضح طور پر اسے مٹا دیتا ہے۔

API کالز CLI سبسکرپشن استعمال نہیں کرتیں۔ ٹولز اور ماڈلز مقامی سیشنز سے مختلف ہوتے ہیں، اور ماڈل کی کامیاب دریافت استدلال (inference) کو ثابت نہیں کرتی۔ ٹوکن کا استعمال صرف اس وقت ظاہر ہوتا ہے جب فراہم کنندہ واقعی اسے واپس بھیجے۔

اسناد کو ٹاسک کی عبارت یا پیش سیٹ کی ہدایات میں رکھنے کے بجائے Connections میں محفوظ رکھیں۔ صرف پڑھنے کی اجازت رکھنے والے ریویورز صرف اپنے مجاز API فائل ٹولز وصول کرتے ہیں؛ رپورٹ آرکیٹیکٹ کے پاس کوئی ٹولز نہیں ہوتے۔ غیر تعاون یافتہ ٹول کالز خاموشی سے چلانے کے بجائے مسترد کر دی جاتی ہیں۔ سرورز استدلال کے پیرامیٹرز، ٹول سپورٹ اور ماڈل کی فہرستوں میں مختلف ہوتے ہیں؛ کسی نقص کا موازنہ اپنے اینڈ پوائنٹ کے اپنے معاہدے سے کریں۔

متعلقہ ہدایات: API کنکشنز.

ترتیبات، زبانیں اور محفوظ ری سیٹ

عمومی ترتیبات ورک اسپیس، انٹرفیس کی زبان اور پہلے سے طے شدہ اختیارات کا انتخاب کرتی ہیں۔ Connections API اینڈ پوائنٹس کا انتظام کرتا ہے۔ Presets اور Review teams کردار کی ترتیبات کو برقرار رکھتے ہیں۔ Remote control مقامی اسناد، سرور کے دائرہ کار اور مالک کی اجازتوں کا انتظام کرتا ہے؛ Updates ریلیز سورس/چینل کا انتظام کرتا ہے۔ About بالکل وہی بلڈ دکھاتا ہے جو چل رہا ہے۔

انٹرفیس کی زبان پرامپٹ کی زبان اور دستاویزات کے جائزے کی حیثیت سے الگ ہے۔ پروڈکٹ کے نام، کمانڈ IDs، فائل ایکسٹینشنز، فراہم کنندہ ماڈل IDs اور صارف کے تخلیق کردہ نام بطور شناخت کنندہ رہتے ہیں۔ موجودہ ترجمہ دستیاب ہونے پر Help منتخب کردہ انٹرفیس کی زبان کی پیروی کرتی ہے؛ مشینی تراجم پر لیبل لگایا جاتا ہے اور انگریزی ہی مستند حوالہ رہتی ہے۔

Save ظاہر کردہ ترتیب کو لاگو کرتا ہے۔ ڈیٹا بیس کا ری سیٹ یا فیکٹری ری سیٹ ایپلی کیشن کا میٹا ڈیٹا ہٹا سکتا ہے؛ جان بوجھ کر ری سیٹ استعمال کرنے سے پہلے فائلیں اور ایک آزمودہ بیک اپ محفوظ رکھیں۔ یہ کارروائیاں مقامی مالک کے اقدامات ہیں۔ ناکام ورک فلو یا خراب ریکارڈ کی تفتیش کے لیے انہیں شارٹ کٹ کے طور پر استعمال نہ کریں۔

متعلقہ ہدایات: مقامی بنانے کی ہدایات · ڈیٹا کی بحالی.

Help معاون سے پوچھیں

Help کھولیں، اس کے معاون کے پینل میں ایک محفوظ شدہ منسلک پری سیٹ منتخب کریں اور ZIAForge کے بارے میں پوچھیں۔ جوابات موجودہ بنیادی انگریزی گائیڈ اور آپ کی منتخب کردہ انٹرفیس زبان کا استعمال کرتے ہیں۔ سیکشن کے حوالے کے بٹن متعلقہ گائیڈ کے عنوانات کھولتے ہیں، تاکہ آپ وضاحت کا حوالے سے موازنہ کر سکیں۔

یہ معاون 100 محفوظ شدہ اندراجات اور 3 MiB تک کی ایک الگ نجی گفتگو رکھتا ہے۔ 12,000 حروف تک کا سوال درج کریں؛ Send اسے پوچھتا ہے، Stop آپ کے سوال کو دستیاب رکھتے ہوئے فعال جواب منسوخ کر دیتا ہے، اور Clear اس Help گفتگو کو ہٹا دیتا ہے۔ آپ کا نہ بھیجا گیا ڈرافٹ اور پری سیٹ کا انتخاب اسی ایپ سیشن میں Help کو بند کرنے یا دوبارہ کھولنے پر برقرار رہتا ہے، لیکن ڈرافٹ ڈسک پر محفوظ نہیں ہوتا۔ معاون ایپلی کیشن کی کمانڈز نہیں بھیجتا، ورک فلو تبدیل نہیں کرتا یا گیٹ کو قبول نہیں کرتا۔ مشورہ کسی کام، اکاؤنٹ یا بیرونی کنکشن کی لائیو تصدیق نہیں ہے۔

Claude Code اور API Help سیشنز بغیر ٹولز والی معاونت کی پالیسی نافذ کرتے ہیں۔ مقامی Codex اور Antigravity Help سیشنز کے لیے موجودہ مقامی مالک کی مقامی کمپیوٹر اجازت درکار ہوتی ہے۔ اگر یہ غیر فعال ہے تو ایپ کسی دوسرے فراہم کنندہ کا انتخاب کرنے کے بجائے لازمی شرط کی وضاحت کرتی ہے۔ صرف مالک ہی اسے مقامی کنٹرول کی ترتیبات میں فعال کر سکتا ہے؛ معاون خود اسے فعال نہیں کر سکتا۔

Codex Help صرف پڑھنے کے لیے سینڈ باکس کا استعمال کرتا ہے اور ٹول کی منظوری کی درخواستوں کو مسترد کرتا ہے۔ Antigravity پلان موڈ اور اپنے مقامی سینڈ باکس فلیگ کا استعمال کرتا ہے۔ یہ مقامی موڈز آپریٹنگ سسٹم کی بندش کی عالمگیر ضمانت نہیں ہیں۔ سورس گائیڈ ہیش اس حوالے کی شناخت کرتا ہے جو جواب کے لیے استعمال ہوا تھا؛ تیار کردہ وضاحت پھر بھی غلط ہو سکتی ہے، لہذا کارروائی سے پہلے اس کے منسلک سیکشنز کا معائنہ کریں۔ پرانے جوابات پر اس وقت نشان لگایا جاتا ہے جب ان کے سورس گائیڈ کا ورژن موجودہ گائیڈ سے مختلف ہو۔

متعلقہ ہدایات: بنیادی گائیڈ اور ترجمہ کی دیکھ بھال · ایپلی کیشن معاون اور اجازتیں.

معاون اور Telegram

معاون منتخب کردہ پری سیٹ اور وہی ایپلی کیشن کنٹرول API استعمال کرتا ہے۔ حالت کا معائنہ کرنے کی اجازت اور کارروائیاں انجام دینے کی اجازت الگ الگ ہیں۔ کمانڈز اور نتائج کا معائنہ کریں: معاون کا متن اس بات کا ثبوت نہیں ہے کہ کوئی کارروائی مکمل ہو چکی ہے۔

Telegram صرف مقامی مالک ہی فعال کر سکتا ہے، ایک موجودہ بوٹ ٹوکن اور عددی مالک ID کے ساتھ۔ کنٹرول اس مالک کی نجی چیٹ کے لیے ہے۔ غیر ترتیب شدہ یا غیر فعال بوٹ کو ایپلی کیشن کے پیغامات وصول نہیں کرنے چاہئیں۔

بوٹ ٹوکن کو عام چیٹ میں مت چسپاں کریں۔ انضمام کو ترتیب دینا Telegram کے کنیکٹیویٹی کو ثابت نہیں کرتا اور خودکار طور پر بوٹ نہیں بناتا۔ اسکرین شاٹس اور جوابات میں ورک اسپیس کا نجی ڈیٹا ہو سکتا ہے۔

معاون کا پری سیٹ منتخب کریں اور ایپلی کیشن آپریشن کی اجازت معائنے سے الگ دیں۔ Codex اور Antigravity معاون پر عمل درآمد کے لیے مالک کی مقامی اجازت درکار ہوتی ہے؛ انہیں بغیر ٹولز والے API یا Claude سیشن سے خاموشی سے تبدیل نہیں کیا جاتا۔ اسکرین شاٹس معاون کی گفتگو میں دکھائے جا سکتے ہیں، لیکن ماڈل کے موجودہ ان پٹ میں تصویر کا تجزیہ شامل نہیں ہے۔ یہ فرض نہ کریں کہ معاون نے تصویر کا بصری معائنہ صرف اس لیے کیا ہے کیونکہ اس نے اسے دکھایا تھا۔

معاون ٹائپ شدہ ٹولز کے ذریعے خلاصوں، ٹاسکس، چیٹس، ورک فلو کی حالت، پروسیس کے سیاق و سباق اور ایپلی کیشن کی ونڈوز کا معائنہ کر سکتا ہے۔ یہ مجاز عام ترتیبات کو تبدیل کر سکتا ہے اور مجاز ایپلی کیشن آپریشنز شروع کر سکتا ہے۔ یہ مقامی حقوق تفویض نہیں کر سکتا، محفوظ شدہ اسناد کو ظاہر نہیں کر سکتا، روٹ ورک اسپیس گرانٹ کو ریموٹلی تبدیل نہیں کر سکتا یا محض سہولت کی خاطر Forge گیٹ کی منظوری نہیں دے سکتا۔

متعلقہ ہدایات: ایپلی کیشن کنٹرول معاہدہ.

اپنا نجی Telegram بوٹ چلائیں

اپنا بوٹ خود بنائیں یا حاصل کریں، اس کی نجی چیٹ شروع کریں، اور مقامی کنٹرول کی ترتیبات میں اس کا ٹوکن اور اپنا عددی Telegram صارف ID درج کریں۔ انضمام کو صرف اس وقت فعال کریں جب آپ ایپ کو منسلک کرنا چاہتے ہوں۔ مالک ID صارف کا شناخت کنندہ ہے، کوئی صارف نام یا بوٹ ID نہیں۔ صرف اسی نجی چیٹ میں اسی صارف کے پیغامات قبول کیے جاتے ہیں۔

چلنے والے ورژن کے جائزے، پروجیکٹ/ٹاسک کی تعداد اور ٹاسک کی حیثیت کے لیے /start، /menu یا /status استعمال کریں۔ بٹنز Projects، Tasks، Screenshot، Help اور Language کھولتے ہیں۔ فہرستیں ہر صفحے پر آٹھ آئٹمز دکھاتی ہیں، جن میں Back، Refresh، Home اور Previous/Next نیویگیشن ہوتی ہے۔ پروجیکٹ کے بٹن ٹاسک لسٹ کو فلٹر کرتے ہیں۔ ایک ٹاسک کارڈ اس کی محفوظ شدہ ورک فلو کی پیش رفت، ماڈل/پری سیٹ اور زیر التواء سوالات (اگر موجود ہوں) دکھاتا ہے۔

کھلی/حالیہ گفتگو اور ورک فلو کے مرحلے کی چیٹس کا پیش نظارہ دیکھنے کے لیے ٹاسک کی Chats کھولیں۔ ہر پیش نظارہ چھ تازہ ترین صارف/معاون پیغامات دکھاتا ہے، جو نمایاں طور پر 200 حروف تک مختصر کیے جاتے ہیں۔ نجی استدلال نہیں دکھایا جاتا۔ تاریخ پڑھنے سے فراہم کنندہ شروع نہیں ہوتا۔ پیش نظارے صرف پڑھنے کے لیے ہیں: عام متن اور /ask TEXT اب بھی ایپلی کیشن معاون سے مخاطب ہوتے ہیں، کبھی بھی بالواسطہ اس ٹاسک چیٹ سے نہیں جسے آپ دیکھ رہے ہیں۔

Run / Continue موجودہ Code یا Work ورک فلو کو دوبارہ پڑھتا ہے اور ایک اہل محفوظ شدہ ورک فلو شروع کرتا ہے۔ Pause اس کے توقف کی درخواست کرتا ہے۔ ان میں سے کوئی بھی ضروریات، تفصیلات، منصوبہ، جائزے کے نتائج یا سوالات کو قبول نہیں کرتا؛ ایک زیر التواء فیصلہ Run کو روکتا ہے۔ ایپلی کیشن میں فیصلے کریں، یا اس کے عین مطابق موجودہ گیٹ اور ریویژن کے ساتھ واضح طور پر مجاز ٹائپ شدہ کمانڈ استعمال کریں۔

انٹرفیس کی 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} ایک واضح کیٹلاگ کمانڈ بھیجتا ہے۔ دلائل کی ساخت کے لیے لائیو کیٹلاگ پڑھیں۔ بیک اینڈ کی وہی اجازت اور فولڈر گرانٹس لاگو ہوتی ہیں جو ایپلی کیشن میں ہیں۔

ایپ کبھی بھی محفوظ کردہ بوٹ ٹوکن کی قدریں معاون کو نہیں بھیجتی ہے۔ اسکرین شاٹس، خلاصے اور گفتگو کا متن پھر بھی نجی پروجیکٹ کی معلومات پر مشتمل ہو سکتا ہے۔ اگر بوٹ یا مالک کے اکاؤنٹ پر مزید بھروسا نہ رہے تو انضمام کو مقامی طور پر روک دیں۔ بوٹ فراہم کنندہ کے ساتھ افشا شدہ ٹوکن کو تبدیل کریں، پھر اس کی مقامی انکرپٹڈ ترتیب کو اپ ڈیٹ کریں۔

متعلقہ ہدایات: نجی بوٹ اور کمانڈز.

صرف مالک کے لیے مقامی کمپیوٹر کی اجازت

مقامی کمپیوٹر تک رسائی پہلے سے غیر فعال ہوتی ہے۔ صرف مالک ہی اسے مقامی Settings → Remote control میں فعال کر سکتا ہے۔ معاون اور HTTP/MCP/Telegram کمانڈز اپنے لیے اس فلیگ کو فعال نہیں کر سکتیں۔ اگر کسی آپریشن سے انکار کر دیا جائے تو معاون کو اس ترتیب کی وضاحت کرنی چاہیے اور مالک کو فیصلہ کرنے دینا چاہیے۔

واضح طور پر فعال ہونے پر، computer.run ایک قابل عمل فائل، دلائل کی صف اور اختیاری مطلق ورکنگ ڈائرکٹری کو قبول کرتا ہے۔ یہ شیل انٹرپولیشن کا استعمال نہیں کرتا، اس کی 30 سیکنڈ کی حد ہے اور آؤٹ پٹ کو 1 MiB تک محدود کرتا ہے۔ فراہم کردہ گمشدہ یا غلط ڈائریکٹری کو مسترد کر دیا جاتا ہے؛ cwd کو چھوڑنے پر ایپ کی ملکیتی ترتیبات کی ڈائریکٹری استعمال ہوتی ہے، HOME نہیں۔ Quit فعال ملکیتی کمانڈز کو منسوخ کرتا ہے اور ان کے عمل کی صفائی کا انتظار کرتا ہے۔

ایپلی کیشن کو پڑھنے/چلانے کا دائرہ کار اور مقامی رسائی الگ الگ فیصلے ہیں۔ ورک ٹری کسی غیر پابند فراہم کنندہ کی فائل سسٹم تک رسائی کو محدود نہیں کرتا۔ کام کے بعد مقامی رسائی کو منسوخ کر دیں اگر اب اس کی ضرورت نہ ہو، اور معاون کے متن کو ثبوت کے طور پر قبول کرنے کے بجائے کمانڈ کی رسیدوں کا معائنہ کریں۔

متعلقہ ہدایات: صرف مالک کے کنٹرول کا معاہدہ.

براؤزر اور ریموٹ انسٹنسز

مقامی مالک سرور کو فعال کرتا ہے اور اس کا پتہ، پورٹ اور دائرہ کار منتخب کرتا ہے: معائنے کے لیے read یا کارروائیوں کے لیے operate۔ پہلے سے طے شدہ 127.0.0.1 پتہ صرف اسی کمپیوٹر پر دستیاب ہے۔ 0.0.0.0 نیٹ ورک انٹرفیسز پر سنتا ہے؛ اسے فعال کرنے سے پہلے نیٹ ورک تک رسائی کا جائزہ لیں۔

ٹوکن لاگ ان کے بعد براؤزر وہی انٹرفیس کھولتا ہے۔ عوامی لنکس یا اسکرین شاٹس میں ٹوکن شامل نہ کریں۔ تنہا HTTP ٹریفک کو انکرپٹ نہیں کرتا؛ غیر معتبر نیٹ ورک پر محفوظ چینل استعمال کریں۔

مالک URL اور ٹوکن کے ذریعے دوسرے انسٹنسز کو ترتیب دیتا ہے۔ بیک اینڈ درخواستوں کو پراکسی کرتا ہے؛ یہ ان کے پروجیکٹس کو مقامی مشین پر کاپی نہیں کرتا۔ ہر عمل سے پہلے منتخب کردہ انسٹنس کو چیک کریں۔

ٹائپ شدہ کمانڈز اور ایونٹس ایپلی کیشن کا کنٹرول رکھتے ہیں۔ Read کا دائرہ کار ٹاسک میں تبدیلیوں کی اجازت نہیں دیتا۔ مقامی کمپیوٹر کا کنٹرول مقامی مالک کا ایک الگ انتخاب ہے اور پہلے سے غیر فعال ہوتا ہے۔

براؤزر، Telegram اور بیرونی ایجنٹ کے کنٹرول کے لیے ایپ کا چلتے رہنا ضروری ہے۔ ہر انسٹنس کی اپنی نجی پروفائل، ٹاسک کی حالت، ٹوکن اور سرور پورٹ ہوتی ہے۔ خود مختار انسٹنسز کے درمیان ایک ہی پروفائل کو بیک وقت دوبارہ استعمال نہ کریں۔ براؤزر کے ایونٹس اور کمانڈ کے جوابات منتخب کردہ انسٹنس تک محدود ہوتے ہیں؛ UI تبدیل کرنے سے فائلیں منتقل نہیں ہوتیں اور نہ ہی مقامی لاگ ان کاپی ہوتا ہے۔

متعلقہ ہدایات: HTTP اور انسٹنس کا کنٹرول.

OpenClaw، Hermes اور دیگر بیرونی ایجنٹس

تصدیق شدہ ایپلی کیشن کنٹرول API یا بنڈل شدہ MCP stdio برج استعمال کریں۔ سرور کو مقامی طور پر فعال کریں، read یا operate کا انتخاب کریں اور ہر کلائنٹ کو اس انسٹنس کے URL اور ٹوکن کے ساتھ ترتیب دیں۔ اسٹینڈ اکیلا MCP برج چلانے کے لیے Node.js 22 یا اس سے نیا ورژن درکار ہے؛ Electron ایپ آپ کے ایجنٹ کلائنٹ کو انسٹال نہیں کرتی ہے۔ براؤزر کا URL کوئی Streamable HTTP MCP اینڈ پوائنٹ نہیں ہے: اسے stdio برج کو بطور ZIAFORGE_URL فراہم کریں۔

برج ziaforge_status، ziaforge_commands، ziaforge_command اور ziaforge_screenshot کو ظاہر کرتا ہے۔ اسٹیٹس اور لائیو کمانڈ کیٹلاگ سے شروعات کریں، پھر منتخب ٹاسک کے لیے system.context پڑھیں۔ ٹائپ شدہ کمانڈز انہی ریویژن، گیٹ، ٹاسک فولڈر اور صفائی کی جانچوں کی پیروی کرتی ہیں جن کی مقامی UI کرتی ہے۔

لائیو کمانڈ کیٹلاگ میں documentation.guide شامل ہے، جو کہ بنیادی انگریزی گائیڈ ہے، اس کے سورس پاتھ اور sourceSha256 کے ساتھ۔ اندرونی ایپلی کیشن آرکیٹیکٹ اپنے ٹولز کے ذریعے یہی حوالہ حاصل کرتا ہے۔ یہ ایجنٹس کو پرانے نوٹس پر انحصار کیے بغیر پروڈکٹ کا پورا سیاق و سباق فراہم کرتا ہے؛ دستاویزات کبھی رسائی تفویض نہیں کرتیں اور نہ ہی کسی موجودہ انسانی فیصلے کا متبادل بنتی ہیں۔

ایجنٹوں کو ایک مختصر انسانی خیال سے ضروریات، تکنیکی فیصلوں اور منصوبہ بندی پر تبادلہ خیال کرنا چاہیے۔ انہیں واضح انسانی گیٹس، منتخب کردہ ماڈلز، دستی/Auto پالیسی اور مطلوبہ جائزے کو برقرار رکھنا چاہیے۔ انہیں جعلی منظوری نہیں بنانی چاہیے، نئے ID کے تحت غیر یقینی کمانڈز کو دوبارہ نہیں چلانا چاہیے، یا مالک کی منشا کے بغیر Git تبدیلیاں شائع نہیں کرنی چاہئیں۔

متعدد تنصیبات کے لیے متعدد نامزد MCP سرورز ترتیب دیں۔ انسٹنس سوئچنگ ایک روٹنگ فیصلہ ہے، ہم آہنگی نہیں۔ 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 دیکھیں۔

آٹومیشنز انٹرفیس فی الحال ڈسپلے کی تعریفیں اور مقامی رن کاؤنٹرز کو محفوظ کرتا ہے۔ یہ کوئی تصدیق شدہ بار بار چلنے والا شیڈولر نہیں ہے اور یہ ثابت نہیں کرتا کہ پس منظر کا ماڈل ٹرن چلا تھا۔ اصل عمل درآمد کے لیے محفوظ کردہ ورک فلو کنٹرولز، ziaf یا تصدیق شدہ API استعمال کریں اور ان کی رسیدوں کا معائنہ کریں۔ مظاہرے کے پینل کو بغیر نگرانی کے شیڈولنگ سمجھنے کی غلطی نہ کریں۔

متعلقہ ہدایات: ڈسپیچر کمانڈز.

ورژن اور اپ ڈیٹس

About چلنے والا عین ورژن دکھاتا ہے۔ عوامی اپ ڈیٹس کے لیے ایک معتبر GitHub ریلیز ریپوزٹری اور مستحکم یا پیش نظارہ چینل کی ضرورت ہوتی ہے۔ چیکنگ، ڈاؤن لوڈنگ اور انسٹالیشن کی الگ الگ حالتیں ہیں؛ کسی خرابی کا مطلب یہ نہیں ہے کہ اپ ڈیٹ انسٹال ہو گئی ہے۔

خودکار تنصیب دستخط شدہ macOS ریلیزز کے لیے ہے۔ غیر دستخط شدہ ڈیولپمنٹ بلڈز اس طریقہ کار کے ذریعے خود بخود انسٹال نہیں ہوتے۔ دستی تبدیلی کے لیے، موجودہ ایپ کو مکمل طور پر بند کریں اور تصدیق شدہ آرٹفیکٹ استعمال کریں۔

فعال ہونے پر خودکار چیکنگ فوری طور پر چلتی ہے، اور اس کے بعد ہر چھ گھنٹے بعد۔

مستحکم پیش نظارہ ریلیزز کو خارج کرتا ہے؛ پیش نظارہ ڈیولپمنٹ ریلیزز کی بھی اجازت دیتا ہے۔ ایک کامیاب جانچ صرف دستیاب ریلیز کا میٹا ڈیٹا قائم کرتی ہے۔ ڈاؤن لوڈ اور انسٹالیشن کے لیے پلیٹ فارم پیکیج اور کنفیگر شدہ ریلیز فیڈ کی ضرورت ہوتی ہے۔ Linux DEB ڈیلیوری ایک الگ انسٹالر کا راستہ ہے؛ یہ نہ سمجھیں کہ DEB خود بخود macOS اپ ڈیٹ کے طریقہ کار سے اپ گریڈ ہو جائے گا۔

متعلقہ ہدایات: ریلیز کی تیاری.

دوبارہ شروع اور بحالی

macOS پر، مکمل بندش کے لیے Quit / ⌘Q استعمال کریں۔ ونڈو بند کرنے سے ایپ چلتی رہ سکتی ہے۔ ایپلی کیشن کو تبدیل کرنے سے پہلے پرانے ورژن کو مکمل طور پر بند کریں۔

شروع کرنے کے بعد، وہی ٹاسک منتخب کریں۔ تاریخ اور ڈرافٹس واپس آ جاتے ہیں۔ Resume ایک مقامی سیاق و سباق کو بحال کرتا ہے لیکن ڈرافٹ نہیں بھیجتا، قطار کو غیر موقوف نہیں کرتا یا نامعلوم آپریشن کو دہرانے کا اختیار نہیں دیتا۔

اگر Recovery ظاہر ہو تو، 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 Secret Service یا 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 چلائیں۔ ان ایپ Help اسی سورس کو پڑھتی ہے۔ حدود، اجازتوں اور غیر معاون راستوں سمیت اصل نفاذ کے ساتھ اضافے کا جائزہ لیں۔

انٹرفیس کی 56 زبانوں میں سے ہر ایک کی ہیلپ کی الگ حیثیت docs/help/locales.json میں ہے۔ گمشدہ یا نامکمل ہیلپ انگریزی پر واپس چلی جاتی ہے۔ مکمل مشینی ترجمہ شدہ مواد پر لیبل لگایا جاتا ہے اور انسانی جائزے کے دعوے کے بغیر، انگریزی سورس ہیش سے منسلک کیا جاتا ہے۔ انسانی طور پر نظر ثانی شدہ ترجمہ اضافی طور پر اپنے مبصر کو ریکارڈ کرتا ہے۔ ہر ترجمے میں سیکشن کی شناختیں، کارروائیاں، فائل/کمانڈ کے شناخت کنندگان اور تکنیکی حدود کو برقرار رکھنا چاہیے، درست سمت استعمال کرنی چاہیے، اور انگریزی سورس تبدیل ہونے پر اسے تازہ کرنا چاہیے۔

ریلیز کرنے سے پہلے، پرانے تیار کردہ آؤٹ پٹ، غلط لوکیل اسکیفولڈز یا ٹوٹے ہوئے مقامی معاہدے کے لنکس کا پتہ لگانے کے لیے node scripts/help/generate.cjs --check چلائیں۔ UI ترجمے کی جانچ اور ایپلی کیشن کے رویے کی جانچ الگ رہتی ہیں۔ HELP_MAINTENANCE.md شراکت دار اور AI کو اپ ڈیٹ کرنے کا طریقہ کار فراہم کرتا ہے؛ دستاویزات کو ایسے پاس کردہ ٹیسٹ کا دعویٰ نہیں کرنا چاہیے جو نہیں چلایا گیا ہو۔

متعلقہ ہدایات: موجودہ پروجیکٹ کا نقشہ · دستاویزات کی دیکھ بھال · شراکت دار کی ہدایات · ایجنٹ کی ہدایات.