【工序｜銷售片產線】
2026-10-18 交接卡補錄｜SALES_PIPELINE_備份_20261018.md
#### 【有效技巧】
- 組裝 mux 必須
-map 0:v:0 -map 1:a:0：B-roll 素材自帶 2kb/s 近靜音音軌，ffmpeg 預設 map 會選素材音訊、丟棄旁白（v12/v13 旁白從未進成片，assemble_v14 起修）。 - 量測抽幀用 output seek（
-ss 放 -i 後）：input seek 對 setpts 後成品取到 keyframe 假幀；避開 xfade 混合區（段 i 起點＝Σ(段長-0.15)）。 - 必須逐鏡量測對齊，勿用 5 鏡平均標的（範例各鏡亮度 114-242、飽和 8-72 兩極）。
- 口型同步唯一保證＝H3 源音（與 setpts 畫面同節奏）＋Seed-VC 轉音色；UI 鏡用 vc_raw 小晴；全片 RMS 歸一 0.14。
- 真人段色彩差異靠 H3 重生成＋提示詞（「steady warm coral pink tone, no blue/cyan/purple」），eq/hue 調不動內容。
- 調 bri 後必須重調 sat（bri 降讓暗部顯色 S 增，v111→v112 鏡6）。
- zoompan 要
-loop 1＋d=總幀數；wav 容器不能裝 h264（混音只出音訊、燒字幕時才合併）。 - UI 飽和用內容級（關鍵幀源頭 PIL HSV S 通道 ×1.15），非濾鏡級（組裝層 eq=saturation 被 clip 吃掉無效）。
- seed 一經收斂勿換（換 seed 表演略優但色彩整組偏離，需 2-3 輪重收斂）。
#### 【踩坑／避開的錯誤】
- Seed-VC 轉換破壞語音：有聲比 48-73%→26-38%、RMS 0.14→0.05；v1 參數（steps/cfg）無效（三組全 27-28%）；v2（inference_v2.py）有 --intelligibility-cfg-rate/--similarity-cfg-rate 待測（需 pip install hydra-core）。
- mk 腳本替換字串一律用 raw 字串：
\workspace 的 \v 被 Python 解析成垂直製表符 → replace 靜默失效（v90-93 素材修正從未進成品）；改完 W =／hd = 行必回查。 - 真人段 hue 旋轉大多無效（鏡2 -6 生效、鏡3 -8 幾乎無效、鏡8 hue 0/-2/-8 皆無效）；多色 wrap 抵消。
- 死路勿重試：LatentSync 在 AI 生成臉有面具偽影；Fish Speech 整合包 venv torch DLL 被 Windows 原則封鎖；Seed-VC 自有 venv 同（改用 ComfyUI venv）；即夢點數已過期。
- H3 對嘴模式會自烤「亂碼文字/字幕」到畫面→H3 prompt 加「禁止任何文字」重生成，勿用 drawbox 黑條遮（黑條過大＝畫面切成兩段被用戶否決）。
- UI 色相環大旋轉（ffmpeg hue/PIL/colorsys float）對多色 UI 素材全漂移不可控（色相環 wrap 中位數跳變）→ 死路；UI 偏黃（+5~13）為插畫本色接受。
- 成片只 25s＝UI 動態段 < 段長（xfade drop）→ 動態段必須 3.2s 覆蓋最長 2.91s。
- PowerShell 行覆蓋改 veq 分支易括號數錯/丟 append/尾行缺閉 → 改完必 py_compile；Replace 尾括號數不符靜默不生效。
- ffmpeg 單幀輸出需
-update 1（否則 image2 warning 但 exit 1）；& $py -c "多行" 的 -c 被當 lex token → 用 .py 檔。
2026-10-18 交接卡補錄｜START_HERE_備份_20261018.md（§十 CAPLock）
#### 【有效技巧】
- 首幀強錨點：單一 cap_girl 美女圖＋產品圖 cap_hat 當 H3 首幀錨點，5 鏡一路繼承啦啦隊服＋黑帽＋透明袋。
- 字幕華麗化（PIL）：金發光外圈→粗黑描邊→白主色＋綠副標，底部半透明黑漸層襯底；不遮商品、不依賴 ffmpeg 時間動畫。
- 混音去重疊：H3 原音
[0:a]volume=0[base] 靜音，只留口播＋BGM＋叮聲。 - 叮聲音效：aevalsrc 自產 0.3s 漸衰高頻（1600→800Hz 滑降），volume=0.5，delay 對齊各鏡頭起點。
- CDN 發布復用 app_id 復發布，判成敗看 JSON
ok（不看 exit code），+release-get 輪詢到 finished；發布成功後禁再訪連結檢查。
#### 【踩坑／避開的錯誤】
- deshake 打亂 overlay 時間基準：deshake 後 overlay 帶任何時間動畫（fade=alpha、enable=between、y 動畫）字幕全消失；deshake＋固定 overlay（無時間動畫）字幕正常 → 字幕特效一律 PIL 靜態化。
- H3 輸出在 D:\Comfy-Desktop\ComfyUI-Shared\output\anchor_enh\，不在舊民族風版目錄。
- SAPI 寫 D 槽假成功（meta 有長度但實體 0 字節）→ 必須寫 C:\Windows\Temp 且生成＋混音同一 PowerShell 命令（檔案稍後消失）。
- 口播重疊（0276）：保留 H3 原音＋加口播＝「兩個人在講話」→ 0277 去 base 修好。
- 混音 filter：wav 22050 mono 用 adelay={single}；勿加 pan=stereo（
| 在 filter 內被切斷報 Error binding filtergraph）。 - image_edit 一次 request_list>4 報 Length mismatch，需分批；aka 短碼不能直接當資源 src（需 bu.download 抓真實檔案）。
- prompt 含「購買號召／速度感線條」觸發 input review not pass → 中性化重試。
2026-10-18 交接卡補錄｜START_HERE_備份_20261018.md（§十七 vlog）
#### 【有效技巧】
- Ken Burns 無抖動公式：zoompan 交替 zoom in/out（scale→crop→zoompan d=125:s=1920x1080:fps=25），不加手持抖動。
- 鏡頭節奏：照片 3-6s（最短 3.5、最長 6，跟旁白時長）；影片從第 3 秒剪、最長 25s。
- xfade 轉場輪播：fade／slideleft／dissolve／circleopen／wiperight，duration 0.4-0.5。
- AI 看圖兩段式：每鏡頭先 qwen3-vl:8b 一句話描述（影片抽第 1 秒縮圖）→ 彙整後寫劇本（強制繁中、每句 25-45 字、收尾固定句）。
- 節點設計：photo_dir 填資料夾即可（免串 LoadImage）、OUTPUT_NODE=True、輸出複製到 ComfyUI output（介面找得到）。
#### 【踩坑／避開的錯誤】
- H3 i2va 動態化人物鏡頭＝假人臉（廣興 0006 人臉全不像）→ 永久拒絕：人物照片只用 Ken Burns，不 AI 動態化。
- IndexTTS unload_model=True → WinError 10054 連線重置 → 必須 unload_model=False。
- zoompan 表達式變數是 on 不是 n（frame number）；transpose=2 逆時針才是直式菜單轉橫（transpose=1 順時針會上下顛倒）。
- 組裝 normalize_clips() 會跳過已存在檔案 → 換素材後必手動刪 norm 對應檔。
- IndexTTS API 是 ComfyUI /prompt workflow 提交格式，非 REST /tts（405）；參考音要 16kHz mono（40kHz stereo 會 SaveAudio 無輸出）。
- TTS wav 比鏡頭短時 -shortest 會把鏡頭截短 → 音軌 apad=whole_dur 補靜音＋-t 強制時長。
- concat demuxer -c copy 在幀率/時長不齊時間戳飄（字幕對不上）→ 改 concat filter 重編碼。
- SRT 時間軸運算 PowerShell [int] 會四捨五入（32.8s 算成 1:32.8 字幕重疊）→ 用 Python int(x//3600) floor。
- ComfyUI 新節點不自動載入 → 建/改節點後必重啟 8188（等 40-45 秒，/object_info 確認）；IndexTTS 8189 殘留 process 佔 port → 重啟前殺乾淨（bind 10048）。
- Ollama qwen3:8b 生成旁白超時（180s 不夠）→ 改 qwen3-vl:8b＋timeout 300；第一次跑模型載入約 2 分鐘易誤判 timeout（先熱身一句）。
2026-10-18 交接卡補錄｜START_HERE_備份_20261018.md（§十五 銷售片角色）
#### 【有效技巧】
- 鎖臉產線決策：最像→貼臉 0.87~0.89；自然→局部重繪；一次生成無貼片→InstantID 0.88~0.92（參考圖要高清正臉）；InstantID→Flux 精修 denoise 0.35。
- 一鍵批量：python tools\one_click_girl.py <照片> [張數] [英文角色名] → 緊裁→InstantID→Flux 精修→驗證→縮圖→manifest，端到端 6 分鐘/3 張，冪等可續跑。
- 表情解耦：貼臉後用 prompt 表情詞（bright smile/pouting/winking）→ sim 不降、表情多樣。
#### 【踩坑／避開的錯誤】
- PuLID 純單圖鎖臉不足（0.17~0.29）→ 必須 PuLID+LoRA 疊用；4 步 Lightning 鎖臉保真差 → 25 步無 LoRA 才是最佳。
- PhotoMaker 參考圖品質決定成敗：低解析摳圖裁臉→0.49；高清正臉大頭照→0.66（用原圖裁不用摳圖殘影版）；inswapper 單張不像（0.72~0.74）→ 多張 embedding 平均（12 張）→0.90/0.82。
- SAC/WDAC 封鎖 torch DLL（WinError 4551）→ 換 Python（.venv 不行換系統 Python），勿關 SAC（不可逆）。
- 中文路徑 cv2 不吃 → 參考圖/中間檔一律英文檔名、角色名勿用中文；cv2.imdecode(np.fromfile(...)) 讀中文路徑。
- ComfyUI 長時間滿載自掛（422/479 張進程消失）→ 斷點續跑＋定期數 output 檔；execution_cached 無輸出圖（同節點同輸入被快取）→ 每次跑務必換 seed。