إضافة Visual Studio Code (بيتا)

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

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

الميزات

تقدم إضافة VSCode لـ WriteTex نتيجة OCR أكثر دقة من خلال تزويد نموذج الذكاء الاصطناعي بسياق المستند الحالي. يمكن للمستخدم ببساطة الكتابة على جهاز iPad/الجهاز اللوحي الخاص به، وسيتم وضع النتائج عند المؤشر في VSCode. يتم بناء السياق من الأسطر الموجودة ضمن نصف قطر معين من المؤشر.

التثبيت

تحذير: قم بتثبيت الإضافة فقط إذا كان جهازك خلف جدار حماية. قم بتمكين الإضافة فقط في شبكة موثوقة. لا تقم بالتثبيت على خادم.

• لمستخدمي Microsoft Visual Studio Code: ابحث في صفحة الإضافات عن "WriteTex" أو قم بالتثبيت من VS Code Marketplace.
• لمستخدمي نسخ VSCode (Cursor, Trae, Antigravity, Kiro, Qoder, Void, VSCodium, Windsurf, Codex إلخ): حاول البحث عن "WriteTex" في صفحة الإضافات الخاصة بنسختك. إذا لم يتم العثور عليها، فقم بتنزيل ملف .vsix الخاص بنا من صفحة الإصدارات وقم بتثبيته يدويًا عبر الإضافات -> النقاط الثلاث في أعلى اليمين -> التثبيت من VSIX.

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

تكوين الإعدادات

بمجرد التثبيت، ستظهر أيقونتنا في الشريط الجانبي الخاص بك. انقر عليها لتكوين الإعدادات.

تكوين AI API

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

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

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

السياق

• نصف قطر أسطر السياق (Context Line Radius) هنا يمكنك التحكم في نصف قطر السياق. الرقم 10 يعني أن السياق يتم بناؤه من 10 أسطر قبل و 10 أسطر بعد المؤشر.
• حد أحرف السياق (Context Char limit) الحد الأقصى لعدد الأحرف في السياق. الرقم 1000 يعني أن السياق محدود بـ 1000 حرف.

إدارة الخدمة

يتم الإشارة إلى حالة الخادم في الأعلى. يمكنك بدء/إيقاف الخادم بالنقر فوق الأزرار المقابلة. ابدأ الخادم ليتمكن تطبيق الهاتف المحمول الخاص بـ WriteTex من الاتصال بمثيل VSCode هذا. يمكن تشغيل خادم واحد فقط في كل مرة. إذا بدأت الخادم في مثيل واحد من VSCode، فيجب عليك إيقافه قبل بدئه في مثيل آخر.

الاتصال بالإضافة

تأكد من تمكين الإضافة وتشغيل الخادم. تأكد من أن مشروعًا واحدًا فقط لديه خادم الإضافة قيد التشغيل.

من iPhone/iPad

تأكد من تمكين الإضافة وتشغيل الخادم. على جهاز iOS الخاص بك، انتقل إلى إعدادات AI API -> إضافة VSCode. قم بتفعيل استخدام VSCode (Use VSCode)، وابحث عن اسم جهازك في قائمة الاكتشاف وحدده. إذا لم يكن جهازك مدرجًا، فجرب الاتصال اليدوي عن طريق إدخال عنوان IP الخاص بجهاز الكمبيوتر الخاص بك في أخرى... (Other...).

لإصدارات تطبيق iOS قبل v2.1: احصل على عنوان IP لجهاز الكمبيوتر الذي يقوم بتشغيل إضافة VSCode. انتقل إلى مدير المهام وانقر فوق شبكتك، وابحث عن عنوان IPv4. في الإعدادات، اضبط AI API على:

الإعداد	القيمة
نقطة نهاية API	http://ip-جهاز-الكمبيوتر:50905/v1
النموذج	النموذج الخاص بك
مفتاح API	writetex

من Android

احصل على عنوان IP لجهاز الكمبيوتر الذي يقوم بتشغيل إضافة VSCode. انتقل إلى مدير المهام وانقر فوق شبكتك، وابحث عن عنوان IPv4. في الإعدادات، اضبط AI API على:

الإعداد	القيمة
نقطة نهاية API	http://ip-جهاز-الكمبيوتر:50905
النموذج	النموذج الخاص بك
مفتاح API	writetex

من Windows/MacOS

في الإعدادات، اضبط AI API على:

الإعداد	القيمة
نقطة نهاية API	http://127.0.0.1:50905
النموذج	النموذج الخاص بك
مفتاح API	writetex

الاستخدام

1. افتح مستندًا بأنواع امتدادات الملفات المدعومة: .tex .latex .markdown .md .rmd .qmd .ipynb
2. ضع المؤشر في المستند
3. قم بتوصيل جهاز iPad/الجهاز اللوحي الخاص بك بإضافة VS Code
4. ابدأ الكتابة، وستظهر نتائج OCR في VS Code عند موضع المؤشر

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

قائمة التحقق العامة

• إضافة VS Code مفعلة
• خادم يعمل في نافذة VS Code مفتوحة واحدة فقط
• تم وضع المؤشر في محرر مفتوح بأحد أنواع امتدادات الملفات هذه: .tex .latex .markdown .md .rmd .qmd .ipynb
• جهاز iPad/الجهاز اللوحي الخاص بك متصل بنفس الشبكة التي يتصل بها جهاز الكمبيوتر الخاص بك
• يسمح جدار الحماية الخاص بجهاز الكمبيوتر الخاص بك بالاتصالات الواردة
• لا تمنع شبكتك الاتصال بين الأجهزة
• إذا كنت تستخدم إضافة Obsidian على سطح المكتب، فتأكد من إغلاق obsidian. يُسمح بمثيل واحد فقط من إضافة WriteTex في محرر نصوص.

تظهر النتائج على iPad ولكن ليس في VS Code

تأكد من وضع المؤشر في VS Code. تحقق مما إذا كان لديك نافذة VS Code أخرى مفتوحة مع تشغيل خادم الإضافة. إذا كان الأمر كذلك، فقم بإغلاقها.

لا يمكن العثور على جهازك في قائمة الاكتشاف على iPad

تحقق مما إذا كان جهاز iPad/الجهاز اللوحي الخاص بك متصلاً بنفس الشبكة التي يتصل بها جهاز الكمبيوتر الخاص بك.

إذا كان جهازك لا يزال غير مدرج، فجرب الاتصال اليدوي عن طريق إدخال عنوان IP لجهاز الكمبيوتر الخاص بك في أخرى... (Other...).