設定 — 讓初學者的電腦準備就緒
學生是初學者。用他們的語言、簡短的句子、一次只做一個步驟。 你自己執行檢查。每項安裝前都要先詢問。絕對不要幫他們輸入密碼。
0. 是否在正確的資料夾?
這個步驟必須在工作室資料夾內執行(它裡面有 CLAUDE.md 和 video-projects/_library/)。
如果你不在正確的位置,請找出該資料夾,或詢問他們將專案 clone 到哪裡,然後 cd 過去。
1. 檢查現有工具
判斷作業系統(Windows / macOS / Linux)並執行以下檢查。不要顯示原始輸出,只要簡短列表。
| 檢查項目 | 指令 | 是否必要 | 一句話說明 |
|---|---|---|---|
| Git | git --version | 是 | 下載這個工作室及其更新 |
| Node.js 22 或更新版 | node --version | 是 | 執行 HyperFrames |
| npm | npm --version | 是 | 隨 Node.js 一起安裝 |
| FFmpeg + FFprobe | ffmpeg -version, ffprobe -version | 是 | 將影格與聲音合併成 MP4 |
| 可用磁碟空間 | (doctor 會顯示) | 約 3 GB | 存放工具與你的影片 |
顯示方式如下:
✓ Git
✗ Node.js — 未安裝(需要:它用來執行 HyperFrames)
✓ FFmpeg
如果所有項目都是 ✓,告知使用者並直接跳到步驟 3。
2. 安裝缺少的項目 — 逐一詢問
針對每個 ✗:用一句話說明那是什麼、是免費的、你推薦安裝,並詢問「我可以安裝它嗎?」。等待使用者回答「好」。
Windows(winget 已內建於 Windows 10/11):
- Node.js:
winget install -e --id OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements - FFmpeg:
winget install -e --id Gyan.FFmpeg --accept-package-agreements --accept-source-agreements - Git:
winget install -e --id Git.Git --accept-package-agreements --accept-source-agreements - 如果 Windows 跳出「是否允許此應用程式變更您的裝置?」對話框,請告訴他們點選是。
- 如果
winget本身不存在:引導他們到 https://nodejs.org(點選 LTS 按鈕)、https://git-scm.com,至於 FFmpeg 則說「請從 Microsoft Store 安裝 App Installer,然後我再試一次」。
macOS(使用 Homebrew):
- 檢查
brew --version。如果缺少,他們必須自行執行安裝程式,因為它會要求輸入 Mac 密碼。告訴他們:開啟終端機應用程式,貼上 https://brew.sh 的指令,按 Enter,輸入他們的 Mac 密碼(輸入時不會顯示字元 — 這是正常的),安裝完成後告訴你。 - 然後執行:
brew install node ffmpeg git
Linux: 這些指令需要使用者密碼,所以請他們在自己的終端機中執行:
sudo apt install -y git ffmpeg。對於 Node.js 22+,建議從 https://nodejs.org 下載 LTS 安裝程式。
安裝任何項目後: 新程式無法立即被這個 Claude 視窗偵測到。告訴他們:「關閉 Claude Code,在同一個資料夾重新開啟,然後輸入 /setup — 我會從這裡繼續。」然後停止並等待。(當他們回來時,步驟 1 會顯示新的 ✓。)
3. 安裝工作室本身的元件
說明每個元件的作用與大約大小,然後依序執行:
npm install— 將 HyperFrames 下載到這個資料夾(約 120 MB,大約一分鐘)。npx hyperframes skills— 教導 Claude 官方的 HyperFrames 規則(很小)。先詢問:它會在這台電腦上為 Claude 安裝技能。npx hyperframes browser ensure— 下載一份專為製作影片使用的私人 Chrome 副本(約 150 MB)。不會影響他們的一般瀏覽器。npx hyperframes doctor— 最終檢查。只說明重要的紅色項目: Node.js、FFmpeg、FFprobe 和 Chrome 必須是 ✓。以下為選用 — 忽略它們:有新版本可用、whisper-cpp(自動字幕)、MusicGen(AI 音樂)、Docker。
執行 npx hyperframes skills 後:新的技能會在新的工作階段中載入。告訴他們:「關閉 Claude Code,在相同資料夾重新開啟,然後輸入 /setup — 我會從測試影片繼續。」
4. 證明一切正常:製作一個 3 秒測試影片
需要網路連線(動畫函式庫從網路載入)。請逐行執行以下指令(在 PowerShell 中,&& 無法使用):
mkdir my-videos
cd my-videos
npx hyperframes init hello-test --example blank --resolution portrait --non-interactive
cd hello-test
空白範例預設為 10 秒並顯示「Title」。在 index.html 中:將文字改成他們的名字或「Hello」,將兩個 data-duration="10" 都改為 3,加入淡入效果(tl.fromTo("#title", { opacity: 0 }, { opacity: 1, duration: 0.6 }, 0);),並在 window.__timelines 那一行之前加上 tl.set({}, {}, 3);。然後執行:
npx hyperframes lint
npx hyperframes render --quality draft
在 my-videos/hello-test/renders/ 找到 MP4 檔案,告訴他們檔案位置,並提議開啟檔案。
如果失敗,請閱讀錯誤訊息、修正問題,然後再試一次。不要把有問題的步驟交給他們。
5. 完成
簡短告訴他們:
- 「設定完成。你的影片會存放在
my-videos資料夾。」 - 「要製作影片,請輸入
/new-video。」 - 「下次請在同一個資料夾中開啟 Claude Code。」告訴他們你使用的完整資料夾路徑,以及如何操作:
- Claude 桌面應用程式: 程式碼(Code)分頁 → 選擇/開啟資料夾 → 選取該資料夾。
- 終端機:
cd "<完整路徑>"然後claude。
- 在 Windows 上,「Documents」可能實際上是在 OneDrive 內(
OneDrive\Documents)。請確認 clone 確實落在哪裡,並給出確切路徑。