DeepSeek Harness for VS Code把 DeepSeek Harness(
它是怎么工作的
三个关键点:
安装与构建
安装
开发调试:
从开始菜单启动也能找到
|
| 安装方式 | 搜索位置 |
|---|---|
| fnm | %FNM_DIR%、%APPDATA%\fnm、%LOCALAPPDATA%\fnm、~\.fnm 下的 node-versions\*\installation |
| nvm / nvm-windows | %NVM_HOME%\*、~\.nvm\versions\node\* |
| npm 全局 | %APPDATA%\npm(Windows)、/usr/local/lib 等 |
| 官方安装包 | %ProgramFiles%\nodejs |
| volta | ~\.volta、%LOCALAPPDATA%\Volta 下的 tools\image\node\* |
命中后,扩展用该安装目录自带的 node.exe 去跑 @deepseek-ai/dsh/lib/bin.js
(扩展宿主里的 process.execPath 是 VS Code 自己,不能拿来当 node 用)。
如果装在别处,用设置项 dsh.executablePath 直接指定 dsh.cmd 或 bin.js 即可。
自动找到正在运行的 dsh web
扩展优先附着到已经在跑的 dsh web,因为只有共用同一个主机进程,边栏和浏览器里的
dsh web 才会看到同一批会话。查找顺序:
- 设置项
dsh.webUrl(留空则跳过); - 环境变量
DSH_WEB_URL(从终端启动 VS Code 时会有); - 设置项
dsh.autoStartPort; - 常用端口
3080/8080/3000; - 扫描本机所有监听端口(Windows 用
netstat -ano -p TCP,其它平台用ss/lsof), 逐个请求首页,只有返回的文档里带__DSH_BOOT__启动信息的才算dsh web。
第 5 步保证了这种场景也能对上:从开始菜单启动(没有 DSH_WEB_URL)、而你的 dsh web
跑在 8080 之类的非默认端口时,扩展依然会附着上去,而不是另外启动一个 3080 的主机
——后者会让边栏和浏览器里的会话分家。
只有所有地址都没找到主机时,扩展才会用 dsh web --no-open 自己启动一个;
如果配置的端口已被占用,会自动改为让系统分配一个空闲端口。
使用
打开 右侧边栏(Ctrl+Alt+B / 命令 View: Toggle Secondary Side Bar Visibility),
在 "DeepSeek Harness" 容器里就能看到完整的 dsh 界面。
边栏顶部的工具条:
| 按钮 | 作用 |
|---|---|
| + | 在当前绑定的工作区里新建会话 |
| 会话 | 从主机上的全部会话(含 dsh web 里创建的)里挑一个打开 |
| 目录 | 绑定当前 VS Code 打开的文件夹(没有打开文件夹时弹出目录选择器) |
| +目录 | 新建一个工作区文件夹并绑定(同名目录会自动加 -2、-3 后缀) |
| ✕ | 解除目录绑定(此后不会再创建任何 dsh 工作区) |
| ⟳ | 重新连接 dsh web |
| ↗ | 在浏览器里打开同一个 dsh web |
命令面板里还有 DeepSeek Harness: 在右侧边栏打开 等命令,其中包括
DeepSeek Harness: 移除 dsh 主机的默认工作区注册(手动清理主机自带的 default-workspace)。
快捷键建议
keybindings.json:
{
"key": "ctrl+alt+d",
"command": "dsh.showPanel",
"when": "terminalFocus"
}
设置项
| 键 | 默认值 | 说明 |
|---|---|---|
dsh.webUrl |
"" |
dsh web 地址。留空时依次尝试 DSH_WEB_URL、dsh.autoStartPort、常用端口,最后扫描本机监听端口自动发现正在运行的 dsh web |
dsh.autoStart |
true |
没有正在运行的 dsh web 时自动启动一个 |
dsh.autoStartPort |
3080 |
自动启动使用的端口(0 = 由系统分配) |
dsh.workspaceMode |
currentFolder |
currentFolder 复用当前文件夹 / newFolder 新建文件夹 / none 不自动绑定 |
dsh.newFolderParent |
"" |
新建文件夹的父目录,留空用当前文件夹的上级目录 |
dsh.newFolderName |
dsh-workspace |
新建文件夹的默认名称 |
dsh.reuseExistingSession |
true |
绑定目录时复用该目录已有的会话 |
dsh.pollIntervalMs |
3000 |
会话列表轮询间隔,用于同步边栏状态 |
dsh.executablePath |
"" |
手动指定 dsh 的可执行文件或 bin.js;留空时自动搜索 fnm/nvm/npm/volta 等安装位置 |
dsh.retireDefaultWorkspace |
true |
绑定目录后删除主机 default-workspace 的注册(目录与会话日志保留) |
已知的边界
- 客户端选中状态不同步:SPA 的"当前选中哪个会话"保存在浏览器
localStorage里, 边栏(不同源)和浏览器 GUI 不共享;但服务端状态(会话、消息、工作区)完全共享。 边栏通过桥接脚本点击会话行来打开会话。 - 会话的工作目录在创建后不能改:host 没有提供修改
cwd的 RPC(只有 host 侧的ctx.workingDirectory.set与working_directory工具)。要换目录请新建会话。 - 扩展只能连到 loopback:host 的信任边界要求 loopback 地址或显式
--trusted-host。
目录结构
src/
extension.ts 激活、命令、设置、后台自动绑定
controller.ts 连接状态、轮询、目录绑定、默认工作区退役
host.ts 附着/拉起 dsh web,签发 Cookie,发现 dsh 安装位置
credentials.ts 读取 .credentials.yaml,签发浏览器 Cookie
rpc.ts /api/<method> 单次 RPC 客户端
mux.ts node:net 上手写的 WebSocket 客户端(访问远端流)
workspaces.ts 通过 workspace/follow 跟随主机的工作区注册表
binding.ts workspace/create、session/create、session/list、workspace/delete
proxy.ts 面向 webview 的 HTTP + WebSocket 反向代理
bridge.ts 注入 SPA 的桥接脚本(打开会话、上报当前会话)
webviewView.ts 右侧边栏 webview(头部 + iframe + CSP)
probe/ 协议级验证脚本(不含 VS Code 依赖)
许可与再分发
本项目以 GPL-3.0-or-later 发布(见 LICENSE)。
- 你可以自由使用、修改、闭源集成到你自己的产品里;
- 但凡你再分发本项目的代码(修改版或原版),都必须同样以 GPL-3.0(或更高版本)开放其源码, 并保留本许可与版权声明。
发布到 VS Code Marketplace 前请确认你发布的 .vsix 里包含 LICENSE,
且 package.json 中的 license 字段为 GPL-3.0-or-later。
发布步骤见 PUBLISHING.md。