Local harness 将退役,VS Code 本地开发要不要搬到云端?

0 阅读13分钟

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 协调层,不是本机上的开发环境。

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 或休眠电脑,进程一旦断掉,会话就接不上了;二是很多由编辑器扩展提供的工具,必须连着打开的编辑器窗口才能正常调用。

VS Code Agent Host

核查 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 的会话,按顺序跑下面五件事

  1. 让 Agent 在终端里拉起本地服务,比如 php artisan serve 或 npm run dev,确认端口正常监听。

  2. 触发一次只读性质的 MCP 工具调用,验证外部上下文能不能顺利拿到。

  3. 挑一个小问题让它改几行代码。

  4. 运行项目自带的测试命令,比如 npm test,直接盯紧终端里的真实测试输出。

  5. 观察执行命令时的审批弹窗正不正常,敲一句 /sandbox policy 看下沙箱边界;如果团队开启了沙箱策略,还可以配合测一个正常允许的操作和一个预期被拦截的操作。

如果是企业管理员准备在 VS Code 1.143 及以上版本里统一推进迁移、清理临时豁免开关,可以在企业托管配置(不是个人或工作区 settings.json)里加上下面这段配置

{
  "vscode": {
    "temporaryAllowLocalHarness": false,
    "temporaryDefaultToLocalHarness": false
  }
}

记好实验数据和验收标准

跑实验的时候,建议顺手记下这九项数据,方便后面团队内部对齐。包括 VS Code 版本号、当前 Session Target、Agent Host 状态、终端实际拿到的 PATH 路径、会话里看到的 MCP 工具清单、沙箱是否真正生效、本地服务能不能启动、测试跑通没有,以及整个配置核对花了多少时间。

只有服务能拉起来、核心命令能执行、MCP 工具能加载、测试全部通过,同时审批和沙箱状态跟预期或组织策略完全一致,才算真正迁移成功。只看下拉框切过去了就收工,后面干活时早晚要返工。

VS Code 本地开发

常见误解与准确表述对照

为了方便跟团队小伙伴同步进度,我把这几天容易传走样的几个说法整理成了对照表

容易传偏的说法更准确的实际情况
Local harness 退役后就不能在本地写代码了本地执行能力照常保留,只是要验证新协调层下的连接和权限
切过去之后代码和数据库会自动搬到云端切换 Session Target 不会自动挪动任何本地文件
Copilot harness 就是云端远程运行环境Harness 只是协调层,任务跑在哪台机器取决于当前执行主机和会话配置
企业开了来源限制就等于配好了插件白名单来源类别限制和可信市场白名单是两项独立配置,要配合使用
所有 Copilot 模型和 API 都停用了模型退役面向多数常规体验,具体能不能用看订阅、运行时和组织策略
界面上选中 Copilot harness 就代表迁移完成了必须实测跑通本地服务、MCP 工具、测试命令、沙箱和审批流才算验收通过

接下来怎么办

离 2027 年 2 月还有一段缓冲期,完全不用慌。按我自己的节奏,会分三步走完这件事。第一步先排查现有项目有没有依赖 Local harness 的旧目录、老记忆文件或复杂的 hooks;第二步拿一个无敏感数据的 PHP 或 Node 样例跑通最小验证;第三步结合组织策略、MCP 鉴权方式和最新的模型清单,把迁移记录沉淀成团队文档。

说到底,对我们维护老项目的人来说,迁移成不成功,看的是服务能不能起、工具能不能调、测试能不能过,而不是界面上还留没留着 Local 这几个字母。