Mafunzo ya Kuanzia ya DSH-Android: Dhibiti Simu ya Android kwa Lugha Asilia na Unda Kazi za Kiotomatiki

DSH-Android ni nini

DSH-Android ni mradi wa jamii unaoendesha DeepSeek Harness moja kwa moja kwenye vifaa vya Android. Baada ya kusakinisha APK, unaweza kueleza kazi kwa lugha ya kawaida na kumruhusu agent kupanga faili, kuendesha App, kubadilisha mipangilio ya mfumo, au kuunda kazi za kiotomatiki zinazoanzishwa kwa muda na matukio ya kifaa.

Mradi hauhitaji Root wala hautegemei Termux. Unaweka Node 24 na injini ya dsh isiyofanyiwa fork ndani ya App, na hutumia uwezo wa kifaa ulioandikwa kwa Kotlin kuwasiliana na mfumo wa Android. Toleo la sasa linahitaji kifaa chenye Android 10 au zaidi na arm64-v8a.

DSH-Android ni mradi wa jamii, hauna uhusiano na DeepSeek rasmi wala haujaidhinishwa nayo.

Vipengele vikuu

Uchakataji wa faili na nyaraka

Unaweza kuamuru DSH-Android itafute, ipange, ihamishe na ibadilishe majina ya faili, pamoja na kubana na kufungua faili zilizobanwa. Pia inaweza kusoma maandishi katika faili za PDF, Word, Excel na PPT.

• Tafuta faili zinazotumia nafasi kubwa.
• Panga saraka ya vipakuliwa kulingana na aina au tarehe.
• Hamisha au badilisha majina ya faili kwa wingi.
• Soma maandishi katika nyaraka za kawaida za ofisini.

Uendeshaji wa skrini na App

Baada ya kuwezesha huduma ya ufikivu, DSH-Android inaweza kusoma skrini, kubofya, kusogeza na kuingiza maandishi, pamoja na kufungua App au kwenda kwenye ukurasa maalum. Hii inafaa kwa kukamilisha kazi za hatua nyingi zinazohitaji kuendesha kiolesura cha picha.

Mipangilio ya mfumo na arifa

Mradi unaunga mkono kudhibiti mwangaza, sauti, hali ya Usinisumbue, kengele, Wi-Fi, Bluetooth na eneo, pamoja na kusoma na kujibu arifa na kudhibiti uchezaji wa midia. Baadhi ya uwezo wa mfumo unaweza kutumiwa moja kwa moja, huku mingine ikihitaji ruhusa za ziada au Shizuku ya hiari.

Vichocheo vya kiotomatiki

Pamoja na kutekeleza amri mara moja, unaweza kuunda kazi zilizopangwa kwa muda au zinazoanzishwa unapounganisha Wi-Fi, kuunganisha Bluetooth, kuanza kuchaji, kufika mahali fulani, kupokea arifa au kukidhi masharti mengine.

Uwezo kamili wa dsh

App inaendesha dsh ya awali badala ya fork inayotunzwa kando, hivyo unaweza kuendelea kutumia uwezo kama skills, MCP, sub-agent na utafutaji wa wavuti. Mfuatano wa kazi huonyesha kwa kila raundi hatua zilizotekelezwa na agent, jambo linalorahisisha kukagua mchakato.

Maandalizi kabla ya kusakinisha

Kabla ya kuanza, thibitisha kuwa kifaa kinakidhi masharti yafuatayo:

• Android 10 au toleo la juu zaidi.
• ABI ya kichakataji ni arm64-v8a.
• Kifurushi cha usakinishaji ni takriban 110 MB; inashauriwa kuwa na angalau 500 MB ya nafasi ya bure.
• Kifaa kinaweza kufikia API ya modeli iliyosanidiwa.
• Una akaunti ya DeepSeek, DeepSeek API key, au kitambulisho cha huduma ya modeli ya mtu wa tatu inayoungwa mkono.

Usakinishaji na mipangilio ya awali

1. Pakua APK ya hivi karibuni kutoka ukurasa wa Releases wa mradi na uisakinishe kwenye kifaa cha Android.

2. Fungua App, ingia kwenye akaunti ya DeepSeek, au jaza API key uliyoipata kutoka jukwaa la DeepSeek.

3. Ikiwa ungependa kutumia modeli nyingine, nenda kwenye Mipangilio → Huduma za modeli, ongeza mtoa huduma husika na ujaze API key, kisha pakua orodha ya modeli.

4. Rudi kwenye ukurasa wa mwanzo na uingize kazi rahisi. Unapotumia uwezo fulani wa kifaa kwa mara ya kwanza, App itakuongoza kutoa ruhusa zinazohitajika.

Ruhusa huombwa inapohitajika, kwa hiyo si lazima utoe ruhusa zote mwanzoni. Unaweza kuzikagua na kuzidhibiti kwa pamoja kwenye Mipangilio → Ruhusa za simu.

Kutekeleza kazi kwa mara ya kwanza

Mfano wa kwanza: Kutafuta faili kubwa

Ingiza kwenye ukurasa wa mwanzo:

Orodhesha faili 5 kubwa zaidi kwenye saraka ya vipakuliwa

agent itaita uwezo wa faili kulingana na kazi na kurudisha matokeo. Ikiwa unahitaji kuchakata zaidi, endelea kuingiza katika mazungumzo hayo hayo:

Panga faili zilizo kubwa kuliko 500 MB kati ya hizo kwenye saraka iitwayo “Faili kubwa”, lakini usifute faili yoyote

Inapohusu kuhamisha, kubadilisha au kufanya operesheni nyingine nyeti, kagua kwa makini hatua za kazi na vidokezo vya idhini vinavyoonyeshwa na App.

Mfano wa pili: Kubadilisha hali ya simu

Unaweza kueleza lengo moja kwa moja, kwa mfano:

Punguza sauti ya midia na uwashe hali ya Usinisumbue

Iwapo operesheni inaweza kukamilika moja kwa moja hutegemea toleo la Android, ROM ya kifaa na ruhusa zilizotolewa. Ruhusa inapohitajika, App itatoa mwongozo wa kuiwasha.

Mfano wa tatu: Kuendesha App

Baada ya kuwezesha huduma ya ufikivu, unaweza kujaribu:

Fungua mipangilio ya mfumo na uende kwenye ukurasa wa Bluetooth

Uendeshaji wa skrini hutegemea hali ya sasa ya kiolesura. Baada ya kazi kukamilika, unaweza kufungua ukurasa wa mfuatano na kukagua kwa raundi vitendo na matokeo ya agent.

Kuweka njia za kuamsha kwa haraka

DSH-Android inaweza kuamshwa kupitia kiputo kinachoelea, msaidizi wa mfumo, kigae cha njia ya mkato na sehemu ya kushiriki ya mfumo. Baada ya kuwezesha njia zinazofaa kulingana na matumizi yako, hutahitaji kurudi kwenye ukurasa wa mwanzo wa App kila mara ili kuwasilisha kazi.

Kwenye baadhi ya ROM za watengenezaji wa ndani, kiputo kinachoelea na uendeshaji wa kiotomatiki wa nyuma huhitaji pia kuruhusu mwenyewe kuonyesha kiolesura nyuma na kujiwasha yenyewe. Unaweza kuangalia ukurasa wa ukaguzi wa App na kurekebisha mipangilio ya mfumo kulingana na vidokezo.

Sanidi Shizuku ili kufungua uwezo zaidi wa mfumo

Shizuku si lazima kwa matumizi ya msingi, lakini inaweza kutoa ruhusa ya shell na hivyo kufungua swichi zaidi za mfumo. Mradi umejumuisha kifurushi rasmi cha usakinishaji; sanidi kwa hatua zifuatazo:

1. Nenda kwenye Mipangilio → Ruhusa za simu.

2. Tumia kipengele cha usakinishaji wa mbofyo mmoja kusakinisha Shizuku.

3. Fuata mwongozo wa Shizuku ili kukamilisha uanzishaji na uidhinishaji.

4. Ikiwa kifaa kina Android 11 au toleo la juu zaidi na toleo la Shizuku si chini ya 13.6, inashauriwa kuwezesha Kuanzisha wakati wa kuwasha (utatuzi wa wireless).

Baada ya kifaa kuwashwa upya, Shizuku kwa kawaida huhitaji kuanzishwa tena. Kuwezesha uanzishaji wa utatuzi wa wireless wakati wa kuwasha hupunguza kurudia operesheni, lakini tabia halisi bado hutegemea toleo la mfumo na vizuizi vya mtengenezaji.

Kuunda kazi za kiotomatiki

Kazi za kiotomatiki zinaweza kutekelezwa kwa wakati maalum au kuanzishwa na matukio ya kifaa. Matukio yanayoungwa mkono ni pamoja na kuunganisha Wi-Fi, kuunganisha Bluetooth, kuanza kuchaji, kufika mahali fulani na kupokea arifa.

Unapounda kazi, inashauriwa kutaja kwa uwazi masharti ya kuanzisha, vitendo vya kutekeleza na masharti ya vikwazo muhimu. Kwa mfano:

Kila usiku saa 11 washa hali ya Usinisumbue na upunguze sauti ya midia

Baada ya kuunganisha Wi-Fi ya nyumbani, tekeleza kazi iliyobainishwa

Mfano wa pili bado unahitaji kusanidi masharti halisi ya mtandao na vitendo husika ndani ya App. Kanuni zinazohusu eneo, arifa au uendeshaji wa nyuma zinahitaji ruhusa zinazolingana. Kwa otomatiki inayoweza kubadilisha au kuhamisha data, inashauriwa kwanza kuijaribu kwa operesheni zisizoharibu data.

Kutumia huduma za modeli za watu wa tatu

Pamoja na DeepSeek, mradi unaruhusu kuongeza OpenAI, Claude, Gemini, Grok, OpenRouter, Kimi, GLM ya Zhipu, Tongyi Qianwen, Volcengine Ark, MiniMax, SiliconFlow, StepFun, au kiolesura chochote kinachooana.

1. Fungua Mipangilio → Huduma za modeli.

2. Chagua mtoa huduma au sanidi kiolesura kinachoendana.

3. Jaza API key na upakue orodha ya modeli.

4. Kwenye kichagua modeli, badilisha hadi modeli unayotaka kutumia.

Kwa sasa modeli za watu wa tatu zinaunga mkono tu kiolesura cha OpenAI-compatible Chat Completions kinachofikiwa kupitia HTTPS. Muktadha huhesabiwa kwa pamoja kama 128K, na hakuna chaguo la kiwango cha kufikiri. Ufanisi wa kuita zana hutegemea modeli iliyochaguliwa. Ikiwa ungependa kutumia utafutaji wa mtandaoni unaotolewa na DeepSeek, hata modeli kuu ikiwa ya mtu wa tatu, bado utahitaji kusanidi DeepSeek API key kando.

Mapendekezo ya matumizi ya hali ya juu

Tumia mfuatano kukagua kazi tata

Kwa operesheni za hatua nyingi, usikague jibu la mwisho pekee. Baada ya kazi kukamilika, fungua mfuatano na uangalie ni uwezo gani agent aliita katika kila raundi na ni vitendo gani alivyotekeleza. Hii hurahisisha kugundua ukosefu wa ruhusa, mabadiliko ya kiolesura au makosa katika uamuzi wa modeli.

Andika kazi kwa uwazi zaidi

Maagizo ya lugha ya kawaida yanapaswa kuwa na lengo, upeo na mipaka ya usalama. Kwa mfano, ikilinganishwa na “panga saraka ya vipakuliwa”, maandishi yafuatayo yanadhibitika zaidi:

Hamisha PDF zilizo kwenye saraka ya vipakuliwa hadi Documents/PDF; faili zikiwa na majina yanayofanana usibadilishe zilizo tayari, na faili nyingine zibaki bila kubadilika

Ikiwa kazi inahusu kufuta, kubadilisha, kutuma ujumbe au kujibu arifa, inashauriwa kutaka kwanza orodha ya vitu vinavyoweza kuchaguliwa au kusubiri uthibitisho.

Tenganisha uendeshaji wa kiolesura na uwezo wa mfumo

Baada ya skrini kufungwa, kazi za API za mfumo kama faili, mipangilio ya mfumo na arifa bado zinaweza kutekelezwa; lakini skrini ikiwa imefungwa kwa usalama, Android hairuhusu App kuendesha kiolesura cha App nyingine. Kazi za aina hii zitasitishwa na kukuomba uendelee baada ya kufungua skrini.

Toa muda kwa uanzishaji baridi

Kwa sasa uanzishaji baridi wa injini huchukua takriban sekunde 5. Unapofungua App kwa mara ya kwanza au injini ikiwa bado haijaendeshwa, majibu ya kazi yanaweza kuwa ya polepole kidogo.

Dhibiti mazungumzo na ruhusa

Kuweka kazi zenye malengo tofauti katika mazungumzo tofauti husaidia kuweka muktadha wazi. Kagua mara kwa mara ruhusa za simu, huduma ya ufikivu, ufikiaji wa arifa na mipangilio ya uendeshaji wa nyuma; unaweza kuzima uwezo usiotumika tena.

Kujenga kutoka kwenye msimbo wa chanzo

Ikiwa ungependa kushiriki katika uundaji, unahitaji kuandaa JDK 21, Android SDK yenye compileSdk 37.2, na NDK r29. Unapojenga kwenye mwenyeji wa arm64 Linux, unahitaji pia kupitisha njia ya aapt2 ya arm64.

Kwanza pakua na uthibitishe maktaba asilia zilizokusanywa awali kama libnode:

native/prebuilt.sh fetch

Matokeo yataandikwa kwenye:

toolchains/out/jniLibs/arm64-v8a/

Kisha jenga kifurushi cha injini chenye dsh, programu-jalizi na viraka:

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

Mwishowe jenga Debug APK:

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

Ikiwa Gradle inaendeshwa kwenye mwenyeji wa arm64 Linux, ongeza pia kulingana na mazingira:

-Pandroid.aapt2FromMavenOverride=<njia ya aapt2 ya arm64>

Kwa kawaida si lazima ujikusanyie Node mwenyewe. Ni wakati tu wa kusasisha Node au kurekebisha viraka asilia ndipo unapohitaji kuendesha kwanza:

native/build.sh

Kisha chapisha matokeo yaliyokusanywa awali kwa amri:

native/prebuilt.sh publish

Kuendesha majaribio ya mwisho hadi mwisho kwenye mwenyeji

Mradi unatoa majaribio ya mwisho hadi mwisho kwenye mwenyeji ambayo kwa kweli yataita DeepSeek API:

node js/test/host-e2e.mjs

Hifadhi API key kwenye faili, kisha tumia DSH_E2E_KEY_FILE kubainisha njia. Njia chaguo-msingi ni:

~/.config/dsh/deepseek_api_key

Muhtasari wa usanifu

Mchakato mkuu wa App hutumia Kotlin na Compose, na unawajibika kwa mazungumzo, ufuatiliaji, uidhinishaji, mipangilio, uwezo wa kifaa na vichochezi vya uendeshaji otomatiki. Node 24 huendeshwa kama maktaba asili ya Android iliyoshirikiwa ndani ya huduma huru ya mbele ya :engine, na huanzisha dsh kupitia JNI.

Kiolesura na dsh huwasiliana kupitia SDK JSON-RPC; uwezo wa kifaa hutekelezwa kwa Kotlin na kuwekwa wazi kwa dsh kupitia njia ya soketi ya faragha. Shizuku ya hiari hutoa ruhusa za shell kwa baadhi ya uwezo, huku maombi ya modeli yakitumwa kwenye API husika kupitia HTTPS.

Muundo huu hautumii proot au Termux, na pia huepuka kutegemea mchakato wa ziada wa kujitegemea wa Node. dsh yenyewe haifanyi fork; urekebishaji wa Android umejikita kwenye programu-jalizi na viraka vichache.

Muhtasari

DSH-Android hufunga injini kamili ya dsh agent ndani ya APK ya Android, na kuwezesha kazi za lugha asilia kuunganishwa na faili, kiolesura cha App, mipangilio ya mfumo, arifa na vichochezi vya uendeshaji otomatiki. Wakati wa matumizi ya kwanza, inapendekezwa kuanza na kazi zisizo na hatari kubwa, kama vile kutafuta faili kwa kusoma tu, kutoa ruhusa inapohitajika, kisha kusanidi hatua kwa hatua huduma ya ufikivu, Shizuku, njia za mkato na kanuni za uendeshaji otomatiki.

Mradi unatumia Apache License 2.0, lakini vipengele vya wahusika wengine vilivyojumuishwa, kama Node.js, dsh, Shizuku na ripgrep, vinafuata leseni zao husika.