幫我設定
用戶是第一次打開實驗室。他們不具備技術背景。到最後,他們會完成所有安裝、在自己臉上看到並選擇喜歡的風格,並儲存好自己的套件。然後他們就準備好製作第一部 Reels 了。
語氣:溫暖、簡潔、一步一步來。在等待時告訴他們正在發生什麼事。絕不直接貼上原始工具輸出。絕不要求他們執行指令,除了步驟 1 中可能缺少的 Homebrew 那一行。
從一則簡短的訊息開始:
歡迎來到 Reels 剪輯實驗室。設定大約需要 10 分鐘:我會安裝一些東西、問你 3 個簡單問題,然後你就可以在自己的影片上挑選喜歡的風格。我們開始吧。
1. 安裝 (≈5 分鐘,大部分時間在等語音模型下載)
執行 python3 tools/doctor.py。它會印出一個檢查清單和 DOCTOR=ok 或 DOCTOR=missing:<names>。按以下順序修正缺失的項目,最後再重新執行一次醫生腳本:
- mac / space: 如果任一項失敗,先停下來並親切地解釋原因(需要 Apple 晶片 Mac;約需 6 GB 可用空間)。
- homebrew: 你不能幫他們安裝,因為它需要他們的 Mac 密碼並在真正終端機中執行。用一句話解釋原因,然後給他們醫生腳本提供的確切安裝指令,告訴他們打開 Terminal app(Cmd+空白鍵,輸入 Terminal),貼上指令,按 Enter,輸入他們的 Mac 密碼(輸入時不會顯示任何內容,這是正常的)並按照提示操作。最後 Homebrew 會印出兩行以
echo和eval開頭的「下一步」指示;請他們也貼上這兩行。等他們說完成後,重新檢查。 - apple-tools: 執行
xcode-select --install。會跳出一個 Mac 視窗;告訴他們點擊 安裝,並在完成時告知你(約幾分鐘)。Homebrew 通常會自動安裝這些,所以先檢查一下。 - ffmpeg:
brew install ffmpeg(如果brew還不在路徑中,請使用/opt/homebrew/bin/brew)。 - uv:
curl -LsSf https://astral.sh/uv/install.sh | sh,如果uv還找不到,則使用~/.local/bin/uv。 - python-tools:
uv sync - renderer:
uv run playwright install chromium - speech-model: 在背景執行
uv run tools/get_models.py(2.3 GB)。如果連線中斷,它會自動恢復。開始下載後,就可以進行訪談。在步驟 3 需要使用它之前回來檢查狀態。
在安裝過程中,用一句話告訴他們每個工具的用途(醫生腳本的描述已為此設計)。
2. 品牌訪談(3 個問題,一次問一個)
以對話方式提問,一次一個訊息。保留他們的確切用詞。
不要詢問名稱、標語或「你做什麼」的標籤:實驗室預設不會加上這些(請參閱 new-reel 技能的「label」)。
- 能量。 「你在鏡頭前是怎樣的:冷靜且深思熟慮、溫暖健談、還是高能量?」這會設定剪輯的活潑程度(請參閱步驟 4 中的表格)。
- 品牌。 「你有品牌或設計檔案、品牌色或字型嗎?把你的設計檔(一個 .md 或 PDF)丟進來,我會用它打造你的風格。或者貼上色碼,或者把 3-6 張你喜歡的 Reels 風格截圖放到
inspiration資料夾。或者直接說『不用了,給我看選項』。」 - 絕對不要。 「你絕對不希望在你的 Reels 上出現什麼?例如全大寫文字、特定表情符號、音效、或是你絕對不會說的話。」
將答案儲存到 brand/profile.md:
# 個人檔案
- 能量: 溫暖健談
- 品牌: 顏色 #… / 字型 … / inspiration/ 中的截圖 / 無
- 絕對不要: …
同時將每個「絕對不要」的項目作為一行規則加入 brand/preferences.md。
3. 在自己臉上看到風格
詢問:「現在請放入任何一段你對著鏡頭說話的影片片段,最好 20 秒或更長。將它拖曳到這個對話或 inbox 資料夾中。不一定要是好的鏡頭;只是用來試試風格。」
當影片片段放進來後(且語音模型已完成):
-
uv run tools/transcribe.py "<影片片段>" --name welcome-sample -
讀取
projects/welcome-sample/lines.md。使用 new-reel 的粗剪規則(取最後一個乾淨的 take,不要有 false starts),寫入包含前 3-5 行乾淨台詞、約 12-20 秒 的cut.json。執行uv run tools/roughcut.py projects/welcome-sample --no-open和uv run tools/verify.py projects/welcome-sample,並修正任何它標記的問題。不要請他們審閱這個剪輯;它只是一個樣本。 -
像 new-reel 技能一樣編寫
build.json:用hooks技能根據他們實際說的話寫一個鉤子(這是他們對實驗室的第一印象,所以要寫得好),1-2 個重點詞彙、1 個縮放、以及對最強台詞的一句陳述。用visuals技能加入 2-4 個彈出視窗(例如他們提到的列表用晶片,或者如果他們談到提示詞就用聊天視窗),讓他們看看實驗室的實際功能。不要加入「behind」時刻。 -
風格對照表:
uv run tools/build.py projects/welcome-sample --looks presets。它會開啟一張圖片,將他們的影片片段以每種風格並排顯示,順序與LOOKS=之後印出的相同。先自己查看圖片(讀取它)並檢查文字是否可讀且沒有遮住臉部。 -
按照印出的順序,用每個套件的
description(來自packs/<名稱>/kit.json)以一句話簡短介紹每種風格。 然後清楚說明風格只是一個起點,不是最終選擇:選擇你感覺最喜歡的那個。之後所有東西都可以更改:「這個風格,但要鼠尾草色和奶油色」、「用我的顏色:#…」、「更柔和一點的字型」、「不要粉紅色」。我會在你的影片片段上重新製作,讓你可以看到效果。
詢問他們想看哪個風格的動態版本。
-
對於他們選擇的每個風格:
uv run tools/build.py projects/welcome-sample --kit <名稱> --out sample-<名稱>。它會在 QuickTime 中開啟。如果他們選了兩個,就同時製作兩個並依序開啟。
如果他們在步驟 2 中提供了品牌顏色、字型或截圖,也提供選項:「或者我可以根據你的品牌製作一個風格。」請參閱步驟 5。
4. 儲存他們的套件
當他們做出選擇時(例如「Editorial 風格,但是鼠尾草色和奶油色」或「Playful 風格,但要更冷靜」):
-
將
packs/<預設>/kit.json複製到packs/<他們名字的小寫>/kit.json。在副本中:"name": 他們的名字"preset": false"based_on": "<預設>"
-
套用他們的能量:
能量 intensity 縮放跳躍 / 重擊 sfx volume_db 陳述句 冷靜且深思熟慮 clean 1.04 / 1.08 −17 最多 1 句 溫暖健談 signature 1.07 / 1.13 −13 最多 1-2 句 高能量 full 1.12 / 1.22 −10 最多 2 句 變更
rules.intensity、zoom、sfx.volume_db以及rules.statement的用詞以符合設定。音效組合(
sfx.palette):- calm:
soft - warm:
soft或playful - high-energy:
punchy - 科技或 AI 主題:考慮使用
clicky
告知一次他們可以在
sfx/sound-menu.mp4中聽到每種音效,並且可以透過要求切換組合(「使用 playful 音效」)。如果他們說過「不要音效」,則設定"sfx": {}。如果他們說過不要全大寫,則將style.caption_case、style.hook_case和style.statement_case設定為"none"。 - calm:
-
套用他們的顏色,無論是來自訪談還是他們提出的要求(「改用這些顏色」):
- 從色碼或純色名稱: 「sage」或「dusty pink」都可以;選擇有品味的十六進位色碼並告訴他們是哪個。
- 交換
colors中的值並保持角色:淺色用於卡片和字幕,深色用於陳述句背景和墨水色,亮色用於強調色和visuals.rotate。 - 檢查對比度: 文字必須在其背景上清晰可讀。
- 為他們的套件重新渲染風格對照表(
--looks <他們的套件>),讓他們在製作完整樣本前先看到效果。 - 字型也一樣: 任何免費的 Google 字型都可以(
fonts.py會確認它是否存在)。
-
將套件的資料夾名稱寫入
brand/kit.txt。 -
用他們的套件再製作一次樣本:
uv run tools/build.py projects/welcome-sample --out sample-mine。它會在 QuickTime 中開啟。詢問:「這是你的風格。有什麼想改的嗎?」將更改套用至他們的套件(而非預設),並重新製作,直到他們滿意為止。小改動如「字幕小一點」、「黃色少一點」或「不要傾斜」都只需要在kit.json中修改一行。
5. 根據他們的品牌製作風格(當被要求時)
來自設計檔案(最佳方式)
如果他們有品牌或設計文件(一個 .md、PDF 或 Google 文件匯出檔,例如 BRAND-DESIGN.md):
-
取得檔案。 要求他們將檔案拖曳到對話中或放入
brand/,然後儲存一份副本為brand/design.md(或保留 PDF)作為他們風格的唯一真實來源。 -
將其對應到他們的套件:
在設計檔案中 在 kit.json中調色盤(十六進位色碼及其用途) colors,加上roles:背景 →hook_card和label_bg;文字顏色 →ink和hook_text;「陳述句」或深色區塊 →statement_bg;強調色 →highlight_blocks;重點色 →accent_pill、visuals.rotate「絕不使用純黑或純白」這類規則 使用他們最深的品牌色作為 ink 標題和展示字型 fonts.display/poster,其斜體作為fonts.italic,用一個無襯線字體作為label和字幕招牌動作(斜體混搭、文字後方的強調區塊、傾斜、貼紙、全大寫) moves和style(hook_case、statement_case、radius)情緒(「冷靜」、「活潑」、「奢華」) visuals.motion、visuals.density、sfx.palette照片或影片風格(溫暖、陰鬱、明亮、底片感) grade:contrast、saturation、brightness、warmth(−0.05 到 0.05)、vignette(0-0.5)、legibility(文字後方深色漸層,0-0.5)。保持膚色自然:不要使用底片顆粒,不要重度壓縮。圖示、圖形元素、貼紙、按鈕(線條粗細、圓角或直角、填滿色塊) visuals.icon_stroke(細 1.5 → 粗 2.5)、visuals.radius、visuals.card(實心 / 輪廓 / 玻璃)、visuals.accent(圖示色塊顏色)、visuals.rotate(晶片和貼紙顏色) -
付費或自訂字型: 尋找字型檔案。如果他們有,就放入
fonts/private/,然後套件使用"file"。如果沒有,則選擇最接近的免費 Google 字型:比對對比度、寬度(高瘦或壓縮?)以及是否有斜體。告知他們你用了哪個替代字型以及原因。例如,「你的付費襯線字體 → Instrument Serif:同樣高挑、高對比感,有斜體。」 -
展示它: 渲染
--looks <他們的套件>並製作sample-mine。說明哪些部分直接來自他們的檔案,哪些是你詮釋的。 -
保持同步: 如果他們之後更新了設計檔案(「我改了品牌顏色」),重新讀取
brand/design.md並以同樣方式更新套件。
來自截圖或貼上的色碼
當他們想要自己的風格而不是預設時:
- 讀取他們放在
inspiration/中的截圖、他們的品牌指南或他們貼上的色碼。注意:- 類型:襯線或無襯線、粗細程度、是否全大寫、是否混用斜體
- 字幕處理方式:輪廓、陰影或方框;整個片語或逐字顯示
- 卡片形狀和圓角半徑
- 4-6 種顏色
- 活潑程度
- 從最接近的預設開始,只修改不同的部分。字型必須是免費的 Google 字型:寫入
{"family": "<Google 字型名稱>", "google": true, "weight": N}(如有斜體則加上"italic": true)。用uv run tools/fonts.py "<family>" --weight N確認每個字型都能下載。如果他們擁有付費字型,可以將檔案放入fonts/private/,並使用{"family": "...", "file": "fonts/private/<檔案>", "weight": N}。 - 不要複製其他創作者的確切字型和顏色。保留感覺,而不是招牌外觀。
- 渲染
--looks <他們的套件>來檢查,然後如步驟 4 一樣製作sample-mine,並在對話中迭代。
6. 完成
用大約 3 行告訴他們:
- 他們的風格已儲存,之後每部 Reels 都會自動使用它
- 如何編輯一部 Reels:將影片片段放入
inbox/或對話中,然後說「編輯這部 Reels」。你會剪輯它,他們可以在對話中審閱台詞,然後你用他們的風格製作 - 彈出式圖形會說明他們說的話;「顯示圖形」可以播放他們風格中所有 14 種圖形的目錄
- 可選附加功能:在對話中放入他們自己的 6 部 Reels 以獲得「圍繞你的 Reels」效果和個人檔案網格(
tools/reels.py add);提供一次他們的真實 Instagram 數據(儲存到brand/instagram.json)以用於追蹤動畫 - 他們可以在任何台詞上要求一個迷因或 GIF(「這裡放 David Rose 的 'ew' 迷因」)。搜尋需要一個免費的 GIPHY 金鑰,你會在第一次時協助他們取得;他們自己的 GIF 檔案則可以立即使用
- 顏色和字型永遠不會鎖定:「改用這些顏色」隨時可用在任何 Reels 上
- 他們可以隨時說出來更改任何東西(「字幕小一點」、「這部不要音效」、「在這部 Reels 上試試 Loud 風格」)
- 完成後的 Reels 會放在 Finished reels 資料夾
- 指令:/new-reel 用於新的影片片段(為每部 Reels 在此資料夾中開啟一個新對話)、/update 用於取得新版本、以及 /report-problem 用於回報問題
然後提供選項:「想把你剛才給我的完整影片片段編輯成你的第一部正式 Reels 嗎?」如果是,就在此對話中對它執行 new-reel 技能。
套件風格開關(用於微調)
kit.json → "style":
caption_outline: 畫素;0 表示只有陰影caption_case: "none" / "uppercase"hook: "card" / "bare"(無卡片,只有輪廓文字)hook_sizehook_casestatement_caselabel: "ticket" / "pill"label_mark: 名稱和主題之間的分隔符號radiusshadow/shadow_soft: rgba 顏色
"captions":
mode: "karaoke