Ralat yang benar-benar dihadapi oleh pengguna dengan CLI Zinnector®, maksud bagi setiap ralat, dan cara penyelesaiannya. Setiap entri menyatakan teks tepat yang akan anda lihat, supaya anda boleh mencari teks tersebut pada halaman ini. Jika ralat anda tiada di sini, jalankan arahan yang gagal dengan ZINNECTOR_DEBUG=1 dan buka isu di github.com/Zinn-Digital/zinnector/issues bersama-sama output tersebut, node --version anda dan sistem pengendalian anda.
"spawn EINVAL" sejurus selepas menerima pemasangan masa jalan (Windows)
Pepijat dalam Zinnector® 0.1.0 dan 0.1.1. Pada Windows, pemasang masa jalan telah menjalankan npm.cmd mengikut nama, dan Node enggan memulakan proses fail .cmd tanpa shell sejak pembetulannya untuk CVE-2024-27980 — jadi pemasangan ranap satu saat selepas anda menjawab Y. Dibetulkan dalam 0.1.2: npm kini dijalankan sebagai node npm-cli.js, yang sama pada setiap platform dan tidak memerlukan shell. Jalankan npm install -g zinnector@latest, kemudian jalankan zinnector dev sekali lagi.
"npm WARN EBADENGINE" semasa pemasangan, atau "Zinnector® needs Node 24 or newer"
Versi Node anda lebih lama daripada 24. npm memaparkan amaran tersebut kerana pakej mengisytiharkan engines: >=24.18.1; pemasangan tetap selesai, tetapi zinnector kemudiannya enggan bermula (kod keluar 78) daripada mengalami kegagalan di bahagian lain yang mengelirukan kemudian. Pasang LTS semasa daripada nodejs.org — winget install OpenJS.NodeJS.LTS pada Windows, brew install node@24 pada macOS — sahkan bahawa node --version memaparkan v24 atau lebih tinggi, dan pasang Zinnector® sekali lagi.
"gyp ERR!", "Building from source with node-gyp", atau "You need to install Visual Studio"
Masa jalan WordPress mempunyai modul natif yang binari prapibinanya wujud untuk Node 24 dan 25 sahaja. Pada Node yang lebih baharu (26 dan ke atas, setakat September 2026), pemasangnya kembali kepada menyusun daripada sumber, yang pada mesin Windows biasa berakhir dengan permintaan untuk Visual Studio. Dibetulkan dalam 0.1.2: Zinnector® mengesan perkara ini sebelum memuat turun apa-apa dan mendapatkan Node 24 untuk masa jalan sahaja — kira-kira 30 MB, disahkan terhadap hasil tambah semak nodejs.org — jadi tiada apa-apa yang perlu disusun. Jika anda masih melihatnya selepas menaik taraf, jalankan zinnector dev --reset-runtime supaya pemasangan separuh siap dari sebelumnya dibuang terlebih dahulu.
Amaran "EPERM" daripada npm semasa ia melakukan pembersihan (Windows)
Hampir selalu disebabkan oleh pengimbas antivirus atau pengindeks carian yang membiarkan fail terbuka di bawah node_modules masa jalan semasa npm cuba mengalih keluarnya. Pemasangan dicuba semula daripada direktori bersih pada zinnector dev seterusnya; jika ia terus berlaku, zinnector dev --reset-runtime mengalih keluar keseluruhan direktori masa jalan terlebih dahulu dan memasang semula.
"the local playground runtime could not be installed"
Mesej ini merangkumi baris terakhir npm itu sendiri dan arahan tepat yang dijalankan oleh Zinnector®, supaya anda boleh menjalankannya sendiri dan melihat output penuh. Punca biasa ialah masalah rangkaian atau proksi — masa jalan diambil menggunakan npm anda sendiri, jadi npm config set proxy … dan cermin pendaftaran terpakai — atau pemasangan terdahulu yang separuh siap, yang dikosongkan oleh --reset-runtime.
"the local playground exited before it was ready", atau ia tidak pernah sedia
Jalankan zinnector dev --verbose untuk melihat output masa jalan itu sendiri. Port yang sudah digunakan ialah punca biasa: zinnector dev --port 9401, atau tetapkan port dalam zinnector.json. Masa jalan yang dipasang tetapi enggan but: zinnector dev --reset-runtime. But kali pertama juga memuat turun WordPress itu sendiri, jadi pada sambungan yang perlahan berikannya beberapa minit; CLI menunggu sehingga lima minit sebelum melaporkan tamat masa berbanding tergantung.
"this project is not a git repository" semasa push
Pelaksanaan didorong daripada repositori, jadi zinnector push memerlukan repositori dengan alat kawalan jauh yang boleh dicapai oleh platform. git init && git add -A && git commit -m initial, tambahkan alat kawalan jauh GitHub atau GitLab anda, kemudian jalankan zinnector link untuk menyambungkannya ke tapak.
Tapak menjadi putih selepas pelaksanaan
Jalankan zinnector check. Sembilan daripada sepuluh kali ia merupakan perbezaan versi PHP — anda membina pada PHP yang lebih baharu daripada yang dijalankan oleh slot — dan laporan menyatakan versi yang perlu ditukar untuk slot tersebut dengan zinnector php <version>, atau versi yang perlu digunakan untuk pembangunan dengan zinnector dev --php <version>. zinnector logs --error menunjukkan ralat maut itu sendiri.
Berkaitan