# Exporter للوكلاء

خمس مهارات تعلّم الوكيل التصدير والنسخ الاحتياطي والبحث باستخدام Exporter.

## المهارات الخمس

يثبّت الأمر أعلاه المهارات الخمس كلها باستخدام [skills CLI](https://github.com/vercel-labs/skills) من [فهرس المهارات](https://exporter.dev/.well-known/skills/index.json) في هذا الموقع. أو احفظ أي ملف SKILL.md أدناه في مجلد المهارات لدى وكيلك.

- [export-apple-notes](https://exporter.dev/.well-known/skills/export-apple-notes/SKILL.md): تصدير ملاحظات Apple إلى ملفات Markdown أو HTML باستخدام `exporter`، وقراءة ملخص JSON. (`.well-known/skills/export-apple-notes/SKILL.md`)
- [apple-notes-to-obsidian](https://exporter.dev/.well-known/skills/apple-notes-to-obsidian/SKILL.md): وضع ملاحظات Apple في مجلد داخل خزنة Obsidian وإبقاؤها متزامنة، بأمان. (`.well-known/skills/apple-notes-to-obsidian/SKILL.md`)
- [backup-apple-notes](https://exporter.dev/.well-known/skills/backup-apple-notes/SKILL.md): نسخة مطابقة كل ليلة، أو لقطات مؤرَّخة، أو خطوة تسبق أداة النسخ الاحتياطي، وتحقّق من أن آخرها قد اكتمل. (`.well-known/skills/backup-apple-notes/SKILL.md`)
- [notes-as-claude-context](https://exporter.dev/.well-known/skills/notes-as-claude-context/SKILL.md): البحث في الملاحظات وجهات الاتصال والمحادثات وقراءتها عبر خادم MCP المحلي. (`.well-known/skills/notes-as-claude-context/SKILL.md`)
- [export-messages](https://exporter.dev/.well-known/skills/export-messages/SKILL.md): محادثات iMessage إلى Markdown، ملف لكل محادثة، مع المرفقات. (`.well-known/skills/export-messages/SKILL.md`)

## ما يستطيع الوكيل فعله

- التصدير: `exporter sync --source apple --json --quiet` إلى مجلد التصدير في التطبيق، أو `exporter export --dest <folder>` إلى أي مجلد منحه الشخص في بطاقة سطر الأوامر.
- النسخ الاحتياطي وفق جدول: يطبع `exporter help cron` أسطر crontab بالمسار الحقيقي: نسخة مطابقة تتبع التعديلات، أو لقطات مؤرَّخة لا تتغير أبدًا.
- قراءة النتيجة: `--json` مع sync وexport وlist وstatus وlog. رموز الخروج: 0 نجاح، 1 إخفاقات في التصدير، 2 يحتاج إلى إعداد، 64 خطأ في الاستخدام.
- البحث كسياق: عبر MCP: `search` و`read` و`list` و`get_recent` و`get_stats` و`get_metadata` على الصادرات. [الأدوات الست](https://exporter.dev/docs/mcp).
- معرفة الحالة: يعرض `exporter status --json` كل مصدر، وآخر تصدير له، وفئته المجانية والعدد المستخدم منها. ويحصي `exporter list sources --json` ما هو موجود.
- معرفة الحصة: التشغيل الذي يتجاوز الحصة المجانية يخرج مع ذلك بالرمز 0 ويطبع سطر `note:` يسمّي ما تم تخطيه. ويفتح الشخص قفل ذلك التطبيق مرة واحدة، داخل Exporter.

## الإعداد

يُجري الشخص أول خطوتين، لأن التطبيق معزول (sandbox). ويتولى الوكيل الباقي.

1. يثبّت الشخص التطبيق: Exporter من Mac App Store، ويُفتح مرة واحدة. ربط تطبيق واختيار مجلد التصدير الخاص به لا يتمّان إلا داخل التطبيق.
2. يلصق الشخص سطرًا واحدًا: في بطاقة سطر الأوامر في التطبيق، «نسخ أمر التثبيت»، ثم لصقه مرة واحدة في Terminal. التطبيق المعزول لا يستطيع الكتابة في PATH بنفسه. ويطبع `exporter help install` السطر الخاص بذلك الجهاز.
3. يتعلم الوكيل المهارات: يثبّت `npx skills add https://exporter.dev` المهارات الخمس أعلاه من فهرس المهارات في هذا الموقع.
4. يتحقق الوكيل ويشغّل: يقول `exporter doctor` ما الذي ينقص، مع سطر `fix:` تحت كل فشل. ثم يصدّر `exporter sync --json --quiet` ويطبع ملخص JSON واحدًا.
5. يقرأ الوكيل كسياق: بعد تشغيل خادم MCP من بطاقته في التطبيق، يربط `claude mcp add --transport http exporter http://localhost:8744/mcp` تطبيق Claude Code بالصادرات.

## أسئلة

### ما الذي لا يستطيع الوكيل فعله؟

ربط تطبيق، أو اختيار مجلد تصدير، أو منح مجلد، أو تشغيل خادم MCP، أو شراء فتح قفل. هذه تتم داخل التطبيق، على يد شخص. ولا يطرح سطر الأوامر أي سؤال أبدًا: الخطوة الناقصة توقف التشغيل برمز الخروج 2 وسطر واحد يقول ما يجب فعله.

### هل يستطيع الوكيل دفع ثمن فتح القفل؟

لا. يُفتح قفل كل تطبيق بشراء لمرة واحدة داخل التطبيق يجريه شخص داخل Exporter. لا يوجد دفع عبر الويب، ولا مفتاح ترخيص، ولا دفع من الوكيل. أخبر الشخص، والتشغيل التالي يلتقط فتح القفل.

### أي الوكلاء يمكنهم استخدامه؟

أي شيء يشغّل أوامر shell يستطيع قيادة `exporter`. وأي شيء يتحدث MCP عبر HTTP يستطيع الاتصال بالخادم: Claude Code بأمر واحد، وCursor وVS Code من أزرار بطاقة خادم MCP في التطبيق، وClaude Desktop عبر إدخال `mcp-remote` منسوخ.

### ما مدى خصوصيته؟

يعمل سطر الأوامر والخادم على جهاز Mac لدى الشخص ويقرآن صادراته هناك، والخادم يستمع على 127.0.0.1 فقط. وتطلب المهارات من الوكيل أن يذكر الأعداد والمسارات، وألا يقتبس من الملاحظات أو الرسائل إلا حين يطلب الشخص ذلك. [الخصوصية](https://exporter.dev/privacy).

## Related

- [CLI](https://exporter.dev/docs/cli): Every command, flag and exit code
- [MCP server](https://exporter.dev/docs/mcp): Connect Claude and other agents
- [Apple Notes in Claude](https://exporter.dev/guides/notes/apple-notes-in-claude): Claude searches your notes, on your Mac

---

human version: https://exporter.dev/ar/agents
every page: https://exporter.dev/llms.txt
