Communitygithub.com

畫面(分鏡)

為剪好的口播配上畫面:在錄製屏幕上疊加 HTML 層(圈重點標註、小黑整屏動畫、推近),層綁定字幕,由播放器逐幀驅動,直接在預覽中查看。用戶在需要做分鏡、配畫面、加動畫、圈重點、B-roll 或製作 storyboard 時使用。

畫面(分鏡) 是什麼?

這個技能專門為口播影片製作『畫面層』——也就是在錄屏畫面上疊加 HTML 層來做視覺輔助,例如圈重點、整屏動畫或推近效果。它的核心定位是『一次性完成』,用戶什麼時候呼叫它就什麼時候做,剪輯改完後可以回來再做。前提是帳本和字幕必須已經存在,層按照字幕片段擺放,時間從帳本計算。支援的檔案包括 `edit-list.json`、`transcript.json` 和 `subtitles.json`,輸出為 `visuals.json` 及模組目錄中的 `index.html`。 工作流程嚴格分為四步:①依據字幕內容決定任務類型,②抽 8-12 幀實際觀察畫面,③計算運動窗口找出穩定區域,④編寫模組並加到播放器。關鍵判斷規則是:如果畫面已經清楚說明內容就不動,如果畫面弱相關或空白則使用小黑動畫,如果畫面正好對應使用者說的話就做圈註。技能嚴禁跳過抽幀和運動窗口的步驟、禁止目測坐標或儲存秒數,也不允許在沒有真實內容時使用佔位圖。品牌圖示必須使用官方字形,從 simple-icons 取得單色官方字形,確保同一品牌在整條影片中僅有一種樣式。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/2789927464king-jpg/video-skill-ku/tree/HEAD/chengfeng-videocut-skills/plugins/chengfeng-videocut/skills/chengfeng-visual

在你喜歡的 AI 中提問

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

說明文件

畫面(分鏡) 是做什麼的?

這是一件完整的事,不是流程中的一段。 用戶什麼時候呼叫它就什麼時候做,改完剪輯可以回來再做。

前提只有兩個:帳本和字幕已經存在(層按字幕片段擺放,時間從帳本計算)。

需要   edit-list.json、transcript.json、subtitles.json
產生   visuals.json + modules/<序號-名稱>/index.html

做完就停止,不指揮用戶下一步。

先讀取並執行 業務 Skill 的階段合約。 模組寫法的硬性規則見 模組契約, 判斷規則見 畫面判斷。

0. 就緒

先執行 檢查更新 的「就緒檢查」——skills 是否 最新、Runtime 是否配套;插件根也在那裡定位(本文命令裡的 <插件根> 都代入 那個字面路徑)。只有「就緒」才繼續;「需新會話」或「停」則按其處置執行 (含「禁止自製替代界面」禁令),業務 Skill 不自帶環境邏輯。

若就緒結果為 runtime.kind=desktop-managed,直接複用桌面 App 已安裝的穩定 CLI 與 同一 launchd/windows-task 服務;不要解析 Electron 路徑、另外安裝依賴或啟動第二個 Runtime。

命令

node "<插件根>/scripts/ensure-running.cjs" --json
node "<插件根>/scripts/videocut-cli.cjs" visual get   <project> --json
node "<插件根>/scripts/videocut-cli.cjs" visual frame <project> --cues sub-0004,sub-0005 --count 12 --out <dir> --json
node "<插件根>/scripts/videocut-cli.cjs" visual add   <project> --module modules/01-xx/index.html --cues sub-0004,sub-0005 [--zoom x,y,w,h] [--id vis-0001] --json
node "<插件根>/scripts/videocut-cli.cjs" visual remove <project> --id vis-0001 --json

ensure-running 必須先證明 canonical 5190 屬於當前平台的託管服務;失敗就透傳並 停止,不回退到 foreground 或自選端口。

層綁定字幕片段(--cues),產品自己換算成詞 ID——層永遠不可能綁到沒人說的詞, 剪輯變了層自己跟著移動。不儲存秒數。

四步,一步不跳

① 根據文字決定任務    讀 subtitles.json,按語義分段,每段回答:
               教學/示範/證明,還是概念/邏輯/過渡?
② 抽幀看畫面    visual frame 抽 8-12 幀,真的用眼睛看。
               實測 12 段裡有 2 段被畫面推翻文字預判 —— 這步不是走形式
③ 量運動窗口    相鄰幀做像素差,找出滾動/切換/操作的時刻。
               層只蓋穩定窗口,圈在畫面開始動之前退場
④ 做層放層     寫模組 → visual add → 在預覽中逐層核對

② 的判斷規則

畫面正是他說的東西     → 標註:圈住、說到哪個詞圈哪裡。真證據不許蓋
畫面弱相關/空白       → 小黑動畫:整屏白底,從風格庫製作
畫面自身足夠清楚      → 不動。這是最常見的正確答案(實測 13 段裡 4 段不動)

③ 的產出物是數字,不是感覺

圈的坐標      像素統計量出來(灰階掃描找文字行),不許目測 —— 目測誤差超過 50px
互動時刻      逐幀像素差找突變(實測一次從 4 跳到 335),圈在它之前 0.2s 退完
穩定窗口      開頭常有滾動(他在找內容),層從停穩那幀的 cue 開始綁

推近(zoom)用之前先想

預設不推近。   960x720 的錄屏放大就糊,用戶會立刻看出來
非推不可時     ≤1.6 倍、區域取 62.5% 見方居中 —— 構圖完整 > 讀清小字
字太小讀不清   用圈引導視線就夠了;真要讀清,答案是高解析度重錄,不是放大

審閱循環

模組目錄用序號命名(01-daily-report、05-anim-task-split), 時間線軌道上顯示目錄名,用戶報號你改那一層,別的不動。

兩條改層紀律,各對應一次真實事故:

改層必查模組     層收窄/延長後,模組裡寫死的相對時刻不會跟著變 ——
                圈的出場時刻可能落到層結束之後,永遠不出現
驗收看像素       截圖看畫面,不查 DOM 屬性。「可見性翻轉正確」的 iframe
                曾經物理上不在畫面裡 —— 屬性全對、螢幕全空

不許做什麼

  • 不許跳過抽幀和運動窗口直接做(兩種錯各犯過一次:蓋掉真證據、圈懸在滾動上)
  • 不許把每段都做點什麼——鋪滿不是目標,不動是常見答案
  • 不許儲存秒數、不許目測坐標、不許在白底頁面上加壓暗
  • 沒有真實內容不許拿佔位圖充數
  • 風格從註冊表選擇,不得憑空發明
  • 品牌圖示用官方字形,不許手動畫替代(X 曾用兩筆交叉線畫過,被用戶抓到)。 本地索引沒有的,從 simple-icons 取單色官方字形(黑白風格正好搭配), 原 svg 存進模組目錄備查;同一條片裡同一品牌只能長一個樣

Individual skills in this repo

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

2789927464king-jpg/video-skill-ku

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。

2789927464king-jpg/video-skill-ku

剪辑中文口播原素材:逐词转录、词典修字出修字表、五轮扫描找口误与重复、汇总表与重复句子表、打开 Studio 让用户复核、复盘沉淀用户偏好与词典。只产出一份已复核的删词账本,不切媒体、不做字幕、不做分镜动画。用户说剪口播、处理口误、生成口播基础素材、继续剪口播,或确认卡回传 action=return_cut_review 时使用。不要用于执行物理剪切、导出剪后视频、单独安装、单独打开工作台或口播分镜成片。

2789927464king-jpg/video-skill-ku

把剪好的口播烧成一个成片文件:账本切片段、推近、字幕、HTML 画面层,一次全部烧进 mp4。用户说导出、出成片、烧字幕、渲染、导出视频、生成最终文件时使用。不要用于生成删词候选、写字幕、做画面动画。

2789927464king-jpg/video-skill-ku

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者,或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。

2789927464king-jpg/video-skill-ku

给剪好的口播做字幕:直接用已有的逐词稿加账本算出剪后时间(不必导出、不必重新转录)、用词典和作者文稿改写听错的专名、按句子分屏、在 Studio 里逐屏复核。用户说做字幕、加字幕、改字幕、重新分屏、字幕不对时使用。不要用于删词剪辑、物理剪切、分镜动画或成片渲染。

2789927464king-jpg/video-skill-ku

操作 chengfeng-videocut 剪辑工作台的已有工程,通过 Runtime CLI 查工程与词句位置、添加或替换画面覆盖层、移除画面、删除明确指定的词句或片段、拆分裁剪移动已有片段、调整画布比例并回读核验。用户说插入片段、删掉这句、移除动画、换个画面、调整顺序或管理时间线时使用;先区分画面覆盖与主轨顺延插入,不负责自动判断口误、创作动画、制作字幕、导出或排查安装故障。

2789927464king-jpg/video-skill-ku

Create Ian Xiaohei-style HTML/SVG motion illustrations for Chinese articles, scripts, storyboard scenes, workflow explanations, concept metaphors, and short video visual aids. Use when the user asks for 小黑 SVG、漫画感 HTML、分层 SVG 动效、把小黑生图做成 HTML/SVG、可编辑矢量动效、口播流程动画、手绘漫画动效、正文配图动画, or wants a Xiaohei illustration style adapted into controllable HTML/SVG/GSAP output instead of raster image generation.

2789927464king-jpg/video-skill-ku

剪映 (JianYing) AI自动化剪辑的高级封装 API (JyWrapper),提供开箱即用的 Python 接口,支持录屏、素材导入、字幕生成、Web 动效合成及项目导出。全面适配 MacOS (Apple Silicon/Intel) 与 Windows,支持 v5.9+ (draft_info.json) 架构、工程自修复、智能配音字幕及录屏变焦。

相關技能