DeepSeek Harness’ni Node.js talab qilmaydigan Windows yagona faylli o‘rnatuvchiga qadoqlash

Loyiha haqida

DeepSeek Harness Easy-Setup Windows uchun mo‘ljallangan qadoqlash loyihasidir. U @deepseek-ai/dsh buyruq qatori dasturini, portativ Node.js ish muhitini, ishga tushirgich va to‘xtatgichni bitta o‘rnatuvchiga birlashtiradi.

Yakuniy foydalanuvchi Node.js, npm yoki boshqa bog‘liqliklarni oldindan o‘rnatishi shart emas. O‘rnatilgandan so‘ng ish stoli yoki Boshlash menyusidagi yorliq orqali dsh web ishga tushiriladi va xizmat tayyor bo‘lgach brauzer avtomatik ochiladi.

O‘rnatilgandan keyingi funksiyalar

• Ish stolida va Boshlash menyusida alohida “DeepSeek Harness” yorliqlari yaratiladi.
• Ishlayotgan xizmatni to‘xtatish uchun “DeepSeek Harness’ni yopish” yorlig‘i yaratiladi.
• Ishga tushirgich dsh web buyrug‘ini bajaradi va xizmat ishga tushgach brauzerni avtomatik ochadi.
• Boshlash menyusida o‘chirish havolasi bo‘ladi, dastur Windows’ning “Ilovalar” ro‘yxatida ham ko‘rinadi.
• Ilova belgisi sifatida dsh frontendidagi kit favicon’idan foydalaniladi.
• O‘rnatish joriy foydalanuvchi uchun amalga oshiriladi va UAC huquqlarini oshirish talab qilinmaydi.

Standart o‘rnatish katalogi:

%LOCALAPPDATA%\Programs\DeepSeekHarness

Foydalanuvchi o‘rnatish ustasida boshqa katalogni ham tanlashi mumkin.

Loyiha katalogini tushunish

Qurishni boshlashdan oldin quyidagi muhim katalog va fayllarning vazifalarini bilib olish mumkin:

• build\build.ps1: asosiy qurish nuqtasi. dsh’ni olish, portativ Node.js’ni yuklash, belgi yaratish, ishga tushirgich va to‘xtatgichni kompilyatsiya qilish hamda o‘rnatuvchi yaratish uchun javob beradi.
• build\fetch-nsis.ps1: portativ NSIS 3.11’ni yuklaydi va SourceForge oynasi mavjud bo‘lmasa, boshqa oynalarni sinab ko‘radi.
• src\Launcher.cs: ishga tushirgich manba kodi; kompilyatsiyadan so‘ng DeepSeekHarness.exe hosil bo‘ladi.
• src\Stopper.cs: to‘xtatgich manba kodi; kompilyatsiyadan so‘ng DeepSeekHarnessStop.exe hosil bo‘ladi.
• src\installer.nsi: NSIS o‘rnatish skripti.
• src\icon\build-icon.js: dsh tarkibidagi sharp yordamida kit SVG’sini turli o‘lchamdagi ICO fayliga aylantiradi.
• test\test-install.ps1: jim o‘rnatish, fayllarni tekshirish, ishga tushirish, to‘xtatish, HTTP tekshiruvi va o‘chirish testlarini bajaradi.
• work\: Node.js arxivi, NSIS va staging kabi oraliq fayllarni saqlaydi. Uni o‘chirish yoki keyingi qurishlarni tezlashtirish uchun saqlab qolish mumkin.
• out\: yakuniy yagona faylli o‘rnatuvchini saqlaydi.

Qurish muhitini tayyorlash

Qurish kompyuteri quyidagi talablarga javob berishi kerak:

• Windows 10 yoki Windows 11 x64.
• PowerShell 5.1.
• .NET Framework 4.x.
• Node.js o‘rnatilgan bo‘lishi va node.exe PATH orqali topilishi yoki qurish vaqtida yo‘li aniq ko‘rsatilishi kerak.
• nodejs.org va SourceForge saytlariga kirish imkoniyati.

Loyiha tizimdagi C# kompilyatori yordamida ikkita bajariladigan faylni kompilyatsiya qiladi. Standart yo‘l:

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\csc.exe

Agar tizimda NSIS 3.x o‘rnatilmagan bo‘lsa, qurish skripti portativ versiyani avtomatik ravishda work\nsis katalogiga yuklaydi.

Muhim: loyiha yo‘lida bo‘sh joylar bo‘lmasin, chunki makensis buyruq qatori ta’rif parametrlari bo‘sh joyli yo‘llarni to‘g‘ri qayta ishlay olmaydi.

Birinchi qadam: dsh’ni o‘rnatish

Qurish skripti sukut bo‘yicha @deepseek-ai/dsh paketini global npm katalogidan o‘qiydi. Avval qurish kompyuterida quyidagini bajaring:

npm i -g @deepseek-ai/dsh

Standart paket katalogi:

%APPDATA%\npm\node_modules\@deepseek-ai\dsh

Agar dsh boshqa joyda bo‘lsa, keyinroq -DshSource parametri orqali uning yo‘lini ko‘rsatish mumkin.

Ikkinchi qadam: yagona faylli o‘rnatuvchini qurish

Loyiha ildiz katalogiga o‘ting va quyidagini ishga tushiring:

powershell -ExecutionPolicy Bypass -File build\build.ps1

Skript dsh fayllari, portativ Node.js, ilova belgisi, C# ishga tushirgichi, to‘xtatgich va NSIS o‘rnatuvchisini ketma-ket tayyorlaydi. Standart natija taxminan quyidagicha:

out\DeepSeekHarness-Setup-0.1.1.exe

README’da keltirilgan namunaviy o‘rnatuvchi hajmi taxminan 44 MB.

Ko‘p ishlatiladigan qurish parametrlari

• -DshSource <katalog>: dsh paket katalogini ko‘rsatadi.
• -NodeExe <yo‘l>: qurish kompyuteridagi node.exe yo‘lini ko‘rsatadi.
• -AppVersion <versiya>: o‘rnatuvchi versiya raqamini almashtiradi.
• -WorkDir <katalog>: oraliq fayllar katalogini o‘zgartiradi.
• -OutDir <katalog>: o‘rnatuvchi chiqish katalogini o‘zgartiradi.

Masalan, maxsus dsh yo‘li, Node.js yo‘li va versiya raqamidan foydalanish:

powershell -ExecutionPolicy Bypass -File build\build.ps1 -DshSource C:\dev\dsh -NodeExe C:\nodejs\node.exe -AppVersion 0.1.1 -OutDir C:\dsh-output

Sukut bo‘yicha versiya raqami dsh’ning package.json faylidan olinadi. Oldindan chiqariladigan versiya asosiy versiyaga aylantiriladi: masalan, 0.1.1-rc.2 0.1.1 sifatida yaratiladi.

work\ katalogidagi fayllar saqlanadi va qayta ishlatiladi. Node.js arxivi yuklab bo‘lingach qayta yuklanmaydi, ochilgan NSIS katalogidan ham keyingi qurishlarda foydalaniladi.

Uchinchi qadam: o‘rnatish va asosiy foydalanish

Qurish tugagach, out\ katalogidagi o‘rnatuvchini ikki marta bosing va o‘rnatish ustasidagi bosqichlarni bajaring. Joriy foydalanuvchi rejimi ishlatilgani sababli sukut bo‘yicha UAC huquqlarini oshirish so‘rovi chiqmaydi.

1. Ish stoli yoki Boshlash menyusidagi “DeepSeek Harness”ni ikki marta bosing.
2. Ishga tushirgich dsh web buyrug‘ini bajaradi.
3. Xizmat mavjud bo‘lgach, standart brauzer tegishli sahifani avtomatik ochadi.
4. Xizmatni to‘xtatish kerak bo‘lsa, “DeepSeek Harness’ni yopish”ni ishga tushiring.
5. Dastur olib tashlanishi kerak bo‘lsa, Boshlash menyusidagi o‘chirish havolasidan yoki Windows’ning “Ilovalar” ro‘yxatidan foydalaning.

Standart katalogga jim rejimda ham o‘rnatish mumkin:

out\DeepSeekHarness-Setup-0.1.1.exe /S

To‘rtinchi qadam: avtomatlashtirilgan testlarni ishga tushirish

Loyiha to‘liq o‘rnatish jarayonini qamrab oluvchi test skriptini taqdim etadi:

powershell -ExecutionPolicy Bypass -File test\test-install.ps1

Test skripti quyidagi amallarni bajaradi:

1. Loyiha ichidagi testinstall\ katalogiga jim o‘rnatadi.
2. O‘rnatilgan fayllar va yorliqlarni birma-bir tekshiradi.
3. Ishga tushirgich va to‘xtatgich xatti-harakatini taqlid qilingan kirish nuqtasi orqali tekshiradi.
4. O‘rnatish katalogidagi portativ Node.js yordamida dsh webni haqiqatan bir marta ishga tushiradi.
5. Standart test porti 3999 orqali HTTP 200 javobini tekshiradi va keng tarqalgan 3080 portini band qilmaydi.
6. O‘chirishni bajaradi va natijani tekshiradi.

Chiqishda ### bilan boshlanuvchi bir nechta tekshiruv ma’lumotlari ko‘rinadi. Oxirgi qator quyidagicha bo‘lishi kerak:

ALL CHECKS PASSED

Test muvaffaqiyatsiz bo‘lsa, oxirida muvaffaqiyatsiz bandlar soni ko‘rsatiladi.

Eslatma: test yaratadigan yorliqlar rasmiy o‘rnatishdagi yorliqlar bilan aynan bir xil nomlanadi. Shu sababli test vaqtida joriy foydalanuvchining ish stoli va Boshlash menyusidagi yorliqlar vaqtincha testinstall\ katalogiga yo‘naltiriladi va o‘chirish bosqichida olib tashlanadi. Test tugagach, rasmiy o‘rnatishni tiklash uchun jim o‘rnatish buyrug‘ini qayta bajarish mumkin.

Ishlash jurnali va muammolarni bartaraf etish

Ishlash paytidagi muhim holat fayllari quyidagi joyda saqlanadi:

%LOCALAPPDATA%\DeepSeekHarness\pid.txt
%LOCALAPPDATA%\DeepSeekHarness\run.log

• pid.txt ishlayotgan dsh jarayoni raqamini saqlaydi; to‘xtatgich undan kerakli jarayonni topish uchun foydalanadi.
• run.log dsh’ning standart chiqishi va standart xatolarini saqlaydi.

Ishga tushirish muvaffaqiyatsiz bo‘lsa, ishga tushirgich oynada run.log joylashuvini ko‘rsatadi. Muammoni tekshirishda avvalo ushbu jurnalni ko‘rib, port bandligi, bog‘liqliklarni yuklash yoki xizmatni ishga tushirishdagi xatolarni aniqlash kerak.

Ilg‘or usullar va amalga oshirishga oid eslatmalar

Node.js versiyasi native modullarga mos kelishini ta’minlash

dsh bog‘liqliklari tarkibida node-pty, sharp va koffi kabi native modullar mavjud. Portativ Node.js ushbu modullarga mos bo‘lishi kerak. Shu sababli qurish skripti sukut bo‘yicha qurish kompyuteridagi Node.js bilan bir xil versiyani tanlaydi. -NodeExe almashtirilganda, o‘rnatuvchi to‘g‘ri ishga tushishini qayta tekshirish kerak.

Xizmatni takroran ishga tushirishning oldini olish

Standart 3080 portida dsh allaqachon ishlayotgan bo‘lsa, ishga tushirgichni yana ikki marta bosish ikkinchi nusxani yaratmaydi. Ishga tushirgich PID faylidagi jarayon hali ham ishlayotganini tekshiradi va mavjud xizmat sahifasini bevosita ochadi.

Ishga tushirgichning juda erta yopilishiga yo‘l qo‘ymaslik

Ishga tushirgich dsh’ni ishga tushirgach, fon rejimida xost jarayon sifatida ishlashda davom etadi va dsh yopilguncha standart chiqish hamda standart xatolarni run.log fayliga yozadi. Ishga tushirgich darhol yopilsa, chiqish quvuri uziladi va dsh keyinchalik jurnal yozganda EPIPE xatosi yuz berishi mumkin.

NSIS o‘chirish jarayoni tugashini to‘g‘ri kutish

NSIS o‘chirgichi avval o‘zini %TEMP% katalogiga nusxalaydi, so‘ng vaqtinchalik katalogdan ishlashda davom etadi va asl o‘chirish jarayoni tezda tugaydi. Shuning uchun avtomatlashtirilgan skript faqat asl jarayon tugashini kutmasligi, balki o‘rnatish katalogi yo‘qolganini davriy tekshirishi kerak. Loyiha test-install.ps1 skriptida bunday amalga oshirishni taqdim etadi.

O‘rnatish skripti kodlashiga e’tibor berish

installer.nsi UTF-8 BOM yoki UTF-16LE kodlashidan foydalanishi kerak, aks holda NSIS Bad text encoding xatosini chiqaradi. Repozitoriydagi manba fayllar BOM’siz UTF-8 formatida saqlangan, build.ps1 esa makensisni chaqirishdan oldin ularni UTF-16LE formatiga aylantiradi.

O‘rnatuvchi hajmini nazorat qilish

Qadoqlash jarayoni Windows x64 muhitida yuklanmaydigan fayllarni, jumladan node-ptyning Darwin, Linux, ARM64 oldindan kompilyatsiya qilingan fayllari va sharp’ning WASM versiyasini olib tashlaydi. README’da bu ishlov taxminan 30 MB joy tejashi aytilgan.

Litsenziya haqida

dsh dasturi MIT litsenziyasi asosida tarqatiladi; batafsil ma’lumotni dsh paketidagi LICENSE faylidan ko‘rish mumkin. Ushbu loyihaning o‘rnatuvchi skriptlari ham MIT litsenziyasi asosida chiqarilgan. Kit belgisi dsh frontend resurslaridan olingan, mualliflik huquqi DeepSeek’ka tegishli.

Xulosa

DeepSeek Harness Easy-Setup dsh, portativ Node.js, Windows uchun ishga tushirish va to‘xtatish dasturlari hamda NSIS o‘rnatish jarayonini birlashtiradi. Muhit tayyorlangach, dsh’ni global o‘rnatish va build\build.ps1ni ishga tushirish orqali maqsad kompyuterida Node.js oldindan o‘rnatilishini talab qilmaydigan yagona faylli o‘rnatuvchi yaratiladi. Chiqarishdan oldin to‘liq test skriptini bajarish va jurnallar, Node.js versiyasi mosligi hamda yorliqlar tiklanganini alohida tekshirish tavsiya etiladi.