使用文件 / 提示詞

front matter 全欄位

在提示詞檔案最上方用 front matter 覆寫模型、供應商、輸出方式、字形轉換與工具開關,並附完整欄位對照表。

最後更新

front matter 是什麼

front matter 是提示詞檔案最前面的一段設定,用 --- 包起來,只支援 KEY: value 這種單行寫法:

---
ZEROTYPE_AIPROMPT_MODEL: gpt-4.1
---

請將轉錄內容改寫成正式、完整、清楚的文件段落。

結束的 --- 之後才是提示詞本文。這段設定只影響這一份提示詞,不會改到全域偏好設定。同一個設定若在 appsettings.Local.json 與 front matter 都有值,這次錄音會用 front matter 的值。

供應商與模型

欄位 別名 可選值 作用
ZEROTYPE_OPENAI_API_BASE API_BASE API 位址 轉錄與 AI 校正共用的位址
ZEROTYPE_OPENAI_CREDENTIAL_NAME 無 金鑰名稱 上面那個位址要用的金鑰名稱
ZEROTYPE_TRANSCRIPTION_API_BASE 無 API 位址 只給轉錄用,填到 /v1 這類基底即可
ZEROTYPE_TRANSCRIPTION_CREDENTIAL_NAME 無 金鑰名稱或 EMPTY 轉錄金鑰;EMPTY 代表不需要金鑰
ZEROTYPE_TRANSCRIPTION_MODEL TRANSCRIPTION_MODEL 模型名稱 轉錄模型;Azure OpenAI 時填 deployment 名稱
ZEROTYPE_TRANSCRIPTION_LANGUAGE TRANSCRIPTION_LANGUAGE ISO-639-1,如 zh、en 轉錄語言提示
ZEROTYPE_TRANSCRIPTION_ENGINE TRANSCRIPTION_ENGINE(僅 macOS) Remote、AppleSpeechAnalyzer 單一提示詞改回雲端轉錄或改用 Apple 裝置端轉錄
ZEROTYPE_AIPROMPT_API_BASE 無 API 位址 只給 AI 校正用
ZEROTYPE_AIPROMPT_CREDENTIAL_NAME 無 金鑰名稱或 EMPTY AI 校正金鑰
ZEROTYPE_AIPROMPT_MODEL AIPROMPT_MODEL 模型名稱 AI 校正模型;Azure OpenAI 時填 deployment 名稱
ZEROTYPE_AIPROMPT_MODEL_EFFORT AIPROMPT_MODEL_EFFORT 依模型而定 推理強度,例如 low、medium、high
ZEROTYPE_API_REQUEST_TIMEOUT_SECONDS API_REQUEST_TIMEOUT_SECONDS 5–300 單次 API 呼叫的逾時秒數,預設 30

輸出與輸入

欄位 別名 可選值 預設 作用
ZEROTYPE_INPUT_MODE INPUT_MODE SmartPaste、SmartPaste+Clipboard、SimulatedKeyboard、Clipboard SmartPaste 文字怎麼進到前景 App
ZEROTYPE_ENABLE_AUTO_ENTER ENABLE_AUTO_ENTER 布林 false 貼完自動送一次 Enter
ZEROTYPE_OUTPUT_CHINESE_CONVERSION OUTPUT_CHINESE_CONVERSION Traditional、Simplified、None Traditional 最終輸出的中文字形
ZEROTYPE_ENABLE_AI_CORRECTION ENABLE_AI_CORRECTION 布林 true 這份提示詞要不要跑 AI 校正
IncludeClipboard 無 布林 沿用全域 這次錄音要不要把剪貼簿當上下文
ZEROTYPE_DISABLE_RECORDING_TONE DISABLE_RECORDING_TONE 布林 沿用全域 用這份提示詞錄音時不播提示音
ZEROTYPE_CUSTOM_HOTKEY 無 單一英數字元,0 不可用 無 這份提示詞的專屬切換鍵

SimulatedKeyboard 是逐字送出鍵盤事件、不碰剪貼簿;Clipboard 只寫入剪貼簿,不自動貼上。輸出模式的差異見輸出模式。

工具與流程

欄位 別名 可選值 作用
ZEROTYPE_TOOL_CALL_LOOP_LIMIT TOOL_CALL_LOOP_LIMIT 1–10 工具呼叫迴圈上限,預設 10
ZEROTYPE_ENABLE_TOOL_FINAL_OUTPUT ENABLE_TOOL_FINAL_OUTPUT 未設定 / false / true 工具執行後要不要再輸出文字;未設定與 false 語意不同
ZEROTYPE_ENABLE_GOOGLE_SEARCH ENABLE_GOOGLE_SEARCH 布林 啟用 google_search
ZEROTYPE_ENABLE_OPEN_URL ENABLE_OPEN_URL 布林 啟用 open_url
ZEROTYPE_ENABLE_OPEN_APP ENABLE_OPEN_APP 布林 啟用 open_app
ZEROTYPE_ENABLE_SEND_KEYS ENABLE_SEND_KEYS 布林 啟用 send_keys
ZEROTYPE_ENABLE_SMART_PASTE ENABLE_SMART_PASTE 布林 啟用 smart_paste
ZEROTYPE_ENABLE_RUN_SHELL ENABLE_RUN_SHELL 布林 啟用 run_shell
ZEROTYPE_ENABLE_READ ENABLE_READ 布林 啟用 read

其餘工具(ask_chatgpt、ask_gemini、find_youtube)的啟用欄位遵循同一個規則:ZEROTYPE_ENABLE_ 加上大寫工具名。工具預設全部關閉,沒啟用就不會出現在該次請求裡。

進階:轉錄與輸出細節

這幾個欄位平常不需要動,需要為單一提示詞調整行為時才使用:

欄位 別名 可選值 作用
ZEROTYPE_ENABLE_REALTIME_TRANSCRIPTION ENABLE_REALTIME_TRANSCRIPTION 布林 改用即時轉錄;false 可明確關閉並覆蓋全域開關
ZEROTYPE_ENABLE_STREAMING_OUTPUT ENABLE_STREAMING_OUTPUT 布林 關閉 AI 校正並搭配即時轉錄時,說話期間就逐字輸出;預設 false(放開錄音鍵後一次輸出)
ZEROTYPE_ENABLE_STRUCTURED_OUTPUT ENABLE_STRUCTURED_OUTPUT 布林 要求模型以結構化格式回傳,只取其中的文字欄位;預設開啟,遇到不支援的供應商會自動降級

即時轉錄還有 VAD 門檻、語句分段、關鍵字等一組細部參數。這些值數量多、且會隨供應商調整,建議用 App 內的提示詞編輯器設定,不確定語意時不要手寫。

值規則

  • value 會去掉前後空白;外層單引號或雙引號會被移除,"gpt-4.1" 與 gpt-4.1 等價。
  • 布林欄位接受 true、1、yes、on、enabled 與 false、0、no、off、disabled、空值。
  • 模型、API base、INPUT_MODE 留空代表「不覆蓋」,沿用全域設定。
  • 值不合法會讓整份提示詞載入失敗,不是靜靜忽略。例如 INPUT_MODE: Paste 或 OUTPUT_CHINESE_CONVERSION: 繁體 都會被拒絕;字形設定請寫 Traditional、Simplified 或 None,也接受 zh-tw、zh-cn、off 這幾個相容寫法。
  • 同一個已知欄位重複出現時,以最後一筆為準。

寫法限制

  • 必須是檔案最前面的區塊,第一行就是 ---,結束也要一行 ---。
  • 空行與 # 開頭的註解可以保留。
  • 不支援 nested YAML、陣列與多行 value。Tools: 底下縮排再列工具是無效的,工具開關要一行一個寫在頂層。
  • 建議一律使用大寫加底線的欄位名,跨平台共用時最不會出錯。
---
# 這個提示詞只給搜尋用
ZEROTYPE_AIPROMPT_MODEL: gpt-4.1-mini
ENABLE_OPEN_URL: true
---

請依照我的口述內容產生回覆。

不可以寫金鑰

front matter 只能指定「金鑰名稱」,不能放金鑰內容。API_KEY、ZEROTYPE_OPENAI_API_KEY、ZEROTYPE_TRANSCRIPTION_API_KEY、ZEROTYPE_AIPROMPT_API_KEY,以及任何以 _KEY 結尾的欄位都會被拒絕。

---
ZEROTYPE_AIPROMPT_CREDENTIAL_NAME: OpenAI 工作金鑰
---

上面的值是你在金鑰管理裡取的名字,不是金鑰本身。金鑰本體存在 Windows 認證管理員或 macOS 鑰匙圈。

優先順序

由低到高:App 內建預設 → appsettings.Local.json → 金鑰管理中的金鑰內容 → 目前提示詞的 front matter。

下一步

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