在檢視 WinDbg 中 AI 發起的除錯器動作時,使用 WinDbg MCP 調查支援的 AI 用戶端的除錯目標。 WinDbg MCP 使用模型上下文協定(MCP),在分析時為客戶端提供 WinDbg 除錯工具與上下文。
AI 產生的結果並不具權威性。 將發現、證據、假設、目標狀態與指令,與 WinDbg 中的輸出結果進行比對驗證。
本文說明如何使用 GitHub Copilot 或 GitHub Copilot CLI 在 Visual Studio Code 中註冊 WinDbg,將所選客戶端連接到預定的 WinDbg 工作階段,並利用該連線進行 AI 輔助除錯。
Prerequisites
- 確認你的組織是否允許 WinDbg MCP。 管理員可以透過啟用 WinDbg 限制模式來停用它。
- 可從 Microsoft Store 的 WinDbg 應用程式或 WinDbg 下載下載 WinDbg 版本 1.2610.1001.0 或更新版本。
- 以下支援的 AI 用戶端之一:
- Visual Studio Code 與 GitHub Copilot
- GitHub Copilot 命令列界面 (CLI)
- 授權將除錯目標及其資料與所選 AI 客戶端及其已設定的模型服務搭配使用。
- 回顧 WinDbg MCP 概述中安全性、隱私與會話限制指引。
安裝並啟用 WinDbg MCP
在此區段中,你用所選的 AI 客戶端註冊 WinDbg 為 MCP 伺服器,啟動目前 WinDbg 會話的 MCP 服務,預設啟用安全模式,並將客戶端連接到除錯目標,以便開始 AI 輔助分析。 你不需要載入或附加到除錯目標,就能啟用伺服器或將 WinDbg 註冊到支援的 AI 客戶端。
要安裝並啟用 MCP 伺服器,請依照以下步驟操作:
開啟 WinDbg。 要開啟它,請在開始選單中搜尋 WinDbg 並選擇它。
從 WinDbg 檔案 選單中,選擇 設定。
在設定頁面,選擇 MCP 服務設定,選擇 啟用伺服器,然後在 用戶端 清單中選擇你的用戶端。 若您使用搭配 GitHub Copilot 的 Visual Studio Code,請選取 VS Code;若您使用 GitHub Copilot CLI,請選取 GitHub Copilot CLI。
使用 WinDbg 功能區中的編號控制項來安裝伺服器、啟動服務並開啟用戶端。
選擇 安裝 MCP (1) 以將 WinDbg 註冊為所選客戶端的 MCP 伺服器,並完成客戶端顯示的任何確認。 通知確認 WinDbg 已向所選客戶端註冊 MCP 伺服器。
選擇 MCP 服務 (2) 以啟動目前 WinDbg 會話的 MCP 伺服器。 在 隱私與安全警告中,請檢視以下安全模式的行為:
- 預設: WinDbg 預設在 MCP 伺服器啟動時選擇啟用安全模式 。
- 啟動: 如果你在 MCP 伺服器啟動時讓該核取方塊保持選取,安全模式就會啟動。 啟用後,安全模式無法關閉,且會持續運作直到 WinDbg 重啟。
- 已儲存的設定: 清除或選取核取方塊後,會更新已儲存的 檔案>設定>MCP 服務設定>啟用 MCP 伺服器安全模式 設定,使其與核取方塊狀態相符。
確認你授權將指定除錯目標及其資料供所選 AI 客戶端及其已設定的模型服務使用,然後選擇 「是」。
WinDbg 隱私與安全警告說明,啟動 MCP 伺服器可能會將敏感的除錯目標資訊暴露給不受信任的第三方。 它警告不要使用伺服器處理你不擁有或未獲授權揭露的個人、機密、專有或其他資料。 AI 驅動的除錯操作可能直接或間接載入或執行不受信任的程式碼,這可能導致安全性受損、資料受損或損害系統或裝置。 安全模式透過限制可載入或執行不受信任程式碼、啟動程序或執行不安全檔案操作的除錯器操作,來降低這些風險。 WinDbg 預設會選擇 **MCP 伺服器啟動時啟用安全模式**核取方塊。 安全模式在伺服器啟動時啟動,並持續運作直到 WinDbg 重新啟動。 取消勾選此核取方塊會變更已儲存的 MCP 服務設定。 選擇 **Yes** 即為確認警告並啟動伺服器;選擇 **No** 會取消該操作。
欲了解更多安全模式資訊,請參閱 安全模式。
載入或附加到除錯目標上。
選擇 開啟聊天 (3)以開啟所選的 AI 客戶端並開始聊天。
驗證 WinDbg MCP 連線
確認 WinDbg 狀態列顯示 AI 用戶端已連接到 MCP 伺服器。
確認 WinDbg MCP 是否存在於 AI 用戶端。
輸入下列提示:
Use WinDbg MCP to report the current target type and execution state.確認 AI 用戶端使用 WinDbg MCP 工具,並回報 WinDbg 顯示的目標類型與執行狀態。
如果用戶端無法連線或結果與目標不符,請參閱「 故障排除 WinDbg MCP 設定與連線問題」。
使用 WinDbg MCP 分析除錯目標
確認連線後,試試立即的分析提示:
Analyze this debugging target and provide the likely cause, supporting evidence, and remaining assumptions.
在採取行動前,先將 AI 客戶端的結果與目標狀態及可視除錯器的輸出做比較。 關於可用的工具與內建提示,請參見 WinDbg MCP 工具與提示。 如需瞭解支援的情境,請參閱 使用 WinDbg MCP 進行除錯。
撰寫有效的 WinDbg MCP 提示
給 AI 客戶端足夠的上下文,讓他們選擇合適的 WinDbg MCP 工具,並產生可驗證的結果:
- 識別除錯目標與任務,例如分析當機傾印、調查即時目標,或檢視 Time Travel Debugging 追蹤。
- 要求提供支持證據和剩下的假設,而不僅僅是結論。
- 當你需要特定分析時,請請求相關的除錯指令、診斷、原始碼審查或腳本。
- 指定輸出格式,例如樹狀、網格、圖形或有序的調查計畫。
- 在採取行動前,先將結果與目標狀態、指令及 WinDbg 中可見的除錯器輸出做比較。
管理 WinDbg 工作階段
這些程序假設你完成設定、開啟支援的 AI 客戶端聊天、確認 WinDbg MCP 是否可用,並在每個你想要使用的 WinDbg 視窗中啟動 MCP 服務。 透過 AI 用戶端聊天請求會話選擇指令;不要直接在 WinDBG 輸入工具名稱。
當 WinDbg MCP 代理偵測到恰好一個可用的 WinDbg 會話時,會自動連線。 若有多個會話可用,AI 用戶端會保持斷線,直到你選擇會話。
當多個 WinDbg 會話可用時,連接 AI 客戶端
當多個 WinDbg 會話可用且 AI 用戶端未連接其中一個時,請使用此程序。 流程結束後,客戶端會連接到所選的工作階段。
- 要求 AI 用戶端使用
list_sessions。 - 在結果中識別預期 WinDbg 會話的程序 ID。
- 請 AI 客戶端使用該程序 ID 搭配
connect_session。 - 確認用戶端回報已連線到預期的工作階段,且其目標狀態與所選的 WinDbg 視窗相符。
將 AI 用戶端切換到另一個 WinDbg 會話
當 AI 用戶端連接到一個 WinDbg 會話,而你想讓它使用另一個會話時,請使用此程序。 程序結束後,客戶端會從原始會話中斷連線,並連接到所選的替代工作階段。
- 請要求 AI 用戶端使用
disconnect_session。 - 要求 AI 客戶端使用
list_sessions。 - 找出新 WinDbg 工作階段的處理程序識別碼。
- 請 AI 客戶端使用該程序 ID 搭配
connect_session。 - 確認用戶端是否回報與新會話的連線,並根據所選的 WinDbg 視窗驗證其目標類型與執行狀態。
將 AI 用戶端從目前的 WinDbg 會話中斷開
當 AI 用戶端連接到 WinDbg 會話,且你想終止該連線時,請使用此程序。 操作完成後,用戶端未連線到 WinDbg 工作階段;WinDbg 和 MCP 服務 可以繼續運作。
- 要求 AI 用戶端使用
disconnect_session。 - 確認客戶端回報代理已與 WinDbg 會話斷開連線。
同一時間只能有一個活躍的 MCP 用戶端連線到一個 WinDbg 工作階段。 如果某個會話無法使用,請將另一個 AI 用戶端從該會話中斷開,然後再連接預期的用戶端。