Jinsi ya kusakinisha, kuendesha na kujenga toleo la kompyuta la DeepSeek Harness kwenye Linux

Utangulizi wa mradi

DeepSeek Harness Linux ni fork ya chini ya DeepSeek Harness rasmi, yenye lengo la kuwapa watumiaji wa Linux toleo la kompyuta linaloweza kupakuliwa, kusakinishwa na kusasishwa moja kwa moja. Inahifadhi uwezo wa agent, skill, muunganisho wa mtandao, kiolesura cha mbele, mfumo wa programu-jalizi na itifaki za mawasiliano wa toleo la juu, huku ikiongeza tu usaidizi unaohusiana na ufungashaji, majaribio na usambazaji wa Linux.

Tanbihi: Mradi huu si toleo rasmi la DeepSeek, wala haujabadilisha kiini cha agent. Toleo la juu bado liko katika developer preview, hivyo huenda likapata masasisho ya mara kwa mara au mabadiliko yanayovunja uoanifu.

Mradi unaunga mkono x64 na arm64. Ya kwanza inafaa kwa kompyuta za kawaida za AMD na Intel, huku ya pili ikifaa kwa Raspberry Pi 5, seva za ARM, na Linux inayoendeshwa kwenye vifaa vya Apple Silicon.

Vipengele vikuu

• Miundo mitatu ya usambazaji: Inatoa AppImage, .deb na .tar.gz.
• Usaidizi wa usanifu mbili: Huunda matoleo ya x64 na arm64 kwa wakati mmoja.
• Masasisho ya kiotomatiki ya AppImage: Hufanya kazi kupitia electron-updater na kituo cha masasisho cha nightly-linux.yml.
• CI asilia: Hutumia runner za ubuntu-24.04 na ubuntu-24.04-arm kando ili kujenga usanifu husika.
• Kufuata toleo la juu: Kiini cha agent na uwezo mkuu wa kompyuta husawazishwa na mradi rasmi.
• Leseni ya MIT: Msimbo wa toleo la juu na safu mpya ya ufungashaji wa Linux husambazwa chini ya leseni ya MIT.

Chagua kifurushi kinachofaa cha usakinishaji

AppImage: Chaguo la kwanza kwa watumiaji wengi

AppImage ni programu ya faili moja isiyohitaji usakinishaji wa kawaida, na inaunga mkono kituo cha masasisho ya kiotomatiki kinachotolewa na mradi. Inafaa kwa watumiaji wanaotaka kuijaribu haraka au kuepuka kubadilisha hali ya usimamizi wa vifurushi vya mfumo.

DEB: Inafaa kwa Debian na Ubuntu

Faili ya .deb inaweza kusakinishwa kwa zana za usimamizi wa vifurushi vya Debian na kuanzishwa kupitia menyu ya programu au terminali. Inafaa kwa watumiaji wanaotaka kuunganisha programu na mazingira ya kompyuta ya mfumo.

tar.gz: Uendeshaji wa kubebeka

.tar.gz inaweza kuendeshwa baada ya kufunguliwa bila usakinishaji. Inafaa kwa saraka za kubebeka, mazingira ya majaribio au hali ambapo vifurushi vya mfumo haviwezi kusakinishwa.

Thibitisha usanifu kabla ya kusakinisha

Kwanza angalia usanifu wa mfumo wa sasa kwenye terminali:

uname -m

• Ikiwa matokeo ni x86_64, pakua toleo ambalo jina la faili lina linux-x64.
• Ikiwa matokeo ni aarch64 au arm64, pakua toleo ambalo jina la faili lina linux-arm64.

Vifurushi vya usakinishaji vinapatikana kwenye ukurasa wa Releases wa mradi. Pakua miundo ya jumuiya kutoka kwenye Release ya hazina hii pekee.

Njia ya kwanza: Endesha AppImage

AppImage ndiyo njia ya usakinishaji inayopendekezwa kwenye README. Inategemea FUSE 2, kwa hiyo sakinisha runtime inayofaa kulingana na usambazaji wako kwanza.

Watumiaji wa Debian au Ubuntu watekeleze:

sudo apt install libfuse2

Watumiaji wa Fedora au mifumo ya RHEL watekeleze:

sudo dnf install fuse2

Baada ya kupakua AppImage inayolingana na usanifu wako, ongeza ruhusa ya utekelezaji kwenye faili. Mfano hapa unatumia faili ya x64:

chmod +x deepseek-harness-*-linux-x64.AppImage
./deepseek-harness-*-linux-x64.AppImage

Watumiaji wa arm64 wanapaswa kubadilisha linux-x64 kwenye amri kuwa linux-arm64, au kutumia moja kwa moja jina halisi la faili lililopakuliwa.

Njia ya pili: Sakinisha kifurushi cha DEB

Kwenye Debian, Ubuntu na usambazaji wake, unaweza kutumia dpkg kusakinisha kifurushi kilichopakuliwa:

sudo dpkg -i deepseek-harness-*-linux-x64.deb

Baada ya usakinishaji kukamilika, unaweza kuanzisha programu kupitia menyu ya programu ya kompyuta au kwa kuendesha kwenye terminali:

deepseek-harness

Unapotumia mfumo wa arm64, sakinisha kifurushi cha DEB ambacho jina lake lina linux-arm64.

Njia ya tatu: Endesha kifurushi cha kubebeka

Ikiwa hutaki kusakinisha kifurushi cha mfumo, fungua .tar.gz na uendeshe kiingilio cha kuanzisha kilicho kwenye saraka:

tar -xzf deepseek-harness-*-linux-x64.tar.gz
cd deepseek-harness-*-linux-x64
./deepseek-harness

Watumiaji wa arm64 pia wanapaswa kuchagua na kufungua faili ya usanifu unaofaa.

Matumizi ya msingi

Baada ya programu kuanza, unaweza kutumia uwezo wa kompyuta uliorithiwa kutoka kwenye toleo la juu, ukiwemo agent, skill, utendaji wa mtandao na kiolesura cha mbele. Fork hii ya Linux haijabadilisha kiini cha agent, mfumo wa programu-jalizi au itifaki za mawasiliano, kwa hiyo tabia husika itafuata utekelezaji wa DeepSeek Harness rasmi.

Ukitumia AppImage, unaweza kuhifadhi faili hiyo moja uliyopakua na kuiendesha tena moja kwa moja; ukisakinisha kifurushi cha DEB, unaweza kuianzisha kwa amri ya deepseek-harness au kupitia menyu ya programu; toleo la kubebeka linapaswa kuendeshwa kwa ./deepseek-harness kutoka kwenye saraka iliyofunguliwa.

Kuendesha kwenye kompyuta ya mbali au mazingira yasiyo na skrini

Programu hii ni ya kompyuta. Unapotumia VNC kwenye seva ya mbali, hakikisha DISPLAY imewekwa ipasavyo. Kwa mfano, katika mazingira ya xfce4 na TigerVNC, nambari ya skrini inaweza kuwa :1:

export DISPLAY=:1
./deepseek-harness

Programu ya kompyuta itaanza kiotomatiki mazingira ya skrini yanapopatikana. Nambari halisi ya skrini inapaswa kuamuliwa kulingana na usanidi wa sasa wa VNC au kikao cha picha.

Jenga kutoka kwenye msimbo chanzo

Andaa vitegemezi

Ujenzi kutoka kwenye msimbo chanzo unahitaji Node.js 24 au toleo jipya zaidi, pnpm na libfuse2 kwenye mashine ya ujenzi. libfuse2 hutumika kuunda AppImage.

Clone na sakinisha vitegemezi

git clone https://github.com/Zhou-Yujing114514/deepseek-harness-linux.git
cd deepseek-harness-linux
pnpm install

Andaa faili za mazingira ya Linux

Nakili faili ya mfano inayotolewa na mradi na ujaze mipangilio ya uchapishaji inapohitajika:

cp apps/desktop/.env.linux.example apps/desktop/.env.linux

Jenga usanifu unaolengwa

Jenga kifurushi cha usakinishaji cha x64:

pnpm --dir apps/desktop run package:linux:x64

Jenga kifurushi cha usakinishaji cha arm64:

pnpm --dir apps/desktop run package:linux:arm64

Kila usanifu utazalisha miundo mitatu: AppImage, DEB na tar.gz. Workflow ya Desktop (Linux) ya mradi pia itajenga inapohitajika kwenye runner asilia, na matokeo yanaweza kupatikana kwenye GitHub Actions Artifacts au Release inayoundwa kiotomatiki.

Masasisho ya kiotomatiki na uthibitishaji wa usalama

AppImage hutumia electron-updater kupitia kituo cha masasisho cha AppImage. Kielezi cha masasisho ni nightly-linux.yml, na uhamishaji hutumia HTTPS.

Muhimu: Ujenzi wa sasa wa Linux hauna sahihi ya msimbo. Masasisho ya kiotomatiki yanategemea tu uhamishaji wa HTTPS na uthibitishaji wa metadata ya feed, bila uthibitishaji wa sahihi ya msimbo, kwa hiyo haufai kutumiwa moja kwa moja katika mazingira yenye mahitaji makubwa ya uaminifu.

Baada ya kupakua au kusasisha, linganisha SHA256 ya faili na checksum iliyotolewa kwenye ukurasa wa Release. Unaweza kutumia amri ifuatayo kukokotoa muhtasari:

sha256sum deepseek-harness-*-linux-x64.AppImage

Thibitisha kuwa matokeo yanafanana kabisa na thamani iliyochapishwa kwenye Release. Faili za DEB, tar.gz na arm64 pia zinaweza kuthibitishwa kwa njia hiyo hiyo.

Vikwazo vinavyojulikana

1. Ujenzi hauna sahihi: Binaries za Linux hazina sahihi ya msimbo wala uthibitishaji wa kiwango cha mfumo.
2. Ubadilishaji wa hati za Office haupatikani kwa sasa: Ubadilishaji wa DOCX, XLSX na PPTX kuwa PDF unategemea binding asilia ya Linux ya LibreOffice Kit, ambayo bado haijasambazwa pamoja na kifurushi cha usakinishaji katika toleo la sasa.
3. Toleo la juu bado liko katika hatua ya majaribio: Mradi rasmi uko katika developer preview, hivyo mabadiliko ya mara kwa mara au yanayovunja uoanifu yanaweza kutokea.
4. Hakuna toleo la duka la programu: Mradi haupitii mchakato wa kuchapishwa kwenye duka la programu.

Kizuizi cha ubadilishaji wa Office hakiathiri uwezo mwingine wa kompyuta uliotajwa wazi kwenye README, ukiwemo agent, skill, utendaji wa mtandao na kiolesura cha mbele.

Mapendekezo ya hali ya juu

• Linganisha usanifu kwanza: Usipakue kifurushi cha arm64 kwenye mfumo wa x64, wala kinyume chake.
• Chagua AppImage unapohitaji masasisho: README ya DEB na tar.gz haitaji matumizi ya kituo cha masasisho cha AppImage.
• Dumisha mchakato wa uthibitishaji: Iwe ni upakuaji wa kwanza au sasisho, hakikisha SHA256 ya Release.
• Fuatilia mabadiliko ya toleo la juu: Fork hii itaendelea kufanya rebase ya commits za toleo la juu, kwa hiyo soma maelezo ya Release kabla ya kusasisha.
• Watengenezaji wanufaike na CI asilia: Unapohitaji kuthibitisha usanifu wote miwili, tumia workflow iliyopo ya Desktop (Linux) ya mradi badala ya kudhani kuwa matokeo ya ujenzi mtambuka ni sawa na ujenzi asilia.

Kabla ya kuendesha, soma pia SAFETY.md ya toleo la juu. Mradi rasmi wa toleo la juu unapatikana kwenye deepseek-ai/deepseek-harness.

Muhtasari

DeepSeek Harness Linux inaongeza uwezo wa usambazaji wa Linux wa x64 na arm64 kwa programu rasmi ya kompyuta. Watumiaji wa kawaida wanaweza kuchagua AppImage yenye usaidizi wa masasisho ya kiotomatiki, watumiaji wa Debian au Ubuntu wanaweza kusakinisha DEB, na wanaohitaji uendeshaji wa kubebeka wanaweza kuchagua tar.gz. Kwa kuwa ujenzi wa sasa bado hauna sahihi, hakikisha SHA256 wakati wa kupakua, kusasisha na kusambaza, na zingatia mabadiliko ya uoanifu katika hatua ya developer preview.