media-library-organizer-skill

لماذا تستخدمه

الميزات الأساسية

تنظيف الملفات غير المهمة: بقايا SMB و .DS_Store والمجلدات الفارغة
دمج النسخ المكررة عبر المجلدات حسب العنوان والسنة والجودة
دمج الحلقات المتناثرة عبر مجموعات الإصدارات
إعادة تسمية المجلدات إلى معيار Title (Year)
الإشارة المرجعية لـ TMDB للتحقق من اكتمال الحلقات
سلامة متدرجة — العمليات المدمرة تتطلب تأكيد
تحذير بذور التورنت قبل إعادة التسمية

عرض مباشر

كيف يبدو في الممارسة

media-library-organizer-skill.replay ▶ جاهز

0/0

التثبيت

مستودع المؤلف · وثائق Claude Skills الرسمية

حالات الاستخدام

استخدامات عملية: media-library-organizer-skill

تحضير مكتبة تحميلات فوضويّة لـ Jellyfin

👤 مستخدمو خادم الوسائط المنزلي الذين لديهم مجلد تحميلات فوضوي ⏱ ~60 min intermediate

متى تستخدمه: قبل توجيه Jellyfin إلى مجلد مليء بفوضى أسماء مجموعات الإصدارات.

الخطوات

المسح والتحليل

استخدم media-library-organizer على /media/downloads. مسح فقط — اعرض قائمة الملفات غير المهمة والنسخ المكررة والحلقات المتناثرة.✓ تم النسخ

→ تقرير يحتوي على 3 أقسام: ملفات غير مهمة / نسخ مكررة / متناثرة
التنظيف التلقائي للملفات غير المهمة (مستوى آمن)

تابع التنظيف من الملفات غير المهمة (.DS_Store وبيانات SMB والمجلدات الفارغة).✓ تم النسخ

→ حذفات صغيرة، لا توجد أي مخاطرة
التأكيد ودمج النسخ المكررة

الآن دمج النسخ المكررة — سأوافق على كل واحدة.✓ تم النسخ

→ موافقات واحدة تلو الأخرى مع عرض العنوان والسنة والجودة
توحيد أسماء المجلدات

أعد التسمية إلى صيغة Title (Year) — حذّر إذا كان هناك أي شيء يُذاع حاليًا.✓ تم النسخ

→ تحذير البذور يظهر قبل إعادة التسمية
التحقق عبر TMDB

تحقق من عدد الحلقات مقابل TMDB — اعرض قائمة الناقصة.✓ تم النسخ

→ قائمة الحلقات الناقصة لكل عرض

النتيجة: يتعرّف Jellyfin/Plex على كل شيء؛ الفجوات الناقصة واضحة.

المزالق

إعادة التسمية تكسر بذرة تورنت نشطة — تحذر المهارة؛ توقف التورنت أو استخدم hard-link قبل إعادة التسمية
دمج النسخ ذات الجودة المختلفة يفقد النسخة الجيدة — تعطي المهارة الأولوية للجودة الأعلى — تحقق مرة أخرى قبل التأكيد

اجمعها مع: filesystem

دمج مكتبة أنمي مع مجموعات إصدارات مختلطة

👤 مجمعو الأنمي ⏱ ~45 min intermediate

متى تستخدمه: مكتبة الأنمي الخاصة بك تحتوي على 3 مجموعات إصدارات لكل عرض في مجلدات مختلفة.

الخطوات

المسح

امسح /anime عن أنماط الحلقات المتناثرة عبر مجموعات الإصدارات.✓ تم النسخ

→ مرشحو الدمج لكل عرض
اختر النسخة الأساسية لكل عرض

لكل مرشح، اختر مجموعة الإصدارات ذات الجودة الأعلى ودمج الآخرين فيها (أو احذفها).✓ تم النسخ

→ مجلدات نظيفة لكل عرض

النتيجة: مجلد واحد لكل عرض بتسمية متسقة.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

media-library-organizer-skill + filesystem

تحرير ملفات NFO أو sidecars مخصصة أثناء نفس الجلسة

أثناء التنظيم، أضف أيضًا ملفات .nfo لكل فيلم برقم TMDB.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها	التكلفة
scan	root path	بداية أي جلسة تنظيم	0 — local
clean_junk	root path, safe_only=true	أول مرة مدمرة	0
merge_duplicates	duplicate pair list	بعد الموافقة على النسخ المكررة	0
normalize_names	root path	بعد التنظيف	0
verify_tmdb	show paths, TMDB_API_KEY	فحص الاكتمال	TMDB free quota

التكلفة والحدود

تكلفة التشغيل

حصة API: TMDB: المستوى المجاني كريم لمكتبات المنزل
الرموز لكل استدعاء: منخفضة — المهارة تنسق في الغالب shell
التكلفة المالية: مجاني
نصيحة: امسح أولاً فقط؛ لا تحرق الرموز على التحليل الكامل حتى تلتزم بالتنظيف

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: قراءة/كتابة نظام الملفات على جذر المكتبة فقط

تخزين بيانات الاعتماد: مفتاح TMDB في متغير البيئة

نقل البيانات الخارجي: TMDB API للتحقق من الاكتمال (البيانات الوصفية العامة فقط)

لا تمنح أبدًا:

لا تشغّل كـ root على قرص الوسائط — استخدم مستخدماً بامتياز الكتابة على المكتبة فقط

قم دائمًا بعمل نسخة احتياطية (أو على الأقل لقطة) قبل merge_duplicates — حتى مع الموافقات.
يعتمد تحذير البذور على أن تكون قادراً على قراءة حالة عميل التورنت؛ إذا لم يكتشفها، توقف البذور يدويًا.

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

كل شيء تم وضع علامة عليه كـ 'ملفات غير مهمة'

أشرت إليه في مجلد غير وسائط — تأكد من الجذر

تحقق: ls /media/downloads

التحقق من TMDB يرجع 401

TMDB_API_KEY مفقود أو غير صحيح

تحقق: curl https://api.themoviedb.org/3/movie/550?api_key=$TMDB_API_KEY

Jellyfin لا يزال لا يكتشف بعد إعادة التسمية

فرض إعادة مسح المكتبة؛ تحقق من أن المجلد يطابق التسمية المتوقعة من Jellyfin

البدائل