Kufunga DeepSeek Harness kuwa Kifungaji cha Faili Moja cha Windows Kisichohitaji Node.js

Utangulizi wa mradi

DeepSeek Harness Easy-Setup ni mradi wa kufunga programu kwa Windows. Unaunganisha programu ya mstari wa amri ya @deepseek-ai/dsh, mazingira ya uendeshaji ya Node.js yanayobebeka, kizindua na kifunga huduma kuwa kifungaji kimoja.

Mtumiaji wa mwisho hahitaji kusakinisha Node.js, npm au vitegemezi vingine mapema. Baada ya usakinishaji, anaweza kuanzisha dsh web kupitia njia ya mkato iliyo kwenye eneo-kazi au menyu ya Mwanzo, na kivinjari hufunguka kiotomatiki huduma inapokuwa tayari.

Vipengele baada ya usakinishaji

• Njia za mkato za “DeepSeek Harness” huundwa kwenye eneo-kazi na menyu ya Mwanzo.
• Njia ya mkato ya “Funga DeepSeek Harness” huundwa ili kusitisha huduma inayoendelea.
• Kizindua huendesha dsh web na kufungua kivinjari kiotomatiki huduma inapoanza.
• Menyu ya Mwanzo hutoa chaguo la kuondoa programu, na programu huonekana pia kwenye orodha ya “Programu” ya Windows.
• Ikoni ya programu hutumia favicon ya nyangumi iliyojumuishwa kwenye sehemu ya mbele ya dsh.
• Usakinishaji hufanywa kwa mtumiaji wa sasa na hauanzishi uinuzaji wa ruhusa wa UAC.

Saraka chaguomsingi ya usakinishaji ni:

%LOCALAPPDATA%\Programs\DeepSeekHarness

Mtumiaji anaweza pia kuchagua saraka nyingine katika mchawi wa usakinishaji.

Kuelewa saraka za mradi

Kabla ya kuanza ujenzi, unaweza kuelewa matumizi ya saraka kadhaa muhimu:

• build\build.ps1: Sehemu kuu ya kuanzisha ujenzi; hupata dsh, hupakua Node.js inayobebeka, hutengeneza ikoni, hukompaili kizindua na kifunga huduma, kisha huunda kifurushi cha usakinishaji.
• build\fetch-nsis.ps1: Hupakua NSIS 3.11 inayobebeka na kujaribu vioo vingine ikiwa kioo cha SourceForge hakipatikani.
• src\Launcher.cs: Msimbo wa kizindua; baada ya kukompailiwa hutengeneza DeepSeekHarness.exe.
• src\Stopper.cs: Msimbo wa kifunga huduma; baada ya kukompailiwa hutengeneza DeepSeekHarnessStop.exe.
• src\installer.nsi: Hati ya usakinishaji ya NSIS.
• src\icon\build-icon.js: Hutumia sharp iliyojumuishwa kwenye dsh kubadilisha SVG ya nyangumi kuwa ICO yenye vipimo vingi.
• test\test-install.ps1: Huendesha majaribio ya usakinishaji kimya, ukaguzi wa faili, uanzishaji, usitishaji, ukaguzi wa HTTP na uondoaji.
• work\: Huhifadhi faili za kati kama kifurushi cha Node.js, NSIS na staging; zinaweza kufutwa au kubakizwa ili kuharakisha ujenzi unaofuata.
• out\: Huhifadhi kifungaji cha mwisho cha faili moja.

Kuandaa mazingira ya ujenzi

Kompyuta ya ujenzi inahitaji kutimiza masharti yafuatayo:

• Windows 10 au Windows 11 x64.
• PowerShell 5.1.
• .NET Framework 4.x.
• Node.js imesakinishwa, na node.exe ipatikane kupitia PATH, au njia yake itajwe wazi wakati wa ujenzi.
• Uwezo wa kufikia nodejs.org na SourceForge.

Mradi hutumia kompaila ya C# iliyojumuishwa kwenye mfumo kukompaili faili mbili zinazoweza kutekelezwa. Njia chaguomsingi ni:

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

Ikiwa NSIS 3.x haijasakinishwa kwenye mfumo, hati ya ujenzi itapakua kiotomatiki toleo linalobebeka kwenye work\nsis.

Muhimu: Njia ya mradi haipaswi kuwa na nafasi, kwa sababu vigezo vya ufafanuzi wa mstari wa amri wa makensis haviwezi kushughulikia kwa usahihi njia zenye nafasi.

Hatua ya kwanza: Kusakinisha dsh

Hati ya ujenzi husoma @deepseek-ai/dsh kutoka kwenye saraka ya kimataifa ya npm kwa chaguomsingi. Kwanza, tekeleza kwenye kompyuta ya ujenzi:

npm i -g @deepseek-ai/dsh

Saraka chaguomsingi ya kifurushi ni:

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

Ikiwa dsh iko mahali pengine, unaweza kutaja njia hiyo baadaye kwa kigezo cha -DshSource.

Hatua ya pili: Kujenga kifungaji cha faili moja

Nenda kwenye saraka kuu ya mradi na utekeleze:

powershell -ExecutionPolicy Bypass -File build\build.ps1

Hati itaandaa kwa mfuatano faili za dsh, Node.js inayobebeka, ikoni ya programu, kizindua cha C#, kifunga huduma na kifurushi cha NSIS. Bidhaa chaguomsingi huwa kama:

out\DeepSeekHarness-Setup-0.1.1.exe

README inaonyesha kuwa ukubwa wa mfano wa kifungaji ni takriban 44 MB.

Vigezo vya kawaida vya ujenzi

• -DshSource <saraka>: Hutaja saraka ya kifurushi cha dsh.
• -NodeExe <njia>: Hutaja node.exe kwenye kompyuta ya ujenzi.
• -AppVersion <toleo>: Hubadilisha nambari ya toleo la kifungaji.
• -WorkDir <saraka>: Hubadilisha saraka ya faili za kati.
• -OutDir <saraka>: Hubadilisha saraka ya kutoa kifungaji.

Kwa mfano, ukitumia njia maalum za dsh na Node.js pamoja na nambari ya toleo:

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

Kwa chaguomsingi, nambari ya toleo huchukuliwa kutoka package.json ya dsh. Toleo la awali hubadilishwa kuwa toleo la msingi; kwa mfano, 0.1.1-rc.2 huzalisha 0.1.1.

Faili zilizo kwenye work\ hubakizwa na kutumiwa tena. Kifurushi cha Node.js hakitapakuliwa tena baada ya kupakuliwa, na saraka iliyofunguliwa ya NSIS itaendelea kutumiwa.

Hatua ya tatu: Kusakinisha na matumizi ya msingi

Baada ya ujenzi kukamilika, bofya mara mbili kifungaji kilicho kwenye saraka ya out\ na ukamilishe usakinishaji kupitia mchawi. Kwa kuwa usakinishaji hufanywa kwa mtumiaji wa sasa, kwa chaguomsingi hakutakuwa na ombi la uinuzaji wa ruhusa wa UAC.

1. Bofya mara mbili “DeepSeek Harness” kwenye eneo-kazi au menyu ya Mwanzo.
2. Kizindua huendesha dsh web.
3. Huduma inapopatikana, kivinjari chaguomsingi hufungua ukurasa husika kiotomatiki.
4. Unapohitaji kusitisha huduma, endesha “Funga DeepSeek Harness”.
5. Unapohitaji kuondoa programu, tumia njia ya kuondoa kwenye menyu ya Mwanzo au orodha ya “Programu” ya Windows.

Unaweza pia kusakinisha katika hali kimya kwenye saraka chaguomsingi:

out\DeepSeekHarness-Setup-0.1.1.exe /S

Hatua ya nne: Kuendesha majaribio ya kiotomatiki

Mradi hutoa hati ya majaribio inayoshughulikia mchakato mzima wa usakinishaji:

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

Hati ya majaribio itafanya shughuli zifuatazo:

1. Husakinisha kimya kwenye testinstall\ iliyo chini ya mradi.
2. Hukagua faili za usakinishaji na njia za mkato moja baada ya nyingine.
3. Huthibitisha tabia ya kizindua na kifunga huduma kwa kutumia sehemu ya kuanzia ya kuiga.
4. Huanzisha kwa kweli dsh web mara moja kwa kutumia Node.js inayobebeka iliyo kwenye saraka ya usakinishaji.
5. Hukagua jibu la HTTP 200 kupitia lango chaguomsingi la majaribio 3999, ili kuepuka kutumia lango la kawaida la 3080.
6. Huondoa programu na kukagua matokeo.

Matokeo yatakuwa na mistari kadhaa ya ukaguzi inayoanza na ###. Mstari wa mwisho unapaswa kuwa:

ALL CHECKS PASSED

Ikiwa jaribio litashindwa, idadi ya vipengee vilivyoshindwa itaonyeshwa mwishoni.

Angalizo: Majina ya njia za mkato yanayoundwa na majaribio yanafanana kabisa na yale ya usakinishaji halisi. Kwa hiyo, wakati wa majaribio, njia za mkato kwenye eneo-kazi na menyu ya Mwanzo ya mtumiaji wa sasa zitaelekeza kwa muda kwenye testinstall\ na zitafutwa wakati wa kuondoa programu. Baada ya majaribio, ikiwa unahitaji kurejesha usakinishaji halisi, tekeleza tena amri ya usakinishaji kimya.

Kumbukumbu za uendeshaji na utatuzi wa matatizo

Faili muhimu za hali wakati wa uendeshaji huhifadhiwa kwenye:

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

• pid.txt huhifadhi nambari ya mchakato wa dsh unaoendelea; kifunga huduma huitumia kutambua mchakato lengwa.
• run.log huhifadhi matokeo ya kawaida na makosa ya kawaida ya dsh.

Uanzishaji ukishindwa, kizindua kitaonyesha katika dirisha ibukizi mahali run.log ilipo. Wakati wa utatuzi, kwanza kagua kumbukumbu hiyo ili kuthibitisha matumizi ya lango, upakiaji wa vitegemezi au makosa ya kuanzisha huduma.

Mbinu za kina na mambo ya kuzingatia katika utekelezaji

Kuhakikisha toleo la Node.js linaendana na moduli asilia

Vitegemezi vya dsh vina moduli asilia kama node-pty, sharp na koffi. Node.js inayobebeka lazima iendane na moduli hizi, kwa hiyo hati ya ujenzi huchagua kwa chaguomsingi toleo la Node.js linalofanana na la kompyuta ya ujenzi. Unapobadilisha -NodeExe, hakikisha tena kuwa kifungaji kinaweza kuanza ipasavyo.

Kuepuka kuanzisha huduma mara mbili

Wakati dsh tayari inaendeshwa kwenye lango chaguomsingi la 3080, kubofya kizindua mara nyingine hakutaunda mfano wa pili. Kizindua hukagua ikiwa mchakato ulio kwenye faili ya pid bado unaendelea na hufungua moja kwa moja ukurasa wa huduma iliyopo.

Kuzuia kizindua kutoka mapema

Baada ya kuanzisha dsh, kizindua huendelea kuwa mchakato mwenyeji wa nyuma, ikiandika matokeo ya kawaida na makosa ya kawaida kwenye run.log hadi dsh itoke. Kizindua kikimaliza mara moja, bomba la matokeo litakatika na dsh inaweza kupata EPIPE inapojaribu kuandika kumbukumbu baadaye.

Kusubiri kwa usahihi uondoaji wa NSIS

Kiondoaji cha NSIS kwanza hujinakili kwenye %TEMP%, kisha huendelea kutekelezwa kutoka kwenye saraka ya muda; mchakato wa awali wa uondoaji hutoka haraka. Kwa hiyo, hati ya kiotomatiki haiwezi kusubiri tu mchakato wa awali umalizike, bali inapaswa kukagua mara kwa mara ikiwa saraka ya usakinishaji imetoweka. test-install.ps1 ya mradi hutoa utekelezaji unaofaa.

Kuzingatia usimbaji wa hati ya usakinishaji

installer.nsi lazima itumie UTF-8 BOM au UTF-16LE, vinginevyo NSIS itaripoti Bad text encoding. Faili chanzo kwenye hazina ni UTF-8 bila BOM; build.ps1 huzibadilisha kuwa UTF-16LE kabla ya kuita makensis.

Kudhibiti ukubwa wa kifungaji

Mchakato wa kufunga huondoa faili ambazo hazitapakiwa kwenye mazingira ya Windows x64, zikiwemo faili za awali za Darwin, Linux na ARM64 za node-pty, pamoja na toleo la WASM la sharp. README inaeleza kuwa hatua hii inaweza kuokoa takriban 30 MB.

Maelezo ya leseni

dsh yenyewe inatumia leseni ya MIT; maelezo kamili yanaweza kuonekana kwenye LICENSE iliyo kwenye kifurushi cha dsh. Hati za kifungaji za mradi huu pia zinatolewa chini ya leseni ya MIT. Ikoni ya nyangumi imetoka kwenye rasilimali za mbele za dsh, na hakimiliki ni ya DeepSeek.

Muhtasari

DeepSeek Harness Easy-Setup huunganisha dsh, Node.js inayobebeka, programu za Windows za kuanzisha na kusitisha huduma, pamoja na mchakato wa usakinishaji wa NSIS. Baada ya kuandaa mazingira, sakinisha dsh kimataifa na utekeleze build\build.ps1 ili kuzalisha kifungaji cha faili moja ambacho hakihitaji Node.js kusakinishwa mapema kwenye kompyuta lengwa. Kabla ya kuchapisha, inashauriwa kuendesha hati kamili ya majaribio na kuangalia hasa kumbukumbu, ulinganifu wa toleo la Node.js na urejeshwaji wa njia za mkato.