使用文件 / 工具呼叫

工具的安全邊界

工具是副作用,不是文字輸出。先看懂開網頁、按鍵、剪貼簿與執行命令各自的風險,再決定要開哪幾個。

最後更新

工具是副作用

文字輸出做錯了,你改一下就好。工具做錯了,是電腦上真的發生了某件事:網頁開了、按鍵送出去了、命令跑了。

所以 ZeroType 把工具預設全部關閉,而且要由「目前選取的那份提示詞」明確開啟。這件事不是多一道手續,而是唯一的授權機制。

風險一覽

工具 實際發生的事 可能出錯的地方
google_search、find_youtube、ask_chatgpt、ask_gemini 在瀏覽器開啟分頁,後兩者會自動送出問題 你只是想把那句話記下來,卻變成一次公開的搜尋紀錄
open_app、open_url 啟動程式或開啟網址 開錯程式;開到不是你預期的網址
send_keys 對目前前景視窗送出快捷鍵 焦點跑掉時,快捷鍵送給別的視窗,例如在別的視窗按了 Ctrl+W
smart_paste 寫入剪貼簿、送出貼上、再還原 貼到錯誤的位置;剪貼簿內容被其他程式讀走
read 讀取本機檔案並交給模型 讀到含密碼、金鑰或個資的檔案,內容進了 API 請求
run_shell 真的執行命令或腳本 刪檔、推送、部署、寄信——做完就回不去了

從最小權限開始

第一次用只開兩個低風險工具就好:

---
ENABLE_GOOGLE_SEARCH: true
ENABLE_OPEN_URL: true
---

請將轉錄內容整理成自然繁體中文。
如果我明確要求搜尋,請使用 google_search。
如果我提供明確 URL 並要求打開,請使用 open_url。
其他情況不要使用工具。

熟悉之後,再依序加上 find_youtube、ask_chatgpt、ask_gemini、open_app,最後才是 send_keys、smart_paste 與 read。

run_shell 建議永遠單獨放一份 USER-shell.md,要用的時候才切換過去。把最危險的工具和日常輸入放在同一份提示詞裡,等於每天都開著它。

run_shell 的額外警告

run_shell 是唯一會在你電腦上執行任意命令的工具。開啟它之前請確認三件事:

  1. 這份提示詞只有你自己用,而且內容你完全看得懂。
  2. 提示詞裡寫明「只有我明確說執行才可以用」,並要求模型在「只是問指令怎麼寫」時只輸出文字。
  3. 你知道它用哪個 shell:Windows 只用 pwsh,macOS 用 /bin/zsh。

Windows 沒有安裝 pwsh 時,run_shell 會直接回報不支援其他 shell,不會偷偷改用 Windows PowerShell 或 cmd。macOS 的腳本檔一律以 zsh 執行,檔案裡的 shebang 不會改變實際使用的 shell,若要 bash 語意必須自己指定。

命令回傳非零結束碼時,這次處理會被視為失敗並留下工具紀錄,ZeroType 會改用處理後的轉錄文字輸出,不會卡在錯誤狀態。但若某些命令真的執行到一半,它不會幫你復原。

前景視窗是共用資源

send_keys 與 smart_paste 都是對「現在有焦點的那個視窗」動作。你在錄音前把游標放在哪裡,就決定了動作會送到哪裡。

實務上有兩個常見情況:

  • 錄音期間你切到別的視窗看資料,放開錄音鍵後貼上或按鍵就送到新視窗。
  • 貼上還沒完成你就按了下一個鍵,導致快捷鍵被下一個 App 收到。

smart_paste 會先備份剪貼簿、貼上、再還原。若原本的剪貼簿含無法安全備份的內容,Windows 會改用模擬鍵盤輸入,不再嘗試完整還原。少數情況下(系統很忙、有同步工具改寫剪貼簿)還原會被跳過,原本的剪貼簿內容可能被蓋掉。

你的輸出規則也會改到工具參數

ZeroType 在執行工具前,會對參數套用字形轉換與你的 FinalOutput 規則——包含 run_shell.script、open_url.url、open_app.app 與 read.path。

也就是說,如果你設了全域字串替換,某個命令、路徑或網址可能被改寫成另一個「看起來有效但不是你要的」值。啟用全域替換規則前,先確認它不會動到你會交給工具的那些字串。

重新轉錄不會再執行工具

從歷史記錄重新轉錄時,ZeroType 只重跑語音轉文字與 AI 校正,不會執行工具、不會輸入前景 App、也不會自動送出 Enter。同一個動作不會做第二次。

處理途中如果你再按一次錄音鍵,ZeroType 會取消還沒完成的工作。但如果某個副作用已經完成——網頁已經開了、文字已經貼上、命令已經跑完——取消不會把它收回來。

不確定就先不要開

如果你看到某份提示詞不太確定它會不會做危險動作,先不要在那份提示詞裡開工具。要驗證,可以先用一句明確的話測一次(例如「搜尋 Google 測試」),確認行為符合預期再繼續用。

下一步

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