Skip to content

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.

8.4 KB
Raw Blame

المساهمة بقالب إنشاء (العربية)

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/.

لديك أسئلة؟ افتح مشكلة مع فكرة قالبك ونموذج مخرجات، وسنساعدك في تحديد النطاق.