Formerly KrillinAI, VideoTranslation and Dubbing Tool for 120+ Languages. Open-source AI workspace for creators, powered by Codex. Video downloader, video translation, create videos, images, audios, and edits with Agents in one place. For your Social Media like YouTube, TikTok, Instagram, etc.
المساهمة بقالب إنشاء (العربية)
English | 简体中文 | 日本語 | 한국어 | Bahasa Indonesia | Español | Français | Deutsch | Português | Русский | العربية
قالب الإنشاء هو مجلد داخل template/<module>/<id>/<version>/ يحتوي على ملف template.json وأصوله المحلية. تغذي القوالب أدوات الاختيار المرئية لتوليد الصور والفيديو والأغلفة — يبدأ المستخدمون من الإعداد المسبق الخاص بك بدلًا من موجه فارغ. يشرح هذا الدليل كيفية إضافة واحد.
ما هو قالب الإنشاء وما ليس كذلك
القالب هو:
- إعداد مسبق مضبوط: موجهات افتراضية، تلميحات أسلوبية، إعدادات النسبة/المدة/الجودة، بالإضافة إلى غلاف ومعاينة يعرضان النتيجة.
- مكتفٍ ذاتيًا. كل ما يعرضه المُنتقي موجود داخل مجلد القالب.
القالب ليس:
- نوعًا جديدًا من القوالب. الوحدات الحالية هي
image-generationوvideo-generationوcover-generator. إذا كنت تحتاج وحدة جديدة، افتح مشكلة للنقاش أولًا — هذا تغيير في المنتج وليس قالبًا. - كومة من الموجهات. القوالب ذات الموجه الفارغ أو العام بدون قيم افتراضية مترجمة ستُرجَع؛ القيمة في الضبط.
- عمل شخص آخر بدون حقوق. راجع النسب والحقوق.
البدء السريع
corepack enable && pnpm install
cp -r template/cover-generator/images-go-hard-thumbnail template/<module>/<template-id-الخاص-بك>
# حرّر template.json، واستبدل أصول الغلاف/المعاينة
pnpm templates:validate # يجب أن ينجح قبل فتح طلب دمج
معرّفات القوالب بأحرف صغيرة مفصولة بشرطات وفريدة داخل الوحدة. يبدأ الإصدار من 1 — مجلد واحد لكل إصدار، لذا التحديثات تنشئ <id>/2/ بدلًا من تعديل <id>/1/.
بنية المجلد
template/<module>/<id>/1/
├── template.json # مطلوب: بيانات وصفية، قيم افتراضية، محتوى مترجم
├── cover.jpg # مطلوب: يُعرض في منتقي القوالب
├── preview.jpg # وحدتا الصورة/الغلاف: معاينة أكبر للنتيجة
├── previewVideo # وحدة الفيديو: مقطع مثال، مثل example.mp4
└── author-avatar.jpg # اختياري: صورة المؤلف المنسوب إليه
حقول template.json
| الحقل | مطلوب | ملاحظات |
|---|---|---|
schemaVersion |
نعم | حاليًا 1. |
id، version، module |
نعم | يجب أن تطابق مسار المجلد <module>/<id>/<version>/. |
runtimeTemplate |
نعم | يربط بمنفّذ Runtime، مثل {"id": "cover", "version": 2}. انسخ من قالب في الوحدة نفسها. |
status |
نعم | published للنشر؛ استخدم draft أثناء العمل. |
title، description |
نعم | zh-CN وen-US مطلوبان. اللغات الأخرى اختيارية. |
cover |
نعم | مسار نسبي لصورة المُنتقي المصغّرة. |
preview / previewVideo |
حسب الوحدة | preview لوحدتي الصورة والغلاف، previewVideo للفيديو. |
defaults |
نعم | الإعدادات الأساسية التي يبدأ منها المستخدم (الموجه، النسبة، المدة، الجودة…). |
defaultsByLocale |
موصى به بشدة | تجاوزات الموجه والأسلوب المترجمة لكل لغة. الضبط الحقيقي يعيش هنا — انظر أدناه. |
tags |
موصى به | تسميات قابلة للبحث؛ حافظ على موضوعيتها. |
author |
عند الاقتضاء | name وurl وavatar للمصادر الخارجية المنسوبة. |
featured، sortOrder |
لا | اترك featured: false؛ المشرفون يقررون الإبراز. |
الموجه هو المنتج
يقضي المراجعون معظم وقتهم في defaults وdefaultsByLocale:
- يجب أن تكون كلتا اللغتين موجهات حقيقية، وليست ترجمات فقدت الضبط. يجب أن تنتج موجهات
zh-CNوen-USنتائج متكافئة مع الاستفادة من نقاط قوة كل لغة. - جعِل ما يُفترض أن يتغير قابلًا للتخصيص. إذا كان نص العنوان أو الموضوع قابلًا للتحرير من المستخدم، فاذكر ذلك صراحةً في الموجه (تستخدم القوالب الموجودة علامات مثل "Customizable text: …").
- اذكر القيود. "بدون علامة مائية، بدون نص إضافي، بدون أشخاص إضافيين" — القيود السلبية مهمة بقدر الوصف للحصول على نتائج قابلة للتكرار.
- طابق بنية
defaultsللوحدة. قوالب الصور تحمل ratio/candidateCount/quality؛ قوالب الفيديو تحمل size/duration؛ قوالب الأغلفة تحمل العنوان الرئيسي ولغة النص وحقول الأسلوب. انسخ البنية من قالب موجود في وحدتك.
الأصول
- ولّد
cover.jpgوالمعاينة بالقالب نفسه — صورة جاهزة أو عمل فني غير مرتبط سيُرفَض. - حافظ على أحجام ملفات معقولة؛ هذه الملفات تُوزَّع مع التطبيق وتُحمَّل في المُنتقي.
- يجب أن تمثل المعاينة نتيجة نموذجية، وليس أفضل نتيجة من خمسين محاولة.
النسب والحقوق
إذا كان قالبك يقتبس موجهًا أو أسلوبًا منشورًا لشخص آخر:
- يجب أن يكون لديك حق إعادة توزيعه.
- املأ حقل
authorبـnameوurl(وauthor-avatar.jpgإن توفر)، كما تفعل القوالب الموجودة. - عند الشك، افتح مشكلة واسأل قبل بدء العمل.
معايير الدمج
- مسار المجلد يطابق
id/version/module؛ المعرّف فريد في الوحدة. -
pnpm templates:validateينجح. -
titleوdescriptionمتوفران بـzh-CNوen-US. -
defaultsByLocaleيحتوي موجهات مضبوطة لكلتا اللغتين. - أصول الغلاف والمعاينة مولّدة بالقالب نفسه.
- نسب
authorمضمّن عند اقتباس عمل خارجي. -
featured: false،status: "published"(أوdraftمع ملاحظة في طلب الدمج).
أنماط الرفض الشائعة
- موجه عام — القالب لا يضيف شيئًا فوق الموجه الفارغ؛ المُنتقي لا يحتاجه.
- لغة مفقودة — لغة واحدة فقط مضبوطة، أو ترجمة آلية فقدت قيود الأسلوب.
- أصول غير متطابقة — الغلاف لا يطابق ما يولّده الموجه فعليًا.
- حقوق غير واضحة — اقتباس عمل شخص ما بدون نسب أو إذن.
- تعديل الإصدار القديم في مكانه — أنشئ مجلد إصدار جديد بدلًا من إعادة كتابة تاريخ
<id>/1/.
لديك أسئلة؟ افتح مشكلة مع فكرة قالبك ونموذج مخرجات، وسنساعدك في تحديد النطاق.