የZIAForge የተጠቃሚ መመሪያ

የመጀመሪያ እርምጃዎች

ZIAForge ውይይትን፣ እቅድን፣ አፈጻጸምን እና ማረጋገጫን በአንድ ተግባር ውስጥ ያቆያል። ለGit ፕሮጀክት Codeን፣ ወይም በተለመደው አቃፊ ውስጥ ላሉ ሰነዶች፣ ምርምር እና ሌሎች ውጤቶች Workን ይምረጡ።

በተለየ ፕሮጀክት ውስጥ በትንሽ ተግባር ይጀምሩ። አገር በቀል (native) CLIን ከመረጡ፣ መጀመሪያ ይጫኑት እና በተርሚናል ውስጥ በራሱ መለያ ይግቡ። በአማራጭ፣ የAPI ግንኙነትን ያዋቅሩ። የCLI ምዝገባ እና የሚከፈልበት API የተለያዩ የግንኙነት ዘዴዎች ናቸው፤ ZIAForge ወደ መለያዎ አያስገባዎትም ወይም በመካከላቸው ክሬዲቶችን አያስተላልፍም።

1. ቅንብሮችን ይክፈቱ እና የስራ ቦታ አቃፊውን እና ቋንቋውን ያረጋግጡ። ስለ የሚለው የሩጫውን ትክክለኛ ማንነት ያሳያል።
2. ለCode፣ በጎን አሞሌው ውስጥ የGit ማከማቻ (repository) ያክሉ። ለWork፣ ተግባሩን ሲፈጥሩ የተለየ አቃፊ ይምረጡ።
3. ከCLI፣ ሞዴል፣ የአመክንዮ ጥረት እና የመዳረሻ ደረጃ ጋር ቅድመ-ቅምጥ ያስቀምጡ። እንዲሁም የተቀመጠ ቅድመ-ቅምጥ ሳይኖር በቀጥታ ብጁን መምረጥ ይችላሉ።
4. ተግባር ይፍጠሩ፣ መንገዱን፣ ሚናዎቹን እና በእጅ ወይም በራስ-ሰር መሻሻልን ይምረጡ። ከመጀመርዎ በፊት ምርጫዎቹን ይገምግሙ።

ተዛማጅ መመሪያዎች: የፕሮጀክት አጠቃላይ እይታ · የአቅራቢ ተኳኋኝነት.

ትክክለኛውን የዴስክቶፕ ፓኬጅ ይጫኑ

ለእርስዎ ኦፕሬቲንግ ሲስተም እና ለCPU አርክቴክቸር ፓኬጅ ይምረጡ፡ x64 ወይም arm64። የግንባታ ቧንቧው (pipeline) macOS DMG/ZIP፣ Windows NSIS ጫኝ/ZIP፣ እና Linux DEB/RPM/AppImage/tar.gz/ZIP ቅርጸቶችን ማምረት ይችላል። የተፈጠረ ፋይል ወይም አቋራጭ ግንባታ ጫኚው እና አገር በቀል (native) UI በእርስዎ ማሽን ላይ ማለፋቸውን የሚያሳይ ማስረጃ አይደለም፤ የዚያን ልቀት የማረጋገጫ መዝገብ ይመልከቱ።

Electron 44ን የሚጠቀሙ የmacOS ግንባታዎች macOS 13 ወይም ከዚያ በኋላ ያስፈልጋቸዋል። በApple Silicon ላይ የarm64 ፓኬጅን እና ለIntel ደግሞ የx64 ፓኬጅን ይጠቀሙ። ከመተካትዎ በፊት አሮጌውን መተግበሪያ ሙሉ በሙሉ ያቁሙ። የቅድመ እይታ ፓኬጆች ያልተፈረሙ እና ኖተራይዝድ ያልተደረጉ ሊሆኑ ይችላሉ፤ የልማት ቅርስን (artifact) ለተፈረመ ይፋዊ ልቀት አያምታቱ።

Windows በጥቅሉ በተካተተው የElectron ስሪት የሚደገፍ ኦፕሬቲንግ ሲስተም እና በPATH ውስጥ የሚገኝ Git ያስፈልገዋል። ተዛማጁን አርክቴክቸር ይምረጡ። ያልተፈረመ ቅድመ እይታ የAuthenticode ማረጋገጫ የለውም። ተንቀሳቃሽ ZIP የሚተገበረውን ፋይል ብቻ ሳይሆን ሙሉውን የመተግበሪያ ማውጫ እና የማስኬጃ (runtime) ፋይሎችን ማቆየት አለበት።

Linux ተኳሃኝ የሆነ ስዕላዊ ዴስክቶፕ፣ በElectron የሚፈለጉ የስርዓት ቤተ-መጻሕፍት እና Git ያስፈልገዋል። ለተመሰጠሩ የቁጥጥር ምስክርነቶች፣ እንደ gnome-libsecret ወይም KWallet ያለ የሚሰራ Secret Service ያቅርቡ፤ ደህንነቱ ያልተጠበቀው የbasic_text backend ተቀባይነት የለውም። ያለ ጭንቅላት (Headless)/ኮንቴይነር የጭስ ማውጫ (smoke) ማስረጃ እያንዳንዱን ዴስክቶፕ ወይም ስርጭት አያረጋግጥም።

DEBን በapt install ./file.deb ይጫኑ፣ ወይም በእርስዎ ስርጭት የፓኬጅ አስተዳዳሪ በኩል RPM ይጫኑ። AppImage ሊተገበር የሚችል ፈቃድ እና ተስማሚ የFUSE ድጋፍ ይፈልጋል፤ --appimage-extract-and-run በሚደገፍበት ቦታ አማራጭ ነው። የtar.gz እና ZIP ፓኬጆችን ከሁሉም የማስኬጃ ፋይሎቻቸው ጋር ያውጡ። ፓኬጅ በሚተካበት ጊዜ የተጠቃሚ ውሂብ እና የመተግበሪያ ፋይሎችን ለይተው ያቆዩ።

ከምንጭ ለመገንባት መደበኛውን የElectron ጫኝ ጨምሮ Node 24፣ Git እና npm ci ይጠቀሙ። አገር በቀል ዳግም ግንባታዎች የመድረክ መሳሪያዎችን ይፈልጋሉ፡ የXcode የትዕዛዝ መስመር መሳሪያዎች በmacOS ላይ፤ MSVC C++፣ Windows SDK እና Python በWindows ላይ፤ አቀናባሪ፣ make፣ Python፣ pkg-config እና አስፈላጊ የማሸጊያ መሳሪያዎች በLinux ላይ። ለትክክለኛዎቹ ትዕዛዞች እና የአሁን የመድረክ ገደቦች PLATFORM_BUILDS.mdን ይከተሉ።

የልቀት ስሪቶች በማዕከላዊነት የተጠበቁ ናቸው እና ውጤቶቹ የማይለወጡ ናቸው። የCI ማረጋገጫ ግንባታ የታተመ ጫኝ አይደለም። የምንጭ ማህደሮች ምንጭን፣ የቁልፍ ፋይልን (lockfile)፣ ሰነዶችን እና ስክሪፕቶችን ይይዛሉ፤ ጥገኞች፣ ምስክርነቶች፣ የተጠቃሚ መገለጫዎች እና የግል ምርምሮች የተገለሉ ናቸው። ከተሳካ የx64 ግንባታ አገር በቀል የARM ወይም Windows ማረጋገጫን በጭራሽ አይገምቱ።

ተዛማጅ መመሪያዎች: የመድረክ ፓኬጆች፣ ቅድመ ሁኔታዎች እና የማረጋገጫ ገደቦች · የግንባታ ማንነት እና የልቀት ፍተሻዎች.

Code: አምስት መንገዶች

Auto ስፋትን ይገመግማል፡ ቀላል ጥያቄ በመልስ ሊያበቃ ይችላል፣ ትልቅ ተግባር ግን ዝግጅት ያስፈልገዋል። ሳንካን መጠገን መንስኤን ይመረምራል እና እርማት ያዘጋጃል። ዝርዝር መግለጫ መጀመሪያ በቴክኒካዊ መፍትሄ ይጀምራል፤ መስፈርቶች መጀመሪያ በመስፈርቶች እና ተቀባይነት መስፈርቶች ይጀምራል።

ባለብዙ ሞዴል ፍለጋ፣ ዲዛይን፣ አተገባበር እና ግምገማ የተለዩ አውዶችን ይጠቀማል። የመንገዱ ስም የተለያዩ አቅራቢዎችን አይጠይቅም፡ እያንዳንዱ ሚና እርስዎ የመረጡትን ቅድመ-ቅምጥ ወይም ብጁ ውቅር ይጠቀማል።

የስራ ዛፍ (Worktree) የተግባርን የGit ለውጦች ይለያል። ቅርንጫፍ በተመረጠው ፍተሻ ውስጥ ይሰራል/ የፕሮጀክቱን፣ ቅርንጫፉን እና ሞዴሉን ከመጀመርዎ በፊት ያረጋግጡ፤ የተግባር መግለጫው በተጨማሪ ወደ ተራ ውይይት አይላክም።

ያልተፈቱ የምርት ወይም ቴክኒካዊ ምርጫዎች ላለው ሀሳብ፣ መስፈርቶች መጀመሪያን ይጠቀሙ እና መሰረቱን በውይይት ውስጥ ይገንቡ። Auto ጥያቄውን ይመድባል፤ እያንዳንዱን አጭር ሀረግ ወዲያውኑ ተግባራዊ ለማድረግ ትዕዛዝ አይደለም። ረቂቅ አስቀምጥ ሞዴልን ሳያነጋግር ጥያቄውን ያቆያል፤ ጀምር የሚተዳደረውን ፍሰት አንድ ጊዜ ያስቀምጣል እና ያስጀምራል። ከአንድ እስከ አራት የተግባር ቅጂዎች ገለልተኛ የፈጠራ መታወቂያዎች እና የሚና ቅንብሮች አሏቸው።

ተዛማጅ መመሪያዎች: የCode የስራ ፍሰት ውል · የCode ጥያቄ መገለጫዎች.

የForge ውይይት

ጀምር ማዕከላዊውን ውይይት ይከፍታል። በተፈጥሮ ይመልሱ፣ የተቃውሞ ጥያቄዎችን ይጠይቁ፣ ገደቦችን ያክሉ እና ቴክኒካዊ ምርጫዎችን ይወያዩ። ውይይቱ እና ጥያቄዎቹ ከተግባሩ ጋር ይቆያሉ።

ጽሁፍ መላክ ሰነድን አይቀበልም ወይም አዲስ የአተገባበር እቅድ አይፈቅድም። በአፈጻጸም ወቅት የሚደረግ ማብራሪያ መጀመሪያ የሚተዳደረውን ተራ ለአፍታ ያቆማል እና የተጎዳውን ስፋት እንደገና ይመረምራል። አስቀድሞ ተቀባይነት ባለው ደረጃ ውስጥ ላለ ጥያቄ መልስ ያንን ደረጃ ሊቀጥል ይችላል።

ሆን ብለው መሰረቱን እንደገና ለመጎብኘት፣ መስፈርቶች፣ ዝርዝር መግለጫ ወይም እቅድን ይምረጡ። አዲስ ስሪት ጥገኛ ውሳኔዎችን አዲስ መቀበልን ይፈልጋል። የተጠናቀቁ ደረጃዎች እና ማስረጃዎቻቸው ይቀራሉ፤ የተተኩ ያላለቁ ምዕራፎች በታሪክ ውስጥ ይቆያሉ።

የሚተዳደሩ የምዕራፍ ክፍለ-ጊዜዎች ከነጻ ቻት ይለያያሉ። በእጅ የሚደረጉ ጥያቄዎችን በቀጥታ በስራ ፍሰት ባለቤትነት ወደተያዘ ክፍለ-ጊዜ ከመላክ ይልቅ የForge ውይይት ይጠቀሙ።

ተዛማጅ መመሪያዎች: የForge የውይይት ውል.

ሰነዶች እና ውሳኔዎች

ሰነድ ይክፈቱ፣ ስሪቱን ይመርምሩ እና በሚያስፈልግበት ጊዜ አርትዖቶችን ያድርጉ። በውይይት በኩል አርትዖቶችን ማስገባት አዲስ ስሪት ያመነጫል፤ ሪፖርቶች እና የተረጋገጡ ውጤቶች ወደ ኋላ ተመልሰው እንደገና አይጻፉም።

የቀረበውን እቅድ ከመቀበልዎ በፊት ቅደም ተከተሉን፣ መመሪያዎችን፣ ተቀባይነት መስፈርቶችን እና የማረጋገጫ ትዕዛዞችን ያርትዑ። የተረዱትን ተጨባጭ ትዕዛዞችን ፍቀድ፡ በተግባር አቃፊው ውስጥ ይሰራሉ። ባለብዙ ሞዴል አንድ ሙሉ ተግባር የማስፈጸሚያ ደረጃን ያቀርባል፣ ዝርዝሮቹም በሰነዶቹ እና በመመሪያዎቹ ውስጥ አሉ።

ማጽደቅ የተለየ ሆን ተብሎ የሚደረግ ውሳኔ ነው። Auto ጥያቄዎችን ወይም የመስፈርቶችን፣ ዝርዝር መግለጫዎችን እና እቅዶችን መቀበልን አያልፍም። በውጪ የተቀየረ ሰነድ አሮጌ ፈቃድን እንደገና መጠቀም አይችልም።

የዝግጅት ፋይሎች እንደ ቅርስ (artifacts) ይታያሉ። ስሪታቸው፣ ያመረተው ምዕራፍ እና ሃሽ ከውጤት ጋር ያቆራኛቸዋል። የCode ሰነዶች ከስራ ዛፍ ውጭ ይቀመጣሉ እና በራስ-ሰር ወደ commit አይገቡም።

ከመቀበልዎ በፊት ሰነዱን እና የታየውን ውሳኔ ያረጋግጡ። መቀበል የአሁኑን በር ID፣ የእቅድ ክለሳ እና የተያዙ የሰነድ ሃሾችን ያስራል። ስፋት ወይም ማስረጃ የተሳሳተ ሲሆን ለውጦችን ይጠይቁ። ውሳኔ ጊዜው ካለፈበት፣ አዲስ ምርጫ ከማድረግዎ በፊት የተቀመጠውን ሁኔታ እንደገና ይጫኑ፤ የተቀየረ ፋይል በቀድሞ ስሪት ስር ተቀባይነት ሊያገኝ አይችልም።

ተዛማጅ መመሪያዎች: የስራ ፍሰት በሮች እና የሰነድ ስሪቶች.

አፈጻጸም እና ግምገማ

የሚደረጉ ነገሮች (To-do) እውነተኛ ደረጃዎችን፣ የአሁኑን ሙከራ፣ የማረጋገጫ እና የግምገማ ውጤቶችን ያሳያል። ወኪል “ተከናውኗል” ማለቱ ደረጃን አያጠናቅቅም፡ የእቅዱ አስፈላጊ ማስረጃ መኖር አለበት።

በእጅ ሁነታ ብቁ በሆኑ ደረጃዎች መካከል ለአፍታ ይቆማል። Auto የተረጋገጡ እርምጃዎችን ያራምዳል እና የተገደቡ ድጋሚ ሙከራዎችን ይፈቅዳል። በኋላ አቁም ሁልጊዜ የፍተሻ ነጥብ (checkpoint) ይፈጥራል። ለአፍታ አቁም የስራ ፍሰቱን ንቁ ስራ ያቆማል፤ ፓነልን መዝጋት አያቆመውም።

ገለልተኛ ገምጋሚ ከፋይሎች እና ከማረጋገጫ ውጤቶች ጋር የተለየ አውድ ይጠቀማል። እያንዳንዱ የሚፈለግ አግድ ግኝት መፈታት አለበት፤ ብዙ ገምጋሚዎች የሚያግድ ስህተትን በድምጽ ብልጫ አያስወግዱትም።

በባለብዙ ሞዴል ውስጥ ግኝቶችን ማረም ግልጽ ውሳኔን ይፈልጋል። እርማት በጸጥታ ሌላ ግምገማ አይጀምርም፡ እንደገና ገምግም አዲስ ዑደት ይከፍታል። የግምገማ አስተያየቶች አተገባበርን ሳይደግሙ የአስተባባሪን ዳግም እይታ ሊጠይቁ ይችላሉ።

የተጠናቀቁ ደረጃዎች በጸጥታ ሊታረሙ አይችሉም። በTDD፣ ቀይ (Red) በትክክል በሚጠበቀው ምክንያት መውደቅ አለበት፣ ከዚያ አረንጓዴ (Green) ማለፍ አለበት። የተገደቡ ሙከራዎች ማለቂያ የሌላቸውን ድጋሚ ሙከራዎች ይከላከላሉ።

ገለልተኛ የCLI/API ገምጋሚዎችን በቅንብሮች → የግምገማ ቡድኖች ውስጥ ያስቀምጡ፣ ከዚያ ቡድኑን በCode ወይም Work ውስጥ ይምረጡ። ገምጋሚዎች በትይዩ ይሰራሉ፣ በመቀጠልም የቡድኑ ሪፖርት አርክቴክት ይከተላል። የተቀመጠ ቡድን ሳይኖርዎት ገለልተኛ ገምጋሚዎችን ማዋቀር ይችላሉ። የሪፖርት አርክቴክቱ ስም-አልባ የተዋቀሩ ሪፖርቶችን ብቻ ይቀበላል፣ ምንም የፕሮጀክት ፋይሎች ወይም መሳሪያዎች የሉትም፤ ይህ መገለል በአሁኑ ጊዜ Claude Code ወይም API ያስፈልገዋል።

እያንዳንዱ የአተገባበር ደረጃ ሊተገበር የሚችል ፍተሻ፣ አስፈላጊ ገለልተኛ ግምገማ ወይም ሁለቱንም ይፈልጋል። የዝግጅት ምዕራፎች በምትኩ የተረጋገጡ ውጤቶችን እና የቅርስ ደረሰኞችን ይይዛሉ፤ እነዚህ የአተገባበር ሙከራዎች እንደተካሄዱ አያስመስሉም። ትዕዛዝ የሚሳካው ትክክለኛው የመውጫ ሁኔታ እና በባለቤትነት የተያዘው ሂደት ጽዳት ሲረጋገጥ ብቻ ነው። ለTDD የቀይ ፍተሻ ከአተገባበሩ እና ከአረንጓዴ ማረጋገጫው በፊት በመደበኛነት መውደቅ አለበት፤ የጎደለ ተፈጻሚ ፋይል ወይም ጊዜ ማብቂያ (timeout) ትክክለኛ የቀይ ውጤት አይደለም።

ነባሪ የወረዳ መቆራረጦች (circuit breakers) በአንድ ደረጃ ላይ ከሶስት ያልተሳኩ ሙከራዎች በኋላ ወይም በአጠቃላይ ሃምሳ ሙከራዎች በኋላ ያቆማሉ። መቋረጥ ሙከራን ይወስዳል ነገር ግን በራሱ እንደ ያልተሳካ ሙከራ አይቆጠርም። ገደቦች እና የተጠናቀቁ ማስረጃዎች ዳግም ከተነሳ በኋላም ይቆያሉ፤ እንደገና መሞከር ዳግም አያስጀምራቸውም። ሌላ ሙከራ ከመፍቀድዎ በፊት የተያዘውን ውድቀት ያንብቡ።

ተዛማጅ መመሪያዎች: ማረጋገጫ እና ግምገማ.

ትይዩ የግምገማ ቡድኖች እና የሪፖርት አርክቴክቱ

ቅንብሮች → የግምገማ ቡድኖችን ይክፈቱ እና ቡድን ያስቀምጡ። ገለልተኛ ገምጋሚዎችን ከራሳቸው CLI ወይም API፣ ሞዴል፣ የአመክንዮ ጥረት እና ልዩ ሙያ ጋር ያክሉ፣ ከዚያ የሪፖርት አርክቴክት ይምረጡ። በተግባሩ የግምገማ ውቅር ውስጥ ቡድኑን ይምረጡ። የአስፈጻሚ ቅድመ-ቅምጥ በገምጋሚም ሊሠራበት ይችላል፣ እና ብጁ እንደተገኘ ይቆያል፤ ገለልተኛ ሚናዎች አሁንም የተለዩ አውዶች አሏቸው።

ገምጋሚዎች በተመሳሳይ የተግባር ማስረጃ ላይ በትይዩ ይሰራሉ። እያንዳንዱ አስፈላጊ ሪፖርት፣ ስህተት እና ውሳኔ ተጠብቆ ይቆያል። አርክቴክቱ ያለ ገምጋሚ ​​ስሞች፣ የሞዴል ወይም የአቅራቢ ማንነቶች፣ የመጀመሪያ የተግባር ይዘቶች፣ የማከማቻ መዳረሻ ወይም መሳሪያዎች ስም-አልባ ቁጥር ያላቸው ሪፖርቶችን ይቀበላል። ሪፖርቶችን ያወዳድራል እና አንድ የተዋቀረ ውሳኔ ይመልሳል፤ አዲስ የምንጭ ግምገማ አያካሂድም።

የሚያግድ ግኝት ወይም አስፈላጊ የገምጋሚ ውድቅ መደረግ በድምጽ ብልጫ ወይም በአርክቴክት ምርጫ ሊተው አይችልም። የጎደሉ ወይም የተበላሹ ሪፖርቶች ማጽደቅን ይከለክላሉ። እርማቶችን ከመቀበልዎ ወይም ከመፍቀድዎ በፊት የግለሰብ ግኝቶችን እና አጠቃላይ ውሳኔን ይመርምሩ። የተቀመጠ ቡድን ለሩጫው ይወሰናል እና ይቀዘቅዛል፤ ቅድመ-ቅምጡን ማረም የተጠናቀቀ ማስረጃን እንደገና አይጽፍም።

ሪፖርት-ብቻ አርክቴክቱ በአሁኑ ጊዜ የሚደገፉትን የClaude ወይም API ከመሳሪያ ነጻ አወቃቀሮችን ይጠቀማል። Codex እና Antigravity እንደ ገምጋሚዎች ሆነው ይቆያሉ ነገር ግን የተረጋገጠ ከመሳሪያ ነጻ ውል እስኪኖር ድረስ ለዚህ ገለልተኛ የአርክቴክት ሚና ውድቅ ይደረጋሉ። “ምንም መሳሪያዎች የሉም” የሚል ጥያቄ ብቻውን በቂ አይደለም።

ተዛማጅ መመሪያዎች: የተተየበ የቡድን ውቅር · የግምገማ ድምር.

የወኪል ልዩ ሙያዎች እና የጥያቄ ፖሊሲ

ሞዴል የአፈጻጸም ሞተር ነው፤ ልዩ ሙያ የመመሪያ መገለጫ ነው። ምንም ተጨማሪ ልዩ ሙያ ላለመኖር ምንምን፣ ለነባሪ መመሪያ መደበኛን፣ ለአግባብ አብሮ የተሰራ መመሪያ Autoን፣ ወይም ለተመረጡ መመሪያዎች እና ለራስዎ የተገደቡ መመሪያዎች በእጅ የሚለውን ይምረጡ። ቅድመ-ቅምጦች ምርጫውን ማቆየት ይችላሉ።

ዋናው ካታሎግ አጠቃላይ ኮድ አጻጻፍን፣ አርክቴክቸርን፣ ደህንነትን፣ አስተማማኝነትን፣ አፈጻጸምን፣ ሙከራን እና የበይነገጽ አጠቃቀምን ይሸፍናል። Auto መመሪያ ለመምረጥ የሚገኘውን የተግባር/የደረጃ ጽሁፍ ይጠቀማል፤ በድብቅ ሌላ ሞዴል አይጠራም ወይም ባለሙያነትን አያረጋግጥም። የአተገባበር እቅዱን ከመቀበልዎ በፊት የእቅድ ጥቆማዎችን መመርመር እና መለወጥ ይቻላል።

የግምገማ ልዩ ሙያዎች ትኩረትን ለመምራት ይረዳሉ ነገር ግን ገለልተኛ ማስረጃዎችን፣ የመዳረሻ ገደቦችን ወይም የተዋቀረውን ውሳኔ በጭራሽ አይተኩም። ብጁ መመሪያዎችን እንደ የተግባር ወሰን አካል አድርገው ይያዙ፡ የሰነድ መቀበልን፣ የመሳሪያ ፖሊሲን፣ ማረጋገጫን ወይም የገምጋሚ ውድቀቶችን ለማለፍ አይጠቀሙባቸው።

ተዛማጅ መመሪያዎች: ዋናው የጥያቄ ካታሎግ.

Work: ከጥያቄ ወደ ሰነድ

Work Gitን አይፈልግም። ነባሪ የተለየ የተግባር አቃፊ ይፈጥራል፤ ብጁ በአገር በቀል መራጭ በኩል ያለውን አቃፊ ይመርጣል። ረቂቅ አስቀምጥ ያለ ግምት (inference) ቅንብሮችን ያከማቻል፤ ጀምር የመጀመሪያውን ምዕራፍ ያካሂዳል።

Auto በቀጥታ ይመልሳል ወይም ከእውነተኛ የሚደረጉ ነገሮች (To-dos) ጋር ተስማሚ እቅድ ያቀርባል። Brainstorm ተጨማሪ ሀሳቦችን ወይም ግምገማን ከመምረጥዎ በፊት ideas.mdን ይፈጥራል። Research findings.mdን፣ ምንጮችን እና ገደቦችን ያቆያል። Write ከአላማ እና ጠቃሚ በሚሆንበት ጊዜ ከoutline.md ወደ ገላጭ ሰነድ ወይም draft.md ይሸጋገራል፤ ክለሳዎች የቀድሞ ስሪቶችን ያቆያሉ።

በአገር በቀል መራጭ በኩል የፋይል ግብአቶችን ይምረጡ እና በ@ ያመልክቷቸው። መተግበሪያው እንደ የማይለወጡ የተግባር ግብአቶች አድርጎ ይገለብጣቸዋል እና ከመሮጡ በፊት ማንነታቸውን ያረጋግጣል። ነባሪ በመተግበሪያ ባለቤትነት የተያዘ የተግባር አቃፊ ይፈጥራል፤ የብጁ አቃፊ መዳረሻ የተቀመጠ የባለቤት ስጦታ ነው። የተቀመጠ፣ ያልተጀመረ ረቂቅ አቃፊውን ሊለውጥ ይችላል።

ገለልተኛ የአስፈጻሚ ቅንብሮች ያላቸው የ1–4 ቅጂዎችን ይፍጠሩ። ተደራራቢ አቃፊዎችን የሚጠቀሙ ተግባራት በአንድ ጊዜ መጻፍ አይችሉም። ይህ ቅንጅት ለZIAForge ስራዎች ተፈጻሚ ይሆናል እንጂ ለዘፈቀደ የውጭ ፕሮግራሞች አይደለም።

Deep Brainstorm በነባሪ ሶስት ገለልተኛ ሰራተኞችን ይጠቀማል እና እስከ ስምንት ድረስ ይደግፋል። ቅደም ተከተላቸውን እና አወቃቀራቸውን ይምረጡ፣ ይህም ቅድመ-ቅምጥን በተለዩ አውዶች ውስጥ እንደገና መጠቀምን ይጨምራል። የሰራተኛ ጥያቄዎች መነሻቸውን ያቆያሉ፤ የተበላሹ ሪፖርቶች አንድ የቅርጸት-ጥገና ሙከራ ያገኛሉ። ከፊል ውድቀት እንደ ሙሉ ስኬት ከመቅረብ ይልቅ የሚታይ ሆኖ ይቆያል።

Deep የተያዙትን የሰራተኛ ሪፖርቶች ወደ brainstorm_report.md ያጣምራል እና ሁልጊዜ የተጠቃሚ ውሳኔን ይጠይቃል። ትንሽ ክትትል በአስተባባሪው በኩል ሪፖርቱን ያሻሽላል፤ ትልቅ ለውጥ የቀዘቀዙትን ሰራተኞች ሌላ ዙር ያስጀምራል። ቅርሶች ስሪቶቻቸውን ያቆያሉ።

የተፈቱ ሚናዎች በተግባር ፈጠራ ወይም በግልጽ ረቂቅ ማስቀመጥ ወቅት ይቀዘቅዛሉ። ከመጀመሪያው ጥሪ በኋላ፣ አውቶማቲክ/በእጅ እድገት ብቻ ሊለወጥ ይችላል፤ ለተለያዩ የሚና ወይም የሞዴል ቅንብሮች አዲስ ተግባር ይጠቀሙ። ዓለም አቀፍ ቅድመ-ቅምጥን ማረም የኋለኛውን ምዕራፎች በጸጥታ አይለውጥም።

በእጅ ሁነታ ከፍተኛ የሆነ የWrite ረቂቅን ጨምሮ ብቁ በሆኑ ምዕራፎች መካከል ለአፍታ ይቆማል። Auto በዚያ ረቂቅ በኩል ሊቀጥል ይችላል። ጥያቄዎች፣ የቀረቡ ተፈጻሚ እቅዶች፣ የBrainstorm አቅጣጫ እና የDeep ሪፖርት ግምገማ በAuto ውስጥም ቢሆን ግልጽ ውሳኔዎች ሆነው ይቆያሉ። ጥቅስ ብቻውን አሰሳ መከሰቱን አያረጋግጥም፣ እና የተያዘ የሁለትዮሽ ፋይል ብቻውን አቀራረቡን አያረጋግጥም።

ተዛማጅ መመሪያዎች: የWork ሁነታዎች እና ውሳኔዎች.

ቅድመ-ቅምጦች፣ ሞዴሎች እና መዳረሻ

ቅድመ-ቅምጥ CLI/APIን፣ ሞዴልን፣ የአመክንዮ ጥረትን እና ፈቃዶችን ያስቀምጣል። የቻት ግርጌ ቅድመ-ቅምጥ፣ CLI፣ ሞዴል እና የአማራጮች ክፍሎች አሉት። ብጁ ያለ ቅድመ-ቅምጥ ይሰራል፤ ቅድመ-ቅምጥ ፍጠር የአሁኑን ምርጫ ያስቀምጣል።

ካታሎጉ ከሚደገፈው ከተመረጠው የተጫነ CLI ወይም API የመጣ ነው። አድስ ምርጫውን ሳይቀይር ዝርዝሩን ያዘምናል። ግኝት የማይገኝ ከሆነ፣ ግልጽ የሆነ ሞዴል ID ያስገቡ፤ አቅራቢው አሁንም መደገፍ አለበት። የአመክንዮ ደረጃዎች በሞዴሉ እና በCLI ላይ የተመሰረቱ ናቸው። የአቅራቢው ነባሪ ከግልጹ none ቶከን የተለየ ነው።

ለውጦችን የሚተገብሩት ከጀርባ እውቅና ከተሰጠ በኋላ ብቻ ነው። በንቁ ተራ ወይም ባዶ ባልሆነ ወረፋ ወቅት መቀያየር የተገደበ ነው። ረቂቆች እና የሚታየው ታሪክ ይቀራሉ፣ ነገር ግን አቅራቢዎችን መቀየር የግል የውስጥ ሁኔታቸውን አያስተላልፍም።

በForge ውስጥ፣ የሚናው ስያሜ አስፈላጊ ነው፡ ዝግጅት የተለየ አቅራጅ (Planner) ሊጠቀም ይችላል። ግርጌው የሚታየውን ሚና ይለውጣል፤ ገምጋሚዎች እና ረዳቶች በስራ ፍሰት ቅንብሮች ውስጥ ይመረጣሉ። ቀድሞውኑ ለተረጋገጠ አተገባበር ፖሊሲ ሊቆለፍ ይችላል።

ፈቃዶች በአቅራቢዎች መካከል ይለያያሉ። አስማሚው በሚደግፍበት ቦታ ተነባቢ ብቻ እና የስራ ቦታ ጽሁፍ ይገኛሉ። Antigravity አገር በቀል የCLI ቅንብሮችን ወይም በግልጽ የተመረጠ ሙሉ መዳረሻን ይጠቀማል። ሙሉ መዳረሻ ማጠሪያ (sandbox) አይደለም።

ልዩ ሙያ የጥያቄ መመሪያን ይጨምራል እንጂ ሌላ ሞዴል ወይም ፈቃድ አይደለም። ቅድመ-ቅምጦች እና ሚናዎች ምንም፣ መደበኛ፣ Auto እና በእጅ ይደግፋሉ። Auto ያለ ተጨማሪ የሞዴል ጥሪ ከደረጃ ጽሁፍ መገለጫዎችን ይመርጣል፤ በእጅ እስከ አራት ልዩ ሙያዎችን እና ብጁ መመሪያዎችን ይቀበላል። በአቅራጅ የቀረቡ ምደባዎች እቅዱን ከመቀበልዎ በፊት ሊታረሙ ይችላሉ።

በእጅ የገባ ሞዴል ID ወይም ጥረት የእርስዎ ምርጫ ሆኖ ይቆያል፣ ነገር ግን አቅራቢው ውድቅ ሊያደርገው ይችላል። ዓለም አቀፍ ቅድመ-ቅምጥን ማረም የሚሰራን ቻት ወይም ተቀባይነት ያለው እቅድ ወደ ኋላ ተመልሶ አይለውጥም። ስራ ፈት የሆነን ውይይት ሆን ብለው ለመቀየር የራሱን የውቅር መቆጣጠሪያዎች ይጠቀሙ እና እውቅና እስኪያገኝ ይጠብቁ። የአካል ጉዳተኛ (የቦዘነ) አማራጭ እንደ ችሎታ ወይም የሕይወት ዑደት ገደብ መነበብ አለበት እንጂ የተቀመጠውን JSON በማረም መታለፍ የለበትም።

ተዛማጅ መመሪያዎች: የአቅራቢ ችሎታዎች.

ቻቶች፣ አቁም እና ወረፋው

ክፍት ትሮች፣ የቅርብ ጊዜ እና ረቂቆች የአንድ ተግባር ናቸው። ትርን መዝጋት ከክፍት ያስወግደዋል ነገር ግን በቅርብ ጊዜ ውስጥ ያቆየዋል፣ እና የአቅራቢውን ሂደት ወይም የሚተዳደር የስራ ፍሰትን አያቆምም። ታሪክን ይፈልጉ፣ ቻትን እንደገና ይክፈቱ ወይም ሁሉንም ተጨማሪ ትሮች ከታሪክ ምናሌው ይዝጉ።

አቁም የአሁኑን ተራ ያቋርጣል። ከሚቀጥለው ላክ በፊት ማቆም እስኪያበቃ ድረስ ይጠብቁ፡ የማቋረጥ ማረጋገጫ የሂደት መጠናቀቅ አይደለም። እስከዚያው ድረስ የሚቀጥለውን ረቂቅ መተየብ ይችላሉ።

በተለመደው ቻት ውስጥ፣ ወረፋ ከአሁኑ ረቂቅ ተለይቶ በኋላ የሚቀርብ ጥያቄን ያስቀምጣል። ወረፋን ለአፍታ አቁም ተጨማሪ ማድረስን ይይዛል። አቁም እና ውጣ ወረፋውን ለአፍታ ያቆማሉ። እንደገና ከጀመሩ በኋላ በመጀመሪያ ቀጥል ያድርጉ፣ ከዚያም ወረፋውን በግልጽ አስቀጥል።

እርግጠኛ ያልሆነ ማለት ማድረሱ አይታወቅም ማለት ነው። እንዲህ ዓይነቱ መልእክት በራስ-ሰር እንደገና አይላክም፡ ታሪኩን ይመርምሩ፣ ተገቢ ከሆነ ጽሁፍ ይቅዱ እና በወረፋ የተያዘውን ንጥል ያሰናብቱ። እንደገና መላክ አዲስ ሆን ተብሎ የሚደረግ ጥያቄ ነው።

የሚተዳደሩ የደረጃ ቻቶች የተለመደውን ወረፋ ሳይሆን የስራ ፍሰታቸውን ይጠቀማሉ። ደረጃን ተከተል የአሁኑን ምዕራፍ ያሳያል፤ ሌላ ትርን እራስዎ መምረጥ መከተልን ያቆማል። የCLI ምዝግብ ማስታወሻዎች ከምላሹ ተለይተው ምርመራዎችን ያሳያሉ።

የማርክዳውን ምላሾች አርዕስቶችን፣ ዝርዝሮችን፣ ሰንጠረዦችን፣ አገናኞችን እና የታጠረ ኮድ ያሳያሉ። የመሳሪያ ካርዶች እና የCLI ምርመራዎች ከመልሱ ተለይተው ይቆያሉ። በአምሳያው የተዘገቡ የአስተሳሰብ እና የቶከን መለኪያዎች የሚታዩት አቅራቢው በትክክል ሲያሳያቸው ብቻ ነው፤ ከአኒሜሽን የግል አመክንዮ ወይም አጠቃቀምን አይገምቱ።

እርግጠኛ ካልሆነ የመላክ ወይም የወረፋ ማረጋገጫ በኋላ፣ ታሪክን ይመርምሩ እና በሚቀርብበት ጊዜ ተመሳሳይ የተቀመጠ ጥያቄን ብቻ እንደገና ይሞክሩ። የወረፋ ደረሰኝ ማለት ማከማቻው ንጥሉን ተቀብሏል ማለት ነው እንጂ ማስተዋል (inference) አልቋል ማለት አይደለም። እርግጠኛ ያልሆነ በወረፋ የተያዘ ንጥልን እንደ ግልጽ ማሰናበት ብቻ ያስወግዱ፤ አስቀድሞ የተላለፈን ጥያቄ መመለስ አይችልም።

ተዛማጅ መመሪያዎች: ዘላቂ የመልእክት ወረፋ.

ፋይሎች፣ Git እና ማጠናቀቅ

ፋይሎች የተግባር አቃፊውን ያሳያል። ውጤቶችን ከመስፈርቶች ጋር ያወዳድሩ፣ ሰነዶችን ይክፈቱ እና ልዩነቶችን (diffs) ይመርምሩ። የሁለትዮሽ ፋይልን ማቆየት በዒላማው መተግበሪያ ውስጥ ትክክለኛ አቀራረብን አያረጋግጥም።

Git ሁኔታን፣ ለውጦችን እና ስራዎችን ከተመዘገቡ ውጤቶች ጋር ያቀርባል። Commit፣ merge እና push በነባሪ በእጅ ናቸው፤ አውቶማቲክ ስራዎች ሙሉ በሙሉ ለተረጋገጠ እቅድ የተለዩ ምርጫዎች ናቸው።

በማረጋገጫ እና በህትመት መካከል የሚሰሩ ፋይሎችን አይቀይሩ፡ ማጽደቅ ከትክክለኛ ባይቶች ጋር የተሳሰረ ነው። ግጭቶች፣ ያልተሳኩ pushዎች እና ያልታወቁ የስራ ውጤቶች ግልጽ ውሳኔ እስኪሰጥ ድረስ እድገትን ያግዳሉ። Auto ማተምን በጸጥታ አይፈቅድም።

Work ምንም የGit ቅርንጫፎችን አይፈጥርም እና ምንም የGit ማጠናቀቂያ የለውም። ስሪቶችን እና ምንጮችን ጨምሮ አስፈላጊ ሰነዶችን ከተመረጠው አቃፊ ያቆዩ።

የፋይል አርታዒው በቅጥያ አገባብ፣ ፍለጋ እና መተካት፣ የመቀልበስ ታሪክ፣ የመስመር መጠቅለያ እና በአንድ ትር ረቂቆችን ያቀርባል። ማስቀመጥ የሚደገፈውን የUTF-8/UTF-16 ኢንኮዲንግ ይጠብቃል እና የውጭ ማሻሻያ ግጭቶችን ውድቅ ያደርጋል። ሌሎች ኢንኮዲንጎች እና የሁለትዮሽ ይዘቶች የውጭ አርታዒ ያስፈልጋቸዋል። ያልተቀመጡ ረቂቆች ባለቤቱ እስኪያድናቸው ወይም እስኪያጠፋቸው ድረስ የመተግበሪያውን መውጣት (Quit) ይከላከላሉ።

ሙሉ አገባብ እስከ 8 MiB ድረስ ነቅቷል። ትላልቅ የጽሁፍ ፋይሎች በ256 KiB መስኮቶች ውስጥ ይከፈታሉ፤ 8–64 MiB ያለ አገባብ ሙሉ በሙሉ በግልጽ ሊጫኑ ይችላሉ። ከ64 MiB በላይ የመስኮት አርትዖት እና የተገደበ የቀጣይ-ግጥሚያ ፍለጋን ይጠቀሙ። ይህ የተገደበ ትልቅ-ፋይል ሁነታ ነው እንጂ በዘፈቀደ ትላልቅ ሰነዶች የSublime Text እኩልነት አይደለም።

አቃፊ ክፈት ዋናውን ማከማቻ (repository) ብቻ በጸጥታ ከመክፈት ይልቅ የአሁኑን ተግባር ወይም የቅርንጫፍ/የስራ ዛፍ አውድ ይጠቀማል። የፋይል ረድፍ የዚያን ፋይል የወላጅ ማውጫ ሊያሳይ ይችላል። መንገዶች በተመዘገቡ የተግባር ድጎማዎች ላይ በጀርባ (backend) ይረጋገጣሉ። የሁለትዮሽ ፋይሎች እንደ ተራ ጽሁፍ ሊታረሙ አይችሉም፤ የታለመውን መመልከቻ ይጠቀሙ እና የመጀመሪያዎቹን ባይቶች ያቆዩ።

የስራ ዛፍ ማስወገድ የተለየ ጥበቃ የሚደረግበት እርምጃ ነው። ስራ ፈት የሆኑ ክፍለ-ጊዜዎችን ጨምሮ ከማስወገድዎ በፊት የተያያዙ የተዋቀሩ ክፍለ-ጊዜዎችን እና ተርሚናሎችን ያጠናቅቁ። የተቀመጠውን የGit ውጤት እና የመልሶ ማግኛ ሁኔታ ይመርምሩ፤ የተግባር መዝገብን መሰረዝ ያልተፈጸመውን (uncommitted) ስራ በጥንቃቄ ለመጠበቅ ምትክ አይደለም።

ተዛማጅ መመሪያዎች: የተተየበ የአርታዒ ውል · የGit ፖሊሲዎች.

የAPI ግንኙነቶች

ግንኙነቶች በግልጽ የተመረጠ OpenAI-ተኳኋኝ የመጨረሻ ነጥብን (endpoint) ያክላል። ስም፣ መሰረታዊ URL፣ ሞዴል እና አስፈላጊ ከሆነ ቁልፍ ያስገቡ። በርካታ ሰርቨሮች በ/v1 የሚያልቅ መሰረታዊ URL ይፈልጋሉ፤ የመጨረሻ ነጥብ ሰነድዎን ይመልከቱ።

ከloopback HTTP በስተቀር HTTPS ያስፈልጋል። በURL ውስጥ ምስክርነቶች (credentials) ያልተካተቱበትን ተራ የመጨረሻ ነጥብ ይጠቀሙ። ቁልፎች የሚደገፈውን የOS ምስጠራ ይጠቀማሉ እና ወደ UI አይመለሱም። የመጨረሻ ነጥቡን መቀየር ቁልፉን እንደገና ማስገባትን ይጠይቃል። የቁልፍ መስኩን ባዶ መተው የተቀመጠውን ቁልፍ ጠብቆ ያቆያል፤ የተቀመጠውን ቁልፍ አስወግድ የሚለው በግልጽ ያጸዳዋል።

የAPI ጥሪዎች የCLI ምዝገባን አይጠቀሙም። መሳሪያዎች እና ሞዴሎች ከአገር በቀል (native) ክፍለ-ጊዜዎች ይለያያሉ፣ እና የተሳካ የሞዴል ግኝት ማስተዋልን (inference) አያረጋግጥም። የቶከን አጠቃቀም የሚታየው አቅራቢው በትክክል ሲመልሰው ብቻ ነው።

ምስክርነቶችን በተግባር ጽሁፍ ወይም በቅድመ-ቅምጥ መመሪያዎች ውስጥ ከማስቀመጥ ይልቅ በግንኙነቶች ውስጥ ያስቀምጡ። ተነባቢ-ብቻ ገምጋሚዎች የተፈቀደላቸውን የAPI ፋይል መሳሪያዎች ብቻ ይቀበላሉ፤ የሪፖርት አርክቴክቱ ምንም መሳሪያዎች የሉትም። የማይደገፉ የመሳሪያ ጥሪዎች በጸጥታ ከመፈጸም ይልቅ ውድቅ ይደረጋሉ። ሰርቨሮች በአመክንዮ መለኪያዎች፣ በመሳሪያ ድጋፍ እና በሞዴል ዝርዝሮች ይለያያሉ፤ ስህተትን ከመጨረሻ ነጥብዎ የራሱ ውል ጋር ያወዳድሩ።

ተዛማጅ መመሪያዎች: የAPI ግንኙነቶች.

ቅንብሮች፣ ቋንቋዎች እና ደህንነቱ የተጠበቀ ዳግም ማስጀመር

አጠቃላይ ቅንብሮች የስራ ቦታን፣ የበይነገጽ ቋንቋን እና ነባሪዎችን ይመርጣሉ። ግንኙነቶች የAPI የመጨረሻ ነጥቦችን ያስተዳድራል። ቅድመ-ቅምጦች እና የግምገማ ቡድኖች የሚና አወቃቀሮችን ያቆያሉ። የርቀት መቆጣጠሪያ የአካባቢ ምስክርነቶችን፣ የአገልጋይ ወሰን እና የባለቤት ፈቃዶችን ያስተዳድራል፤ ዝመናዎች የልቀት ምንጭን/ቻናልን ያስተዳድራል። ስለ የሚለው ትክክለኛውን የሚሰራ ግንባታ ያሳያል።

የበይነገጽ ቋንቋ ከመጠየቂያ ቋንቋ እና ከሰነድ ግምገማ ሁኔታ የተለየ ነው። የምርት ስሞች፣ የትዕዛዝ መለያዎች፣ የፋይል ቅጥያዎች፣ የአቅራቢ ሞዴል መለያዎች እና በተጠቃሚ የተፈጠሩ ስሞች መለያዎች ሆነው ይቀራሉ። ወቅታዊ ትርጉም ሲገኝ እገዛ የተመረጠውን የበይነገጽ ቋንቋ ይከተላል፤ የማሽን ትርጉሞች ምልክት ይደረግባቸዋል እንዲሁም እንግሊዝኛ ይፋዊ ማጣቀሻ ሆኖ ይቆያል።

አስቀምጥ የሚታየውን ውቅር ተግባራዊ ያደርጋል። የውሂብ ጎታ ዳግም ማስጀመር ወይም የፋብሪካ ዳግም ማስጀመር የመተግበሪያ ሜታዳታን ሊያስወግድ ይችላል፤ ዳግም ማስጀመርን ሆን ብለው ከመጠቀምዎ በፊት ፋይሎችን እና የተሞከረ ምትኬን ይጠብቁ። እነዚህ ክዋኔዎች የአካባቢው ባለቤት እርምጃዎች ናቸው። ያልተሳካ የስራ ፍሰትን ወይም የተበላሸ መዝገብን ለመመርመር እንደ አቋራጭ መንገድ አይጠቀሙባቸው።

ተዛማጅ መመሪያዎች: የአካባቢያዊነት መመሪያዎች · የውሂብ መልሶ ማግኛ.

የእገዛ ረዳቱን ይጠይቁ

እገዛን ይክፈቱ፣ በረዳቱ ፓነል ውስጥ የተቀመጠ የተገናኘ ቅድመ-ቅምጥ ይምረጡ እና ስለ ZIAForge ይጠይቁ። ምላሾች የአሁኑን ይፋዊ የእንግሊዝኛ መመሪያ እና የመረጡትን የበይነገጽ ቋንቋ ይጠቀማሉ። የክፍል ማጣቀሻ አዝራሮች አግባብ የሆኑትን የመመሪያ ርዕሶች ይከፍታሉ፣ ስለዚህ ማብራሪያውን ከማጣቀሻው ጋር ማወዳደር ይችላሉ።

ይህ ረዳት እስከ 100 የተቀመጡ ግቤቶች እና 3 MiB ድረስ የተለየ የግል ውይይት ይይዛል። እስከ 12,000 ቁምፊዎች የሚደርስ ጥያቄ ያስገቡ፤ ላክ ይጠይቀዋል፣ አቁም ጥያቄዎ እንዳለ ሆኖ ንቁውን ምላሽ ይሰርዛል፣ እና አጽዳ ደግሞ ይህንን የእገዛ ውይይት ያስወግዳል። ያልተላከው ረቂቅዎ እና የቅድመ-ቅምጥ ምርጫዎ በእዚያው የመተግበሪያ ክፍለ-ጊዜ ውስጥ እገዛን መዝጋት ወይም እንደገና መክፈትን ይቋቋማሉ፣ ነገር ግን ረቂቁ በዲስክ ላይ አይቀመጥም። ረዳቱ የመተግበሪያ ትዕዛዞችን አይልክም፣ የስራ ፍሰትን አይለውጥም ወይም በርን አያጸድቅም። ምክር የተግባር፣ መለያ ወይም የውጭ ግንኙነት የቀጥታ ማረጋገጫ አይደለም።

የ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ን ይጠቀሙ። አዝራሮች ፕሮጀክቶችን፣ ተግባራትን፣ ቅጽበታዊ ገጽ እይታን፣ እገዛን እና ቋንቋን ይከፍታሉ። ዝርዝሮች በገጽ ስምንት ንጥሎችን ከኋላ፣ አድስ፣ መነሻ እና ቀዳሚ/ቀጣይ አሰሳ ጋር ያሳያሉ። የፕሮጀክት አዝራሮች የተግባር ዝርዝሩን ያጣራሉ፤ የተግባር ካርድ የተቀመጠውን የስራ ፍሰት ሂደት፣ ሞዴል/ቅድመ-ቅምጥ እና ሲኖሩ የሚጠበቁ ጥያቄዎችን ያሳያል።

ክፍት/የቅርብ ጊዜ ውይይቶችን እና የስራ ፍሰት ምዕራፍ ውይይቶችን አስቀድመው ለማየት የተግባሩን ውይይቶች ይክፈቱ። እያንዳንዱ ቅድመ-ዕይታ እስከ ስድስት የቅርብ ጊዜ የተጠቃሚ/ረዳት መልዕክቶችን ያሳያል፣ እያንዳንዳቸው በሚታይ ሁኔታ ወደ 200 ቁምፊዎች አጥረዋል። የግል አስተሳሰብ አይታይም። ታሪክን ማንበብ አቅራቢን አያስጀምርም። ቅድመ-ዕይታዎች ተነባቢ-ብቻ ናቸው፦ መደበኛ ጽሑፍ እና /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} ይፋዊ የካታሎግ ትዕዛዝ ይልካል። ለክርክር ቅርጾች የቀጥታ ካታሎጉን ያንብቡ። በመተግበሪያው ውስጥ እንዳለው ተመሳሳይ የጀርባ ፈቃድ እና የአቃፊ ፈቃዶች ተፈጻሚ ይሆናሉ።

መተግበሪያው የተቀመጡ የቦት-ቶከን እሴቶችን በጭራሽ ወደ ረዳቱ አይልክም። ሆኖም ቅጽበታዊ ገጽ እይታዎች፣ ማጠቃለያዎች እና የውይይት ጽሑፎች የግል የፕሮጀክት መረጃ ሊይዙ ይችላሉ። ቦቱ ወይም የባለቤቱ መለያ የማይታመን ከሆነ ውህደቱን በአካባቢው ያቁሙ። የፈሰሰውን ቶከን ከቦት አቅራቢው ጋር ይቀይሩ፣ ከዚያ በአካባቢው የተመሰጠረውን ውቅር ያዘምኑ።

ተዛማጅ መመሪያዎች: የግል ቦት እና ትዕዛዞች.

የባለቤት-ብቻ የአካባቢ ኮምፒውተር ፈቃድ

የአካባቢ ኮምፒውተር መዳረሻ ተሰናክሎ ይጀምራል። በአካባቢ ቅንብሮች → የርቀት መቆጣጠሪያ ውስጥ ሊያነቃው የሚችለው ባለቤቱ ብቻ ነው። ረዳቱ እና የHTTP/MCP/Telegram ትዕዛዞች ይህንን ባንዲራ ለራሳቸው ማንቃት አይችሉም። ክዋኔ ከተከለከለ፣ ረዳቱ ቅንብሩን መግለጽ እና ባለቤቱ እንዲወስን መተው አለበት።

በግልጽ ሲነቃ፣ computer.run ተፈጻሚ ፋይልን፣ የክርክር ድርድርን እና አማራጭ ፍጹም የስራ ማውጫን ይቀበላል። ምንም የሼል መግቢያ አይጠቀምም፣ የ30 ሰከንድ ገደብ አለው እንዲሁም ውጤቱን በ1 MiB ይገድባል። የቀረበ የጎደለ ወይም ልክ ያልሆነ ማውጫ ውድቅ ይደረጋል፤ cwdን መተው የመተግበሪያው የሆነውን የቅንብሮች ማውጫ ይጠቀማል እንጂ HOMEን አይደለም። መውጣት ንቁ የሆኑ የባለቤትነት ትዕዛዞችን ይሰርዛል እንዲሁም ሂደታቸው እስኪጸዳ ይጠብቃል።

የመተግበሪያ ማንበብ/መስራት ወሰን እና የአካባቢ መዳረሻ የተለያዩ ውሳኔዎች ናቸው። የስራ ዛፍ ያልተገደበ የአቅራቢ ፋይል ስርዓት መዳረሻን አይገድብም። ከአሁን በኋላ የማያስፈልግ ከሆነ ከተግባሩ በኋላ የአካባቢ መዳረሻን ይሰርዙ፣ እና የረዳቱን ጽሑፍ እንደ ማስረጃ ከመቀበል ይልቅ የትዕዛዝ ደረሰኞችን ይመርምሩ።

ተዛማጅ መመሪያዎች: የባለቤት-ብቻ ቁጥጥር ውል.

አሳሽ እና የርቀት ምሳሌዎች

የአካባቢው ባለቤት አገልጋዩን ያነቃል እንዲሁም አድራሻውን፣ ወደቡን እና ወሰኑን ይመርጣል፦ ለመመርመር ማንበብ ወይም ለድርጊቶች መስራት። ነባሪው 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 መጨረሻ ነጥብ አይደለም፦ ወደ 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 ልቀቶች ነው። ያልተፈረሙ የልማት ግንባታዎች በዚህ ዘዴ በራስ-ሰር አይጫኑም። በእጅ ለመተካት የአሁኑን መተግበሪያ ሙሉ በሙሉ ይዝጉ እና የተረጋገጠ ቅርስ ይጠቀሙ።

አውቶማቲክ ፍተሻ ሲነቃ ወዲያውኑ ይሰራል፣ ከዚያም በየስድስት ሰዓቱ ይሰራል።

የተረጋጋ የቅድመ-ዕይታ ልቀቶችን አያካትትም፤ ቅድመ-ዕይታ የልማት ልቀቶችንም ይፈቅዳል። የተሳካ ፍተሻ የሚገኘውን የልቀት ሜታዳታ ብቻ ያረጋግጣል። ማውረድ እና መጫን የመድረክ ጥቅል እና የተዋቀረ የልቀት ምግብ ያስፈልጋቸዋል። የLinux DEB አቅርቦት የተለየ የመጫኛ መንገድ ነው፤ DEB በmacOS የማዘመኛ ዘዴ በራስ-ሰር ይሻሻላል ብለው አያስቡ።

ተዛማጅ መመሪያዎች: የልቀት ዝግጁነት.

ዳግም ማስጀመር እና መልሶ ማግኛ

በmacOS ላይ፣ ሙሉ በሙሉ ለመዝጋት ውጣ / ⌘Q ይጠቀሙ። መስኮቱን መዝጋት መተግበሪያውን እንደሰራ ሊተወው ይችላል። መተግበሪያውን ከመተካትዎ በፊት የድሮውን ስሪት ሙሉ በሙሉ ያቁሙ።

ከተከፈተ በኋላ ያንኑ ተግባር ይምረጡ። ታሪክ እና ረቂቆች ይመለሳሉ። መልሶ መቀጠል የአካባቢውን አውድ ወደነበረበት ይመልሳል ነገር ግን ረቂቅ አይልክም፣ ወረፋውን አያስጀምርም ወይም ያልታወቀ ክዋኔን መድገም አይፈቅድም።

መልሶ ማግኛ ከታየ፣ JSONን በእጅዎ አያርሙ። የተጎዳውን የሰነድ ዓይነት ይመርምሩ፣ ዋናዎቹን ፋይሎች ይጠብቁ እና የተረጋገጠ መጠባበቂያ ይምረጡ። የቆየ ወረፋን ወደነበረበት መመለስ ንጥሎቹን እርግጠኛ እንዳልሆኑ ምልክት ያደርግባቸዋል።

አቅርቦት በማይታወቅበት ጊዜ፣ የሚተዳደር የስራ ፍሰት ለአዲስ አውድ ግልጽ ፈቃድ ሊያስፈልገው ይችላል። የቀድሞ ስራ እና ያልተሳኩ ሙከራዎች ይቀራሉ፤ የሚታይ እምቢታ ከተፈበረከ ስኬት የበለጠ አስተማማኝ ነው።

ሁሉም የመተግበሪያ ምሳሌዎች ተዘግተው ሳሉ የተግባር ፋይሎችን እና የመተግበሪያ መገለጫን ምትኬ ያስቀምጡ። የተገለበጠ አቃፊ የተሞከረ መልሶ ማግኛ አይደለም። መልሶ ማግኛ የተረጋገጠ መጠባበቂያ እንዲመርጡ ከጠየቀዎት፣ ትክክለኛዎቹን የተበላሹ ፋይሎችም ያቆዩ። የቆየ የስራ ፍሰት ወይም ወረፋ ወደነበረበት መመለስ እርግጠኛ ያልሆነ ግምትን ወይም የGit ክዋኔዎችን በድጋሚ ለማስኬድ ፈቃድ አይሰጥም።

ተዛማጅ መመሪያዎች: የመልሶ ማግኛ ውል.

ችግር መፍታት

CLI አልተገኘም፦ በመደበኛ ተርሚናል ውስጥ ጭነቱን እና ስሪቱን ያረጋግጡ፣ ከዚያ ZIAForgeን እንደገና ያስጀምሩ። ተፈጻሚ ፋይል መኖሩ ገብተዋል ማለት አይደለም። የአቅራቢውን የራስዎን የመግቢያ ዘዴ ይጠቀሙ።

ሞዴል አይገኝም ወይም ማረጋገጫ አልተሳካም፦ ግኝትን ያድሱ፣ የሚገኝ ID ይምረጡ እና መለያዎን እና ገደቦችዎን ያረጋግጡ። ታሪኩን ከመመርመርዎ በፊት እርግጠኛ ያልሆኑትን ጥያቄ አይደግሙ።

የስራ ፍሰት ቆሟል፦ የአሁኑን ምዕራፍ፣ ጥያቄ፣ የማረጋገጫ ደረሰኝ ወይም የCLI ምዝግብ ማስታወሻዎችን ይክፈቱ። የተወሰነውን ምክንያት ይፍቱ፦ ያልተመለሰ ጥያቄ፣ ትዕዛዝ፣ የአቃፊ ፈቃድ ወይም የሙከራ ገደብ። መቀጠል ያልተሳካ ፍተሻን ወደ ስኬት ሊለውጠው አይችልም።

አቃፊ ጠፍቷል ወይም ተተክቷል፦ ወደ ዋናው አቃፊ መዳረሻን ይመልሱ ወይም አዲስ ተግባር ይፍጠሩ። መተግበሪያው ከHOME መቀጠል የለበትም። ሌላ cwd ከተመለከቱ፣ ዙሩን ያቁሙ እና ምርመራዎችን ይጠብቁ።

ለሪፖርት፣ የስለ ስሪቱን፣ መስመሩን፣ CLI/ሞዴልን፣ የሚጠበቀውን እና ትክክለኛውን ባህሪ፣ ቅጽበታዊ ገጽ እይታን እና አስተማማኝ የምዝግብ ማስታወሻ ቅንጭብን ያካትቱ። ሊታተሙ የማይችሉ ምስጢሮችን፣ የግል ይዘቶችን እና ዱካዎችን ያስወግዱ።

የርቀት ገጽ አይገኝም፦ ባለቤቱ አገልጋዩን ማብራቱን ያረጋግጡ፣ የሚያዳምጠውን አድራሻ እና ወደብ ይፈትሹ፣ ከዚያ በትክክለኛው የምሳሌ ቶከን ያረጋግጡ። 401 ማረጋገጫን ያሳያል፤ የተከለከለ ለውጥ የማንበብ ወሰን ወይም የባለቤት-ብቻ ቁጥጥር ሊሆን ይችላል። ቶከኑን መቀየር ነባር የአሳሽ ደንበኞችን ይዘጋል። የተለየውን የ DevTools መመርመሪያ ወደብ እንደ የርቀት መተግበሪያ ቁጥጥር አያጋልጡ።

የአርታዒ ማስቀመጥ ተከልክሏል፦ ረቂቁን ያቆዩ፣ በዲስክ ላይ ያለውን የአሁኑን ፋይል ይመርምሩ እና የውጭ-ለውጥ ግጭትን ይፍቱ። የመተግበሪያ ሜታዳታን እንደገና በመጻፍ ንጽጽሩን አያልፉ። የትላልቅ ፋይሎች ሙሉ ጭነት የማይገኝ ከሆነ፣ የሚደገፈውን የመስኮት አርትዖት/ፍለጋ ወይም ውጫዊ አርታዒ ይጠቀሙ።

Telegram አይገኝም፦ የቦት ቶከኑን፣ የቁጥር ባለቤቱን፣ የግል ውይይቱን እና ሁኔታውን በአካባቢው ያረጋግጡ። ተፎካካሪ ዌብሁክ ወይም ፖለር ምርጫን ሊያግድ ይችላል፤ ZIAForge በራስ-ሰር ዌብሁክን አይሰርዝም ወይም ሌላ ፖለርን አይቆጣጠርም። ባልታወቀ ወሰን ላይ ውድቅ የተደረጉ ወይም የተቋረጡ ትዕዛዞች በራስ-ሰር አይደገሙም።

ተዛማጅ መመሪያዎች: ሙከራ እና ምርመራ.

ችግሮችን ሪፖርት ያድርጉ እና ማስረጃዎችን ይመርምሩ

ትክክለኛውን የሚሰራ ግንባታ ከስለ ዝርዝር፣ OS/አርክቴክቸር፣ የተግባር ሁነታ፣ የተመረጠ አቅራቢ/ሞዴል እና ችግሩን መልሰው የሚያስነሱትን እርምጃዎች ይመዝግቡ። የሚጠበቀውን ውጤት እና የታየውን ውጤት ይግለጹ። ሙሉ የግል መገለጫ ከማጋራት ይልቅ፣ ደህንነቱ የተጠበቀ ቅጽበታዊ ገጽ እይታ እና አግባብ ያለው የተቀመጠ ትዕዛዝ ወይም የማረጋገጫ ደረሰኝ ያካትቱ።

የCLI ምዝግብ ማስታወሻዎች፣ የክስተት መዝገቦች፣ የሞዴል ግልባጮች፣ የአሳሽ ዱካዎች እና ቅጽበታዊ ገጽ እይታዎች የምንጭ ኮድን፣ የግል ዱካዎችን ወይም ቶከኖችን ሊያጋልጡ ይችላሉ። ከማጋራትዎ በፊት ይመርምሩ እና አደገኛ ውሂብን ያጥፉ። የተቻለውን ያህል ጥረት የሚያደርግ የምዝግብ ማስታወሻ አጣሪ ቅጽበታዊ ገጽ እይታ ወይም ማህደር ለህዝብ የሚጋራ መሆኑን አያረጋግጥም።

ለአስተዋጽዖ አበርካቾች፣ qa:doctor የአካባቢ/ግንባታ መለያን ያነባል፤ qa:inspect ከአቅራቢ አምሳያዎች ጋር የተነጠለ መገለጫ ይከፍታል። ቋሚ የሙከራ ውሂብ ሞዴል ሳያነጋግር የተፈተሸውን የመተግበሪያ መንገድ ያረጋግጣል። የቀጥታ ግምት፣ የTelegram ግንኙነት፣ የአካባቢ Linux ዴስክቶፕ፣ የፊርማ እና የታሸጉ ቅርሶች ፍተሻዎች የተለያዩ ማስረጃዎች ናቸው። ሊደገሙ ለሚችሉ ትዕዛዞች እና ጽዳት TESTING.mdን ይመልከቱ።

ተዛማጅ መመሪያዎች: የማስረጃ ትዕዛዞች.

የአካባቢ ውሂብ እና ወሰኖች

ፕሮጀክቶች፣ ታሪክ፣ እቅዶች፣ ሰነዶች እና ምርመራዎች የግል ጽሑፍ ሊይዙ ይችላሉ። መገለጫዎችን፣ ያልተጣሩ ቀረጻዎችን፣ ቁልፎችን ወይም ሙሉ ምዝግብ ማስታወሻዎችን ከምንጭ ኮድ ጋር አያትሙ።

በLinux ላይ፣ የAPIን፣ ቁጥጥርን፣ Telegramን እና የምሳሌ ምስክርነቶችን ማስቀመጥ የተከፈተ የGNOME ሚስጥር አገልግሎት ወይም KWalletን ይፈልጋል፤ የሚደገፍ የምስጢር ማከማቻ ከሌለ፣ ZIAForge የElectronን የbasic_text አማራጭ ከመጠቀም ይልቅ እነዚህን ምስጢሮች ለማስቀመጥ ፈቃደኛ አይሆንም።

የአካባቢ ማከማቻ ጥያቄዎች በኮምፒውተርዎ ላይ ይቆያሉ ማለት አይደለም፦ የተመረጠው CLI/API ወደ አቅራቢው ይልካቸዋል። የስራ አቃፊ እና የሂደት ቁጥጥር የOS ማግለል አይደሉም። የተመረጡትን ፈቃዶች ይመርምሩ።

የማስረጃ ዓይነቶችን ይለዩ፦ ቋሚ ሙከራዎች መተግበሪያውን ያለ ሞዴል ይፈትሻሉ፤ የቀጥታ አካባቢያዊ እውነተኛ CLI/መለያን ይለማመዳል፤ የታሸጉ ፍተሻዎች የተወሰነ ቅርጽን ያረጋግጣሉ። አንዱን ማለፍ ሌሎቹን ዋስትና አይሰጥም።

የመተግበሪያ ወሰን፣ የስራ ዛፍ እና ተነባቢ-ብቻ መጠየቂያ ከስርዓተ-ክወና ማስገደድ የተለዩ ናቸው። የAntigravity ገምጋሚ/ረዳት ፖሊሲዎች የፋይል ስርዓት ተነባቢ-ብቻ መዳረሻን ከማስገደድ ይልቅ በተሰበሰበ የስራ ቦታ ማስረጃ ውስጥ ለውጦችን ያገኛሉ። የአካባቢ ኮምፒውተር ቁጥጥር በባለቤቱ የተፈቀዱ ፕሮግራሞችን ከመደበኛ የመተግበሪያ-መሳሪያ ወሰን ውጭ ያስፈጽማል፤ ከአሁን በኋላ የማያስፈልግ ሲሆን ያጥፉት።

ተዛማጅ መመሪያዎች: መነሻ እና ህትመት.

ይህንን ክፍት ምንጭ ፕሮጀክት ይረዱ እና ይቀይሩ

በመጀመሪያ AGENTS.md እና CONTRIBUTING.mdን ያንብቡ፣ ከዚያ ለአሁኑ የምንጭ ወሰኖች PROJECT_MAP.mdን ያንብቡ። የተተገበሩ የተገለጹ ውሎች እና የአሁኑ የስራ ፍሰት/አቅራቢ ሰነዶች ባህሪን ይገዛሉ። CONCEPT.md እና በተርሚናል-የሚጀምሩ የARCHITECTURE.md ክፍሎች ታሪካዊ ዓላማን ይጠብቃሉ እንዲሁም አሁን ላለው ልቀት የይገባኛል ጥያቄዎች ተደርገው መወሰድ የለባቸውም።

የእንግሊዝኛ እገዛ ምንጭ docs/help/en.json ነው። የተፈጠረውን USER_GUIDE.md ወይም website/guide.html በእጅዎ አያርሙ። ይፋዊውን ክፍል ይለውጡ፣ የተጎዳውን ውል ያዘምኑ እና node scripts/help/generate.cjsን ያስኪዱ። የውስጠ-መተግበሪያ እገዛ ያንኑ ምንጭ ያነባል። ጭማሪዎችን ከትክክለኛው አተገባበር ጋር ይገምግሙ፣ ይህም ገደቦችን፣ ፈቃዶችን እና የማይደገፉ መንገዶችን ይጨምራል።

እያንዳንዳቸው 56 የበይነገጽ ቋንቋዎች በdocs/help/locales.json ውስጥ የተለየ የእገዛ ሁኔታ አላቸው። የጎደለ ወይም ያልተሟላ እገዛ ወደ እንግሊዝኛ ይመለሳል። የተሟሉ በማሽን የተተረጎሙ አካላት ምልክት ይደረግባቸዋል እና ከእንግሊዝኛው የምንጭ ሃሽ ጋር ይያያዛሉ፣ ይህም የሰው ግምገማ ሳይጠየቅ ነው። በሰው የተገመገመ ትርጉም በተጨማሪም ገምጋሚውን ይመዘግባል። እያንዳንዱ ትርጉም የክፍል መለያዎችን፣ ድርጊቶችን፣ የፋይል/ትዕዛዝ መለያዎችን እና ቴክኒካዊ ገደቦችን መጠበቅ አለበት፣ ትክክለኛውን አቅጣጫ መጠቀም አለበት፣ እና የእንግሊዝኛ ምንጩ ሲቀየር መታደስ አለበት።

ከማቅረብዎ በፊት፣ ያረጀ የተፈጠረ ውጤትን፣ ልክ ያልሆኑ የቋንቋ ቅርጾችን ወይም የተበላሹ የአካባቢ የውል አገናኞችን ለመለየት node scripts/help/generate.cjs --checkን ያስኪዱ። የUI የትርጉም ፍተሻዎች እና የመተግበሪያ ባህሪ ፍተሻዎች የተለያዩ እንደሆኑ ይቆያሉ። HELP_MAINTENANCE.md የአስተዋጽዖ አበርካቹን እና የAI የማዘመን ሂደትን ይሰጣል፤ ሰነዶች ያልተካሄደን ፈተና አለፈ ብለው መናገር የለባቸውም።

ተዛማጅ መመሪያዎች: የአሁኑ የፕሮጀክት ካርታ · የሰነድ ጥገና · የአስተዋጽዖ አበርካች መመሪያዎች · የወኪል መመሪያዎች.