Communitygithub.com

浮動書桌縮放 (Floating Desk Zoom)

將真實的應用程式視窗變成漂浮在暖色紙質桌面上的卡片,鏡頭會迅速切入動作、跟隨打字、再流暢滑出,營造高級產品展示影片風格。支援阿拉伯語或英語,9:16 限時動態格式。

浮動書桌縮放 (Floating Desk Zoom) 是什麼?

這個「浮動書桌縮放」(Floating Desk Zoom) 技能專為影片製作專案而設計,能夠將真實的螢幕錄影轉變為有如高級產品展示的影片:應用程式視窗會以卡片形式漂浮在溫暖的紙質桌面上,虛擬鏡頭在關鍵操作點(如打字、切換面板)迅速切入放大,然後緩緩滑出。整個過程完全基於真實的螢幕錄影,不產生任何 AI 生成內容。技能支援 9:16 格式(可輸出 1080×1920),主要用於展示型影片、快速教學或 AI 新聞短片的後製。它能處理來自 OBS 的 2160×3840 錄影並自動裁剪出桌面區域,協助偵測螢幕變化點(打字、捲動等)並建議切入位置。主要工具為 `vid desk` 指令集,包含專案初始化、掃描、建立與判斷等子指令。風格引擎可切換「平靜 (calm)」與「強烈 (punchy)」模式,前者提供柔和滑動與緩慢縮放,後者則更快速、更具動感。輸出前必須通過 lint、snapshot 與 judge 檢查,確保文字清晰、無黑邊、無隱私資料外洩。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bassam1998new-ops/hyperframes-students/tree/HEAD/.claude/skills/style-floating-desk-zoom

在你喜歡的 AI 中提問

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

說明文件

風格:浮動書桌縮放

一種沉穩、高級的產品展示:真實的應用程式視窗像卡片一樣漂浮在柔和的桌面上,鏡頭在發生變化時切入近距離特寫,然後緩慢滑出。完全基於真實的螢幕錄影製作 — 絕不生成內容。 卡片:video-projects/_library/styles/floating-desk-zoom/style.md — 已核准 2026-10-02。

先看外觀(在風格資料夾中):frames/01-wide.png(不在公開儲存庫中) · frames/04-punch-in.png(不在公開儲存庫中) · frames/02-glide-dim.png(不在公開儲存庫中)(還有 frames/03-card.png(不在公開儲存庫中))。

0. 先套用卡片

node tools/vid.mjs style apply floating-desk-zoom <project> [--mode calm|punchy]
node tools/vid.mjs desk help

1. 顏色 = 角色(品牌填滿色碼)

風格 = 品質、結構與動態。暖色紙是參考 — 當品牌有自己的底色時就替換它。

角色在哪裡設定取自 brand/<name>.md
桌面 / 紙張director/desk.json 中的 look.bg(預設 #E9E4DB)底色(淺色品牌);保持柔和與淺色
卡片陰影look.shadow(暖棕色,兩層)從底色染出的陰影,絕不使用純黑色
未使用視窗的變暗look.dim(0.55,0 = 關閉)無 — 灰色,非品牌色
上方的標題 / 字幕你自己的圖層,位於桌面之上text-strong(紙上的墨水),強調色 = 主色,僅一個單字
應用程式本身的顏色負責其餘部分 — 桌面上不需要額外的強調色。

2. 開始建構

  • 工具是 vid desk(tools/vid/desk.mjs):
    node tools/vid.mjs desk init <project> <recording.mp4> [--from s] [--to s]   # 裁切桌面 → assets/screen.mp4 + assets/voice.m4a,掃描,寫入 director/desk.json
    # 編輯 director/desk.json:cards [{id, rect}],shots [{at, card, focus, move:"cut"|"glide", dur, pan}],look {…}
    node tools/vid.mjs desk build <project>                                      # → compositions/floating-desk.html;將印出的 host <div> 貼到 index.html
    
    vid desk scan <video> 會顯示螢幕變化處(打字、面板、捲動)— 在這些地方放置 punch-in。業主錄製的 OBS 檔案是 2160×3840,桌面位於中間帶狀區域;init 會將其裁切出來。
  • 自備相機變體(更多控制的紙質外觀):先前專案(非公開)+ build_cut_hd.py(全解析度二次裁切,使 punch-in 保持銳利)。
  • 佈局 9:16(1080×1920): 寬卡片約佔寬度的 90%,垂直置中於 y 900。被選中的卡片保持全寬,但內部範圍為 y 420–1240,以便踢腳文字和字幕放在紙張上。當卡片為全寬時,文字應避開 y 330–1470 的區域。
  • 佈局 16:9: 尚未建置。
  • 鏡頭(動作記號): 切入(硬切,最大 1.6 倍輸出像素/來源像素)→ 以 2.5% 線性推進(#fd-drift)並可選隨打字方向平移(sine.inOut)→ 以 1.2–1.4 秒 power3.inOut 滑出 → 橫向滑動到下一個視窗。每 3–6 秒移動一次,兩次移動之間間隔不少於 1.5 秒。
  • 絕不讓 <video> 本身產生動畫 — 只有 #fd-cam(移動/縮放)和 #fd-drift(推進)。
  • 文字: 內建無文字。標題、字幕和計數位於桌面上方的獨立圖層(阿拉伯文:IBM Plex Sans Arabic,紙上的墨水)。
  • 轉場: 僅有鏡頭移動;無擦拭、無閃爍。
  • 模式: calm = 如同 vid desk 預設建置(drift 2.5%,glides 1.2–1.4 秒,無音效)· punchy(未測試)= glides 0.7 秒 expo.inOut,drift 4%,punch-in 時有滴答聲。
  • 音效: 人聲 −14 LUFS,來自 _library/assets/music(不在公開儲存庫中) 的柔和背景音樂,約 −23 LUFS,並做側壓縮。滑動時可選加入柔和嗖聲(_library/assets/sfx/el/whoosh-slow.mp3(不在公開儲存庫中))。絕不生成音樂。

3. 業主檢視前的檢查事項

  1. 在專案內執行 npx hyperframes lint — 0 個錯誤(duplicate_media_discovery_risk 警告若有多張卡片則無害)。
  2. npx hyperframes snapshot --at <每個鏡頭時間> — 閱讀每一幀:文字清晰,瀏覽器下方無黑色條帶。
  3. npx hyperframes render --quality draft → node tools/vid.mjs judge <draft.mp4> → 閱讀 sheet.jpg 和 safe-sheet.jpg。
  4. 安全區 x 60–960,y 220–1500 · 阿拉伯文字幕需連寫、由右至左,絕不逐字母拆分,<html> 上不要有 dir="rtl"。
  5. 風格檢查:desk build 會列出已達最大縮放值的鏡頭 — 修正它們;檢查每一個 punch-in 是否有隱私資料(金鑰、電子郵件、客戶名稱)並模糊或剪掉;螢幕上顯示紙張後,字幕切換為墨水色。

應做 / 不應做

  • 應做: 要求錄影時使用大應用程式字型(125–150%)並在步驟之間留 1–2 秒停頓;在他提到的確切詞語上 punch in(型號標籤、價格通知、提示語);在淺色 UI 上使用墨水色輪廓,深色 UI 上使用紙張色輪廓。
  • 不應做: 在並排比較中使視窗變暗(業主說:「取消變暗」);放大超過 1.6 倍;在少於 1.5 秒內堆疊移動;保留螢幕已顯示重複資訊的標籤;顯示隱私資料。

工作完成後:node tools/vid.mjs style comment floating-desk-zoom "<什麼有效或無效>"。

Individual skills in this repo

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

bassam1998new-ops/hyperframes-students

Make a new video with a beginner, start to finish — a few easy questions, pick a look from this repo's styles, build it with HyperFrames, check the frames, render and show it. Use when the student says "new video", "make a video", "اعمل فيديو", "عايز فيديو", "reel", "animation", or asks how to start a video. Hands the technical HyperFrames rules to the official hyperframes skills.

bassam1998new-ops/hyperframes-students

First-time setup for the HyperFrames student studio. Checks the computer (Git, Node.js, FFmpeg, the render browser), explains in plain words what is missing, recommends what to install, asks before installing anything, then makes a 3-second test video to prove it all works. Use when the student says "setup", "install", "اعمل setup", "نزّل البرامج", "it doesn't work", "command not found", when node_modules is missing, or when `npx hyperframes doctor` shows a red item. Safe to run again any time — it skips what is already done.

bassam1998new-ops/hyperframes-students

Build a video in the Amber Grid Newsroom look (style card amber-grid-newsroom) — a hot "breaking news" desk: near-black grid field, the real screen recording in a framed window with instant reframes, an English title over an Arabic title line, and karaoke captions where the spoken word turns hot. Use when the director picked this card, or the owner says "make it in the amber newsroom style", "news desk", "breaking news look", "زي ريل opus 5.5", "ستايل الأخبار", or the video is AI news or a build show-off cut from his OBS screen recording with an Egyptian Arabic voice-over. 9:16 reels. Not for lecture clips or direct offers.

bassam1998new-ops/hyperframes-students

Build a video in the Cream Caret Type look (style card cream-caret-type) — Arabic words typed with a coloured caret on a flat two-colour page (night and paper that swap on hard cuts), select-highlight → delete → retype, a flat profile silhouette, one coloured dot that match-cuts into a flat vector eye, a zoom-through the iris, a fixed noun with a bold verb swapping every 16 frames, a pixel-art icon on the sign-off and a monogram end card — one sound per event, silence between. Use when the director picked this card, or the owner says "the typing intro", "caret type", "cream caret", "زي فيديو الكتابة", "الكلام اللي بيتكتب", "intro بالكتابة", or the video is a channel / "who am I" intro, a course or service intro hook, a short opener before a talking head, a word-play promise line or a bumper. 9:16 only, Arabic-first. Not for talking heads the whole time, screen-recording proof, data-heavy explainers or full spoken subtitles. DRAFT — untested.

bassam1998new-ops/hyperframes-students

Build a video in the Hatch Cosmos look (style card hatch-cosmos) — a hand-drawn pencil-hatched world on one canvas, a block mascot (or a pair) that walks, looks, blinks and does ^ ^ eyes, a dive through its eye into a hatched galaxy of nebula blobs, tilted rings and needle stars. Use when the director picked this card, or the owner says "hatched", "hatch cosmos", "pencil cosmos", "the galaxy video style", "the mascot dive", "زي فيديو المجرة", "الستايل المرسوم بالقلم", "الكائن اللي بيدخل في عينه", or the video is a music-led show-off/teaser, a concept intro with a mascot, a "journey inside" beat or a channel bumper. 9:16 and 16:9 both built. Not for talking heads, real screen-recording proof, data-heavy explainers or photographic looks.

bassam1998new-ops/hyperframes-students

Build a video in the Horizon Prompt One-shot look (style card horizon-prompt-oneshot) — one continuous camera on a near-black stage lit by a soft planet-horizon glow; a glass app bar, a cursor and a prompt box morph into each other, a prompt is typed, the send button grows into a tile that blooms into a full-frame result, then a light wipe to a logo end card, every beat hit-synced to a UI sound. Use when the director picked this card, or the owner says "horizon prompt", "the prompt one-shot", "the ChatGPT-style promo", "زي فيديو البرومبت", "الكيرسر اللي بيكتب البرومبت", or the video is an AI tool show-off / prompt-to-result demo, a course or service promo opener, a launch teaser or a channel bumper. Not for talking heads, real screen-recording proof, data-heavy explainers or long tutorials. DRAFT — untested.

bassam1998new-ops/hyperframes-students

Remix 2+ existing style cards of the Hyperframes video workspace into one NEW draft style card, layer by layer (palette roles, type, texture, grade, camera, light, edit rhythm, transitions, motion, sound, prompt parts), then let the owner pick the skills for the video and start the director. Use when the owner says "hybrid style", "remix styles", "mix two styles", "combine styles", "اعمل هايبرد", "ادمج الستايلين", or ticks cards and presses "Remix these" on the Styles board.

bassam1998new-ops/hyperframes-students

Build a video in the Midnight Kinetic Type look (style card midnight-kinetic-type) — clean motion type on a flat dark field, word-by-word mask rises, one accent word that lands alone, icon strokes that draw on, and hard cuts on the music's beat grid. Use when the director picked this card, or the owner says "make it in the kinetic type style", "midnight type", "like an earlier project", "تايبوجرافي متحركة", or the video is a direct offer, proof / results reel or AI news told with type, music and SFX (no face, no footage). Arabic (Cairo, per-word) and English (Inter) versions; 9:16 reels. Not for lecture clips or quick tutorials.

bassam1998new-ops/hyperframes-students

Build a video in the Midnight Screen Desk look (style card midnight-screen-desk) — a calm, organised news desk in three fixed zones: an Arabic info card on top, the real screen recording in a glowing band with punch-ins in the middle, and word-by-word captions (dim → bright) below. Use when the director picked this card, or the owner says "make it in the screen desk style", "three zones", "like the AI releases reel", "كارت فوق والشاشة في النص", or the video is AI news, a build show-off or a quick tutorial cut from his screen recording with an Egyptian Arabic voice-over. 9:16 reels. Not for lecture clips or direct offers.

bassam1998new-ops/hyperframes-students

Build a video in the Mint Lecture Room look (style card mint-lecture-room) — a calm classroom cut of a real lesson: one long take with slow zooms that follow the point, a topic lower third, a quiz card that asks, counts down think-time and then answers, and karaoke captions that light the current word. Use when the director picked this card, or the owner says "make it in the lecture room style", "lecture clip", "course cut", "quiz card", "قص من المحاضرة", "سؤال وجواب", or the video is a lecture clip or quick tutorial cut from his AI course recordings (Egyptian Arabic). 9:16 reels. Not for AI news or direct offers.

bassam1998new-ops/hyperframes-students

Build a video in the Neon Node Explainer look (style card neon-node-explainer) — a plain stage, one headline per spoken sentence, and one small glowing diagram (tiles, lines, packets, checks, terminal, tool list) that builds itself part by part. Use when the director picked this card, or the owner says "make it in the neon node style", "node explainer", "API vs MCP style", "اعمله زي فيديو الـ MCP", or the video is an AI explainer, concept explainer, quick tutorial or AI news with a voice-over and no face. Arabic headlines + English mono labels; 9:16 and 16:9 both built. Not for talking heads, warm stories, real screen-recording demos or music-only hype reels.

bassam1998new-ops/hyperframes-students

Build a video in the Swiss Motion Reel look (style card swiss-motion-reel) — a Swiss-grid "instrument panel" with a constant thin HUD, flat 2-colour blocks, word slams, shape match-cuts and hard cuts on a 128 BPM beat. Use when the director picked this card, or the owner says "make it in the Swiss style", "motion reel", "like the motion designer reel", "HUD reel", "ستايل سويسري", or the video is a brand sizzle, product intro, "what we do" reel, launch teaser or any no-person, graphics-only, music-led video. Latin display type with Arabic in a clean geometric sans; built and tested in 16:9, 9:16 still to build. Not for talking heads, screen-recording tutorials or long voice-led explainers.

bassam1998new-ops/hyperframes-students

Build a video in the Warm Glass Face-cam look (style card warm-glass-facecam) — the presenter talks to camera while frosted-glass panels with one warm glow land exactly where he points; blur-punch text, a karaoke pill, small charts, and a shrink into a rounded picture-in-picture for the demo part. Use when the director picked this card, or the owner says "make it in the warm glass style", "glass panels over my face", "face-cam with glass cards", "PiP intro", "كروت زجاج وأنا بتكلم", or the video is a build show-off or quick tutorial with the owner on camera. Source is English 16:9; the 9:16 and Arabic versions still have to be built at the first job. Not for lecture clips or AI news.

bassam1998new-ops/hyperframes-students

Build a video in the <Style name> look (style card <slug>). Use when the director picked this style card, when the owner says "make it in the <Style name> style", "<slug>", "استايل <Style name>", or the video type is <video types from use_when>. Works for Arabic (Egyptian) and English, 9:16 reels<, and 16:9 if supported>. Not for <avoid_when>.

相關技能