更新動態

這一版改了什麼

早上那版讓 vault 在 Windows 跑得起來；這一版把「裝機路上會卡住的點」再清一輪，Mac 端行為照樣不變。

• 接連結器不再卡住：SETUP 那一節過去第一步就要跑 claude mcp list，但桌面版 Claude Code 沒有這個指令，整節會停在原地。現在沒有 CLI 就先用問答把連結器狀態補齊、AI 在背景幫你裝 CLI、裝好之後回頭補掃核對——整個安裝過程不停下來等任何東西。
• hook 少一個前置條件：開場儀表與對話存檔的 hook 改用三平台啟動器，Windows 沒裝 Git for Windows（hook 退到 PowerShell 跑）也能動；找 Python 的邏輯搬進 Node，不再依賴殼的語法。
• skills 載入多一層保險：萬一連結（junction）建得起來、Claude Code 卻載不到 skills，跑 node ./offline/doctor.mjs --copy-skills 會把它改建成實體副本，之後每次健檢自動跟 skills/ 同步。
• 檔名規則進 SCHEMA：選題標題不再允許 :、? 這些 Windows 開不了的字元（要用改全形 ：？｜），內容產線建檔前會先檢查——Mac 建的 vault 同步到 Windows，不會再出現打不開的資料夾。
• 工具表安裝指令跨平台化：能一句三平台通吃的（npm／pip）就用一句；只有平台專屬的才並列 brew ／ winget。

已經在用的：跟 Claude 說「update」即可，今天兩版會依序一起套。還沒開始用的：直接重新下載新安裝包，一步到位最省 token。

這一版改了什麼

這一版讓同一份 vault 在 Windows 也跑得起來，Mac 端行為完全不變。

之前在 Windows 打開 vault 會遇到一串「怎麼都沒反應」：開場的 HUB 儀表注入不進去（中文編碼炸掉）、python3 是 Microsoft Store 的空殼跑了沒輸出、skills 一個都載不到（別名被 checkout 成文字檔）、連 update 機制本身都會把每個檔誤判成「路徑逃出 vault」。這版把這一串全修掉，並新增一支健檢指令 node ./offline/doctor.mjs：開工前跑一次，缺什麼（node／Python／Git Bash）它印一行安裝指令給你照唸，skills 別名斷了它直接修好。

另外：設計產線的產圖腳本不再寫死 Mac 的 Chrome 路徑（Windows 沒裝 Chrome 時用內建 Edge 也能出圖）；機制.md 新增〈平台〉一節，讓 AI 在 Windows 上固定走 Git Bash、改檔只用 Write／Edit，不會用 PowerShell 把你的檔案寫壞；codex-cli-img 產圖多了一套驗收規則（比例、出血、字形、品牌字串逐張檢查）。

已經在用的：跟 Claude 說「update」套用即可。還沒開始用的：直接重新下載新安裝包比較省 token——新包已含全部修正，不必讓 AI 逐檔套。

這一版改了什麼

Windows 全面支援。 這一版起，AI 剪輯師在 Windows 10/11 上從安裝到出片整條鏈都走得通—— 照 SETUP.md 用 winget 裝 Node／Python／ffmpeg，健檢會自動把 skills 連結改建成 Windows 的 junction， 轉錄、剪輯、字幕、閘門到 GPU 渲染（NVIDIA 實測）全部真機驗過，快速模式與完整模式各出過一支成品。 中文路徑、cp950 編碼、C:\Program Files 空格這些 Windows 經典地雷都處理掉了。 少數還是 macOS 專屬的功能（講者去背、聲音克隆）在 SETUP.md 的平台差異表裡寫明，不會靜默失敗。

沒有雲端金鑰也能剪完整支片。 以前 .env 沒填 ELEVENLABS_API_KEY 的機器，初次轉錄會直接報錯剪不下去。 現在會自動退到隨包的離線路線（Breeze 模型＋whisper.cpp，node app/scripts/fetch-asr-model.mjs 抓一次就有）—— 慢一點、但整條全離線。刀口回退同時加了守衛：離線轉錄的時間戳偏早時，不會再把人聲的尾巴當靜音吃掉。

快速模式真的能出片了。 之前把製作模式切到 quick，閘門會自相矛盾——一邊規定快速模式不得有視覺元素、 一邊又因為沒有視覺元素把片擋下，永遠走不到渲染。現在新增 build-quick-plan：剪完直接從字幕與剪單產 plan， 不用分鏡表，零元素也能成片，閘門在 quick 模式下只檢它該檢的。

修掉一批「全部檢查都綠、成品卻不對」的靜默問題。 音效庫：登記在冊但檔案不在的音效以前會被選進成片，整段沒聲音而每一關都過——現在選音前驗檔案真的在， 安裝中斷留下的缺檔會自動補齊，解壓改用內建實作、不再依賴系統的 unzip。 章節轉場：讀錯欄位導致翻頁音色永遠配錯，修正。 結構檢查：hyperframes check 以前在買家機器上會被靜默跳過（等於沒檢），現在真的跑。 渲染驗收的聯絡表在沒有字型設定的機器上會直接崩潰，改帶隨包字型。

渲染前的閘門多抓三種問題：動畫 GIF 沒標時長、寫在動畫區塊外而被靜默丟棄的動畫、 掛在容器節點上的語意主張——以前這些會漏到成品才發現，現在擋在渲染前。

指令入口統一改 node。 文件裡的 bash app/scripts/xxx.sh 一律改成 node app/scripts/xxx.mjs， Mac 與 Windows 用同一套指令；你手打舊的 .sh 也還能動，會自動轉呼叫新版。

相容性

• 你自己改過的設定不會被蓋掉——走三方合併，只有還停在原廠值的欄位會跟著換。
• projects/、study/、.env、素材庫一律不碰。
• Windows 用戶第一次照 SETUP.md 裝好後，之後的更新與 Mac 完全同一條路。

這一版把你手上的包一路追平到現在，套完之後與今天新下載的安裝包完全一致。

這一版改了什麼

第一次開機的引導從四拍變六拍，而且不再讓你空等。 開設定面板時會明講「哪幾件是必做的」—— 最常見的卡點是漏掉右上角「選擇 AI Video Editor 資料夾」，於是後面按儲存都寫不進檔案， 而且看不出哪裡錯。現在還會在背景先幫你把離線轉錄模型備好，用選的決定素材與製作模式。

新增：系統開始記得你的判斷。 以前你說「這裡不該有元素」「這種片不要放字」，AI 只能改這一次的片。 現在有了 MEMORY.md——放在根目錄、更新永遠不會碰它、優先權高過任何內建規範， 而且剪片前的工單會把適用條目印出來。你不用手寫，對成品給回饋時 AI 判斷那是「口味」就會自己寫進去。

新增：回報 bug。 遇到跑不出來、卡住、或 AI 自己修不掉的時候，說一聲「回報 bug」， 它會蒐集版本、環境、復現步驟與閘門全文寫成本機檔，全文給你看過才送出——不收素材、逐字稿、金鑰。

預設風格改成撕紙手作（設定面板的清單本來就標它是預設，值沒跟上）， 字幕字型換成隨包附的 Noto Sans TC——原本指向的字魂扁桃體是自備的商用字型、不隨包發布， 所以每一台的字幕其實都在悄悄退回備援字型，跟風格描述的長相不一樣。

字型缺了可以自己補：node app/scripts/fetch-fonts.mjs --add "<字族名>" 會去查 Google Fonts 把 OFL 字檔抓下來；查不到就照實說「這支要自備」，不會靜默失敗。

素材抓不到時不再中途打斷你：缺字型、缺 API key、素材抓不到，AI 會先換一條路做完， 交付時才一件一行告訴你「原先要什麼、因為什麼、所以先怎麼做」。

update 指令改用繁體中文回覆。

相容性

• 你自己改過的設定不會被蓋掉——走三方合併，只有還停在原廠值的欄位會跟著換。
• projects/、study/、.env 一律不碰。
• MEMORY.md 不在更新範圍內，也不會被建立——你有需要時 AI 才建，之後永遠是你的。

這一版修了什麼

設定面板連不上／按儲存無限轉圈（主因）。瀏覽器記住的資料夾若被改名、刪除，或指到別份安裝， 面板仍會顯示「已連接」，而按下儲存會卡在權限視窗上——畫面只寫「儲存中…」，沒有任何線索。 現在：快取的資料夾每次都驗證是否還存在且是編輯器根目錄，驗不過就直接請你重選； 連上之後按鈕改成「換資料夾」不再消失；新增「重置資料夾連接」當作卡死時的出口； 等系統視窗時文案會說明在等什麼，超過 8 秒提醒視窗可能開在瀏覽器後面。

缺字型不再靜默。安裝包不夾帶字檔，但渲染用 url() 鎖定字型，缺檔會靜默跳過、 成品退回系統字體（中文筆畫黏死，且每台機器長相不同）。新增 fetch-fonts.mjs， 從官方來源補齊 4 支 OFL 字型與授權檔，下載內建重試；bootstrap.sh 缺字型時會自動呼叫。

開機健檢。新增 health-check.sh，每個 session 開頭跑一次：.env 不存在就從範本建立、 字型或 skill 佈局有問題就提醒、有新版就告知。離線可用，連不上更新索引會安靜跳過。

skill 佈局還原。打包時 symlink 被解引用，.claude/skills 與 .agent/skills 變成實體副本， 導致更新可能落在 Claude Code 沒有載入的那一份。本版把三份一起更新， 並附 link-skills.sh 讓你還原成 symlink（內容不同就拒絕，不會洗掉你的客製）。

相容性

• 不動 .env、projects/、study/、素材與輸出。
• .env 若不存在會由健檢從 .env.example 複製一份（用 cp，範本保留）。
• 客製過的檔案走三方合併，不覆寫。