شرح EasyRead: ترجمة وقراءة وملاحظات على أبحاث PDF بالإنجليزية محلياً

شنو هو EasyRead

EasyRead هو أداة محلية موجهة لقراية المقالات العلمية بالإنجليزية. يقدر يستورد ملفات PDF، ويولّد فالخلفية ترجمة بالصينية صفحة بصفحة، مع الحفاظ قدر الإمكان على المعادلات والجداول والمراجع وبنية المقال الأصلي. الصفحات اللي سالات ترجمتها كتقدر تقراها دغيا، والصفحات الأخرى كيبانو مؤقتاً بحال فالنسخة الأصلية، يعني ما خاصكش تسنى حتى تسالي معالجة المقال كامل.

عوض ما تعطي ملف PDF كامل لأداة ترجمة عادية، EasyRead كيشبه أكثر لورشة كاملة لقراية المقالات العلمية: النص الرئيسي كيعرض ترجمة وفية، وشرح وأجوبة الذكاء الاصطناعي كيتحطّو فالجانب باش يبقى الفرق واضح بين المعنى الأصلي ديال المقال والمحتوى اللي زادو النموذج. الخدمة كتسمع غير فالجهاز المحلي، والمقالات والترجمات والملاحظات وسجل المحادثات كاملين كيبقاو محفوظين فالحاسوب ديالك.

الوظائف الأساسية

تنسيق صيني مناسب للقراية الطويلة

EasyRead كيستعمل تنسيق صيني للنص الرئيسي، وكيعاود يرتب المعادلات باستعمال KaTeX، وكيحوّل الجداول لجداول بثلاثة خطوط، مع الاحتفاظ بالنص الأصلي ديال المراجع. الواجهة كتدعم الوضع الداكن، وكتناسب القراية المتواصلة للمواد الأكاديمية الطويلة.

راجع النص الإنجليزي الأصلي فكل وقت

وأنت كتقرا، تقدر تبدّل لوضع المقارنة باش يبان النص الإنجليزي تحت كل فقرة صينية. ومن الجهة اليمنى تقدر تفتح الصفحة الأصلية ديال PDF؛ الصفحة كتبدّل مع موضع القراية الحالي، وكتحدد الفقرة الحالية فمكانها فالصفحة الأصلية، باش تسهّل مراجعة المعادلات والمصطلحات والسياق.

أسئلة وأجوبة بالذكاء الاصطناعي واقتباس عدة فقرات

لوحة «سول AI» فالجهة اليمنى كتدعم المحادثة بشكل متدفق. تقدر تجر فقرة أو أكثر لخانة الإدخال وتسول، أو تخلي النموذج يحلل المحتوى اعتماداً على التسطير بلون معيّن. EasyRead كيسمح بإنشاء عدة محادثات، واختيار Claude أو GPT أو DeepSeek أو Tongyi أو Ollama المحلي لكل محادثة بوحدها. والأجوبة اللي بغيتي تحتافظ بها تقدر تحطها بنقرة وحدة حدّ الفقرات المعنية.

التسطير والملاحظات ومراجعة الترجمة

• من بعد ما تختار النص، استعمل قلم التمييز بأربعة ألوان أو التسطير.
• زيد ملاحظة للمحتوى المختار أو طرح عليه سؤال.
• خلي AI يجاوب على السؤال أو يعلّق على ملاحظة مكتوبة من قبل.
• جمّع الملاحظات حسب ترتيب النص الأصلي، واختار جزءاً منها وصدّرو بصيغة Markdown.
• دير نقرتين على الفقرة باش تعدّل الترجمة مباشرة.
• بدّل ترجمة المصطلح فمسرد المصطلحات وطبّق التغيير على النص كامل.

باش يتفادى ضياع البيانات، كل تعديل كيتخزن أولاً فالمتصفح، وما كيتحيدش السجل المؤقت حتى كتأكد الخدمة المحلية من الكتابة فالملف. إلا وقع من بعد تعارض بين نتيجة الترجمة والتعديل اليدوي، EasyRead كينبّهك للتغيير وما كيغطّيش مباشرة على المحتوى ديالك.

مكتبة المراجع وتقدم القراية

مكتبة المراجع كتدعم التصنيف والتثبيت والبحث والتمييز بالنجمة، وحالات ما تقراش، كتقرا، وتقريت. تقدر تجر المقالات لتصنيفات كتديرها بنفسك، ومنين كتحذفها كتمشي أولاً لسلة المهملات. وتقدر حتى تنسخ الاقتباس بصيغ GB/T 7714 أو APA أو BibTeX، وتشوف تقدم القراية ديال كل مقال.

اختيار نموذج الترجمة

فأول استعمال، حلّ «الإعدادات» من الفوق على اليمين واختار محرك الترجمة. EasyRead كيدعم هاد الأنواع ديال الحلول:

• Claude Code: الحل اللي كيوصي به README. خاصك تثبّت Claude Code وتسجّل الدخول، وما كيتطلبش تزيد API Key، وتقدر تستعمل الرصيد ديال الاشتراك وتشوف صورة الصفحة الأصلية لمراجعة المعادلات.
• Codex CLI: من بعد تثبيت Codex وتسجيل الدخول، تقدر تشغلو بحساب ChatGPT بلا ما تزيد API Key.
• واجهات API المحلية: كيدعم DeepSeek و智谱 و阿里云百炼 وKimi و硅基流动 و魔搭، وكيحتاج API Key ديال المنصة المعنية.
• واجهات API الخارجية: كيدعم OpenAI وAnthropic وGemini وOpenRouter وGroq وCerebras، وكيحتاج API Key؛ جودة الاتصال كتتعلق بمزود الخدمة.
• النموذج المحلي: تقدر تربطو بـ Ollama أو LM Studio باش يخدم أوفلاين بالكامل. README كيوصي باستعمال qwen3.5:9b، وإذا كانت ذاكرة كارت الشاشة قليلة تقدر تجرب نسخة 4b.
• واجهة مخصصة: تقدر تعمّر أي عنوان متوافق مع OpenAI وKey، مع دعم صيغتي Chat Completions وResponses.

من بعد الإعداد، كليك على «جرّب ترجمة جملة» باش تتأكد واش النموذج خدام. صفحة الإعدادات كتفحص أوتوماتيكياً الأدوات المرتبطة اللي مثبتة فالجهاز. إلا ما بغيتيش الترجمة تبدا مباشرة من بعد الاستيراد، سدّ خيار «بدا الترجمة أوتوماتيكياً من بعد الاستيراد»، ومن بعد عالج الملفات يدوياً أو خلي agent فالمحادثة ينفذ الترجمة.

تثبيت EasyRead

الخيار الأول: استعمال حزمة سطح المكتب

هاد الطريقة هي الأسهل وما كتحتاجش تثبيت Python. سير لـ EasyRead Releases وحمّل الملف المناسب للنظام ديالك.

• Windows: حمّل EasyRead-Setup-x.x.x.exe ودير عليه نقرتين للتثبيت. إلا بان «Windows حمى حاسوبك»، اختار «معلومات إضافية»، ومن بعد كليك على «شغّل رغم ذلك».
• macOS: الأجهزة اللي فيها شريحة Apple تحمّل EasyRead-x.x.x-arm64.dmg وجرّ التطبيق لـ «التطبيقات». فالأول، إلا بان إشعار بأنه ما قدرش يتحقق من المطور، سير لـ «إعدادات النظام → الخصوصية والأمان» واختار «فتح رغم ذلك».
• Linux: حمّل EasyRead-x.x.x.AppImage، زيد ليه صلاحية التنفيذ ومن بعد شغلو.

chmod +x EasyRead-x.x.x.AppImage
./EasyRead-x.x.x.AppImage

بيانات النسخة المثبتة كاينة فمجلد EasyRead داخل مجلد المستخدم ديال النظام. حذف البرنامج أو إعادة تثبيتو ما كيمسحش أوتوماتيكياً المقالات والإعدادات.

الخيار الثاني: التشغيل من المصدر

طريقة المصدر كتحتاج Python 3.10 أو إصدار أحدث. تقدر تحمّل أرشيف المصدر ديال آخر إصدار وتفك الضغط عليه، أو تستنسخ المستودع.

git clone https://github.com/Edwardxlai/easyread.git
cd easyread

مستعملو Windows يقدرو يديرو نقرتين على start.cmd. فالتشغيل الأول غادي يتثبت الإعداد أوتوماتيكياً، ومن بعد يكفي تدير نقرتين مرة أخرى. مستعملو macOS أو Linux يشغلو الأمر التالي من مجلد المشروع:

./start.sh

إلى شغلتو بالسكريبت، من بعد ما تسد جميع صفحات EasyRead فالمتصفح، الخدمة فالخلفية كتخرج غالباً من بعد شي عشرات ديال الثواني. إلا كانت شي ترجمة مازال خدامة، الخدمة كتسنى حتى تسالي المهمة.

الخيار الثالث: استعمال pip

تقدر حتى تثبت حزمة Python مباشرة من GitHub:

pip install git+https://github.com/Edwardxlai/easyread
easyread

من بعد التشغيل، المتصفح غادي يحل http://127.0.0.1:8765. الخدمة كتسمع غير فالعنوان المحلي، وبيانات نسخة pip كتتحفظ افتراضياً فـ ~/EasyRead.

أول استيراد وترجمة للمقال

1. حلّ «الإعدادات» من الفوق على اليمين، واختار محرك الترجمة وضبطو.
2. استعمل «جرّب ترجمة جملة» باش تتأكد من الحساب أو API Key أو الاتصال بالنموذج المحلي.
3. جرّ ملف PDF للنافذة، أو لسّق رقم arXiv أو عنوان المقال أو DOI أو الرابط المباشر ديال PDF أو رابط صفحة مقال مدعوم.
4. بالنسبة للمقالات الطويلة، تقدر تختار «ترجمة النص الرئيسي فقط»، أو تحدد مجال الترجمة باستعمال «صفحات محددة».
5. تسنى المعالجة فالخلفية صفحة بصفحة. المحتوى اللي سالات ترجمتو كيبان مباشرة بالصينية، والصفحات اللي مازال ما تترجمات كيبقاو كيعرضو صفحة PDF الأصلية.

زيادة على arXiv، EasyRead يقدر يحاول يقلب على PDF عمومي فمصادر بحال OpenReview وACL وNeurIPS وbioRxiv وPMC وصفحات المجلات، ويكمّل أسماء المؤلفين والسنة والمصدر. صفحة مكتبة المراجع كتدعم حتى اللصق المباشر بالاختصار Ctrl+V لرقم أو رابط.

طريقة القراية والتعليق الأساسية

1. حلّ المقال اللي استوردتي، وبدا القراية من الصفحات اللي سالات ترجمتها.
2. إلا بغيتي تراجع المعنى الأصلي، بدّل لوضع المقارنة أو حلّ صفحة PDF الأصلية من الجهة اليمنى.
3. كليك على الفقرة باش تبان شريط الأدوات؛ ومن بعد اختار النص وزيد التمييز أو التسطير أو ملاحظة.
4. جرّ الفقرات المهمة لخانة «سول AI»، وطلب من النموذج يشرح المفاهيم أو يقارن الطرق أو يرتب العلاقة بين المعادلات.
5. حفظ الأجوبة المفيدة حدّ الفقرات المناسبة.
6. فملخص الملاحظات، اختار المحتوى اللي محتاج وصدّرو بصيغة Markdown، ومن بعد دخلو لـ Obsidian أو Notion.

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

معالجة فشل الترجمة

النموذج يقدر يفشل فبعض الصفحات بسبب تحديد المعدل أو الشبكة أو الرصيد. EasyRead كيعيد المحاولة أوتوماتيكياً؛ وإذا بقات العملية فاشلة، كيتجاوز الصفحة وكيكمّل ترجمة الصفحات اللي من بعدها. من بعد ما تسالي المعالجة، تقدر تشوف سبب الفشل ورقم الصفحة فقسم «الترجمة» على يمين المقال، ومن بعد كليك على «عاود المحاولة للصفحات الفاشلة».

«سجل الترجمة» كيعرض التفاصيل ديال كل دفعة مهام، و«سجل التشغيل» اللي فالأسفل ديال الإعدادات كيتستعمل لفحص الخدمة المحلية. إلا سالا رصيد Claude Code، تقدر تسنى حتى يرجع الرصيد وتحاول من جديد، أو تبدّل مؤقتاً لـ API أو Ollama؛ الصفحات اللي تترجمات من قبل ما غاديش تعاود تترجم بسبب هاد التغيير.

استعمال سطر الأوامر وAI agent

EasyRead فيه واجهة لسطر الأوامر، وagents بحال Claude Code وCodex يقدرو يقراو الأسئلة والملاحظات فمكتبة المراجع، ويكتبو الأجوبة حدّ الفقرات المعنية، وحتى يترجمو أو يعاودو ترجمة صفحات محددة. شرح المهارات كاين فالمستودع فـ skill/paper-reading/SKILL.md، وتقدر تحط هاد المجلد فـ ~/.claude/skills/ أو ~/.codex/skills/.

easyread list
easyread import 论文.pdf
easyread status ID
easyread discuss ID --from 回答.json
easyread export ID

• easyread list: عرض مكتبة المراجع المحلية.
• easyread import: استيراد PDF أو رقم arXiv أو رابط مقال.
• easyread status ID: عرض التقدم والترجمات المعدلة يدوياً والملاحظات والأسئلة اللي مازال خاصها جواب.
• easyread discuss ID --from 回答.json: كتابة نتيجة النقاش فالهامش ديال صفحات المقال.
• easyread export ID: تصدير HTML أوفلاين فملف واحد.

باش تشوف أوامر أخرى، شغّل easyread --help.

نصائح متقدمة

تصدير مقال أوفلاين قابل للمشاركة

فمكتبة المراجع، دير كليك بالزر اليمين على المقال واختار «تصدير HTML أوفلاين»، وغادي تحصل على صفحة فملف واحد كتتحل مباشرة فالمتصفح. الترجمة والمعادلات وصور الصفحات الأصلية والتسطير والملاحظات كاملين كيدخلو فالملف، والطرف الآخر ما كيحتاجش يثبت EasyRead.

التسطير والملاحظات الجديدة فالصفحة الأوفلاين كيتحفظو غير فالمتصفح اللي تحلات فيه. إلا بغيتي تدمجهم من جديد فمكتبة المراجع الرئيسية، صدّر JSON ديال التعديلات من «التعليمات» فالصفحة الأوفلاين، ومن بعد نفذ:

easyread merge ID --from 导出.json

إلا بغيتي تنشر المقال فمواقع بحال GitHub Pages، تقدر تولّد مجلد عرض فيه الصور مفصولة والتحميل عند الطلب:

easyread demo ID --out 目录

نسخ احتياطي ومزامنة البيانات

إلا كنت كتستعمل طريقة المصدر، البيانات كاينة فمجلد library/ داخل المشروع؛ ومن بعد تثبيت pip كاينة فـ ~/EasyRead/library/. كل مقال عندو مجلد مستقل فيه PDF الأصلي وصور الصفحات الأصلية والترجمة والملاحظات ونقاشات AI وملفات JSON ديال سجل المحادثات وغيرها. الإعدادات وتفضيلات الواجهة محفوظين بشكل منفصل فـ config.json وprefs.json، وتقدر تدير نسخ احتياطي أو مزامنة لهاد الملفات مباشرة.

التحكم فالتكلفة وتبديل النماذج

EasyRead كيسجّل كل ترجمة وكل جواب ديال الذكاء الاصطناعي شحال استهلك من الـ token. ملي كتستعمل اشتراك Claude، تقدر حتى تشوف الاستعمال ديال الحصة ديال 5 سوايع و7 أيام، ووقت إعادة التعيين. فالاستخدام الفعلي، تقدر تخلي الموديلات عالية الجودة تتكلف بالأوراق المهمة، وتستعمل للمواد العادية API منخفض التكلفة ولا Ollama خدام فالحاسوب ديالك.

تبديل الموديل ما غاديش يعاود يعالج الصفحات اللي تترجمات بنجاح. تقدر تخلي النتائج الحالية، ومن بعد تعاود غير الصفحات اللي فشلات ولا الأجزاء اللي بغيتي تحسّنها يدوياً.

بناء نسخة سطح المكتب للمطورين

نسخة Electron ديال سطح المكتب كتعاود تستعمل نفس خدمة Python المحلية ونفس واجهة الويب. بيئة التطوير كتحتاج Node.js 22 ولا أحدث، وPython 3.10 ولا أحدث، وزيد عليهم PyInstaller.

npm install
python -m pip install pyinstaller
npm run dev

باش تولّد حزمة تثبيت قابلة للتوزيع، شغّل:

npm run dist

نتائج البناء كاينة فـ dist/electron/، وWindows كيخرّج برنامج تثبيت NSIS، وmacOS كيخرّج DMG، وLinux كيخرّج AppImage.

الخلاصة

EasyRead كيجمع ترجمة الأوراق العلمية، ومراجعة النص الأصلي، والأسئلة والأجوبة بالذكاء الاصطناعي، والتعليقات التوضيحية، وتدبير المراجع فمسار عمل محلي واحد. أسهل طريقة باش تبدا هي تنزّل حزمة التثبيت، وتكوّن موديل خدام، ومن بعد تجرّ ملف PDF وتبدا القراية. ومن بعد، باستعمال قاموس المصطلحات، وسطر الأوامر، والتصدير بلا إنترنت، والموديلات المحلية، تقدر تبني مكتبة شخصية ديال الأوراق العلمية كتوازن بين الخصوصية، والتكلفة، ونجاعة القراية.

المشروع مرخّص برخصة MIT. تقدر تمشي لـ مستودع GitHub باش تشوف الكود المصدري، ولا تفتح العرض التجريبي على الإنترنت وتجرب تجربة القراية.