Isifundo Sokuqala se-DSH-Android: Lawula Ifoni ye-Android Ngolimi Lwemvelo Futhi Dala Imisebenzi Ezenzakalelayo

Yini i-DSH-Android

I-DSH-Android iphrojekthi yomphakathi eyenza i-DeepSeek Harness isebenze ngqo kumadivayisi e-Android. Ngemva kokufaka i-APK, ungachaza umsebenzi ngolimi lwemvelo, bese uvumela i-agent ihlele amafayela, isebenzise izinhlelo zokusebenza, iguqule izilungiselelo zesistimu, noma idale imisebenzi ezenzakalelayo eqaliswa isikhathi noma imicimbi yedivayisi.

Iphrojekthi ayidingi i-Root futhi ayincikile ku-Termux. Ifaka i-Node 24 nenjini ye-dsh engaforkiwe ngaphakathi kohlelo lokusebenza, bese isebenzisa amakhono edivayisi abhalwe nge-Kotlin ukuxhumana nesistimu ye-Android. Inguqulo yamanje idinga i-Android 10 noma ngaphezulu kanye namadivayisi ane-arm64-v8a.

I-DSH-Android iphrojekthi yomphakathi, ayihlobene ngokusemthethweni ne-DeepSeek futhi ayigunyazwanga yiyo.

Imisebenzi eyinhloko

Ukucubungula amafayela namadokhumenti

Ungacela i-DSH-Android ithole, ihlele, ihambise futhi iqambe kabusha amafayela, futhi ingenza nokucindezela nokukhulula amafayela. Ingakwazi nokufunda umbhalo kumafayela e-PDF, Word, Excel ne-PPT.

• Thola amafayela asebenzisa isikhala esikhulu.
• Hlela ifolda yokulanda ngokohlobo noma ngedethi.
• Hambisa noma uqambe kabusha amafayela amaningi ngesikhathi esisodwa.
• Funda umbhalo kumadokhumenti ajwayelekile asehhovisi.

Ukusebenzisa isikrini nezinhlelo zokusebenza

Ngemva kokunika amandla isevisi yokufinyeleleka, i-DSH-Android ingafunda isikrini, ichofoze, iswayiphe futhi ifake umbhalo, futhi ingavula izinhlelo zokusebenza noma iye ekhasini elithile. Lokhu kulungele imisebenzi yezinyathelo eziningi edinga ukusebenzisa isixhumi esibonakalayo esinemifanekiso.

Izilungiselelo zesistimu nezaziso

Iphrojekthi isekela ukulawula ukukhanya, ivolumu, imodi yokungaphazamisi, ama-alamu, i-Wi-Fi, i-Bluetooth nendawo, futhi ingafunda futhi iphendule izaziso, iphinde ilawule ukudlalwa kwemidiya. Amanye amakhono esistimu angasetshenziswa ngokuqondile, kanti amanye adinga izimvume ezengeziwe noma usizo lwe-Shizuku ongayikhetha.

Ukuqalisa okuzenzakalelayo

Ngaphezu kokusebenzisa imiyalo ngokushesha, ungakha imisebenzi ehleliwe noma uqale imisebenzi lapho uxhuma ku-Wi-Fi, uxhuma ku-Bluetooth, uqala ukushaja, ufika endaweni ethile, uthola isaziso, noma kwenzeka ezinye izimo.

Amakhono aphelele e-dsh

Uhlelo lokusebenza lusebenzisa i-dsh yoqobo, hhayi ifork egcinwa ngokwehlukana, ngakho ungaqhubeka nokusebenzisa amakhono, i-MCP, ama-sub-agent nokusesha kuwebhu. Umkhondo womsebenzi ubonisa ngezigaba izenzo ezenziwe yi-agent, okwenza kube lula ukuhlola inqubo.

Okulungiselelwa ngaphambi kokufaka

Ngaphambi kokuqala, qinisekisa ukuthi idivayisi ihlangabezana nale mibandela:

• I-Android 10 noma inguqulo ephakeme.
• I-ABI yephrosesa yi-arm64-v8a.
• Iphakheji yokufaka icishe ibe ngu-110 MB; kunconywa ukuthi kube okungenani no-500 MB wesikhala esitholakalayo.
• Idivayisi ingafinyelela ku-API yemodeli elungiselelwe.
• Une-akhawunti ye-DeepSeek, i-DeepSeek API key, noma imininingwane yesevisi yemodeli yomuntu wesithathu esekelwayo.

Ukufaka nokusetha kokuqala

1. Landa i-APK yakamuva ekhasini le-Releases lephrojekthi, bese uyifaka kudivayisi ye-Android.

2. Vula uhlelo lokusebenza, ungene nge-akhawunti ye-DeepSeek, noma ufake i-API key oyithole epulatifomu ye-DeepSeek.

3. Uma ufuna ukusebenzisa enye imodeli, iya kokuthi Izilungiselelo → Izinsiza zemodeli, engeza umhlinzeki ofanele bese ufaka i-API key, bese ulanda uhlu lwamamodeli.

4. Buyela ekhasini lasekhaya, ufake umsebenzi olula. Lapho usebenzisa ikhono elithile ledivayisi okokuqala, uhlelo lokusebenza luzokuqondisa ekunikezeni imvume ehambisanayo.

Izimvume zicelwa lapho zidingeka khona, ngakho akudingeki uvule zonke izimvume ekuqaleni. Ungazibuka futhi uzilawule ndawonye kokuthi Izilungiselelo → Izimvume zefoni.

Ukusebenzisa umsebenzi okokuqala

Isibonelo sokuqala: Ukuthola amafayela amakhulu

Ekhasini lasekhaya faka:

Faka ohlwini amafayela angu-5 amakhulu kunawo wonke kufolda yokulanda

I-agent izosebenzisa ikhono lamafayela ngokusekelwe emsebenzini bese ibuyisa imiphumela. Uma kudingeka ukuqhubeka nokucubungula, ungaqhubeka nokufaka okulandelayo engxoxweni efanayo:

Hambisa amafayela angaphezu kuka-500 MB phakathi kwawo uwafake kufolda ebizwa ngokuthi “Amafayela amakhulu”, kodwa ungasusi lutho

Uma kuhileleka ukuhambisa, ukuguqula noma ezinye izenzo ezibucayi, hlola ngokucophelela izinyathelo zomsebenzi nezaziso zokugunyaza eziboniswa uhlelo lokusebenza.

Isibonelo sesibili: Ukulungisa isimo sefoni

Ungachaza umgomo ngokuqondile, ngokwesibonelo:

Yehlisa ivolumu yemidiya bese uvula imodi yokungaphazamisi

Ukuthi isenzo esithile singaqedwa ngokuqondile kuncike enguqulweni ye-Android, ku-ROM yedivayisi nasezimvumeni osuvele uzinikezile. Uma kudingeka imvume, uhlelo lokusebenza luzokunikeza iziqondiso zokuyivula.

Isibonelo sesithathu: Ukusebenzisa uhlelo lokusebenza

Ngemva kokunika amandla isevisi yokufinyeleleka, ungazama:

Vula izilungiselelo zesistimu, uye ekhasini le-Bluetooth

Ukusebenza kwesikrini kuncike esimweni samanje sesixhumi esibonakalayo. Ngemva kokuqedwa komsebenzi, ungavula ikhasi lomkhondo ukuze ubuyekeze izenzo nemiphumela ye-agent ngesigaba ngasinye.

Ukusetha izindlela zokuyivusa ngokushesha

I-DSH-Android ingavuswa ngebhola elintantayo, umsizi wesistimu, ithayela elisheshayo kanye nendawo yokwabelana yesistimu. Ngemva kokunika amandla izindlela ezifanele ngokwemikhuba yakho yokusebenzisa, ungathumela imisebenzi ngaphandle kokubuyela ekhasini lasekhaya lohlelo lokusebenza njalo.

Kwamanye ama-ROM aseShayina, ibhola elintantayo nokuzisebenzela kwangemuva kudinga futhi ukuthi uvumele mathupha ukuvela kwesixhumi esibonakalayo ngemuva kanye ukuziqalisa ngokuzenzakalelayo. Ungahlola ikhasi lokuhlolwa kohlelo lokusebenza bese ulungisa izilungiselelo zesistimu ngokwemiyalelo.

Ukulungisa i-Shizuku ukuze uvule amanye amakhono esistimu

I-Shizuku ayidingeki ekusetshenzisweni okuyisisekelo, kodwa inganikeza izimvume ze-shell futhi ngaleyo ndlela ivule ezinye izilawuli zesistimu. Iphrojekthi ifaka iphakheji yokufaka esemthethweni; yisethise ngalezi zinyathelo:

1. Iya kokuthi Izilungiselelo → Izimvume zefoni.

2. Sebenzisa umsebenzi wokufaka ngokuchofoza kanye ukufaka i-Shizuku.

3. Landela iziqondiso ze-Shizuku ukuze uqedele ukuqalisa nokugunyaza.

4. Uma idivayisi ine-Android 11 noma ephakeme futhi inguqulo ye-Shizuku ingekho ngaphansi kuka-13.6, kunconywa ukuthi uvule Ukuqalisa lapho kuvulwa ifoni (ukulungisa nge-wireless).

Ngemva kokuqalisa kabusha idivayisi, i-Shizuku ngokuvamile idinga ukuqalwa kabusha. Ukuvula ukuqalisa lapho kuvulwa ifoni usebenzisa ukulungisa nge-wireless kunganciphisa ukuphindaphinda kwezenzo, kodwa ukuziphatha kwangempela kusancike enguqulweni yesistimu nemikhawulo yomkhiqizi.

Ukudala imisebenzi ezenzakalelayo

Imisebenzi ezenzakalelayo ingasetshenziswa ngesikhathi esimisiwe noma iqalwe umcimbi wedivayisi. Imicimbi esekelwayo ihlanganisa ukuxhuma ku-Wi-Fi, ukuxhuma ku-Bluetooth, ukuqala ukushaja, ukufika endaweni ethile nokuthola isaziso.

Lapho udala umsebenzi, kunconywa ukuthi uchaze ngokucacile isimo sokuqalisa, isenzo okufanele senziwe kanye nemikhawulo edingekayo. Ngokwesibonelo:

Nsuku zonke ngo-11 ebusuku vula imodi yokungaphazamisi, bese wehlisa ivolumu yemidiya

Yenza umsebenzi othile ngemva kokuxhuma ku-Wi-Fi yasekhaya

Isibonelo sesibili sisadinga ukuthi ulungise isimo sangempela senethiwekhi nezenzo ezithile ngaphakathi kohlelo lokusebenza. Imithetho ehilela indawo, izaziso noma ukusebenza ngemuva idinga izimvume ezihambisanayo. Ngokuzenzakalela okungase kuguqule noma kuhambise idatha, kunconywa ukuthi uqale ukuvivinya ngezenzo ezingalimazi lutho.

Ukusebenzisa izinsiza zamamodeli zabanye abahlinzeki

Ngaphandle kwe-DeepSeek, iphrojekthi ivumela nokwengezwa kwe-OpenAI, Claude, Gemini, Grok, OpenRouter, Kimi, Zhipu GLM, Tongyi Qianwen, Volcengine Ark, MiniMax, SiliconFlow, StepFun, noma noma iyiphi i-interface ehambisanayo.

1. Vula Izilungiselelo → Izinsiza zemodeli.

2. Khetha umhlinzeki noma lungisa i-interface ehambisanayo.

3. Faka i-API key bese ulanda uhlu lwamamodeli.

4. Khetha imodeli ofuna ukuyisebenzisa kumkhethi wamamodeli.

Okwamanje amamodeli ezinkampani zangaphandle asekela kuphela i-OpenAI-compatible Chat Completions API efinyelelwa nge-HTTPS. Umongo ubalwa ngokufanayo njenge-128K, futhi akukho ukukhetha kwezinga lokucabanga. Ukusebenza kokubiza amathuluzi kuncike kumodeli ekhethiwe. Uma ufuna ukusebenzisa ukusesha okuxhumeke ku-inthanethi okunikezwa yi-DeepSeek, kufanele ulungise i-DeepSeek API key ngokwehlukana, ngisho noma imodeli eyinhloko ivela kwenye insizakalo.

Iziphakamiso zokusetshenziswa okuthuthukile

Sebenzisa umkhondo ukuhlola imisebenzi eyinkimbinkimbi

Emisebenzini yezinyathelo eziningi, ungabheki impendulo yokugcina kuphela. Ngemva kokuqedwa komsebenzi, vula umkhondo uhlole ukuthi i-agent isebenzise maphi amakhono nokuthi yenze ziphi izenzo esigabeni ngasinye. Lokhu kwenza kube lula ukuthola izimvume ezinganele, izinguquko zesixhumi esibonakalayo noma ukwahlulela okuphambukile kwemodeli.

Bhala imisebenzi ngokucacile

Imiyalo yolimi lwemvelo kufanele ibe nomgomo, ububanzi kanye nemingcele yokuphepha. Ngokwesibonelo, uma kuqhathaniswa nokuthi “hlela ifolda yokulanda”, le ndlela elandelayo ilawuleka kangcono:

Hambisa ama-PDF akufolda yokulanda uwafake ku-Documents/PDF, ungawabhali phezu kwawo uma kunamafayela anamagama afanayo, amanye amafayela awaguquki

Uma umsebenzi ubandakanya ukususa, ukubhala phezu kwedatha, ukuthumela imilayezo noma ukuphendula izaziso, kunconywa ukuthi ucele ngokucacile ukuthi kuqale kufakwe ohlwini izinto ezingase zikhethwe noma kulindwe ukuqinisekiswa.

Hlukanisa izenzo zesixhumi esibonakalayo namakhono esistimu

Ngemva kokukhiya isikrini, imisebenzi esebenzisa ama-API esistimu, njengamafayela, izilungiselelo zesistimu nezaziso, isengaqhutshwa; kodwa uma kusetshenziswa ukukhiya isikrini okuphephile, i-Android ayivumeli uhlelo lokusebenza ukuthi lusebenzise isixhumi esibonakalayo sezinye izinhlelo zokusebenza. Imisebenzi enjalo izoma futhi ikwazise ukuthi uvule isikrini ukuze uqhubeke.

Vumela isikhathi sokuqalisa okubandayo

Injini yamanje idinga cishe imizuzwana engu-5 ukuze iqale okubandayo. Lapho uvula uhlelo lokusebenza okokuqala noma injini ingakasebenzi, ukuphendula komsebenzi kungase kube kancane.

Phatha izingxoxo nezimvume

Ukubeka imisebenzi enezinjongo ezahlukene ezingxoxweni ezahlukene kusiza ukugcina umongo ucacile. Hlola njalo izimvume zefoni, isevisi yokufinyeleleka, imvume yokufinyelela izaziso kanye nezilungiselelo zokusebenza ngemuva; amakhono ongasawasebenzisi ungawacisha.

Ukwakha kusuka kukhodi yomthombo

Uma ufuna ukubamba iqhaza ekuthuthukiseni, lungiselela i-JDK 21, i-Android SDK, lapho i-compileSdk ingu-37.2, kanye ne-NDK r29. Lapho wakha kumphathi we-arm64 Linux, kufanele futhi unikeze indlela eya ku-aapt2 yenguqulo ye-arm64.

Okokuqala landa futhi uhlole amalabhulali omdabu ahlanganiswe kusengaphambili, njenge-libnode:

native/prebuilt.sh fetch

Imiphumela izobhalwa ku:

toolchains/out/jniLibs/arm64-v8a/

Bese wakha iphakheji yenjini equkethe i-dsh, ama-plugin namapatch:

OUT_DIR=<engineOut> js/build-engine.sh

Ekugcineni yakha i-Debug APK:

./gradlew :app:assembleDebug -Pdsh.engineOut=<engineOut>

Uma usebenzisa i-Gradle kumphathi we-arm64 Linux, kufanele futhi wengeze lokhu kuye ngendawo:

-Pandroid.aapt2FromMavenOverride=<indlela eya ku-aapt2 yenguqulo ye-arm64>

Ngokuvamile akudingeki uzakhele i-Node ngokwakho. Kuphela lapho uthuthukisa i-Node noma uguqula ama-patch omdabu lapho kudingeka uqale usebenzise:

native/build.sh

Ngemva kwalokho shicilela imiphumela ehlanganiswe kusengaphambili ngomyalo olandelayo:

native/prebuilt.sh publish

Ukuqhuba ukuhlolwa okuphelele komphathi

Iphrojekthi inikeza ukuhlolwa okuphelele komphathi okusebenzisa i-DeepSeek API yangempela:

node js/test/host-e2e.mjs

Gcina i-API key efayeleni, bese usebenzisa i-DSH_E2E_KEY_FILE ukucacisa indlela. Indlela ezenzakalelayo yi:

~/.config/dsh/deepseek_api_key

Uhlolojikelele lokwakhiwa

Inqubo eyinhloko ye-App isebenzisa i-Kotlin ne-Compose, futhi iphethe izingxoxo, imikhondo, izicelo zokugunyazwa, izilungiselelo, amakhono edivayisi nezibangeli zokuzenzakalela. I-Node 24 isebenza njengomtapo wolwazi owabelwana nawo womdabu we-Android ngaphakathi kwesevisi ezimele yangaphambili ye-:engine, futhi iqalisa i-dsh nge-JNI.

Isixhumi esibonakalayo ne-dsh kuxhumana nge-SDK JSON-RPC; amakhono edivayisi asetshenziswa nge-Kotlin futhi adalulwa ku-dsh ngesiteshi se-socket esiyimfihlo. I-Shizuku ongayikhetha inikeza imvume ye-shell kwamanye amakhono, kanti izicelo zemodeli zithunyelwa ku-API ehambisanayo nge-HTTPS.

Lo mklamo awusebenzisi i-proot noma i-Termux, futhi ugwema nokuncika kunqubo ezimele eyengeziwe ye-Node. I-dsh ngokwayo ayenzi i-fork; ukulungiswa kwe-Android kugxile kuma-plugin nakumapheshana ambalwa.

Isifinyezo

I-DSH-Android ihlanganisa injini ephelele ye-dsh agent ibe yi-APK eyodwa ye-Android, ukuze imisebenzi yolimi lwemvelo ikwazi ukuxhumana namafayela, izixhumi ezibonakalayo zezinhlelo zokusebenza, izilungiselelo zesistimu, izaziso nezibangeli zokuzenzakalela. Lapho uqala ukuyisebenzisa, kunconywa ukuthi uqale ngemisebenzi enobungozi obuphansi, njengemibuzo yamafayela efundeka kuphela, unikeze izimvume lapho kudingeka, bese ulungisa kancane kancane isevisi yokufinyeleleka, i-Shizuku, izinqamuleli nemithetho yokuzenzakalela.

Iphrojekthi isebenzisa i-Apache License 2.0, kodwa izingxenye zezinkampani zangaphandle ezakhelwe ngaphakathi, okuhlanganisa i-Node.js, i-dsh, i-Shizuku ne-ripgrep, ngayinye ilandela ilayisensi yayo.