فيديو سجل التغييرات

# سجل التغييرات ← فيديو ذو علامة تجارية

المدخل: ملف سجل التغييرات .md (المواضيع + العناصر، مثل ملخص HyperFrames الأسبوعي). المخرج: مشروع HyperFrames نظيف من الأخطاء، بلون أخضر "seam-gate-green" في `projects/active/weekly-changelog-<range>/`. يتم التقديم عند الطلب فقط.

**يجب تحميلها أولا، وغير قابلة للتفاوض:** `motion-doctrine` (+ `cut-the-curve`، `oversized-cursor` إذا ظهر مؤشر، `seam-craft`) و `captions-overlay`. توفر هذه المهارة مسار عمل سجل التغييرات المحدد؛ ويوفر "doctrine" قانون الحركة.

## التوجيه الأساسي: تصور، لا تسرد

يتم توضيح كل موضوع بواسطة **نموذج متحرك للواجهة الرسومية الفعلية أو نظير موثوق به** يظهر التغيير في التجربة — وليس نقاطا نصية أبدا. وجه كل موضوع/عنصر عبر `references/visualization-registry.md` قبل كتابة النص؛ يقرر السجل إعادة إنشاء الواجهة الرسومية / نظير الواجهة الرسومية / الطرفية / قائمة التحقق. قائمة التحقق النصية هي الملاذ الأخير، ومخصصة للعناصر غير المرئية حقا (قوائم إصلاح الموثوقية).

## مسار العمل

### 0 · تهيئة المشروع من أصول هذه المهارة — غير قابلة للتفاوض

**افعل ذلك قبل كتابة أي HTML للتركيب. تخطي هذه الخطوة ينتج دائما فيديو يبدو وكأنه مشروع مشابه قمت ببنائه من قبل، وليس علامة هذه المهارة التجارية — هذه هي الطريقة الأكثر شيوعا التي تخرج بها هذه المهارة عن علامتها التجارية.** أصول المهارة والخطوط والهيكل هي المهارة؛ موجه SKILL.md هو موجه.

```bash mkdir -p project/assets/fonts cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/ cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3 ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \ -vf "scale=1080:1080,fps=30,eq=saturation=0.72,drawbox=c=black@0.5:t=fill" \ -an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4 cp <SKILL_DIR>/examples/master-skeleton.html project/index.html ```

ثم **اقرأ `references/build-spec.md` من البداية إلى النهاية** (لا تقم بالتصفح السريع) — فهو يحدد رموز العلامة التجارية (TT Norms Pro + ABC Solar Display + TT Norms Mono، كريمي `#f5f6f4`، أخضر مقنن `#5ef17c`، بطاقات زجاجية ذات حدود خضراء اللون، شكل حبة kicker/sec-chip، شريط تعليق 32 بكسل عند `top: 990`) التي ترثها كل مشهد من الهيكل.

بعد ذلك فقط ابدأ الخطوات 1-6 أدناه. الخطوات 1-4 (تحليل، توجيه، نص، تعليق صوتي) تخطط لما يدخل في الهيكل؛ الخطوة 5 تملأ العناصر النائبة (`<RANGE>`، `<TOTAL>`، `<CUT_N>`، `<DUR_N>`، محتويات المشهد) داخل `project/index.html` المنسوخ بالفعل — أنت لا تعيد كتابة تصميم الهيكل، أو الخطوط، أو لوحة الألوان، أو غلاف التخطيط.

إذا وجدت نفسك تستخدم `cp` على ملف `index.html` لفيديو سابق، أو تكتب إعلانات `@font-face` الخاصة بك، أو تصمم خلفية WebGL shader بدلا من استخدام ملف MP4 لنمط الخلفية المشفر أعلاه: توقف. احذف `index.html` الحالي وابدأ من جديد عند `cp` للهيكل الرئيسي. إعادة بناء محتوى المشهد على الهيكل الصحيح أرخص من تعديل العلامة التجارية في الهيكل الخاطئ.

### 1 · تحليل + قص تحريري

- استخرج: نطاق الأسبوع، إحصائيات العناوين الرئيسية (الإصدارات، الالتزامات)، المواضيع، العناصر. - **الميزانية: 45-60 ثانية إجمالا.** العنوان ≤2 ثانية، الخاتمة ≤3.5 ثانية، 4 مواضيع ≈ 9-12 ثانية لكل منها. - لكل موضوع، احتفظ بتصور بطل واحد + 3 عناصر منطوقة كحد أقصى. كل شيء آخر موجود فقط كمؤشر "ملخص كامل" في الخاتمة. القص هو المهمة: سجل التغييرات الذي يحتوي على 30 عنصرا لا يزال ينتج ≤14 إيقاعا منطوقا. - رتب المواضيع حسب القصة: ميزة رئيسية ← سطح المنتج ← الأداء ← الموثوقية (عادة ما يقرأ الملخص بهذه الطريقة بالفعل).

### 2 · توجيه التصور

لكل موضوع، اختر السطح من `references/visualization-registry.md` واكتب سطرا واحدا: `الموضوع ← السطح ← الإجراءات المتسلسلة من 2-4 التي يقوم بها النموذج، كل منها مرتبط بعبارة نصية`. إذا لم يتناسب أي سطح من السجل ولم يوجد نظير موثوق به، فهو مشهد قائمة تحقق — لا تخترع واجهة مستخدم مزيفة لشيء لا يمكننا تمثيله بصدق.

### 3 · نص ذو طبقتين (منطوق مقابل معروض)

اكتب النص ك **خطوط رمزية** وفقا ل `references/script-voice.md`: سجل محادثة، كل مصطلح تقني يحمل شكلا صوتيا `spoken` من `references/lexicon.json` بينما يحافظ `display` على التهجئة القياسية. تظهر التسميات التوضيحية `display`؛ يقرأ التعليق الصوتي `spoken`. أي مصطلح غير موجود في المعجم: توقف واسأل المستخدم عن كيفية نطقه، ثم أضفه إلى المعجم. احفظه باسم `script-tokens.json` في المشروع.

### 4 · التعليق الصوتي — آني (HeyGen، مثبتة)

```bash # spoken-layer text only; words JSON = ground-truth timestamps of the SPOKEN text # Repo-native path: the changelog-video skill runs from the hyperframes repo root, # so it uses the tracked hyperframes-media TTS helper directly (no `npx hyperframes # skills` install step). If you've copied the skill into another repo, swap in # your own path to the media-use / hyperframes-media heygen-tts.mjs. node skills/hyperframes-media/scripts/heygen-tts.mjs ./vo-spoken.txt \ -o voiceover.mp3 --words vo-words.json \ --voice 330290724a1b470fb63153f34d4c0183 # Annie — lifelike (do not substitute) ```

يتطلب `heygen` CLI ≥0.3.0 مصادق عليه (`heygen auth login --oauth`). ثم قم بمحاذاة الطوابع الزمنية المنطوقة مرة أخرى مع الرموز المعروضة:

```bash node <SK ```