دليل إضافة Obsidian (نسخة تجريبية)

على غرار إضافة VS Code، تقدم إضافة Obsidian الخاصة بنا ميزة التعرف الضوئي على الحروف (OCR) المدركة للسياق، مما يتيح أداءً أكثر دقة مع تكامل سلس بين تطبيق WriteTex و Obsidian.

تحذير: الإضافة قيد التطوير المكثف ولا تقدم أي ضمانات. استخدمها على مسؤوليتك الخاصة. راجع LICENSE. حاليًا، يجب أن يكون لديك تكوين API فعال من مزود خارجي (مثل OpenAI) لاستخدام الإضافة.

المميزات

• رفيق لتطبيق WriteTex: يربط تطبيق WriteTex للهاتف المحمول بسلاسة بمحرر Obsidian لسطح المكتب.
• إدراك السياق: يرسل النص المحيط بالمؤشر تلقائيًا إلى الذكاء الاصطناعي، مما يحسن الدقة من خلال فهم أسلوب المستند الحالي والمتغيرات.
• إدراج مباشر: يتم إدراج الكود الناتج فورًا عند المؤشر.

التثبيت

1. قم بتنزيل أحدث إصدار من مستودع GitHub الخاص بنا.
2. ضع ملفي main.js و manifest.json في دليل الإضافات الخاص بـ vault الخاص بك: <VAULT>/.obsidian/plugins/writetex-obsidian/.
3. افتح إعدادات Obsidian -> Community Plugins وقم بتمكين WriteTex.

لا تحتاج إلى تثبيت إصدار سطح المكتب من WriteTex لاستخدام إضافة Obsidian. مطلوب فقط تطبيق الهاتف المحمول على جهاز iPad/الجهاز اللوحي الخاص بك.

التكوين

هذا الجزء مشابه لإعدادات المنصات الأخرى. يظهر مثال بسيط أدناه:

الإعداد	القيمة
نقطة نهاية API	https://api.openai.com/v1
النموذج	gpt-5
مفتاح API	sk-...

تعليمات مخصصة (Custom Instructions)
بعض المطالبات الإضافية لتوجيه نموذج الذكاء الاصطناعي. على سبيل المثال، يمكنك إضافة "استخدم \mathbb{i} للوحدة التخيلية".

الاستخدام

1. بدء الخادم:

   • يبدأ الخادم تلقائيًا عند تحميل Obsidian.
   • تحقق من شريط الحالة في أسفل اليمين: يجب أن يظهر "WriteTex: On".
   • إذا كان يظهر "Off"، افتح لوحة الأوامر (Cmd/Ctrl + P) وقم بتشغيل "WriteTex: Start Server".

2. توصيل العميل (مثل تطبيق iOS):

   • افتح تطبيق WriteTex على هاتفك.
   • تأكد من أن هاتفك وجهاز الكمبيوتر الخاص بك على نفس شبكة Wi-Fi.
   • يجب أن يكتشف التطبيق تلقائيًا "WriteTex Obsidian @ [YourHostname]".
   • إذا فشل الاكتشاف التلقائي، أدخل عنوان IP لجهاز الكمبيوتر الخاص بك يدويًا.

بالنسبة للمنصات الأخرى (Windows، Android، MacOS)، اتبع الدليل في VS Code.

3. إدراج معادلة مكتوبة بخط اليد باستخدام WriteTex:
   • ضع المؤشر في ملاحظة Obsidian حيث تريد أن يظهر الكود.
   • استخدم تطبيق الهاتف المحمول لكتابة معادلة رياضية.
   • ستتلقى الإضافة الصورة، وتحللها مع سياق ملاحظتك الحالية، وتدرج نتيجة LaTeX/Markdown مباشرة في المحرر الخاص بك.

استكشاف الأخطاء وإصلاحها

• الخادم لا يبدأ: تحقق مما إذا كان المنفذ 50905 مستخدمًا من قبل تطبيق آخر. إذا قمت بتمكين خادم WriteTex في إضافة VS Code، فيرجى تعطيله قبل تشغيل Obsidian.
• تطبيق الهاتف المحمول لا يمكنه الاتصال:
  • تأكد من أن كلا الجهازين على نفس شبكة Wi-Fi.
  • تحقق من إعدادات جدار الحماية بجهاز الكمبيوتر الخاص بك للسماح بالاتصالات الواردة على المنفذ 50905.
  • قد تمنع بعض الشبكات المدرسية أو شبكات الشركات الاتصالات بين الأجهزة. في هذه الحالة، يمكنك محاولة استخدام VPN أو نقطة اتصال.
• خطأ "Unauthorized": تأكد من أن تطبيق العميل يرسل مفتاح API writetex.