GitHub 2026 年 11 月 16 日(北京时间 11 月 17 日凌晨)发布的变更公告时,我第一反应也是心里一紧。公告里写着 VS Code 1.146 正式弃用 Local harness,计划在 2027 年 2 月彻底移除。平时我主力用 VS Code 维护本地 PHP 和 Node 项目,终端命令、MCP 服务和 hooks 都配好了,看到 Local 要下线,难免会担心本地开发流是不是要整体迁到云端。
通读了一遍官方迁移文档后,悬着的心,没死,终于放下了。先把最关键的结论放在前面,这次调整改变的只是 AI Agent 的执行协调层,不等于取消 VS Code 本地执行,更不等于代码和数据库必须搬到云端。本机照样可以跑构建、起服务、跑测试,真正需要我们花时间核对的,是工具、认证凭据、终端路径、Agent Host 进程和沙箱状态有没有跟着平稳接管。
好消息就是,Local 退役,退役的是 harness 协调层,不是本机上的开发环境。
先分清四层架构,别把协调层当成运行环境
刚看到退役消息时,很多人和我一开始一样,容易把执行协调层直接当成本地运行环境。其实把日常用到的 AI 辅助开发拆开来看,里面包含模型、Harness、执行机器和项目环境四个完全不同的层级。
| 架构层级 | 承担的职责 | 这次调整带来的变化 |
|---|---|---|
| 模型 | 理解需求、推理逻辑并生成代码 | 涉及部分旧模型退役与列表更新 |
| Harness | 协调上下文、调度工具调用、处理审批流并维持会话 | Local harness 被弃用,由内置 Copilot harness 接替 |
| 执行机器 | 实际运行命令、脚本和后台进程的设备 | 依然可以使用我们自己的电脑,不用搬到云端 |
| 项目环境 | PHP、Node.js 运行时、本地数据库、依赖包与配置文件 | 留在本地原处,不会因为切换选项自动搬迁 |
把这四层拆开理顺,焦虑就少了一大半。Harness 既不是大模型本身,也不是远程服务器,更不是本地数据库或语言运行时。我在会话选项里切一下 harness,换掉的只是中间协调上下文和工具的软件层,本机硬盘里的项目文件不会因此自动挪窝。
VS Code 官方时间线和 Copilot harness 的接替关系
理清了概念边界,再来看具体的时间节点和替代方案,方便自己安排 Local harness 迁移的节奏。
Local harness 的弃用与移除节点
按照 GitHub 的官方公告,VS Code 1.146 已经把 Local harness 标为弃用状态,最终移除窗口定在 2027 年 2 月。如果公司策略没有禁用,过渡期内虽然还能临时切回去用,但新能力和稳定性修复都会往新协调层集中。
同时要注意,企业级临时默认配置 vscode.temporaryDefaultToLocalHarness 也会在 2027 年 2 月一并移除。与其依赖临时开关拖延,不如早点把配置迁过来。
Copilot harness 承担了什么角色
接棒的是已经内置在 VS Code 里的 Copilot harness,从 VS Code 1.143 开始,它就是新建会话时的默认选项。它基于 Copilot SDK 构建,和 Copilot CLI 以及 GitHub Copilot app 共享同一套编码 Agent 运行时,我不用单独再装一遍 CLI 或 SDK 就能直接用。
对我这种习惯同时开着编辑器和 Agents 窗口干活的人来说,共享运行时最大的好处是同一条会话可以在不同窗口之间接续。另外我确认了一下,既有订阅包括 Copilot Free 都能继续用,只是具体开放哪些功能要看套餐和组织策略,像 connectors 和 canvases 目前还有预览标记,云端沙箱会话则还处于实验阶段。
切过去之后,哪些本地开发习惯不用改
对每天都要改业务代码、连本地测试库的人来说,最关心的还是手头正在跑的工作流会不会断掉。对照官方指南来看,下面三块基础能力在切换后都会原样保留。
本地命令和构建脚本照常跑
只要会话连的还是我本机环境,平时常用的本地命令和调试脚本都可以继续交给 Agent 触发,比如每天都会敲的那几条指令
php artisan serve
npm run dev
npm test
前提也很明确,Agent 会话必须运行在本地机器上,终端路径和执行权限维持正常,并且组织策略没有把这些操作拦下来。
项目代码和数据库依然留在本地
在聊天界面的 Session Target 下拉选项里选中 Copilot,只是换了协调层,并不等于把项目传到云端。仓库代码、本地 .env 文件以及数据库目录依然待在本机原来的路径里,读写速度和使用方式都不会变。
本地服务底座继续配合使用
在 GitHub Copilot 本地开发场景中,各层职责分得很清楚。拿我平时搭配使用的 ServBay 来说,它稳稳托住本地的多版本 PHP、Node.js 和各类数据库服务;而 Copilot harness 专心负责上下文整理和任务协调。两者根本不在同一个层级上,谈不上谁替代谁,继续打配合就行。
真正需要迁移和逐项检查的四个地方
代码和环境不用搬家,不代表点一下切换选项就万事大吉。协调层换了之后,后台进程依赖、密钥传递和配置目录都会有细微差别。下面这四个环节是我梳理下来最容易踩坑的地方,迁移时一定要逐个核对。
确认 Agent Host 进程一直在线
VS Code Agent Host 是撑起跨窗口会话的后台进程。以前习惯在编辑器 Chat 视图点击 Open in Agents,或者反过来点击 Open in Editor 接续同一条任务,背后靠的就是它。
本地跑长任务的时候得留心两点。一是千万别直接关掉 VS Code 或休眠电脑,进程一旦断掉,会话就接不上了;二是很多由编辑器扩展提供的工具,必须连着打开的编辑器窗口才能正常调用。
核查 MCP servers 配置和鉴权凭据
项目里如果重度依赖 Copilot MCP 兼容能力,切换后不能只看列表里有没有名字。我会先通过命令面板打开 Chat: Open Customizations,切到 Tools 面板,亲眼确认需要的工具确实加载进了 Copilot 会话。
更麻烦的是认证信息。如果旧配置里用到了 ${input:...} 或 ${command:...} 这类占位符,以前存在编辑器里的密钥和输入状态不会自动带过来。遇到工具连不上时,要按新方式重新补全鉴权配置,千万别为了省事把明文密钥直接写进仓库配置文件。另外,只读和写入权限的划分,以及组织有没有限制 MCP 来源,也都要顺手看一眼。
梳理 hooks、skills、custom agents 和记忆文件
这部分最容易被忽略,因为并不是所有旧配置都能一键自动转换。在 VS Code 1.146 里打开 Chat: Open Customizations 后,点进 Migrations 标签页能看到官方扫描出来的迁移提示,剩下还得自己手工对照处理几件事
-
Prompt files:原来的提示词文件要转换成 skills 格式,转完之后必须点进去再核对一遍原本绑定的 agent、模型和工具列表还在不在。
-
个人配置目录:以前存在编辑器个人配置档里的 agents、instructions 和 skills,如果想在脱离编辑器窗口时也能生效,得挪到 Copilot harness 原生支持的路径下。
-
Hooks 脚本:hooks 目前没有自动转换工具,只能自己一个个检查触发事件是否支持、脚本的输入输出对不对、报错后怎么处理,以及新协调层下要不要重新点一遍审批确认。
-
记忆文件:旧版 Local harness 存下的记忆文件和 Copilot Memory 是两套完全独立的系统,切过来不会自动转换历史记忆。团队共用的规范还是老老实实写进受版本控制的 instructions 或 skills 文件里更稳当。
改之前记得先备份一份老配置,迁移跑通之后再把多余的旧副本清掉,免得新旧两份规则互相打架。
验证终端初始化和沙箱真实状态
千万不要以为切到了 Copilot harness,沙箱保护就自动打开了。沙箱开关 chat.agent.sandbox.enabled 不会自己打开,必须看本地设置或企业下发的策略。
真想心里有底,不能光看界面上的选项,建议直接在 Copilot 会话框里输入 /sandbox policy,看一眼当前生效的执行主机、文件读写边界和网络限制,再顺手从命令面板跑一次 Developer: Policy Diagnostics 确认策略来源。像我项目里指定了特定版本的 PHP 和 Node 路径,也要确认新起出来的终端有没有完整加载 shell 初始化脚本。
企业插件来源管理,限制类别不等于自动放行
顺带看了一眼 GitHub 同天发的企业侧更新,做团队管理的同学可以留意一下。企业管理员现在可以通过托管设置 strictPluginOnlyCustomization,按类别限制成员加载零散的用户级或项目级配置,要求指定类别必须来自插件或企业托管配置。
受控的类别一共五个,分别是 skills、custom agents、hooks、MCP servers 以及可执行 Copilot extensions(这里指的是可执行的 canvas 提供方,不是 VS Code 插件市场里的普通扩展)。
不过这里有个很容易误解的点。开了来源分类限制,只代表必须是插件形式,绝不等于任何插件都自动通过了企业审批,它本身不是白名单。真要限定只准用哪些来源,还得配合 strictKnownMarketplaces 一起配置。而且这项功能只面向 GitHub Enterprise Cloud 下拿了 Business 或 Enterprise 许可证的成员,个人版用户不用往这方面套。
模型可用性调整,别和 harness 迁移混在一起
同样在 11 月 16 日生效的还有模型列表调整。如果升级完发现习惯的模型找不到了,先别急着怪 Copilot harness 出了 bug,这是两件独立的事。
这次在 Copilot 多数体验中退役了三款模型,分别是 Claude Opus 4.8、Claude Opus 5 和 GPT-5.6 Terra,官方建议依次改用 Claude Opus 5.5,以及 GPT-6.1 Sol 或 GPT-6 Luna。其中年度个人订阅里的 Claude Opus 4.8 存在例外权限;Claude Opus 5 虽然从选择器里拿掉了,但部分已授权的运行时还保留着拒绝回退路径。
所以这事不能一刀切地说成全球 API 全停了,具体能不能用还得看账号订阅、运行时以及公司有没有配模型限制策略。如果最近打算录教程或者写团队迁移文档,发之前最好用实际账号重新截图确认一遍当前模型列表。
用一次最小对照实验,验证工作流有没有真正接管
为了避免直接切主力项目翻车,我打算先做一次最小对照实验,把整条本地研发链路跑通了再正式切换。
先搭一个干净的实验环境
准备一台升级到 VS Code 1.146 的电脑,登上有权限的 Copilot 账号,挑一个完全不含敏感数据的 PHP 或 Node 样例仓库。动手前先把本机用户级和项目级的 MCP、hooks 以及其他自定义配置完整备份一遍。
跑一遍五步对照任务
先记录好旧工作流下的基线表现,然后新建一个 Session Target 选为 Copilot 的会话,按顺序跑下面五件事
-
让 Agent 在终端里拉起本地服务,比如
php artisan serve或npm run dev,确认端口正常监听。 -
触发一次只读性质的 MCP 工具调用,验证外部上下文能不能顺利拿到。
-
挑一个小问题让它改几行代码。
-
运行项目自带的测试命令,比如
npm test,直接盯紧终端里的真实测试输出。 -
观察执行命令时的审批弹窗正不正常,敲一句
/sandbox policy看下沙箱边界;如果团队开启了沙箱策略,还可以配合测一个正常允许的操作和一个预期被拦截的操作。
如果是企业管理员准备在 VS Code 1.143 及以上版本里统一推进迁移、清理临时豁免开关,可以在企业托管配置(不是个人或工作区 settings.json)里加上下面这段配置
{
"vscode": {
"temporaryAllowLocalHarness": false,
"temporaryDefaultToLocalHarness": false
}
}
记好实验数据和验收标准
跑实验的时候,建议顺手记下这九项数据,方便后面团队内部对齐。包括 VS Code 版本号、当前 Session Target、Agent Host 状态、终端实际拿到的 PATH 路径、会话里看到的 MCP 工具清单、沙箱是否真正生效、本地服务能不能启动、测试跑通没有,以及整个配置核对花了多少时间。
只有服务能拉起来、核心命令能执行、MCP 工具能加载、测试全部通过,同时审批和沙箱状态跟预期或组织策略完全一致,才算真正迁移成功。只看下拉框切过去了就收工,后面干活时早晚要返工。
常见误解与准确表述对照
为了方便跟团队小伙伴同步进度,我把这几天容易传走样的几个说法整理成了对照表
| 容易传偏的说法 | 更准确的实际情况 |
|---|---|
| Local harness 退役后就不能在本地写代码了 | 本地执行能力照常保留,只是要验证新协调层下的连接和权限 |
| 切过去之后代码和数据库会自动搬到云端 | 切换 Session Target 不会自动挪动任何本地文件 |
| Copilot harness 就是云端远程运行环境 | Harness 只是协调层,任务跑在哪台机器取决于当前执行主机和会话配置 |
| 企业开了来源限制就等于配好了插件白名单 | 来源类别限制和可信市场白名单是两项独立配置,要配合使用 |
| 所有 Copilot 模型和 API 都停用了 | 模型退役面向多数常规体验,具体能不能用看订阅、运行时和组织策略 |
| 界面上选中 Copilot harness 就代表迁移完成了 | 必须实测跑通本地服务、MCP 工具、测试命令、沙箱和审批流才算验收通过 |
接下来怎么办
离 2027 年 2 月还有一段缓冲期,完全不用慌。按我自己的节奏,会分三步走完这件事。第一步先排查现有项目有没有依赖 Local harness 的旧目录、老记忆文件或复杂的 hooks;第二步拿一个无敏感数据的 PHP 或 Node 样例跑通最小验证;第三步结合组织策略、MCP 鉴权方式和最新的模型清单,把迁移记录沉淀成团队文档。
说到底,对我们维护老项目的人来说,迁移成不成功,看的是服务能不能起、工具能不能调、测试能不能过,而不是界面上还留没留着 Local 这几个字母。