DeepSeek Harness for VS Code

一个零依赖的 VS Code 扩展，把 DeepSeek Harness (DSH) 的 Web GUI 内嵌到 VS Code 侧边栏 / 辅助侧边栏中，并自动检测、启动 DSH 服务。

本扩展的设计哲学是「只做一个忠实的窗口」：最大程度上客观、原样地呈现 DSH Web GUI，不注入脚本、不改写界面、不拦截交互，也完全不干涉你对 DSH 的插件开发、界面魔改等任何二次定制——DSH 的功能表达始终由你完全掌控。

如果喜欢本扩展请转至 Deepseek-Harness-for-VS-Code 星标助力；对 Chrome Extension 有需求也请关注 Deepseek-Harness-for-Chrome。

快速安装（下载 .vsix）

1. 从 GitHub Releases 下载最新的 .vsix 安装包：

   https://github.com/Vithrive/Deepseek-Harness-for-VS-Code/releases/latest/download/deepseek-harness-vscode-0.2.11.vsix

2. 在 VS Code 中安装：

   code --install-extension deepseek-harness-vscode-0.2.11.vsix

   或在 VS Code 中：Ctrl+Shift+P → Extensions: Install from VSIX... → 选择下载的 .vsix 文件。

3. 重载窗口：Ctrl+Shift+P → Reload Window。

4. 打开项目文件夹，点击 Activity Bar 的「DeepSeek Harness」图标，扩展会自动检测并启动 DSH。

特性

• 在 Activity Bar 中新增「DeepSeek Harness」图标，点击后打开内嵌面板
• 支持把面板移动到辅助侧边栏（右键图标 → Move to Secondary Side Bar，或直接拖拽）
• 自动检测：打开面板时探测 dshPanel.url 是否可访问
• 自动启动：检测到未运行时，自动执行 dsh web --host <host> --port <port> 启动 DSH
• 工作区自动绑定：启动 dsh 时使用 VS Code 当前打开的工作区文件夹作为 dsh 工作目录（无工作区则退回用户主目录）
• 工作区自动注册：把 VS Code 当前工作区自动注册为 DSH 工作区，新会话默认使用该工作区（除非用户在 DSH 里手动切换）
• 远程（vscode-server）支持：在 Remote-SSH / Dev Containers 等远程场景下运行，自动检测并安装服务器端的 dsh，并通过端口转发把 DSH 面板接入本地 VS Code
• 就绪等待：启动后自动轮询等待服务就绪，再渲染界面，避免白屏
• 字号跟随编辑器：面板整体等比缩放，从而让 16px 对话正文对齐 VS Code editor.fontSize（缩放比例 = editor.fontSize / 16，安全夹取到 8..72px / 0.5..2 倍），修改后即时生效，无需重载当前对话
• 面板顶部提供「刷新」「重启 dsh web」和「在浏览器中打开」按钮：「刷新」仅在服务离线时才重载（在线时只确认状态、不打断对话）；「重启」始终可启动/重启 dsh，仅当 dsh 非本窗口启动时会先弹确认，避免误中断其他窗口正在运行的任务

从源码安装（开发模式，零依赖，无需编译）

本扩展是纯 JavaScript，不需要 npm install、不需要 TypeScript 编译。

方式一：直接加载开发扩展

1. 克隆并打开本目录：

   git clone https://github.com/Vithrive/Deepseek-Harness-for-VS-Code.git
   code Deepseek-Harness-for-VS-Code

2. 在 VS Code 中按 F5，会弹出「扩展开发宿主」窗口。

3. 在扩展开发宿主中打开你的项目文件夹（File → Open Folder），这样 DSH 的工作区就是你的项目。

4. 点击左侧 Activity Bar 的「DeepSeek Harness」图标，面板会：

   • 检测 http://127.0.0.1:3080 是否已运行；
   • 若未运行，自动执行 dsh web --host 127.0.0.1 --port 3080，工作目录为当前项目；
   • 服务就绪后自动渲染 DSH 界面。

5. 把图标移到辅助侧边栏：右键图标 → Move to Secondary Side Bar。

方式二：自行打包成 .vsix 并安装

cd DeepSeek-Harness-for-VS-Code
npx --yes @vscode/vsce package --allow-missing-repository
code --install-extension deepseek-harness-vscode-0.2.11.vsix

配置

在 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
}

各配置项含义

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

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

1. 自动检测并安装 dsh：打开面板时，会在服务器端执行 dsh --version 检测是否已安装 DeepSeek Harness。未安装时弹出提示，确认后自动执行 npm install -g @deepseek-ai/dsh（要求服务器已安装 Node.js 与 npm）。

2. 自动端口转发：DSH 在服务器上监听 127.0.0.1:3080。扩展通过 vscode.env.asExternalUri 自动建立端口转发，把远程端口暴露到本地，使侧边栏中的 iframe 能直接加载远程 DSH 界面，无需手动配置 SSH 隧道。

3. 工作区自动对接：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。

工作原理

1. 打开面板 → 先显示「正在启动」加载页；
2. 用 Node 内置 http/https 探测 dshPanel.url；
3. 未连接且 autoStart 开启 → spawn('dsh web --host ... --port ...')，cwd 设为 VS Code 工作区；
4. 轮询等待服务就绪（最多约 30 秒）；
5. 服务就绪后，通过 POST /api/workspace.create 把 VS Code 当前工作区注册为 DSH 工作区；
6. 就绪后通过 WebviewViewProvider 渲染 iframe；
7. retainContextWhenHidden: true 保持面板隐藏时不丢会话状态；
8. 扩展停用时按 killOnDispose 决定是否结束它自己启动的 dsh（不影响你手动启动的实例）。

工作区行为说明

• 新会话默认工作区：DSH 的新会话默认使用 dsh 进程的启动目录（cwd）作为工作区。扩展以 VS Code 当前工作区作为 cwd 启动 dsh，因此新会话默认指向 VS Code 工作区。
• 工作区列表注册：扩展会在服务就绪后调用 workspace.create，把 VS Code 工作区加入 DSH 的工作区列表（幂等，已存在则不重复）。
• 用户可手动更改：在 DSH 里手动选择其他工作区后，新会话会按你选择的工作区创建，扩展不会覆盖你的选择。

分支说明

• dev-<版本号>：开发分支，命名与扩展版本号一致（历史 dev-0.1.0，当前 dev-0.2.11）
• main：与最新 dev-* 内容保持一致，作为默认分支
• .vsix 安装包通过 GitHub Releases 发布

前置条件

• 已安装 DeepSeek Harness：支持 npm install -g @deepseek-ai/dsh 全局安装，也支持 npx @deepseek-ai/dsh 安装（包只缓存在 npx 目录、不写全局 PATH 也能识别）；扩展会自动检测这两种方式，也可通过 dshPanel.dshCommand 指定完整路径
• 实测 DSH 默认响应头未设置 X-Frame-Options / 严格 CSP，可被 iframe 正常内嵌