د Zinnector® د ستونزو حل

هغه تېروتنې چې خلک یې په حقیقت کې د Zinnector® CLI سره تجربه کوي، د هرې یوې مانا، او د حل لاره. هر عنوان هغه کره متن ښيي چې تاسو به یې وګورئ، ترڅو وکولای شئ په دې پاڼه کې یې وپلټئ. که ستاسو ستونزه دلته نه وي، ناکامه شوې کمانډ له ZINNECTOR_DEBUG=1 سره چل کړئ او په github.com/Zinn-Digital/zinnector/issues کې د ترلاسه شوې پایلې، د خپل node --version او د خپل عملیاتي سیسټم سره یوه مسله (issue) پرانیزئ.

د رن‌ټایم (runtime) انسټال له منلو سمدستي وروسته "spawn EINVAL" (په Windows کې)

په Zinnector® 0.1.0 او 0.1.1 کې یوه نیمګړتیا ده. په Windows کې د رن‌ټایم انسټالر npm.cmd د نوم له مخې چل کړی و، او Node د CVE-2024-27980 د ترمیم راهیسې له شیل پرته د .cmd فایل چلول رد کړي دي — نو له همدې امله انسټال یوه ثانیه وروسته له هغې چې تاسو 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 بیا د دې پر ځای چې وروسته په یو ناڅرګند ځای کې ناکام شي، د پیل کېدو څخه ډډه کوي (exit code 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 لپاره شتون لري. په نوي Node کې (له سپتمبر 2026 راهیسې 26 او لوړ) د هغې انسټالر بېرته له سرچینې څخه د کمپایل کولو حالت ته ځي، چې په یو عادي Windows کمپیوټر کې د Visual Studio په غوښتنه پای ته رسېږي. په 0.1.2 کې حل شوی: Zinnector® دا د هر څه له ډاونلوډ کولو دمخه پیژني او یوازې د رن‌ټایم لپاره یو Node 24 راوړي — شاوخوا 30 MB، چې د nodejs.org د چک‌سمونو (checksums) سره تایید شوی — نو هېڅ شی هم نه کمپایل کېږي. که تاسو له ارتقا وروسته هم دا وینئ، zinnector dev --reset-runtime چل کړئ ترڅو له مخکې نیمګړی انسټال لومړی له منځه یوړل شي.

له npm څخه د پاکولو پر مهال د "EPERM" خبرداری (په Windows کې)

نږدې تل یو انټي ویروس سکینر یا د لټون شاخص جوړوونکی وي چې د رن‌ټایم د node_modules لاندې یو فایل خلاص ساتي په داسې حال کې چې npm د هغه د لرې کولو هڅه کوي. انسټال په راتلونکي zinnector dev کې له یوه پاک ډایرکټري څخه بیا هڅه کېږي؛ که دا بیا هم دوام ومومي، نو zinnector dev --reset-runtime لومړی د رن‌ټایم بشپړ ډایرکټري لرې کوي او بیا یې انسټالوي.

"the local playground runtime could not be installed"

په دې پیغام کې پخپله د npm وروستۍ کرښې او هغه دقیق کمانډ شامل دی چې Zinnector® چلولی و، نو تاسو کولی شئ دا پخپله چل کړئ او بشپړې پایلې وګورئ. معمول لاملونه یې د شبکې یا پروکسي ستونزه ده — رن‌ټایم ستاسو د خپل npm سره راوړل کېږي، نو npm config set proxy … او یو راجسټرې مرر تطبیقېږي — یا یو مخکینی نیمګړی انسټال، چې --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 د ځنډېدو پر ځای، د مهال‌پای (timeout) راپور ورکولو دمخه تر پنځو دقیقو پورې انتظار کوي.

د push پر مهال "this project is not a git repository"

ډیپلوایونه (deploys) له یو ریپوزیټري څخه پرمخ وړل کېږي، نو zinnector push یوه داسې ریپوزیټري ته اړتیا لري چې یو ریموټ ولري ترڅو پلیټفارم ورته لاسرسی ومومي. 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 error) ښيي.

اړوند

• پیل کول · محلي پراختیا · ډیپلوای کول · د کمانډونو لارښود