د 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 ستاسو په ماشین کې تیر شوي؛ د دې خپرونې د تایید ریکارډ وګورئ.

د macOS جوړښتونه چې Electron 44 کاروي macOS 13 یا وروسته ته اړتیا لري. په ایپل سیلیکون کې د arm64 کڅوړه او د انټل لپاره د x64 کڅوړه وکاروئ. د ځای پرځای کولو دمخه یو پخوانی اپلیکیشن په بشپړ ډول وتړئ. د مخکتنې کڅوړې ممکن غیر لاسلیک شوې او نوټریزه نه وي؛ د پراختیا هنري توکی د لاسلیک شوي عامه خپرونې په توګه مه ګڼئ.

Windows یو داسې عملیاتي سیسټم ته اړتیا لري چې د بنډل شوي Electron نسخې لخوا ملاتړ کیږي او Git په PATH کې شتون ولري. اړونده معماري غوره کړئ. یو غیر لاسلیک شوی مخکتنه د 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 کڅوړې د دوی د چلولو وخت ټولو فایلونو سره استخراج کړئ. د کڅوړې ځای په ځای کولو پرمهال د کارونکي ډیټا او د اپلیکیشن فایلونه جلا وساتئ.

د سرچینې څخه جوړولو لپاره، نوډ 24، Git او npm ci وکاروئ، په شمول د عادي Electron انسټالر. اصلي بیا رغونه د پلیټ فارم وسیلو ته اړتیا لري: په macOS کې د Xcode کمانډ لاین وسیلې؛ په Windows کې MSVC C++، Windows SDK او پایتون؛ په Linux کې کمپایلر، make، پایتون، pkg-config او اړین بسته بندۍ وسیلې. د دقیقو کمانډونو او اوسني پلیټ فارم محدودیتونو لپاره PLATFORM_BUILDS.md تعقیب کړئ.

د خپریدو نسخې په مرکزي ډول ځانګړې شوي او پایلې یې نه بدلیدونکې دي. د CI تایید جوړښت یو خپور شوی انسټالر نه دی. د سرچینې آرشیفونه سرچینه، لاک فایل، اسناد او سکریپټونه لري؛ انحصارات، اعتبارنامې، د کارونکي پروفایلونه او خصوصي څیړنې ایستل شوي دي. هیڅکله د یو بریالي x64 جوړښت څخه د اصلي ARM یا Windows د اعتبار اټکل مه کوئ.

اړوند لارښوونې: د پلیټفارم کڅوړې، دمخه اړتیاوې او د تایید محدودیتونه · د جوړښت پیژندنه او د خپریدو چکونه.

Code: پنځه لارې

Auto ساحه ارزوي: یوه ساده پوښتنه ممکن په ځواب پای ته ورسیږي، پداسې حال کې چې یوه لویه دنده چمتووالي ته اړتیا لري. د ستونزې حل کول (Fix a bug) یو لامل څیړي او سمون چمتو کوي. لومړی مشخصات (Spec first) په تخنیکي حل پیل کوي؛ لومړی اړتیاوې (Requirements first) د اړتیاوو او د منلو له معیارونو سره پیل کیږي.

څو ماډلي (Multi-model) د پلټنې، ډیزاین، پلي کولو او بیاکتنې لپاره جلا شرایط کاروي. د لارې نوم مختلف چمتو کونکو ته اړتیا نلري: هر رول هغه مخکینی ټاکل شوی (preset) یا Custom ترتیب کاروي چې تاسو یې غوره کوئ.

یو Worktree د دندې د Git بدلونونه جلا کوي. برانچ په ټاکل شوي چیک آوټ کې کار کوي. د پیل کولو دمخه پروژه، څانګه او ماډل وګورئ؛ د دندې تفصیل عادي چټ ته هم نه لیږل کیږي.

د یوې داسې مفکورې لپاره چې نا حل شوي محصول یا تخنیکي انتخابونه لري، لومړی اړتیاوې (Requirements first) وکاروئ او په بحث کې بنسټ کیږدئ. Auto غوښتنه ډلبندي کوي؛ دا یو داسې حکم نه دی چې هره لنډه جمله سمدلاسه پلي کړي. د مسودې خوندي کول غوښتنه له ماډل سره اړیکې نیولو پرته ساتي؛ پیل (Start) یو ځل مدیریت شوی جریان خوندي او پیلوي. له یو څخه تر څلورو دندو کاپي د خپلواک جوړونې پیژندپاڼې او د رول ترتیبات لري.

اړوند لارښوونې: د Code د کاري بهیر تړون · د Code د پرامپټ پروفایلونه.

د Forge بحث

پیل (Start) مرکزي بحث خلاصوي. په طبیعي ډول ځواب ورکړئ، متقابلې پوښتنې وپوښتئ، محدودیتونه اضافه کړئ او تخنیکي انتخابونه بحث کړئ. خبرې اترې او پوښتنې له دندې سره پاتې کیږي.

د متن لیږل یو سند نه مني یا نوي پلي کولو پلان ته اجازه نه ورکوي. د اجرا پرمهال توضیحات لومړی مدیریت شوی وار ودروي او اغیزمن شوې ساحه بیا ګوري. په دمخه منل شوي ګام کې یوې پوښتنې ته ځواب کولی شي هغه ګام ته دوام ورکړي.

په قصدي توګه د بنسټ د بیا لیدو لپاره، اړتیاوې، مشخصات یا پلان جوړونه وټاکئ. یوه نوې نسخه د تړلو پریکړو نوي منلو ته اړتیا لري. بشپړ شوي ګامونه او د هغوی شواهد پاتې کیږي؛ ځای پرځای شوي نامکمل مرحلې په تاریخ کې پاتې کیږي.

د مدیریت شوي مرحلې ناستې له وړیا چټ څخه توپیر لري. د کاري بهیر پورې اړوند ناستې ته مستقیم د لاسي پرامپټونو لیږلو پرځای د Forge بحث وکاروئ.

اړوند لارښوونې: د Forge بحث تړون.

اسناد او پریکړې

یو سند خلاص کړئ، د هغې نسخه وګورئ او د اړتیا په وخت کې سمونونه وکړئ. د بحث له لارې د سمونونو سپارل یوه نوې نسخه تولیدوي؛ راپورونه او تایید شوې پایلې په شاتګ سره بیا نه لیکل کیږي.

د وړاندیز شوي پلان منلو دمخه، ترتیب، لارښوونې، د منلو معیارونه او د تایید امرونه ایډیټ کړئ. هغه کانکریټ امرونه مجاز کړئ چې تاسو پرې پوهیږئ: دوی د دندې په فولډر کې چلیږي. څو ماډلي د بشپړې دندې پلي کولو یو ګام وړاندیز کوي، د هغې په اسنادو او لارښوونو کې له جزیاتو سره.

تاییدول (Approve) یوه جلا او قصدي پریکړه ده. Auto د اړتیاوو، مشخصاتو او پلانونو پوښتنې یا منل له پامه نه غورځوي. یو سند چې بهرني بدلونونه پکې راغلي وي نشي کولی پخوانی تایید بیا وکاروي.

د چمتووالي فایلونه د هنري توکو (artifacts) په توګه ښکاري. د دوی نسخه، تولیدوونکې مرحله او هش دوی له یوې پایلې سره تړي. د Code اسناد له ورک‌ټري څخه بهر ساتل کیږي او په اوتومات ډول کمټ ته نه ننوځي.

د منلو دمخه دواړه سند او ښودل شوې پریکړه وګورئ. منل د اوسنۍ دروازې ID، د پلان بیا کتنه او د ساتل شوي سند هشونه تړي. کله چې ساحه یا شواهد ناسم وي د بدلونونو غوښتنه وکړئ. که چیرې پریکړه زړه شوې وي، د نوي انتخاب کولو دمخه خوندي شوی حالت بیا پورته کړئ؛ یو بدل شوی فایل د پخوانۍ نسخې لاندې نشي منل کیدی.

اړوند لارښوونې: د کاري بهیر دروازې او د سند نسخې.

اجرا او بیاکتنه

کړنلاره (To-do) اصلي ګامونه، اوسنۍ هڅه، د تایید او بیاکتنې پایلې ښیې. د یو استازي لخوا “done” ویل یو ګام نه بشپړوي: د پلان اړین شواهد باید شتون ولري.

لاسي حالت د شرایطو وړ ګامونو ترمنځ دریږي. Auto تایید شوي ګامونه پرمخ وړي او محدودو بیا هڅو ته اجازه ورکوي. وروسته ودرول (Stop after) تل د چک نقطه جوړوي. ځنډول (Pause) د کاري بهیر فعال کار ودروي؛ د یو پینل تړل دا نه ودروي.

یو خپلواک بیاکتونکی له فایلونو او تایید شویو پایلو سره جلا شرایط کاروي. هر اړین بندوونکی موندنه باید حل شي؛ ډیری بیاکتونکي د بندوونکې تېروتنې په اړه رایه نه باطلوي.

په څو ماډلي (Multi-model) کې، د موندنو سمول یوې څرګندې پریکړې ته اړتیا لري. یو سمون په خاموشۍ بله بیاکتنه نه پیلوي: بیا بیاکتنه (Review again) یو نوی دوران پرانیزي. د بیاکتنې تبصرې کولی شي د پلي کولو تکرار پرته د همغږۍ کونکي بیا غور غوښتنه وکړي.

بشپړ شوي ګامونه په پټه نشي ترمیم کیدی. په TDD سره، سور (Red) باید په حقیقت کې د متوقع لامل له امله ناکام شي، بیا شین (Green) باید بریالی شي. محدودې هڅې د نه ختمیدونکو بیا هڅو مخه نیسي.

په Settings → Review teams کې خپلواک CLI/API بیاکتونکي خوندي کړئ، بیا دا ټیم په Code یا Work کې وټاکئ. بیاکتونکي په موازي توګه چلیږي، ورپسې د ټیم د راپور معمار راځي. تاسو کولی شئ پرته له کوم خوندي شوي ټیم څخه هم خپلواک بیاکتونکي ترتیب کړئ. د راپور معمار یوازې نامعلوم جوړښت شوي راپورونه ترلاسه کوي، د پروژې فایلونو یا وسیلو پرته؛ دا جلاوالی اوس مهال Claude Code یا API ته اړتیا لري.

د پلي کولو هر ګام د پلي کیدو وړ چیک، اړینې خپلواکې بیاکتنې، یا دواړو ته اړتیا لري. د چمتووالي مرحلې د دې پرځای باوري پایلې او د هنري توکو رسیدونه ساتي؛ دا داسې نه ښيي چې د پلي کولو ازموینې ترسره شوې وي. یو امر یوازې هغه وخت بریالی کیږي کله چې د هغې اصلي وتلو حالت او د اړوندې پروسې پاکول تایید شي. د TDD لپاره د سور چیک باید د پلي کولو او شین تایید دمخه په نورمال ډول ناکام شي؛ یو ورک اجرایوي فایل یا د وخت پای ته رسیدل د اعتبار وړ سور پایله نه ده.

اصلي بریکران په یوه ګام کې د دریو ناکامو هڅو یا په ټولیز ډول له پنځوسو هڅو وروسته ودریږي. مداخله یوه هڅه مصرفوي مګر پخپله د ناکامې هڅې په توګه نه حساب کیږي. محدودیتونه او بشپړ شوي شواهد له بیا پیل وروسته پاتې کیږي؛ بیا هڅه (Retry) دوی نه بیا تنظیموي. د بلې هڅې د واک ورکولو دمخه ساتل شوې ناکامي ولولئ.

اړوند لارښوونې: تایید او بیاکتنه.

موازي بیاکتونکي ټیمونه او د راپور معمار

امستنې پرانیزئ → Review teams او یو ټیم خوندي کړئ. له خپل CLI یا API، ماډل، د استدلال هڅې او تخصص سره خپلواک بیاکتونکي اضافه کړئ، بیا د راپور معمار وټاکئ. دا ټیم د دندې د بیاکتنې په ترتیب کې غوره کړئ. یو اجرا کوونکی پریسټ هم د یو بیاکتونکي لخوا کارول کیدی شي، او Custom لاهم شتون لري؛ خپلواک رولونه لاهم جلا شرایط لري.

بیاکتونکي د ورته دندې شواهدو باندې په موازي ډول چلیږي. هر اړین راپور، تېروتنه او پریکړه ساتل کیږي. معمار د بیاکتنې د نومونو، ماډل یا چمتو کونکي هویت، د اصلي دندې مینځپانګې، ذخیرې لاسرسي یا وسایلو پرته نامعلوم شمیرل شوي راپورونه ترلاسه کوي. دا راپورونه پرتله کوي او یو جوړښت شوې پریکړه بیرته راګرځوي؛ دا د سرچینې نوې بیاکتنه نه ترسره کوي.

یو بندوونکی موندنه یا د اړین بیاکتونکي رد کول د اکثریت رایو یا د معمار غوره توب لخوا نشي بخښل کیدی. ورک یا ناسم راپورونه د تصویب مخه نیسي. د سمونونو منلو یا مجاز کولو دمخه انفرادي موندنې او مجموعي پریکړه وګورئ. یو خوندي شوی ټیم د منډې لپاره حل شوی او کنګل شوی دی؛ د دې مخکینۍ بڼې ترمیم کول بشپړ شوي شواهد نه بیا لیکي.

یوازې د راپور معمار اوس مهال د Claude یا API ملاتړ شوي د وسیلې څخه پاک ترتیبات کاروي. Codex او Antigravity د بیاکتونکو په توګه شتون لري مګر د دې جلا شوي معمار رول لپاره تر هغه وخته پورې رد کیږي چې د وسیلې څخه پاک تایید شوی تړون شتون ولري. یو پرامپټ چې یوازې “no tools” ووایی کافي نه دی.

اړوند لارښوونې: د ټایپ شوي ټیم ترتیب · د بیاکتنې راټولول.

د ایجنټ تخصصونه او د پرامپټ تګلاره

یو ماډل د اجرا انجن دی؛ یو تخصص د لارښوونې پروفایل دی. د هیڅ اضافه شوي تخصص لپاره None وټاکئ، د ډیفالټ لارښود لپاره Standard، د اړونده جوړ شوي لارښود لپاره Auto، یا د ټاکل شویو لارښودونو او ستاسو خپلو محدودو لارښوونو لپاره Manual غوره کړئ. پریسټونه کولی شي دا انتخاب وساتي.

اصلي کتلاګ عمومي کوډینګ، جوړښت، امنیت، اعتبار، فعالیت، ازموینه او د انټرفیس کارونې اسانتیا پوښي. Auto د لارښود غوره کولو لپاره د دندې/ګام شته متن کاروي؛ دا په پټه بل ماډل ته زنګ نه وهي او نه هم تخصص تصدیقوي. د پلان جوړونې وړاندیزونه د پلي کولو پلان منلو دمخه کتل کیدی شي او بدلیدلی شي.

د بیاکتنې تخصصونه د پام په اړولو کې مرسته کوي مګر هیڅکله د خپلواکو شواهدو، د لاسرسي محدودیتونو یا جوړښت شوې پریکړې ځای نه نیسي. دودیزو لارښوونو سره د دندې د ساحې د یوې برخې په توګه چلند وکړئ: د اسنادو منلو، د وسیلې تګلارې، تصدیق کولو یا د بیاکتنې د ناکامیو څخه د تیښتې لپاره یې مه کاروئ.

اړوند لارښوونې: اصلي پرامپټ کتلاګ.

Work: له پوښتنې تر سنده پورې

Work و Git ته اړتیا نلري. ډیفالټ یو جلا کاري فولډر جوړوي؛ Custom د اصلي ټاکونکي له لارې یو شته فولډر ټاکي. د مسودې خوندي کول پرته له استدلال څخه ترتیبات ساتي؛ پیل (Start) لومړۍ مرحله پرمخ وړي.

Auto مستقیم ځواب ورکوي یا له حقیقي کړنلارو (To-dos) سره مناسب پلان وړاندیز کوي. ذهني طوفان (Brainstorm) ideas.md رامینځته کوي مخکې لدې چې تاسو نور نظرونه یا ارزونه غوره کړئ. څیړنه (Research) findings.md، سرچینې او محدودیتونه ساتي. لیکل (Write) له ارادې څخه، او کله چې ګټور وي، له outline.md څخه یو تشریحي سند یا draft.md ته ځي؛ بیاکتنې مخکینۍ نسخې ساتي.

د فایل توکي د اصلي ټاکونکي له لارې غوره کړئ او د @ سره ورته اشاره وکړئ. اپلیکیشن دوی د نه بدلیدونکو دندو توکو په توګه کاپي کوي او د منډې دمخه د دوی هویت تاییدوي. ډیفالټ د اپلیکیشن پورې اړوند د دندې فولډر جوړوي؛ د Custom فولډر لاسرسی د خوندي شوي مالک اجازه ده. یوه خوندي شوې، نه پیل شوې مسوده کولی شي خپل فولډر بدل کړي.

د خپلواکو اجرا کونکو ترتیباتو سره له 1 څخه تر 4 پورې کاپي جوړې کړئ. هغه دندې چې تکراري فولډرونه کاروي نشي کولی په ورته وخت کې ولیکي. دا همغږي د ZIAForge په عملیاتو پلي کیږي، نه په ناټاکلو بهرنیو پروګرامونو.

ژور ذهني طوفان (Deep Brainstorm) ډیفالټ درې خپلواک کارکوونکي لري او تر اتو پورې ملاتړ کوي. د دوی ترتیب او تنظیمات وټاکئ، په شمول په جلا شرایطو کې د مخکینۍ بڼې بیا کارول. د کارګرانو پوښتنې خپلې ریښې ساتي؛ خراب شوي راپورونه د فارمټ ترمیم یوه هڅه ترلاسه کوي. جزوي ناکامي د دې پرځای چې د متفقې بریا په توګه وښودل شي، ښکاره پاتې کیږي.

ژور (Deep) د ساتل شوي کارګرانو راپورونه په brainstorm_report.md کې یوځای کوي او تل د کارونکي پریکړه غواړي. یو کوچنی تعقیب د همغږۍ کونکي له لارې راپور بیاکتنه کوي؛ یو لوی بدلون د کنګل شویو کارګرانو بل پړاو پیلوي. هنري توکي خپلې نسخې ساتي.

ټاکل شوي رولونه د دندې رامینځته کولو یا څرګند مسودې خوندي کولو پرمهال کنګل کیږي. له لومړي غوښتنې وروسته، یوازې اتوماتیک/لاسي پرمختګ بدلون موندلی شي؛ د مختلفو رول یا ماډل ترتیباتو لپاره نوې دنده وکاروئ. د نړیوال پریسټ ایډیټ کول په خاموشۍ وروستنۍ مرحلې نه بدلوي.

لاسي حالت د شرایطو لرونکو مرحلو ترمنځ دریږي، په شمول د پام وړ د لیکلو لنډیز (Write outline). Auto کولی شي د دې لنډیز له لارې دوام ومومي. پوښتنې، وړاندیز شوي د اجرا وړ پلانونه، د Brainstorm لارښوونه او د Deep راپور بیاکتنه حتی په Auto کې څرګندې پریکړې پاتې کیږي. یوازې یو حواله دا نه ثابتوي چې لټون شوی، او یوازې ساتل شوی بائنري فایل د دې رینډرینګ نه ثابتوي.

اړوند لارښوونې: د Work موډونه او پریکړې.

پریسټونه، ماډلونه او لاسرسی

یو پریسټ CLI/API، ماډل، د استدلال هڅه او اجازې خوندي کوي. د چټ پای برخه پریسټ، CLI، ماډل او د انتخابونو برخې لري. Custom پرته له کوم پریسټ څخه کار کوي؛ Create preset اوسنی انتخاب خوندي کوي.

کتلاګ د ټاکل شوي نصب شوي CLI یا API څخه راځي چیرې چې ملاتړ کیږي. تازه کول (Refresh) لیست تازه کوي پرته له دې چې انتخاب بدل کړي. که کشف شتون ونلري، یو واضح ماډل ID دننه کړئ؛ چمتو کونکی باید لاهم د هغې ملاتړ وکړي. د استدلال کچې په ماډل او CLI پورې اړه لري. د چمتو کونکي ډیفالټ له روښانه none نښې څخه جلا دی.

بدلونونه یوازې د شاته پای تصدیق وروسته پلي کړئ. د فعال وار یا غیر تش قطار په جریان کې بدلون محدود دی. مسودې او لیدل کیدونکی تاریخ پاتې کیږي، مګر د چمتو کونکو بدلول د دوی خصوصي داخلي حالت نه لیږدوي.

په Forge کې، د رول لیبل مهم دی: چمتووالی کولی شي یو جلا پلان جوړونکی (Planner) وکاروي. پای پاڼه ښودل شوی رول بدلوي؛ بیاکتونکي او مرستندویان د کاري بهیر په ترتیباتو کې ټاکل کیږي. د مخکې تایید شوي تطبیق لپاره تګلاره ممکن بنده وي.

اجازې د چمتو کونکو ترمنځ توپیر لري. یوازې لوستل (Read only) او په کارځای کې لیکل (Workspace write) هلته شتون لري چیرې چې اډاپټر یې ملاتړ کوي. Antigravity د اصلي CLI ترتیبات یا په څرګند ډول ټاکل شوی بشپړ لاسرسی کاروي. بشپړ لاسرسی یو سنډباکس ندی.

تخصص د پرامپټ لارښود اضافه کوي، نه بل ماډل یا اجازه. پریسټونه او رولونه د None، Standard، Auto او Manual ملاتړ کوي. Auto د ګام متن څخه د اضافي ماډل کال پرته پروفایلونه غوره کوي؛ Manual تر څلورو پورې تخصصونه او دودیزې لارښوونې مني. د پلان جوړونکي لخوا وړاندیز شوي ګمارنې د پلان منلو دمخه ترمیم کیدی شي.

په لاسي ډول دننه شوی ماډل ID یا هڅه ستاسو انتخاب پاتې کیږي، مګر چمتو کونکی ممکن دا رد کړي. د نړیوال پریسټ ترمیم کول روان چټ یا منل شوی پلان په پخواني ډول نه بدلوي. د یوې بې کاره خبرې اترې په قصدي توګه بدلولو لپاره، د هغې خپل تنظیمي کنټرولونه وکاروئ او تصدیق ته انتظار وکړئ. یو غیر فعال شوی اختیار باید د وړتیا یا ژوند دورې محدودیت په توګه ولوستل شي، نه دا چې د خوندي شوي JSON په ترمیمولو سره له پامه وغورځول شي.

اړوند لارښوونې: د چمتو کونکي وړتیاوې.

چټونه، Stop او قطار

پرانستې ژبې (tabs)، وروستي او مسودې په یوه دنده پورې اړه لري. د یوې ژبې تړل دا له Open څخه لرې کوي مګر په Recent کې یې ساتي او د دې پروسیسر یا مدیریت شوي کاري بهیر نه ودروي. تاریخ ولټوئ، یو چټ بیا پرانیزئ یا د تاریخ له مینو څخه نور ټول ټبونه وتړئ.

بندول (Stop) روان وار شلوي. د بل لیږلو مخکې د دریدو بشپړیدو ته انتظار وکړئ: د مداخلې منل د پروسې بشپړیدل ندي. تاسو کولی شئ په دې موده کې بله مسوده ولیکئ.

په عادي چټ کې، قطار (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 څخه پورته د کړکۍ ترمیم او محدود بل-سمون لټون وکاروئ. دا د لوی فایلونو محدود حالت دی، نه د بې حده لویو اسنادو لپاره د سبلائم ټیکس مساوي.

فولډر خلاصول (Open folder) د اصلي ذخیرې په خاموشۍ خلاصولو پرځای اوسنی کار یا د څانګې/ورک‌ټري شرایط کاروي. د فایل قطار کولی شي د هغه فایل اصلي لارښود وښیې. لارې د شاته پای لخوا د ثبت شوې دندې د اجازو پراساس باوري کیږي. بائنري فایلونه د ساده متن په توګه نشي ترمیم کیدی؛ د دوی هدفي لیدونکي وکاروئ او اصلي بایټونه وساتئ.

د ورک‌ټري لرې کول یو جلا او خوندي عمل دی. د دې لرې کولو دمخه ضمیمه شوي جوړښت شوي ناستې او ټرمینلونه پای ته ورسوئ، پشمول هغه ناستې چې بې کاره دي. خوندي شوې Git پایله او د رغیدو حالت وګورئ؛ د دندې د ریکارډ ړنګول د نه سپارل شوي کار په خوندي توګه ساتلو بدیل نه دی.

اړوند لارښوونې: د ټایپ شوي ایډیټر تړون · د Git تګلارې.

د API پیوستونونه

پیوستونونه په څرګند ډول ټاکل شوی د OpenAI-سره مطابقت لرونکی وروستی ټکی (endpoint) اضافه کوي. یو نوم، بنسټیز URL، ماډل او که اړتیا وي کلۍ دننه کړئ. ډیری سرورونه یو داسې بنسټیز URL غواړي چې په /v1 پای ته رسیږي؛ د خپل وروستي ټکي اسناد وګورئ.

له لوپ‌بیک HTTP پرته، HTTPS اړین دی. یو ساده وروستی ټکی وکاروئ پرته له دې چې په URL کې دننه اعتبارنامې شاملې وي. کیلیانې د OS ملاتړ شوی انکرپشن کاروي او بېرته UI ته نه ښودل کېږي. د وروستي ټکي بدلون د هغې د کلۍ بیا دننه کول غواړي. د کلۍ ساحه تشه پریښودل خوندي شوې کلۍ ساتي؛ د خوندي شوې کلۍ لرې کول (Remove) دا په صریح ډول پاکوي.

د API غوښتنې د CLI ګډون نه کاروي. وسیلې او ماډلونه له اصلي ناستو (sessions) سره توپیر لري، او د ماډل بریالی موندنه د استدلال ثبوت نه دی. د ټوکن کارول یوازې هغه وخت ښکاري چې چمتو کوونکی یې په حقیقت کې بیرته راستانه کړي.

اعتبارنامې د کاري روښانتیاو یا پریسټلارښوونو پرځای په پیوستونونو کې وساتئ. یوازې لوستونکي ارزونکي یوازې د API فایل مجاز وسایل ترلاسه کوي؛ د راپور معمار هیڅ وسیلې نلري. د وسیلو غیر ملاتړ شوي زنګونه د خاموشه پلي کیدو پرځای رد کیږي. سرورونه په استدلال پیرامیټرو، د وسیلې ملاتړ او ماډل لیستونو کې توپیر لري؛ یوه تېروتنه د خپل وروستي ټکي له تړون سره پرتله کړئ.

اړوند لارښوونې: د API پیوستونونه.

ترتیبات، ژبې او خوندي بیا تنظیمول

عمومي ترتیبات کارځای، د انټرفیس ژبه او ډیفالټونه ټاکي. پیوستونونه د API وروستي ټکي اداره کوي. پریسټونه او Review teams د رول ترتیبات ساتي. لیرې کنټرول سیمه ایز اعتبارنامې، د سرور ساحه او د مالک اجازې اداره کوي؛ تازه معلومات د خپریدو سرچینه/چینل اداره کوي. په اړه (About) روان کره جوړښت ښیې.

د انټرفیس ژبه د پرامپټ ژبې او د اسنادو د بیاکتنې له وضعیت څخه جلا ده. د محصول نومونه، د کمانډ ID ګانې، د فایل پسوندونه، د چمتو کونکي ماډل ID ګانې او د کاروونکي له خوا رامنځته شوي نومونه د پیژندونکو په توګه پاتې کیږي. مرسته د ټاکل شوې انټرفیس ژبې پیروي کوي کله چې اوسنۍ ژباړه شتون ولري؛ د ماشین ژباړې لیبل شوي او انګلیسي د کینونیکي حوالې په توګه پاتې کیږي.

خوندي کول ښودل شوی تشکیلات پلي کوي. د ډیټابیس بیا تنظیم یا فابریکې بیا تنظیم کولی شي د غوښتنلیک میټاډاټا لرې کړي؛ په قصدي توګه د بیا تنظیم کولو کارولو دمخه فایلونه او یو ازمویل شوی بیک اپ وساتئ. دا عملیات د ځایی مالک کړنې دي. دا د ناکام شوي کاري فلو یا فاسد ریکارډ د پلټنې لپاره د لنډې لارې په توګه مه کاروئ.

اړوند لارښوونې: د ځايي کولو لارښوونې · د ډاټا بیا رغونه.

د مرستې له مرستیال څخه وپوښتئ

مرسته خلاصه کړئ، د هغې د مرستیال په پینل کې یوه خوندي شوې وصل شوې مخکینۍ بڼه وټاکئ او د ZIAForge په اړه پوښتنه وکړئ. ځوابونه د اوسني کینونیکي انګلیسي لارښود او ستاسو د ټاکل شوې انټرفیس ژبې څخه کار اخلي. د برخې حوالې تڼۍ اړوند لارښود موضوعات پرانیزي، ترڅو تاسو وکولی شئ وضاحت له حوالې سره پرتله کړئ.

دا مرستیال تر 100 پورې خوندي شوو ثبتونو او 3 MiB پورې یو جلا خصوصي خبرې اترې ساتي. تر 12,000 کرکټرونو پورې یوه پوښتنه ولیکئ؛ لېږل (Send) یې پوښتي، درول (Stop) فعال ځواب لغوه کوي پداسې حال کې چې ستاسو پوښتنه د لاسرسي وړ ساتي، او پاکول (Clear) د مرستې دا خبرې اترې لرې کوي. ستاسو نه لېږل شوې مسوده او د مخکینۍ بڼې انتخاب په ورته اپلېکېشن ناسته کې د مرستې بندولو یا بیا خلاصولو سره پاتې کیږي، مګر مسوده په ډیسک کې نه خوندي کیږي. مرستیال د اپلېکېشن کمانډونه نه لېږي، د کار بهیر نه بدلوي یا کوم ګېټ نه مني. مشوره د یوې دندې، حساب یا بهرني پیوستون ژوندۍ تایید نه دی.

د Claude Code او API د مرستې ناستې د ملاتړ شوې بې له وسیلو تګلارې تطبیق کوي. اصلي Codex او Antigravity مرستندویه ناستې د شته ځايي مالک اصلي کمپیوټر اجازې ته اړتیا لري. که دا غیر فعال وي، اپلېکېشن د بل چمتو کونکي غوره کولو پرځای مخکینی شرط تشریح کوي. یوازې مالک کولی شي دا په ځايي کنټرول ترتیباتو کې فعاله کړي؛ مرستیال نشي کولی پخپله دا فعال کړي.

د Codex مرسته یوازې د لوستلو سینډبکس کاروي او د وسیلې تصویب غوښتنې ردوي. Antigravity د پلان حالت او د هغې اصلي سینډبکس بیرغ کاروي. دا اصلي حالتونه د عملیاتي سیسټم د محدودیت نړیوال تضمین نه دی. د سرچینې لارښود هش هغه حواله پیژني چې د ځواب لپاره کارول کیږي؛ یو رامینځته شوی وضاحت لاهم غلط کیدی شي، نو د عمل کولو دمخه د هغې لینک شوې برخې معاینه کړئ. زاړه ځوابونه هغه وخت نښه کیږي کله چې د دوی د سرچینې لارښود نسخه د اوسني لارښود څخه توپیر ولري.

اړوند لارښوونې: کینونیکي لارښود او د ژباړې ساتنه · د اپلېکېشن مرستیال او اجازې.

مرستیال او Telegram

مرستیال ټاکل شوې مخکینۍ بڼه او د اپلېکېشن د کنټرول ورته API کاروي. د وضعیت د معاینه کولو اجازه او د عملیاتو ترسره کولو اجازه جلا دي. کمانډونه او پایلې معاینه کړئ: د مرستیال نثر د دې ثبوت نه دی چې کوم عمل بشپړ شوی دی.

Telegram یوازې د ځايي مالک له خوا، د شته بوټ ټوکن او د مالک عددي ID سره فعالېږي. کنټرول د هغه مالک د خصوصي چیټ لپاره دی. یو ناپیکربندي شوی یا غیرفعال بوټ باید د اپلېکېشن پیغامونه ترلاسه نه کړي.

د بوټ ټوکن په عادي چیټ کې مه پیست کوئ. د انټیګرېشن تنظیمول د Telegram اتصال نه ثابتوي او په خپله یو بوټ نه جوړوي. سکرین شاټونه او ځوابونه ښايي د کاري ساحې خصوصي معلومات ولري.

د مرستیال یوه مخکینۍ بڼه وټاکئ او د اپلېکېشن د عملیاتو اجازه له تفتیش څخه جلا ورکړئ. د Codex او Antigravity مرستیال اجرا کول د مالک اصلي اجازې ته اړتیا لري؛ دوی په پټه د وسیلې پرته API یا Claude ناستې سره نه بدلېږي. سکرین شاټونه د مرستیال په خبرو اترو کې ښودل کېدای شي، مګر د اوسني ماډل انپټ د عکس تحلیل نه لري. داسې فرض مه کوئ چې مرستیال یوازې د دې لپاره چې یو عکس یې ښودلی، هغه یې په سترګو معاینه کړی هم دی.

مرستیال کولی شي د ټایپ شوو وسیلو له لارې لنډیزونه، دندې، چیټونه، د کاري جریان وضعیت، د پروسې سیاق او د اپلېکېشن کړکۍ وپلټي. دا کولی شي مجاز عادي ترتیبات بدل کړي او د اپلېکېشن مجاز عملیات پیل کړي. دا نشي کولی اصلي حقونه ورکړي، خوندي شوي اسناد افشا کړي، د اصلي کاري ځای اجازه له لرې لارې بدله کړي یا یوازې د اسانتیا په خاطر د Forge ګېټ تایید کړي.

اړوند لارښوونې: د اپلېکېشن د کنټرول تړون.

خپل شخصي Telegram بوټ چل کړئ

خپل بوټ جوړ کړئ یا یې ترلاسه کړئ، د هغه شخصي چیټ پیل کړئ، او د هغه ټوکن او خپل عددي Telegram کاروونکي ID په ځایی کنټرول ترتیباتو کې داخل کړئ. انټیګریشن یوازې هغه وخت فعال کړئ کله چې تاسو اراده لرئ چې ایپ وصل شي. د مالک ID د کاروونکي پیژندونکی دی، نه د کارونکي نوم یا د بوټ ID. یوازې په هغه ورته شخصي چیټ کې د هغه کارونکي پیغامونه منل کیږي.

د روانې نسخې، د پروژې/دندې شمیرو او د دندې حالتونو عمومي لید لپاره /start، /menu یا /status وکاروئ. تڼۍ پروژې، دندې، سکرین شاټ، مرسته او ژبه پرانیزي. لیستونه په هر مخ اته توکي ښیې، د شاته (Back)، تازه کول (Refresh)، کور (Home) او پخوانی/بل (Previous/Next) نیویګیشن سره. د پروژې بټن د دندو لیست فلټر کوي. د کارډ کارت د هغه خوندي شوی کاري فلو پرمختګ، ماډل/پریسیټ او پاتې پوښتنې کله چې شتون ولري ښیې.

د پرانیستو/وروستیو خبرو اترو او د کاري جریان مرحلې چیټونو مخکتنې لپاره د یوې دندې چیټونه (Chats) خلاص کړئ. هر مخکتنه تر شپږو پورې وروستي کارونکي/مرستیال پیغامونه ښیې، چې په ښکاره ډول هر یو تر 200 حروفو پورې لنډ شوي. شخصي استدلال نه ښودل کیږي. د تاریخ لوستل یو برابرونکی نه پیلوي. مخکتنې یوازې د لوستلو لپاره دي: عادي متن او /ask TEXT لاهم د غوښتنلیک مرستیال ته خطاب کوي، هیڅکله په ضمني توګه د دندې چیټ ته چې تاسو یې ګورئ خطاب نه کوي.

چلول / دوام ورکول (Run / Continue) اوسنی Code یا Work کاري فلو بیا لولي او یو وړ خوندي شوی کاري فلو پیلوي. ځنډول (Pause) د هغې د ځنډولو غوښتنه کوي. هیڅ یو یې اړتیاوې، مشخصات، پلان، د بیاکتنې موندنې یا پوښتنې نه مني؛ پاتې پریکړه د چلولو مخه نیسي. په اپلیکیشن کې پریکړې وکړئ، یا د هغې د دقیقې اوسنۍ دروازې او بیاکتنې سره په ښکاره ډول مجاز شوی ټایپ شوی کمانډ وکاروئ.

د ژبې (Language) یا /language څخه کار واخلئ ترڅو د 56 انٹرفیس ژبو څخه هر یو د هغې په اصلي نوم وټاکئ. دا یوازې د دې بوټ او مالک لپاره غوره توب دوامدار ساتي. د اپلیکیشن ژبه وکاروئ (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) د ملکیت فعال کمانډونه لغوه کوي او د دوی د پروسې پاکولو ته انتظار باسي.

د غوښتنلیک د لوستلو/چلولو ساحه او اصلي لاسرسی جلا پریکړې دي. یو کاري وننه (worktree) د غیر محدود چمتو کونکي د فایل سیسټم لاسرسی نه محدودوي. که نور اړتیا نه وي، د دندې وروسته اصلي لاسرسی لغوه کړئ، او د ثبوت په توګه د مرستیال نثر منلو پرځای د کمانډ رسیدونه معاینه کړئ.

اړوند لارښوونې: یوازې د مالک د کنټرول تړون.

براوزر او لرې پرتو بېلګې

ځایی مالک سرور فعالوي او د هغې پته، پورټ او ساحه غوره کوي: د معاینې لپاره لوستل یا د عملونو لپاره چلول. ډیفالټ 127.0.0.1 پته یوازې پدې کمپیوټر کې شتون لري. 0.0.0.0 د شبکې انٹرفیسونو ته غوږ نیسي؛ د فعالولو دمخه د شبکې لاسرسی بیاکتنه وکړئ.

یو براوزر د ټوکن ننوتلو وروسته ورته انٹرفیس خلاصوي. په عامه لینکونو یا سکرین شاټونو کې ټوکنونه مه شاملوئ. یوازې HTTP ټرافیک نه کوډ کوي؛ په نا باوري شبکه کې یو خوندي چینل وکاروئ.

مالک نورې بېلګې د URL او ټوکن په واسطه تنظیموي. بیک انډ غوښتنې پراکسي کوي؛ دا د هغوی پروژې په محلي ماشین کې کاپي نه کوي. د هر عمل څخه دمخه ټاکل شوی مثال وګورئ.

ټایپ شوي کمانډونه او پیښې د غوښتنلیک کنټرول لیږدوي. د لوستلو ساحه د دندې بدلونونو اجازه نه ورکوي. د اصلي کمپیوټر کنټرول د ځایی مالک جلا انتخاب دی او غیر فعال پیل کیږي.

ایپ باید د براوزر، Telegram او بهرني اجنټ کنټرول لپاره روان وي. هر مثال خپل شخصي پروفایل، د دندې حالت، ټوکن او سرور پورټ لري. د خپلواکو مثالونو ترمنځ په ورته وخت کې یو پروفایل بیا مه کاروئ. د براوزر پیښې او کمانډ ځوابونه ټاکل شوي مثال ته ځانګړي دي؛ د UI بدلول فایلونه نه بدلوي یا اصلي ننوتل نه کاپي کوي.

اړوند لارښوونې: HTTP او د مثال کنټرول.

OpenClaw، Hermes او نور بهرني اجنټان

د تصدیق شوي غوښتنلیک کنټرول API یا د بنډل شوي MCP stdio پل څخه کار واخلئ. سرور په محلي ډول فعال کړئ، لوستل یا چلول وټاکئ او هر پیرودونکی د هغه مثال URL او ټوکن سره تنظیم کړئ. د سټینډ الون MCP پل چلولو لپاره Node.js 22 یا نوي ته اړتیا ده؛ د Electron اپلیکیشن ستاسو د اجنټ پیرودونکی نه انسټالوي. د براوزر URL د سټریم ایبل HTTP MCP پای ټکی نه دی: دا د ZIAFORGE_URL په توګه stdio پله ته ورکړئ.

پل 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 او د Git بدلونونو لپاره operationId. د نامعلوم منلو وروسته اصلي هویت او تادیه خوندي کړئ؛ مخکې لدې چې په قصدي ډول نوي کار صادر کړئ خوندي شوی حالت ولولئ.

اړوند لارښوونې: د 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 وکاروئ. د پیل یو بریالی تایید پدې معنی ندي چې دنده بشپړه شوې.

--until-success په قصدي توګه د خوندي شوي کاري جریان لپاره Auto فعالوي، مګر پوښتنې، بیاکتنه، د منلو دروازې، محدودیتونه او د چک ټکي لاهم پلي کیږي. Ctrl+C د کتنې ډیسپیچر څخه وځي؛ دا په ښکاره ډول د غوښتنلیک کاري جریان نه ودروي. د وتلو کوډونو، محلي پای ټکي او پروفایل سمبالولو لپاره CLI.md وګورئ.

د Automations انٹرفیس دا مهال د ښودلو تعریفونه او ځایی چلولو کاونټرونه ذخیره کوي. دا یو تصدیق شوی تکراري مهالویش نه دی او دا نه ثابتوي چې د شالید ماډل باری روان دی. د حقیقي اجرا کولو لپاره خوندي شوي کاري فلو کنټرولونه، ziaf یا مستند API وکاروئ او د هغوی رسیدونه معاینه کړئ. د بې پامه مهالویش لپاره د مظاهرې پینل غلط مه کوئ.

اړوند لارښوونې: د ډیسپیچر کمانډونه.

نسخه او تازه معلومات

د About برخه کره روانه نسخه ښیي. عامه تازه معلومات د باور وړ GitHub د خپریدو ذخیره او یو مستحکم یا مخکتنې چینل ته اړتیا لري. کتنه، ډاونلوډ کول او انسټال کول جلا حالتونه لري؛ تېروتنه پدې معنی نه ده چې تازه معلومات انسټال شوي دي.

اتوماتیک انسټالیشن د لاسلیک شوي macOS ریلیزونو لپاره دی. نه لاسلیک شوي پرمختیایي جوړښتونه د دې میکانیزم له لارې په اتوماتيک ډول نه انسټال کیږي. د لاسي بدلولو لپاره، اوسنی ایپ په بشپړه توګه وتړئ او یو تایید شوی هنري اثر وکاروئ.

اتوماتیک کتنه سمدلاسه چلیږي کله چې فعاله شي، بیا په هر شپږو ساعتونو کې.

ثابت (Stable) د مخکتنې ریلیزونه نه پکې شاملوي؛ مخکتنه (Preview) د پراختیا ریلیزونو ته هم اجازه ورکوي. یو بریالی چک یوازې د موجود ریلیز میټاډاټا رامینځته کوي. ډاونلوډ او انسټالیشن د پلیټ فارم کڅوړې او تنظیم شوي ریلیز فیډ ته اړتیا لري. د 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 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 چل کړئ. په اپلیکیشن کې مرسته ورته سرچینه لولي. د اصلي پلي کولو سره اضافه شوي توکي بیاکتنه وکړئ، پشمول حدود، اجازې او نه ملاتړ شوي لارې.

د 56 انٹرفیس ژبو څخه هر یو په docs/help/locales.json کې د جلا مرستې حالت لري. ورکه یا نیمګړې مرسته بیرته انګلیسي ته راګرځي. بشپړ ماشین ژباړل شوي متنونه لیبل شوي او د انګلیسي سرچینې هش سره تړلي دي، پرته له دې چې د انسان د بیاکتنې ادعا وشي. د انسان لخوا بیاکتل شوې ژباړه سربیره پردې خپل بیاکتونکی ثبتوي. هره ژباړه باید د برخې IDs، عملونه، د فایل/کمانډ پیژندونکي او تخنیکي محدودیتونه وساتي، سم لوری وکاروي، او کله چې د هغې انګلیسي سرچینه بدله شي نو باید تازه شي.

د لیږدولو دمخه، node scripts/help/generate.cjs --check چل کړئ ترڅو زوړ تولید شوی محصول، د باطل ژبې جوړښتونه یا مات شوي محلي قرارداد لینکونه ومومي. د UI ژباړې چکونه او د غوښتنلیک چلند چکونه جلا پاتې کیږي. HELP_MAINTENANCE.md د ونډه اخیستونکي او AI تازه کولو پروسه وړاندې کوي؛ اسناد باید د داسې بریالۍ ازموینې ادعا ونه کړي چې نه وي ترسره شوې.

اړوند لارښوونې: د اوسنۍ پروژې نقشه · د اسنادو ساتنه · د ګډونوال لارښوونې · د اجنټ لارښوونې.