doctor 找出原因。
doctor 依相依順序逐一檢查 dev 工作階段的控制通道環節——從磁碟上的就緒契約一路到對擴充功能內執行器的即時探測——並指出第一個失敗的環節與具體修復方式,而不是讓你面對每個指令各自的死巷錯誤。
何時使用 doctor
extension logs或某個 act verb 連不上,你想知道是哪個環節斷了。- agent 或指令稿透過
ready.json驅動工作階段,需要機器可讀的健康檢查。 - dev 工作階段看起來還活著,但擴充功能不再回應。
用法
參數與 flag
檢查內容
檢查依相依順序執行。某個環節失敗時,依賴它的後續檢查會標成 skip,並註明被哪個檢查擋住——skip 不等於通過。
pretty 輸出每個檢查印出一行,並附上第一個失敗檢查的修復建議。全部通過時結束碼為
0,任一檢查失敗時為 1,CI 與指令稿可以直接據此把關。
機器可讀輸出
--output json 會把檢查結果印成 JSON 陣列,每個檢查一個物件:
status 為 pass、fail 或 skip;有已知修復方式的失敗會帶 remediation。
典型流程
- 啟動工作階段:
extension dev --browser=chromium --allow-control(需要 eval verb 時加上--allow-eval)。 - 後續指令連不上時,在同一個專案根目錄執行
extension doctor。 - 依第一個失敗檢查給的修復建議處理,然後再次執行
doctor確認。