Communitygithub.com

ascorblack/video-skills

HTML/瀏覽器影格渲染與優化規則 — 處理逐格渲染、跳轉播放、確定性、NVENC 編碼、分離音訊及版本管理的專業技能。

video-skills 是什麼?

這個技能提供了一系列從實戰專案中提煉出的規則與最佳實踐,專門用於處理從 HTML 或瀏覽器影格渲染影片的流程。它教導開發者如何避免常見的陷阱,例如基於時間而非連續播放的渲染特性、使用補間動畫代替 `@keyframes`、以及透過影格編號計算雜訊來確保確定性。技能內容涵蓋多個關鍵領域:渲染效率(使用 Workers、分離會話)、編碼品質(NVENC 搭配位元率限制、PSNR 比較)、以及交付流程(無損音訊嵌入、ffprobe 驗證、版本保留)。這些規則支援 Claude Code、Cursor 等 AI 代理工具,並引用自「視覺」、「3D」、「聲音」等歷史專案課程,能顯著提升渲染結果的重複性、速度與最終品質。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ascorblack/video-skills/tree/HEAD/ru/skills/video-render

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

渲染與優化

每條規則都來自過去影片的教訓;方括號內為來源(圖例見下方)。 當來源有衝突時,會列出兩種建議,並標明各自適用的情況。

簡短規則

  1. 渲染是根據時間點抓取影格,而不是連續播放動畫:一個屬性對應一個動畫,脈衝效果應使用補間動畫而非 @keyframes。[視覺]
  2. 將外部腳本與字型放入專案中,不要在渲染期間動態載入。[視覺][科普]
  3. 根據影格編號計算雜訊顆粒,而非隨機生成器[科普];應保存隨機數生成器的序列,並確保舊版本能逐位元組一致地重新建構。[聲音]
  4. 在加速之前,先確認時間花在哪裡。[3D]
  5. 使用 NVENC 進行編碼,同時限制位元率;透過相同片段上的 PSNR 比較編碼器品質。[3D]
  6. 渲染應脫離會話執行;兩個版本應依序進行,而非同時使用同一張顯示卡。[3D]
  7. 將檔案轉移到渲染機器後,請比對檔案的檢查碼。[3D]
  8. 將影像與聲音分開處理:透過複製視訊串流來嵌入聲音,不要重新編碼影像。[影片][視覺][3D]
  9. 提交前使用 ffprobe 檢查,並確認頁面確實提供新檔案。[影片]
  10. 請勿刪除舊版本。[影片][聲音]

詳細說明

  • seek-render.md — 逐格渲染搭配跳轉播放的常見問題與確定性。
  • performance.md — 時間耗費在哪裡、編碼、workers、渲染啟動。
  • mux-and-delivery.md — 嵌入聲音、檢查成品、版本管理。

來源

  • [聲音] — 關於聲音與配音的歷史課程,用於宣傳影片與簡報。
  • [影片] — 關於影片的歷史課程:介面錄製、節奏、轉場。
  • [視覺] — 關於視覺的歷史課程,用於從示意圖影格製作宣傳影片(HTML 影格 → 逐格渲染搭配跳轉播放)。
  • [3D] — 關於瀏覽器中第一人稱 3D 影片的課程(three.js → 逐格渲染)。
  • [科普] — 關於模仿 70 年代初蘇聯科普與幻燈片風格的影片課程。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

ascorblack/video-skills

Правила 3D-анимации для роликов в браузере (three.js → покадровый рендер) и анимации фигур с предметами — руки и тело от первого лица, рукав и манжета, контакт кисти с предметами и поверхностями, смешивание поз и углов, расталкивание персонажей, ходьба без скольжения, свечение, контактные тени, процедурные материалы, детекторы пересечений и рывков. Используй, когда строишь, анимируешь или проверяешь 3D-сцену, персонажей, руки, предметы в руках или свет в ролике.

ascorblack/video-skills

Правила звука для роликов — фоновая музыка и звуковое оформление, совпадение звука с картинкой, сведение голоса и музыки (LUFS, истинный пик, приглушение), удлинение музыки без стыков, синтез дикторской озвучки (дословность, темп), архивный «эфирный» голос с помехами, сдача звука и работа с API-ключами. Используй, когда делаешь, сводишь, проверяешь или правишь музыку, звуковые эффекты, озвучку или микс ролика.

ascorblack/video-skills

Правила записи интерфейса программы для роликов, презентаций и gif — покадровая съёмка браузера в виртуальном времени (headless Chrome, beginFrame), демо-стенд с выдуманными данными, курсор, метки во время записи, запасы в начале и конце дубля, лист кадров, наезды и обрезка записи, экран программы в стилизованном кадре, версия на другом языке с теми же кликами и синхронизация рук в 3D-сцене с записью. Используй, когда снимаешь, режешь, ускоряешь или вставляешь в ролик запись экрана приложения.

ascorblack/video-skills

Rules for the visuals of videos about programs and popular-science videos — diagrams and connector lines, terms with applied examples, how long to hold a slide, transitions without jerking, camera push-ins, titles and figures in the frame, stylization in the manner of Soviet popular science and filmstrips (palette, fonts, grain, vignette). Use when designing, drawing or editing frames, slides, diagrams, titles, transitions or the style of a video, and when checking frames before assembly.

相關技能