|
1 | | -### 1. لا يمكن رؤية ملف إعدادات `app.log`، ولا يمكن معرفة محتوى الخطأ |
2 | | -يرجى من مستخدمي Windows وضع دليل العمل لهذا البرنامج في مجلد غير موجود على القرص C. |
3 | | - |
4 | | -### 2. تم إنشاء ملف الإعدادات في النسخة غير المكتبية، ولكن لا يزال يظهر الخطأ "لا يمكن العثور على ملف الإعدادات" |
5 | | -تأكد من أن اسم ملف الإعدادات هو `config.toml`، وليس `config.toml.txt` أو أي شيء آخر. بعد الانتهاء من الإعداد، يجب أن تكون بنية مجلد العمل لهذا البرنامج كما يلي: |
6 | | -``` |
7 | | -/── config/ |
8 | | -│ └── config.toml |
9 | | -├── cookies.txt （<- ملف cookies.txt اختياري） |
10 | | -└── krillinai.exe |
11 | | -``` |
12 | | - |
13 | | -### 3. تم ملء إعدادات النموذج الكبير، ولكن يظهر الخطأ "xxxxx يحتاج إلى إعداد xxxxx API Key" |
14 | | -على الرغم من أن خدمات النموذج وخدمات الصوت يمكن أن تستخدم كلاهما خدمات openai، إلا أن هناك أيضًا سيناريوهات حيث يستخدم النموذج الكبير خدمات غير openai بشكل منفصل، لذا فإن هذين الإعدادين منفصلان. بالإضافة إلى إعدادات النموذج الكبير، يرجى البحث عن إعدادات whisper أدناه لملء المفتاح والمعلومات المقابلة. |
15 | | - |
16 | | -### 4. يظهر الخطأ "yt-dlp error" |
17 | | -مشكلة في برنامج تنزيل الفيديو، والتي تبدو حاليًا مجرد مشكلة في الشبكة أو إصدار برنامج التنزيل. تحقق مما إذا كان وكيل الشبكة مفتوحًا ومكونًا في إعدادات ملف الإعدادات، كما يُنصح باختيار نقطة اتصال في هونغ كونغ. يتم تثبيت برنامج التنزيل تلقائيًا بواسطة هذا البرنامج، وسأقوم بتحديث مصدر التثبيت، ولكن نظرًا لأنه ليس مصدرًا رسميًا، فقد يكون هناك تأخير. إذا واجهت مشكلة، حاول تحديثه يدويًا، وطريقة التحديث هي: |
18 | | - |
19 | | -افتح الطرفية في موقع دليل bin للبرنامج، ثم نفذ |
20 | | -``` |
21 | | -./yt-dlp.exe -U |
22 | | -``` |
23 | | -استبدل هنا `yt-dlp.exe` باسم برنامج ytdlp الفعلي في نظامك. |
24 | | - |
25 | | -### 5. بعد النشر، يتم إنشاء الترجمة بشكل طبيعي، ولكن الترجمة المدمجة في الفيديو تحتوي على الكثير من الرموز غير المفهومة |
26 | | -معظمها بسبب نقص خطوط اللغة الصينية في Linux. يرجى تنزيل خط [微软雅黑](https://modelscope.cn/models/Maranello/KrillinAI_dependency_cn/resolve/master/%E5%AD%97%E4%BD%93/msyh.ttc) و[微软雅黑-bold](https://modelscope.cn/models/Maranello/KrillinAI_dependency_cn/resolve/master/%E5%AD%97%E4%BD%93/msyhbd.ttc) (أو اختيار خط يلبي متطلباتك)، ثم اتبع الخطوات التالية: |
27 | | -1. أنشئ مجلد msyh في /usr/share/fonts/ وانسخ الخطوط التي تم تنزيلها إلى هذا الدليل |
28 | | -2. |
| 1 | +### 1. البرنامج يُظهر "ملف التكوين غير موجود" أو "xxxxx يتطلب تكوين مفتاح API لـ xxxxx." كيف يمكنني إصلاح ذلك؟ |
| 2 | + |
| 3 | +هذه مشكلة شائعة في الإعداد. هناك بعض الأسباب التي قد تؤدي إلى حدوث ذلك: |
| 4 | + |
| 5 | +1. **موقع الملف أو اسمه غير صحيح:** |
| 6 | + |
| 7 | +* يتطلب البرنامج ملف تكوين باسم `config.toml` بالضبط. تأكد من أنك لم تسميه عن طريق الخطأ `config.toml.txt`. |
| 8 | +* يجب وضع هذا الملف داخل مجلد `config`. يجب أن تكون البنية الصحيحة للدليل العامل كما يلي: |
| 9 | + ``` |
| 10 | + /── config/ |
| 11 | + │ └── config.toml |
| 12 | + └── krillinai.exe (ملفك التنفيذي) |
| 13 | + ``` |
| 14 | +* **لمستخدمي ويندوز:** يُوصى بوضع دليل البرنامج بالكامل في مجلد ليس على محرك الأقراص C: لتجنب مشاكل الأذونات المحتملة. |
| 15 | + |
| 16 | +2. **تكوين مفتاح API غير مكتمل:** |
| 17 | + |
| 18 | +* يتطلب التطبيق تكوينات منفصلة لنموذج اللغة الكبير (لترجمة)، وخدمة الصوت (للتفريغ وتوليد الصوت) وخدمة tts. |
| 19 | +* حتى إذا كنت تستخدم OpenAI للجميع، يجب عليك ملء المفتاح في أقسام مختلفة من ملف `config.toml`. ابحث عن قسم `llm`، قسم `transcribe`، قسم `tts` واملأ مفاتيح API المقابلة والمعلومات المطلوبة الأخرى. |
| 20 | + |
| 21 | +### 2. أحصل على خطأ يحتوي على "خطأ yt-dlp." ماذا يجب أن أفعل؟ |
| 22 | + |
| 23 | +يشير هذا الخطأ إلى مشكلة في برنامج تنزيل الفيديو، والتي عادة ما تكون مرتبطة بشبكتك أو إصدار برنامج التنزيل. |
| 24 | + |
| 25 | +* **الشبكة:** إذا كنت تستخدم وكيلًا، تأكد من أنه مُكون بشكل صحيح في إعدادات الوكيل داخل ملف `config.toml`. |
| 26 | +* **تحديث `yt-dlp`:** قد يكون إصدار `yt-dlp` المدمج مع البرنامج قديمًا. يمكنك تحديثه يدويًا عن طريق فتح نافذة طرفية في دليل `bin` الخاص بالبرنامج وتشغيل الأمر: |
| 27 | + ``` |
| 28 | + ./yt-dlp.exe -U |
| 29 | + ``` |
| 30 | + |
| 31 | + (استبدل `yt-dlp.exe` باسم الملف الصحيح لنظام التشغيل الخاص بك إذا كان مختلفًا). |
| 32 | + |
| 33 | +### 3. الترجمة في الفيديو النهائي مشوشة أو تظهر ككتل مربعة، خاصة على لينكس. |
| 34 | + |
| 35 | +هذا يحدث تقريبًا دائمًا بسبب عدم وجود خطوط على النظام، وخاصة تلك التي تدعم الأحرف الصينية. لإصلاح ذلك، تحتاج إلى تثبيت الخطوط اللازمة. |
| 36 | + |
| 37 | +1. قم بتنزيل الخطوط المطلوبة، مثل [Microsoft YaHei](https://modelscope.cn/models/Maranello/KrillinAI_dependency_cn/resolve/master/%E5%AD%97%E4%BD%93/msyh.ttc) و [Microsoft YaHei Bold](https://modelscope.cn/models/Maranello/KrillinAI_dependency_cn/resolve/master/%E5%AD%97%E4%BD%93/msyhbd.ttc). |
| 38 | +2. أنشئ دليل خطوط جديد: `sudo mkdir -p /usr/share/fonts/msyh`. |
| 39 | +3. انسخ ملفات الخطوط `.ttc` التي تم تنزيلها إلى هذا الدليل الجديد. |
| 40 | +4. نفذ الأوامر التالية لإعادة بناء ذاكرة التخزين المؤقت للخطوط: |
29 | 41 | ``` |
30 | 42 | cd /usr/share/fonts/msyh |
31 | 43 | sudo mkfontscale |
32 | 44 | sudo mkfontdir |
33 | | - fc-cache |
| 45 | + sudo fc-cache -fv |
34 | 46 | ``` |
35 | 47 |
|
36 | | -### 6. كيف يمكن ملء رمز الصوت في تحويل النص إلى كلام؟ |
37 | | -يرجى الرجوع إلى وثائق مزود خدمة الصوت، وفيما يلي ما يتعلق بهذا المشروع: |
38 | | -[وثائق OpenAI TTS](https://platform.openai.com/docs/guides/text-to-speech/api-reference)، الموجودة في خيارات الصوت |
39 | | -[وثائق تفاعل الصوت الذكي من علي بابا](https://help.aliyun.com/zh/isi/developer-reference/overview-of-speech-synthesis)، الموجودة في قائمة الصوت - قيمة معلمة voice |
| 48 | +### 4. على macOS، التطبيق لا يبدأ ويظهر خطأ مثل "KlicStudio تالف ولا يمكن فتحه." |
| 49 | +
|
| 50 | +يحدث هذا بسبب ميزة الأمان في macOS، Gatekeeper، التي تقيد التطبيقات من المطورين غير المعتمدين. لإصلاح ذلك، يجب عليك إزالة خاصية الحجر الصحي يدويًا. |
| 51 | +
|
| 52 | +1. افتح تطبيق **Terminal**. |
| 53 | +2. اكتب الأمر `xattr -cr` متبوعًا بمسافة، ثم اسحب ملف `KlicStudio.app` من نافذة Finder إلى Terminal. سيبدو الأمر كما يلي: |
| 54 | + ``` |
| 55 | + xattr -cr /Applications/KlicStudio.app |
| 56 | + ``` |
| 57 | +3. اضغط على Enter. يجب أن تكون قادرًا الآن على فتح التطبيق. |
| 58 | +
|
| 59 | +### 5. أحصل على أخطاء مثل `خطأ ffmpeg`، `خطأ audioToSrt`، أو `حالة الخروج 1` أثناء المعالجة. |
| 60 | +
|
| 61 | +تشير هذه الأخطاء عادةً إلى مشاكل في التبعيات أو موارد النظام. |
| 62 | +
|
| 63 | +* **`خطأ ffmpeg`:** يشير هذا إلى أن `ffmpeg` إما غير مثبت أو غير متاح من مسار النظام. تأكد من أنك قد قمت بتثبيت نسخة كاملة ورسمية من `ffmpeg` وأن موقعه مضاف إلى متغيرات البيئة في نظامك. |
| 64 | +* **`خطأ audioToSrt` أو `حالة الخروج 1`:** يحدث هذا الخطأ أثناء مرحلة التفريغ (من الصوت إلى النص). الأسباب الشائعة هي: |
| 65 | + * **مشاكل في النموذج:** فشل نموذج التفريغ المحلي (مثل `fasterwhisper`) في التحميل أو تعرض للتلف أثناء التنزيل. |
| 66 | + * **ذاكرة غير كافية (RAM):** تشغيل النماذج المحلية يتطلب موارد كبيرة. إذا نفدت الذاكرة من جهازك، قد يقوم نظام التشغيل بإنهاء العملية، مما يؤدي إلى حدوث خطأ. |
| 67 | + * **فشل الشبكة:** إذا كنت تستخدم خدمة تفريغ عبر الإنترنت (مثل واجهة برمجة تطبيقات Whisper من OpenAI)، فهذا يشير إلى وجود مشكلة في اتصال الشبكة لديك أو مفتاح API غير صالح. |
| 68 | +
|
| 69 | +### 6. شريط التقدم لا يتحرك. هل البرنامج متجمد؟ |
| 70 | +
|
| 71 | +لا، طالما أنك لا ترى رسالة خطأ، فإن البرنامج يعمل. يتم تحديث شريط التقدم فقط بعد الانتهاء من مهمة كبيرة (مثل التفريغ أو ترميز الفيديو). يمكن أن تكون هذه المهام تستغرق وقتًا طويلاً، مما يتسبب في توقف شريط التقدم لفترة طويلة. يرجى التحلي بالصبر وانتظار انتهاء المهمة. |
| 72 | +
|
| 73 | +### 7. بطاقة الرسوم NVIDIA من سلسلة 5000 غير مدعومة من `fasterwhisper`. ماذا يجب أن أفعل؟ |
| 74 | +
|
| 75 | +لقد لوحظ أن نموذج `fasterwhisper` قد لا يعمل بشكل صحيح مع بطاقات الرسوم NVIDIA من سلسلة 5000 (اعتبارًا من منتصف 2025). لديك بعض البدائل للتفريغ: |
| 76 | +
|
| 77 | +1. **استخدام نموذج قائم على السحابة:** قم بتعيين `transcribe.provider.name` إلى `openai` أو `aliyun` في ملف `config.toml`. ثم، املأ مفتاح API والتفاصيل التكوينية المقابلة. سيستخدم هذا نموذج Whisper الخاص بمزود السحابة بدلاً من النموذج المحلي. |
| 78 | +2. **استخدام نموذج محلي آخر:** يمكنك تجربة نماذج تفريغ محلية أخرى، مثل `whisper.cpp` الأصلي. |
| 79 | +
|
| 80 | +### 8. كيف يمكنني العثور على رمز الصوت/النغمة الصحيح لخاصية تحويل النص إلى كلام؟ |
| 81 | +
|
| 82 | +تُحدد الأصوات المتاحة وأكوادها المقابلة من قبل مزود خدمة الصوت الذي تستخدمه. يرجى الرجوع إلى الوثائق الرسمية الخاصة بهم. |
| 83 | +
|
| 84 | +* **OpenAI TTS:** [الوثائق](https://platform.openai.com/docs/guides/text-to-speech/api-reference) (انظر خيارات `voice`). |
| 85 | +* **Alibaba Cloud:** [الوثائق](https://help.aliyun.com/zh/isi/developer-reference/overview-of-speech-synthesis) (انظر معلمة `voice` في قائمة النغمات). |
| 86 | +
|
| 87 | +### 9. كيف يمكنني استخدام نموذج لغة كبير محلي (LLM)، مثل الذي يعمل على Ollama، للترجمة؟ |
| 88 | +
|
| 89 | +نعم، يمكنك تكوين KlicStudio لاستخدام أي LLM محلي يوفر نقطة نهاية API متوافقة مع OpenAI. |
| 90 | +
|
| 91 | +1. **ابدأ نموذج LLM المحلي الخاص بك:** تأكد من أن خدمتك المحلية (مثل Ollama التي تعمل على Llama3) نشطة وقابلة للوصول. |
| 92 | +2. **تحرير `config.toml`:** في قسم نموذج اللغة الكبير (المترجم): |
| 93 | +
|
| 94 | +* قم بتعيين مزود `name` (أو `type`) إلى `"openai"`. |
| 95 | +* قم بتعيين `api_key` إلى أي سلسلة عشوائية (مثل `"ollama"`)، حيث إنها ليست مطلوبة للمكالمات المحلية. |
| 96 | +* قم بتعيين `base_url` إلى نقطة نهاية API لنموذجك المحلي. بالنسبة لـ Ollama، يكون هذا عادةً `http://localhost:11434/v1`. |
| 97 | +* قم بتعيين `model` إلى اسم النموذج الذي تقدمه، على سبيل المثال، `"llama3"`. |
| 98 | +
|
| 99 | +### 10. هل يمكنني تخصيص نمط الترجمة (الخط، الحجم، اللون) في الفيديو النهائي؟ |
| 100 | +
|
| 101 | +لا. حاليًا، يقوم KlicStudio بإنشاء **ترجمات مشفرة**، مما يعني أنها تُحرق مباشرة في إطارات الفيديو. التطبيق **لا يقدم خيارات لتخصيص نمط الترجمة**؛ يستخدم نمطًا محددًا مسبقًا. |
| 102 | +
|
| 103 | +للحصول على تخصيص متقدم، الحل الموصى به هو: |
| 104 | +
|
| 105 | +1. استخدام KlicStudio لإنشاء ملف الترجمة `.srt` المترجم. |
| 106 | +2. استيراد الفيديو الأصلي وملف `.srt` هذا إلى محرر فيديو احترافي (مثل Premiere Pro، Final Cut Pro، DaVinci Resolve) لتطبيق الأنماط المخصصة قبل التصدير. |
| 107 | +
|
| 108 | +### 11. لدي بالفعل ملف `.srt` مترجم. هل يمكن لـ KlicStudio استخدامه فقط لأداء الدبلجة؟ |
| 109 | +
|
| 110 | +لا، هذه الميزة غير مدعومة حاليًا. يقوم التطبيق بتشغيل سلسلة كاملة من التفريغ إلى إنشاء الفيديو النهائي. |
0 commit comments