SouVi 引擎
souvi 已加入 PATH，可從任何目錄執行。引擎位於 /home/cptdawn/Kode/SouVi-Engine（以下簡稱 $SOUVI）。souvi <cmd> -h 可查看參數；souvi presets 列出交付格式、外觀、標題樣式、轉場及音效。
工作區
每個交付物集合都是 $SOUVI 中的一個專案：
projects/<slug>/—timeline.json（剪輯檔）和BRIEF.md（簡報 + 附日期的決策記錄）assets/<slug>/{footage,images,music,voice,sfx,graphics,fonts,luts,refs}/— 來源素材，絕不修改output/<slug>/{drafts,renders,final,review}/— 結果，版本化為_vNNN，絕不覆寫
從其他儲存庫呼叫時：slug 為該儲存庫的資料夾名稱（如需獨立交付可加上後綴，例如 myapp-teaser）。使用 souvi import <slug> <files…> 導入媒體（非音樂音訊加 --as voice|sfx，大型影片加 --link）；使用 souvi promote <render> --to <calling repo 中的資料夾> 交付。除非使用者要求，否則請勿動到 $SOUVI 中的 git。
並行代理是安全的：每個任務在私有資料夾中執行，同一專案的渲染工作會排隊等待鎖。為每個代理的交付物指定獨立的 slug。
工作循環
souvi new <slug> --preset <delivery>；將簡報寫入BRIEF.md。souvi import …、souvi assets <slug>，然後對每個候選來源執行souvi look <clip>。- 閱讀
$SOUVI/docs/timeline.md後撰寫timeline.json；執行souvi plan <slug>直到無錯誤。 souvi render <slug> --draft（可加--gpu、--until N），審查，修改。souvi render <slug>（QC 必須 PASS），審查，souvi promote <render> [--to …]。
審查 — 您無法觀看或收聽，因此請閱讀這些指令輸出的 PNG：souvi look <video>（聯絡表；--from/--to 可在剪輯點附近產生密集表）、souvi frame <video> --at <t…>、souvi hear <file>（頻譜圖、波形、響度）。當最終渲染通過此審查與 QC 時，工作即完成。
工藝
進行創意決策前，請先閱讀 video.md（影像）及 audio.md（音效）。應用其審查檢查清單中的每一項。
單一檔案工具
export --preset、master、voice、sfx、reverb、stabilize、denoise、grade、retime、qc、loudness、probe。處理後的檔案會以 <name>.<tag>_vNNN.<ext> 格式儲存在來源旁。
對於其他需求，只要保持 10-bit 處理、lanczos 縮放、BT.709 標籤和 soxr 重新取樣，可直接使用原始 ffmpeg；最後用 souvi master 完成響度處理，並用 souvi export 編碼交付物。