> termcourse: اقرأ وانشر على منصات Discourse من الطرفية

[merefield (Robert)]

هذا تطبيق طرفية (TUI)، مجرد تسلية… وفي هذه المرحلة لا يزال تجريبيًا!

	ملخص	واجهة مستخدم طرفية لتصفح ونشر المشاركات في منتديات Discourse مع قوائم المواضيع، وعرض المواضيع بالكامل، والردود، والإعجابات، والبحث، ومُنشئ مدمج.
	رابط المستودع	GitHub - merefield/termcourse: A terminal based client to access Discourse instances, supporting API keys, username/password (and with MFA token)
	دليل التثبيت	ملف README.md في المستودع (قسم البدء السريع)
	الرعاية	يُرجى التفكير في أن تصبح راعياً مستمراً لعملي في المصادر المفتوحة (Sponsor @merefield on GitHub Sponsors · GitHub) بمستوى يناسب مواردك أو موارد مؤسستك واحتياجاتك لضمان حصول هذا المشروع على الصيانة التي يستحقها واستمراره في العمل لموقعك في المستقبل.

هل تستمتع بـ termcourse؟ يُرجى عمل له على GitHub

نظرة عامة

\u003e termcourse هو عميل قائم على الطرفية لـ Discourse. يتصرف مثل جلسة متصفح خفيفة الوزن مع تسجيل دخول قائم على ملفات تعريف الارتباط (اسم المستخدم/البريد الإلكتروني + كلمة المرور) ويدعم المصادقة متعددة العوامل (TOTP/رموز النسخ الاحتياطي). يوجد أيضًا خيار احتياطي لمفتاح واجهة برمجة التطبيقات (API key) للمواقع المقيدة أو التي تستخدم تسجيل الدخول الموحد فقط.

الميزات

• تصفح قوائم المواضيع “الأحدث” / “الشائعة” / “الجديدة” / “غير المقروءة” / “الأعلى”، مع التبديل بين فترات “الأعلى”.
• فتح المواضيع عبر الأسهم + Enter، أو اختصارات لوحة المفاتيح الرقمية (1-0) لأول 10 مواضيع مرئية.
• عرض المواضيع بالكامل مع مشاركات قابلة للتمرير، ورأس/تذييل ثابتين، وشريط تقدم/موضع المشاركة.
• توسيع المشاركات المحددة إلى المحتوى الكامل؛ المشاركات غير المحددة تعرض مقتطفات مضغوطة.
• الرد على المواضيع بأكملها أو مشاركات محددة.
• إنشاء مواضيع جديدة مع العنوان، ومحدد الفئة، ومُنشئ نص مضمن.
• الإعجاب/إلغاء الإعجاب بالمشاركات مع حالة مرئية لقلب الإعجاب لكل مشاركة.
• البحث في المشاركات والانتقال مباشرة إلى سياق الموضوع/المشاركة المطابق.
• يدعم المُنشئ المضمن حركة المؤشر، والإدراج، والأسطر الجديدة، والمسافة للخلف، وعداد الحد الأدنى للطول المباشر.
• عرض يدعم إدراك ترميز Markdown، بما في ذلك الروابط الملتفة ودعم معاينة الصور المضمنة (chafa / viu).
• استبدال الرموز التعبيرية لرموز :emoji: الشائعة والوجوه المبتسمة من نوع :)-style.
• دعم بيانات اعتماد مواقع متعددة عبر متغيرات البيئة + ملف credentials.yml لكل مضيف (مع مطالبة للحقول المفقودة لتسجيل الدخول).
• تسجيل دخول باسم المستخدم/كلمة المرور بجلسة ملفات تعريف الارتباط مع دعم المصادقة متعددة العوامل (TOTP + رمز النسخ الاحتياطي)، بالإضافة إلى خيار احتياطي لمفتاح واجهة برمجة التطبيقات.
• تصميم قائم على YAML مع مدمجات (افتراضي، رمادي، ساحة المعركة) وتجاوزات محلية عبر theme.yml.
• إعادة رسم تغيير الحجم بشكل تفاعلي مع فاصل زمني للاستقصاء قابل للتكوين (TERMCOURSE_TICK_MS).
• تسجيل اختياري لتشخيصات HTTP/المصادقة وعرض واجهة المستخدم.

البدء السريع

راجع أحدث README لمزيد من المعلومات

git clone https://github.com/merefield/termcourse
cd termcourse
bundle install

اسم المستخدم/كلمة المرور (موصى به)

bundle exec bin/termcourse your.discourse.host

خيار احتياطي لمفتاح واجهة برمجة التطبيقات

DISCOURSE_API_KEY=“your_key” DISCOURSE_API_USERNAME=“your_username” \
bundle exec bin/termcourse your.discourse.host

ملاحظات المصادقة

• يستخدم تسجيل الدخول باسم المستخدم/كلمة المرور جلسة متصفح عادية.
• المصادقة متعددة العوامل مدعومة لـ TOTP ورموز النسخ الاحتياطي.
• مفاتيح واجهة برمجة التطبيقات مدعومة كخيار احتياطي.

الأمان

• لا يتم تخزين بيانات الاعتماد؛ ملفات تعريف الارتباط في الذاكرة فقط.
• تتجنب متغيرات البيئة أو الرد على المطالبة المقدمة كلمات المرور في سجل الأوامر (shell history).
• التسجيل اختياري ومعطل افتراضيًا.

القيود

• بعض المواقع غير متوافقة مع اسم المستخدم/كلمة المرور لأنها تمنع تدفقات تسجيل الدخول عن بعد المبرمجة.
• يعيش في الطرفية

شكر وتقدير

مستوحى جزئيًا من Dumbcourse – Old-browser friendly UI at /dumb (D-pad + small screens)

[merefield (Robert)]

حتى تتمكن من تسجيل الدخول بسرعة إلى مواقع متعددة (جلسة واحدة في كل علامة تبويب بالطبع)، أجريت التحسينات التالية:

تحسينات المصادقة والإعدادات لـ termcourse

• أصبح اسم المستخدم/كلمة المرور هو مسار تسجيل الدخول الافتراضي.
• لم تعد بحاجة إلى تضمين https:// - هذا اختياري
• تتم المطالبة بالحقول المفقودة لتسجيل الدخول بشكل تفاعلي (على سبيل المثال: اسم المستخدم معروف، كلمة المرور مفقودة).
• تتضمن مساعدة واجهة سطر الأوامر (CLI) متغيرات البيئة الأساسية ومواقع ملفات سجل التصحيح.

بيانات الاعتماد وسلوك متغيرات البيئة (ENV)

• يدعم ملف بيانات اعتماد مُعيَّن حسب المضيف مع ترتيب البحث:
  1. TERMCOURSE_CREDENTIALS_FILE (إذا تم تعيينه)
  2. ./credentials.yml
  3. ~/.config/termcourse/credentials.yml
• أسبقية المصادقة:
  1. علامات واجهة سطر الأوامر (CLI flags)
  2. بيانات اعتماد المضيف من ملف YAML
  3. متغيرات البيئة العامة DISCOURSE_*
  4. مطالبة تفاعلية
• للمصادقة: تتم المطالبة بقيم اسم المستخدم/كلمة المرور المفقودة لتسجيل الدخول.
• لمصادقة واجهة برمجة التطبيقات (API)، يجب أن يؤدي كل من اسم مستخدم واجهة برمجة التطبيقات والمفتاح إلى قيم غير فارغة.

تصحيح الأخطاء (Debugging)

• تصحيح أخطاء HTTP/المصادقة: TERMCOURSE_HTTP_DEBUG=1 → /tmp/termcourse_http_debug.txt
• تصحيح أخطاء عرض واجهة المستخدم (UI): TERMCOURSE_DEBUG=1 → /tmp/termcourse_debug.txt

نظافة المستودع (Repo hygiene)

• تمت إضافة credentials.example.yml و .env.example مع أمثلة متطابقة.
• تمت إضافة إدخالات .gitignore لملفات الأسرار المحلية:
  • .env
  • credentials.yml

[merefield (Robert)]

هذا منخفض الجودة إلى حد ما ولكنه يعمل.

تحتاج إلى تثبيت viu أو chafa - وهذا بحد ذاته يمكن أن يكون مشروعًا

في وضع الجودة العالية على chafa أو باستخدام viu، يتفوق Windows Terminal على طرفية MacOS لأنه يدعم ألوانًا أكثر بكثير (شكرًا مايكروسوفت!)

ملاحظات الإصدار: عرض الصور (في الطرفية!)

عرض الصور

• تمت إضافة معاينات صور ما بعد التضمين مع اختيار الواجهة الخلفية:
  • يجرب chafa أولاً تلقائيًا، ثم viu.
  • TERMCOURSE_CHAFA_MODE=stable|quality
  • مستقر (stable): إخراج متحفظ لاستقرار الطرفية.
  • جودة (quality): عرض رموز بتفاصيل/ألوان أعلى.
• تمت إضافة التحكم في ارتفاع المعاينة:
  • TERMCOURSE_IMAGE_LINES (الافتراضي: 14)
  • ينطبق على ارتفاع سطر المعاينة؛ مفيد لضبط الكثافة المرئية.
• تحسين سلوك نسبة العرض إلى الارتفاع في viu:
  • تم التبديل إلى العرض المستهدف للسطر (-h) للحفاظ على نسبة العرض إلى الارتفاع بشكل أفضل.
• تمت إضافة عناصر تحكم في تصفية جودة المعاينة:
  • TERMCOURSE_IMAGE_QUALITY_FILTER=1 يقوم بتصفية المعاينات التي تحتوي على كتل فقط.
  • اضبطه على 0 لعرض مخرج أداة التصيير دائمًا.
• تمت إضافة حد أمان لتنزيل الصور:
  • TERMCOURSE_IMAGE_MAX_BYTES (الافتراضي: 5242880)
  • يمنع تنزيل الصور كبيرة الحجم من التأثير على الأداء.
• تمت إضافة دعم لروابط صور Discourse upload://…:
  • يتم حلها تلقائيًا إلى /uploads/short-url/…
• تحسين تنظيف/استقرار الطرفية:
  • يحتفظ برموز ألوان SGR الصالحة عند الحاجة.
  • يزيل تسلسلات التحكم/الرسومات التي تزعزع الاستقرار.
  • يمنع عرض أجزاء هروب ANSI كنص خام.

[merefield (Robert)]

ملاحظة: لقد وجدت موقعًا واحدًا يحظر اسم المستخدم/كلمة المرور عن بُعد، لذا لن يعمل هذا العميل في هذا الموقف (إلا إذا كنت تملكه ويمكنك تعيين مفتاح واجهة برمجة التطبيقات!)- نرحب بالاقتراحات، ولكن لا يوجد دعم حاليًا في تلك الحالات.

[Canapin (Coin-coin le Canapin)]

لست متأكدًا من أنني سأستخدم هذا في العالم الحقيقي، لا أرى فائدة لي فيه، ولكني جربته وكان ممتعًا. أحب أن أكون قادرًا على التفاعل مع منصة منتديات من الجيل التالي من واجهة بدائية وأساسية.

بطريقة ما، إنه جذاب للغاية من الناحية الجمالية.

[merefield (Robert)]

نعم، أعتقد أنه قد يكون مفيدًا عندما:

• تكون على منصة منخفضة الدقة (low fi)
• تعبث بجهاز راسبيري باي (لم يتم اختباره بعد للعلم)
• من خادم للتحقق من أنك متصل … أو إذا كان كود الواجهة الأمامية يتعطل!
• لموقع ديسكورس (Discourse) يعتمد بشكل كبير على النصوص …
• … وكفضول تقني

لقد كنت أنوي اختباره على هاتفي باستخدام تيرمينوس (Terminus) …

[merefield (Robert)]

حسنًا، ربما يكون هذا هو آخر تحديث لهذا اليوم:

• أصبحت الواجهة الآن متجاوبة مع تغيير حجم النافذة
• تحسينات على المحتوى في تعليمات الشريط العلوي
• المفاتيح من 1 إلى (1)0 تفتح الآن موضوع ذلك الرقم في قائمة المواضيع

تذكر أن تستخدم git pull للحصول على التحديثات.

[mcmcclur (Mark McClure)]

يا رجل، الآن يجب أن أبدأ العمل على أعمالي الفنية بأسكي!!
¯\_(ツ)_/¯

[merefield (Robert)]

لقد أضفت نظام ثيمات قابل للتخصيص بالكامل، هذا هو “fairground”:

… وهذا هو “slate”:

التفاصيل في ملف README

[merefield (Robert)]

حسناً، إليكم يا رفاق، بعض التحديثات المثيرة :

• إضافة دعم للرسائل الخاصة - اضغط على f مرتين
• إضافة أعمدة إضافية للفئة، والمستخدمين، والمشاهدات، بشكل تدريجي عند توسيع العرض
• تعديل السمة للفواصل العمودية
• تحديث ملف README

[merefield (Robert)]

لقد دمجت هذا بالأمس:

• إذا بذلت جهدًا لتثبيت chafa أو viu، فسيتم مكافأتك الآن بميزة جديدة: تبديل “النافذة الكاملة” لصور المنشورات. على نظام ويندوز (Windows)، يعد هذا جيدًا بشكل خاص بسبب دعم عمق الألوان السخي في تطبيق طرفية ويندوز (Windows Terminal).

[merefield (Robert)]

يحتوي termcourse الآن على نافذة منبثقة لحالة الرسائل الخاصة غير المقروءة في شريط حالة قائمة المواضيع، ومثل عميل المتصفح، سيقوم بنشر إشعارات القراءة تلو الأخرى أثناء تحريك المؤشر.

[merefield (Robert)]

لقد دمجت إصلاحات للسمات على نظام التشغيل ماك أو إس

[Canapin (Coin-coin le Canapin)]

جميل… هل يعمل على جهاز بيب-بوي (Pip-Boy)؟

[merefield (Robert)]

لا تتردد في تقديم طلب سحب (PR) لذلك أو مشاركة رموز الألوان وسأضيفها إلى ملف themes.yml الخاص بالأمثلة

[merefield (Robert)]

أحببته! تم الدمج، شكرًا لك!

Add old school green theme (#1)

[merefield (Robert)]

https://github.com/merefield/termcourse/pull/2

كان العرض سيئًا للغاية… لذلك قمت بإصلاحه… الواجهة الآن تعرض الاختلافات، لذا فهي أسرع وأكثر سلاسة بكثير… لم تعد ترسم الشاشة بأكملها مع كل حركة للمؤشر.

لقد اختبرت هذا فقط على نظام ويندوز حتى الآن، لذا يرجى إبلاغي بأي مشاكل - ولكن يجب أن يساعد الأنظمة الأبطأ بشكل كبير.

لقد أضفت أيضًا بعض الاختبارات و GitHub CI!

[merefield (Robert)]

لديه الآن نظام إشعارات فوري يعتمد على MessageBus لإعلامك في شريط الحالة عند تحديث قائمة المواضيع (حتى تتمكن من الضغط على g للتحديث):

Add MessageBus live update notifications (#3)

من المحتمل أن أعمل على شارات قراءة المواضيع بعد ذلك…

[Canapin (Coin-coin le Canapin)]

هذا رائع!

لماذا لا تستخدمون اختصارات لوحة المفاتيح نفسها المستخدمة في ديs course؟ لكي تكون التجربة أكثر سلاسة

[merefield (Robert)]

ليست فكرة سيئة … هذه بالتأكيد تستحق محاولة في مرحلة ما لمعرفة ما إذا كان يمكن تقريب الأشياء بشكل معقول … ولكن هناك بالطبع بعض الاختلافات الكبيرة في الوسيط لذا قد يظل بعض الأشياء مختلفة.