عن المشروع

## نظرة عامة تعتبر Tachikaze أداة CLI مكتوبة بلغة Rust تقوم بعملية "قص الـ CM بشكل لاسلاس" من ملفات التسجيل التي تم تحويلها بالفعل إلى MP4. تستلهم Tachikaze بشدة من Amatsukaze، حيث تهدف إلى السماح بتطبيق قص الـ CM على أي تسجيل حتى بعد تحويله إلى MP4، وكذلك تشغيل نفس العملية على أنظمة macOS وLinux. ## طريقة الاستخدام أقصر مثال للتنفيذ هو: ```console $ tachikaze auto IN.mp4 -o OUT.mp4 ``` حيث أن الأمر `auto` ينفذ سلسلة العمليات `prepare` → `analyze` → gate → `cut` → `remap-subs` بشكل تفاعلي بدون تدخل المستخدم. وفي حال قام `gate` بتحديد ما يعتبره غير مؤكد، يتم إنهاء العملية دون قص باستخدام الخيار `--ignore-gate`. كما أن `analyze`/`auto` يقومان بتفعيل اكتشاف اللوغو افتراضياً، ويستنتجان حدود اللوغو تلقائياً من المدخلات (يمكن تعطيل ذلك عبر `--no-logo`). إذا كنت ترغب في إدراج مرحلة قرار بين التحليل والقص، يمكنك استخدام `analyze` لإخراج قائمة Trim ثم استخدام `cut` للقطع الفعلي. أما معالجة الملفات المتعددة فتعتمد عادة على حلقات الشيل (shell loops)، مع تفضيل تسمية المخرجات بـ `*_CMcut.mp4` لتجنب إعادة التقاط glob patterns. ## الاعتمادات بالإضافة إلى Tachikaze الأساسي، يتطلب العمل مع هذه الأداة الأدوات الخارجية التالية لتكون متاحة في المسار PATH: - **chapter_exe**: لاكتشاف الصمت ونقاط التغير الشفهي - **join_logo_scp**: لتحديد الـ CM (إنشاء Trim) - **dtvindex**: لفهرسة أرقام الإطارات المشتركة - **ffmpeg / ffprobe**: للعمليات التحضيرية والتحقق ## البناء والتثبيت يتم بناء المشروع باستخدام `cargo build --release --locked`، بينما يتم تثبيت الأداة باستخدام `make install` (الافتراضي هو /usr/local، ويمكن تغيير PREFIX). تتوفر إرشادات لبيئة macOS باستخدام أداة Toolchain، بالإضافة إلى وثائق Docker (يوجد Dockerfile ولكن لم يتم توزيع صور Docker جاهزة). ## القيود المعروفة - البيئات التي تم التحقق منها هي macOS (Apple Silicon) وLinux (arm64 وDocker). Windows غير مدعومة. - الفيديو يستخدم H.264، والصوت يستخدم كودك (Opus/AAC). - يتم تقريب حدود GOP إلى حدود الإطارات الرئيسية، مما يترك متوسط 2.1-2.5 ثانية من الـ CM حول نقاط القص (سياسة التسامح). - كل عملية واحدة تأخذ مدخلاً واحداً فقط. ## الترخيص والمصدر النسخة الأساسية من Tachikaze تحت رخصة MIT (Copyright (c) 2026 Masayuki Mizuno). لم يتم نقل جسم Amatsukaze الأساسي، بل يُعامل كمصدر مرجعي ومصدر إلهام للخوارزميات. بعض أجزاء اكتشاف اللوغو (في src/logo/score.rs و src/logo/interval.rs) هي نسخ مدمجة لكود MIT مشتق من Amatsukaze، وتحتفظ بإشارة حقوق النشر الأصلية. الكود غير المعروف الترخيص منه من delogo لم يتم دمجه، وتم إعادة كتابته من المعادلات. عند التشغيل، يتم استدعاء الأدوات الخارجية (chapter_exe / join_logo_scp / dtvindex / ffmpeg) كعمليات منفصلة، ولا يوجد مشاركة للروابط أو مساحات العناوين المشتركة، بل يتم تمرير البيانات عبر الملفات والوسائط الخطية.