hojas-studio

---
name: "hojas-studio"
description: "Hojas Studio: سكل مونتاج كامل لمقاطع الكلام للكاميرا والبودكاست بالكود (قص، تفريغ، كابشن عربي، مشاهد). يفتح بث حي، يسأل المستخدم بصفحة أسئلة (النوع، المنصة، المقاس، الكابشن، الهوية)، يمنتج على إجاباته ومنصته، ويسلّمه تايم لاين بالمتصفح يعدّل فيه ويصدّر. يطبّق ملاحظات الاستوديو، يرسل المقطع لجواله، ينشر من متصفحه بعد موافقته، ويتعلّم أسلوبه. يسحب الفيديو من أي رابط، ويطلّع لقطات قصيرة من الحلقات الطويلة، ويجهّز المونتاج اليدوي. فيه مكتبة لكل مقاطعه، وأصوات وموسيقى CC0، وفحص قبل النشر وأغلفة وكاروسيل. والموشن جرافيك (Motion Graphics) أساسي: عشر قوالب للبرومو والإعلان والعناوين والشرح وفيديوهات السوشال تنطبق لحالها على أي طلب حركة أو أنيميشن، مع قوالب حركة جاهزة (رقم يعدّ، عنوان يضرب، قائمة، مقارنة، ختم شعار). وهوية محفوظة لكل شخص (identity.md من ملف يرفعه أو وصف يكتبه) تنطبق على المونتاج والموشن والبودكاست."
---

# Hojas Studio 4.38: اسأل، منتج على منصته، سلّم على التايم لاين، وانشر

سكل مونتاج كامل من صنع هوجاس (راكان الزهراني)، يشتغل لأي مستخدم وما يحتاج أي سكل ثاني. فيه جزئين: **المحرّك** (مجلد `engine/`: القص، التفريغ، المشاهد، الرسم، وخطواته في `engine/MONTAGE.md`) و**الاستوديو** (`hs.py` والواجهة). وطريقة الشغل أربع أشياء:
0. **أسئلة قبل المونتاج:** بعد التفريغ تنفتح له صفحة أسئلة، وما تبدأ المونتاج إلا بعد ما يحفظ إجاباته.
1. **بث حي:** من أول ثانية يفتح للمستخدم صفحة يشوف فيها وش قاعد تسوي.
2. **تسليم على التايم لاين:** قبل ما تسلّم الملف النهائي، يتحول المقطع للاستوديو والمستخدم يحط لمساته.
3. **أدوات تعديل:** كل شي بالاستوديو تقدر تسويه أنت بالأوامر، وكل تعديل تكتبه يظهر عنده خلال ثانيتين.
5. **أسلوبين جاهزين (4.2):** «ورق متحرك» (الكلام ينكتب كلمة كلمة على ورق فاتح) و«الدحيح» (رأس بعنوان ومكتب ورق وكروت مشبوكة). التفاصيل في `<engine>/references/styles.md`.
4. **يكلّمه وينشر له (4.1):** إشعار على جواله لما تحتاجه ومعه المقطع لما يخلص، ويتعلّم أسلوبه من تعديلاته، ويجهّز النشر من متصفحه ويوقف قبل زر النشر.
6. **مكتبة وجوال وبودكاست (4.3):** «المكتبة» (`hs hub`) تجمع كل مقاطعه وأوامره وحالة جهازه بواجهة واحدة للجوال والكمبيوتر، مع ملاحظات بالصوت. ومن حلقة طويلة يطلع مقاطع قصيرة مترجمة (`hs clips`).
7. **روابط ولقطات ومونتاج يدوي (4.4):** يسحب الفيديو من رابط أي منصة (`hs grab`)، ويرشّح أقوى اللقطات من الفيديو الطويل (Claude يختار أو المستخدم)، ويجهّز المقطع للمونتاج اليدوي بالاستوديو مع رسم حر (`hs prep`). التفاصيل بقسم 6و.
8. **قبل النشر وبعده (4.5):** فحص احتفاظ بالمقطع نفسه، يختار أحسن إعادة، أغلفة وكاروسيل وثريد ووصف يوتيوب، أرقام مقاطعه يتعلّم منها، مصنع ليلي لمجلد مقاطع، وقص عمودي يتبع المتكلم بالفيديو العرضي. كلها على جهازه بدون Claude. التفاصيل بقسم 6ز.
9. **ذوق المونتاج ومكتبة CC0 (4.7):** قواعد المونتاج بالأرقام (الإيقاع، الهوك، الزوم، مدة النص، توقيت الرسومات، مستويات الصوت والمؤثرات) في `<engine>/references/editing-rules.md`، و128 صوت وموسيقى CC0 جديدة بالمكتبة (أرقامها `cc-…`) مقسمة على 12 قسم.
10. **موشن جاهز وهوية جديدة (4.8):** تسع قوالب حركة فوق المقطع (`type=mg`): رقم يعدّ، عنوان يضرب، قائمة صح تنكشف مع الكلام، مراحل، إشارة، اقتباس، نسبة بدائرة، مقارنة، وختم شعار. توقيتاتها من HyperFrames ونابضها من Remotion، وقواعد المخرج من Lemo-Opuscar، كلها في `<engine>/references/motion-kit.md`. وشعار هوجاس الجديد (رمز ثلاث قطع تايم لاين + HJS) بشاشات التحميل.
11. **كابشن أنظف وقص آمن (4.9):** كل سطر 5 كلمات، والأسماء المعروفة (شركات، موديلات، تطبيقات، معالم) تنكتب بالإنجليزي. خطه الخاص (ثمانية) افتراضي إذا مثبّت على جهازه، وخط العنوان للعنوان الثابت فوق بس. الحذف ما يشيل كلام مهم ولا آخر كلامه بدون موافقته، وما يخلّي كابشن يتيم، ويتراجع بضغطة. شعار الشركة يطلع لما ينذكر اسمها، و«X أفضل من Y» حركة هادية. وصور تخيلية للمواضيع المهمة. التفاصيل بقسم 6ح.
12. **اختيار الجمل وعشر حلول (4.10):** الإعادات والتلعثم والبدايات المتعثرة تنكشف من التسجيل الخام، وأنت (Claude) تختار الأفضل بكل مجموعة بالمعنى، والمستخدم يشوفها بتبويب «الجمل» ويسمع أي لقطة ويبدّل بضغطة. ومعها: كلمات مشكوك فيها بخط منقط، قاموسه يتعلّم من تصحيحاته، قطعات ما تنزل على صوت، فكرة مكررة، تقصير لمدة، خطة قبل البناء، كلام بدون كابشن، أرقام تتأكد منها، تحية بالبداية، وشريط خطوات. التفاصيل بقسم 6ط.

13. **Motion Graphics أساسي وهوية محفوظة (4.37):** عشر قوالب موشن من 16 مقطع مرجعي (خريطة أدلة لكل فريم)، تنطبق لحالها على أي طلب حركة (قسم 2ب)، وهوية لكل شخص بـ`identity.md` تنطبق على كل شي (قسم 2ج).

**متى تستخدمه:** مع كل مونتاج مقطع (حتى لو ما طلب الاستوديو بالاسم) · «افتح التايم لاين» · «عدّل الكابشن / الخط / الألوان» · «أضف شخصية / عنوان / مؤثر / صورة» · «شيل الحشو» · «طبّق ملاحظات الاستوديو» · «سوّ ترجمة» · «افتحه على جوالي» · «صدّر» · «سوّ لقطات من هالرابط» · «أبي أمنتجه بنفسي» · **أي طلب موشن أو حركة** («موشن جرافيك»، «أنيميشن»، «برومو»، «إعلان متحرك»، «عنوان متحرك»، «فيديو شرح»، «ريل سوشال»، «انترو»، «لوقو متحرك»، motion graphics, animation, promo, explainer, title) · «هذي هويتي» أو ملف هوية.

## وين الملفات

- **مجلد السكل `<skill>`:** المجلد اللي فيه هذا الملف، وفيه `hs.py` · `studio.html` · `app.js` · `i18n.js` · `ext.js` · `review.html` · `AGENT.md` · `qr.js` · `sfxlib.json` · `engine/` (وفيه `vision/` لمكان الوجه وقص الشخص) · `CHANGELOG.md` (سجل التحديثات، اقرأه لو سألك وش الجديد). التثبيت الموصى فيه: المستودع كامل منسوخ بـ git في `~/.claude/skills/hojas-studio/`، فكل الملفات بجنب هذا الملف، والتحديث `hs update`. لو المجلد اللي قرأت منه هذا الملف ما فيه `hs.py`، شوف آخر سطر بهذا الملف: `Skill files on this computer:` يكتبه `install` ومعه مكان الملفات. لو ما فيه، دوّر على `~/Documents/hojas-studio/`. لو ما لقيته بالمكانين قل له بجملة وحدة إن ملفات السكل ناقصة. لا تعيد كتابتها من راسك.
- **المحرّك `<engine>` = `<skill>/engine`:** `hs.py` يلقاه لحاله، ما تمرّر له شي. خطوات المونتاج كاملة في `<engine>/MONTAGE.md`: **اقرأه قبل أول مونتاج بالجلسة**، ومراجعه في `<engine>/references/` تنفتح عند الحاجة فقط.
- **مجلد الشغل `<work>`:** مجلد المشروع اللي تبنيه لكل مقطع (فيه `compose.html` · `caps.json` · `cutz.mp4` …).

يشتغل على جهازه فقط (Claude Code أو OpenCode محلي)، مو من السحابة. على ويندوز: `python` مو `python3`، والمسارات بشكل `C:/...`.

تحت: `hs` = `python <skill>/hs.py`.

## أسلوبك معه

عربي بسيط ومختصر. أنت اللي تجهّز وتشغّل، ما تعطيه قائمة أوامر. شي واحد بكل مرة، والنتيجة أول سطر.

## 1) أول ما تبدأ أي مونتاج ← افتح البث الحي

قبل أي خطوة مونتاج، حتى قبل ما يوصل الفيديو:

```bash
bash <engine>/scripts/00_setup.sh     # مرة وحدة، يفحص أدوات المونتاج (الخطوة 0 في MONTAGE.md)
hs doctor                             # مرة وحدة، يفحص أدوات الاستوديو
hs open <work>                        # يشغّل الخادم بالخلفية ويفتح المتصفح عنده، ويطبع الرابط
hs hub                                # المكتبة (مرة وحدة): المشروع يطلع فيها لحاله، ويفتحه من جواله
```

⛔ **قبل أي تثبيت:** لو `00_setup.sh` أو `hs doctor` قال فيه أداة ناقصة، لا تثبّت شي من نفسك. شغّل `hs tools` واعرض عليه بكلامك البسيط: اسم كل أداة ناقصة، وليش نحتاجها، ومن وين تنزل، وحجمها. مثال: «أحتاج أثبّت ffmpeg عشان يقص الفيديو ويطلّع الملف النهائي، برنامج مفتوح المصدر 90 ميقا. أثبّته؟». ثبّت بعد موافقته فقط (`00_setup.sh --install`)، ولا تثبّت أي شي غير اللي بالقائمة. ولو الناقص «مكتبة التصدير (puppeteer-core)» (أغلب اللي ركّبوه كبلقن): قل له «أحتاج أثبّت مكتبة صغيرة (8 ميقا) يتحكم فيها الاستوديو بكروم وقت التصدير، تنحفظ بـ ~/.hojas-studio وتبقى مع التحديثات. أثبّتها؟» وبعد موافقته `hs deps`. وطمّنه: المونتاج كله على جهازه، وما ينرفع فيديو ولا صوت لأي مكان.

قل له: «فتحت لك صفحة تتابع فيها المونتاج». ثم مع كل مرحلة اكتب سطراً يراه:

```bash
hs say <work> "شلت السكتات: 52 ثانية راحت"
hs say <work> "أفرّغ كلامك، 3 دقايق"
hs say <work> "جهز المقطع، افتح التايم لاين" --kind done
```

الصفحة تعرض المراحل (استلام · قص · تفريغ · كابشن · قص وزوم · مشاهد · رسم · نهائي) من ملفات المشروع تلقائياً، وآخر معاينة ترسمها (`prev/` و`sheet.jpg`). أول ما يجهز `compose.html` و`caps.json` و`cutz.mp4` و`vfr/` تتحول الصفحة لتايم لاين وحدها، والإضافة تتركّب على `compose.html` (سطر واحد آخر الملف + `hs-ext.js` بمجلد الشغل) بدون ما تسوي شي.

الرابطان (الجهاز + الجوال برمز دخول) محفوظان في `<work>/.hs/url.txt`، وزر «الجوال» داخل الاستوديو يطلّع QR يفتح واجهة الجوال (`/m`): المعاينة فوق، أزرار (نسخة، تراجع، إعادة، قص) والتايم لاين بمساراته، وتحت مايك كبير للملاحظة بالصوت ولوحة كتابة، وأي شي يختاره تنفتح لوحته من تحت. والأفضل يفتح كل مقاطعه من «المكتبة» (`hs hub`).

## 2) بعد التفريغ وقبل أي مونتاج ← اسأله ⛔ إلزامي

الترتيب ثابت: استلم الفيديو ← قص السكتات ← التفريغ ← **اختيار الجمل** (`hs takes <work> scan` ثم أنت تختار الأفضل بكل مجموعة ثم `hs takes <work> apply`، قسم 6ط) ← `hs caps clean <work>` (يشيل كلام whisper المخترع) ← صحّح النص ← `hs caps regroup <work>` (5 كلمات بالسطر على أنفاس الكلام والأسماء بالإنجليزي، `references/captions.md`) ← `hs fonts apply <work>` (خطه الخاص لو مثبّت) ← **قف هنا واسأله**. لا تصمّم مشاهد ولا ترسم قبل إجاباته. صفحة الأسئلة تغني عن الخطوة 5.5 في `MONTAGE.md` (عرض النص عليه): الجمل اللي يبي يشيلها يعلّمها بالصفحة نفسها. الخطوة 1 (هويته البصرية) صارت سؤالاً داخل الصفحة: لا تسأله عنها بالمحادثة.

⛔ **ممنوع أي سؤال عن المونتاج بالمحادثة.** لا ألوان، لا حساب، لا شكل كابشن، لا منصة، لا هوك. كل سؤال مكانه صفحة الأسئلة. اللي ما تغطيه الصفحة أضفه لها بـ `--file q.json`. المسموح بالمحادثة شي واحد: إذن تثبيت أداة ناقصة على جهازه.

```bash
hs brief <work> ask --hooks "صيغة 1" "صيغة 2" "صيغة 3" --topics "موضوع 1" "موضوع 2" --note "مقطعك 48 ثانية وفيه جملتين معادتين"
hs brief <work> wait          # ينتظر لين يضغط حفظ (9 دقايق بالكثير). لو طلع «لسه ما حفظ» أعد نفس الأمر
hs brief <work> apply         # يطبّق اللي يقدر عليه لحاله (المقاس، الكابشن، الألوان، الهوك، الختام، الزووم، المؤثرات، أسلوب الدحيح) ويطبع الباقي مهام
hs brief <work> check         # يفحص المشروع مقابل كل إجابة: ✓ أو □ مع السبب. يطلع برمز 4 لو باقي شي
hs brief <work> ok <رمز> "وش سويت"   # للبنود اللي ما تنفحص لحالها (نوع المقطع، ملاحظاته، المرجع، الألوان من المقطع)
```

⛔ **إجاباته شرط مو اقتراح.** كل إجابة تصير بند بقائمة تحقق، تشوفها أنت بـ `brief check` ويشوفها هو بتبويب «الفحص» بالاستوديو. **لا تسلّم ولا تصدّر قبل ما يطلع «كل إجاباته مطبّقة».** `hs export` يرفض لحاله لو فيه بند □ (إلا `--force` لو هو طلب). البند اليدوي ما تعلّمه ✓ إلا بعد ما تنفّذه فعلاً، والجملة اللي تكتبها تطلع له تحت البند.

- `--hooks`: 3 صيغ هوك تكتبها أنت من أقوى سطر بكلامه (مو أول جملة قالها).
- `--topics`: المواضيع اللي تستاهل صوراً توضيحية من كلامه (2 إلى 5).
- `--note`: سطر واحد يفيده وهو يجاوب (المدة، جمل معادة، شي لاحظته).
- أسئلة خاصة بهذا المقطع: `--file q.json` بشكل `[{"id":"price","q":"أذكر السعر بالكابشن؟","options":["نعم","لا"]}]`. لا تكرر أسئلة الصفحة.
- الصفحة تسأله عن: **الهوية** (هويته المحفوظة مختارة لحالها، أو «هوية جديدة» يرفع ملف أو يكتب وصف، قسم 2ج) · **الأسلوب** (عادي · **موشن جرافيك** · بودكاست · ورق متحرك · الدحيح) · نوع المقطع (وفيه «أخرى» يكتب فيها بكلماته) · المنصات (تيك توك، انستقرام، إكس، لينكدإن) · مقاس المقطع (9:16، 4:5، 1:1، 16:9) · المدة والإيقاع · شكل الكابشن ومكانه · الترجمة · الهوك · الشخصية · الصور والمقاطع (حقيقية / مولّدة / يرفعها) · كروت الشرح (بدون / قليل / متوسط / كثير) · المؤثرات والصوت · القص (حشو، إعادات، جمل يعلّمها) · الختام والهوية · ملاحظات حرّة · **ألوان حسابه** (يختار لي من المقطع / أبيض وأسود / ألوانه بمنتقي ألوان) واسم حسابه.
- قل له بالمحادثة سطراً واحداً فقط: «فتحت لك صفحة الأسئلة، جاوب واضغط حفظ وأبدأ». لا تلحقه بأي سؤال.
- بعد ما يحفظ تتحول الصفحة نفسها لصفحة المعاينة الحية (مراحل الشغل ولقطات منه)، ولما تخلص تتحول للتايم لاين تلقائياً. لا تقفل `hs open` ولا تسلّم المقطع بالمحادثة فقط: التسليم دايماً على صفحة المعاينة.
- `apply` يطبّق: ألوان الحساب (يكتب `theme.json`)، الكابشن، الترجمة، الهوك، الشخصية، الهوية، المقاس، ويرفع الكابشن لداخل المنطقة الآمنة لمنصاته. والباقي يطلع لك قائمة مهام بأوامرها الجاهزة. **نفّذها كلها** وبالترتيب اللي تقوله (القص قبل تصميم المشاهد).
- لو كتب نوع المقطع بنفسه («أخرى»): افهم من كلامه الأسلوب المطلوب وامش عليه. لو ما وضح خذ أقرب تفسير، نفّذه، واذكر له بسطر وش فهمت.
- لو ما جاوب خلال الانتظار وقال لك بالمحادثة «كمّل»: كمّل بالافتراضي واذكر له ذلك.

### المنصة تحدد المونتاج ⛔

`apply` يطبع آخر شي «وش تحتاج منصاته». هذي مو معلومة للقراءة، هذي شروط المونتاج. نفس الدليل بأي وقت: `hs platform tiktok instagram x linkedin`.

| المنصة | المقاس | الأنسب | وش يفرق بالمونتاج |
|---|---|---|---|
| تيك توك | 9:16 | 20 إلى 45 ث | هوك بأول ثانية ونص بلا مقدمة · تغيير بصري كل 2 إلى 3 ثواني · كلمات البحث تنقال وتنكتب · ختام يرجّع لأول المقطع أو يطلب تعليق |
| انستقرام | 9:16 أو 4:5 | 15 إلى 45 ث | لحظة تستاهل تنرسل لصديق · الوجه والعنوان بالوسط (الشبكة تقص 3:4) · الكابشن أعلى (الوصف يغطي آخر ثلث) · بلا علامة مائية |
| إكس | 16:9 أو 1:1 أو 9:16 | 15 إلى 45 ث | يشتغل صامت فالفكرة تنفهم من النص من أول فريم · رأي أو معلومة من أول جملة · 140 ثانية بالكثير للحساب العادي |
| لينكدإن | 4:5 أو 1:1 أو 9:16 | 30 إلى 90 ث | نبرة مهنية وفائدة من أول جملة · إيقاع أهدأ · بلا ترندات وموسيقى صاخبة · ختام سؤال يفتح نقاش |

- اختار أكثر من منصة؟ امش على الأشد (أقصر مدة، أعلى مكان كابشن)، و`apply` يطبع لك نطاق الكابشن الآمن للكل.
- الهوك، الإيقاع، عدد الصور، نبرة نص البوست في `post.txt`: كلها تتبع المنصة. مقطع لينكدإن بإيقاع تيك توك غلط، والعكس.
- أرقام تيك توك وانستقرام من أدلة المقاسات المنشورة، وإكس ولينكدإن تقدير محافظ. حد لينكدإن 15 دقيقة على كل الأجهزة (تحديث 2026-10-11). لو قال لك رقماً مختلفاً من تجربته امش على كلامه.

### المقاس

المحرّك يركّب عمودي 1080×1920 دايماً. المقاسات الثانية تطلع وقت التصدير ومعها الماستر العمودي:
- **4:5 و1:1:** قص من فوق وتحت. `apply` يطبع لك الحزام (مثلاً بين 12% و82% من الارتفاع): الوجه والنصوص والصور والهوك لازم داخله. زر «مناطق الأمان» بالاستوديو يوريه.
- **16:9:** المقطع بالنص وخلفية مغبّشة منه على الجنبين. قل له هذا بوضوح قبل ما يتوقع عرضي يملأ الشاشة.
- تغييره بعدين: `hs set <work> frame.ar="1:1"` · مكان القص `frame.cy=0.47` · أو نسخة وحدة: `hs export <work> --frame 4:5`.

### الصور والمقاطع التوضيحية

```bash
hs media <work> search "Berlin 1945 newsreel" --video # مقاطع حقيقية برخص حرّة (أرشيف، أماكن، علوم). الاستعلام بالإنجليزي
hs media <work> add 1 --at 12.4 --dur 4 [--from 8]     # ينزّل المقطع ويقص 4 ثواني ويحطها بي-رول عند الجملة
hs shot <work> github.com/user/repo --at 20            # لقطة لصفحة موقع داخل إطار متصفح وتتحرك لتحت
hs media <work> search "World War II Berlin 1945"      # صور برخص حرّة من ويكيميديا كومنز، الاستعلام بالإنجليزي
hs media <work> add 2 --at 12.4 --dur 3 --fit card     # card كرت فوق · cover ملء الشاشة بحركة بطيئة
hs gen <work> request image "وصف بالإنجليزي" --at 20 --fit cover   # يحفظ طلب توليد ويطبع النص الجاهز
hs gen <work> request video "وصف" --at 31
hs gen <work> list                                     # الطلبات اللي تنتظر ونصها
hs gen <work> import 3 "C:/Users/…/Downloads/الناتج.png"   # يدخّل الناتج التايم لاين (صورة ← طبقة · مقطع ← بي-رول)
hs gen <work> import 3 "https://…/image.png"            # (4.9) أو رابط الناتج مباشرة
hs gen <work> moments 4                                # (4.9) أهم الجمل اللي تستاهل صورة تخيلية
```

- **المقاطع الحقيقية أول خيار للمواضيع التاريخية والأماكن والأخبار** (تكلم عن الحرب العالمية ← `search "World War II …" --video`). للتقنية والمواضيع الحديثة غالباً ما تلقى شي مناسب: استخدم لقطة موقع (`hs shot`) أو صورة أو توليد. بعد الإضافة ارسم معاينة وتأكد إن اللقطة تطابق كلامه، وإلا احذفها.
- ذكر موقعاً أو أداة أو مستودعاً؟ `hs shot` بدل ما توصفه.
- اربط كل صورة بالجملة اللي تتكلم عنها (وقت أول كلمة فيها). صورة كل 5 إلى 8 ثواني تكفي، ولا تغطّي وجهه بلحظات الهوك والانفعال.
- شوف نتائج البحث قبل ما تضيف: العنوان لازم يطابق الموضوع فعلاً. لو ما لقيت شي مناسب لا تحط صورة غلط.
- **التوليد من حسابه الشخصي، بلا مفاتيح API أبداً.** لا تطلب منه مفتاحاً ولا تستخدم واحداً. لكل طلب ينتظر، بهذا الترتيب:
  1. **متصفحه (Claude in Chrome):** افتح ChatGPT للصور (`chatgpt.com`) أو Gemini للمقاطع (`gemini.google.com`) وهو مسجّل دخوله، الصق النص الجاهز من `gen list`، انتظر الناتج، نزّله، ثم `gen import <رقم> <مسار الملف في Downloads>`.
  2. **ما فيه متصفح؟** موصل التوليد المربوط بحسابه (Higgsfield): ولّد، نزّل الناتج لمجلد المشروع، ثم `gen import`. يسحب من رصيده فقل له قبلها.
  3. **ما فيه ولا واحد؟** خلّ الطلب ينتظر وقل له بجملة: يفتح «الملفات» بالاستوديو، يضغط «افتح ChatGPT» أو «افتح Gemini» (الوصف ينتسخ تلقائياً)، يولّد وينزّل، ثم «ارفع الناتج».
- التوليد محسوب على اشتراكه وحدوده اليومية: لا تولّد إلا لو اختار «مولّدة» بالأسئلة أو طلبها، ولا تتعدى العدد اللي اختاره. لو الموقع قال الحد خلص، وقّف وقل له.
- لا تولّد صورة شخص حقيقي معروف ولا شعاراً أو شخصية معروفة.
- مصادر الصور الحقيقية تنحفظ تلقائياً وتطلع في حزمة النشر (`credits.txt`).

## 2ب) Motion Graphics (موشن جرافيك) ⛔ أساسي

الموشن جرافيك جزء أساسي من السكل، مو زينة ولا ميزة إضافية. المرجع كامل: `<engine>/references/motion-graphics.md` (خريطة أدلة 16 مجلد، 93 تقنية، عشر قوالب، البرومبت الرئيسي، فحص التسليم). **اقرأه كامل قبل أي موشن.**

**متى ينطبق لحاله (التوجيه):**
- الطلب فيه حركة أو أنيميشن أو برومو أو إعلان أو عنوان متحرك أو شرح أو فيديو سوشال (بأي صيغة، عربي أو إنجليزي) ← طبّقه بدون ما ينطلب بالاسم.
- اختار «موشن جرافيك» بصفحة الأسئلة أو بالمكتبة (`hs.wantStyle=motion`) ← أساسي بكل المقطع، و`brief apply` يطبع لك المهمة و`brief check` يفحصه.
- أي مونتاج عادي: كل رقم وقائمة ومقارنة وكلمة مفتاح لها موشن من القوالب (مو بس كابشن).
- ⛔ **قال صراحة ثابت** («صورة»، «بوستر»، «بدون حركة»، «بدون موشن»): لا تطبّقه، وقل بسطر إنه موجود لو يبيه.

**أي قالب:** جدول قسم 3 بالمرجع. مقاطع حسابه الشخصية = **MG-05** (وجهه + إدخالات موشن عند الهوك وكل فكرة) إلا لو طلب غيره. قالبين بالكثير بالمقطع.

| القالب | لـ |
|---|---|
| MG-01 كولاج تحريري | افتتاحية، عنوان فني |
| MG-02 برومو فاخر رمادي | منتج، براند، إعلان |
| MG-03 استعارة تبعد وتكشف | فكرة لها صورة، تحليل |
| MG-04 أرشيف وثائقي | قصة شخص، اقتباس |
| MG-05 متكلم + إدخالات ⭐ | مقاطع حسابه (الافتراضي) |
| MG-06 «هل تعرف؟» | معلومة، رقم، دراسة |
| MG-07 كلمة حمرا بوجهين | رأي حاد، نصيحة |
| MG-08 تقني أبيض بأيقونات | ذكاء اصطناعي، أدوات، قبل وبعد |
| MG-09 قصة رمزية بالأشكال | مشاعر، رحلة، فاصل فني |
| MG-10 لوب بلا نص | خلفية، ختم، انتظار |

**الخطوات (داخل مسار المونتاج العادي، بعد صفحة الأسئلة):**
1. هويته أول (`hs identity show`، قسم 2ج): كل متغير بالقالب (`{{ACCENT}}` `{{BG}}` `{{CTA}}`…) منها.
2. جملة وحدة تلخص المقطع، ووين الفايدة (قبل الثانية 5).
3. خريطة ضربات من `caps.json`: كل كلمة مهمة ← عنصر بوقتها.
4. ابنِ بالطبقات حسب «البناء بـ hs» بالقالب (`type=mg` · `viz` · `split` · `cover` · `behind` · `anno` · `kinetic` · `hs kf` · `hs media` · `hs gen` من حسابه بعد موافقته).
5. معاينة 4 إلى 6 لقطات، وفحص قسم 7 بالمرجع.
6. `hs brief <work> ok mg "MG-xx: وش بنيت"` لو اختار الأسلوب بالصفحة.

**صفحة فاضية (موشن بدون الفيديو تحته):** خلفية `type=image fit=cover move=none anim=none` + `nocap=true` + `viz … layout=bare color=…` على الفاتح + `mg stat dim=0`، والتفاصيل المجرّبة بقسم 6 بالمرجع.

**قواعد فوق المراجع ⛔** (المراجع تسوي عكسها، احنا لا): أول فريم فيه محتوى · الكتابة حرف حرف مو بالهوك · ولا فريم فاضي بين المشاهد ولا نهاية سودا · وجهه أو الأداة الحقيقية تطلع بمقاطع حسابه · ولا عنصر يغطي نص · دعوة بكلمة وحدة ثابتة · تحت 40 ث للشورت · التصدير 1080×1920.

## 2ج) الهوية المحفوظة (`identity.md`) (4.37)

كل شخص أو براند له هوية وحدة تنكتب **مرة** وتنطبق لحالها على **المونتاج العادي والموشن جرافيك والبودكاست**، فما يعيد يطلبها. الدليل: `<engine>/references/identity.md`.

- **وين:** `~/.hojas-studio/identity/<الاسم>/`: `identity.md` (أنت تكتبها) · `identity.json` (الألوان والخطوط والحساب والدعوة والشعار والقالب المفضل) · `request.md` (كلامه) · `files/` (اللي رفعه).
- **من وين تجي:** صفحة الأسئلة (قسم «ألوان حسابك»: «هويتي» مختارة لحالها، أو «هوية جديدة» يرفع ملف أو يكتب لك كيف يبيها) · المكتبة لأي نوع مشروع (Claude يمنتجه، موشن جرافيك، يدوي، بودكاست) · أو بالمحادثة («هذي هويتي» مع ملف ← `hs identity new "الاسم" --text "…" --file …`).
- **وش ينطبق لحاله:** `theme.json` (الخلفية والكتابة والمميز والخط والحساب) · لون الكلمة المنطوقة وخط الكابشن · كلمة الدعوة بكرت الختام · الشعار بـ`assets/identity-logo.*` · صندوق اسم المتكلم بالبودكاست · الخطوط اللي رفعها. والمشروع يحفظ اسمها (`hs.identity`).
- **مسودة؟** «هوية جديدة» تنحفظ مسودة من وصفه (الألوان والخط والحساب). المشروع يجيك ومعه مهمة «الهوية لسه مسودة»: اقرأ ملفاته وطلبه، **اكتب `identity.md` كامل** بأقسام الدليل، `hs identity set` للأرقام، `hs identity check` لين يطلع سليم، ثم `hs identity apply <work>`. قله بسطر وش صممت.
- **قبل أي تصميم:** `hs identity show` (أو اللي بـ`hs.identity`) واقرأ `identity.md`. إجاباته بالصفحة لهالمقطع تتقدّم عليها، والهوية ما تتغيّر إلا لو قال «عدّل هويتي».
- الأوامر: `hs identity list | new | show | set | check | default | apply <work> | path`.

## 3) قبل التسليم ← حوّله على التايم لاين

بعد ما تخلص تصميم المشاهد وقبل الرسم النهائي:

1. **الترجمة الإنجليزية لو طلبها بالأسئلة (تكتبها أنت، الاستوديو ما فيه مترجم وهذا مقصود للجودة):** `hs tr <work> export` ← اكتب `en.json` بشكل `[{"i":0,"en":"…"}]` ← `hs tr <work> import en.json`. المعنى مو الحرف، جملة قصيرة تنقرا بنظرة (8 كلمات تقريباً)، بلا كلام ما قاله، والأسماء والمصطلحات التقنية كما هي. لو ما يبغاها ظاهرة: `hs set <work> en.on=false` (تبقى محفوظة ويشغّلها بضغطة).
2. **الهوية:** `hs brand <work> list` ولو عنده هوية `hs brand <work> apply <اسم>`.
3. **الفحص:** `hs check <work>` وعالج اللي تقدر عليه (ثبات بصري طويل ← مؤثر أو طبقة أو مشهد). ويطبع سطرين من التحديث المجدول: **«أول 3 ثواني»** (كلام يبدأ متأخر · ما فيه تغيير بصري · ما فيه عنوان على الشاشة بأول ثانية) وعلاجها هوك أو نص أو زوم بالبداية، و**«المدة»** لو المقطع يتعدى حد منصة مختارة (إكس 140 ث · انستقرام 3 دقايق · تيك توك 10 دقايق · لينكدإن 15 دقيقة) أو بعيد عن المدى الأنسب لها. لو تعدى الحد قصّر المقطع أو قل للمستخدم قبل التصدير.
4. **التقريب والانتقالات لو طلبها:** `hs auto <work> zooms` (كلمة بارزة كل ثانيتين ونص بالكثير) · `hs auto <work> transitions` (انتقال يكمّل الحركة عند تغيّر الفكرة بس، اتجاه واحد، `references/motion.md`). مونتاج على أغنية: `hs beat <work> <الموسيقى>` ثم `hs auto <work> beats` (`references/music.md`).
4ب. **قبل تصميم المشاهد اقرأ `references/story.md`**: الهيكل، الهوك، عدد الكروت، «اعرض لا تعدّد».
4ج. **الموشن جرافيك (قسم 2ب):** القالب من `references/motion-graphics.md` على هويته، وفحص قسم 7 فيه (أول فريم، الفايدة قبل 5 ث، لا نص فوق نص، لا نهاية فاضية، دعوة بكلمة).
5. **نص البوست:** اكتبه في `<work>/post.txt` بأسلوب منصته (تيك توك وانستقرام: سطر هوك و5 هاشتاقات · إكس: جملة رأي قصيرة بلا حشو هاشتاقات · لينكدإن: فقرة مهنية قصيرة تنتهي بسؤال). أكثر من منصة؟ اكتب نسخة لكل وحدة تحت عنوانها.
6. **لقطة الأسلوب:** `hs style snap <work>`. اللي يغيّره بعدها بالتايم لاين ينحسب من ذوقه، والتصدير يتعلّم منه لحاله.
7. `hs say <work> "جهز، عدّل لمساتك" --kind done` وقل له بالمحادثة: «المقطع على التايم لاين، عدّل اللي تبغاه وصدّر من زر التصدير، أو قل لي وأصدّر». ولو يبي يعدّل بنفسه: زر «مونتاج يدوي» فوق، و«اسأل Claude» يرجّعك له وقت ما يحتاج.

⛔ **لا تسوي الرسم النهائي الكامل قبل ما يقول لك.** الاستوديو يعرض المقطع حيّاً بدون رسم، فيعدّل لمساته أول ثم يصدّر مرة وحدة (يوفّر وقت وتوكنز). ارسم معاينات فقط (3 إلى 6 لقطات) للتأكد.

التصدير: هو من الاستوديو، أو أنت بـ`hs export <work>` (`--hooks` نسخة لكل هوك · `--clean` بلا كابشن · `--frame 4:5` مقاس ثاني) ثم `hs pack <work>` لحزمة النشر. يطلع `ad-master.mp4` العمودي دايماً، ومعه `ad-4x5.mp4` أو `ad-1x1.mp4` أو `ad-16x9.mp4` لو مقاسه غير. افتح لقطة من النسخة المقصوصة وتأكد إن ما انقص نص أو وجه. بعد التصدير شغّل فحص المنطقة الآمنة (`<engine>/scripts/08_safe_check.js`).

## 4) وش بالاستوديو (عشان تعرف توجّهه)

- **وضعين بصفحة وحدة (4.18):** زر فوق يبدّل بين «Claude يمنتج» و«مونتاج يدوي» (التفاصيل بقسم 6ن).
- **يسار:** «النص» (بحث، تمييز كلمة، تعديل، حذف جملة) و«العناصر» (كان اسمه «الملفات»: رسم حر، مقاطع بي-رول، بحث صور، توليد بالذكاء، افتتاحات ونصوص، صيغ الهوك، شخصيات، مؤثرات وتقريب وانتقالات تلقائية، مؤثرات صوتية، صور، خطوط).
- **«طبّق على: هذا فقط / الكل»:** لما يحدد جملة أو نصاً أو شخصية ويغيّر مكانها أو لونها أو حجمها، يختار هل التغيير عليها وحدها أو على كل مثيلاتها. يسحب الدائرة على الشاشة للتحريك.
- **ستايلات كابشن جاهزة** (20) بتبويب الكابشن وبصفحة الأسئلة: نظيف · صندوق · كبسولة · جريء · كاريوكي · كلمة كلمة · شريط · سطور بيضاء · خط تحت الكلمة · تعبئة · ثلاث كلمات · كلمتين · مفرّغ · ريترو · هادي · كوفي · نسخ · نسخ كلمة كلمة · قزاز · مرح. وتحميل لقطة كفر من زر تحت المعاينة.
- **حركات وأرقام** في «الملفات»: نسبة من نقط · شبكة أشخاص · دائرة تتعبى · مقارنة أعمدة · خريطة ومسار · ختام بكلمة · شاشة كلمة. و**لقطة موقع** بكتابة الرابط. وبحث «مقاطع» جنب «صور».
- **ستايل القزاز:** خلفية نص «قزاز»، ستايل كابشن «قزاز» و«نسخ كلمة كلمة»، وإطار للصور: قزاز · حلقة · متصفح · بوست.
- **كروت الشرح:** من «الملفات» يختار الشكل (نقاط · خطوات · مخطط · مقارنة · رقم كبير · صح وغلط · خط زمني · قمع · اقتباس). الشرح المتحرك فوق والمتحدث تحت، والفيديو ينزل ويرجع بحركة ناعمة. حجم الكرت ومكان وجهه ينضبطون لحالهم (التفاصيل بقسم «كروت الشرح» تحت).
- **الشخص والخلفية:** يغيّر الخلفية ورا المتحدث (تغبيش · أبيض وأسود · تعتيم · لون · تدرّج · استوديو · صورة) أو يحط نصاً يمر خلفه. أول مرة تاخذ ثواني لفصل الشخص، وكله على جهازه.
- **أصواتي:** في «الملفات» تحت المؤثرات الصوتية. يرفع ملفاته (مؤثرات، موسيقى، صوت شعاره) أو يحطها بالمجلد، ويسمّيها ويكتب متى تنستخدم.
- **الخصوصية والأدوات:** بتبويب المشروع، يعرض الأدوات المستخدمة وليش، ووش اللي يتصل بالنت.
- **بلا أكواد:** المدن تنكتب بالاسم، أرقام الأعمدة صفوف، وزن الخط بالاسم، والتوقيت بزر «يبدأ من المؤشر». لو سألك عن شي ما فهمه بالواجهة اشرحه بكلمة عادية، لا تعطيه كود.
- **تحديد لقطة وقص أطرافها:** يضغط على أي لقطة بتراك الفيديو (بين قصتين) فتتحدد، ويسحب طرفها الأبيض عشان يقص من أولها أو آخرها، أو يحذفها كاملة.
- **علامة القص:** مربع أبيض على تراك الفيديو عند كل قصة. يضغطه ويختار انتقال بين اللقطتين، أو يطبّقه على كل القصات. والمؤثرات في «الملفات» مربعات فيها مثال حي.
- **«مناطق الأمان»** زر تحت المعاينة: يوري اللي تغطيه واجهة منصاته وحدود القص لو المقاس مو 9:16.
- **طلبات التوليد** في «الملفات»: يكتب الوصف ويضغط «اطلب صورة» أو «اطلب مقطع»، وكل طلب له: افتح ChatGPT/Gemini · ارفع الناتج · خلّ Claude يولّده.
- **بعد التصدير:** يحمّل الملف، أو يضغط «على الجوال» ويصوّر الرمز فيتحمّل على جواله.
- **يمين:** العنصر المحدد · الكابشن · الترجمة · الصوت · الفحص · الملاحظات · Claude · المشروع (تصدير، حزمة نشر، المقاس والمنصات، مقارنة نسختين، هويات، نسخ).
- **التايم لاين:** طبقات (3 صفوف) · كابشن · مشاهد ومؤثرات صوتية · فيديو · صوت · فحص · ملاحظات.
- **4.0 (دمج 30 سكل فيديو):** بـ«الملفات»: **انتقالات** تكمّل الحركة (انزلاق · دخول · خروج · تركيز · سحبة · لفّة · دائرة) واتجاهها · **علامات بخط اليد** (دائرة · خط تحت · سهم · مربع · تظليل · صح · خطأ) · **مؤشر ماوس** يضغط · **شريط اسم** (4 أشكال) · **صورة داخل صورة** (وجهه بزاوية والشاشة للشرح) · **كولاج ورقي** من صوره · **الطابع** (12 طابع جاهز) · **تلوين الفيديو** (11 تلوين). وبحركات الأرقام: خط بياني · عدّاد سلوت · خبر بتظليل. وبالكابشن: تمييز توهّج وقلم تظليل. وبالصوت: تحسين الصوت (6 أشكال) وخفض الموسيقى وقت الكلام. و«الفحص» يعطي نصايح إيقاع وقراءة.
- **4.1:** زر «الجوال» فيه **إشعارات الجوال** (ntfy) · كرت الختام فيه **اختيار الخط** · التصدير **يتعلّم أسلوبه** · **النشر** من متصفحه (قسم 6ج).
- **4.2:** طبقتين جداد: **ورق متحرك** (`type=kinetic`) و**كرت مكتب** (`type=desk`)، ولكل وحدة لوحتها. وصفحة الأسئلة فيها «أسلوب المونتاج».
- **كرت الختام بالتايم لاين:** مربع «كرت الختام» آخر تراك الفيديو. يضغطه فيعدّل نصه (سطرين، دعوة، كلمة بارزة، سطر صغير، نقاط)، ويسحب طرفه اليمين يغيّر مدته، أو يحذفه. ويضيفه من «الملفات» لو ما فيه. التشغيل يكمل لآخر الختام. نصه تكتبه أنت بـ`studio.json` ← `outro` `{l1,l2,cta,word,sub,chips}` ومدته `sfx.json` ← `outro` (0 = بلا ختام). لو كتبت compose مخصص، خلّ كرت الختام يقرأ من `OUTRO_T` عشان يتعدّل من الاستوديو.
- **السحب:** المغناطيس يلصق على 6 بكسل بس، و`Alt` وقت السحب يطفيه. السحب قرب طرف التايم لاين يمرّره لحاله. الكابشن ماشي مع الصوت، فيتحرك بحدود السكتة اللي حوله والجيران يتقلصون لحد كلماتهم. عشان يغيّر وقته أكثر يسحب أطرافه.
- **الأدوات:** تحديد `A` · قص `B` · مغناطيس `N` · معاينة بالمرور `S` · ربط الصوت بالصورة `L` · ملاحظة `M` · مسافة تشغيل · الأسهم فريم · `Shift`+سهم ثانية · `Del` حذف · `Ctrl+Z` تراجع · `Ctrl+D` تكرار · `Ctrl+F` بحث.
- **القص من الفيديو:** بأداة القص (`B`) أو المقص تحت الفيديو يقص المكان، فينفصل المقطع قطعتين بينهم فراغ (مو خط)، يحدد القطعة ثم حذف. علامات القص تنحفظ بالمشروع (`hs.marks`) وتنمسح بعد أي قص فعلي.
- **التراجع (4.14):** كل تغيير ينحفظ خطوة بسجل داخل المشروع (`.hs/hist`): تعديلاته، وأوامرك أنت، والقص. `Ctrl+Z` و`Ctrl+Shift+Z` يشتغلون حتى بعد ما يقفل الاستوديو أو يحدّث الصفحة، والقص يرجع ويعاد بناء الفيديو لحاله. أنت: `hs undo <work>` · `hs redo <work>`. قال «رجّع اللي سويته» ← `hs undo` مو تعديل يدوي.
- **الواجهة عربي وإنجليزي** من زر أعلى الصفحة.
- **تبويب Claude:** يكتب طلباً ويضغط «نفّذ» فيشتغل Claude Code على جهازه بدليل `AGENT.md`. لو Claude Code مو مثبّت، الطلب ينسخ ويلصقه لك.
- **مراجعة العميل:** رابط برمز خاص، العميل يعلّق على أي ثانية ويرسم ويعتمد. تعليقاته ما توصلك إلا لو المستخدم حوّلها لملاحظة.

## 5) الأوامر: تعدّل أي شي بالاستوديو

| تبغى | الأمر |
|---|---|
| الجمل مرقّمة | `hs text <work> show` |
| تعديل نص جملة | `hs text <work> 4 "النص الجديد"` (الترقيم من 1) |
| الكابشن والترجمة والصوت | `hs set <work> cap.on=true cap.font=Tajawal cap.size=70 cap.y=72 cap.enter=pop cap.bg=box cap.bgColor="#3B1D8F" en.size=40 mix.voice=1.2 mix.clean=true mix.sfx.tap=0.5` |
| طبقة نص | `hs layer <work> add type=text text="عنوان" s=1.2 e=4 x=0.5 y=0.22 size=96 bg=pill bgColor="#D2558F" anim=pop` |
| شخصية | `hs layer <work> add type=char char=robo s=0 e=30 x=0.2 y=0.62 size=0.26 color="#8F73F5"` |
| صورة | `hs layer <work> add type=image src="assets/logo.png" s=2 e=6 x=0.5 y=0.3 w=0.4` |
| مؤثر | `hs layer <work> add type=fx fx=punch s=6.1 e=7.4 amount=0.7` |
| كرت شرح | `hs layer <work> add type=split style=steps title="ثلاث خطوات" "text=الأولى\nالثانية\nالثالثة" s=12.4 e=18` (الأشكال بقسم «كروت الشرح») |
| خلفية المتحدث | `hs layer <work> add type=bg mode=blur s=8 e=12` (`mode`: blur · bw · dim · color · grad · studio · image) |
| نص خلف الشخص | `hs layer <work> add type=behind text="بضغطة" s=8.3 e=9.4 color="#FFD21F"` |
| صورة داخل صورة | `hs layer <work> add type=pip pos=tr size=0.36 s=12 e=18` (`pos`: tr · tl · br · bl · `circle=true` دائري · `deco` · `bgColor`) |
| علامة بخط اليد | `hs layer <work> add type=mark kind=circle x=0.5 y=0.3 w=0.4 h=0.08 s=5 e=7 color="#FFD21F"` (`kind`: circle · underline · arrow · box · highlight · check · cross) |
| رسم حر | `hs layer <work> add type=draw pts='[[0.3,0.3],[0.5,0.25],[0.7,0.3],null,[0.4,0.6],[0.6,0.6]]' color="#FFD21F" lw=12 reveal=0.9 s=4 e=7` (نقاط من 0 إلى 1، `null` يرفع القلم · `glow`: shadow · neon · none) |
| حركة بالمفاتيح | `hs kf <work> L3 add 2.0` ثم `hs kf <work> L3 add 3.5 dx=-300 dy=120 s=1.3 r=10 e=back` (الوقت بالتايم لاين · `preset across|grow|rise|spin|pulse|sway` · `list` · `rm <ث|all>`). التفاصيل بقسم 6ر |
| مؤشر ماوس | `hs layer <work> add type=cursor x=0.62 y=0.4 at=1.0 s=20 e=23` (`at` وقت الضغطة من بداية الطبقة · `from`: bottom · left · right · `style`: light · dark) |
| شريط اسم | `hs layer <work> add type=lt style=bar text="الاسم" sub="الوصف" s=1 e=5` (`style`: bar · card · tag · line · `side`: right · left) |
| قالب موشن جرافيك (4.37) | اقرأ `references/motion-graphics.md` ← القالب (MG-01 إلى MG-10) ← أوامر «البناء بـ hs» فيه بمتغيرات هويته |
| هويته (4.37) | `hs identity list` · `new "الاسم" --text "…" --file …` · `show` · `set <الاسم> colors.acc=#… fonts.head=… cta=…` · `check` · `default` · `apply <work>` (`references/identity.md`) |
| موشن جاهز | `hs layer <work> add type=mg kind=stat value=100 prefix=$ "label=الوصف" s=10 e=13.5` (`kind`: stat · slam · check · steps · callout · quote · ring · compare · sting · logo، و4.28: stretch · rec · notif · search · apps · articles · mosaic · rewind · ba، و4.36: freeze تجميد اللقطة، تفاصيلها بقسم 6ق). **اقرأ `references/motion-kit.md` قبل أول قالب** |
| كولاج ورقي | `hs layer <work> add type=collage items='[{"src":"assets/a.png"},{"src":"assets/b.png"}]' bgColor="#E07A3F" s=8 e=12` (`references/looks.md`) |
| انتقال عند قصة | `hs layer <work> add type=fx fx=curve seam=12.4 s=12.1 e=12.75 dir=right` (أو `hs auto <work> transitions type=push`) |
| طابع | `hs look <work> list` · `apply dossier` · `off` |
| تلوين الفيديو | `hs set <work> grade.preset=skin grade.amount=0.8` |
| الكابشن على الأنفاس | `hs caps <work> regroup [كلمات_السطر أسطر سكتة]` (الافتراضي 5 2 0.5) · `hs caps <work> names` (الأسماء بالإنجليزي بس) · `hs caps <work> clean [--dry]` |
| خطوطه الخاصة | `hs fonts list` · `hs fonts install <zip>` · `hs fonts apply <work>` |
| شعار شركة | `hs logo <work> plan` · `hs logo <work> auto` · `hs logo add <الاسم> <ملف\|رابط>` |
| لحظات الصور التخيلية | `hs gen <work> moments [عدد]` |
| إيقاع موسيقى | `hs beat <work> my3` ثم `hs auto <work> beats` |
| تحسين الصوت | `hs set <work> mix.voiceFx=clarity mix.duck=0.45` (clarity · deboom · demud · soft · radio · phone) |
| تلاشي الصوت بالخلفية | `hs set <work> mix.bgIn=1 mix.bgOut=4` (بالثواني من 0 إلى 6 · الافتراضي 1 و1.4 · نهاية 3 إلى 5 ثواني تعطي ختام هادي) |
| كتم كلمة (بيب) | `hs bleep <work> word فلان شركة` (كل مرة انقالت) · `hs bleep <work> at 12.4` (الكلمة عند هالثانية) · `list` · `rm 2` · `rm all` · `mode beep\|mute` · `cap stars\|hide\|keep` · `tone 1000` |
| أصواته الخاصة | `hs sfx <work> list` (تطلع تحت «أصوات المستخدم») · `hs sfx <work> add my2 12.4` · `hs sfx <work> import "C:/…/ملف.mp3" --name "ضحكة" --note "مع النكتة"` |
| وش الأدوات وليش | `hs tools` |
| حركة أرقام | `hs layer <work> add type=viz kind=<النوع> s=<ث> e=<ث> …` (الجدول تحت) |
| شاشة كلمة وحدة | `hs layer <work> add type=cover text="هذا" s=4.1 e=4.9 bgColor="#F3F2EE" font="Noto Naskh Arabic"` |
| نص على قزاز | `hs layer <work> add type=text text="مجاني\nومفتوح المصدر" bg=glass font="Noto Naskh Arabic" y=0.72 s=30 e=33` |
| أيقونة أو صورة بإطار | `hs layer <work> add type=image src="assets/icon.png" frame=glass w=0.16 x=0.3 y=0.3 s=5 e=8` (`frame`: glass · ring · browser · post) |
| لقطة موقع | `hs shot <work> <الرابط> --at <ث> [--dur 4] [--top]` |
| إدارة الطبقات | `hs layer <work> list` · `set L3 y=0.4` · `rm L3` |
| الهوك | `hs hook <work> set "…" "…"` · `active 2` · `off` |
| صور حقيقية | `hs media <work> search "…"` · `add <رقم> --at <ث> [--dur 3] [--fit card\|cover]` |
| توليد من حسابه | `hs gen <work> request image\|video "…" [--at <ث>]` · `list` · `import <رقم> <ملف>` · `rm <رقم>` |
| المنصات والمقاس | `hs platform [tiktok instagram x linkedin]` · `hs set <work> frame.ar="4:5" frame.cy=0.47` |
| تلقائي | `hs auto <work> zooms` · `transitions` · `clear zooms` |
| الأسئلة | `hs brief <work> ask …` · `wait` · `show` · `apply` · `check` · `ok <رمز> "…"` |
| الفحص | `hs check <work>` |
| القص من الفيديو والصوت | `hs remove <work> --cards 3 7` · `--ranges 4.2-5.1` · `--fillers` · يرفض (رمز 2) لو فيه كلام مهم أو آخر كلامه، و`--force` بس بعد موافقته |
| المكتبة | `hs hub` · `--tailscale` (رابط آمن للمايك) |
| اختيار الجمل | `hs takes <work> scan` · `list [--all]` · `use <رقم> --why …` · `drop` · `keep` · `note` · `fit <ثواني>` · `preview` · `apply` |
| التراجع | `hs undo <work>` · `hs redo <work>` (نفس سجل الاستوديو) |
| الصوت والخلفية | `hs voice <work> mute\|set\|list\|rm` · `hs voice <work> studio on\|off\|redo\|status\|export\|import <ملف>` · `hs rmbg <work> <صورة> [auto\|flat\|person]` |
| الخطة والخطوات | `hs plan <work> show \| check \| wait \| approve \| draft \| build` · `hs steps <work>` · `hs facts <work>` · `hs cuts <work> [fix]` · `hs gloss list` |
| حلقة طويلة | `hs clips scan <حلقة> <مجلد>` · `cand <مجلد> list\|set\|add\|rm` · `build <مجلد> --picks c1,c3 --edit none\|me\|claude` · `make <مجلد> --from … --to … --title …` · `list` |
| فيديو من رابط | `hs grab <رابط> --mode auto\|manual\|clips [--pick claude\|me] [--n 5] [--len 30-60] [--note "…"]` |
| تجهيز للمونتاج اليدوي | `hs prep <work> [--keep-silence]` |
| البحث بكل مقاطعه | `hs db search "كلمة"` · `index [--full]` · `stats` · `reset` |
| «ما لقيت Claude» أو Claude وقف | `hs claude` (وينه) · `hs claude test` (يرد؟ حد؟ دخول؟) · `hs claude set <مسار>` |
| الجهاز يثقل وقت الشغل | `hs hub --cpu light` (الافتراضي: أولوية أقل) · `--cpu full` أقصى سرعة · `hs doctor` يقول هل التفريغ على كرت الشاشة |
| الملاحظات | `hs notes <work> list` · `done <id> "وش سويت"` · `add <ث> "…" [--kind question\|info]` (ملاحظة منك له) |
| التصدير والحزمة | `hs export <work> [--frame 4:5] [--hooks] [--clean]` · `hs pack <work>` |
| إشعار لجواله | `hs notify send "نص" --work <work> [--file <ملف>]` · `hs notify status` |
| أسلوبه | `hs style show` · `hs style snap <work>` · `hs style apply <work>` |
| النشر | `hs publish <work> list` · `hs publish <work> tiktok [--at "وقت"]` · `hs publish <work> done tiktok <رابط>` |
| كرت الختام | `hs set <work> outro.font="Lalezar" outro.cta="تابعني"` |
| ورق متحرك | `hs kinetic <work> auto [--from ث --to ث] [--deco both]` · `hs kinetic <work> set mark=@حسابه` · `hs layer <work> set <id> text="سطر\n* كبير\n> صندوق" card=terminal cardText="…"` |
| الدحيح | `hs dahih <work> on --title "…" --tag "#…" [--avatar assets/x.jpg] [--logo claude] [--layout full]` · `hs dahih <work> bg navy --at ث` · `hs layer <work> add type=desk kind=note text="…" label="EDIT REQUEST #1" s=… e=…` |
| تحديث السكل | بلقن: تلقائي (`hs autoupdate on` يشغّله لو مطفي، بعد موافقته) · سكل عادي: `hs update` |
| فحص ملفات الاستوديو نفسها | `hs selftest [<work>]` |
| الهويات | `hs brand <work> list` · `save <اسم>` · `apply <اسم>` |
| الحالة | `hs status <work>` |

**الحركات (`type=viz`)** — كلها تاخذ `layout` (stage كرت فوق وهو صغير تحت · split نص الشاشة · over قزاز فوق المقطع · full بدونه)، و`title` عنوان صغير، و`accent` اللون:

| `kind` | متى | الحقول |
|---|---|---|
| `pctdots` | قال نسبة أو رقم («60% من الناس») | `values='[60,86]'` (أكثر من رقم يتبدلون بالترتيب) · `unit="%"` · `label="…"` |
| `people` | نسبة من الناس | `value=70` · `label` |
| `fill` | نسبة من شي (الماي 75% من الأرض) | `value=75` · `color2` لون الفاضي · `label` |
| `bars` | مقارنة أرقام (أطوال، أسعار، سرعات) | `items='[{"label":"برج خليفة","value":828},{"label":"برج الساعة","value":601}]'` · `unit="م"` (لين 6) |
| `route` | سفر أو مسافة بين مكانين | `from='{"name":"الدوحة","lat":25.29,"lon":51.53}'` · `to='{…}'` · `time="5 ساعات"` · `mode=plane\|car` · `km` (تنحسب لحالها) |
| `line` | أرقام تتغيّر مع الوقت | `values='[5,9,14,22]'` · `labels='["يناير","فبراير"]'` · `unit` |
| `slot` | رقم واحد يدور ويوقف | `value=2480` · `unit="ر.س"` · `label` |
| `news` | عنوان خبر وجزء منه يتظلّل | `text` · `mark="كلمات منه"` · `source` · `src` صورة · `layout=full` |
| `cta` | ختام «اكتب كلمة كذا» | `pre="اكتب كلمة"` · `word="حركة"` · `post="يوصلك بالخاص"` |

- الأرقام والإحداثيات من عندك لازم تكون صحيحة: خذ الرقم من كلامه حرفياً، والإحداثيات من معرفتك بالمدينة. لو مو متأكد من رقم لا تخترعه.
- مدة الحركة = مدة الجملة اللي فيها الرقم (3 إلى 6 ثواني). حركة وحدة لكل رقم، ولا تحط حركتين فوق بعض.
- `stage` و`full` يخفون الكابشن الكبير ويحطونه سطراً صغيراً بين الكرت وبينه. `cta` و`cover` يخفون الكابشن.

### كروت الشرح: اشرح بالرسم مو بالكتابة ⛔

كرت الشرح مو قائمة نصوص. كل فكرة لها شكل يشرحها، وأنت تختاره. الكمية من إجابته بصفحة الأسئلة (`apply` يطبع العدد). **لا تكرر نفس الشكل مرتين ورا بعض**، ولا تحط كرت على الهوك.

| `style` | متى | وش تكتب |
|---|---|---|
| `list` | مزايا أو أسباب | `text` كل سطر نقطة. أيقونة: `[bolt] سريع`. سطر صغير تحته: `سريع \| بدون برامج`. مرقّمة: `num=true` |
| `steps` | خطوات بالترتيب | كل سطر خطوة (لين 6). تترقّم والخط بينها ينرسم مع الكلام |
| `flow` | شي يتحول لشي | كل سطر مربع (لين 5) وبينهم أسهم. آخر مربع يتلوّن |
| `versus` | مقارنة طرفين | `a="قبل" b="بعد"` وكل سطر `يمين \| يسار` |
| `stat` | رقم واحد قوي | `value=87 unit=% label="من المشاهدين يكملون"` (يعدّ من صفر، ومع % يرسم حلقة) · `trend=up\|down` |
| `check` | صح وغلط | كل سطر يبدأ بـ `+` أو `-` |
| `timeline` | تواريخ أو مراحل زمنية | كل سطر `2023 \| وش صار` |
| `funnel` | أرقام تتناقص | كل سطر `الاسم \| الرقم` من الأكبر |
| `quote` | جملة قوية | `text` الجملة · `by` صاحبها |
| `draw` | فكرة ما لها شكل جاهز | `draw='[…]'` عناصر ترتبها أنت (تحت) |

حقول مشتركة: `title` (2 إلى 4 كلمات) · `accent` · `bgColor` · `color` · `deco` (glow · dots · grid · waves · none) · `src` صورة فوق · `ratio` (اتركه: ينضبط على وجهه).

**الرسم الحر (`style=draw`):** شبكة من 0 إلى 100 (x من اليسار، y من فوق) داخل مساحة الكرت. كل عنصر `k` نوعه، و`at` ثانية ظهوره من بداية الكرت (خله يطلع مع الكلمة اللي تخصه).

```bash
hs layer <work> add type=split style=draw title="الفكرة" s=20 e=26 draw='[
 {"k":"circle","id":"a","x":80,"y":25,"r":11,"icon":"user","at":0.2},
 {"k":"box","id":"b","x":50,"y":25,"w":26,"h":16,"text":"Claude","solid":true,"at":0.8},
 {"k":"arrow","from":"a","to":"b","at":1.0},
 {"k":"circle","id":"c","x":20,"y":25,"r":11,"icon":"play","color":"#2FBF9B","at":1.5},
 {"k":"arrow","from":"b","to":"c","at":1.7},
 {"k":"num","x":50,"y":70,"value":10,"unit":" دقايق","size":120,"at":2.2}]'
```

| `k` | الحقول |
|---|---|
| `box` | `x y w h text` · `solid` معبّى · `icon` · `dash` حد منقّط |
| `circle` | `x y r` · `text` أو `icon` · `solid=false` مفرّغ |
| `text` | `x y text size` (بالبكسل، 40 إلى 90) · `color` |
| `icon` | `name x y size` · `badge` دائرة خلفه |
| `arrow` · `line` | `from` و`to` (رقم عنصر `id` أو `[x,y]`) · `curve` انحناء من -1 إلى 1 · `dash` · `text` على السهم |
| `num` | `x y value unit size` يعدّ من `from` |
| `bar` · `ring` | `x y value` (0 إلى 100) · `w` أو `r` |
| `img` | `src x y w` |

لكل عنصر: `at` · `anim` (pop · rise · drop · draw · fade) · `color` · `pulse=true` ينبض · `out` ثانية اختفائه.
الأيقونات: check · x · plus · arrow · up · down · star · heart · user · users · clock · money · bulb · rocket · lock · chart · trend · cart · chat · gear · fire · bolt · eye · globe · play · cloud · code · search · bell · doc · camera · pin · phone · laptop · target · gift · brain · shield · warn · wand · flag.

- العربي يمين: أول شي بالكلام حطه يمين (x كبير) والسهم يمشي لليسار.
- 3 إلى 7 عناصر تكفي. اترك 8 بين العناصر، والنص داخل المربع قصير.
- نفس الأشكال بكرت فوق وهو صغير تحت: `type=viz kind=card style=steps layout=stage …` أو `kind=draw`.
- **ارسم معاينة لكل كرت وشوفها** (`04_render_frames.js <work> preview <ث>`): عنصر طالع برّا أو نص مقصوص؟ عدّل الإحداثيات.

### الوجه والشخص

- **مكان الوجه لحاله:** أول ما يجهز الفيديو السكل يحدد مكان وجهه (`face.json`). أي كرت يقص الفيديو يحرّك القص عشان الوجه يبقى كامل وبمكان مريح، وحجم كرت الشرح ينضبط عليه. ما تسوي شي. لو قال وجهه مقصوص: `hs face <work>` يعيد التحديد، أو كبّر حصته بـ`ratio=0.42`.
- **خلفية المتحدث (`type=bg`):** `blur` يغبّش اللي وراه (لحظة تركيز) · `bw` الخلفية أبيض وأسود وهو ملوّن · `dim` تعتيم · `color` لون (`color`) · `grad` تدرّج (`color` و`color2`) · `studio` خلفية استوديو بوهج (`color` و`accent`) · `image` صورة (`src`). `amount` من 0.1 إلى 1.
- **نص خلف الشخص (`type=behind`):** كلمة أو كلمتين كبيرة تمر ورا راسه. تشتغل والفيديو ملء الشاشة فقط (مو داخل كرت). `size` (افتراضي 270) · `color` · `fill=outline` مفرّغ · `y` (اتركه: ينحط فوق الراس).
- الاثنين يحتاجون قص الشخص، وينبني لحاله أول ما تضيف الطبقة (ثانية لكل 10 فريمات تقريباً). استخدمهم مرة أو مرتين بالمقطع: أكثر يفقد أثره. الحواف تقريبية، فلا تستخدم `color` الفاقع مع شعر منكوش.
- على أي نظام (ويندوز وماك). سكربتات `11_behind_text.js` و`14_backdrop.py` القديمة ماك فقط: لا تستخدمها، استخدم `type=behind` و`type=bg`.

### الأصوات

- **قبل ما تختار أي صوت أو موسيقى أو زوم أو تحدد إيقاع، اقرأ `<engine>/references/editing-rules.md` مرة بالجلسة.** فيه متى ينحط كل صوت ومستواه، وجدول «اللحظة ← الصوت».
- `hs sfx <work> list [قسم]` يطبع المكتبة مقسمة (انتقال، نقر، ظهور، تنبيه، نجاح، خطأ، كتابة، ضربة، فاصل، فلوس وورق، أجواء، موسيقى) ومع كل صوت متى ينستخدم. `cc-…` كلها CC0 حرة للاستخدام التجاري. ثم **أصوات المستخدم** (أرقامها `my1` `my2` …) ومعها وصفه لمتى تنستخدم. **أصواته أول خيار** لما يناسب اللحظة أو لما وصفه يقول.
- الطويل (فوق 8 ثواني) موسيقى أو خلفية: حدد مدته وقوته في `sfx.json` بشكل `"my3":[[0,0.5,30]]` (من الثانية 0، قوة 0.5، لمدة 30).
- **كتم كلمة (4.6):** طلب يخفي كلمة (اسم شخص أو شركة، سعر، شتيمة)؟ `hs bleep <work> word <الكلمة>` يلقاها بكل مكان انقالت (بدون همزات، ومع و ب ل ال قبلها) ويكتمها بصوت بيب، وبالكابشن نجوم (`ش***`). `mode mute` صمت بدل البيب، و`cap hide` مربع مكان الكلمة، و`cap keep` تبقى مكتوبة. ينطبق على التصدير وملف الترجمة SRT والنص، ويزحف مع القص. اقرأ له `list` بعدها عشان يتأكد إن كل مرة انكتمت. بالاستوديو: تبويب الصوت ← «كتم كلمة»، أو اختار جملة وتضغط الكلمة.
- **أصوات من حسابه (4.19):** لو عنده خدمة أصوات مربوطة بك (ElevenLabs، Higgsfield) شوف قسم 6س.
- قال «عندي ملفات صوت»؟ دلّه: «الملفات» ← «أصواتي» ← «ارفع»، أو لو عطاك المسار: `hs sfx <work> import "<المسار>" --name "…" --note "…"`.

القيم:
- `cap.enter`: rise · pop · slide · drop · zoom · fade · words · none
- `cap.exit` خروج النص (4.21): auto (العادي القديم، الافتراضي) · fade · rise (يطير لفوق) · sink (ينزل) · shrink (ينكمش) · punch أو zoom (يكبر ويختفي) · blur (غباش) · slide (ينسحب) · wipe (مسح من اليمين) · words (الكلمات تطيح وحدة ورى الثانية بترتيب القراءة) · none (قطع). يطلع بآخر كل جملة، ومع `cap.chunk` بآخر كل دفعة. `cap.exitDur` مدته بالثواني (0.1 إلى 0.8، فاضي = حسب الحركة). لجملة وحدة: `hs set <work> 'capOv.<نص الجملة>.exit=words'`. اختر خروج يكمّل الدخول (pop مع shrink أو punch، rise مع rise، slide مع slide)، ولا تخلط أكثر من نوعين بالمقطع. للشورت السريع: `cap.chunk=1 cap.enter=pop cap.exit=punch`، وللهادي: `cap.enter=fade cap.exit=blur`. وتقدر تحطه لجملة وحدة من الاستوديو.
- `cap.bg`: none · box · glass (قزاز مغبّش) · lines (كل سطر بكرته) · bar (شريط بعرض الشاشة) · pill ، ولون الكرت `cap.bgColor` وشفافيته `cap.bgOpacity`
- `cap.hl` تمييز الكلمة المنطوقة: color · under (خط تحتها) · dim (الباقي باهت لين ينقال) · glow (توهّج) · marker (قلم تظليل)
- `cap.chunk` كم كلمة تظهر مع بعض: 0 الجملة كاملة · 1 إلى 4 · `cap.actScale` تكبير المنطوقة (1 إلى 1.5) · `cap.fill`: solid · outline · `cap.shadow`: true · false · "hard" مع `cap.shadowColor`
- `cap.y` مكان أسفل الكابشن كنسبة من ارتفاع الشاشة. النطاق الآمن يعتمد على منصاته ومقاسه (`apply` يطبعه، والاستوديو ينبّه لو طلع برّاه). انستقرام أشدها: لا تنزل تحت 67
- `anim` للطبقات: pop · rise · drop · slide · slideL · zoom · fade · type · none
- `char`: robo · sprout · star · cube ، أو صورته: `src="assets/اسم.png"` (الشخصية تتكلم مع الكلام وتقفز عند الكلمة المميّزة)
- `fx`: zoom · punch · shake · flash · bw · blur · vignette · letterbox · tint · glitch · grain · facezoom (تقريب على وجهه) · spotlight (ضوء على وجهه) · pulse · tilt · rgb · vhs · pixel · duotone · sepia · invert · mirror · leak · strobe · speed. اختر المؤثر من معنى اللحظة (صدمة ← shake أو rgb · تركيز ← facezoom أو spotlight · ذكرى ← sepia أو vhs)، ولا تكرر نفس المؤثر
- انتقالات (`type=fx` مع `seam` و`dir`): curve · push · pull · rack · whip · spin · iris. والاحتفال: confetti. قواعدها بـ`references/motion.md`.
- **الموشن الجاهز بدل ما تبنيه من الصفر:** رقم ينقال ← `mg stat` أو `ring` · جملة قوية من كلمة إلى ثلاث ← `slam` · قائمة أو ميزات ← `check` (يظهر مع الكلام لحاله) · مراحل أو أنواع بالترتيب ← `steps` · تأشير على شي بالصورة ← `callout` · رأي أو تقييم ← `quote` · خيارين ← `compare` · نهاية المقطع ← `sting` بشعاره. واحد بكل لحظة، ولا تحطه وقت الهوك. `leak` صار تسريب ضوء عضوي، مرة أو مرتين بالمقطع.
- `x` و`y` نسبة من 0 إلى 1 من الشاشة (1080×1920). الأزمنة بالثواني على زمن الإخراج.

كل هذا في `studio.json ← hs`:

```json
{ "cap": { "on": true, "font": "Tajawal", "weight": 800, "size": 64, "color": "#FFFFFF", "active": "#F2B33D", "bg": "none", "bgColor": "#000000", "bgOpacity": 0.62,
           "stroke": 0, "strokeColor": "#000000", "shadow": true, "y": 76, "width": 760, "lines": 2, "enter": "rise", "hl": "color", "chunk": 0, "actScale": 1, "fill": "solid" },
  "frame": { "ar": "9:16", "cy": 0.47 }, "platforms": ["tiktok", "instagram"],
  "en": { "on": true, "font": "Inter", "size": 40, "color": "#FFFFFF", "pos": "below", "map": { "الجملة العربية": "English" } },
  "layers": [ { "id": "L1", "type": "text|image|char|fx|split|viz|cover|bg|behind", "s": 1.2, "e": 4, "track": 1 } ],
  "hooks": { "on": true, "active": 0, "dur": 2.6, "style": "box|pill|plain", "items": [ { "text": "…" } ] },
  "mix": { "voice": 1, "clean": false, "studio": false, "bg": 0.28, "sfx": { "tap": 0.5 } },
  "capOv": { "نص الجملة": { "y": 30, "size": 80, "color": "#FFE14D", "active": "#FFFFFF" } },
  "check": { "gap": 2.5 }, "ideas": [ { "t": 12.4, "text": "…" } ],
  "fonts": [ { "name": "MyFont", "file": "MyFont.ttf" } ], "edits": { "النص الأصلي": "النص المعدّل" } }
```

- **المشاهد (`scenes`):** أي لحظة ما يغطيها مشهد تطلع ملء الشاشة تلقائياً. اكتب فقط المشاهد اللي تبغاها (`R_DOWN` · `R_LOWER` · `R_OFF`) بأوقاتها، وما يحتاج تعبّي الفراغات. `R_OFF` (المتحدث مختفي) لا تستخدمه إلا ومعه رسم يملأ الشاشة بنفس المدة، وإلا تطلع الشاشة فاضية.
- `track` = سطر الطبقة: الرقم الأعلى يطلع فوق بالفيديو (وبنفس الرقم، اللي بعدها بالقائمة فوق). الطبقات المتداخلة بنفس الرقم تاخذ أسطر لحالها بالتايم لاين، فلا تحطها فوق بعض عشان تخفيها.
- `capOv` = شكل ومكان جملة وحدة فقط (تتجاوز `cap` العام). طبقة الصورة: `fit` = free · card · cover و`kb` حركة بطيئة.
- `cap.on=false` ← المحرّك يرسم كابشنه الأساسي كما هو (ستايلاته الستة). `cap.on=true` ← إضافة الاستوديو ترسم الكابشن.
- عدّل الملف مباشرة لو الأمر ما يغطي اللي تبغاه. الخطوط المرفوعة في `<work>/fonts/` والصور في `<work>/assets/`.
- `edits` يرجّع تعديلات النص بعد أي إعادة بناء. لا تعدّله باليد، استخدم أمر `text`.
- `hs remove` يحفظ نسخة «قبل القص (تلقائي)» ثم يعيد بناء الفيديو، وكل وقت (كلمة، مؤثر، طبقة) ينحسب من مكانه بالتسجيل الأصلي، فاللي انحذف ينحذف كابشنه معه. ياخذ دقيقة أو أكثر. بالاستوديو `Ctrl+Z` بعد القص يرجّع النسخة.
- **القص بالاستوديو فوري (4.23):** لما يقص هو من الاستوديو، الكابشن والطبقات والتايم لاين تتغيّر على طول والمعاينة تتخطّى المقصوص من الفيديو الحالي، والفيديو ينبني من جديد بس وقت التصدير. `.hs/media.json` = القص اللي انبنى منه `cutz.mp4` (يكتبه `03_cut_zoom.py` لحاله، لا تعدّله). معاينات `04_render_frames.js` تحسب القص الفوري لحالها. لو تبي `cutz.mp4` نفسه على آخر قص (مثلاً قبل شيل الخلفية أو تحليل الصورة): `hs media <work> fresh`.

## 6) «طبّق ملاحظات الاستوديو»

`hs notes <work> list` يطبع كل ملاحظة مفتوحة: وقتها، نصها، الجملة وقتها، إحداثيات المؤشر على الشاشة (من 1080×1920)، ومسار اللقطة.

لكل ملاحظة بالترتيب:
1. **اقرأ اللقطة** (`<work>/notes/<id>.jpg`) لو فيها مؤشر أو تخص شي بصري. المؤشر يقول لك أي عنصر يقصد.
2. **نفّذ** بأخف أمر من الجدول فوق. المشاهد والموشن والمؤثرات الصوتية بأدوات المحرّك (`compose.html` · `sfx.json`).
- **«ما عجبتني، بدّلها» (4.35):** ملاحظة تبدأ بـ«Claude: «…» ما عجبتني، بدّلها» جت من زر الكليك يمين على طبقة أو لقطة بي-رول أو لقطة الفيديو. بدّل نفس الشي بنفس وقته بشي ثاني يناسب كلامه (صورة أو مقطع من `hs media search`، أو موشن ثاني، أو قص اللقطة)، لا تعيد نفس الاختيار، ولو كتب ليش امش عليه.
3. **علّمها تمّت** مع جملة وش سويت (تظهر له تحت الملاحظة): `hs notes <work> done <id> "صغّرت الخط وعدّلت الكلمة"`.
4. ملاحظة مو واضحة؟ لا تخمّن. خلّها مفتوحة واسأله عنها بملاحظة منك (تحت).
5. ملاحظة فيها «اقتراحك» و«رده»: هذي ملاحظة كتبتها أنت ورد عليها. نفّذ رده هو، مو اقتراحك الأصلي.

### ملاحظاتك أنت له (4.2)
تقدر تترك له ملاحظة على لحظة معيّنة بدل ما تسأله بالمحادثة أو تقرر عنه:
```bash
hs notes <work> add <ثانية> "أقترح أحط رقم 24 بدائرة هنا لأنه يقول متاح 24 ساعة"            # اقتراح: يطلع له زر موافق / لا / رد مكتوب
hs notes <work> add <ثانية> "تبي الهوك أصفر ولا يبقى أبيض؟" --kind question                 # سؤال: يرد كتابة
hs notes <work> add <ثانية> "كلمة «…» ما وضحت، اسمعها وصحّحها" --kind fix                  # 4.29: لازم يعدّلها هو (زر «روح لها» و«صلّحتها»)
hs notes <work> auto                                                                       # 4.29: ملاحظات «لازم تعدّلها» لحالها: كلمة ما وضحت بالصوت، كابشن أسرع من إنه ينقرا، نص صغير أو سريع
hs notes <work> add <ثانية> "شلت جملة «يعني» هنا لأنها معادة" --kind info                   # معلومة: بس يقراها
```
- تطلع له بتبويب «الملاحظات» بلون بنفسجي، وبنقطة على التايم لاين، ويوصله تنبيه لو مفعّل.
- **لا تنفّذ اقتراح قبل رده.** `notes list` يوريك اللي ينتظر رده، واللي رد عليه يطلع مع رده.
- استخدمها لما تشوف شي يستاهل وما هو بإجاباته: فرصة كرت، لقطة ضعيفة، جملة تتشال. اقتراحين أو ثلاثة بالمقطع بالكثير، مو على كل شي.

بعد ما تخلص الكل: عاين برسم حقيقي للحظات الملاحظات واعرض ورقة لقطات وحدة. لو طلب الملف النهائي أعد التصدير.

## 6ب) يكلّمه ويتعلّم منه (4.1)

**الإشعارات (`hs notify`):** مجانية عن طريق تطبيق ntfy، بلا حساب ولا مفاتيح. يفعّلها المستخدم مرة من زر «الجوال» بالاستوديو (أو `hs notify setup`). لو مفعّلة:
- تنرسل لحالها لما تفتح صفحة الأسئلة («أنتظرك») ولما يخلص التصدير (ومعها المقطع لو أصغر من 15MB).
- أرسل أنت بنفسك لما توقف وتحتاجه: `hs notify send "وش تحتاج منه بجملة" --work <work>`. مثل: طلب توليد ينتظر حسابه، أو نشر ينتظر موافقته.
- لا ترسل أكثر من إشعار لنفس الشي. ولو مطفية لا تلح عليه، قل له مرة إنها موجودة.
- لو سأل عن الخصوصية: الإشعار والمقطع المرفق يمرّون على خادم ntfy.sh ساعات قليلة، واسم القناة هو كلمة السر.

**الأسلوب المتعلَّم (`hs style`):** قبل التسليم `hs style snap <work>`، والتصدير يقارن ويتعلّم لحاله. `brief apply` يطبع أسلوبه ويطبّق تصحيحات الكلمات اللي كررها. امش عليه من البداية (الخط، الألوان، كرت الختام، الطبقات اللي يحذفها دايم)، وإجاباته بصفحة الأسئلة تتقدّم عليه لو تعارضت. `hs style show` لو سألك وش تعرف عن أسلوبه.

**كرت الختام:** الخط يتغيّر من الاستوديو (اضغط كرت الختام ← «خط كرت الختام») أو `hs set <work> outro.font="Lalezar"`. باقي نصوصه: `outro.cta` · `outro.word` · `outro.l1` · `outro.l2` · `outro.sub`.

## 6د) الأساليب الجاهزة (4.2)

لو اختار بصفحة الأسئلة «ورق متحرك» أو «الدحيح» (`brief apply` يطبعها بمهامك)، أو طلبها بالكلام، أو أرسل مقطع بنفس الشكل: **اقرأ `<engine>/references/styles.md` كامل قبل ما تبدأ**. فيه الخطوات والقواعد وأي كرت لأي كلام.
- **ورق متحرك:** `hs kinetic <work> auto --deco both` يسوي البداية من كلامه، وبعدها راجع كل شاشة بـ`layer set` (السطر الكبير، الصندوق، الكرت). وجهه يختفي وصوته يكمل، فاستخدمه للمقطع كامل أو لهوك أو لمقطع شرح بالنص.
- **الدحيح:** `hs dahih <work> on --title … --tag … --avatar …` ثم الخلفيات (`hs dahih <work> bg navy --at ث`) والكروت (`hs layer <work> add type=desk kind=…`). قص الشخص يجهز لحاله أول مرة (دقايق).
- الأسلوبين ينرسمون بالاستوديو وبالتصدير مثل أي طبقة، والمستخدم يعدّل الكروت من لوحة العنصر.
- **بودكاست مترجم (4.3):** حلقة طويلة (بودكاست، مقابلة، محاضرة) يبي منها مقاطع، أو اختار «بودكاست مترجم»: **اقرأ `<engine>/references/clips.md` كامل.** `hs clips scan` يفرّغ الحلقة مرة وحدة، وأنت تختار أقوى اللحظات، و`hs clips make` يسوي لكل لحظة مشروع جاهز. الشكل نظيف: عنوان فوق ومصدره، وترجمة عربية بخط صغير تحت والأصل تحتها. بلا موشن ولا زووم ولا مؤثرات، وكروت الشرح بس لو اختارها.

## 6هـ) المكتبة والجوال (4.3)

`hs hub` يفتح «المكتبة»: كل مقاطعه بمكان واحد (حالة كل مقطع وخطه الزمني المصغّر)، و«الأوامر» (كل طلب وصلك من الاستوديو مع زر «رجّعه» يرجّع المقطع لقبل الطلب)، و«جهازك» (المساحة، خلّه صاحي، Claude والتصدير، إعادة تشغيل الاستوديو). يشتغل بالجوال والكمبيوتر، ومنه يرفع فيديو جديد أو حلقة طويلة وتوصلك كطلب.

```bash
hs hub                      # يشغّل المكتبة ويفتحها (مرة وحدة، تبقى شغّالة بالخلفية)
hs hub --restart            # بعد تحديث السكل: يقفل المكتبة القديمة ويشغّل الجديدة
hs hub --tailscale          # رابط آمن https للجوال عشان المايك يشتغل (لازم Tailscale مثبّت بجهازه وجواله بنفس الحساب)
```
- **قل له يستخدم المكتبة من جواله** بدل رابط كل مشروع لحاله. رابطها ورمز الدخول بتبويب «جهازك».
- **قبل أي «أوامر» من الاستوديو ينحفظ نسخة لحاله**، فلا تخاف من التجربة. هو يرجّعها بضغطة.
- **ملاحظة صوتية:** يضغط المايك مطوّل ويتكلم، وتوصلك ملاحظة فيها نصه (يتفرّغ على جهازه) والتسجيل نفسه (`notes/voice-*.webm`). لو النص يقول «ما قدرت أفرّغها» فرّغ الملف بوِسبر بنفسك قبل ما تنفّذها.
- **طلبات بضغطة** (شيل الحشو، قصّره، هوك أقوى…) توصلك كطلب عادي بنفس الطريقة. «قصّره لـ30 ثانية» يطلب منك ملاحظة فيها اللي بتشيله قبل القص: سوّها بـ`hs notes <work> add` وانتظر رده.

## 6و) رابط من أي منصة · لقطات من فيديو طويل · مونتاج يدوي (4.4)

**رابط:** يرسل رابط تيك توك أو يوتيوب أو انستقرام أو X (أو أي موقع فيديو) من المكتبة أو بالشات:
```bash
hs grab <الرابط> --mode clips --pick claude --n 5 --len 30-60 --note "طلبه"   # لقطات من فيديو طويل، Claude يختار
hs grab <الرابط> --mode clips --pick me                                        # هو يختار من صفحة «اختر لقطاتك» بالمكتبة
hs grab <الرابط> --mode manual                                                 # يتجهّز ويمنتجه بنفسه بالاستوديو
hs grab <الرابط> --mode auto                                                   # تمنتجه أنت كامل (البث الحي ثم الأسئلة)
```
- يسحب بأداة yt-dlp المجانية. **لو مو مثبّتة: استأذنه أول**، ثم `python -m pip install -U yt-dlp` (أو زر «ثبّتها» بالمكتبة). لو الموقع يبي تسجيل دخول: `hs hub --cookies chrome` (يستخدم دخوله بمتصفحه).
- يسحب محتواه هو أو محتوى عنده إذن فيه. لو المقطع لغيره اكتب المصدر (`--credit`).
- أي فيديو أطول من 6 دقايق يتحول لحاله لـ«لقطات».

**ترشيح اللقطات:** `clips scan` يرشّح لحاله (`clips suggest`) بدرجة «احتمال يضرب» من النص والصوت: هوك بأول ثواني (سؤال، رقم، كلمة تشد)، فكرة مكتملة، حماس بالصوت، وقرب من طلبه. **الدرجة تقدير وأنت تراجعها:**
```bash
hs clips cand <مجلد> list
hs clips cand <مجلد> set c3 --score 88 --why "هوك بسؤال|رقم صادم" --title "ليش تخسر أول سنة؟" --from 12:31 --to 13:20
hs clips cand <مجلد> add --from 40:02 --to 40:55 --score 91 --why "قصة شخصية" --title "…"
hs clips cand <مجلد> rm c7
hs clips build <مجلد> --picks c1,c3 --edit none|me|claude   # يقص المختارة لمشاريع (me = يجهّزها للتعديل اليدوي)
```
- لو «Claude يختار»: قيّم كمحرّر محتوى قصير، اختر الأقوى بعدد طلبه، `build --edit none`، ثم منتج كل وحدة حسب `references/clips.md`.
- لو «أنا أختار»: قيّم بس (cand set/add) ولا تقص شي. هو يختار من المكتبة، ويقدر يضيف لقطته بنفسه (يضغط جملة البداية والنهاية).

**قاعدة بيانات المقاطع (على جهازه فقط):** كل مقاطعه وحلقاته الطويلة تنفهرس لحالها بملف SQLite في `~/.hojas-studio/library.db`: العنوان، المصدر، وكل جملة قالها بتوقيتها، والملاحظات والعناصر والهوك ونص البوست. البحث بالمكتبة يطلّع المقاطع واللحظات، ويفتح المقطع على الثانية نفسها. ما يطلع منها شي لأي مكان.
```bash
hs db search "مليون ريال"     # وين قلت هالكلام؟ (المقطع + الثانية)
hs db index [--full]          # يحدّثها الحين (المكتبة تحدّثها لحالها كل دقيقة)
hs db stats · hs db reset     # reset يمسح القاعدة بس، مقاطعه ما تنلمس
hs claude [test|set <مسار>]   # 4.4.1: المكتبة تحفظ مكان Claude لحالها أول ما تفتح Claude Code
hs hub --cpu light|full       # خفيف على الجهاز (الافتراضي) أو أقصى سرعة
```
- لما يسأل «وين المقطع اللي تكلمت فيه عن كذا» أو يبي يعيد استخدام لقطة قديمة: `hs db search` أول، لا تفتح المشاريع وحدة وحدة.

**مونتاج يدوي:** `hs prep <work>` يقص السكتات ويفرّغ ويكتب الكابشن ويجهّز الفريمات بدون ما تتدخل، ثم يفتحه بالاستوديو ويكمّل بيده: الكابشن، العناصر (نصوص، كروت شرح، حركات أرقام، علامات، شخصيات، خلفيات)، **رسم حر** (يرسم بالماوس أو بإصبعه ويرتسم بالفيديو: `type=draw`)، القص، الصوت. كل تعديل ينحفظ لحاله، وزر «المكتبة» يحفظ ويطلع. «تايم لاين جديد منه» بالمكتبة ينسخ أي مشروع لنسخة مستقلة.

## 6ز) قبل النشر وبعده (4.5) ⛔ لا تصرف من حدّه بدون داعي

المستخدم يهمه حدّ استخدامه في Claude. كل ميزات 4.5 تشتغل على جهازه بدون Claude، وأي زر بالواجهة يشغّل Claude يسأله قبلها ويقول كم تقريباً يستهلك. فأنت:
- لا تسوي بـClaude شي تقدر الأداة تسويه لحالها (الفحص، الإعادات، الأغلفة، النصوص، الأرقام). شغّل الأمر واعرض النتيجة.
- قبل أي شغل طويل منك (مونتاج كامل، تقييم حلقة كاملة) قل له بجملة إنه يستهلك، إلا لو هو طالبه صراحة.

| يبي | سوّ |
|---|---|
| «كيف المقطع؟» «يضرب؟» قبل التصدير | `hs retention <work>`: درجة 0 إلى 100 وست أبعاد (أول 3 ثواني، الإيقاع، حركة الصورة، الوضوح، النهاية، الطول) والتصليحات بالتوقيت. صلّح المحلي منها بالأوامر (قص الوقفات، زوم، عنوان أول المقطع) قبل ما تقترح شي ثاني |
| «شيل الإعادات» | الفحص يجمع كل جملة انقالت أكثر من مرة ويختار الأكمل والأوضح (مو دايم الأخيرة). بالاستوديو ← الفحص ← الإعادات، يسمعها ويغيّر |
| غلاف | الاستوديو ← انشر ← الغلاف: 3 لقطات معبّرة بعنوان، يختار ويحفظ `cover-N.jpg` |
| كاروسيل · ثريد · وصف يوتيوب | الاستوديو ← انشر: تطلع من كلامه بالمقطع (`repurpose.json`)، يعدّل ويحفظ صور الكاروسيل (`carousel/`). زر «خلّ Claude يحسّنها» اختياري |
| أرقام مقاطعه | يدخلها بالاستوديو ← انشر، أو المكتبة ← أرقامك (يدوي أو CSV من TikTok Studio أو Metricool). بعد 5 مقاطع تطلع له وش يضرب عنده، وترشيح اللقطات يميل له (`~/.hojas-studio/learned.json`) |
| يصوّر وهو يقرا | الملقّن «قريباً» بالمكتبة، للحين ما ينفتح. قل له إنه جاي بالتحديث الجاي |
| عنده مقاطع كثيرة | «مصنع الليل» بالمكتبة ← جهازك: مجلد `_inbox` بمجلد المشاريع، أي فيديو ينحط فيه يتجهّز لحاله (يدوي افتراضياً، Claude اختياري)، وبالليل بس لو اختار، وإشعار بالجوال لما يخلص |
| فيديو عرضي (بودكاست، مقابلة) | القص العمودي يتبع اللي يتكلم تلقائياً (`engine/scripts/22_reframe.py` ← `reframe.json`). ينتقل بين الجمل بس. لو غلط بمكان، احذف `reframe.json` وعدّل المفاتيح بيدك `{"keys":[[ثانية, مركز 0..1]]}` ثم أعد القص |

## 6ج) النشر (4.1) ⛔ موافقته قبل الضغطة الأخيرة

ما فيه مفاتيح API: النشر يصير من متصفحه هو (Claude in Chrome) وبحسابه المسجّل فيه. المتاح: `hs publish <work> list`. لو فيه ملف `publish-private.md` بمجلد السكل اقرأه، فيه منصات إضافية وخطواتها.

1. **قبل أي شي:** لازم يكون صدّر وراضي عن المقطع. `hs publish <work> tiktok` يطبع الخطة: مسار الملف، نص البوست من `post.txt`، والرابط. لو طلب جدولة: `--at "2026-10-15 20:00"`.
2. **افتح المتصفح:** `tabs_context` ثم تبويب جديد على رابط الخطة (تيك توك: `https://www.tiktok.com/tiktokstudio/upload`). لو طلب تسجيل دخول: وقف وقل له يسجّل بنفسه. لا تكتب كلمة سر أبداً.
3. **ارفع الملف:** بأداة رفع الملفات على حقل الفيديو بالمسار الكامل من الخطة، وانتظر لين يخلص الرفع والمعالجة.
4. **عبّي:** الوصف من الخطة كما هو، الغلاف لو فيه خيار (لقطة فيها وجهه وعنوان واضح)، الخصوصية «الكل» إلا لو قال غير. الجدولة لو طلبها من خيار «جدولة» بنفس الصفحة.
5. **⛔ وقف قبل زر «نشر» أو «جدولة» الأخير.** خذ لقطة شاشة، وأرسل له إشعار (`hs notify send "المقطع جاهز للنشر على تيك توك، أنتظر موافقتك" --work <work>`)، واسأله بالمحادثة سؤال واحد: أنشر؟
6. **بعد ما يقول نعم صراحة:** اضغط الزر، تأكد إنه انتشر أو انجدول، ثم `hs publish <work> done tiktok "<الرابط لو ظهر>"`.
- موافقته على مقطع ما تنطبق على مقطع ثاني. كل نشر يحتاج «نعم» جديدة.
- لا تضغط أي شي يغيّر إعدادات حسابه، ولا تقبل شروط جديدة بداله. لو طلعت لك نافذة شروط، وقف وقل له.
- تيك توك ممكن يقيّد الحسابات اللي تنشر بأتمتة كاملة، وعشان كذا الضغطة الأخيرة له.

## 6ح) الكابشن والخط والقص الآمن والشعارات والصور التخيلية (4.9)

**الكابشن:** كل سطر 5 كلمات. لو الجملة زادت كلمة أو كلمتين يروحون لبداية الكابشن اللي بعده، ولو زادت 3 أو أكثر تصير سطر ثاني بنفس الكابشن (10 كلمات بالكثير). `02_captions.py` يطبّقها لحاله، وللمشاريع القديمة `hs caps <work> regroup`. الحجم الافتراضي صار أصغر (56).

**الأسماء بالإنجليزي ⛔:** اسم الشركة أو الموديل أو التطبيق أو المعلم ينكتب باسمه المعروف: «شات جي بي تي» ← ChatGPT · «والسونيت» ← «و Sonnet» · «بجوجل درايف» ← «ب Google Drive». القاموس في `engine/scripts/capgroup.py`، ولو لقيت اسم معروف ما تحوّل صحّحه بالنص (`hs text`) وأضفه للقاموس لو طلب تطوير السكل.

**خطه الخاص (ثمانية):** يثبّته مرة وحدة من الملف اللي عنده `hs fonts install <zip>` (ينحفظ بجهازه في `~/.hojas-studio/fonts`)، وبعدها كل مشروع ياخذه لحاله: الكابشن «Thmanyah Sans»، والعنوان الثابت فوق (الهوك) «Thmanyah Serif Display» وما يستخدمه أي نص ثاني. مشروع قديم: `hs fonts apply <work>`.
⛔ **رخصته تمنع نشر الملفات:** لا تحط ملفات الخط بالمستودع ولا الموقع ولا أي zip ينرسل لأحد، ولا تنسخها لمكان عام. تبقى على جهازه وبمشاريعه بس.

**القص الآمن:**
- `hs remove` و`10_script_edit.py` يرفضون (رمز 2) لو اللي بينحذف فيه رقم أو سعر أو اسم أو نصيحة أو مقارنة، أو آخر جملتين بالمقطع. لا تمرّر `--force` من نفسك: اعرض الجمل عليه بصفحة الأسئلة (`brief ask --file`) وخلّه يختار.
- ⛔ لا تنهي المقطع وهو باقي يتكلم. لو لازم يقصر، القص يكون على نهاية جملة كاملة، ولو ما فيه مفر يختفي الصوت بهدوء (اللقطات من `hs clips` صارت تنقص على حدود الجمل وتختفي بنعومة لحالها).
- قص السكتات صار أشد (0.16 ث بين الجمل) ويحافظ على آخر حرف بالكلمة. لو قال إنه سريع زيادة: `HS_GAP=0.22` قبل `01_cut_plan.py`.

**شعار الشركة لما ينذكر اسمها:**
```bash
hs logo <work> plan     # يطلع الشارات المقترحة من الكابشن (بعد ما الأسماء صارت إنجليزي)
hs logo <work> auto     # يضيفها طبقات mg (kind=logo) وينزّل الشعارات
hs logo add Canva "C:/…/canva.svg"   # شعار رسمي لشركة ما لقيناها (ينحفظ بجهازه لكل المشاريع)
```
- شارة صغيرة داكنة فوق الكابشن (شعار + اسم) تدخل بنابض وتطلع بعد 2.2 ث. أول ذكر للشركة، وترجع لو انذكرت بعد 25 ث. بين كل شارتين 4 ث، و5 بالدقيقة بالكثير، وما تطلع فوق طبقة ثانية.
- «Claude أفضل من ChatGPT» (أفضل، أحسن، أقوى، أسرع، أذكى، أرخص، أدق، أضعف…) تصير شارتين متقابلتين والكلمة بينهم، 3 ث، بدون تعتيم ولا وميض. الأفضل له إطار بلون الحساب.
- الشعارات من Simple Icons (CC0) وتنزل أول مرة. اللي مو موجود هناك (OpenAI وChatGPT، Canva، Microsoft، Amazon…) يطلع حرف أول بدائرة لين يرفع شعارها. لا ترسم شعاراً من عندك.
- بالاستوديو: «موشن جاهز» ← «شعار شركة»، وزر «شعارات تلقائي من الكلام».

**صور تخيلية للمواضيع المهمة:** لما يتكلم عن فكرة مهمة (رقم، نصيحة، مقارنة، قصة) حط 2 إلى 4 صور تخيلية بالمقطع، كلها بنفس الستايل.
1. `hs gen <work> moments 4` يطلع أهم الجمل وأوقاتها (8 ث بينها على الأقل). اختار منها اللي فعلاً يستاهل.
2. اكتب لكل وحدة وصفاً بالإنجليزي يوصف المعنى بصورة (مو الكلمات حرفياً)، وآخر كل وصف نفس جملة الستايل (مثال: `cinematic, soft natural light, muted colors, shallow depth of field`). بلا نص داخل الصورة، بلا أشخاص حقيقيين معروفين، بلا شعارات.
3. `hs gen <work> request image "<الوصف>" --at <الوقت> --fit card` لكل وحدة.
4. لو اختار «مولّدة» بالأسئلة أو قال «ولّدها من حساباتي»: ولّدها بنفس ترتيب قسم الصور (متصفحه بـ ChatGPT أو Gemini وهو مسجّل، أو موصل Higgsfield لو مربوط وبعد ما تقول له إنه يسحب من رصيده)، ثم `hs gen <work> import <رقم> <الملف أو الرابط>`. ما فيه طريقة؟ الطلبات تنتظره بـ«العناصر» بنصها الجاهز.
5. ارسم معاينة وتأكد إن كل صورة تطابق كلامه ولا تغطي وجهه بلحظة مهمة.

## 6ط) اختيار الجمل والحلول العشر (4.10)

### اختيار الجمل ⛔ أنت اللي تختار
المتكلم يتلعثم، أو يبدأ الجملة ويتركها، أو يعيدها مرتين وثلاث، وأحياناً الصح الأخيرة وأحياناً وحدة بالنص. بعد التفريغ وقبل الكابشن:
```bash
hs takes <work> scan              # يقسم كلامه لمحاولات ويوسمها، ويختار مبدئياً آخر محاولة كاملة بكل مجموعة
hs takes <work> list --all        # كل المحاولات (✓ باقية · ✗ محذوفة · [g] نفس الجملة أكثر من مرة) واقرأها كاملة
hs takes <work> use 27 --why "الكاملة وفيها الرقم الصح" --claude    # هذي المختارة من مجموعتها
hs takes <work> drop 14 --why "بدأها وتركها"    ·    hs takes <work> keep 9    # احذف أو رجّع (أي محاولة أو تلعثم مثل 12.1)
hs takes <work> note "شلت 6 إعادات وبداية متعثرة، وخليت الثانية بجملة السعر لأنها أوضح"   # ملخص يطلع له فوق القائمة
hs takes <work> apply             # يقص من التسجيل الأصلي (ولو الفيديو مبني يعيد بناءه، والكابشن بتصحيحاته يمشي معه)
```
- **الاختيار بالمعنى مو بالترتيب:** الأخيرة غالباً هي الصح، بس لو الأولى كاملة والثانية ناقصة أو فيها معلومة غلط، خلّ الأولى. قارن: الكاملة، الصح بالمعلومة، الأوضح، الأقل تلعثم. اسمع لو تقدر تشك.
- اقرأ `list --all` كاملة: الأداة ما تمسك كل شي. جملة بدأها وغيّر صياغتها بجملة ثانية (مثل «وصلنا مرحلة.. تعدينا مرحلة») احذف الأولى بنفسك.
- **التلعثم داخل الجملة** (`«كل يوم.. كل يوم يطلع لك»`، `«آ.. امم»`) ينقص لين تبدأ الجملة فعلاً. التكرار السلس للتأكيد («قوية قوية») ما ينقص، ولو انقص غلط رجّعه بـ `keep`.
- **بلا كلام** (جملة اخترعها whisper فوق السكوت) و**ضجيج** تنحذف لحالها. **تحية بالبداية** («مساكم الله بالخير») اقتراح بس: بالشورتس احذفها إلا لو أسلوبه يبيها. **فكرة مكررة** (قالها قبل بمكان بعيد) اقتراح، قرر أنت.
- **قصّره لمدة:** `hs takes <work> fit 60` يقترح جمل تنحذف (يبدأ بالأضعف ويخلي أول 8 ثواني وآخر جملتين). راجع الاقتراح، رجّع المهم، ثم `apply`.
- المستخدم يشوف كل هذا بتبويب **«الجمل»**: الخام وبعد القص، شريط المحذوف والباقي، كل لقطة يسمعها من التسجيل الأصلي، «استخدم هذه» و«أرجعها» و«احذفها»، «استمع للنتيجة» قبل القص، «اقطع من جديد»، ومربع يكتب لك فيه («استخدم اللقطة الأولى بدل الثانية») وزر «خلّ Claude يختار» يشغّلك على نفس الأوامر.
- `Ctrl+Z` بعد «اقطع من جديد» يرجّع القص. واللي يحذفه بالاستوديو بنفسه يبقى محذوف لو رجعت تطبّق.

### الحلول العشر
1. **كلمات مشكوك فيها:** الكلمة اللي whisper ما تأكد منها (ثقة تحت 50%) تطلع تحتها خط منقط بتبويب «النص». `hs caps <work> unsure` يطلعها مع جملتها. صحّح الغلط منها بالمعنى (`hs text`)، والأسماء بالإنجليزي، ولا تغيّر كلامه.
2. **قاموسه:** أي تصحيح (منه بالاستوديو أو منك بـ `hs text`) لاسم أو كلمة قريبة من الغلط أو كلمة مشكوك فيها ينحفظ في `~/.hojas-studio/glossary.json`، وينطبق لحاله على كل كابشن جديد. `hs gloss list | add "الغلط" "الصح" | rm "الغلط"` · `hs caps <work> gloss` لمشروع قديم.
3. **القص ما ينزل على صوت:** `hs cuts <work>` يلقى القطعات اللي تقص حرف، و`hs cuts <work> fix` ينقلها لأقرب سكتة (≤ 0.14 ث). بالفحص زر «صلّحها».
4. **فكرة مكررة:** بقائمة الجمل وسم «فكرة مكررة» لو قالها قبل بمكان بعيد.
5. **قصّره لمدة:** `hs takes <work> fit <ثواني>` (فوق).
6. **الخطة قبل البناء ⛔:** قبل ما تصمم المشاهد اكتب `<work>/plan.json` وخلّه يوافق:
   ```json
   {"approved": false, "feedback": "", "style": "صور واقعية بإضاءة ناعمة", "items": [
     {"id": 1, "title": "قنوات الناجحين", "s": 0.0, "e": 4.2, "speech": "كلامه بهذا الجزء", "show": "وش يطلع على الشاشة", "motion": "كيف يتحرك", "kind": "web", "query": "وش تدور أو تولّد", "source": "الرابط أو المصدر"}]}
   ```
   `kind`: web من النت · archive أرشيف حقيقي · gen صورة مولّدة · draw رسمة بالكود · overlay عنصر فوق الفيديو · screen لقطة موقع · text نص أو موشن · none وجهه بس. لكل بند كمان `idea` (الفكرة) و`example` (المثال اللي يفهّمها، إلزامي للصور)، والبناء نفسه بـ`hs plan <work> build` (القسم 6م). بعدها `hs plan <work> check` ثم `hs plan <work> wait`: لو وافق ابن، ولو كتب ملاحظة («أعد الخطة بكلامي») عدّل الخطة وانتظر مرة ثانية. بتبويب «الخطة» يقدر يضغط «اصنع أول صورتين لتشوف الأسلوب» فتولّد أول بندين gen بس (من حسابه، بنفس ترتيب قسم الصور) وتحط `src` و`status: "done"`.
7. **كلام بدون كابشن:** `hs caps <work> gaps` يلقى صوت كلام ما له كابشن (whisper فوّته). اسمعه واكتبه بالنص، أو أعد تفريغ هالجزء.
8. **أرقام وأسماء تتأكد منها:** `hs facts <work>` يطلع الجمل اللي فيها أرقام وأسعار وموديلات ومقارنات. ⛔ قبل التصدير تأكد منها بالبحث (الأسعار والنسخ تتغيّر). الكابشن يتصحح، بس كلامه بالصوت ما يتغيّر: لو المعلومة غلط قل له، واقترح يشيل الجملة أو يحط تصحيح على الشاشة.
9. **التحية بالبداية:** وسم «تحية بالبداية» بالجمل (فوق).
10. **شريط الخطوات:** فوق اللوحة اليسار بالاستوديو: الجمل ← الكابشن ← الخطة ← البناء ← التصدير، كل وحدة بحالتها وتفتح مكانها. `hs steps <work>` نفس الشي بالطرفية.

## 6ي) تراك الصوت وشيل الخلفية (4.11)

**تراك الصوت بالاستوديو (صار ظاهر تحت الفيديو):**
- **أي صوت أو موسيقى أضافها:** يضغط عليه بتراك «المشاهد والمؤثرات» فتطلع له: المستوى (0 يكتمه، 2 ضعفه)، يبدأ عند، يبدأ من داخل الصوت، المدة، يظهر تدريجي، يختفي تدريجي، وزر «اسمع». ويسحب طرفه بالتايم لاين يقصه من أوله أو آخره، أو يحركه من نصه. بالملف: `sfx.json` كل عنصر `[ثانية, مستوى, مدة, يبدأ من, ظهور, اختفاء]` (المدة null = لين آخر الصوت).
- **صوته هو:** يسحب على تراك «الصوت» يحدد جزء، فيطلع له: «قصّه من المقطع» (صوت وصورة)، «اكتمه بس»، «وطّه للنص»، «علّه شوي». الأجزاء تطلع على التراك ويعدّل مستواها، وتمشي مع القص. بالأوامر: `hs voice <work> mute <من> <إلى>` · `set <من> <إلى> <مستوى>` · `list` · `rm <رقم|all>`.
- الكلام نفسه يتعدّل من «النص»: حذف كلمة أو جملة يقصها من الصوت والصورة.

**شيل الخلفية من صورة مضافة:**
- بالاستوديو: يحدد الصورة ← «شيل الخلفية». على جهازه وبدون نت: الخلفية السادة (أبيض، لون واحد، لقطة شاشة) تنشال من الحواف بحافة ناعمة، والصورة اللي فيها شخص يفصلها موديل الشخص اللي بالسكل. «رجّع الصورة الأصلية» يرجّعها.
- أنت: `hs rmbg <work> assets/الصورة.jpg [auto|flat|person]` يحفظ `assets/…-nobg-….png`، وبعدها غيّر `src` بالطبقة (وخلّ `srcOrig` بالأصل).
- **صورة معقدة ومو شخص** (منتج على خلفية فيها تفاصيل): استخدم أداة شيل الخلفية من حسابه (Higgsfield `remove_background` أو Canva `remove-background`)، وقل له قبلها إنها تستهلك من رصيده. زر «خلّ Claude يشيلها» يشغّلك على نفس الخطوات.

## 6ك) صوت استوديو، والتحكم بأي صوت بضغطة (4.12)

**صوت استوديو (على جهازه، بلا رفع ولا اشتراك):** بالاستوديو «الصوت» ← «صوت استوديو». يشيل الضجيج بنموذج RNNoise اللي بالسكل (`engine/audio/sh.rnnn`)، يخفّض الفراغ بين الكلام 12 ديسيبل (يخفف صدى الغرفة والنفس)، يوزن مستوى كل جملة على جملته الوسط (لحد 6 ديسيبل)، ويصلّح التشويش لو الصوت كان عالي لدرجة القص. ما يلمس `cutz.mp4`: يطلع `.hs/sv-<توقيع>.wav` بزمن المقطع، والتصدير والمعاينة ياخذون منه. التوقيع يتغير مع القص وتوقيت الجمل، فما يتراكم التنظيف ولا يطلع صوت قديم. لما يكون شغّال، «تنظيف الصوت» العادي ما ينطبق (هذا أقوى منه).
- يسمع الفرق بالاستوديو: «تسمع: الأصل | الاستوديو» يبدّل وهو شغّال، وتحت الزر أرقام قبل وبعد.
- أنت: `hs voice <work> studio on` (يعالج ويطبع الأرقام) · `off` · `redo` · `status`.
- **غرفة فيها صدى قوي** (المحلي ما يشيل الصدى داخل الكلمة نفسها): `hs voice <work> studio export` يطلّع `voice-for-studio.wav`. هو يرفعه على Auphonic أو Adobe Podcast **من حسابه** وينزّل النتيجة، وبعدها `hs voice <work> studio import <الملف>`. لازم نفس طول القص (فرق أقل من 0.15 ث)، ولو تغيّر القص بعدين يرجع التصدير لصوت الاستوديو المحلي ويقوله. لا ترفع شي بنفسك.

**أي صوت بالمقطع، يضغط عليه ويتحكم فيه هو:**
- مؤثر أو صوت مضاف: يضغط عليه بالتايم لاين ← تحكمه هو (المستوى، القص، التلاشي، اسمع). أقسام «الصوت» العامة تتحكم بكل الأصوات من نفس النوع مرة وحدة.
- **مربوط أو مفصول (4.14):** زر «ربط الصوت بالصورة» (`L`). مربوط: تحدد قطعة يتحدد صوتها وصورتها، والحذف والقص يشيل الاثنين، وفيه بعد «احذف الصوت بس» و«احذف الصورة بس». مفصول: كل تراك تحدده لحاله، وحذف الصوت يكتمه (`mix.vr` مستوى 0) وحذف الصورة يخليها سودا وصوته يكمل (`hs.blank` نطاقات `{s,e}`، تزحف مع القص، وتطلع بالتايم لاين «بدون صورة» يضغطها ويرجّعها).
- **صوته مقاطع زي أي برنامج مونتاج (4.13):** تراك «الصوت» مقسوم على نفس قطع الفيديو. يضغط على قطعة ← تتحدد هي وصورتها: مستواها، «اكتمه بس»، «قسّمه عند المؤشر» (أو المقص أو B)، «احذفه (صوت وصورة)» أو Delete، ويسحب طرفها الأبيض يقصها. السحب على التراك يحدد جزء من داخل القطعة. المؤثرات تنقسم بالمقص بعد. والتايم لاين يطول لحاله على قد التراكات، ويتسحب حدّه الفوقاني.
- لقطة بتراك «الفيديو» ← «صوتك بهاللقطة». جملة بالكابشن ← «صوت هالجملة». الاثنين يحفظون نطاق بـ `mix.vr`.
- الموسيقى (لو فيه `bg-audio.mp3` بالمجلد) تطلع شريط تحت تراك الصوت ← يضغط عليها: مستواها، تطلع وتختفي تدريجي، كم تنخفض وقت الكلام، اسمع.

## 6ل) الصور التوضيحية تتحرك ويتعلّق عليها (4.15)

مأخوذ من مونتاج مقاطع الشرح اللي كلها صور (Claude يجيب الصور ويحركها ويكتب عليها). القاعدة: **الصورة ملء الشاشة ما تكون ثابتة أبداً، وأي شي يقوله بالكلام ينأشّر عليه بالصورة.**

**حركة الصورة** (طبقة `image` بـ`fit:"cover"`، والصور المستوردة تجيها `push` + `hand` + `focus` تلقائي):
- `move`: `push` (يقرّب ويجيب النقطة `fx,fy` للنص، زي الكاميرا تمشي على الشي) · `pull` · `panL` `panR` `panU` `panD` · `drift` · `float` (للأشياء الصغيرة) · `none`. `amount` قوة الحركة (0.2 لين 2.5).
- `hand: true` كاميرا باليد (اهتزاز طبيعي خفيف). `shake: [1.0, 2.4]` هزّة قوية بالثواني من بداية الطبقة (لما يقول «يهزّون الجوال» مثلاً).
- `inFx`: `focus` (من الغباش) · `zoomblur` · `whip` · `stretch` (مطّ لفوق، زي برج طالع). `outFx`: `zoomblur` · `whip` · `focus`. نوّعها بين الصور.
- `fx,fy`: **شوف الصورة بنفسك** (Read) وحط النقطة على الشي المهم بالصورة (0 لين 1 من اليسار ومن فوق).

**تعليق على الصورة** (`type:"anno"`، ينرسم فوق الصورة وتحت الكابشن). الأماكن نسب من الشاشة 0 لين 1، فلازم تشوف الصورة وتحدد مكان الشي:
- `ring`: حلقة على شي `x,y,r`، وجنبها `label` أو عدّاد `from,to,pre,suf,side` (مثل «تضغط مرة ومرتين وثلاث» ← from 1 to 3، أو `pre:"×"` from 4 to 15).
- `spots`: بقعة تنتقل بين `pts` بالترتيب، مع `labels`.
- `route`: دبوس على كل نقطة ومسار مقوّس بينها (خرائط: «من أستراليا وبريطانيا»).
- `path`: نقطة مضيئة بذيل تمشي على `pts`، و`from:[x,y]` يربطها بخط متقطع (يد تحرك شي على الشاشة).
- `wave`: خط نبض بـ`y`، و`burst:[[من,إلى]]` يهتز (اهتزاز، صوت، توتر). `tap`: دوائر ضغطة إصبع على `x,y`.
- `boxes`: `rects:[[x,y,w,h],…]` مربعات تطلع وحدة وحدة و`tag` فوقها (شبكة ناس: «ثلث المرات»). `tags`: أسماء صغيرة على `pts`.
- `screen`: صورة (`src` من `assets/`) أو `text` داخل شاشة جوال أو كمبيوتر بالصورة `rect:[x,y,w,h]`، و`spin:true` يتقلب (نرد). `spinner`: علامة تحميل تدور على `x,y`.
- **4.24 (15 جديدة):** `arrow` سهم بخط اليد من `pts[0]` لـ`pts[1]` (`labels[0]` عند ذيله، `lift` الانحناء) · `scribble` دائرة بالقلم `x,y,r` + `label` · `underline` خط فرشاة بين نقطتين · `highlight` قلم تظليل على `rects` · `cross` شطب ✗ على `rects` (للغلط و«لا تسوي») · `check` صح ✓ يترسم `x,y,r` · `lens` عدسة تكبّر الصورة فعلاً `x,y,r,zoom` · `spotlight` يعتّم كل شي إلا نقطة ويتنقل بين `pts` (`r,dim`) · `blur` يخفي `rects` (`mode:"pixel"` مربعات) · `bubble` فقاعة كلام `x,y,text` تنكتب حرف حرف · `frame` زوايا كاميرا تقفل على `rects` مع نقطة تسجيل و`labels` · `scan` خط مسح يمر مرتين وبعدها `labels[0]` (يناسب الذكاء الاصطناعي) · `burst` انفجار كوميكس `x,y,r,text` · `stars` تقييم `x,y,value` (يقبل 4.5) · `price` بطاقة سعر معلّقة تتمرجح `x,y,text`.
- **اختار بالمعنى:** «شوف هنا» ← `arrow` أو `scribble` · رقم أو سطر بشاشة ← `highlight` أو `lens` · غلط وصح ← `cross` و`check` · تركيز على شي وسط زحمة ← `spotlight` أو `frame` · بيانات خاصة ← `blur` · تحليل AI ← `scan` · مفاجأة ← `burst` · مراجعة منتج ← `stars` و`price`. واحد بكل لحظة، ومع كلمته (`at`).
- التعليق **يمشي مع الصورة اللي تحته** (نفس الدفع والهزّة)، فالأماكن تحددها على الصورة وهي بمكانها الأصلي. `stick:false` يثبّته بالشاشة.
- `at:[…]` توقيت كل نقطة بالثواني من بداية الطبقة: **خلّه مع الكلمة** من `caps.json` (وقت الكلمة ناقص بداية الطبقة).
- اللون الافتراضي لون حسابه (`color` يغيّره). بالاستوديو: «العناصر» ← «تعليق على الصورة»، والأماكن بالضغط على الفيديو.

**فلتر سينما** (`hs set <work> grade.preset=cine grade.amount=0.85` أو الطابع `hs look <work> apply cinema`): تباين أعلى وألوان أهدى، إضاءة دافية، توهج للأماكن المضيئة، أطراف داكنة وحبيبات خفيفة، على الفيديو والصور مع بعض قبل الكابشن، فكل المقطع يطلع من نفس العالم. والتعليقات والكلمات المتوهجة تصير ذهبية لحالها. الطابع «سينما دافية» يضبط معه الكابشن بكرت داكن.

**كلمة متوهجة:** طبقة `text` بـ`anim:"glow"` و`size` 150 لين 200 و`y` بين 0.12 و0.2 ولون دافي (`#FFE7B3`): للكلمة المفتاح بالجملة («ليش؟»، «وهم السيطرة»، «2020»، «لندن»)، فوق الوجه أو فوق الصورة.

أمثلة:
```
hs layer <work> add type=image src=assets/elevator.jpg fit=cover s=4.2 e=7.5 move=push fx=0.52 fy=0.44 hand=true inFx=focus
hs layer <work> add type=anno kind=ring s=4.4 e=7.5 x=0.52 y=0.43 r=0.09 from=1 to=3 side=left size=150 at=[0.3,1.1,1.9]
hs layer <work> add type=anno kind=route s=12 e=15 pts=[[0.43,0.38],[0.78,0.7]] labels='["بريطانيا","أستراليا"]'
hs layer <work> add type=anno kind=boxes s=20 e=23 rects=[[0.27,0.4,0.18,0.1],[0.52,0.49,0.18,0.1]] tag=أنا
hs layer <work> add type=text text=2020 anim=glow size=170 y=0.18 color=#FFE7B3 s=12.4 e=15
```

## 6م) القصة البصرية: يتابع كلامه ويجيب مثال يفهّم (4.16) ⛔ لأي مقطع شرح

⛔ اقرأ `engine/references/visual-story.md` قبل ما تكتب الخطة. الفكرة: كل فكرة بكلامه لها **مثال قريب من حياة المشاهد** يفهم منه بدون صوت (الكريدت = عداد بنزين، قوة الموديل = القير، الربط = أفياش)، وكل الأمثلة من **عالم واحد** (`motif`) ترجع له أكثر من مرة، وكل حلقة ورقم وشعار يطلع **مع الكلمة نفسها**، وبالنهاية أشياء القصة ترجع جنب وجهه (`callback`).

1. `hs plan <work> draft` يقسم كلامه لأفكار. عبّ لكل بند: `idea` و`example` و`show` والنوع، وبعدها `mg` أو `logo` أو `anno` أو `glow` بـ`cue` على كلماته.
2. المثال البسيط (عداد، قير، سلّم، ميزان، أفياش حول شعار) **ارسمه بالكود** (`kind:"draw"`) بدل ما تصرف من رصيده. الصور الواقعية `gen` بنفس جملة الأسلوب، وبعد ما تجي شوفها وحط أماكن التعليقات.
3. `hs plan <work> check` ثم `wait`. بعد موافقته: `hs plan <work> build` (أو زر «ابنِ من الخطة»). يبني الموشن والشعارات والتوهج حتى لو الصور لسه، ويقول وش البنود اللي تنتظر صورها.
4. لا تملي كل ثانية: جملة عادية بين فكرتين = وجهه (`none`). ولا تحط نوعين موشن نفس الشي ورا بعض.

## 6ن) وضعين: «Claude يمنتج» و«مونتاج يدوي» (4.18)

الاستوديو صفحة وحدة فيها زر فوق يبدّل الوضع، والوضع ينحفظ بالمشروع (`studio.json` ← `hs.mode`).

- **Claude يمنتج (`claude`):** المعاينة كبيرة، والتبويبات: الخطة، الفحص، النشر، الملاحظات، Claude (طلباته وتقدّمه)، والمشروع. أدوات التحرير والقوائم اللي يسار تختفي، والتايم لاين نحيف للمتابعة بس.
- **مونتاج يدوي (`manual`):** المحرّر كامل، وClaude مخفي. زر «اسأل Claude» يفتح لوحة جنب المعاينة فيها «يعدّل على:» (الجملة أو الطبقة المحددة، أو المقطع كله)، والطلب يوصلك ومعه وش محدد. **عدّل اللي حدده بس**، ولا تلمس باقي المقطع إلا لو طلب.
- **مين يحدد الوضع:** اختياره بالمكتبة («Claude يمنتجه» أو «مونتاج يدوي»)، و`hs open` على مشروع لسه ما جهز يحطه على `claude` لو ما له وضع. ولو Claude وقف وانجهز المشروع للتعديل اليدوي يتحول `manual`. المشاريع القديمة بدون وضع تفتح يدوي.
- **أنت تقدر تغيّره:** `hs mode <work>` يقول الوضع، و`hs mode <work> manual|claude` يغيّره. لا تغيّره من نفسك إلا لو طلب، أو بعد التسليم لو قال «بعدّل بنفسي».
- أي زر يشغّل Claude ينبّهه قبل إنه يصرف من حدّه (نفس تنبيه «اطلب من Claude»).

## 6ع) الهوك والنصوص المربوطة والأقسام (4.20)

- **الهوك عنصر زي غيره:** يطلع بأول سطر بالتايم لاين، يضغطه (أو يضغط عليه بالفيديو) وتنفتح لوحته: الصيغ الثلاث، الشكل، الخط، الحجم، لون الكلام والكرت، مكانه فوق وتحت ويمين ويسار، الدخول، والمدة. ويسحبه بالدائرة على الفيديو. بالأوامر: `hs set <work> hooks.y=0.3 hooks.x=0.5 hooks.size=90 hooks.color=#FFFFFF hooks.bgColor=#141413 hooks.font=… hooks.anim=pop hooks.dur=2.6`.
- **ربط النصوص باللقطة:** الطبقات تمشي مع اللقطة لو انحذف جزء قبلها (الافتراضي). زر «ربط النصوص» بالتايم لاين يطفيه للكل (`hs.pinLayers=false`)، ولكل طبقة مفتاح «يمشي مع اللقطة» (`L.pin`). الطبقة اللي مو مربوطة تبقى بثانيتها وإطارها متقطع بالتايم لاين. لا تغيّرها إلا لو طلب.
- **الأقسام تكبر وتصغر:** يسحب طرف القسم اللي يسار أو يمين، ودبل كلك يرجّعه. ينحفظ على جهازه.
- **تعديلاته البسيطة ما تحتاجك:** كل شي بالاستوديو يتعدّل بيده. لا تقترح عليه تعديل يقدر يسويه بضغطة إلا لو سألك.

## 6س) أصوات من حسابه: ElevenLabs وHiggsfield وغيرها (4.19) ⛔ لا تصرف من رصيده بدون موافقته

1. **أول المونتاج شوف أدواتك:** فيه أداة توليد أصوات من موصّل مربوط؟ (أدوات ElevenLabs مثل المؤثرات الصوتية والموسيقى والصوت، أو `generate_audio` من Higgsfield). سجّلها مرة: `hs sound providers set elevenlabs higgsfield` (أي خدمة ثانية: `set <اسمها> --name "الاسم"`). ما فيه؟ `hs sound providers off`.
2. **صفحة الأسئلة تسأله** «منين الأصوات؟»: المكتبة المجانية وأصواته، أو الخدمة (مكتوب جنبها «من رصيدك»). لا تسأله بالشات.
3. **اختار الخدمة؟** المكتبة وأصواته أول، وولّد بس اللحظات اللي ما لها صوت مناسب. **قل له كم صوت بتولّد قبل ما تبدأ.** وصف كل صوت قصير وواضح (وش الصوت، ومدته، وبدون كلام)، والموسيقى بدون غناء وبطول المقطع.
4. **احفظ وسجّل:** كل ملف بـ `<work>/assets/sfx/` ثم `hs sfx <work> import <الملف> --name "…" --note "متى ينستخدم" --gen <الخدمة> --prompt "الوصف"`، وبعدها `hs sfx <work> add <id> <ثانية>` بقواعد `editing-rules.md`. اللي يتولّد يصير من «أصواتي» ويرجع له بكل مشاريعه بدون ما يصرف مرة ثانية، فدوّر فيها قبل أي توليد.
5. ⛔ **لا مفاتيح API:** الربط يكون من موصّلات Claude بحسابه (claude.ai ← الإعدادات ← الموصّلات). اللي عنده مفتاح بس يضيفه بنفسه بجهازه، وأنت لا تطلبه ولا تكتبه. ولو ما عنده رصيد أو الأداة رفضت: قل له وكمّل من المكتبة.

## 6ف) تحسين الجودة (4.25)

- `hs quality <work> light|strong|off` يطلّع فريمات الفيديو من جديد بتنظيف التشويش وتوضيح التفاصيل (ويرفع لـ1080 لو أقل). ينطبق على الفيديو بس قبل الكابشن. `preview <ثانية> [light|strong]` يطلّع صورة قبل وبعد بـ`.hs/qprev.jpg`.
- اقترحه لو الفيديو مصوّر بإضاءة ضعيفة أو دقته أقل من 1080 (`strong`)، وإلا `light`. ياخذ دقيقة لدقيقتين، والتصدير صار بجودة أعلى لحاله.
- المشروع اللي ما فيه `cut.json` (مبني بالموشن أو غيره): أول قص يحفظ الفيديو الحالي `src-cutz.mp4` كأصل، والقص والتصدير يشتغلون منه.

## 6ص) بودكاست (beta) والدبلجة (4.26)

**البودكاست** (بالمكتبة «بودكاست beta»، وهو نفس مجلد الحلقة `clips.json`):
1. رابط يوتيوب: النص ينسحب من ترجمة يوتيوب بدون تحميل (`clips_text`: `long.json` و`transcript.txt`)، ويطلع **ضعف العدد** اللي طلبه مرشّحات، كل وحدة بنصها كامل (`text`). ملف أو رابط بدون ترجمة: يتحمّل ويتفرّغ زي قبل.
2. **المعنى كامل (4.32):** كل مرشّح يبدأ من أول الفكرة ويخلص بآخرها (`thoughts`: السكتات، و«و/بس/لأن» بأول الجملة، و«على/اللي/في» بآخرها). لو الفكرة أطول من طلبه عادي، ولو أطول مرة تنترك، **ولا ينقص بنص الكلام أبداً**. لما تقيّم المرشّحات اقرأ النص قبلها وبعدها: لو تبدأ بنص قصة أو ترد على شي قبلها (جواب بدون سؤاله، «هذا/اياه» بدون ما ينعرف وش)، رجّع البداية لأول القصة أو احذفها (`cand rm`).
3. هو يختار من المكتبة، أو «هات غيرها» يجيب مرشّحات جديدة ما تتداخل مع اللي شافها (ويبقي اللي حددها). لو طلب منك: `hs clips cand <dir> list` وقيّمها بالنص (`cand set`)، ولا تقص شي قبل ما يختار.
4. اللي يختاره بس ينزل (`yt_section`: الجزء وحده مع ثانية زيادة)، ويطلع مقطع بأسلوب البودكاست الخفيف: كابشن خفيف بلغة المتكلم + سطر ترجمة (`want.tr`) + عنوان فوق، **بدون مؤثرات ولا فلسفة**. ترجم بـ`hs tr <work> export` ثم `import`.
5. **الشكل الافتراضي (4.27، من مقطع أرسله):** كابشن سطرين أبيض بظل بدون خلفية تحت الوسط (`POD_CAP`)، وكلمة مهمة وحدة تقريباً كل 8 كلمات **بالذهبي** (`fixes.json` ← `hot`، تنختار لحالها وراجعها أنت)، و**اسم المتكلم** بصندوق غامق فوق يمين (طبقة نص `auto:"name"`، الاسم من عنوان الحلقة «مع فلان» أو `pod.speaker`)، والكادر ثابت بدون زوم يتغيّر (`hs.vpos.still`). لا عنوان كبير فوق (`pod.titleOn:false`) إلا لو طلبه. لو ما لقيت الاسم بالعنوان، اكتبه بطبقة الاسم.
   - بالترجمة: لوّن الكلمة المهمة بنجمتين `*كذا*` داخل الترجمة (مرة وحدة بالسطر).
   - **الهوية (4.37):** كل مقطع من الحلقة ياخذ هويته (المختارة بالمكتبة أو الافتراضية): لون الكلمة المهمة، خط الكابشن، صندوق الاسم. «بدون» بالمكتبة يطفيها.
   - **قوالب جاهزة مع الاسم** بتبويب الكابشن (مقابلة، صندوق، ورقة، عريض، هادي، الاسم تحت): كل وحدة تغيّر الكابشن وصندوق الاسم مع بعض.
   - **مكان الفيديو** (تبويب المشروع): يشوف الصورة الأصلية كاملة ويسحب مربع ويكبّر، والفيديو يتقص من الأصل من جديد (`hs.vpos` = `x` مكان المربع بالعرض، `y` بالطول، `z` تكبير، `still`). لو طلب «حرّك الفيديو» أو «قرّب عليه» عدّل `hs.vpos` وأعد البناء.
6. **شخصية المقدّم الثابتة** (اختيارية، مطفية بالأساس من 4.27؛ نفسها لكل عملائه): `host.json` بالإعدادات (الاسم والشخصية واللون)، وتنحط بزاوية كل مقطع بودكاست (طبقة `char` بـ`auto:"host"`). لا تشيلها إلا لو طلب.

**الدبلجة** (طلبها بالمكتبة يحفظ `hs.dubWant`، أو قال «دبلج»): الصوت الأصلي **ينشال كامل** والدبلجة بنفس سكتاته.
1. `hs dub <work> script <ar|en|es|…>` يكتب `dub.json` و`dub-script.txt`: كل جملة بوقتها ومدتها وكم كلمة تتسع (`words`) والسكتة بعدها.
2. ترجم كل جملة **بنفس طولها تقريباً** (لا تزيد عن `words`)، بالمعنى مو الحرف، وبلهجة طبيعية للغة الهدف، ثم `hs dub <work> import <ملف>` بشكل `[{"i":0,"tr":"…"}]` (يصير سطر الترجمة بالكابشن بعد).
3. **الصوت:** لو ElevenLabs مربوط بك وهو وافق إنه يصرف من رصيده (قل له كم جملة قبل): ولّد كل جملة بصوت واحد ثابت، احفظها وأضفها `hs dub <work> add <رقم> <ملف>`. ما فيه ElevenLabs؟ أعطه `dub-script.txt` (أو زر «انسخ السكربت بالتوقيت» بتبويب الصوت) يسجّله أو يولّده بنفسه، ويرفع الملف الكامل من نفس التبويب أو `hs dub <work> track <ملف>`.
4. `hs dub <work> build`: كل جملة عند بدايتها، والأطول من مكانها تتسرّع لين ×1.3، والأطول من كذا يطلع تنبيه: قصّر ترجمتها وأعد توليدها. `hs dub <work> status` يقول وش ناقص، و`off` يرجّع الصوت الأصلي. التصدير والمعاينة ياخذون الدبلجة لحالهم.
⛔ لا مفاتيح API، ولا تولّد صوت شخص حقيقي غيره بدون إذن صاحب الصوت.

## 6ق) مؤثرات 4.28 (من مقطعين أرسلهم راكان)

كلها `type=mg` بالـ`kind` (وتطلع بالاستوديو بـ«العناصر ← موشن جاهز»):
- `stretch` **تمطيط الكلمة**: `text="بدون\nبرامج مونتاج"` السطر الأول ملوّن وأطول كلمة بكل سطر تتمطّط (كشيدة بالعربي، تباعد حروف بالإنجليزي). `stretch=6` قد إيش. للكلمة اللي يشدد عليها.
- `rec` **شاشة تصوير**: زوايا وREC ووقت وعدّاد صوت يتحرك مع كلامه و`label="خام · بدون مايك"`. للمقطع الخام أو «قبل».
- `notif` **إشعارات تتراكم**: `text="فرّغت كلامك | 80 كلمة\nنظّفت صوتك | بدون مايك"` كل سطر يطلع لما ينقال أول كلمة فيه والقديم ينزل. للخطوات اللي سواها.
- `search` **خانة تكتب**: `text="فيديو" cta="وصلك كل شي بالخاص"` تنكتب حرف حرف وبعدين الكلمة كبيرة وزر. للدعوة بالختام (نفس كلمة الدعوة بالصوت والكابشن).
- `apps` **برامج تنشطب**: `icons="Premiere, CapCut, After Effects"` و`style=row` (صف فوق ينشطب وحدة وحدة) أو `style=wall` (حائط يتشوّش وينشطب كله ويطيح، ورقم `count=0 label=برامج`، ولابتوب يطيح وينفجر). لما يقول «بدون برامج» أو «ما تحتاج».
- `articles` **الكلمة بمقالات كثيرة**: `word=Success` صفحات ورق تتقلّب بسرعة والكلمة مظللة بالنص والباقي مغبّش. `layout=card` كرت صغير فوقه بدل ملء الشاشة. لما يذكر كلمة بحث عنها أو «كل الناس تقول».
- `mosaic` **صور كثيرة**: `items` صور (أول وحدة يبدأ فيها، الأخيرة يرجع لها، والباقي يملأ) تبعد لين تصير آلاف وترجع تقرّب على وحدة ثانية. لما يقول «ملايين الناس» أو «واحد من كثير». الصور من `hs media search` (صور حقيقية بإذن استخدام) أو يرفعها هو. ⛔ لا تولّد وجوه أشخاص حقيقيين.
- `rewind` **ترجيع**: `back=4` الفيديو يرجع لورا بسرعة مع تشويش شريط و«ترجيع»، ومدة الطبقة هي مدة الترجيع. قبل ما يرجع للفكرة أو يلخّص.
- `freeze` **تجميد اللقطة (4.36)**: `hs layer <work> add type=mg kind=freeze style=flash "label=هذا أنا" s=<ث> e=<ث>`. الفيديو يوقف على فريم أول الطبقة، وصوته والكابشن يكملون، ومدة المقطع ما تتغيّر. `style`: `flash` فلاش وتقريب بطيء على وجهه واسم بسهم يأشّر عليه (`zoom=0.08`، من 0 إلى 0.3) · `photo` اللقطة تصير صورة مطبوعة مايلة فوق نفسها مغبّشة والنص تحتها (`sub` سطر ثاني مثل التاريخ، `tilt=-4`) · `comic` نقط كوميكس وإطار وصندوق أصفر (`sub` صندوق ثاني تحت، `y` مكان الصندوق) · `film` أبيض وأسود بحبيبات وأشرطة سينما والنص ينكتب تحت (`sub` سطر صغير). `flash=false` بدون فلاش، `nocap=true` يخفي الكابشن وقتها، `label=` فاضي بدون نص. متى: لما يعرّف بنفسه أو بشخص أو مكان («هذا أنا قبل سنتين»)، أو لحظة قصة يوقف عندها، أو بعد جملة قوية. 1.5 إلى 3 ثواني، ومرة وحدة بالمقطع (مرتين بالكثير وبشكلين مختلفين). حطه على بداية جملة قصيرة أو على كلمة يعرّف فيها، لأن فمه يوقف وهو يتكلم. وتقدر تحط معه صوت ضربة خفيفة (`cc-impact-soft-1`) أو `cc-whoosh-reverse-1s` عند بدايته. هو يقدر يحطه بنفسه: كليك يمين على التايم لاين أو الفيديو ← «جمّد اللقطة هنا».
- `ba` **قبل وبعد**: `from=<ثانية>` كرتين جنب بعض: بعد المونتاج والخام من نفس اللحظة، وتحتهم كلامه الحين. لما يطلب مقارنة الخام مع النتيجة.
- **داخل جوال:** لقطة بي-رول (تصوير شاشة يرفعه) بـ`mode=phone` بـ`brollClips`: تطلع داخل آيفون يتحرك وتحته صاحب المقطع (`pip:false` تشيله)، و`badge="×8"` شارة جنبه، و`taps=[[ثانية,x,y],…]` ضغطات على الشاشة.
- **قص الراس برا الكرت** موجود من قبل (`headout`)، وكتابة ورا الشخص (`behind`).

**الفيديو نفسه (4.31):** `hs.vxf = {x, y, s}` يحرّك الفيديو ويكبّره فوري (بكسل على 1080×1920، و`s` الحجم). هو يحدده بضغطة على المعاينة ويسحبه، والعجلة تكبّر. للقص من الأصل الأوسع استخدم `hs.vpos` (قسم 6ص).

**ملاحظات «لازم تعدّلها» (4.29):** بعد كل مونتاج شغّل `hs notes <work> auto` (ينشغل لحاله بالتجهيز بعد). وأي شي تشوفه صعب ينقرا أو مو متأكد منه (كلمة ما انسمعت، اسم ما تعرف كتابته، رقم مو واضح)، لا تخمّن: حط ملاحظة `--kind fix` عند وقتها تقول له وش يصلّح بالضبط.

**صورة لكل شي ينذكر (افتراضي من 4.28):** لما يذكر شركة أو تطبيق أو موديل أو منتج أو مكان أو شخص عام أو شي ملموس، حط صورته وقتها:
1. الشركات والتطبيقات: `hs logo <work> auto` (شارة الشعار، و«X أفضل من Y» شارتين).
2. الباقي: `hs media <work> search "<الشي بالإنجليزي>"` ثم `add <رقم> --at <وقت الكلمة> --dur 2.5 --fit card`. وحدة كل 4 ثواني بالكثير، ولا تغطي وجهه ولا الكابشن (ممنوع نص فوق نص).
3. لا صورة مولّدة لشخص حقيقي أو شعار. ولو ما لقيت صورة مناسبة، خلّها بدون.

## 6ر) حركة بالمفاتيح (4.29)

أي طبقة نص أو صورة (مو ملء الشاشة) أو شخصية أو شريط اسم أو علامة أو رسم حر، تقدر تحركها بمفاتيح مثل CapCut: كل مفتاح وقت وفيه المكان والحجم والدوران والشفافية، والطبقة تتحرك بينها لحالها.
- **بالاستوديو:** يحدد الطبقة ← «حركة بالمفاتيح» ← «◆ مفتاح هنا»، يحرك المؤشر، ويغيّر القيم أو يسحب الطبقة على الفيديو، فينحط مفتاح ثاني لحاله. المعينات على الطبقة بالتايم لاين هي المفاتيح. وفيه 6 حركات جاهزة.
- **من الطرفية:** `hs kf <work> <id> add <ثانية بالتايم لاين> [dx= dy= s= r= o= e=]`. `dx`/`dy` إزاحة بالبكسل على 1080×1920 (سالب = يسار/فوق)، `s` حجم (1 عادي)، `r` دوران بالدرجات، `o` شفافية 0 إلى 1، و`e` طريقة الوصول للمفتاح اللي بعده: `smooth` ناعم (الافتراضي) · `linear` ثابت · `back` ارتداد · `hold` قفزة. المفتاح الجديد ياخذ القيم اللي عندها الطبقة بهالثانية، فحط بس اللي يتغيّر.
- **الجاهز:** `hs kf <work> <id> preset across` (يعبر الشاشة) · `grow` (يكبر ببطء) · `rise` (يطلع لفوق) · `spin` (يلف ويوقف) · `pulse` (ينبض) · `sway` (يتمايل). يمسح المفاتيح القديمة ويحط الجديدة على مدة الطبقة.
- **متى:** صورة منتج تدخل من طرف وتوقف جنب وجهه، رقم يكبر مع كلامه، سهم أو علامة تتبع شي يتحرك، عنوان يطلع ويطلع لفوق. مرة أو مرتين بالمقطع، مو على كل نص. وما تتعارض مع دخول الطبقة (`anim`)، تنضاف فوقه.
- البيانات: `kf=[{t,dx,dy,s,r,o,e}]` بالطبقة، و`t` من بداية الطبقة. بدون `kf` الطبقة تطلع نفس قبل بالضبط.

## 7) طلبات تحتاج أدوات خارجية

- **دبلجة إنجليزية:** بأداة الدبلجة في Higgsfield على الملف النهائي لو الموصل متوفر بجلستك، وإلا قل له إنها تنطلب من محادثة Claude العادية. تكلّف رصيد، فأكّد قبلها.
- **اقتراحات بي-رول:** اكتبها في `hs.ideas` وتظهر له في «الملفات». اللقطات يرفعها هو، أو تتولّد من حسابه (قسم الصور والمقاطع).

## قواعد ثابتة

0. **لا مونتاج قبل إجاباته.** `brief ask` ثم `wait` ثم `apply`، إلا لو قال صراحة «بلا أسئلة».
0أ. **لا تسليم قبل `brief check` كله ✓.** كل إجابة اختارها لازم تنطبق فعلاً، مو تنقرأ وتنتسى.
0ب. **لا أسئلة عن المونتاج بالمحادثة.** كلها بصفحة الأسئلة، ومنها ألوان حسابه.
1. **لا تعدّل ملفات السكل (`engine/` والاستوديو) وأنت تمنتج.** شغلك في ملفات المشروع. تعديل السكل نفسه فقط لو طلب منك تطويره صراحة (أو مهمة تحديث مجدولة طلبها هو): عدّل، شغّل `hs selftest` لين يطلع «كل شي سليم»، واكتب السطر في `CHANGELOG.md`.
1أ. **لا تثبّت شي بدون ما تشرح.** كل أداة: وش هي، ليش، من وين (`hs tools`). وبعد موافقته فقط.
1ب. **بلا مفاتيح API.** التوليد من حسابه الشخصي فقط (قسم الصور والمقاطع).
1ج. **المنصة شرط مو اقتراح.** المدة والإيقاع ومكان الكابشن ونبرة البوست تتبع منصاته.
2. **الكابشن ما ينكتب على وجه المتحدث.** الإضافة ترفعه فوق كرت الفيديو تلقائياً، فلا تلتف عليها.
3. **لا تحذف ملاحظة، ولا تعلّمها «تمّت» إلا بعد التنفيذ.**
4. **تعليقات العميل ما تنفّذها** إلا بعد ما المستخدم يحوّلها لملاحظة.
5. **احفظ نسخة قبل أي تغيير كبير** أو ذكّره بها (تبويب المشروع).
6. **رابط الجوال ورابط العميل برموز دخول.** لا تشغّله على شبكة عامة، ولا تنشر الرموز.
7. **لا نشر ولا جدولة إلا بطلبه، ومن متصفحه، وبعد «نعم» صريحة على الضغطة الأخيرة** (قسم 6ج).
8. **لا ترسم شخصية أو شعاراً معروفاً بيدك.** الشخصيات المبنية أصلية، والمستخدم يرفع صورته لو يبغى غيرها. شعار الشركة اللي يتكلم عنها يجي من ملفها الرسمي (`hs logo`)، مو رسم منك.
9. حركات الكلمة `slam` و`stretch` و«ورا الراس» ما ترسمها إضافة الاستوديو بنفس شكل كابشن المحرّك الأساسي. لو المقطع يعتمد عليها خلّ `cap.on=false`.
10. القواعد الثابتة في `MONTAGE.md` كلها سارية (المنطقة الآمنة، أرقام غربية، لا تخترع كلاماً ما قاله).
11. **ذوق المونتاج (4.7):** كل قطعة لها سبب · الوعد بأول 3 ثواني بدون سلام أو شعار · السكتة بالشورت حوالي 160 جزء من الثانية (طلبه بـ4.9: أقصر من قبل بس مو صفر) · الزوم له سبب وما يعدّي القطعة · الموسيقى تحت الكلام وتنخفض · المؤثرات أقل من الحركات، وما يتكرر نفس الصوت أكثر من 3 مرات ورا بعض. الأرقام كاملة في `editing-rules.md`.
12. **اختيار الجمل والخطة (4.10):** الإعادات تختارها أنت بالمعنى وتكتب السبب، والخطة يوافق عليها قبل البناء، والأرقام تتأكد منها قبل التصدير.
13. **صوت استوديو (4.12):** شغّله بكل مونتاج بعد القص (`hs voice <work> studio on`) وانقل له سطر الأرقام بملخص التسليم، وقله يقدر يقارن «الأصل | الاستوديو» بالاستوديو. لا ترفع صوته لأي موقع بنفسك: Auphonic أو Adobe من حسابه هو.
14. **الموشن جرافيك أساسي (4.37):** أي طلب حركة يمشي على `motion-graphics.md` بدون ما ينطلب بالاسم، إلا لو قال ثابت. والهوية المحفوظة تنطبق على كل شي، وما تسأله عنها بالمحادثة.

## التحقق قبل ما تقول «خلصت»

- `00_setup.sh` و`hs doctor` طلعوا «جاهز».
- الكابشن وكل نص داخل النطاق الآمن اللي طبعه `apply`، ولو المقاس مو 9:16 شفت لقطة من النسخة المقصوصة.
- لو منصته إكس: المدة 140 ثانية أو أقل، أو أكّد إن حسابه مشترك.
- `hs status <work>` يطبع الرابط والمراحل، والرابط يفتح والمعاينة تتحرك مع التشغيل.
- كل كرت شرح شفته بمعاينة: الوجه كامل، ما فيه عنصر طالع برّا، والأشكال متنوعة.
- معاينة رسم حقيقية بعد أي تغيير بصري: `node <engine>/scripts/04_render_frames.js <work> preview <3 أوقات>` واقرأ ورقة لقطات وحدة.
- بعد التصدير: فحص المنطقة الآمنة (`08_safe_check.js`)، وقائمة «التحقق قبل التسليم» في `MONTAGE.md`.
- `hs retention <work>` قبل ما تقول «جاهز»: لو الدرجة تحت 70 صلّح المحلي من التصليحات أو قل له وش الناقص.
- **فيه موشن؟** فحص قسم 7 بـ`motion-graphics.md` على المعاينة (12 بند). **فيه هوية؟** الألوان والخط والدعوة بالمعاينة نفسها اللي بـ`identity.md`، و`hs identity check` سليم.

## مشاكل معروفة

- **شاشة سوداء أو فاضية بالمعاينة** ← غالباً مشهد `R_OFF` بلا رسم فوقه. شيله من `scenes` أو حط له كرت شرح.
- **وجهه مقصوص أو منزاح داخل الكرت** ← `hs face <work>` ثم ارسم معاينة. لو المقطع ما فيه وجه واضح يبقى المكان الافتراضي.
- **الخلفية ما تغيّرت أو النص ما مر وراه** ← القناع لسه ينبني (ثواني)، أو `engine/vision` ناقص (`hs doctor` يقول). أعد: `hs mask <work> <من>-<إلى>`.
- **الجوال يعلّق أو بلا صوت** ← يحدّث الصفحة مرة. المعاينة على الجوال بنص الدقة عشان تمشي، والتصدير ما يتأثر.
- **«ما لقيت مجلد engine»** ← ملفات السكل ناقصة. ينزّل السكل كامل من جديد.
- **الإشعار ما وصل** ← `hs notify status` ثم `hs notify test`. يحتاج نت، والقناة بتطبيق ntfy نفس اسم القناة بالضبط.
- **صفحة النشر تغيّرت ولا لقيت الزر** ← لا تخمّن. خذ لقطة شاشة وقل له وش تشوف.
- **ميزة مذكورة في `MONTAGE.md` وسكربتها مو موجود** ← أول الملف فيه قائمة «غير متوفر بهذي النسخة». تخطّاها وقل له.
- **التجميع يفشل على ويندوز** ← لازم Git for Windows (السكربت يقدّمه على WSL تلقائياً).
- **الخط ما تغيّر بالرسم** ← خطوط Google تحتاج نت. بلا نت استخدم خطاً مرفوعاً.
- **الجوال ما يفتح** ← نفس الواي فاي، وجدار الحماية يسمح للبورت 8800.
- **بحث الصور فشل** ← يحتاج نت. والاستعلام بالإنجليزي وبكلمات بسيطة.
- **`gen import` يقول ما لقيت الملف** ← المسار كامل وبين علامتي تنصيص، والتنزيل خلص فعلاً (مو `.crdownload`).
- **ChatGPT أو Gemini يطلب تسجيل دخول أو يقول الحد خلص** ← لا تحاول تتجاوزه. قل له، وخلّ الطلب ينتظر.
- **أرقام أو أقواس مختفية بالواجهة** ← لو خط الواجهة الخاص موجود في `fonts/`، أرقامه اللاتينية وأقواسه فاضية بالملف، فالواجهة تستخدمه للحروف العربية فقط. لا توسّع `unicode-range` حقه في `studio.html`.
- **النسخة 4:5 أو 1:1 قاصّة نص** ← ارفع أو نزّل العنصر لداخل الحزام، أو حرّك القص بـ`frame.cy`.
- **زر «نفّذ» ما يشتغل** ← Claude Code مو مثبّت أو مو مسجّل دخول. الطلب ينسخ بدلها.
- **الرابط ما انسحب** ← `yt-dlp` قديم (`python -m pip install -U yt-dlp`)، أو الموقع يبي دخول (`hs hub --cookies chrome`)، أو المقطع خاص.