VS Code 本地 Web 工作台
在本地 vscode.dev 中验证 VS Code 工作台和 Agents 窗口改动。
技能限定在本地 sibling checkout、127.0.0.1 服务和可选本地 mock agent;明确说明 mock 模式绕过 GitHub 认证及 hosts API,具备一定数据流透明度。扣分:未要求运行命令前确认,未说明本地 WebSocket、文件访问及 npm 构建的权限边界,也未提供停止服务、清理构建产物或恢复方案;仍依赖本地工作区和浏览器工具。
路径、工作目录、端口、URL、前置构建、首次编译竞态、缓存问题及常见失败均有具体说明,脚本之间基本一致。扣分:依赖未提供的 vscode-dev 仓库、已安装依赖和 out/产物,命令及日志仅作静态描述,未执行验证;异常覆盖和失败诊断仍有限,因此不超过静态上限10。
目标用户和场景清楚,覆盖 workbench、Agents window、mock agent、移动模拟及缓存刷新,并说明 Agents 场景的非适用条件。扣分:未明确完整的非适用范围、浏览器工具能力边界或中文使用说明;常规安装和构建可能需要海外 npm/GitHub 资源,虽 mock 核心交互可离线,环境适配证据仍不足。
文档结构清晰,按布局、启动、URL、交互、缓存、噪声、排障和 mock agent 渐进展开,包含命令、参数、预期日志和故障表。扣分:技能本身没有版本、变更记录、维护责任、更新路径、安装依赖说明或 FAQ;MIT、Microsoft provenance 和仓库治理可由共享材料支持,但并非该 SKILL.md 的完整维护声明。
技能直接给出启动服务、访问 URL、浏览器交互、缓存清理和 mock agent 配置步骤,预期日志使结果具有可操作性。扣分:未静态证明 vscode-dev 路由、协议版本、mock binary 或浏览器工具实际可用;仍需用户准备第二仓库、构建产物和环境,静态评估下只能接近但不超过效果上限7。
提供了可复现的目录布局、绝对路径建议、命令、URL、环境变量、预期日志和指向源码文件的名称,具备有限审计线索。扣分:没有提交的专门测试、实际运行记录或独立交叉验证,所附 CI 材料也不覆盖该 skill 的关键路径;按静态证据只能给有限分数,低于上限5。
- 运行 npm、Node agent host 和浏览器服务会产生本地进程、构建产物和网络监听;使用前应确认目录、端口及工作区无敏感数据,并补充停止与清理步骤。
- 该技能依赖 sibling 的 vscode-dev 仓库、vscode 的 out/构建产物及浏览器工具;缺失任一项时不能直接运行。
- 普通依赖安装或首次构建可能访问海外 npm/GitHub 资源;中国大陆网络环境下应预先准备缓存、镜像或离线依赖,不能将 mock 模式的离线能力推广到完整安装流程。
它能做什么 & 适用场景
这个技能用于通过本地运行的 vscode.dev 服务,加载相邻的 microsoft/vscode 源码并操作 VS Code Web 工作台。它覆盖开发服务器启动、vscode-quality=dev URL、浏览器交互,以及可选的本地模拟 Agent 主机。vscode-dev 和 vscode 必须位于同一工作根目录下的相邻文件夹中。它适合需要验证 Web-only 工作台改动的开发者,但不适合只想安装或使用桌面版 VS Code 的用户。
从相邻的 microsoft/vscode checkout 提供本地 VS Code Web 工作台或 /agents Agents 窗口;在 vscode-dev 文件夹中运行 npm run dev,并通过 https://127.0.0.1:3000 提供服务;使用带有 ?vscode-quality=dev 的 URL 选择本地开发源码;通过浏览器工具点击、输入和发送聊天内容;在重建后注销 service worker 并清理缓存以避免旧资源;可选地运行 vscode 中的 agentHostServerMain.js,以 WebSocket 模拟 Agent 主机并为 Agents 窗口提供预置或脚本化会话。
- 正在修改 VS Code Web 工作台的开发者,需要在发布 Insiders 构建前直接验证本地源码。
- 需要测试 Agents 窗口交互的开发者,希望使用本地 mock agent host 绕过 GitHub 登录和隧道发现。
- 使用浏览器自动化验证聊天输入、发送按钮或工作台行为的工程师。
- 修改 vscode 源码后发现页面仍显示旧界面的开发者,需要清理 service worker 和缓存再重新加载。
优缺点一览
- 直接针对相邻 vscode 源码提供本地 Web 工作台,适合快速验证 Web-only 改动。
- 同时覆盖主工作台和 /agents Agents 窗口。
- 本地 mock agent host 可绕过 GitHub 认证和 /agents/api/hosts 端点,支持离线场景。
- 提供聊天发送、缓存清理、移动设备模拟和常见故障的具体操作说明。
- 必须同时准备 vscode-dev 和 vscode 两个相邻 checkout,不能只依赖当前 microsoft/vscode 仓库。
- 启动命令必须在 vscode-dev 文件夹执行;在 vscode 文件夹执行会因缺少 dev 脚本而失败。
- Agents 窗口通常需要额外启动 mock agent host,而且 vscode/out 必须已生成相关构建产物。
- 集成浏览器的真实移动端视口受面板宽度限制;源码没有提供独立的安装器、版本要求或测试套件说明。
如何安装
该源码没有记录独立的技能安装器或安装命令。使用时需要准备 microsoft/vscode checkout 和 vscode-dev checkout,并按以下布局放置:<workRoot>/vscode/ 和 <workRoot>/vscode-dev/。技能文件位于 microsoft/vscode 的 .github/skills/vscode-dev-workbench/SKILL.md。README 说明整个 microsoft/vscode 仓库采用 MIT 许可证;本技能的单独安装步骤未被说明。
如何使用
先在 vscode-dev 文件夹运行:
cd /path/to/vscode-dev
npm run dev
也可以使用:
pushd /absolute/path/to/vscode-dev >/dev/null && pwd && npm run dev
服务就绪后打开 https://127.0.0.1:3000/?vscode-quality=dev;Agents 窗口使用 https://127.0.0.1:3000/agents?vscode-quality=dev。若测试 Agents 窗口,另开终端在 vscode 文件夹运行:
cd /path/to/vscode
node out/vs/platform/agentHost/node/agentHostServerMain.js --enable-mock-agent --quiet --without-connection-token --port 8765
然后打开 https://127.0.0.1:3000/agents?vscode-quality=dev&mock-agent-host=ws://localhost:8765&vscode-log=trace。若首次启动出现 Cannot find module './indexes',等待 watcher 完成编译并自动重启;如果 vscode/out 中缺少 agentHostServerMain.js,先运行 VS Code - Build 任务或 npm run watch。