Communitygithub.com

jun7799/jianying-subtitle-fixer

剪映字幕AI纠错流水線。當使用者說「糾字幕」、「字幕糾錯」、「改字幕」、「修正字幕」、「字幕識別錯了」、「處理字幕」,或提到錄完影片要在剪映裡改專有名詞字幕(如 Agent、Claude Code、MCP 識別錯)時使用。流程:剪映智慧字幕辨識 → 本工具解密草稿 → 術語表規則+智譜glm-4-flash雙層糾錯 → 回加密寫回 → 使用者回剪映手動剪輯。

jianying-subtitle-fixer 是什麼?

此技能專為解決剪映智慧字幕辨識中,專有名詞頻繁錯誤的問題而設計。它作為一道自動化流水線,可無縫整合至創作者工作流程中:從剪映草稿中解密字幕內容,運用詞彙表規則和大型語言模型(智譜glm-4-flash)進行雙層糾錯,再將修正後的字幕加密寫回原始草稿,最終使用者只需在剪映中微調即可。主要支援 Windows 平台上的剪映桌面版(相容版本 10.3 至 11.5),並依賴社群工具 jy-draftc 來編解密。其核心價值在於大幅節省手動校對時間(例如將每部影片半小時的校對工作縮短至幾分鐘),同時透過可積累的術語表持續提高準確度。工具提供多種安全機制,包括預覽模式(--dry-run)、備份恢復,以及長度突變檢測,避免 LLM 幻覺導致錯誤修改。此外,使用者可選擇純規則模式(--no-llm)以獲得即時回應,或讓 LLM 批量處理同音錯字,平衡速度與精度。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add jun7799/jianying-subtitle-fixer

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

剪映字幕 AI 糾錯

解決什麼問題

剪映的語音辨識快且免費,但專有名詞(Agent、Claude Code、MCP、WorkBuddy…)總辨識錯, 每集影片手改字幕要花半小時。本工具自動完成:解密草稿 → 雙層糾錯 → 回加密寫回, 時間軸和樣式零改動,改完回剪映直接開始剪輯。

前置條件(一次性,詳見 references/setup.md)

  1. tools/ 下放好 jy-draftc.exe(從 GitHub wenshui330/jy-draftc 下載)
  2. 本機裝有剪映桌面版(自動探測,或設 JY_INSTALL_DIR 指向含 videoeditor.dll 的版本目錄)
  3. 智譜 API key(環境變數 ZHIPU_API_KEY;用智譜跑 Claude Code 的可自動讀取 settings.json)

標準工作流程

1. 使用者在剪映裡:新建草稿 → 放影片 → 「文字→智慧字幕」辨識完
2. 完全退出剪映(含托盤)——腳本會檢測,剪映開著拒絕寫回
3. 跑腳本(dry-run 先看效果):
   python scripts/fix_subtitles.py "草稿名" --dry-run
4. 讓使用者看 workspace/<草稿名>/changes.md 對照表,確認改動
5. 正式寫回(去掉 --dry-run)
6. 使用者重開剪映 → 字幕已糾好 → 手動刪減/加變速 → 匯出

執行命令模板

& "<skill目錄>/scripts/fix_subtitles.py" "草稿名" --dry-run   # 預覽
& "<skill目錄>/scripts/fix_subtitles.py" "草稿名"             # 正式寫回
& "<skill目錄>/scripts/fix_subtitles.py" "草稿名" --no-llm    # 純規則,秒出

參數

參數作用
--dry-run只出對照表+SRT 不寫回(剪映開著也能跑)
--no-llm只跑術語表規則取代,不調 API
--batch NLLM 每批條數,預設 30

術語表維護(核心!越用越準)

config/terms.json:

  • terms:權威寫法(寫回前強制校驗大小寫,如 api→API)
  • fix:確定無疑的「錯→對」映射(如 克勞德扣→Claude Code、engine→Agent)

每次跑完發現新錯拼,主動詢問使用者是否沉澱進術語表。 使用者是內容創作者,同一系列的影片術語高度重複,術語表是最有效的資產。 注意:加長短語映射(如「手抽injection→手搓Agent」)可能被已有的短映射(「手抽→手搓」) 先命中而失效——優先加目標詞本身的映射(如「injection→Agent」)。

雙層糾錯機制

  • 規則層(主力):術語表精確取代,秒級、零成本、100%可控
  • LLM 層(兜底):glm-4-flash 批量糾同音錯字(30條/批×4路並發), 寫回前過術語校驗 + 長度突變檢測(防幻覺重寫)

安全機制

  • 剪映執行中拒絕寫回;每次執行自動備份到 workspace/<草稿名>/backups/
  • 只改文字欄位,時間軸/樣式/軌道不動;回滾 = 用備份覆蓋 draft_content.json

已知邊界

  • 依賴 jy-draftc 對剪映版本的支援(當前支援 10.3~11.5,剪映大版本更新後留意該專案)
  • 草稿裡手動加的標題文字也會一起被糾(對照表可見,一般無礙)
  • glm-4-flash 偶爾會小幅越權(刪語氣詞/補字),prompt 已加「寧可漏改不可錯改」約束, 最終以對照表人工抽查為準

相關技能