終端機啟動器 是做什麼的?
使用 scripts/open-terminal.js 將可執行檔與每個引數保留為獨立的程序項目。請勿內插 Shell 命令字串。所有 spawn 都保持 shell: false。預設為非啟動計畫。僅在使用者明確要求實際視窗且 argv 已審查後才使用 --launch。啟動的程序會繼承呼叫程序的完整環境,包括包含秘密的變數。啟動器不會過濾環境。請在一個環境對目標命令安全的 Shell 中執行它。
啟動命令
在 -- 之前傳遞啟動器選項,然後傳遞一個可執行檔及其引數陣列:
node skills/terminal-opener/scripts/open-terminal.js \
--launch \
--cwd /absolute/host/path \
-- ssh -t example.test command-with-arguments
先執行普通模式。讓 WezTerm 嘗試其多工器並開啟新視窗,如果多工器不可用,則讓啟動器回退到分離的 wezterm start 程序。當使用回退時,從 JSON 輸出(或可讀的失敗行)讀取 muxFailure,以診斷多工器路徑失敗的原因。
從終端機組態恢復
當使用者組態或多工器狀態可能干擾請求的命令時,加入 --recover 或 --standalone。使用以下指令啟動分離的 WezTerm 程序:
--skip-config start --always-new-process
預期恢復模式會有意跳過所有使用者終端機組態。
啟動前檢查
省略 --launch(或加入 --dry-run)並加入 --json,以檢查確切的可執行檔、argv、工作目錄、終端機適配器、主要啟動與回退,而不開啟視窗。將 JSON 計畫視為呼叫者的組合邊界。
在沒有命令的情況下執行 --detect --json 以探查終端機可用性。當適配器缺失或不受支援時,請遵循傳回的 action。對目前適配器使用 WezTerm;將其他請求的終端機視為不受支援的計畫,而不是要執行的命令。