GitHub 在 2026 年 11 月 16 日公告,VS Code 1.146 已將 Local harness 標示為 deprecated,並預計在 2027 年 2 月移除。替代的 Microsoft Copilot harness 自 VS Code 1.143 起已是新 session 的預設。這裡的 harness 是協調模型、context 與 tools 的 agent runtime,不是把 VS Code 或本機程式碼整套搬到雲端;GitHub 明確說明,切換到 Copilot harness 後,仍可在本機執行 agent command。
受影響的不是所有 Copilot 自動補全使用者,而是仍選用 Local session target、用 vscode.temporaryDefaultToLocalHarness 企業例外,或依賴 Local 專用 agents、instructions、skills、MCP 與 hooks 行為的團隊。期限後設定例外也無法保留 Local harness,因此應在 2 月前完成相容性驗證,而不是只把 session picker 改成 Copilot。
先分清楚 runtime、執行位置與安全控制
Copilot harness 與 Copilot CLI、GitHub Copilot app 共用較一致的 agent runtime,能讓 repository 中的可攜客製化被多個 client 使用。agent 的 Agent Host process 仍可在本機運行,editor 提供的 tools 仍需要連線中的 editor。選擇新 harness 不等於檔案自動上傳,也不代表原本的權限模型原封不動。
企業管理者特別要注意:GitHub 說 Copilot harness 支援 Local harness 沒有的 managed runtime permissions 與 sandbox restrictions,但「選到 Copilot」不會自動啟用 sandbox。若舊環境把確認對話、hook 或 instruction 當作安全邊界,遷移後必須重新驗證 policy、tool permission、工作目錄與網路限制。
同樣地,指令能要求 agent 不做某件事,不代表平台層一定阻擋。對 production secret、雲端寫入與破壞性命令,仍應用最小權限 token、受保護環境、required review 與外部政策控管,而不是只靠 prompt。
客製化要搬到新的可攜位置
VS Code 的 migration view 會按 workspace 與 user scope 列出偵測到的項目。可直接轉換的項目可選 Migrate;需要語意修改或 repository 工作的項目可用 Migrate with Agent,但會使用 Copilot credits。官方文件指出,後者會先建立 recovery bundle、預設保留來源檔,且清理來源前會另外詢問。手動 review 的項目則應由負責人理解差異後再改。
核心原則是把客製化移到 Copilot folders 與可攜格式,讓 VS Code、Copilot CLI 與其他支援 client 讀到同一份 repository 設定。搬移完成後先保留備份;若新舊副本同時被讀取,可能出現重複 instruction、重複 server 或 hook 執行兩次。來源只能在驗收成功後移除。
盤點時至少分成五類:custom agents、instructions、skills、MCP servers 與 hooks。不要只搜尋 .vscode;還要檢查使用者 profile、額外自訂 location、Dev Container、remote host 與企業派送的 managed settings。workspace 設定應判斷是否適合進版控,user secret 與個人路徑則不能直接提交。
MCP 遷移要測能力,不只測能啟動
官方遷移文件列出的 MCP 目標位置是:workspace 的 .vscode/mcp.json 移至 workspace root 的 .mcp.json;VS Code profile 的 MCP 設定移至 $COPILOT_HOME/mcp-config.json,未設定 COPILOT_HOME 時通常是 ~/.copilot/mcp-config.json。remote 或 Dev Container session 的路徑與使用者設定,屬於實際執行 agent 的 machine 或 container,不能拿本機路徑直接套用。
自動遷移可能移除 registry version、development mode、更新資訊或每個 server 的 sandbox metadata。editor sampling、prompt、resource、interactive UI 等能力也不保證等價。驗收時要逐一測 authentication、tools、resources、prompt、sampling 與錯誤處理,而不是只看到 server 顯示 connected。
共享 .mcp.json 前,先檢查是否含 token、絕對使用者路徑或內網 endpoint。secret 應透過受支援的環境或 secret manager 注入,並為每個 server 限制可用工具與下游權限。遷移後刻意測試一個未授權操作,確認拒絕路徑仍有效。
Hooks 不能只改事件名稱
Local 與 Copilot command hooks 的事件與 payload 不完全相同。官方文件舉例,Local 的 PreToolUse 對應 Copilot 的 preToolUse,欄位可能從 tool_name 變成 toolName,timeout、matcher 與輸出 envelope 也有差異。Local 常見的 hookSpecificOutput 不能假設在新 runtime 原樣可用。
最安全做法是保留原 script,建立名稱不同的新版本,並先用不會被自動發現的 .disabled 設定測試。選一個無害工具,記錄實際 event payload,再驗證 allow、ask、deny、timeout、失敗與非互動 session。不要把未知欄位直接插入 shell command,也不要把 hook 回傳「ask」視為無人值守環境一定會暫停;官方文件特別提醒,互動批准與 fail-open timeout 需要分開評估。
三階段完成遷移與回滾
第一階段建立清冊:找出仍使用 Local 的成員、workspace、企業政策、客製化檔案與執行主機。用 VS Code 1.146 的 migration view 匯出待處理項目,指定 owner,並保留目前可工作的設定與版本。第二階段選低風險 repository,以 Copilot session target 執行固定任務,驗證 context、tool permission、MCP、hook、測試與 diff review。
第三階段分批移除 vscode.temporaryDefaultToLocalHarness 例外,更新內部教學與 onboarding,並用一般成員帳號驗證 managed policy。回滾是在 2027 年 2 月前暫時切回 Local、恢復備份並修正轉換;期限之後的備援應是停用有問題的客製化、改走人工流程或使用已驗證的 Copilot 設定,不能把 Local 當永久方案。
完成條件不只是新 session 能聊天,而是同一組代表性任務在新的 runtime 下具備可預期 context、最小權限、可審查工具呼叫與可靠失敗路徑。這次退場提供約三個月窗口;先把客製化變成可攜、可測、可回滾的 repository 資產,會比截止日前臨時切換 session target 更能降低開發中斷。