使用文件 / 附錄
環境變數
ZeroType 支援的環境變數、各自用途、必填判斷與覆寫順序,只列名稱與用途,不列值。
最後更新
三層設定,一種順序
ZeroType 的設定有三個來源,優先順序由高到低是:
- 選取提示詞的 front matter:只影響那一次錄音,而且只能覆寫非機密設定。
- 環境變數:影響整個程序。
- 全域設定檔
appsettings.Local.json:平常調整的路徑,也是最後的回退值。
例外是金鑰:提示詞裡不得出現明文金鑰,寫了會被拒絕。金鑰一律放進 Windows 認證管理員或 macOS 鑰匙圈。
供應商與端點
| 變數 | 用途 | 必填 |
|---|---|---|
ZEROTYPE_OPENAI_API_BASE |
轉錄與校正共用的 API base | 使用共用端點時必填 |
ZEROTYPE_OPENAI_API_KEY |
共用金鑰內容 | 端點需要金鑰時必填 |
ZEROTYPE_OPENAI_CREDENTIAL_NAME |
共用金鑰在系統金鑰庫的名稱 | 與上者擇一 |
ZEROTYPE_TRANSCRIPTION_API_BASE |
只用於轉錄的 API base | 選填(覆寫共用值) |
ZEROTYPE_TRANSCRIPTION_API_KEY |
只用於轉錄的金鑰 | 選填 |
ZEROTYPE_TRANSCRIPTION_CREDENTIAL_NAME |
只用於轉錄的金鑰名稱 | 選填 |
ZEROTYPE_TRANSCRIPTION_MODEL |
轉錄模型,或 Azure 的部署名稱 | 雲端轉錄必填 |
ZEROTYPE_TRANSCRIPTION_LANGUAGE |
轉錄語言提示,例如 zh、en、ja |
選填 |
ZEROTYPE_AIPROMPT_API_BASE |
只用於 AI 校正的 API base | 選填(覆寫共用值) |
ZEROTYPE_AIPROMPT_API_KEY |
只用於 AI 校正的金鑰 | 選填 |
ZEROTYPE_AIPROMPT_CREDENTIAL_NAME |
只用於 AI 校正的金鑰名稱 | 選填 |
ZEROTYPE_AIPROMPT_MODEL |
AI 校正模型,或 Azure 的部署名稱 | 啟用校正時必填 |
ZEROTYPE_AIPROMPT_MODEL_EFFORT |
校正模型的 reasoning effort | 選填 |
「必填」指的是那個操作真的會被執行時。只用 Apple 裝置端轉錄時,轉錄端點、模型與金鑰都可以不填。若端點本身不需要金鑰,金鑰名稱可以填 EMPTY。
行為與執行
| 變數 | 用途 | 預設 |
|---|---|---|
ZEROTYPE_INPUT_MODE |
文字輸出方式:SmartPaste、SmartPaste+Clipboard、SimulatedKeyboard、Clipboard |
跟隨設定檔 |
ZEROTYPE_OUTPUT_CONVERSION_ENABLED |
是否執行確定性輸出轉換(自訂詞彙、字形統一) | 啟用 |
ZEROTYPE_TOOL_CALL_LOOP_LIMIT |
工具呼叫迴圈上限,允許 1–10 |
10 |
ZEROTYPE_AIPROMPT_TOOL_CALL_LOOP_LIMIT |
只給 AI 校正用的迴圈上限,優先於上者 | 未設定 |
ZEROTYPE_API_REQUEST_TIMEOUT_SECONDS |
LLM 請求逾時秒數 | 30 |
ZEROTYPE_UPDATE_CHECK_ON_STARTUP |
啟動後是否檢查更新 | 啟用 |
ZEROTYPE_UPDATE_MANIFEST_URL |
覆寫更新來源,主要供測試 | 平台預設值 |
ZEROTYPE_UPDATE_AUTO_DOWNLOAD_AND_INSTALL |
未來啟動時發現新版就直接下載安裝,不跳詢問視窗;手動檢查仍保留詢問流程 | 關閉 |
ZEROTYPE_OFFLINE |
明確離線模式:只允許本機端點 | 關閉 |
布林值可接受 true、1、yes、on、enabled;停用可用 false、0、no、off、disabled 或空值。
提示詞層級
這些寫在 USER.md / USER-*.md 的 front matter,只影響使用該提示詞的那次錄音。
| 變數 | 用途 |
|---|---|
ZEROTYPE_ENABLE_AI_CORRECTION |
是否對這次錄音做 AI 校正 |
ZEROTYPE_TRANSCRIPTION_ENGINE |
這次錄音改用雲端(Remote)或 macOS 的 Apple 裝置端轉錄 |
ZEROTYPE_ENABLE_REALTIME_TRANSCRIPTION |
是否改用即時串流轉錄 |
ZEROTYPE_ENABLE_STRUCTURED_OUTPUT |
是否要求模型回傳結構化結果 |
ZEROTYPE_ENABLE_STREAMING_OUTPUT |
關閉校正時,是否邊說邊輸出 |
ZEROTYPE_ENABLE_AUTO_ENTER |
輸入完成後自動送出 Enter |
ZEROTYPE_ENABLE_TOOL_FINAL_OUTPUT |
工具執行後是否仍輸出最終文字 |
ZEROTYPE_ENABLE_OPEN_APP |
允許開啟應用程式 |
ZEROTYPE_ENABLE_OPEN_URL |
允許開啟網址 |
ZEROTYPE_ENABLE_RUN_SHELL |
允許執行 shell 腳本 |
ZEROTYPE_ENABLE_GOOGLE_SEARCH |
允許搜尋 |
ZEROTYPE_ENABLE_ASK_CHATGPT |
允許轉問 ChatGPT |
ZEROTYPE_ENABLE_ASK_GEMINI |
允許轉問 Gemini |
ZEROTYPE_ENABLE_FIND_YOUTUBE |
允許搜尋 YouTube |
ZEROTYPE_ENABLE_SEND_KEYS |
允許模擬按鍵 |
ZEROTYPE_ENABLE_SMART_PASTE |
允許以智慧貼上輸出 |
ZEROTYPE_ENABLE_READ |
允許讀取檔案 |
ZEROTYPE_OUTPUT_CHINESE_CONVERSION |
字形轉換方向:Traditional、Simplified、None |
ZEROTYPE_CUSTOM_HOTKEY |
此提示詞的自訂切換鍵(單一英數字元,0 保留) |
ZEROTYPE_DISABLE_RECORDING_TONE |
這次錄音不播放開始與結束提示音 |
ZEROTYPE_DISABLE_RATING |
停用完成態評分快捷鍵 |
工具相關的開關預設關閉,必須在提示詞裡明確開啟,ZeroType 才會執行。完整清單與語意見 Front Matter 與 工具總覽。
覆寫順序
| 設定 | 順序 |
|---|---|
| 轉錄端點與金鑰 | Transcription.* → OpenAI.* |
| 校正端點與金鑰 | AiPrompt.* → OpenAI.* |
| 模型與語言 | 只覆蓋對應操作,不會互相影響 |
| 工具迴圈上限 | ZEROTYPE_AIPROMPT_TOOL_CALL_LOOP_LIMIT → ZEROTYPE_TOOL_CALL_LOOP_LIMIT → 設定檔 |
| 請求逾時 | 提示詞 front matter → 設定檔 OpenAI:RequestTimeoutSeconds → 30 秒 |
| 輸出轉換 | 環境變數 → 設定檔 OutputConversion:Enabled → 預設啟用 |
金鑰的三個規則
- 環境變數只放名稱與用途,值寫成你自己的金鑰;不要把金鑰貼進文件、提示詞或 Git。
- macOS 已由 App 管理的金鑰名稱,不接受同名的環境變數覆寫,避免來源混淆。
- 提示詞檔出現明文金鑰會被拒絕載入或拒絕同步,請改用金鑰名稱。
多奇教育訓練的學員金鑰由登入自動取得,檔名固定為 DUOTIFY_LEARN_API_KEY,不需要自己設定環境變數。
這一頁有錯、或有沒寫到的地方?寫信到 training [at] miniasp.com,我們會依實際行為更新文件。