使用文件 / 輸出與詞彙

詞彙表產生器

把 Excel 裡的錯詞對照表轉成 ZeroType 的 global_replacements.json,包含輸入欄位格式、產出檔案放哪裡與常見錯誤。

最後更新

它做什麼

手寫 JSON 不難,但要一次補上兩三百組專有名詞就很煩。詞彙表產生器讓你用試算表維護對照表,再轉成 ZeroType 讀得懂的規則檔。

流程只有三步:

  1. 在試算表裡填「常見錯詞來源」與「正確詞彙」。
  2. 上傳到詞彙表產生器,它產出一份 global_replacements.json。
  3. 把檔案放進 ZeroType 設定資料夾。

登入學員帳號後還有更直接的路:表格會自動載入你同步到雲端的 global_replacements.json,直接在表格上改,按「儲存到雲端」即可,不必下載再搬檔案。儲存時以表格內容整份取代目前階段的詞彙(表格刪掉的列,雲端也會刪掉),另一個階段與所有 Regex 原樣保留;儲存前會列出新增、修改、刪除的項目。同一組錯詞寫成一列或分成多列,送出的檔案內容完全一樣,所以合併同義詞不會產生「需要儲存的變更」。

詞彙一多就不好用眼睛找。第二步「檢查與編輯」上方有快速搜尋,輸入關鍵字就會即時篩選,常見錯詞來源與正確詞彙兩欄都會比對;多個關鍵字用空白隔開時要同時命中才會留下來,例如 保哥 多奇。列號維持表格原本的順序,跟提醒區講的「第 N 列」對得上。篩選只影響畫面,預覽、下載與儲存到雲端仍然是整份表格。

輸入長什麼樣

試算表只有兩個欄位:

常見錯詞來源 正確詞彙
CheckGPT ChatGPT
ChatGBT ChatGPT
肉 type ZeroType
估狗 Google

規則很單純:

  • 常見錯詞來源:語音模型實際吐出來錯的字,一列一個。
  • 正確詞彙:你希望輸出成什麼。
  • 同一個正確詞有很多種錯法時,多填幾列,或把多個錯詞放在同一列的多行裡。
  • 欄名請沿用上面這兩個名稱,換成別的寫法可能對不上。

App 內的「匯出 Excel」可以幫你做出符合格式的檔案。目前沒有任何詞彙設定時,它會匯出一份含 5 筆範例的範本檔,直接照著填就不會錯。

產出什麼

詞彙表只有錯詞與正確詞兩欄,所以產生器輸出的是 global_replacements.json 裡的詞彙替換(Literals)對照表:鍵是正確詞,值是錯詞陣列。需要格式規則時要另外加 Regex,寫法見Regex 規則。

放到哪裡

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

替換檔案的路徑由 appsettings.Local.json 的 OutputConversion.DeterministicReplacementFile 決定,預設就是上面這個檔名。若你改過這個值,請把檔案放到你指定的位置。

放好之後,下一次錄音就會生效,不需要重開 App。

建議做法:從 App 匯入

直接覆蓋檔案最快,但要小心蓋掉既有規則。比較安全的順序是:

  1. 先用 App 的「自訂詞彙」→「匯出 Excel」備份目前規則。
  2. 在試算表裡把新詞補進去。
  3. 回到「自訂詞彙」按「匯入 Excel」,把資料合併進目前選取的階段。
  4. 確認預覽結果正確,再按「套用」或「儲存」。

匯入只改記憶體草稿,沒按「套用」或「儲存」就不會動到磁碟上的檔案。這個流程不會清掉你原本的 Regex 規則。

常見錯誤

症狀 原因 怎麼修
上傳後沒有產生任何規則 欄名不符,或檔案裡沒有可讀的資料列 先用 App 匯出的範本檔當底稿
整份規則都沒生效 有一列錯詞欄位是空白,被寫成空字串來源,驗證失敗 刪掉空白列後重新產生
錄音時完全沒套用規則 同一個錯詞對到兩個不同的正確詞,檔案被拒絕 只留一個對應,其餘刪除
只有部分詞生效 同一個正確詞拆成多列,寫成重複的鍵 合併成一筆,多個錯詞放進同一筆的來源清單
加了 Regex 之後整份失效 用了不支援的語法,例如 look-around 去掉該語法,或改回詞彙替換
檔案放了但沒反應 檔名或路徑和 DeterministicReplacementFile 不一致 確認設定值與實際檔名

ZeroType 對規則檔採嚴格驗證:只要有一條規則不合法,整份檔案都不會被套用,不會只套用其中一部分。所以「全部沒生效」通常不是 App 壞了,而是某一列有問題。

檢查有沒有生效

錄一段包含該專有名詞的話,然後到歷史記錄,用「開啟該筆資料夾」比對:

  • transcription_text.txt 是原始轉錄,可以看到模型原本聽成什麼。
  • output_text.txt 是最終輸出,應該已經是你設定的正確詞。

如果原始轉錄對、最終輸出錯,問題在規則;如果兩邊都錯,可能是規則沒載入,或詞放在 Transcription 階段卻被 AI 又改了回去。

下一步

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