使用文件 / 工具呼叫

工具範例

十個工具各一組可照抄的 front matter 與說法,從搜尋、開 App 到執行 shell 命令。

最後更新

怎麼用這一頁

每一節都是「貼進提示詞的 front matter」加「你可以怎麼說」。把 front matter 放進你要用的那份 USER.md 或 USER-*.md 最上面,句子放在 front matter 之後。

想一次開很多工具也可以,但建議先挑兩三個你真的會用的。工具開越多,模型判斷失誤的機會越大。

一句話只做一件事也比較穩。與其說「搜尋一下然後幫我開那個網站然後寄出去」,不如分三次講,每次都能確認結果。

---
ENABLE_GOOGLE_SEARCH: true
---

如果我明確要求搜尋 Google,請使用 google_search。
如果我只是一般口述文字,請不要搜尋。

可以說:

搜尋 Google ZeroType 語音輸入工具

ask_chatgpt

---
ENABLE_ASK_CHATGPT: true
---

如果我明確說「問 ChatGPT」,請使用 ask_chatgpt。
一般文字輸入不要使用工具。

可以說:

問 ChatGPT 幫我解釋什麼是 API gateway

ZeroType 會在瀏覽器開啟 ChatGPT,把問題填進去並自動送出,你直接看回答就好。

ask_gemini

---
ENABLE_ASK_GEMINI: true
---

如果我明確說「問 Gemini」,請使用 ask_gemini。

可以說:

問 Gemini 幫我整理這段產品需求

find_youtube

---
ENABLE_FIND_YOUTUBE: true
---

如果我要求找影片、教學、音樂或 YouTube 內容,請使用 find_youtube。

可以說:

找 YouTube 上的 macOS 權限教學

open_app

---
ENABLE_OPEN_APP: true
---

如果我要求開啟桌面應用程式,請使用 open_app。

可以說:

開啟 Visual Studio Code

或:

打開 Spotify

先用本機已安裝的應用程式清單比對名稱,對不到才交給系統開啟。如果第一次開失敗,ZeroType 會用同一份清單再比對一次,所以講常見的中文或英文名稱命中的機率比較高。

open_url

---
ENABLE_OPEN_URL: true
---

如果我提供明確 URL 並要求打開,請使用 open_url。
不要自己猜網址。

可以說:

打開 https://example.com/pricing

open_url 只接受完整的絕對網址,包含 https:// 或 http://。只說「打開某某網站」而沒有給網址時,請改用 google_search。

send_keys

---
ENABLE_SEND_KEYS: true
---

如果我要求按快捷鍵,請使用 send_keys。
如果我是要輸入一般文字,請不要使用快捷鍵。

可以說:

按 Ctrl A 然後 Ctrl C

macOS 上說:

按 Command S

send_keys 只送快捷鍵與控制鍵,例如 Ctrl+C、Alt+Tab、Enter、Escape、F5,可以用逗號串起連續按鍵。它不會幫你打出文字,打字請用 smart_paste。

smart_paste

---
ENABLE_SMART_PASTE: true
---

如果我要求把整理好的文字貼到目前視窗,請使用 smart_paste。

可以說:

用條列方式整理我剛說的三個重點,然後貼上來

工具貼上的文字會先經過字形轉換與你的輸出規則,再寫進前景 App。貼完之後 ZeroType 不會再多輸入任何確認文字。

read

---
ENABLE_READ: true
---

如果我說「讀我的筆記」,請用 read 讀取 #file:./notes.md,再依內容回答。

可以說:

讀我的筆記,整理三點結論

#file:./notes.md 的 ./ 是相對於 ZeroType 的設定資料夾(Windows 是 %LOCALAPPDATA%\ZeroType,macOS 是 ~/Library/Application Support/ZeroType)。也可以給絕對路徑、file:// 連結或 Markdown 連結指向的本機檔案。單次最多讀 16,384 bytes,超過會被截斷。

read 不讀 http://、https:// 網址,也不讀資料夾。一般相對路徑(例如只寫 notes.md)不會被當成檔案路徑解析。

run_shell

---
ENABLE_RUN_SHELL: true
ENABLE_TOOL_FINAL_OUTPUT: true
---

這是 shell 專用模式。
只有當我明確說「執行」、「跑」、「run」或「execute」某個本機命令或腳本時,才可以使用 run_shell。
如果我只是詢問命令怎麼寫,請只輸出文字說明,不要執行。
如果命令結果對回答有幫助,請根據 tool result 回傳最終文字摘要。

可以說:

執行 shell 指令 pwd

或:

執行腳本 /Users/me/scripts/backup.sh

這是唯一會真的在你電腦上跑命令的工具,建議單獨放一份 USER-shell.md,不要混進日常提示詞。Windows 只用 pwsh;macOS 用 /bin/zsh,腳本檔一律以 zsh 執行,檔案開頭的 shebang 不會改變實際使用的 shell。

下一步

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