تحكّم فـ iPhone بالذكاء الاصطناعي باستعمال Poki: الإعداد، MCP، وسير العمل ديال Agent

شنو هو Poki؟

Poki هو مشروع مفتوح المصدر لـ macOS وiOS، كيخلّي وكيل ذكاء اصطناعي يتحكّم فـ iPhone بطريقة كتشبه لتفاعل المستخدم العادي. تقدر تربطو بعميل MCP بحال Claude Code ولا Codex، ولا تستعمل Poki Agent الاختياري من التيرمينال ولا من قناة ديال المراسلة.

حيت Poki كيتحكّم فـ iPhone حقيقي، يقدر يدير إجراءات عندها نتائج فعلية. إلا طلبتي منّو يصيفط رسالة، يدير أداء، ولا يبدّل شي إعداد فحساب، راه ممكن هاد الإجراء يوقع فعلاً. محتوى الشاشة كيتصيفط حتى هو لخدمة النموذج اللي عيّنتي، لذلك استعمل المشروع غير إلا كنت فاهم مزيان تداعيات الخصوصية والحساب.

زور موقع Poki باش تشوف خارطة الطريق ديال المشروع ومعلومات إضافية.

أهم المزايا

• Poki MCP: ربط Poki بـ Claude Code أو Codex أو أي عميل آخر متوافق مع MCP.
• Poki Agent: شغّل المهام من التيرمينال ولا من قنوات iMessage وTelegram المصرّح بها.
• اختيار الجهاز: استعمل تلقائياً iPhone واحد مربوط، ولا اختار جهازاً بالـ UUID ديالو إلا كانو كثر من جهاز متاحين.
• التعلّم من التكرار: Poki كيتفكّر المهام السابقة ويقدر يشغّل المهام المتكررة بسرعة أكثر.
• اختيارات متعددة للربط: استعمل محاكي ولا iPhone حقيقي مربوط بـ Mac.
• أساس مفتوح المصدر: المشروع منشور برخصة AGPL-3.0-only.

المتطلبات

التثبيت من المصدر كيتطلب macOS 15 أو أحدث، وXcode كامل، وRust، وNode.js 24 أو أحدث، وffmpeg. سكريبت الإعداد كيتحقق من التبعيات الناقصة، ولكن خاصك تثبّت المتطلبات اللي كيبيّنها قبل ما تكمل.

بالنسبة لـ iPhone حقيقي، خاصك تربط الجهاز مع Mac ديالك عبر USB الأول. تبع دليل إعداد iPhone الحقيقي ديال المشروع باش تعرف تفاصيل الربط عبر USB، ووضع المطوّر، وWi-Fi.

ثبّت Poki من المصدر

نزّل المستودع، دخل للمجلد ديالو، شغّل سكريبت الإعداد، وبدا الخادم:

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

البناء الأول يقدر ياخذ بضع دقايق. خلّي npm start خدام مادام كتستعمل خادم MCP ولا Poki Agent.

استعمل حزمة macOS arm64 الجاهزة

إلا كنت كتستعمل Mac بمعالج Apple Silicon، تقدر تنزّل poki-v0.1.1-macos-arm64.tar.gz من إصدارات المشروع. فكّ الضغط عليها، ثبّت تبعيات Node، وبدا الخادم:

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

الحزمة فيها الجسر الأصلي وأدوات idevice، لذلك ما كايناش حاجة لـ Rust ولا لـ ./bin/setup. ولكن مازال خاصك macOS خدام على Apple Silicon، وXcode كامل، وNode.js 24 أو أحدث، وPython 3، وffmpeg.

ربط عميل MCP

منين يكون الخادم خدام، حلّ تيرمينال آخر فنفس المجلد وسجّل Poki عند عميل MCP ديالك. بالنسبة لـ Claude Code، استعمل:

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

بالنسبة لـ Codex، استعمل:

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

الـ README كيدعم حتى عملاء آخرين كيقبلو إعداد JSON فيه mcpServers. راجع دليل التثبيت ديال المشروع باش تلقى التفاصيل الخاصة بكل عميل وحلول المشاكل.

ثبّت Poki Agent ودخل للحساب

Poki Agent اختياري. كيوفّر وكيلاً مستقلاً فالتيرمينال وكيدعم قنوات المراسلة المهيّأة. خلّي خادم Poki خدام، ومن بعد حلّ تيرمينال آخر فمجلد المشروع وثبّت الوكيل:

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

Poki Agent كيستعمل gpt-6.1-terra مع استدلال منخفض بشكل افتراضي. الـ README كينصح تخلي هاد الإعداد الافتراضي حيت كان أسرع إعداد تجرّب لمهام الهاتف. إلا بغيتي تبدّل النموذج، عيّن متغيّر البيئة POKI_AGENT_MODEL. شوف دليل تشغيل Poki Agent باش تعرف الإعدادات المدعومة.

شغّل أول مهمة على iPhone

إلا كان iPhone واحد مربوط، Poki Agent كيختارو تلقائياً. باش تشوف الأجهزة المربوطة والـ UUIDs ديالها، شغّل:

node bin/call.mjs list_devices

من بعد تقدر تطلب من الوكيل يدير مهمة. مثلاً:

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

إلا كانو مربوطين كثر من جهاز، حدّد الجهاز الهدف باستعمال الـ UUID ديالو:

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

بدا بمهام قليلة المخاطر وانت كتتأكد باللي الجهاز والتطبيق وإعدادات النموذج الصحيحين كيتستعملو.

استعمل قنوات المراسلة

من بعد ما تهيّأ قناة مصرّح بها، تقدر تشغّل Poki Agent مع iMessage ولا Telegram:

poki imessage
poki telegram

إعداد القنوات وإعدادات النموذج موثّقة فـ وثائق Poki Agent. ما تصرّح حتى قناة إلا كنت فاهم شكون يقدر يصيفط مهام للوكيل ديالك وشنو الإجراءات اللي تقدر هاد المهام تفعّل.

الإعدادات المتقدمة والصيانة

حدّث Poki

استعمل أمر التحديث المدمج من مجلد المشروع:

./bin/poki update

Poki كيدير كل نهار فحصاً مجهولاً لإصدارات GitHub. باش تعطل هاد الفحص، عيّن:

export POKI_NO_UPDATE_CHECK=1

من بعد التحديث، تبع تعليمات التحديث ديال المشروع باش تعرف خطوات إعادة التشغيل وتفاصيل الحزمة الجاهزة.

اختار الجهاز المناسب

استعمل node bin/call.mjs list_devices قبل شي مهمة ملي خاصك تتأكد من الأجهزة المتاحة. إلا كانو بزاف ديال الأجهزة، دوز معرّف UUID الكامل باستعمال --device عوض ما تعتمد على الاختيار التلقائي.

فهم حدود iPhone الحقيقي

الدعم ديال iPhone الحقيقي تْتحقق منّو غير فـ iPhones اللي كايستعملو الواجهة بالصينية. الأجهزة الحقيقية كاتدعم غير الوضع العمودي. تصدير حاوية التطبيق والروابط المباشرة لصفحات فرعية فـ Settings ما متاحينش. راجع التوثيق ديال التحقق والحدود المعروفة ديال المشروع قبل ما تصمّم سير عمل مبني على جهاز حقيقي.

استكشف مراجع الأدوات والإعدادات

إلى بغيتي تكاملات أعمق، قرا مرجع سلوك أدوات MCP ودليل الإعدادات. هاد الوثائق كاتشرح سلوك الأدوات، متغيرات البيئة، والجلسات. المستودع كايوثّق حتى الجسر الأصلي ومحوّل المحاكي.

السلامة والترخيص

Poki كايتحكم فـ iPhone الحقيقي ديالك. إجراءات بحال إرسال الرسائل ولا أداء الدفعات تقدر توقع إلا طلبتيها.

Poki مشروع مستقل ومفتوح المصدر، وما عندوش علاقة بـ Apple ولا OpenAI ولا بصانعي التطبيقات والمواقع اللي كاايشغّلها. أتمتة خدمات تابعة لجهات أخرى تقدر تخرق شروط الخدمة ديالها، وانت المسؤول على الإجراءات اللي كتدار فالجهاز والحسابات ديالك. البرنامج متوفّر كما هو بموجب ترخيص AGPL-3.0-only.

الخلاصة

Poki كايوفّر طريقة عملية باش تربط أدوات الذكاء الاصطناعي بـ iPhone من macOS. ثبّتو من المصدر ولا استعمل حزمة Apple Silicon، خلّي الخادم خدام، سجّل نقطة نهاية MCP عند العميل ديالك، واستعمل Poki Agent فـ مهام الطرفية ولا المراسلة. بدا بمهام متحكَّم فيها، واختار الأجهزة بشكل صريح ملي يكون ضروري، وراجع حدود المشروع وإرشادات السلامة قبل ما تفعّل أتمتة أوسع.