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 немесе одан кейінгі нұсқасын қажет етеді. Apple Silicon үшін arm64 пакетін, ал Intel үшін x64 пакетін пайдаланыңыз. Ауыстыру алдында ескі қолданбаны толығымен жабыңыз. Алдын ала қарау пакеттері қол қойылмаған және нотариалды куәландырылмаған болуы мүмкін; әзірлеу артефактісін қол қойылған жалпыға қолжетімді шығарылыммен шатастырмаңыз.

Windows жүйесіне жиынтықтағы Electron нұсқасы қолдайтын операциялық жүйе және PATH ішінде қолжетімді Git қажет. Сәйкес архитектураны таңдаңыз. Қол қойылмаған алдын ала қарау нұсқасында Authenticode сертификаты жоқ. Тасымалы ZIP тек орындалатын файлды ғана емес, толық қолданба каталогы мен орындалу уақытының файлдарын сақтауы керек.

Linux жүйесіне үйлесімді графикалық жұмыс үстелі, Electron талап ететін жүйелік кітапханалар және Git қажет. Шифрланған басқару деректері үшін gnome-libsecret немесе KWallet сияқты жұмыс істейтін Secret Service қызметін ұсыныңыз; қауіпсіз емес basic_text сервері қабылданбайды. Графикалық интерфейссіз/контейнердегі тексеру дәлелдері әрбір жұмыс үстелін немесе дистрибутивті растамайды.

DEB пакетін apt install ./file.deb арқылы орнатыңыз немесе RPM пакетін дистрибутивтің пакет менеджері арқылы орнатыңыз. AppImage орындалу рұқсатын және сәйкес FUSE қолдауын қажет етеді; қолдау көрсетілетін жерде --appimage-extract-and-run балама болып табылады. tar.gz және ZIP пакеттерін олардың барлық орындалу уақыты файлдарымен бірге шығарыңыз. Пакетті ауыстыру кезінде пайдаланушы деректері мен қолданба файлдарын бөлек ұстаңыз.

Бастапқы кодтан құрастыру үшін қалыпты Electron орнатқышын қоса, Node 24, Git және npm ci пайдаланыңыз. Жүйелік қайта құрастырулар платформалық құралдарды қажет етеді: 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 сұрауды жіктейді; бұл әрбір қысқа сөз тіркесін бірден іске асыру туралы бұйрық емес. «Жобаны сақтау» модельге хабарласпай сұрауды сақтайды; «Бастау» басқарылатын ағымды бір рет сақтайды және іске қосады. Тапсырманың бірден төртке дейінгі көшірмелерінің тәуелсіз құру идентификаторлары және рөл параметрлері болады.

Байланысты нұсқаулықтар: Code жұмыс процесінің келісімі · Code нұсқау профильдері.

Forge талқылауы

«Бастау» орталық талқылауды ашады. Табиғи түрде жауап беріңіз, қарсы сұрақтар қойыңыз, шектеулер қосыңыз және техникалық таңдауларды талқылаңыз. Әңгіме мен сұрақтар тапсырмамен бірге қалады.

Мәтін жіберу құжатты қабылдамайды немесе жаңа іске асыру жоспарына рұқсат бермейді. Орындау кезіндегі түсініктеме алдымен басқарылатын қадамды кідіртеді және әсер еткен ауқымды қайта қарайды. Қабылданған қадамдағы сұраққа жауап сол қадамды жалғастыра алады.

Негізді мақсатты түрде қайта қарау үшін «Талаптар», «Спецификация» немесе «Жоспарлау» тармағын таңдаңыз. Жаңа нұсқа тәуелді шешімдерді қайта қабылдауды қажет етеді. Аяқталған қадамдар мен олардың дәлелдері қалады; ауыстырылған аяқталмаған кезеңдер тарихта қалады.

Басқарылатын кезең сессиялары еркін чаттан өзгешеленеді. Жұмыс процесіне тиесілі сессияға қолмен нұсқауларды тікелей жіберудің орнына Forge талқылауын пайдаланыңыз.

Байланысты нұсқаулықтар: Forge талқылау келісімі.

Құжаттар мен шешімдер

Құжатты ашыңыз, оның нұсқасын тексеріңіз және қажет болған жағдайда түзетулер енгізіңіз. Талқылау арқылы түзетулерді жіберу жаңа нұсқаны шығарады; есептер мен тексерілген нәтижелер өткен мерзімге қайта жазылмайды.

Ұсынылған жоспарды қабылдамас бұрын ретті, нұсқауларды, қабылдау критерийлерін және тексеру пәрмендерін өңдеңіз. Өзіңіз түсінетін нақты командаларға рұқсат беріңіз: олар тапсырма қалтасында орындалады. Көпмодельді режим құжаттары мен нұсқауларында егжей-тегжейлері бар бір толық тапсырманы орындау қадамын ұсынады.

«Бекіту» — бұл жеке, саналы шешім. Auto талаптарды, техникалық сипаттамаларды және жоспарларды қабылдауды немесе сұрақтарды айналып өтпейді. Сырттан өзгертілген құжат ескі мақұлдауды қайта пайдалана алмайды.

Дайындық файлдары артефакт ретінде пайда болады. Олардың нұсқасы, шығарушы кезеңі және хэші оларды нәтижемен байланыстырады. Code құжаттары жұмыс ағашынан тыс сақталады және коммитке автоматты түрде енгізілмейді.

Қабылдамас бұрын құжатты да, көрсетілген шешімді де тексеріңіз. Қабылдау ағымдағы қақпаның ID, жоспар редакциясын және сақталған құжат хэштерін бекітеді. Ауқым немесе дәлелдеме қате болған кезде өзгертулерді сұраңыз. Егер шешім ескірген болса, жаңа таңдау жасамас бұрын сақталған күйді қайта жүктеңіз; өзгертілген файл бұрынғы нұсқа бойынша қабылданбайды.

Байланысты нұсқаулықтар: Жұмыс процесінің қақпалары және құжат нұсқалары.

Орындау және шолу

«Орындалатын істер» нақты қадамдарды, ағымдағы әрекетті, тексеру және шолу нәтижелерін көрсетеді. Агенттің «орындалды» деуі қадамды аяқтамайды: жоспар талап ететін дәлелдер болуы керек.

Қолмен режим қолайлы қадамдар арасында кідіреді. Auto тексерілген қадамдарды алға жылжытады және шектелген қайталауларға мүмкіндік береді. «Кейін тоқтату» әрқашан бақылау нүктесін жасайды. «Кідірту» жұмыс процесінің белсенді жұмысын тоқтатады; панельді жабу оны тоқтатпайды.

Тәуелсіз шолушы файлдары мен тексеру нәтижелері бар бөлек контекстті пайдаланады. Барлық талап етілетін бұғаттаушы ескертулер шешілуі керек; бірнеше шолушылар дауыс беру арқылы бұғаттаушы қатені жоя алмайды.

Көпмодельді режимде кемшіліктерді түзету нақты шешімді қажет етеді. Түзету жаңа шолуды үнсіз бастамайды: «Қайта шолу» жаңа циклді ашады. Шолу ескертулері орындауды қайталамай-ақ үйлестірушіден қайта қарауды сұрай алады.

Аяқталған қадамдарды үнсіз өңдеуге болмайды. TDD кезінде Red күтілген себеппен сәтсіз аяқталуы керек, содан кейін Green сәтті өтуі керек. Шектелген әрекеттер шексіз қайталаулардың алдын алады.

Тәуелсіз CLI/API шолушыларын «Параметрлер → Шолу топтары» бөлімінде сақтаңыз, содан кейін топты Code немесе Work ішінде таңдаңыз. Шолушылар қатар орындалады, содан кейін топтың есеп сәулетшісі іске қосылады. Сондай-ақ, сақталған топсыз тәуелсіз шолушыларды конфигурациялауға болады. Есеп сәулетшісі жоба файлдары немесе құралдары жоқ тек анонимді құрылымдық есептерді алады; бұл оқшаулау қазіргі уақытта Claude Code немесе API талап етеді.

Әрбір орындау қадамы орындалатын тексеруді, міндетті тәуелсіз шолуды немесе екеуін де қажет етеді. Дайындық кезеңдері оның орнына расталған нәтижелер мен артефакт түбіртектерін сақтайды; олар орындау сынақтары өтті деп көрсетпейді. Пәрмен тек оның нақты шығу күйі мен тиесілі процестерді тазалау расталған кезде ғана сәтті аяқталады. TDD үшін Red тексеруі іске асырудан және Green тексеруінен бұрын қалыпты түрде сәтсіз болуы керек; жоқ орындалатын файл немесе күту уақытының асып кетуі жарамды Red нәтижесі болып табылмайды.

Әдепкі ажыратқыштар бір қадамда үш сәтсіз әрекеттен немесе барлығы елу әрекеттен кейін тоқтайды. Үзу әрекетті пайдаланады, бірақ оның өзі сәтсіз әрекет болып саналмайды. Шектеулер мен аяқталған дәлелдемелер қайта іске қосу кезінде сақталады; «Қайталау» оларды қайта орнатпайды. Басқа әрекетке рұқсат бермес бұрын сақталған сәтсіздікті оқыңыз.

Байланысты нұсқаулықтар: Тексеру және шолу.

Параллель шолу топтары және есеп сәулетшісі

«Параметрлер → Шолу топтары» тармағын ашып, топты сақтаңыз. Тәуелсіз шолушыларды өздерінің CLI немесе API, моделі, пайымдау күші және мамандануымен қосыңыз, содан кейін есеп сәулетшісін таңдаңыз. Тапсырманың шолу конфигурациясында топты таңдаңыз. Орындаушының алдын ала орнатуын шолушы да пайдалана алады, ал Пайдаланушы конфигурациясы қолжетімді болып қалады; тәуелсіз рөлдерде әлі де бөлек контексттер болады.

Шолушылар бір тапсырма дәлелдері бойынша қатар орындалады. Әрбір талап етілетін есеп, қате және үкім сақталады. Сәулетші шолушылардың атынсыз, модель немесе провайдер сәйкестендіруінсіз, бастапқы тапсырма мазмұнынсыз, репозиторийге рұқсатсыз немесе құралдарсыз анонимді нөмірленген есептерді алады. Ол есептерді салыстырады және бір құрылымдық үкімді қайтарады; ол бастапқы кодты жаңадан шолуды жүргізбейді.

Бұғаттаушы ескертуді немесе талап етілетін шолушының қабылдамауын көпшілік дауыспен немесе сәулетшінің қалауымен жоюға болмайды. Есептердің болмауы немесе бұрмалануы мақұлдауға жол бермейді. Түзетулерді қабылдамас немесе рұқсат бермес бұрын жеке ескертулер мен жиынтық шешімді тексеріңіз. Сақталған топ орындау үшін бекітіледі және бұғатталады; оның алдын ала орнатуын өңдеу аяқталған дәлелдемелерді қайта жазбайды.

Тек есеп беретін сәулетші қазіргі уақытта қолдау көрсетілетін Claude немесе құралсыз API конфигурацияларын пайдаланады. Codex және Antigravity шолушы ретінде қолжетімді болып қала береді, бірақ тексерілген құралсыз келісім болғанша осы оқшауланған сәулетші рөлі үшін қабылданбайды. Тек «құралдар жоқ» деген нұсқаудың өзі ғана жеткіліксіз.

Байланысты нұсқаулықтар: Типтелген топ конфигурациясы · Шолуды біріктіру.

Агенттерді мамандандыру және нұсқаулық саясаты

Модель — бұл орындау механизмi; мамандандыру — бұл нұсқаулық профилі. Қосымша мамандандыру болмауы үшін «Жоқ», әдепкі нұсқаулық үшін «Стандартты», сәйкес кірістірілген нұсқаулық үшін 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 параметрлерін немесе анық таңдалған толық рұқсатты пайдаланады. Толық рұқсат оқшауланған орта (sandbox) емес.

Мамандандыру басқа модельді немесе рұқсатты емес, нұсқаулық бағытты қосады. Алдын ала орнатулар мен рөлдер «Жоқ», «Стандартты», Auto және «Қолмен» нұсқаларын қолдайды. Auto қосымша модельді шақырусыз қадам мәтінінен профильдерді таңдайды; «Қолмен» төрт мамандыққа дейін және пайдаланушы нұсқауларын қабылдайды. Жоспарлаушы ұсынған тағайындауларды жоспарды қабылдамас бұрын өңдеуге болады.

Қолмен енгізілген модель ID немесе күш-жігер сіздің таңдауыңыз болып қала береді, бірақ провайдер оны қабылдамауы мүмкін. Жаһандық алдын ала орнатуды өңдеу орындалып жатқан чатты немесе қабылданған жоспарды кері күшпен өзгертпейді. Әрекетсіз сөйлесуді мақсатты түрде өзгерту үшін оның жеке конфигурациясын басқару элементтерін пайдаланыңыз және растауды күтіңіз. Өшірілген опция сақталған JSON өңдеу арқылы айналып өтпей, мүмкіндік немесе өмірлік цикл шегі ретінде оқылуы керек.

Байланысты нұсқаулықтар: Провайдер мүмкіндіктері.

Чаттар, тоқтату және кезек

Ашық қойындылар, «Соңғылар» және нобайлар бір тапсырмаға тиесілі. Қойындыны жабу оны «Ашық» тізімінен алып тастайды, бірақ оны «Соңғылар» ішінде сақтайды және оның провайдер процесін немесе басқарылатын жұмыс процесін тоқтатпайды. Тарихты іздеңіз, чатты қайта ашыңыз немесе тарих мәзірінен барлық қосымша қойындыларды жабыңыз.

«Тоқтату» ағымдағы қадамды үзеді. Келесі «Жіберу» алдында тоқтатудың аяқталуын күтіңіз: үзуді растау процестің аяқталғанын білдірмейді. Бұл уақытта сіз келесі нобайды тере аласыз.

Кәдімгі чатта «Кезек» кейінгі сұрауды ағымдағы нобайдан бөлек сақтайды. «Кезекте тоқтата тұру» әрі қарай жеткізуді кідіртеді. «Тоқтату» және «Шығу» кезекті тоқтата тұрады. Қайта іске қосқаннан кейін алдымен «Жалғастыру», содан кейін анық түрде «Кезекте жалғастыру» таңдаңыз.

«Белгісіз» жеткізілімнің белгісіз екенін білдіреді. Мұндай хабарлама автоматты түрде қайта жіберілмейді: журналды қарап шығыңыз, қажет болса мәтінді көшіріңіз және кезекке қойылған элементті алып тастаңыз. Оны қайта жіберу жаңа саналы сұрау болып табылады.

Басқарылатын кезең чаттары кәдімгі кезекті емес, өздерінің жұмыс процесін пайдаланады. «Кезеңді қадағалау» ағымдағы кезеңді көрсетеді; басқа қойындыны қолмен таңдау қадағалауды тоқтатады. CLI журналдары диагностиканы жауаптан бөлек көрсетеді.

Markdown жауаптары тақырыптарды, тізімдерді, кестелерді, сілтемелерді және қоршалған кодты көрсетеді. Құрал карталары мен CLI диагностикасы жауаптан бөлек қалады. Модель хабарлаған пайымдау мен токен көрсеткіштері тек провайдер оларды нақты көрсеткенде ғана пайда болады; анимациядан ішкі пайымдауды немесе пайдалануды болжамаңыз.

Белгісіз жіберуден немесе кезек растауынан кейін журналды тексеріп, ұсынылған жағдайда тек сол сақталған сұрауды қайталаңыз. Кезек түбіртегі қойманың элементті қабылдағанын білдіреді, бірақ қорытындының аяқталғанын білдірмейді. Белгісіз кезек элементін тек оны анық алып тастау ретінде ғана жойыңыз; ол жеткізіліп қойған нұсқауды қайтарып ала алмайды.

Байланысты нұсқаулықтар: Тұрақты хабарлар кезегі.

Файлдар, Git және аяқтау

«Файлдар» тапсырма қалтасын көрсетеді. Нәтижелерді талаптармен салыстырыңыз, құжаттарды ашыңыз және айырмашылықтарды тексеріңіз. Екілік файлды сақтау оның мақсатты қолданбада дұрыс көрсетілуін дәлелдемейді.

Git тіркелген нәтижелері бар күйді, өзгерістерді және операцияларды қамтамасыз етеді. Коммит жасау, біріктіру және жіберу әдепкі бойынша қолмен орындалады; автоматты операциялар — толық тексерілген жоспар үшін бөлек таңдаулар.

Тексеру мен жариялау арасында жұмыс файлдарын өзгертпеңіз: бекіту нақты байттармен байланысты. Қайшылықтар, сәтсіз жіберулер және белгісіз операция нәтижелері нақты шешім қабылданғанға дейін прогресті бұғаттайды. Auto жариялауға үнсіз рұқсат бермейді.

Work ешқандай Git тармақтарын жасамайды және оның Git бойынша аяқталуы жоқ. Қажетті құжаттарды таңдалған қалтадан сақтаңыз, оның ішінде нұсқалары мен дереккөздерін қоса.

Файл редакторы кеңейтім бойынша синтаксисті, іздеу мен ауыстыруды, болдырмау тарихын, жолдарды тасымалдауды және әрбір қойынды бойынша жобаларды қамтамасыз етеді. Сақтаулар қолдау көрсетілетін UTF-8/UTF-16 кодтауын сақтайды және сыртқы өзгертулер қайшылығын қабылдамай тастайды. Басқа кодтаулар мен екілік мазмұн үшін сыртқы редактор қажет. Сақталмаған нобайлар иесі оларды сақтағанға немесе жойғанға дейін қолданбадан шығуға жол бермейді.

Толық синтаксис 8 МиБ дейін қолжетімді. Үлкенірек мәтіндік файлдар 256 КиБ терезелерінде ашылады; 8–64 МиБ синтаксиссіз толығымен анық жүктелуі мүмкін. 64 МиБ жоғары болса, терезелік өңдеуді және шектелген келесі сәйкестікті іздеуді пайдаланыңыз. Бұл шектеулі үлкен файл режимі, кез келген үлкен құжаттар үшін Sublime Text баламасы емес.

«Қалтаны ашу» тек бастапқы репозиторийді үнсіз ашудың орнына, ағымдағы тапсырманы немесе тармақ/worktree контекстін пайдаланады. Файл жолы сол файлдың негізгі каталогын көрсете алады. Жолдар тіркелген тапсырма рұқсаттары бойынша бекенд арқылы тексеріледі. Екілік файлдар қарапайым мәтін ретінде өңделмейді; олардың мақсатты қарау құралын пайдаланыңыз және бастапқы байттарды сақтаңыз.

Worktree жою — бұл жеке қорғалған әрекет. Оны жоймас бұрын тіркелген құрылымдық сессиялар мен терминалдарды, соның ішінде әрекетсіз тұрған сессияларды аяқтаңыз. Сақталған Git нәтижесін және қалпына келтіру күйін тексеріңіз; тапсырма жазбасын жою бекітілмеген жұмысты қауіпсіз сақтаудың орнын баса алмайды.

Байланысты нұсқаулықтар: Типтелген редактор келісімі · Git саясаттары.

API қосылымдары

«Қосылымдар» бөлімі анық таңдалған OpenAI-үйлесімді соңғы нүктені қосады. Атауын, базалық URL, үлгіні және қажет болса кілтті енгізіңіз. Көптеген серверлер /v1 деп аяқталатын базалық URL мекенжайын талап етеді; соңғы нүктеңіздің құжаттамасын қараңыз.

Тұйықталған кері байланыс HTTP қоспағанда, HTTPS міндетті болып табылады. URL ішіне кірістірілген тіркелгі деректері жоқ кәдімгі соңғы нүктені пайдаланыңыз. Кілттер қолдау көрсетілетін OS шифрлауын пайдаланады және UI интерфейсіне қайтарылмайды. Соңғы нүктені өзгерту оның кілтін қайта енгізуді талап етеді. Кілт өрісін бос қалдыру сақталған кілтті сақтайды; «Сақталған кілтті өшіру» оны анық тазартады.

API шақырулары CLI жазылымын пайдаланбайды. Құралдар мен модельдер жүйелік сессиялардан өзгеше, ал модельді сәтті табу оның қорытынды жасайтынын дәлелдемейді. Токендерді пайдалану тек провайдер оны нақты қайтарғанда ғана көрінеді.

Тіркелгі деректерін тапсырма мәтінінде немесе алдын ала орнатылған нұсқауларда емес, «Қосылымдар» бөлімінде сақтаңыз. Тек оқуға арналған шолушылар тек өздеріне рұқсат етілген API файл құралдарын алады; есеп сәулетшісінде құралдар болмайды. Қолдау көрсетілмейтін құрал шақырулары үнсіз орындалмай, қабылданбай тасталады. Серверлер пайымдау параметрлері, құралдарды қолдау және модельдер тізімі бойынша ерекшеленеді; қатені соңғы нүктеңіздің жеке келісімімен салыстырыңыз.

Байланысты нұсқаулықтар: API қосылымдары.

Параметрлер, тілдер және қауіпсіз қалпына келтіру

Жалпы параметрлер жұмыс кеңістігін, интерфейс тілін және әдепкі мәндерді таңдайды. «Қосылымдар» API соңғы нүктелерін басқарады. «Алдын ала орнатулар» және «Шолу топтары» рөл конфигурацияларын сақтайды. «Қашықтан басқару» жергілікті тіркелгі деректерін, сервер ауқымын және иесінің рұқсаттарын басқарады; «Жаңартулар» шығарылым көзін/арнасын басқарады. «Бағдарлама туралы» орындалып жатқан нақты құрастыруды көрсетеді.

Интерфейс тілі сұрау (prompt) тілінен және құжаттаманы тексеру күйінен бөлек болады. Өнім атаулары, команда идентификаторлары, файл кеңейтімдері, провайдер үлгісінің идентификаторлары және пайдаланушы жасаған атаулар өзгермейтін идентификаторлар болып қалады. Ағымдағы аударма қолжетімді болғанда, Анықтама таңдалған интерфейс тіліне сәйкес келеді; машиналық аудармалар арнайы белгіленеді, ал ағылшын тілі канондық дереккөз болып қала береді.

«Сақтау» көрсетілген конфигурацияны қолданады. Дерекқорды қалпына келтіру немесе зауыттық баптауларды қалпына келтіру қолданба метадеректерін өшіріп тастауы мүмкін; тазартуды әдейі пайдаланбас бұрын файлдарды және тексерілген сақтық көшірмені сақтап алыңыз. Бұл операциялар жергілікті иесінің әрекеті болып табылады. Оларды сәтсіз жұмыс үрдісін немесе зақымдалған жазбаны тексерудің оңай жолы ретінде пайдаланбаңыз.

Байланысты нұсқаулықтар: Локализация нұсқаулары · Деректерді қалпына келтіру.

Анықтама көмекшісінен сұрау

Анықтаманы ашыңыз, оның көмекші тақтасынан сақталған қосылған пресетті таңдаңыз және ZIAForge туралы сұраңыз. Жауаптар ағымдағы канондық ағылшынша нұсқаулықты және сіз таңдаған интерфейс тілін пайдаланады. Бөлімдерге сілтеме жасайтын батырмалар тиісті нұсқаулық тақырыптарын ашады, осылайша сіз түсіндірмені негізгі дереккөзбен салыстыра аласыз.

Бұл көмекші 100-ге дейін сақталған жазба мен 3 МиБ көлеміндегі бөлек жеке сөйлесуді сақтайды. Көлемі 12,000 таңбаға дейінгі сұрақты енгізіңіз; «Жіберу» оны қояды, «Тоқтату» сұрағыңызды қалдыра отырып белсенді жауапты болдырмайды, ал «Тазарту» осы Анықтама сөйлесуін өшіреді. Жіберілмеген нобайыңыз бен пресет таңдауы бір қолданба сеансында Анықтаманы жабу және қайта ашу кезінде сақталады, бірақ нобай дискіге сақталмайды. Көмекші қолданба командаларын жібермейді, жұмыс үрдісін өзгертпейді немесе тосқауылды мақұлдамайды. Кеңес тапсырманы, тіркелгіні немесе сыртқы байланысты нақты уақытта тексеру болып табылмайды.

Claude Code және API Анықтама сеанстары қолдау көрсетілетін құралсыз жұмыс саясатын ұстанады. Жергілікті Codex және Antigravity Анықтама сеанстары иенің бұрыннан бар жергілікті компьютерлік рұқсатын талап етеді. Егер ол сөндірулі болса, қолданба басқа провайдерді таңдаудың орнына осы алғышартты түсіндіреді. Оны тек иесі жергілікті басқару параметрлерінде қоса алады; көмекші оны өзі қоса алмайды.

Codex Анықтамасы тек оқуға арналған құмсалғышты (sandbox) пайдаланады және құралдарды мақұлдау сұрауларынан бас тартады. Antigravity жоспарлау режимін және өзінің жергілікті құмсалғыш жалаушасын пайдаланады. Бұл жергілікті режимдер операциялық жүйе деңгейіндегі толық оқшаулаудың әмбебап кепілі бола алмайды. Бастапқы нұсқаулықтың хэші жауап үшін пайдаланылған дереккөзді анықтайды; жасалған түсіндірмеде қателер болуы мүмкін, сондықтан әрекет етуден бұрын оған сілтенген бөлімдерді тексеріңіз. Ескі жауаптардың бастапқы нұсқаулық нұсқасы ағымдағы нұсқаулықтан өзгеше болғанда, олар белгіленеді.

Байланысты нұсқаулықтар: Канондық нұсқаулық және аудармаға қызмет көрсету · Қолданба көмекшісі және рұқсаттар.

Көмекші және Telegram

Көмекші таңдалған пресетті және қолданбаны басқарудың бірдей API интерфейсін пайдаланады. Күйді тексеруге берілетін рұқсат пен операцияларды орындауға берілетін рұқсат бір-бірінен бөлек. Командалар мен нәтижелерді тексеріңіз: көмекшінің мәтіндік жауабы әрекеттің орындалғанына дәлел бола алмайды.

Telegram тек жергілікті иесі тарапынан, бар бот токені және иесінің сандық ID идентификаторы арқылы қосылады. Басқару сол иенің жеке чаты үшін қарастырылған. Бапталмаған немесе белсенді емес бот қолданба хабарларын қабылдамауы тиіс.

Бот токенін әдеттегі чатқа қоймаңыз. Интеграцияны баптау Telegram байланысын растамайды және ботты автоматты түрде жасамайды. Скриншоттар мен жауаптарда жұмыс кеңістігінің құпия деректері болуы мүмкін.

Көмекші пресетін таңдап, қолданба операцияларын орындау рұқсатын тексеру рұқсатынан бөлек беріңіз. Codex және Antigravity көмекшілерін іске қосу иенің жергілікті рұқсатын талап етеді; олар құралсыз API немесе Claude сеансымен үнсіз алмастырылмайды. Скриншоттар көмекшімен сөйлесуде көрсетілуі мүмкін, бірақ үлгінің ағымдағы кіріс деректері кескінді талдауды қамтымайды. Кескін көрсетілгені үшін ғана көмекші оны көзбен тексерді деп есептемеңіз.

Көмекші арнайы типтелген құралдар арқылы жиынтықтарды, тапсырмаларды, чаттарды, жұмыс үрдісінің күйін, процесс контексін және қолданба терезелерін тексере алады. Ол рұқсат етілген қарапайым параметрлерді өзгертіп, рұқсат берілген қолданба операцияларын іске қоса алады. Ол жергілікті құқықтар бере алмайды, сақталған тіркелгі деректерін аша алмайды, түбірлік жұмыс кеңістігінің рұқсатын қашықтан өзгерте алмайды немесе жай ғана ыңғайлы болғаны үшін Forge тосқауылын мақұлдай алмайды.

Байланысты нұсқаулықтар: Қолданбаны басқару шарты.

Жеке Telegram ботыңызды басқарыңыз

Өзіңіздің ботыңызды жасаңыз немесе алыңыз, оның жеке чатын іске қосыңыз және жергілікті басқару параметрлеріне оның токені мен өзіңіздің сандық Telegram пайдаланушы ID нөміріңізді енгізіңіз. Интеграцияны қолданбаның қосылуын қалаған кезде ғана іске қосыңыз. Иенің ID нөмірі — пайдаланушы аты немесе бот ID емес, пайдаланушы идентификаторы. Тек сол жеке чаттағы сол пайдаланушының хабарламалары ғана қабылданады.

Орындалып жатқан нұсқаны, жоба/тапсырма санын және тапсырма күйлерін шолу үшін /start, /menu немесе /status пәрмендерін пайдаланыңыз. Батырмалар «Жобалар», «Тапсырмалар», «Скриншот», «Анықтама» және «Тіл» бөлімдерін ашады. Тізімдер әр бетте сегіз элементтен көрсетеді, сондай-ақ «Артқа», «Жаңарту», «Басты бет» және «Алдыңғы/Келесі» шарлау батырмалары бар. Жоба батырмалары тапсырмалар тізімін сүзгіден өткізеді. Тапсырма картасы сақталған жұмыс үрдісінің орындалу барысын, үлгіні/пресетті және бар болса шешілмеген сұрақтарды көрсетеді.

Ашық/соңғы сөйлесулерді және жұмыс үрдісі кезеңдерінің чаттарын алдын ала қарау үшін тапсырманың «Чаттар» бөлімін ашыңыз. Әрбір алдын ала қарау соңғы алты пайдаланушы/көмекші хабарламасын көрсетеді, олардың әрқайсысы көрінетіндей 200 таңбаға дейін қысқартылған. Жеке пайымдаулар (reasoning) көрсетілмейді. Тарихты оқу провайдерді іске қоспайды. Алдын ала қарау тек оқуға арналған: әдеттегі мәтін және /ask TEXT пәрмені сіз қарап отырған тапсырма чатына емес, қолданба көмекшісіне ғана бағытталады.

«Іске қосу / Жалғастыру» ағымдағы Code немесе Work жұмыс үрдісін қайта оқиды және жарамды сақталған жұмыс үрдісін бастайды. «Кідірту» оны кідіртуді сұрайды. Олардың ешқайсысы талаптарды, спецификацияны, жоспарды, шолу қорытындыларын немесе сұрақтарды қабылдамайды; шешілмеген шешім іске қосуға жол бермейді. Шешімдерді қолданбада қабылдаңыз немесе нақты ағымдағы тосқауылы мен ревизиясы бар, арнайы рұқсат етілген типтелген команданы пайдаланыңыз.

Интерфейстің 56 тілінің кез келгенін ана тіліндегі атауы бойынша таңдау үшін «Тіл» немесе /language пәрменін пайдаланыңыз. Бұл тек осы бот пен иесі үшін таңдауды сақтайды. «Қолданба тілін пайдалану» бұл баптауды тазартады. Ол қолданбаның тілін де, кіру рұқсаттарын да өзгертпейді; бар хабарламалар автоматты түрде қайта жіберілмейді.

Шарлау әдетте сол жарияланған мәзір хабарын жаңартады. Батырмалардың 15 минуттан кейін мерзімі бітетін және бір рет қолданылатын жабық идентификаторлары болады; картаны өзгерту оның ескі батырмаларының жарамдылығын жояды. Мерзімі өткен, пайдаланылған, хабарламасы сәйкес келмейтін және алдыңғы процестің батырмалары әрекетті орындай алмайды. Түбегейлі өңдеуге келмейтін хабарлама жаңа картамен ауыстырылуы мүмкін; белгісіз желі қатесі жаңа хабарлама ретінде қайталанбайды.

Іске қосылған кезде поллер бұрынғы жинақталған кезектерді өткізіп жібереді және үзілген командалар қайта іске қосылғанда автоматты түрде қайталанбауы үшін тарату алдында жаңартуды қабылдауды тіркейді. Бұл қайталануды болдырмайды; ол аяқталуға кепілдік бермейді. Қатеден кейін жаңа жұмысты әдейі бастамас бұрын күйді/контекстті тексеріңіз. Тапсырма күйі туралы автоматты хабарландырулар қарастырылмаған.

Нақты командалар қолжетімді болып қала береді: /projects, /tasks, /task TASK_ID, /run TASK_ID, /pause TASK_ID, /screenshot және /ask TEXT. /new {JSON} типтелген createTask арқылы тапсырма жасайды; /command {JSON} нақты каталог командасын жібереді. Аргументтердің құрылымын көру үшін нақты каталогты қараңыз. Қолданбадағыдай бэкендтік авторизация және қалта рұқсаттары қолданылады.

Қолданба сақталған бот токендерінің мәндерін ешқашан көмекшіге жібермейді. Дегенмен скриншоттарда, жиынтықтарда және сөйлесу мәтінінде жобаның құпия ақпараты болуы мүмкін. Егер ботқа немесе иенің тіркелгісіне сенім жоғалса, интеграцияны жергілікті түрде тоқтатыңыз. Жарияланып кеткен токенді бот провайдерінде ауыстырыңыз (rotate), содан кейін оның жергілікті шифрланған конфигурациясын жаңартыңыз.

Байланысты нұсқаулықтар: Жеке бот және командалар.

Тек иесіне арналған жергілікті компьютерлік рұқсат

Компьютерге жергілікті қолжетімділік бастапқыда сөндірулі болады. Оны тек иесі ғана жергілікті Баптаулар → Қашықтан басқару бөлімінде қоса алады. Көмекші және HTTP/MCP/Telegram командалары бұл жалаушаны өздігінен қоса алмайды. Егер операцияға тыйым салынса, көмекші параметрді сипаттап, шешімді иесіне қалдыруы тиіс.

Ашық түрде рұқсат етілген кезде computer.run орындалатын файлды, аргументтер массивін және қосымша абсолютті жұмыс каталогын қабылдайды. Ол қоршамның интерпретациясын (shell interpolation) пайдаланбайды, 30 секундтық шегі бар және шығыс көлемін 1 МиБ-пен шектейді. Көрсетілген каталог жоқ немесе жарамсыз болса, қабылданбайды; cwd көрсетілмесе, HOME емес, қолданбаға тиесілі параметрлер каталогы қолданылады. Қолданбадан шығу (Quit) тиесілі белсенді командаларды болдырмайды және олардың процестерінің тазалануын күтеді.

Қолданбаның оқу/басқару аясы мен жергілікті қолжетімділік — бөлек шешімдер. Жұмыс ағашы (worktree) шектеусіз провайдердің файлдық жүйеге қолжетімділігін шектемейді. Тапсырмадан кейін қажет болмаса, жергілікті рұқсатты қайтарып алыңыз және көмекшінің мәтініне сенбей, команда түбіртектерін тексеріңіз.

Байланысты нұсқаулықтар: Тек иесіне арналған басқару шарты.

Шолғыш және қашықтағы инстанциялар

Жергілікті иесі серверді қосып, оның мекенжайын, портын және ауқымын таңдайды: тексеру үшін read (оқу) немесе әрекеттер үшін operate (басқару). Әдепкі 127.0.0.1 мекенжайы тек осы компьютерде ғана қолжетімді. 0.0.0.0 желілік интерфейстерді тыңдайды; оны қоспас бұрын желіге қолжетімділікті тексеріңіз.

Шолғыш токен арқылы кіргеннен кейін дәл сол интерфейсті ашады. Токендерді жалпыға ортақ сілтемелерге немесе скриншоттарға қоспаңыз. HTTP жалғыз өзі трафикті шифрламайды; сенімсіз желіде қорғалған арнаны пайдаланыңыз.

Иесі басқа инстанцияларды URL және токен арқылы баптайды. Бэкенд сұрауларды проксилейді; бұл олардың жобаларын жергілікті құрылғыға көшірмейді. Әрбір әрекеттің алдында таңдалған инстанцияны тексеріңіз.

Типтелген командалар мен оқиғалар қолданбаны басқаруды қамтамасыз етеді. Оқу режимі (read scope) тапсырмаларды өзгертуге құқық бермейді. Компьютерді жергілікті басқару — жергілікті иенің бөлек таңдауы және ол бастапқыда сөндірулі болады.

Қолданба шолғыш, Telegram және сыртқы агенттер арқылы басқару үшін қосулы тұруы керек. Әрбір инстанцияның жеке профилі, тапсырма күйі, токені және сервер порты болады. Тәуелсіз инстанциялар арасында бір профильді қатар пайдаланбаңыз. Шолғыш оқиғалары мен команда жауаптары таңдалған инстанцияға ғана қатысты; UI интерфейсін ауыстыру файлдардың орнын ауыстырмайды немесе жергілікті кіру деректерін көшірмейді.

Байланысты нұсқаулықтар: HTTP және инстанцияны басқару.

OpenClaw, Hermes және басқа сыртқы агенттер

Аутентификацияланған қолданбаны басқару API интерфейсін немесе жиынтықтағы MCP stdio көпірін пайдаланыңыз. Серверді жергілікті түрде қосыңыз, оқу немесе басқару (operate) режимін таңдаңыз және әрбір клиентті сол инстанцияның URL мекенжайымен және токенімен баптаңыз. Бөлек MCP көпірін іске қосу үшін Node.js 22 немесе одан жаңа нұсқасы қажет; Electron қолданбасы сіздің агент клиентіңізді орнатпайды. Шолғыштың URL мекенжайы ағынды 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. «Іске қосу» туралы сәтті растау тапсырманың аяқталғанын білдірмейді.

--until-success сақталған жұмыс үрдісі үшін Auto режимін әдейі қосады, бірақ сұрақтар, тексеру, қабылдау тосқауылдары, шектеулер мен бақылау нүктелері бәрібір қолданылады. Ctrl+C бақылаушы диспетчерден шығады; ол қолданбаның жұмыс үрдісін автоматты түрде тоқтатпайды. Шығу кодтары, жергілікті түйін және профильмен жұмыс істеу туралы ақпаратты CLI.md файлынан қараңыз.

«Автоматтандырулар» интерфейсі қазіргі уақытта тек көрсету анықтамалары мен жергілікті орындалу есептегіштерін сақтайды. Ол сертификатталған қайталанатын жоспарлағыш болып табылмайды және фондық үлгі қадамының орындалғанын дәлелдемейді. Нақты орындау үшін сақталған жұмыс үрдісінің басқару элементтерін, ziaf немесе аутентификацияланған API интерфейсін пайдаланыңыз және олардың түбіртектерін тексеріңіз. Көрсетілім тақтасын дербес жоспарлау жүйесімен шатастырмаңыз.

Байланысты нұсқаулықтар: Диспетчер командалары.

Нұсқа және жаңартулар

«Бағдарлама туралы» бөлімінде дәл іске қосылған нұсқа көрсетіледі. Жалпыға ортақ жаңартулар сенімді GitHub шығарылым репозиторийін және тұрақты немесе алдын ала қарау арнасын талап етеді. Тексеру, жүктеп алу және орнату бөлек күйлерге ие; қатенің болуы жаңарту орнатылды дегенді білдірмейді.

Автоматты орнату цифрлық қолтаңбасы бар macOS шығарылымдары үшін қарастырылған. Қолтаңбасы жоқ әзірлеу құрастырылымдары осы механизм арқылы автоматты түрде орнатылмайды. Қолмен ауыстыру үшін ағымдағы қолданбаны толығымен жабыңыз және тексерілген артефактіні пайдаланыңыз.

Автоматты тексеру қосылған кезде бірден, содан кейін әр алты сағат сайын орындалады.

Тұрақты арна (Stable) алдын ала шығарылымдарды қамтымайды; алдын ала қарау (preview) әзірлеу шығарылымдарына да рұқсат береді. Сәтті тексеру тек қолжетімді шығарылым метадеректерін анықтайды. Жүктеп алу және орнату үшін платформа пакеті және бапталған шығарылым арнасы қажет. Linux DEB жеткізілімі — бөлек орнату жолы; DEB пакеті macOS жаңарту механизмі арқылы автоматты түрде жаңартылады деп ойламаңыз.

Байланысты нұсқаулықтар: Шығарылымның дайындығы.

Қайта іске қосу және қалпына келтіру

macOS жүйесінде толық жабу үшін Quit / ⌘Q пайдаланыңыз. Терезені жабу қолданбаны фондық режимде қалдыруы мүмкін. Қолданбаны ауыстырмас бұрын ескі нұсқаны толығымен жабыңыз.

Іске қосқаннан кейін дәл сол тапсырманы таңдаңыз. Тарих пен нобайлар қайта оралады. Жұмысты жалғастыру (Resume) жергілікті мән-мәтінді қалпына келтіреді, бірақ нобайды жібермейді, кезекті кідірістен шығармайды немесе белгісіз операцияны қайталауға рұқсат бермейді.

Егер Recovery (Қалпына келтіру) пайда болса, JSON файлын қолмен өңдемеңіз. Зақымдалған құжат түрін тексеріңіз, түпнұсқа файлдарды сақтаңыз және тексерілген сақтық көшірмені таңдаңыз. Ескі кезекті қалпына келтіру оның элементтерін күмәнді деп белгілейді.

Жеткізу белгісіз болған кезде, басқарылатын жұмыс үрдісіне жаңа мән-мәтін үшін ашық рұқсат қажет болуы мүмкін. Бұрынғы жұмыс пен сәтсіз әрекеттер сақталады; жалған сәттіліктен гөрі көзге көрінетін бас тарту қауіпсізірек.

Тапсырма файлдары мен қолданба профилінің сақтық көшірмесін қолданбаның барлық даналары жабық кезде жасаңыз. Көшірілген қалта тексерілген қалпына келтіру болып саналмайды. Егер қалпына келтіру процесі тексерілген сақтық көшірмені таңдауды сұраса, зақымдалған нақты файлдарды да сақтап қалыңыз. Ескі жұмыс үрдісін немесе кезекті қалпына келтіру күмәнді қорытындыны немесе Git операцияларын қайталауға рұқсат бермейді.

Байланысты нұсқаулықтар: Қалпына келтіру шарты.

Ақаулықтарды жою

CLI табылмады: оның орнатылымын және нұсқасын кәдімгі терминалда тексеріңіз, содан кейін ZIAForge қайта іске қосыңыз. Орындалатын файлдың болуы жүйеге кіргеніңізді білдірмейді. Провайдердің өзінің кіру механизмін пайдаланыңыз.

Үлгі қолжетімсіз немесе авторизация сәтсіз аяқталды: анықтауды жаңартыңыз, қолжетімді ID таңдаңыз және тіркелгіңіз бен шектеулеріңізді тексеріңіз. Тарихын тексермес бұрын күмәнді сұрауды қайталамаңыз.

Жұмыс үрдісі тоқтатылды: ағымдағы кезеңді, сұрақты, тексеру түбіртегін немесе CLI журналдарын ашыңыз. Нақты себепті шешіңіз: жауапсыз қалған сұрақ, команда, қалта рұқсаты немесе әрекет шегі. Жалғастыру (Continue) сәтсіз тексеруді сәттілікке айналдыра алмайды.

Қалта жоқ немесе ауыстырылған: бастапқы қалтаға қолжетімділікті қалпына келтіріңіз немесе жаңа тапсырма жасаңыз. Қолданба HOME каталогынан жұмысты жалғастырмауы керек. Басқа cwd байқасаңыз, кезекті тоқтатып, диагностикалық деректерді сақтаңыз.

Есеп беру үшін «Бағдарлама туралы» нұсқасын, бағытты, CLI/үлгіні, күтілген және нақты әрекетті, скриншотты және журналдың қауіпсіз үзіндісін тіркеңіз. Жариялауға болмайтын құпияларды, жеке мазмұнды және жолдарды алып тастаңыз.

Қашықтағы бет қолжетімсіз: иенің серверді қосқанын тексеріңіз, тыңдалатын мекенжай мен портты тексеріңіз, содан кейін дұрыс инстанция токенімен аутентификациядан өтіңіз. 401 қатесі аутентификацияны білдіреді; қабылданбаған өзгерту әрекеті оқу режимі (read scope) немесе тек иесіне арналған басқару элементі болуы мүмкін. Токенді өзгерту бұрыннан бар шолғыш клиенттерін жабады. Бөлек DevTools тексеру портын қашықтан қолданбаны басқару интерфейсі ретінде ашпаңыз.

Редакторды сақтау қабылданбады: нобайды сақтаңыз, дискідегі ағымдағы файлды тексеріңіз және сыртқы өзгерістер қайшылығын шешіңіз. Қолданба метадеректерін қайта жазу арқылы салыстыруды айналып өтпеңіз. Үлкен файлды толық жүктеу мүмкін болмаса, қолдау көрсетілетін терезелік өңдеуді/іздеуді немесе сыртқы редакторды пайдаланыңыз.

Telegram қолжетімсіз: бот токенін, сандық иесін, жеке чатты және күйді жергілікті түрде растаңыз. Бәсекелес вебхук немесе поллер сұрауды блоктауы мүмкін; ZIAForge вебхукты автоматты түрде жоймайды немесе басқа поллерді иемденбейді. Белгісіз шекарада қабылданбаған немесе үзілген командалар автоматты түрде қайталанбайды.

Байланысты нұсқаулықтар: Сынау және диагностикалау.

Мәселелер туралы хабарлау және дәлелдемелерді тексеру

«Бағдарлама туралы» бөлімінен нақты іске қосылған нұсқаны, 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/тіркелгіні тексереді; пакеттелген тексерулер нақты бір артефактіні растайды. Біреуінен сәтті өту басқаларына кепілдік бермейді.

Қолданбаның әрекет аясы, жұмыс ағашы және тек оқуға арналған сұрау (prompt) операциялық жүйе деңгейіндегі мәжбүрлеуден өзгеше. 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 ішінде бөлек анықтамалық күйі бар. Жоқ немесе толық емес анықтамалық ағылшын тіліне ауысады. Машинамен толық аударылған мәтіндер белгіленеді және адамның тексеруін талап етпей, ағылшын дереккөзінің хэшіне байланыстырылады. Адам тексерген аудармаға қосымша тексерушінің аты жазылады. Әрбір аударма бөлім идентификаторларын, әрекеттерді, файл/команда идентификаторларын және техникалық шектеулерді сақтауы, дұрыс бағытты пайдалануы және ағылшын дереккөзі өзгерген кезде жаңартылуы тиіс.

Жіберу алдында ескірген жасалған нәтижені, жарамсыз локаль құрылымын немесе бұзылған жергілікті шарт сілтемелерін анықтау үшін node scripts/help/generate.cjs --check іске қосыңыз. UI аудармасын тексеру мен қолданба әрекетін тексеру бөлек болып қала береді. HELP_MAINTENANCE.md қатысушы мен AI жаңарту процедурасын сипаттайды; құжаттамада орындалмаған сынақтан өтті деп көрсетілмеуі керек.

Байланысты нұсқаулықтар: Ағымдағы жоба картасы · Құжаттамаға қызмет көрсету · Үлес қосушыға арналған нұсқаулар · Агентке арналған нұсқаулар.