Zinnector® CLI дээр хэрэглэгчдэд бодитоор тулгардаг алдаанууд, тэдгээрийн учир шалтгаан болон засах аргууд. Бүртгэл бүрд таны харах яг тэр текстийг заасан тул та энэ хуудаснаас хайж олох боломжтой. Хэрэв таны алдаа энд байхгүй бол тухайн алдаа заасан командыг ZINNECTOR_DEBUG=1 утгатай ажиллуулж, гарсан үр дүн, өөрийн node --version болон үйлдлийн системийн мэдээллийн хамт github.com/Zinn-Digital/zinnector/issues хаягаар issue үүсгэнэ үү.
Ажиллах орчны суулгалтыг зөвшөөрсний дараа шууд "spawn EINVAL" заах (Windows)
Энэ нь Zinnector® 0.1.0 болон 0.1.1 хувилбар дахь алдаа юм. Windows дээр ажиллах орчны суулгагч нь npm.cmd-г нэрээр нь дуудаж байсан бөгөөд Node нь CVE-2024-27980 аюулгүй байдлын засвараас хойш бүрхүүл (shell) ашиглахгүйгээр .cmd файлыг spawn хийхээс татгалздаг болсон — үүнээс болж суулгалт нь таныг Y гэж хариулснаас нэг секундийн дараа гацдаг байв. 0.1.2 хувилбарт зассан: npm нь одоо бүх платформ дээр ижил байдлаар бөгөөд бүрхүүл шаарддаггүй node npm-cli.js байдлаар ажилладаг болсон. Эхлээд npm install -g zinnector@latest, дараа нь zinnector dev командыг дахин ажиллуулна уу.
Суулгах үед "npm WARN EBADENGINE" эсвэл "Zinnector® needs Node 24 or newer" заах
Таны Node-ийн хувилбар 24-өөс хуучин байна. npm уг анхааруулгыг харуулдаг учир нь уг багцад engines: >=24.18.1 гэж тодорхойлсон байдаг; суулгалт ямар ч байсан дуусах боловч zinnector нь дараа нь ойлгомжгүй байдлаар алдаа зааж зогсохын оронд эхлэхээсээ шууд татгалздаг (гаралтын код 78). nodejs.org сайтаас одоогийн LTS хувилбарыг суулгана уу — Windows дээр winget install OpenJS.NodeJS.LTS, macOS дээр brew install node@24 — node --version нь v24 буюу түүнээс дээш утга харуулж байгааг баталгаажуулж, Zinnector®-ийг дахин суулгана уу.
"gyp ERR!", "Building from source with node-gyp", эсвэл "You need to install Visual Studio"
WordPress-ийн ажиллах орчинд зөвхөн Node 24 болон 25-д зориулсан урьдчилан бүтээсэн хоёртын (binary) файлууд бүхий үндсэн модуль бий. Шинэ Node дээр (2026 оны 9-р сарын байдлаар 26 ба түүнээс дээш) түүний суулгагч нь эх кодоос хөрвүүлэх горим руу шилждэг бөгөөд энэ нь ердийн Windows компьютер дээр Visual Studio шаардсанаар өндөрлөдөг. 0.1.2 хувилбарт зассан: Zinnector® юу ч татаж авахаас өмнө үүнийг илрүүлж, зөвхөн ажиллах орчинд зориулж Node 24-ийг татаж авдаг — ойролцоогоор 30 МБ, nodejs.org-ийн шалгах нийлбэрээр (checksums) баталгаажсан — ингэснээр юуг ч эх кодоос хөрвүүлэх шаардлагагүй болно. Хэрэв та хувилбараа ахиулсны дараа ч үүнийг харсаар байвал zinnector dev --reset-runtime командыг ажиллуулж, өмнөх дутуу хийгдсэн суулгалтыг эхлээд устгана уу.
npm цэвэрлэгээ хийх үед "EPERM" анхааруулга өгөх (Windows)
Энэ нь бараг үргэлж npm тухайн файлыг устгах гэж оролдох үед вирусийн эсрэг программ эсвэл хайлтын индексжүүлэгч ажиллах орчны node_modules доторх файлыг нээлттэй барьснаас болдог. Дараагийн zinnector dev командаар цэвэр директороос суулгалтыг дахин оролдоно; хэрэв энэ нь давтагдсаар байвал zinnector dev --reset-runtime нь эхлээд ажиллах орчны бүх директорыг устгаад дахин суулгадаг.
"the local playground runtime could not be installed"
Уг мессеж нь npm-ийн хамгийн сүүлийн мөрүүд болон Zinnector®-ийн ажиллуулсан яг тэр командыг агуулдаг тул та өөрөө ажиллуулж, бүтэн гаралтыг харах боломжтой. Ихэвчлэн сүлжээ эсвэл прокситой холбоотой асуудлаас үүдэлтэй байдаг — ажиллах орчныг таны өөрийн npm-ээр татаж авдаг тул npm config set proxy … болон бүртгэлийн толин тусгал (mirror) тохиргоо үйлчилнэ — эсвэл өмнөх дутуу суулгалтаас болдог ба үүнийг --reset-runtime нь цэвэрлэдэг.
"the local playground exited before it was ready", эсвэл хэзээ ч бэлэн болохгүй байх
Ажиллах орчны өөрийнх нь гаралтыг харахын тулд zinnector dev --verbose командыг ажиллуулна уу. Порт аль хэдийн ашиглагдаж байгаа нь хамгийн түгээмэл тохиолддог: zinnector dev --port 9401 командыг ашиглах, эсвэл zinnector.json дотор port-ыг тохируулна уу. Суусан боловч ачааллаж эхлэхгүй байгаа ажиллах орчинд: zinnector dev --reset-runtime. Эхний ачаалалт нь мөн WordPress-ийг өөрийг нь татаж авдаг тул удаан интернэт холболттой үед хэдэн минут хүлээнэ үү; CLI нь гацаж үлдэхийн оронд хугацаа дууссан тухай мэдээлэхээс өмнө 5 минут хүртэл хүлээнэ.
Push хийх үед "this project is not a git repository" заах
Байршуулалтыг хадгалах сангаас (repository) удирдан явуулдаг тул zinnector push-д платформ хандаж чадах алсын холболт (remote) бүхий сан хэрэгтэй. git init && git add -A && git commit -m initial, өөрийн GitHub эсвэл GitLab алсын холболтыг нэмж, дараа нь сайтад холбохын тулд zinnector link командыг ажиллуулна уу.
Байршуулсны дараа сайт цагаан дэлгэц заах
zinnector check командыг ажиллуулна уу. Арван тохиолдлын есөд нь энэ нь PHP хувилбарын зөрүү байдаг — та уг слотын ажиллаж байгаа хувилбараас шинэ PHP дээр хөгжүүлсэн байдаг — тайланд уг слотыг zinnector php <version> ашиглан аль хувилбар руу шилжүүлэх, эсвэл zinnector dev --php <version> ашиглан алинд нь тохируулж хөгжүүлэхийг зааж өгдөг. zinnector logs --error нь ноцтой алдааг (fatal) өөрийг нь харуулна.
Холбоотой