使用文件 / 附錄

環境變數

ZeroType 支援的環境變數、各自用途、必填判斷與覆寫順序,只列名稱與用途,不列值。

最後更新

三層設定,一種順序

ZeroType 的設定有三個來源,優先順序由高到低是:

  1. 選取提示詞的 front matter:只影響那一次錄音,而且只能覆寫非機密設定。
  2. 環境變數:影響整個程序。
  3. 全域設定檔 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 → 預設啟用

金鑰的三個規則

  1. 環境變數只放名稱與用途,值寫成你自己的金鑰;不要把金鑰貼進文件、提示詞或 Git。
  2. macOS 已由 App 管理的金鑰名稱,不接受同名的環境變數覆寫,避免來源混淆。
  3. 提示詞檔出現明文金鑰會被拒絕載入或拒絕同步,請改用金鑰名稱。

多奇教育訓練的學員金鑰由登入自動取得,檔名固定為 DUOTIFY_LEARN_API_KEY,不需要自己設定環境變數。

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