配置

在 VS Code 设置（settings.json）中可覆盖默认值：

{
  "dshPanel.url": "http://127.0.0.1:3080",
  "dshPanel.host": "127.0.0.1",
  "dshPanel.port": 3080,
  "dshPanel.autoStart": true,
  "dshPanel.autoRegisterWorkspace": true,
  "dshPanel.autoInstallDsh": true,
  "dshPanel.dshCommand": "dsh",
  "dshPanel.killOnDispose": true
}

各配置项含义

配置项	默认值	说明
`dshPanel.url`	`http://127.0.0.1:3080`	面板连接的 DSH 地址
`dshPanel.host`	`127.0.0.1`	自动启动时绑定的主机
`dshPanel.port`	`3080`	自动启动时监听的端口
`dshPanel.autoStart`	`true`	未运行时是否自动启动 dsh
`dshPanel.autoRegisterWorkspace`	`true`	是否把 VS Code 当前工作区自动注册为 DSH 工作区
`dshPanel.autoInstallDsh`	`true`	未安装 dsh 时是否提示并代为安装
`dshPanel.dshCommand`	`dsh`	dsh 命令（可填完整路径）
`dshPanel.killOnDispose`	`true`	扩展停用时是否结束它启动的 dsh

远程服务器（vscode-server）场景

本扩展声明 extensionKind: ["workspace"]，在 Remote-SSH / Dev Containers 等远程场景下运行于服务器端，因此：

自动检测并安装 dsh：打开面板时，会在服务器端执行 dsh --version 检测是否已安装 DeepSeek Harness。未安装时弹出提示，确认后自动执行 npm install -g @deepseek-ai/dsh（要求服务器已安装 Node.js 与 npm）。
自动端口转发：DSH 在服务器上监听 127.0.0.1:3080。扩展通过 vscode.env.asExternalUri 自动建立端口转发，把远程端口暴露到本地，使侧边栏中的 iframe 能直接加载远程 DSH 界面，无需手动配置 SSH 隧道。
工作区自动对接：dsh 以远程工作区为 cwd 启动，新会话默认使用该远程工作区，并自动注册到 DSH 工作区列表。

注意：VS Code 首次转发端口可能弹出「是否转发端口」的确认，选择允许即可。

手动 SSH 隧道（可选，非远程场景）

如果你的 DSH 跑在另一台机器、且不是通过 VS Code Remote 连接的，可手动建立 SSH 隧道：

ssh -L 3080:127.0.0.1:3080 user@your-server

然后把 dshPanel.autoStart 设为 false（避免在本地又起一个），dshPanel.url 保持 http://127.0.0.1:3080。

各配置项含义

配置项	默认值	说明
`dshPanel.url`	`http://127.0.0.1:3080`	面板连接的 DSH 地址
`dshPanel.host`	`127.0.0.1`	自动启动时绑定的主机
`dshPanel.port`	`3080`	自动启动时监听的端口
`dshPanel.autoStart`	`true`	未运行时是否自动启动 dsh
`dshPanel.autoRegisterWorkspace`	`true`	是否把 VS Code 当前工作区自动注册为 DSH 工作区
`dshPanel.autoInstallDsh`	`true`	未安装 dsh 时是否提示并代为安装
`dshPanel.dshCommand`	`dsh`	dsh 命令（可填完整路径）
`dshPanel.killOnDispose`	`true`	扩展停用时是否结束它启动的 dsh

deepseek-harness-vscode

安装

说明文档

配置

各配置项含义

远程服务器（vscode-server）场景

手动 SSH 隧道（可选，非远程场景）

各配置项含义