Lychee

روابط التوثيق تتغير حتى عندما لا يتغير مشروعك: صفحة تُنقل، وعنوان قسم يُعدّل، ورابط قديم يبقى داخل README. تساعدك Lychee على تحويل مراجعة الروابط إلى فحص قابل للتكرار، بدل فتح كل رابط يدويًا. هي أداة سطر أوامر من مشروع lycheeverse، وليست متصفحًا يختبر رحلة المستخدم كاملة.

🧭 ما Lychee؟

تستخرج الأداة الروابط من ملفات مثل Markdown وHTML، ثم تفحصها وتعرض النتائج. تستطيع تشغيلها على ملف محدد أو مجلد أو صفحة ويب، وتحدد أنت نطاق العمل. فائدتها العملية أن مراجعة التوثيق تصبح جزءًا من تسليم التغيير؛ لا تضطر لتذكّر عشرات الروابط بعد كل تعديل. المصدر هو المستودع الرسمي، وتاريخ المراجعة 28 أكتوبر 2026.

رسم توضيحي للمسار، وليس لقطة للمنتج أو نتيجة فحص منفذ.

🌟 ثلاث قدرات مفيدة وكيف تستخدمها

1. ابدأ بملف معلوم بدل فحص كل شيء

الأمر lychee README.md يفحص روابط الملف الذي حددته. إذا عدّلت صفحة تثبيت، اجعلها أول مدخل للفحص، واقرأ الروابط التي أبلغ عنها التقرير قبل توسيع النطاق. تستطيع لاحقًا تمرير عدة ملفات، كما يوضح دليل البداية.

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

2. افحص الانتقال إلى عنوان داخل الصفحة

قد تفتح الصفحة بنجاح بينما ينقلك #installation إلى قسم لم يعد موجودًا. تفعّل --include-fragments فحص الأجزاء في الروابط وفق دليل العناوين الداخلية. يناسب ذلك فهرس دليل طويل أو روابط الدعم التي تشير إلى خطوة محددة.

انتبه إلى الحد: العناوين التي ينشئها JavaScript لا تُفحص بهذه الآلية، وقد تختلف معرفات العناوين بين مولدات Markdown. عند نتيجة غير مفهومة، افتح الصفحة النهائية وراجع عنوان القسم الفعلي. لا تعدّل المرجع إلى عنوان مختلف لمجرد إسكات التنبيه.

3. تحكّم في الاستثناءات والطلبات المتكررة

توثّق الأداة استبعاد الروابط عبر --exclude، واستبعاد العناوين الخاصة عبر --exclude-all-private. يمكن حفظ استثناءات مستمرة في .lycheeignore مع سبب واضح لكل استثناء. لا تجعل القائمة مقبرة للروابط المعطلة: افصل رابطًا خاصًا لا يستطيع الفاحص الوصول إليه عن رابط عام يحتاج إصلاحًا. راجع الاستثناءات.

وعند تكرار الفحص، يحفظ --cache نتائج في .lycheecache لتقليل الطلبات؛ لكنه يعني أن بعض النتائج قد تأتي من الذاكرة المؤقتة. بعد إصلاح رابط تريد التحقق منه فورًا، راجع عمر النتيجة أو أعد فحصه دون الاعتماد على نتيجة مخزنة. التفاصيل في التخزين المؤقت.

🪜 مثال عملي من البداية إلى المراجعة

المثال التالي تعليمي، ولم ننفذه هنا. افترض أنك مسؤول عن دليل منتج صغير وتريد مراجعة README بعد تحديث فقرة الإعداد:

1. افتح الملف واقرأ الروابط التي أضفتها؛ احذف أي رمز وصول أو رابط خاص غير مقصود قبل الفحص.
2. ثبّت الأداة بالطريقة المناسبة لنظامك، ثم افحص الإصدار والمساعدة.
3. شغّل الفحص على الملف وحده، مع استبعاد العناوين الخاصة إذا كان نطاقك روابط عامة.
4. افحص كل نتيجة: هل الرابط حُذف فعلًا، أم أن الموقع حظر الطلب أو طلب تسجيل دخول؟
5. أصلح المرجع الصحيح، ثم أعد الفحص وراجع التغيير قبل حفظه في المستودع.

brew install lychee
lychee --version
lychee --help
lychee --exclude-all-private --include-fragments README.md

أمر Homebrew موثّق في دليل البداية، والخيارات موثّقة في مرجع الأوامر. لم نثبّت الأداة على جهازك. على Linux أو Windows راجع مدير الحزم المتاح في المصدر نفسه؛ لا تفترض أن الأمر أعلاه يناسب كل جهاز.

⚖️ ماذا تتغير مقارنة بالمراجعة اليدوية؟

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

⚙️ الإعداد والتكامل مع المشروع

تدعم Lychee ملف lychee.toml. يتيح مرجع الإعداد ضبط مهلة الاتصال والتزامن وإعادة المحاولات، بدل تكرار خيارات كثيرة في كل أمر. اختر قيمًا تناسب عدد الروابط والوجهات، وأبقِ تحقق TLS مفعّلًا. لا تُدخل إعدادًا يلغي فحص الشهادة لمجرد تجاوز خطأ يحتاج تشخيصًا.

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

💰 التكلفة والتوافق والخصوصية

المشروع مفتوح المصدر بترخيص MIT OR Apache-2.0، والإصدار الأخير الذي ظهر وقت المراجعة هو lychee-v0.24.2. تتوفر ملفات تنفيذية لـLinux وmacOS وWindows. الاستخدام المحلي لا يحتاج اشتراك AI أو API مدفوعًا؛ الشبكة لازمة لفحص الوجهات البعيدة، وقد تضع تلك الوجهات حدودًا للطلبات.

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

⚠️ الحدود وما لم نختبره

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

هذه مراجعة وثائق بتاريخ 28 أكتوبر 2026، لا تجربة تشغيل مقاسة. الرسوم أصلية وتشرح المفاهيم؛ لا تعرض تقريرًا حقيقيًا أو أرقام نجاح مخترعة. عند المراجعة كان للمستودع 4056 نجمة و240 تفرعًا، وآخر دفع مسجّل 26 أكتوبر؛ هذه مؤشرات رصد وليست تقييمًا للجودة.

📚 المصادر

• المستودع والترخيص والإصدارات.
• التثبيت والبدء والأوامر.
• الإعداد، الاستثناءات، العناوين الداخلية، التخزين المؤقت.

اطلعنا على المصادر في 28 أكتوبر 2026؛ قد تتغير متطلبات الإصدارات والوجهات بعد هذا التاريخ.