使用文件 / 輸出與詞彙

自訂詞彙

用 global_replacements.json 固定專有名詞、修正語音模型固定誤聽,並在 AI 校正前後兩個階段各自套用。

最後更新

它解決什麼問題

語音轉錄對人名、產品名、縮寫特別容易出錯,而且錯法通常很固定:每次講「ChatGPT」都變成「CheckGPT」。在提示詞裡拜託 AI 改回來並不可靠,因為每次錯法都略有不同,而 AI 只會處理它看到的那一份文字。

自訂詞彙就是用一張對照表,把固定的錯詞換成正確詞。它同時處理兩件事:

  • 修正語音模型的固定誤聽,讓 AI 讀到正確的詞。
  • 統一正式輸出的拼法,例如品牌大小寫與空格。

檔案在哪

平台 路徑
Windows %LOCALAPPDATA%\ZeroType\global_replacements.json
macOS ~/Library/Application Support/ZeroType/global_replacements.json

全新安裝時 ZeroType 會自動放一份範本進去,appsettings.Local.json 的 OutputConversion.DeterministicReplacementFile 預設指向這個檔名。

  • 相對路徑以 ZeroType 設定資料夾為基準,也可以填絕對路徑。
  • 把值改成空字串,代表不載入替換規則。
  • 檔案不存在時會靜靜略過,不會報錯。
  • 這個路徑是全域設定,不能用提示詞的 front matter 覆蓋。

兩個階段

階段 執行時機 用來做什麼
Transcription 轉錄完成、字形轉換後,送進 AI 之前 修正固定誤聽,改善 AI 收到的語意
FinalOutput AI 校正與字形轉換之後 統一正式輸出的拼法、空白、標點與格式

兩個階段互相獨立,同一個錯詞可以在兩邊有不同的對應。完整順序見輸出轉換流程。

檔案結構

{
  "Transcription": {
    "Literals": {
      "ZeroType": [
        "Zero Type",
        "肉 type"
      ]
    },
    "Regex": [
      {
        "Pattern": "版本[ ]*([0-9]+)",
        "Replacement": "版本 $1"
      }
    ]
  },
  "FinalOutput": {
    "Literals": {
      "ZeroType": [
        "zerotype"
      ]
    },
    "Regex": [
      {
        "Pattern": "[ \t]+",
        "Replacement": " "
      }
    ]
  }
}

Transcription 與 FinalOutput 都可以省略,Literals 與 Regex 也可以只寫其中一個。

Literals:一對多的詞彙表

Literals 的鍵是要輸出什麼,值是會被換掉的來源字串陣列:

{
  "Literals": {
    "ChatGPT": [
      "CheckGPT",
      "ChatGBT"
    ]
  }
}

執行規則:

  • 區分大小寫:來源寫 Zero Type,就不會命中 zero type。
  • 精確比對,不做 Unicode 正規化。
  • 同一個位置有多個來源可命中時,較長的來源優先。
  • 整段只掃描一次,替換後的結果不會再被同一輪規則處理。
  • 鍵可以留空字串,代表把命中的內容直接刪掉。
  • 同一個來源不能重複,也不能對應到兩個不同的正確詞。

什麼放哪一階段

情況 建議階段
語音模型長期聽錯的人名、產品名、術語 Transcription
會影響句意的縮寫、同音字 Transcription
品牌正式拼法與大小寫 FinalOutput
空白、標點、版本號與編號格式 FinalOutput
需要固定刪除或遮蔽的內容 FinalOutput

不要把句子層級的格式化放進 Transcription。那一階段的任務是讓 AI 看懂,不是把句子排版好。

詞彙替換與 Regex 怎麼選

需求 用哪一種
固定的錯詞換成正確詞 Literals
一個正確詞對多種錯法 Literals
格式有變化,例如版本號位數不定 Regex
要搬動、重排、抓取片段 Regex

能用 Literals 解決的就不要用 Regex,可讀性與安全性都比較好。Regex 的語法與風險見Regex 規則。

用 App 內編輯器管理

偏好設定裡有「自訂詞彙」頁籤,用表單管理同一份檔案,不必手動編輯 JSON:

  • 分開呈現兩個階段、詞彙替換與 Regex。
  • 所有編輯只改記憶體草稿,按「套用」或「儲存」才寫入檔案。
  • 有未套用的草稿時關閉視窗會先確認。
  • 可以匯入或匯出 Excel 詞彙對照表。
  • 附「規則測試」區,用目前草稿試轉一段文字。

如果偏好設定開著的時候,檔案被其他程式改掉了,ZeroType 會拒絕用舊草稿覆寫,請重新開啟再合併。想把 Excel 詞彙表轉成規則檔,見詞彙表產生器。

嚴格驗證

ZeroType 會驗證整份檔案,出現下列任一情況就整份拒絕,不會只套用一半:

  • 出現未知欄位,或混用舊版與新版格式。
  • Literals 的來源是空字串,或來源陣列是空的。
  • 同一個來源重複,或對應衝突。
  • Regex 樣式是空的或無法編譯。
  • 替換樣板參照了不存在的擷取群組。

在 App 的編輯器裡儲存時就會擋下這些錯誤。若你直接手改 JSON,改完記得先開一次編輯器確認載入正常,不要等到錄音時才發現整份沒生效。

備份與還原

規則檔就是一個純文字 JSON 檔:

  • 備份:把 global_replacements.json 複製到其他位置,或整個設定資料夾一起備份。
  • 還原:把備份檔覆蓋回原路徑。下一次錄音就會使用新內容。
  • 搬移:換電腦時直接把檔案帶過去,不必重建。

自動更新不會覆蓋你既有的規則檔。新版本內建的範本只在檔案不存在時才會補上,所以你的個人詞彙是安全的。

下一步

這一頁有錯、或有沒寫到的地方?寫信到 training [at] miniasp.com,我們會依實際行為更新文件。