Code OSS 启动与调试

这个 Skill 能做什么，适合哪些场景？

这是 microsoft/vscode 仓库中 .agents/skills/launch/ 下的单个技能，用于启动从源码构建的 Code OSS。它会把已认证的 Code OSS 用户数据目录复制到临时目录，分配独立的用户数据、扩展目录、共享数据目录和调试端口。启动完成后，它输出包含 CDP、扩展宿主、主进程和 Agent Host 端口的 JSON，便于使用 @playwright/cli 和 dap-cli。该技能适合 VS Code 本身的 UI 流程、聊天流程、截图和断点调试，但要求在 macOS 或 Linux 上具备完整构建环境和已认证的源用户配置。

技能通过相对于 SKILL.md 的 scripts/launch.sh 启动 Code OSS。启动器读取源码仓库和源用户数据目录，将认证配置复制到临时目录；默认采用精简复制，排除工作区存储、历史记录、日志、缓存和其他可再生成数据，同时保留认证所需的 OS keychain 和部分 User/globalStorage 内容。它为每次启动创建独立的 user-data-dir、extensions-dir、shared-data-dir 和临时运行目录，选择空闲的 CDP、扩展宿主、主进程及 Agent Host 调试端口，并在渲染器 CDP 可用后输出 JSON。技能还提供使用 @playwright/cli 连接、列出或切换 Electron 页面、生成快照和截图、通过 Monaco 粘贴脚本输入聊天内容，以及把 dap-cli 连接到相应 Node 调试端口的操作说明。

如何安装这个 Skill？

该仓库将技能放在 .agents/skills/launch/，但提供的材料没有说明独立安装命令或发布包安装流程。使用前应在 VS Code 源码检出目录安装依赖（缺少时运行 npm install），并运行 npm run compile 或 npm run watch 构建完整客户端及 extensions/ 下的内置扩展；还需准备已认证的 Code OSS 用户数据目录。调试器工作另外需要将 dap-cli 放到 PATH；材料建议在缺少该技能时从 https://github.com/roblourens/dap-cli 安装。

tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/microsoft/vscode.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.agents/skills/launch" ~/.claude/skills/
rm -rf "$tmp"

如何使用这个 Skill？

将 LAUNCH 指向该技能目录中的 scripts/launch.sh，例如 LAUNCH=<SKILL.md 所在目录>/scripts/launch.sh。然后运行 INFO=$("$LAUNCH" | tail -n1)，并用 jq -r .cdpPort <<<"$INFO" 读取 CDP 端口；再使用 npx @playwright/cli -s=唯一会话名 attach --cdp=http://127.0.0.1:$CDP 连接。可用 "$LAUNCH" --agents 启动 Agents 窗口，使用 --source-user-data-dir <path> 指定认证源，使用 --repo <vscode-repo-root> 指定仓库，使用 --clone-extensions 复制源扩展，或使用 --full 跳过精简排除。要调试扩展宿主、主进程或 Agent Host，分别将 dap-cli 连接到 JSON 中的 extHostPort、mainPort 或 agentHostPort；工作台渲染器使用 cdpPort。每个并行实例和 Playwright 会话都应使用独立名称，结束后关闭 Playwright 会话、终止 Code OSS 进程并删除临时运行目录。

这个 Skill 有哪些优点和局限？

这个 Skill 与同类方案有什么区别？

与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。

常见问题