Hermes کے ساتھ اسٹیج 1 ڈراما سیریز ورک فلو بنائیں

Hermes کیا کرتا ہے

Hermes ایک ڈراما سیریز ایجنٹ آرکیٹیکچر ہے جو کہانی کے اندراج، افزودگی، اثاثہ سازی، اقساط کی تیاری، رن ٹائم ایونٹس اور پروڈکشن ورک فلو کو منظم کرتا ہے۔ اس کا موجودہ نفاذ مرحلہ 1 کے اندراج اور افزودگی، مرحلہ 2 کی JSONL تعمیر اور توثیق، مرحلہ 2 اور مرحلہ 3 کے رن ٹائم رویے، ایونٹ ہینڈلنگ، اور Comfy ورکر انٹیگریشن کا احاطہ کرتا ہے۔

یہ پروجیکٹ Streamlit ہوسٹ ایپلیکیشن کے گرد بنایا گیا ہے جس میں Chat، Assets اور Job پینلز شامل ہیں۔ ایک گفتگو ایک series_id سے منسلک ہوتی ہے، جبکہ پروجیکٹ مستند سیریز ڈیٹا projects/{slug}/ میں محفوظ کرتا ہے۔

مرحلہ ماڈل کو سمجھیں

ریپوزٹری S1–S7 آرکیٹیکچر کی دستاویز فراہم کرتی ہے۔ مرحلہ 1 اندراج اور افزودگی سنبھالتا ہے: ایک سطری تصور اسکرپٹ اور کاسٹ تصاویر میں تبدیل ہوتا ہے، جس کے لیے واضح منظوری کے مراحل موجود ہیں۔ مرحلہ 2 غیر متزامن JSONL کام تیار کرتا ہے اور غیر متزامن Comfy پروسیسنگ شروع کرتا ہے۔ مرحلہ 3 رن ٹائم حالت کو اپ ڈیٹ کرنے کے لیے on_episode_complete ہک استعمال کرتا ہے، جس میں دوسری قسط تیار کرنے کی معاونت بھی شامل ہے۔

مراحل 4 سے 7 بھی اسی Agent v1 دائرہ کار کا حصہ ہیں۔ ان کا تفصیلی آرکیٹیکچر ریپوزٹری کی آرکیٹیکچر دستاویزات میں درج ہے، جبکہ حتمی نفاذی فیصلے DECISIONS.md میں ریکارڈ کیے گئے ہیں۔

ریپوزٹری تیار کریں

ریپوزٹری کے روٹ سے آغاز کریں۔ README میں پروجیکٹ ڈائریکٹری کا نام drama-series-agent دیا گیا ہے، اس لیے مرحلہ 1 کی کمانڈز چلانے سے پہلے اس ڈائریکٹری میں جائیں۔

cd drama-series-agent

README کسی الگ dependency-installation کمانڈ کی تجویز نہیں دیتا۔ اسکرپٹس چلانے یا پیکیجز درآمد کرنے سے پہلے ریپوزٹری کا موجودہ Python ماحول اور پروجیکٹ سیٹ اپ استعمال کریں۔

مرحلہ 1 کا اندراجی اسکرپٹ چلائیں

عنوان سے نیا ڈراما پروجیکٹ تیار کرنے کے لیے --title آپشن کے ساتھ اندراجی اسکرپٹ چلائیں۔ درج ذیل مثال README کے مطابق چینی عنوان استعمال کرتی ہے:

python scripts/hermes_drama_intake.py --title 我的短剧

یہ کمانڈ مرحلہ 1 کے اندراجی ورک فلو کو شروع کرتی ہے۔ اس کے بعد پروجیکٹ لے آؤٹ رن ٹائم حقیقت، ادبی مواد، قسط کے ٹیمپلیٹس، کاسٹ ڈیٹا اور اسکلز کے لیے مخصوص مقامات فراہم کرتا ہے۔

سسٹم میں استعمال ہونے والے JSON اسکیما دیکھنے کے لیے چلائیں:

python scripts/hermes_drama_intake.py --dump-schemas

اسکیما کا معائنہ ٹولز کو مربوط کرتے وقت یا ریپوزٹری کے معاہدوں کے مطابق پے لوڈز کی توثیق کرتے وقت مفید ہے۔

S1-B افزودگی کا ورک فلو مکمل کریں

README handle_tool_call کے ذریعے S1-B ورک فلو فراہم کرتا ہے۔ ڈسپیچر کو drama_series_agent.drama.dispatch سے درآمد کریں:

from drama_series_agent.drama.dispatch import handle_tool_call

پروجیکٹ تیار کرنے کے بعد، آپریشنز اس ترتیب سے چلائیں:

1. انٹیک سے ادبی پیکیج تیار کرنے کے لیے run_literary_generate۔
2. تیار کردہ ادبی آؤٹ پٹ کو واضح طور پر منظور کرنے کے لیے accept_literary_package۔
3. کاسٹ ٹیبل اخذ کرنے کے لیے extract_cast_table۔
4. کاسٹ تصاویر تیار کرنے کے لیے run_cast_image_generate۔
5. تیار کردہ کاسٹ اثاثوں کو منظور کرنے کے لیے accept_cast_images۔
6. آڈیو کے کام کو مؤخر کیے جانے کا ریکارڈ رکھنے کے لیے mark_audio_deferred۔
7. یہ جانچنے کے لیے get_s1_gate_status کہ آیا سیریز ready_for_s2 ہے۔

منظوری کے مراحل اہم ہیں: مرحلہ 1 صرف جنریشن کالز کا سلسلہ نہیں ہے۔ مرحلہ 2 کے لیے مرحلہ 1 گیٹ کے تیار ہونے کی اطلاع دینے سے پہلے ادبی پیکیج اور کاسٹ تصاویر کو منظور کرنا ضروری ہے۔

پروجیکٹ لے آؤٹ کو رہنما کے طور پر استعمال کریں

Hermes مختلف اقسام کے پروجیکٹ ڈیٹا کو قابلِ پیش گوئی ماؤنٹس میں الگ کرتا ہے:

• hermes/architecture/ میں S1-B، S2–S3 سلسلے کی دستاویزات، S4–S7 دائرہ کار اور آرکیٹیکچرل فیصلے شامل ہیں۔
• hermes/contracts/ میں JSON Schemas اور مثالیں شامل ہیں۔
• projects/{slug}/ میں L1 حقیقت محفوظ ہوتی ہے، جس میں series_runtime.json، انٹیک ڈیٹا، ہینڈ آف ڈیٹا اور فیصلے شامل ہیں۔
• dramas/{slug}/ ادبی ماؤنٹ ہے۔
• templates/{slug}/ HostApp قسط کا ماؤنٹ ہے۔
• data/cast/{slug}/ کاسٹ اور آواز کا ڈیٹا محفوظ کرتا ہے۔
• skills/drama-intake/ میں مرحلہ 1-A اسکل شامل ہے۔
• skills/drama-series-develop/ پروجیکٹ کی ترقی کے شعبوں، جیسے خاکوں، دنیا کی تعمیر، کرداروں اور بصری انداز کا احاطہ کرتا ہے۔
• skills/0xsline-short-drama/ وہ ادبی اسکل فراہم کرتا ہے جسے رن ٹائم پر ادبی اسکل استعمال کرتی ہے۔
• skills/drama-series-h3-r2v-prompts/ H3 Ref2VA وائرنگ فراہم کرتا ہے۔

اہم Python پیکیجز کو جانیں

ریپوزٹری اپنی Python فعالیت کو مرکوز پیکیجز میں تقسیم کرتی ہے:

• drama_series_agent.intake دریافت، اسکیفولڈنگ، انجیشن اور ہینڈ آف سنبھالتا ہے۔
• drama_series_agent.drama میں JobEvent، SeriesRuntime، EventBus، S1-B افزودگی، S3 ہک اور Comfy ورکر شامل ہیں۔
• drama_series_agent.adapters.r2v MiniMax H3 R2V قسط رنر اور توثیق فراہم کرتا ہے۔
• drama_series_agent.utils.skills_paths اسکل کے مقامات متعین کرتا ہے۔

ورک فلو میں توسیع کرتے وقت ان پیکیج حدود کو استعمال کریں، بجائے اس کے کہ انٹیک، رن ٹائم اور اڈاپٹر کی منطق کو ایک ہی ماڈیول میں رکھا جائے۔

مرحلہ 1 سے پروڈکشن کی طرف بڑھیں

جب get_s1_gate_status ready_for_s2 کی اطلاع دے، تو سیریز مرحلہ 2 کی طرف بڑھ سکتی ہے۔ مرحلہ 2 JSONL کام تیار اور توثیق کرتا ہے اور اسے غیر متزامن طور پر چلاتا ہے۔ ریپوزٹری comfy_worker.enqueue_comfy_episode کے ذریعے Comfy ورکر کو بھی مربوط کرتی ہے۔

مرحلہ 2 اور اس کے بعد کی پروسیسنگ کو چیٹ کو مکمل جاب لاگ سمجھنے کے بجائے رن ٹائم ایونٹس کے ذریعے پیش رفت بتانی چاہیے۔ طے شدہ فیصلوں کے مطابق Chat سنگِ میل دکھاتا ہے، جبکہ غیر ہم وقتی کام جاب اور ایونٹ کی تہوں کے ذریعے سنبھالا جاتا ہے۔

جب کوئی ایپی سوڈ مکمل ہوتا ہے تو Stage 3 کا on_episode_complete ہُک سیریز کے رن ٹائم کو اپ ڈیٹ کرتا ہے۔ یہ رن ٹائم اپ ڈیٹ اگلے ایپی سوڈ کے بہاؤ کو سپورٹ کرتا ہے، جس میں مطلوبہ “دوسرا ایپی سوڈ تیار کریں” کا رویہ بھی شامل ہے۔

عملی انضمامی تجاویز

• ہر گفتگو کو ایک ہی series_id سے منسلک رکھیں تاکہ رن ٹائم کی حالت غیر مبہم رہے۔
• بیرونی انضمامات بنانے سے پہلے --dump-schemas کے ذریعے اسکیما دیکھ لیں۔
• ادبی آؤٹ پٹ اور کاسٹ کی تصاویر کے لیے واضح منظوری کے سلسلے کو برقرار رکھیں۔
• رن ٹائم، ادبی، ایپی سوڈ اور کاسٹ کے ڈیٹا کے لیے پروجیکٹ ماؤنٹس کو اصل ماخذ کی حدود سمجھیں۔
• Streamlit ہوسٹ یا ورک فلو کی حدود تبدیل کرنے سے پہلے DECISIONS.md پڑھیں۔
• Job Event یا series_runtime پے لوڈز تیار کرتے وقت hermes/contracts/ میں درج معاہدوں کا استعمال کریں۔
• Stage 2 کی پروسیسنگ کو غیر ہم وقتی سمجھیں اور ہوسٹ ایپلیکیشن کی جاب اور چیٹ سطحوں کے ذریعے سنگِ میل دکھائیں۔

نتیجہ

Hermes ایک سطری ڈرامائی تصور سے منظور شدہ Stage 1 پیکیج تک، اور پھر غیر ہم وقتی ایپی سوڈ پروڈکشن تک پہنچنے کا منظم راستہ فراہم کرتا ہے۔ انٹیک اسکرپٹ سے آغاز کریں، S1-B کی تیاری اور منظوری کا سلسلہ مکمل کریں، ready_for_s2 گیٹ کی تصدیق کریں، اور ورک فلو کو محفوظ طریقے سے بڑھانے کے لیے درج شدہ معاہدوں اور رن ٹائم ہُکس کا استعمال کریں۔