apfel مشروع من .

درس تعليمي · اختُبر في 15 نوفمبر 2026

الدرس التعليمي لـ apfel

أول رد من الذكاء الاصطناعي الموجود أصلًا على Mac لديك خلال 60 ثانية. ثم 11 مهمة يتقنها، كلٌّ منها جاهز للنسخ واللصق مع المخرجات الحقيقية، وقائمة صريحة بما لا يستطيع فعله.

تسجيل حقيقي للطرفية دون أي تعديل: apfel 1.18.0 على macOS 27.0.1، MacBook Air M2.
في هذه الصفحة: 15 قسمًا
  1. أول رد لك في 60 ثانية
  2. 1. اسأل جهاز Mac عن نفسه
  3. 2. صحّح أي نص نسخته
  4. 3. اقرأ الإيصالات وملفات PDF والسكربتات
  5. 4. حوّل جملة عادية إلى أمر shell
  6. 5. احصل على JSON تثق به سكربتاتك
  7. 6. أتمت يومك: git والصوت وسكربتات جاهزة
  8. 7. شغّل كود OpenAI الخاص بك مجانًا
  9. 8. امنحه أدوات عبر MCP
  10. 9. دردش معه لتجرّب prompt
  11. 10. أبقِ الخادم يعمل في الخلفية
  12. 11. تطبيقات مبنية على apfel
  13. الحدود وإجابات صريحة
  14. حين يفشل شيء ما
  15. من صنع هذا وكيف اختُبر

أول رد لك في 60 ثانية

تحتاج إلى جهاز Mac بشريحة Apple Silicon (M1 أو أحدث) يعمل بنظام macOS 26 Tahoe أو أحدث، مع تفعيل Apple Intelligence من إعدادات النظام > Apple Intelligence وSiri. تحقق من الشرطين الأولين بسطر واحد:

الطرفية
sw_vers -productVersion && uname -m
27.0.1
arm64

إذا كان الإصدار 26 أو أعلى وظهر arm64 فأنت جاهز. ثبّت apfel عبر Homebrew. بلا Xcode، وبلا حساب، وبلا مفتاح API:

الطرفية
brew install apfel

اطرح سؤالك الأول:

الطرفية
apfel "In one sentence: what can a small on-device language model do for me?"
A small on-device language model can help you perform tasks like text translation, summarization, and data analysis directly on your device.

هذا الرد جاء من نموذج Apple على جهاز Mac لديك. لم يُرسَل شيء إلى أي خادم، ولم يكلّفك شيئًا.

إن لم ينجح الأمر: اسأل apfel هل النموذج جاهز:

الطرفية
apfel --model-info | grep -E 'available|context'
├ available:  yes
├ context:    4096 tokens

إذا ظهر available: no، ففعّل Apple Intelligence من إعدادات النظام وانتظر حتى يكتمل تنزيل النموذج (يذكر دليل التثبيت أن حجمه من 3 إلى 4 GB). يجب أن تكون لغة Mac ولغة Siri هي اللغة المدعومة نفسها. ينتهي apfel برمز الخروج 5 ما دام النموذج غير متاح.

التالي: المهام أدناه. كل مهمة تبدأ بما سيكون لديك بعد دقيقتين.

1. اسأل جهاز Mac عن نفسه

خلال 2 دقيقة يصبح لديك: إجابات بلغة واضحة عن القرص والمعالج والذاكرة، مباشرة من الأوامر التي تعرفها أصلًا.

عندما يطبع أمر في الطرفية سيلًا من الأرقام، أريد إجابة من سطر واحد، لكي أتصرف دون قراءة صفحة man.

مرّر أي أمر إلى apfel عبر pipe وقل ما تريد معرفته:

الطرفية
df -h | apfel "which volume is fullest, one sentence"
/dev/disk3s1 is the fullest volume, with 630Gi used.
الطرفية
ps aux | sort -k 3 -nr | head -5 | awk '{print $11, $3"%"}' | apfel "which app is using the most CPU, one sentence"
`/System/Library/CoreServices/RemoteManagement/screensharingd.bundle/Contents/MacOS/screensharingd` is using the most CPU.

اجعل المدخلات صغيرة: استخدم head وawk وgrep أولًا، ثم apfel. لا يقرأ النموذج إلا بضعة آلاف من الكلمات دفعة واحدة، وأقل من ذلك في حالة الكود (انظر الحدود).

إن لم ينجح الأمر: بعض الأوامر تكتب إلى stderr، والـ pipe لا ينقله. وسيخبرك apfel بذلك: piped input was empty - if the command prints to stderr, try: command 2>&1 | apfel.

التالي: الحيلة نفسها تعمل مع git log وlsof وpmset -g batt وملفات السجل وأي شيء آخر يطبع نصًا.

2. صحّح أي نص نسخته

خلال 2 دقيقة يصبح لديك: أمر يصحح قواعد أي نص موجود في الحافظة، في أي تطبيق.

عندما أكتب رسالة سريعة في Slack أو Mail أو المتصفح، أريد تنقيحها دون فتح تطبيق آخر، لكي ألصقها من جديد خلال ثوانٍ.

انسخ نصًا ما، ثم شغّل السطر الأوسط. يقرأ pbpaste الحافظة، ويكتب pbcopy النتيجة فيها من جديد:

الطرفية
printf 'can u send me the slides from yesterdays meeting i lost them' | pbcopy
pbpaste | apfel "Rewrite the text above with correct grammar and spelling. Reply with the rewritten text only." | pbcopy
pbpaste
Can you send me the slides from yesterday’s meeting? I lost them.

لماذا عبارة "the text above" (النص أعلاه)؟ لأن apfel يضع النص المُمرَّر أولًا وتعليماتك بعده (المصدر). مع التعليمة القصيرة "fix grammar and spelling, reply with the corrected text only" ردّ النموذج على الرسالة بدل أن يصححها، وأجاب Could you let me know which meeting you're referring to?. وفي اختبارنا، حُلّت المشكلة حين سمّينا له النص الذي يجب أن يعمل عليه.

إن لم ينجح الأمر: اقرأ النتيجة قبل إرسالها. النموذج الصغير يغيّر المعنى أحيانًا؛ فحين طلبنا منه ترجمة هذه الجملة إلى الألمانية، حوّل "Can you send me" (هل يمكنك أن ترسل لي) إلى "Can I send you" (هل يمكنني أن أرسل لك).

التالي: ضع السطر الأوسط في alias للـ shell أو في إجراء "Run Shell Script" ضمن Shortcuts واربطه باختصار لوحة مفاتيح.

3. اقرأ الإيصالات وملفات PDF والسكربتات

خلال 2 دقيقة يصبح لديك: إجابات عن صورة أو ملف PDF ممسوح ضوئيًا أو سكربت، تُقرأ على جهاز Mac لديك بتقنية التعرف على النصوص من Apple.

عندما يصل إيصال أو مستند ممسوح أو ملف مجهول إلى مجلد Downloads، أريد المعلومة الوحيدة التي أحتاجها منه، لكي أؤرشفه دون أن أفتحه.

أرفق ملفًا باستخدام -f. أعددنا صورة إيصال للاختبار (receipt.png) تحتوي هذه الأسطر:

المخرجات
CAFE APFEL
2x Melange          9.80
1x Sachertorte      7.90
1x Apfelstrudel     6.50
TOTAL EUR          24.20
14.11.2026  21:14
الطرفية
apfel -f receipt.png "What is the total? Just the amount."
24.20

ويعمل الإيصال نفسه أيضًا إذا حُفظ كملف PDF مكوّن من صور فقط، لأن apfel يشغّل التعرف على النصوص على الصفحات الممسوحة ضوئيًا:

الطرفية
apfel -f receipt.pdf "What is the total? Just the amount."
24.20

وكذلك أي ملف نصي، مثل سكربت shell:

الطرفية
apfel -f apfel-demos/gitsum "What does this script do? Two sentences."
This script summarizes recent Git activity by summarizing the last N commits, grouping related changes, and generating a concise report. It uses Apple Intelligence to format the output, and optionally copies the summary to the clipboard.

ستحصل على هذا السكربت في المهمة 6. ولإرفاق عدة ملفات استخدم -f a.txt -f b.txt.

إن لم ينجح الأمر: رمز الخروج 4 يعني أن الملف أطول مما يستوعبه النموذج (انظر الحدود). ورمز الخروج 3 يعني أن مرشح الأمان لدى Apple حظره؛ ويقترح دليل استخراج الملفات إضافة --permissive في هذه الحالة.

4. حوّل جملة عادية إلى أمر shell

خلال 2 دقيقة يصبح لديك: الأمر الذي لم تستطع تذكّره، مطبوعًا وحده لتنسخه مباشرة.

عندما أنسى خيارات find أو du أو tar، أريد الأمر انطلاقًا من جملة عادية، لكي أبقى في الطرفية.

يطبع --code الكود وحده، بلا أي شرح:

الطرفية
apfel --code "one find command that lists files larger than 100MB in my home folder"
find /Users/yourusername/home -type f -size +100M

الخيارات صحيحة، لكن النموذج اختلق مجلدًا. مجلدك الرئيسي هو ~ (أي: find ~ -type f -size +100M).

الطرفية
apfel --code "a python function that removes duplicates from a list but keeps the order"
def remove_duplicates_preserve_order(lst):
    seen = set()
    result = []
    for item in lst:
        if item not in seen:
            seen.add(item)
            result.append(item)
    return result

اقرأ كل أمر قبل تشغيله. في اختباراتنا أنتج النموذج أوامر خاطئة أيضًا. حين طلبنا "the 10 largest files in the current folder" (أكبر 10 ملفات في المجلد الحالي)، طبع ls -lh | head -n 10، وهو يعرض أول 10 عناصر لا أكبرها. وحين طلبنا "show open ports" (اعرض المنافذ المفتوحة)، اقترح netstat -tuln | grep LISTEN، وهو يستخدم خيارات Linux؛ أما على macOS فلا يطبع شيئًا على الإطلاق. على Mac، يعرضها الأمر lsof -iTCP -sTCP:LISTEN -n -P.

التالي: سكربت العرض cmd في المهمة 6 يغلّف هذا كله ويسألك قبل أن يشغّل أي شيء (-x) أو ينسخ الأمر (-c).

5. احصل على JSON تثق به سكربتاتك

خلال 2 دقيقة يصبح لديك: بيانات منظمة مستخرجة من نص فوضوي، بصيغة JSON تطابق مخططك دائمًا.

عندما أحتاج إلى أسماء أو أرقام أو تواريخ من رسائل البريد والملاحظات، أريد حقولًا لا نصًا نثريًا، لكي أمررها إلى jq أو جدول بيانات أو سكربت.

احفظ مخطط JSON Schema باسم contact.schema.json:

JSON
{
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "city": { "type": "string" },
    "phone": { "type": "string" }
  },
  "required": ["name", "city", "phone"]
}

ثم مرّر النص مع --schema. يقيّد apfel النموذج بحيث تكون المخرجات JSON صالحًا لهذا المخطط:

الطرفية
echo "Hi, I am Maria Lopez from Vienna, call me on +43 660 1234567" | apfel --schema contact.schema.json "Extract the contact" | jq .
{
  "name": "Maria Lopez",
  "city": "Vienna",
  "phone": "+43 660 1234567"
}

تعود المفاتيح بالترتيب الذي يعلنه مخططك.

ولأي رد بصيغة JSON مع بيانات وصفية، استخدم -o json:

الطرفية
apfel -o json "Translate to German: apple" | jq -r .content
Apfel

ولقائمة كاملة، استخدم --batch: سطر JSON واحد لكل سجل في المدخلات، وسطر نتيجة واحد لكل سجل في المخرجات، وكل سجل في جلسة جديدة. إليك ثلاث مراجعات لمنتج في ملف نصي:

الطرفية
cat reviews.txt
Love it, works offline and it is fast.
Crashes every time I open a PDF.
It is okay, it does the job.
jq -Rc '{custom_id: (input_line_number|tostring), prompt: ("Classify the sentiment of this review as positive, negative or neutral. Reply with one word. Review: " + .)}' reviews.txt | apfel --batch | jq -r '"\(.custom_id) \(.status) \(.content)"'
1 ok Positive
2 ok Negative
3 ok Neutral
apfel: batch: 3 records, 3 ok, 0 failed

يحوّل jq -R كل سطر إلى سجل؛ والسطر الأخير هو ملخص apfel على stderr. السجل الذي يفشل يحصل على status: "error" وتستمر الدفعة.

إن لم ينجح الأمر: يدعم apfel جزءًا من JSON Schema (الكائنات، والسلاسل النصية، وقوائم enum، والأرقام، والقيم المنطقية، والمصفوفات، و$ref المحلي). الكلمة المفتاحية غير المدعومة مثل pattern توقف التنفيذ برمز الخروج 2 وتذكر اسمها؛ والقائمة الكاملة في وثيقة التوافق مع API.

6. أتمت يومك: git والصوت وسكربتات جاهزة

خلال 2 دقيقة يصبح لديك: ملخص لعملك الأخير، وجهاز Mac يخبرك بصوت مسموع حين تنتهي مهمة طويلة، وثمانية سكربتات shell جاهزة تعمل بالذكاء الاصطناعي.

عندما أنتقل بين المهام أو أنتظر انتهاء البناء (build)، أريد أتمتة صغيرة تشرح الأمور وتعلن عنها، لكي أكفّ عن مراقبة الطرفية.

لخّص ما أنجزته، من داخل أي مستودع git:

الطرفية
git log --oneline -10 | apfel "summarize what I have been working on, two sentences"
I've been updating star counts to 6,608 and refining ISO datetimes with timezone handling in the Article JSON-LD. Additionally, I've implemented the apfel AI tutorial and redesigned the pre-header with a centered line about the project.

اجعل جهاز Mac يتكلم حين ينتهي شيء ما. مرّر الرد إلى say، وضع أمرك الطويل قبله مع &&:

الطرفية
apfel "tell me cheerfully that my build just finished, one short sentence, no emoji" | say

لم يكن لجهاز الاختبار مخرج صوت، لذا سجّلنا الكلام في ملف بدلًا من ذلك (| say -o build-done.aiff، أي 102,880 بايت من الصوت). والجملة التي نطقها كانت Your build is finished, and I'm glad you asked!.

ويأتي apfel أيضًا مع ثمانية سكربتات عرض. اكتبها في مجلد:

الطرفية
apfel --demos
apfel: wrote 9 demo files to /Users/arthurficial/work/apfel-i18n-video-2026-11-15/tut/apfel-demos
  • cmd
  • explain
  • gitsum
  • mac-narrator
  • naming
  • oneliner
  • port
  • wtd

وهذا واحد أعجبنا أثناء الاختبار:

الطرفية
./apfel-demos/naming "function that retries HTTP requests with exponential backoff"
retryExponentialBackoff | exponential_retry_backoff | exponential delay retry  
retryWithExponentialBackoff | exponential_retry_http_backoff | HTTP retry with delay  
backoffRetryHTTP | exponential_http_retry | retry with exponential pause

لم تكن كل العروض جيدة في تجاربنا: oneliner "count unique IP addresses in access.log" اصطدم بحد الطول وطبع أمرًا معطوبًا، وexplain أضاف رسالة خطأ لا وجود لها. ويسرد ملف README للعروض السكربتات الثمانية كلها.

7. شغّل كود OpenAI الخاص بك مجانًا

خلال 2 دقيقة يصبح لديك: خادم محلي يتحدث OpenAI Chat Completions API، فيعمل كود SDK الحالي على جهاز Mac لديك بدلًا من نموذج سحابي مدفوع.

عندما أبني نموذجًا أوليًا باستخدام OpenAI SDK، أريد نقطة نهاية محلية مجانية، لكي أبني وأختبر بلا مفاتيح ولا فواتير ولا إرسال بيانات إلى الخارج.

شغّل الخادم في تبويب طرفية:

الطرفية
apfel --serve
apfel server v1.18.0
├ endpoint: http://127.0.0.1:11434
├ model:    apple-foundationmodel
├ cors:     disabled
├ origin:   localhost only (http://127.0.0.1, http://localhost, http://[::1])
├ token:    none
├ health:   public
├ max concurrent: 5
├ debug:    off
└ ready

Endpoints:
  POST http://127.0.0.1:11434/v1/chat/completions
  GET  http://127.0.0.1:11434/v1/models
  GET  http://127.0.0.1:11434/health

2026-11-15T13:39:31+0100 info Hummingbird: [HummingbirdCore] Server started and listening on 127.0.0.1:11434

وفي تبويب ثانٍ، استدعِه كما تستدعي OpenAI:

الطرفية
curl -s http://localhost:11434/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"apple-foundationmodel","messages":[{"role":"user","content":"Say hello to my terminal in five words."}]}' | jq -r '.choices[0].message.content'
Hello, terminal.

تعمل مكتبة OpenAI Python SDK الرسمية دون أي تغيير. لا يختلف سوى عنوان URL الأساسي واسم النموذج. احفظ الكود باسم hello.py:

Python
from openai import OpenAI

client = OpenAI(base_url="http://localhost:11434/v1", api_key="unused")
reply = client.chat.completions.create(
    model="apple-foundationmodel",
    messages=[{"role": "user", "content": "Give me three names for a coffee shop run by robots."}],
)
print(reply.choices[0].message.content)
الطرفية
python3 -m venv venv && ./venv/bin/pip -q install openai
./venv/bin/python hello.py
1. RoboBrew  
2. CogCafé  
3. Circuit Sip

لا يستمع الخادم إلا على جهاز Mac لديك (127.0.0.1)، ويرفض الطلبات القادمة من صفحات ويب ذات أصول أخرى. ولفتحه على شبكتك، أضف token: apfel --serve --host 0.0.0.0 --token-auto (دليل أمان الخادم).

إن لم ينجح الأمر: Connection refused يعني أن الخادم لا يعمل. أما التضمينات (embeddings) ونقطة النهاية القديمة /v1/completions فتعيد HTTP 501، لأن النموذج المحلي لا يوفّرها.

التالي: يوثّق القائمون على apfel طرق الإعداد مع VS Code Copilot (المحادثة فقط)، وopencode، وZed، وNode.js وRuby وPHP وست لغات أخرى. لم نُعِد اختبار هذه الإعدادات لهذه الصفحة.

8. امنحه أدوات عبر MCP

خلال 2 دقيقة يصبح لديك: النموذج يقرأ صفحة ويب حية ويلخصها، عبر أداة Model Context Protocol.

عندما تكون الإجابة في صفحة ويب، أريد أن يجلبها النموذج بنفسه، لكي أحصل على ملخص دون نسخ النصوص هنا وهناك.

ثبّت أدوات apfel-mcp، المصممة لتناسب نافذة السياق الصغيرة:

الطرفية
brew install Arthur-Ficial/tap/apfel-mcp

أرفق واحدة منها باستخدام --mcp واطرح سؤالك. يُخفي -q المخرجات الخام للأداة:

الطرفية
apfel -q --mcp $(which apfel-mcp-url-fetch) "Summarize https://apfel.franzai.com/ in 3 bullets"
- **Purpose**: apfel is a Swift 6.3 tool that wraps Apple’s on-device LLM (part of macOS 26’s Apple Intelligence) and exposes it via a CLI, HTTP server, and interactive chat with context management.  
- **Features**: It handles terminal commands, JSON output, file attachments, real token counting, and context trimming (4,096 or 8,192 tokens depending on hardware), while converting OpenAI tool schemas to Apple’s native format.  
- **Technical details**: Built using the FoundationModels framework, it runs on Apple Silicon’s Neural Engine and GPU without network or cloud dependencies, and is open-source under MIT license.

وتضم الحزمة نفسها apfel-mcp-ddg-search (بحث في الويب)، وapfel-mcp-search-and-fetch، وapfel-mcp-fs (قراءة ملف محلي). ويعمل أي خادم MCP: مسار سكربت محلي أو عنوان https://.

وتعمل أيضًا الأدوات ذات المعاملات المسمّاة المتعددة. إليك الآلة الحاسبة من مستودع apfel (mcp/calculator/server.py): يستدعي النموذج multiply مع المعاملين كليهما، فيشغّلها apfel ويجيب النموذج بالنتيجة:

الطرفية
apfel --mcp ./server.py "What is 15 times 27?"
mcp: /Users/arthurficial/work/apfel-i18n-video-2026-11-15/tut/./server.py - add, subtract, multiply, divide, sqrt, power, round_number
tool: multiply({"a": 15, "b": 27}) = 405
15 times 27 is 405.

السطر tool: هو apfel يعرض لك الاستدعاء الذي نفّذه. قبل apfel 1.18.0 لم يكن النموذج يرى أسماء المعاملات فيخمّنها، لذا كان استدعاء كهذا يفشل (المشكلة #555، وأُصلحت في طلب الدمج #556). إذا رأيت invalid arguments هنا، فحدّث باستخدام brew upgrade apfel.

9. دردش معه لتجرّب prompt

خلال 2 دقيقة يصبح لديك: محادثة في الطرفية تتذكر ما قلته سابقًا.

عندما أصوغ prompt لسكربت، أريد تجربة بضع جولات بسرعة، لكي أرى كيف يتفاعل النموذج قبل أن أؤتمته.

الطرفية
apfel --chat
Apple Intelligence · on-device LLM · apfel v1.18.0
────────────────────────────────────────────────────────
Type 'quit' to exit.

you› My name is Franz. I live in Vienna.
 ai› Hello, Franz. It's nice to meet you. I'm here to help with any questions or tasks you might have. How can I assist you today?

you› Suggest one thing I could do there this weekend. One sentence.
 ai› You could visit the Kunsthistorisches Museum to explore its impressive collection of art and artifacts.

you› What is my name?
 ai› Your name is Franz.

you› quit

Goodbye.

أضف شخصية باستخدام -s، مثل apfel --chat -s "You are a patient Python tutor". وحين تتجاوز محادثة طويلة نافذة السياق، يحذف apfel أقدم الجولات افتراضيًا؛ ويشرح دليل السياق الاستراتيجيات الأخرى. وإن أردت نافذة بأزرار، فانظر apfel-chat.

10. أبقِ الخادم يعمل في الخلفية

خلال 2 دقيقة يصبح لديك: الخادم المتوافق مع OpenAI يبدأ تلقائيًا عند تسجيل الدخول، وجاهز دائمًا على المنفذ 11434.

عندما تستخدم الأدوات على جهاز Mac لديك نقطة النهاية المحلية كل يوم، أريد أن تكون متاحة دائمًا، لكي أتوقف عن تشغيلها يدويًا.

الطرفية
brew services start apfel
==> Successfully started `apfel` (label: sh.brew.apfel)
curl -s http://127.0.0.1:11434/health | jq -c '{status, model_available, context_window}'
{"status":"ok","model_available":true,"context_window":4096}
brew services stop apfel
Stopping `apfel`... (might take a while)
==> Successfully stopped `apfel` (label: sh.brew.apfel)

الإعدادات مثل المنفذ أو الـ token أو خوادم MCP هي متغيرات بيئة، مثل APFEL_PORT=8080 brew services start apfel. وتجدها كلها في دليل خدمة الخلفية.

11. تطبيقات مبنية على apfel

خلال 2 دقيقة يصبح لديك: النموذج المحلي نفسه في نافذة، أو في شريط القوائم، أو خلف اختصار لوحة مفاتيح، إن كنت تفضّل التطبيقات على الطرفية.

تأتي هذه التطبيقات من القائمين على apfel أنفسهم (راجع "apfel tree" في README). تحققنا في 15 نوفمبر 2026 من أن اسم التثبيت لكل منها موجود في Homebrew؛ لكننا لم نختبر التطبيقات لهذه الصفحة.

التطبيق ما يفعله التثبيت
apfel-chat تطبيق محادثة بردود متدفقة، وكلام، وتحليل صور brew install Arthur-Ficial/tap/apfel-chat
apfel-clip إجراءات من شريط القوائم على الحافظة: تلخيص، وترجمة، وإعادة صياغة brew install Arthur-Ficial/tap/apfel-clip
apfel-quick اضغط مفتاحًا، واسأل، واحصل على الإجابة، ثم أغلقها brew install Arthur-Ficial/tap/apfel-quick
apfelpad مفكرة يكون فيها الذكاء الاصطناعي صيغة تضعها في خلية brew install Arthur-Ficial/tap/apfelpad
apfel-mcp أدوات MCP بحجم يناسب النافذة الصغيرة (المهمة 8) brew install Arthur-Ficial/tap/apfel-mcp
apfel-run apfel مع إعدادات محفوظة وقائمة بخوادم MCP brew install Arthur-Ficial/tap/apfel-run
apfel-tag وسوم ومواضيع ومشاعر لأي نص تمرره إليه brew install Arthur-Ficial/tap/apfel-tag
apfel-gui نافذة تصحيح أخطاء: الطلبات، ورسائل MCP، والكلام brew install Arthur-Ficial/tap/apfel-gui

الحدود وإجابات صريحة

يمنحك apfel نموذج Apple المحلي. ويقدّر README حجمه بنحو 3 مليارات معامل، أي أصغر بكثير من النماذج السحابية التي تقف خلف ChatGPT أو Claude. وهو جيد في مهام النصوص القصيرة والمركّزة. وهذه هي الحدود التي اصطدمنا بها أو التي تذكرها الوثائق.

نافذة السياق صغيرة. يجب أن يتسع السؤال والإجابة معًا في 4,096 توكن على macOS 26 وعلى أجهزة Mac بشريحة M1 وM2، أو في 8,192 توكن على أجهزة Mac بشريحة M3 أو أحدث مع ذاكرة 12 GB أو أكثر تعمل بنظام macOS 27 (README). يعرض apfel --model-info النافذة على جهازك. حتى ملف README الخاص بـ apfel أطول من أن يتسع فيها. احسب قبل أن ترسل:

الطرفية
apfel --count-tokens -f README.md "summarize in 3 bullets"
8272/3584 tokens (over budget)
  prompt=7, README.md=8258
apfel -f README.md "summarize in 3 bullets"; echo "exit code: $?"
error: [context overflow] Input exceeds the model's context window: the input is 8264 tokens, the window is 4096 tokens. Shorten the conversation history.
exit code: 4

الرقم 3,584 هو نافذة 4,096 مطروحًا منها 512 توكن محجوزة للإجابة. يحتوي README على نحو 3,000 كلمة، لكن Markdown والكود يستهلكان توكنات كثيرة لكل كلمة. أدخِل الملفات الطويلة على أجزاء (head -c 6000 file)، قسمًا تلو الآخر.

لا يعرف تاريخ اليوم. بل اختلق تاريخًا:

الطرفية
apfel "What is today's date?"
Today's date is October 27, 2024.
apfel -s "Today is $(date '+%B %d, %Y')." "What is today's date? One sentence."
Today's date is November 15, 2026.

أعطه في الـ prompt أي معلومة يحتاج إليها. لا وصول له إلى الإنترنت ما لم ترفق أداة MCP.

يخطئ أحيانًا، وبكل ثقة. رأيت ذلك أعلاه: أوامر shell خاطئة في المهمة 4، وترجمة قلبت المعنى في المهمة 2. تحقق من كل ما يهمك.

قد يحظر مرشح الأمان لدى Apple نصًا غير ضار. حينها يتوقف apfel برمز الخروج 3 والرسالة The request was blocked by Apple's safety guardrails. أعد الصياغة، أو أضف --permissive للكتابة الإبداعية والمستندات؛ وتشرح وثيقة الحواجز الأمنية ما الذي يغيّره. لم نصادف أي حظر في التجارب الخاصة بهذه الصفحة.

تختلف الإجابات في كل تشغيل. هذه مخرجات حقيقية من تشغيل واحد لكل أمر، وستأتي إجاباتك بصياغة مختلفة. استخدم --temperature 0 لإجابات أكثر ثباتًا؛ لا يعد apfel بمخرجات متطابقة بين مرات التشغيل أو تحديثات macOS (سياسة الاستقرار).

السرعة: معظم الإجابات في تجاربنا عادت خلال 1 إلى 2 ثانية. واستغرق تلخيص صفحة الويب 8 ثوانٍ باستخدام أداة MCP.

المتطلبات صارمة: Apple Silicon فقط، وmacOS 26 أو أحدث، وApple Intelligence مفعّل، وإحدى اللغات الـ 15 التي يسردها --model-info. لا يمكن تشغيله على أجهزة Mac بمعالجات Intel.

حين يفشل شيء ما

يبلّغ apfel عن المشكلات برمز خروج، لكي تتمكن السكربتات من التصرف. تحقق منه باستخدام echo $? مباشرة بعد الأمر.

رمز الخروج أو الخطأ المعنى ما العمل
2 خيار أو معامل خاطئ تأتي الخيارات قبل الـ prompt؛ ويسردها apfel --help
3 مرشح الأمان لدى Apple حظر الطلب أعد الصياغة، أو أضف --permissive
4 المدخلات أطول من نافذة السياق أرسل نصًا أقل؛ وتحقق باستخدام apfel --count-tokens
5 النموذج غير متاح فعّل Apple Intelligence، وانتظر اكتمال التنزيل، ووحّد لغة Mac ولغة Siri
6 النموذج مشغول أو بلغ حد معدل الطلبات انتظر وأعد التشغيل، أو أضف --retry
Connection refused لا يوجد خادم على المنفذ 11434 شغّل apfel --serve أو brew services start apfel
HTTP 501 نقطة نهاية لا يوفّرها النموذج المحلي (embeddings، /v1/completions) استخدم /v1/chat/completions
piped input was empty كتب الأمر إلى stderr command 2>&1 \| apfel "..."

ما زلت عالقًا؟ ابحث أو افتح مشكلة (issue) على GitHub.

من صنع هذا وكيف اختُبر

apfel مجاني ومفتوح المصدر (رخصة MIT)، وهو مشروع من franzai أنشأه Franz Enzenhofer. ويُطوَّر بمشاركة Arthur Ficial، المساعد الذكي لـ Franz، الذي كتب هذا الدرس أيضًا. ولأن صانعي apfel هم من كتبوا هذه الصفحة، فقد ذكرنا كل إخفاق رأيناه بدل أن نحذفه.

كيف اختبرنا: في 15 نوفمبر 2026 شغّلنا كل أمر في هذه الصفحة على MacBook Air M2 (24 GB) بنظام macOS 27.0.1 (رقم البناء 26A434). استخدمنا الملف التنفيذي الموقّع لـ apfel 1.18.0 من إصدار GitHub (وهو الملف نفسه الذي يثبّته Homebrew tap)، داخل جلسة طرفية حقيقية، ونسخنا المخرجات دون تغيير. أظهرت النسخة الأولى من هذه الصفحة (14 نوفمبر 2026، apfel 1.16.0) خلل الأدوات متعددة المعاملات في المهمة 8؛ وقد أصلحه الإصدار 1.18.0، لذا أعدنا تشغيل كل أمر لهذه النسخة. وحيث كانت المخرجات الأولى خاطئة، أبقينا المخرجات الخاطئة في الصفحة وأشرنا إلى ذلك. ولم نُعِد التشغيل إلا للعثور على إجابات لا تحتاج إلى أي تعديل: أحد ملخصات صفحة الويب احتوى على شرطة طويلة لا يطبعها هذا الموقع، فأعدنا تشغيله واحتفظنا بالتشغيل الثالث. وتحققنا من مثال الكلام بكتابة الصوت في ملف، لأن جهاز الاختبار لم يكن فيه مخرج صوت. أما سكربتات العرض فقد كتبها apfel --demos من apfel 1.18.0.

ما كتبه الآخرون عن apfel: منشور Show HN (3 أبريل 2026، 743 نقطة)، ودليل من Better Stack، ومقال في GIGAZINE، ومراجعة عملية على danilchenko.dev.

المصادر: ملف README لـ apfel، ومرجع CLI، ودليل التثبيت، وسكربتات العرض، وapfel مقابل fm من Apple، ومتتبّع المشكلات، وقد قرأناها في 15 نوفمبر 2026.