SuperAPI AI 工具集

vscode

编程与开发

查看项目

更新于 10-22 20:09

技能介绍

用途

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 只负责进程生命周期,不代智能体读取、写入或搜索文件,也不将服务器暴露到回环之外。