README_ar.md

WitNote

Smart Core, Simple Form
Everything is a file
🌐 Official Website

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Español | Français | Deutsch | Italiano | Português | Русский | العربية | हिन्दी | বাংলা | Türkçe | Polski | Nederlands | Bahasa Indonesia

🎉 متوفر الآن على متجر تطبيقات ماك (Mac App Store)!

وصل WitNote رسميًا إلى متجر تطبيقات ماك. شكراً لدعمكم! نجمتكم ⭐️ هي أكبر حافز لنا للمضي قدماً!

WitNote هو رفيق كتابة ذكي محلي أولاً لأنظمة macOS و Windows و Linux. يدعم التبديل الحر بين محركات Ollama / WebLLM / Cloud API، مقترناً بواجهة بطاقات أصلية فائقة البساطة، يعمل مباشرة بعد التثبيت. لا اعتماد مستمر على السحابة، لا مخاوف بشأن الخصوصية — الذكاء أصبح خفيفاً.

---

🌟 الفلسفة الأساسية

• ذكي (Smart): ثلاثة محركات في واحد، حرية الاختيار.
  • WebLLM: نموذج خفيف الوزن، يتطلب التنزيل عند التشغيل الأول، ثم يعمل دون اتصال بالإنترنت.
  • Ollama: نموذج محلي قوي، أداء قوي، دون اتصال بالكامل.
  • Cloud API: اتصل بذكاء السحابة، إمكانيات لا حصر لها.
• بسيط (Simple): لا تعقيد.
  • إدارة البطاقات بأسلوب iOS، السحب للتنظيم.
  • وضع التركيز الذكي — تضيق النافذة، ويبسط المحرر.
• آمن (Secure): سيادة البيانات.
  • سياسة الخصوصية: تخزين محلي بنسبة 100%. أفكارك ملك لك وحدك.

---

✨ المميزات (v1.3.3)

🆕 ما الجديد في v1.3.3

• 🪟 واجهة الزجاج المصنفر — تصميم مرئي جديد تماماً، تأثير الزجاج المصنفر الحديث في كل مكان
• 📐 تخطيط مرن بثلاث لوحات — يمكن تغيير حجم الشريط الجانبي والمحرر ولوحة الذكاء الاصطناعي وإغلاقها بشكل مستقل
• ✋ السحب والتحرير في لوحتين — في العرض المنقسم، اسحب الفاصل بحرية لضبط نسبة المحرر/المعانية
• 📂 شجرة ملفات بأسلوب Finder — علامات ملونة، السحب للنقل، التمرير للتوسيع، قائمة سياق مطورة بالكامل
• 📄 دعم متعدد التنسيقات — تمت إضافة معاينة PDF/Word، ويدعم تنسيقات الصور الشائعة
  • قابل للتحرير: .md .txt
  • معاينة للقراءة فقط: .pdf .docx
  • عارض الصور: .jpg .png .gif .webp
• 🚀 بدء تشغيل أسرع — شاشة ترحيب محسنة، تقليل وقت انتظار الشاشة البيضاء بشكل كبير
• 🔒 إصدار متجر التطبيقات — متوافق تماماً مع معايير أمان Apple Sandbox، الآن على متجر تطبيقات ماك

🔧 الميزات الأساسية

• 📝 ملاحظات محلية نقية — اختر أي مجلد كخزنة ملاحظاتك، يدعم .txt و .md
• 🤖 محرك ثلاثة في واحد — بدّل بحرية بين WebLLM (خفيف)، Ollama (قوة محلية)، أو Cloud API (اتصال مخصص)
• ✨ الإكمال التلقائي الذكي — 3 إعدادات مسبقة (خفيف/قياسي/كامل)، اضغط Tab لقبول الاقتراحات جملة بجملة
• 🎭 مكتبة أدوار غنية — أكثر من 10 موجهات أدوار مختارة مدمجة (كاتب، مترجم، ملمع، إلخ)، تبديل بنقرة واحدة ودعم مخصص
• 🌍 تواصل عالمي — يدعم 8 لغات:
  • English, 简体中文, 繁體中文, 日本語, 한국어, Français, Deutsch, Español
  • تتكيف الواجهة واستجابات الذكاء الاصطناعي تلقائياً مع لغتك
• 🔒 الخصوصية أولاً — يتم تنفيذ جميع استدلالات الذكاء الاصطناعي محلياً (عند استخدام المحركات المحلية)، لا تحميل للبيانات، موثق من Apple
• 💬 قابل للتخصيص للغاية — حرر موجهات النظام بحرية لإنشاء مساعد الذكاء الاصطناعي الخاص بك
• 🎨 سمات متعددة — فاتح / داكن / شاي الزن، وضع داكن محسن بالكامل
• 🗂️ عرض شبكة البطاقات — أسلوب iOS مع فرز السحب والإفلات، قوائم سياق مصقولة
• 🔍 مدرك للسياق — يمكن للذكاء الاصطناعي قراءة مقالتك الحالية أو محتوى المجلد مباشرة
• 🎯 وضع التركيز — يتحول تلقائياً إلى تحرير خالٍ من التشتت عندما تضيق النافذة

---

🚀 البدء السريع

التنزيل

🍎 متجر تطبيقات ماك (موصى به)

📦 إصدارات غيت هاب (GitHub Releases)

نزّل أحدث مثبت من Releases:

المنصة	الملف	ملاحظة
🍎 macOS	WitNote-1.3.3.dmg	فقط Apple Silicon (M1/M2/M3/M4/M5)
🪟 Windows (x64)	WitNote-1.3.3-setup-x64.exe	كمبيوتر قياسي (Intel/AMD)
🪟 Windows (ARM64)	WitNote-1.3.3-setup-arm64.exe	كمبيوترات Snapdragon (مثل Surface Pro X)
🐧 Linux (AppImage)	WitNote-1.3.3-x86_64.AppImage	x64 عالمي (متاح ARM64)
📦 Linux (Deb)	WitNote-1.3.3-amd64.deb	Ubuntu/Debian x64 (متاح ARM64)

---

💻 متطلبات النظام

🍎 macOS

العنصر	الحد الأدنى	الموصى به
إصدار النظام	macOS 12.0+	macOS 13.0+
الشريحة	غير مدعوم (شرائح Intel)	Apple Silicon (M1/M2/M3/M4/M5)
الرام	-	16GB+
التخزين	-	SSD, 4GB+ مساحة حرة

❌ ملاحظة مهمة لأجهزة ماك بمعالجات Intel:

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

1. عدم توافق البنية: تعتمد محركات الاستدلال المحلي المدمجة (WebLLM/Ollama) بشكل عميق على بنية ARM64 وتسريع الأجهزة NPU/Metal في Apple Silicon.
2. نقص تسريع الأجهزة: تفتقر أجهزة Intel Mac إلى بنية الذاكرة الموحدة. تشغيل النماذج المكممة بطيء للغاية (قد يستغرق إنشاء رمز واحد ثوانٍ) ويسبب ارتفاعاً شديداً في حرارة الجهاز.
3. المقايضة المعمارية: لضمان أفضل تجربة وأقل حجم للحزمة، قمنا بإزالة الدعم لبنية x86_64.

نوصي بشدة باستخدام أجهزة ماك المزودة بشرائح Apple Silicon (سلسلة M).

🪟 Windows

العنصر	الحد الأدنى	الموصى به
إصدار النظام	Windows 10 (64-bit)	Windows 11
المعالج	Intel Core i5 / AMD Ryzen 5	Intel Core i7 / AMD Ryzen 7
الرام	8GB	16GB+
التخزين	2GB مساحة حرة	SSD, 4GB+ مساحة حرة
GPU	رسومات مدمجة	GPU منفصل مع دعم Vulkan

⚠️ ملاحظة: أجهزة Windows ARM64 (مثل Surface Pro X) مدعومة الآن بشكل أصلي!

🐧 Linux

العنصر	الحد الأدنى	الموصى به
إصدار النظام	Ubuntu 20.04+ / Debian 11+	أحدث التوزيعات السائدة
البنية	x64 / ARM64	x64 / ARM64
الرام	8GB	16GB+

---

📦 التثبيت

🍎 تثبيت macOS

الطريقة 1: متجر تطبيقات ماك (موصى به)

ابحث عن "WitNote" في متجر التطبيقات أو انقر هنا للتنزيل والتثبيت، والاستمتاع بالتحديثات التلقائية.

الطريقة 2: مثبت DMG

1. قم بتنزيل ملف .dmg
2. انقر نقراً مزدوجاً لفتح DMG
3. اسحب التطبيق إلى مجلد التطبيقات
4. شغّله من التطبيقات

🎉 أخبار رائعة!

هذا التطبيق الآن موثق من Apple (Notarized)! لا مزيد من تحذيرات "مطور غير مؤكد"!

😅 المطور أخذ قرضاً بشجاعة لدفع ثمن حساب Apple Developer البالغ 99 دولاراً... (نعم، هذا حدث بالفعل. شكراً لجميع المستخدمين لدعمهم!)

🪟 تثبيت Windows

1. قم بتنزيل مثبت .exe
2. شغّل معالج الإعداد
3. اختر مسار التثبيت (قابل للتخصيص)
4. أكمل التثبيت، شغّل من سطح المكتب أو قائمة ابدأ

🐧 تثبيت Linux

AppImage (عالمي):

1. قم بتنزيل ملف .AppImage
2. انقر بزر الماوس الأيمن خصائص -> السماح بتنفيذ الملف كبرنامج (أو chmod +x WitNote*.AppImage)
3. انقر نقراً مزدوجاً للتشغيل

Deb (Ubuntu/Debian):

1. قم بتنزيل ملف .deb (مثل WitNote-1.3.3-amd64.deb)
2. شغّل التثبيت عبر الترمينال (يعالج التبعيات تلقائياً):

   sudo apt install ./WitNote-1.3.3-amd64.deb

📝 ملاحظات مهمة لمستخدمي Windows:

كمطور فردي بدون شهادة توقيع كود EV باهظة الثمن، قد تواجه ما يلي:

1. SmartScreen: إذا رأيت "قام Windows بحماية جهاز الكمبيوتر الخاص بك" (ناشر غير معروف)، يرجى النقر فوق "مزيد من المعلومات" -> "تشغيل على أي حال".
2. تحذير مضاد الفيروسات: قد يقوم Windows Defender أو برامج مكافحة الفيروسات الأخرى بوضع علامة على المثبت. المشروع مفتوح المصدر وآمن. إذا تم حظره، يرجى محاولة تعطيل مضاد الفيروسات مؤقتاً.

---

🔧 معلومات محرك الذكاء الاصطناعي

1. WebLLM (خفيف)

يتضمن التطبيق محرك WebLLM مدمجاً مع نموذج qwen2.5:0.5b (لنظام macOS فقط، يوصى لمستخدمي Windows باستخدام Ollama).

• الإيجابيات: لا حاجة لتثبيت برامج إضافية، يعمل بالكامل دون اتصال بالإنترنت بعد تنزيل النموذج الأولي.
• الأفضل لـ: الأسئلة والأجوبة السريعة، تلميع النصوص البسيط، الأجهزة منخفضة المواصفات.

2. Ollama (قوة محلية)

يدعم الاتصال بخدمة Ollama التي تعمل محلياً.

• الإيجابيات: يشغل نماذج 7B أو 14B أو حتى أكبر، أداء قوي، دون اتصال بالكامل.
• الاستخدام: قم بتثبيت Ollama أولاً، ثم قم بتنزيل المزيد من النماذج في الإعدادات (مثل qwen2.5:7b, llama3, إلخ).

3. Cloud API (سحابة بلا حدود)

يدعم الاتصال بواجهات برمجة التطبيقات السحابية المتوافقة مع OpenAI.

• الإيجابيات: الوصول إلى أقوى النماذج على وجه الأرض باستخدام مفتاح API فقط.
• الأفضل لـ: التفكير المنطقي عالي المستوى، أو عندما لا تتمكن الأجهزة المحلية من دعم النماذج الكبيرة.
• التكوين: أدخل عنوان URL لـ API والمفتاح في الإعدادات (يدعم OpenAI, Gemini, DeepSeek, Moonshot, إلخ).

---

📸 لقطات الشاشة

📐 محرر ذو لوحين

🤖 ثلاثة محركات ذكاء اصطناعي

✨ إكمال تلقائي ذكي

🎭 شخصية مخصصة

📄 دعم متعدد التنسيقات

🎯 وضع التركيز

🎨 سمات متعددة

🗂️ إدارة ملفات البطاقات

---

🛠️ التطوير

# استنساخ المستودع
git clone https://github.com/hooosberg/WitNote.git
cd WitNote

# تثبيت التبعيات
npm install

# بدء خادم التطوير
npm run dev

# بناء إصدار macOS
npm run build

# بناء إصدار Windows
npm run build -- --win

---

📄 الترخيص

MIT License

---

👨‍💻 المطور

hooosberg

📧 zikedece@proton.me

🔗 https://github.com/hooosberg/WitNote

📖 مذكرات التطوير

---

Smart Core, Simple Form
Everything is a file