使用文件 / 提示詞
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。
下一步
- 多組 profile:把不同設定拆成不同檔案。
- 供應商與模型選用:要填哪個位址與模型名稱。
這一頁有錯、或有沒寫到的地方?寫信到 training [at] miniasp.com,我們會依實際行為更新文件。