Dhibiti iPhone kwa AI ukitumia Poki: Usanidi, MCP na mtiririko wa kazi wa Agent

Poki Ni Nini?

Poki ni mradi wa macOS na iOS wa chanzo huria unaomwezesha wakala wa AI kuendesha iPhone kwa njia inayofanana na mwingiliano wa kawaida wa mtumiaji. Unaweza kuiunganisha na mteja wa MCP kama Claude Code au Codex, au kutumia Poki Agent ya hiari kutoka kwenye terminali au njia ya ujumbe.

Kwa sababu Poki inadhibiti iPhone halisi, inaweza kutekeleza vitendo vyenye madhara au athari kubwa. Ukiomba itume ujumbe, ifanye malipo, au ibadilishe akaunti, kitendo hicho kinaweza kutokea kweli. Maudhui ya skrini pia hutumwa kwenye huduma ya modeli uliyosanidi, kwa hiyo tumia mradi huu tu unapofahamu athari zake kwa faragha na akaunti.

Tembelea tovuti ya Poki kwa ramani ya maendeleo ya mradi na maelezo zaidi.

Vipengele Muhimu

• Poki MCP: Unganisha Poki na Claude Code, Codex, au mteja mwingine unaoendana na MCP.
• Poki Agent: Endesha kazi kutoka kwenye terminali au njia zilizoidhinishwa za iMessage na Telegram.
• Uteuzi wa kifaa: Tumia kiotomatiki iPhone moja iliyounganishwa au chagua kifaa kwa UUID yake wakati vifaa kadhaa vinapatikana.
• Kujifunza kutokana na marudio: Poki hukumbuka kazi za awali na inaweza kuendesha kazi zinazorudiwa kwa haraka zaidi.
• Chaguo nyingi za muunganisho: Tumia simulatori au iPhone halisi iliyounganishwa kwenye Mac.
• Msingi wa chanzo huria: Mradi umetolewa chini ya leseni ya AGPL-3.0-only.

Mahitaji

Usakinishaji kutoka kwenye chanzo unahitaji macOS 15 au toleo jipya zaidi, Xcode kamili, Rust, Node.js 24 au toleo jipya zaidi, na ffmpeg. Skripti ya usanidi hukagua vitegemezi vinavyokosekana, lakini lazima usakinishe mahitaji ya awali inayoripoti kabla ya kuendelea.

Kwa iPhone halisi, kwanza oanisha kifaa na Mac yako kupitia USB. Fuata mwongozo wa usanidi wa iPhone halisi wa mradi kwa maelezo ya uoanishaji wa USB, Developer Mode, na Wi-Fi.

Sakinisha Poki kutoka kwenye Chanzo

Clone hazina, ingia kwenye saraka yake, endesha skripti ya usanidi, kisha uanze seva:

git clone https://github.com/JosssphZhou/poki.git
cd poki
./bin/setup
npm start

Uundaji wa kwanza unaweza kuchukua dakika chache. Acha npm start ikiendelea wakati unatumia seva ya MCP au Poki Agent.

Tumia Kifurushi cha macOS arm64 Kilichoundwa Mapema

Ikiwa unatumia Mac yenye Apple Silicon, unaweza kupakua poki-v0.1.1-macos-arm64.tar.gz kutoka kwenye matoleo ya mradi. Kifungue, sakinisha vitegemezi vya Node, kisha uanze seva:

tar -xzf poki-v0.1.1-macos-arm64.tar.gz
cd poki-v0.1.1
npm ci --no-audit --no-fund
npm start

Kifurushi kinajumuisha daraja asilia na zana za idevice, kwa hiyo Rust na ./bin/setup hazihitajiki. Bado unahitaji macOS kwenye Apple Silicon, Xcode kamili, Node.js 24 au toleo jipya zaidi, Python 3, na ffmpeg.

Unganisha Mteja wa MCP

Seva ikiwa inaendelea, fungua terminali nyingine kwenye saraka hiyo hiyo na usajili Poki kwa mteja wako wa MCP. Kwa Claude Code, tumia:

claude mcp add --scope user poki-mcp -- node "$PWD/src/stdio.mjs"

Kwa Codex, tumia:

codex mcp add poki-mcp -- node "$PWD/src/stdio.mjs"

README pia inasaidia wateja wengine wanaokubali usanidi wa JSON wa mcpServers. Tazama mwongozo wa usakinishaji wa mradi kwa maelezo mahususi ya kila mteja na utatuzi wa matatizo.

Sakinisha na Ingia kwenye Poki Agent

Poki Agent ni ya hiari. Inatoa wakala wa kujitegemea wa terminali na inasaidia njia za ujumbe zilizosanidiwa. Acha seva ya Poki ikiendelea, kisha fungua terminali nyingine kwenye saraka ya mradi na usakinishe wakala:

npm ci --prefix agent
export PATH="$PWD/bin:$PATH"
poki login
poki status

Poki Agent hutumia gpt-6.1-terra ikiwa na kiwango cha chini cha reasoning kwa chaguo-msingi. README inapendekeza uendelee kutumia chaguo-msingi hili kwa sababu lilikuwa usanidi wa haraka zaidi uliojaribiwa kwa kazi za simu. Ili kubadilisha modeli, weka kigezo cha mazingira cha POKI_AGENT_MODEL. Tazama mwongozo wa Kuendesha Poki Agent kwa usanidi unaoungwa mkono.

Endesha Kazi Yako ya Kwanza kwenye iPhone

Wakati iPhone moja imeunganishwa, Poki Agent huichagua kiotomatiki. Ili kuona vifaa vilivyounganishwa na UUID zake, endesha:

node bin/call.mjs list_devices

Kisha unaweza kumuomba wakala atekeleze kazi. Kwa mfano:

poki "Search esp32 in Chrome and summarize the top result"

Ikiwa zaidi ya kifaa kimoja kimeunganishwa, bainisha kifaa lengwa kwa kutumia UUID yake:

poki --device '<device UUID>' "Search esp32 in Chrome and summarize the top result"

Anza na kazi zenye hatari ndogo huku ukithibitisha kuwa kifaa, programu na usanidi wa modeli unaotumika ni sahihi.

Tumia Njia za Ujumbe

Baada ya kusanidi njia iliyoidhinishwa, unaweza kuanzisha Poki Agent kwa iMessage au Telegram:

poki imessage
poki telegram

Usanidi wa njia na modeli umeelezwa katika nyaraka za Poki Agent. Usiiidhinishe njia yoyote isipokuwa umeelewa ni nani anayeweza kutuma kazi kwa wakala wako na vitendo ambavyo kazi hizo zinaweza kuanzisha.

Usanidi wa Kina na Matengenezo

Sasisha Poki

Tumia amri ya kusasisha iliyojengwa ndani kutoka kwenye saraka ya mradi:

./bin/poki update

Poki hukagua matoleo mapya ya GitHub bila kutambulisha mtumiaji mara moja kwa siku. Ili kuzima ukaguzi huo, weka:

export POKI_NO_UPDATE_CHECK=1

Baada ya kusasisha, fuata maelekezo ya kusasisha ya mradi kwa hatua za kuanzisha upya na maelezo ya kifurushi kilichoundwa awali.

Chagua Kifaa Sahihi

Tumia node bin/call.mjs list_devices kabla ya kazi unapohitaji kuthibitisha vifaa vinavyopatikana. Ukiwa na vifaa vingi, pitisha UUID kamili kwa kutumia --device badala ya kutegemea uteuzi wa kiotomatiki.

Elewa Vikwazo vya iPhone Halisi

Usaidizi wa iPhone halisi umethibitishwa tu kwenye iPhone zinazotumia kiolesura cha Kichina. Vifaa halisi vinaunga mkono mkao wa wima pekee. Uhamishaji wa kontena la programu na viungo vya moja kwa moja vya kurasa ndogo za Mipangilio havipatikani. Kagua uthibitishaji na vikwazo vinavyojulikana vya mradi kabla ya kubuni mtiririko wa kazi unaotegemea kifaa halisi.

Chunguza Marejeo ya Zana na Usanidi

Kwa miunganisho ya kina zaidi, soma marejeo ya tabia ya zana ya MCP na mwongozo wa usanidi. Nyaraka hizi zinaeleza tabia ya zana, vigeu vya mazingira na vipindi. Hifadhi pia inaandika kuhusu daraja asilia na adapta ya kiigaji.

Usalama na Leseni

Poki inadhibiti iPhone yako halisi. Vitendo kama kutuma ujumbe au kufanya malipo vinaweza kutokea ukiviomba.

Poki ni mradi huru wa chanzo huria na hauhusiani na Apple, OpenAI au watengenezaji wa programu na tovuti inazotumia. Kuendesha huduma za wahusika wengine kiotomatiki kunaweza kukiuka masharti yao ya huduma, na unawajibika kwa vitendo vinavyofanywa kwenye kifaa na akaunti zako. Programu hii inatolewa jinsi ilivyo chini ya leseni ya AGPL-3.0-only.

Hitimisho

Poki hutoa njia ya vitendo ya kuunganisha zana za AI kwenye iPhone kutoka macOS. Isakinishe kutoka kwenye msimbo chanzi au tumia kifurushi cha Apple Silicon, iache seva ikiendelea kufanya kazi, sajili sehemu ya mwisho ya MCP kwa mteja wako na utumie Poki Agent kwa mtiririko wa kazi wa terminali au ujumbe. Anza na kazi zinazodhibitiwa, chagua vifaa kwa uwazi inapohitajika na kagua vikwazo pamoja na mwongozo wa usalama wa mradi kabla ya kuwezesha uendeshaji mpana zaidi kiotomatiki.