使用文件 / 輸出與詞彙
自訂詞彙
用 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,我們會依實際行為更新文件。