用途
vscode worker 通过 code CLI 运行 VS Code Server,为每个工作区目录启动一个回环进程,并使用独立隔离的配置目录;同时提供一个 Console 页面,在对话旁内嵌 VS Code Workbench,让用户使用自己熟悉的编辑器、扩展、设置同步和终端处理聊天的工作目录。
它适合以下场景:
- 用户要求在工作目录、仓库或文件夹中打开 VS Code,或希望在聊天旁有编辑器。
- 用户想在真实编辑器中检查改动后再继续对话;对该文件夹调用
vscode::start返回运行中的服务器后,Console 页面即可显示。 - 需要复用、列出、停止某个工作区的服务器,或在工作结束后删除其配置目录。
主要能力
vscode::start:为绝对路径的工作区目录启动服务器,或返回已在运行的服务器;id 默认取该路径的稳定哈希。vscode::instances::list:列出该 worker 拥有的所有服务器,包含 host、port、pid、状态和退出码。vscode::stop:按 id 停止服务器进程组。vscode::delete:停止服务器、移除记录,并可通过delete_profile选择是否删除其数据目录。
Console 页面会对聊天的工作目录调用 vscode::start,并在 iframe 中打开 http://<host>:<port>/;其他 worker 可通过 panels.open({ pageId: 'vscode', context: { workspace } }) 打开指定文件夹。
使用方式
主机需安装 VS Code CLI;工作区首次启动时会下载匹配的服务器构建。配置项(CLI 路径、数据目录、绑定主机、端口范围、超时)由 configuration worker 在 id vscode 下管理。
限制与边界
- 不是文件 API:读写、搜索文件请使用 shell 或
coder::*;需要智能体与用户共享缓冲区时使用editor。 - 不是远程访问:服务器只绑定回环地址,并拒绝其他
bind_host;远程或多用户 Console 需要先自行配置带认证的代理。 - 启动服务器会把主机文件系统暴露给本地浏览器,因此
vscode::start默认允许,而vscode::stop与vscode::delete需审批。 - Workbench 本身即 VS Code Web,该 worker 不额外增加编辑器功能。
- 该 worker 只负责进程生命周期,不代智能体读取、写入或搜索文件,也不将服务器暴露到回环之外。