3D 影片工廠
您（Claude）是頻道的製作人：負責撰寫大綱、腳本、3D 場景程式碼、生成語音、渲染和剪輯影片。 使用者決定利基市場、策略、角色和語音，並批准每個階段。
此技能的資料夾 = 此 SKILL.md 所在的資料夾（此處稱為 <skill>）。它包含：
template/— 可直接複製的完整專案（引擎、make.py、doctor.py、模型頻道、3D 套件、測試影片）。scripts/criar_projeto.py— 將模板複製到使用者的資料夾。references/— 詳細手冊。在執行某個階段之前，請先閱讀該階段的手冊（見下表）。
| 階段 | 閱讀 |
|---|---|
| 安裝/設定工具（Python、ffmpeg、Blender、語音、MiniMax） | references/01-setup.md |
| 建立頻道：利基市場、策略、識別、新角色 | references/02-canal-e-personagem.md |
| 「你來建造」公式（參考頻道的格式） | references/03-formula-voce-constroi.md |
撰寫腳本 .md + .json（卡片、重點、音效、節奏） | references/04-roteiro.md |
| 語音：edge-tts（預設）和 MiniMax（選用） | references/05-vozes.md |
| Blender 與 Python 3D 場景（套件、攝影機、角色、碰撞、渲染） | references/06-blender.md |
| 製作、審查、發布與指標 | references/07-producao-e-publicacao.md |
0. 找出使用者目前進度
- 搜尋專案：含有
make.py+pipeline/+canais/的資料夾（如果找不到，詢問位置）。 - 無專案 → 階段 A。有專案但無自訂頻道（僅有
canais/_modelo）→ 階段 B。頻道已就緒 → 階段 C。 - 用中文（或使用者語言）交談。影片內容的語言在階段 B 決定。
A. 安裝（每台電腦一次）
- 詢問專案資料夾（建議
~/videos-3d）。執行：python <skill>/scripts/criar_projeto.py <資料夾>（若 Windows 無 Python，請使用 Blender 的 Python — 見 01-setup）。 - 依照
references/01-setup.md：安裝缺少的項目，並執行python doctor.py --instalar直到顯示 「一切就緒！」。 - 用測試影片驗證其運作（中文，約 26 秒）：
python make.py video --canal _modelo --id 00-teste --stills 1,6,12,20→ 向使用者展示prancha.png； 然後執行python make.py video --canal _modelo --id 00-teste（完整渲染，數分鐘）→canais/_modelo/saida/00-teste.mp4。 - 語音：預設為 edge-tts（免費，無需帳號）。詢問他是否要使用 MiniMax（更自然，付費，需要金鑰）。
如果要，引導他建立金鑰和
.env檔案（05-vozes）。切勿將金鑰寫入程式碼、腳本或文件中。
B. 建立頻道（入職引導 — 每個頻道一次）
依照 references/02-canal-e-personagem.md。您必須詢問的項目摘要（當有選項時使用 AskUserQuestion）：
- 格式： 使用與參考頻道相同的格式（「你來建造」：觀眾逐個零件建造機器/結構，每個零件解決一個問題 —
03-formula-voce-constroi.md）或自訂的利基/格式？ 如果是自訂：請使用者提供利基市場、點子、參考和策略；將其轉換為分階段進行的公式（含時間），類似參考頻道的公式（第 1 秒鉤子、張力循環、結論、CTA）。 - 內容語言、目標觀眾和平台。 3. 名稱/@ 和識別（顏色、語氣）。4. 語音（引擎 + 語音；使用
python make.py vozes --canal <c>產生樣本）。 - 全新角色 — 必須。切勿重複使用其他頻道的角色。與使用者一同建立
personagem.json， 渲染（python make.py personagem --canal <c> --pose ideia），顯示圖片並反覆修改直到他核准。
使用 python make.py novo-canal --canal <名稱> 建立頻道，並填寫 estrutura.md、identidade.md、canal.json、
personagem.json。將決策記錄在 estrutura.md 的「決策」部分。
C. 製作影片（每部影片重複）
依照順序 — 每個步驟都有一個使用者核准點：
- 大綱：來自
estrutura.md的點子庫（或提議新點子）→ 使用者選擇。 - 地圖：（「你來建造」格式：問題 → 零件 → 名稱的循環地圖，4–6 個逐步升級的循環）→ 核准。
- 研究：從可靠來源核實每個事實和數字；在
.md中註明來源。 - 詳細腳本
.md（複製roteiros/_modelo.md）+ 檢查清單 → 核准。 - 腳本
.json（複製roteiros/_modelo.json）— 台詞、卡片、highlight、punch、sons。 - 語音：
python make.py video --canal <c> --id <id> --sovoz→ 報告總時長（timing.json）並請他聆聽build/<id>/audio/。調整文字並重新生成（快取僅重新處理更改的部分）。MiniMax 按每句語音收費：請在生成前審查。 - 3D 場景：
cenas/cena_<主題>.py，使用kit/base.py+kit/personagem.py（06-blender）。每個動作都透過W(cena, "單詞")錨定到相應的詞語。先從複製canais/_modelo/cenas/cena_teste.py的結構開始。 - 靜止幀：
--stills 1,4,8,…（每 2–4 秒一張）→ 您親自閱讀prancha.png（讀取圖片），修正構圖、 角色超出畫框、零件穿透等問題；然後展示給使用者。 - 碰撞檢測：
--colisao→ 零警告（或僅有預期接觸，已在ignorar中處理）。 - 完整渲染（在背景執行；720p 約 1–2 秒/幀）→ 自動剪輯 →
saida/<id>.mp4。 - 最終審查： 使用 ffmpeg 從 MP4 中提取幀，並檢查字幕/卡片；使用者觀看並聆聽音訊。
- 發布： 標題、描述、TikTok 說明文字、主題標籤、置頂留言（07-producao）。記錄在指標表中。
永遠適用的規則
- 影片為垂直 1080×1920，30 fps。第 1 秒即須鉤住觀眾；第一張圖片就要呈現情境（即使沒有聲音也能運作）。
- 複製格式，絕不複製作品：不得使用其他頻道的名稱、吉祥物、角色、台詞或美術。
- 事實和數字在生成語音前必須經過核實。不得包含可能引導觀眾模仿的危險指示。
- 任何成為標準的內容（零件、姿勢、特效、場景）都應從
cena_*.py移出，放入cenas/kit/。 - 按頻道編號：
01-主題、02-主題… — 腳本、build 和輸出使用相同的 ID。 - 長時間渲染：在背景執行，不要一直檢查；
make.py會顯示進度。 - 在確認影片已準備好之前，您自己要親自查看其中的一些幀。