joygqz/vscode-dsh

DeepSeek Harness Launcher

Visual Studio Marketplace
Open VSX
GitHub release

在 VS Code 中一键启动、打开并管理 DeepSeek Harness Web UI。该扩展会检查环境、通过 npm 获取 DSH、选择安全端口、等待就绪，并在停止时清理进程。

先决条件

- VS Code 1.125 或更高版本。
- Node.js 22.19+（仅限 22.x）或 24+，且 node 和 npx 位于同一安装目录中。
- 受信任的本地、SSH、WSL、Dev Container 或 Codespaces 工作区。
- 一个你有权访问的模型的 API 密钥（在 Harness 页面内配置；此扩展不会读取或存储它）。

Harness 可以读取和写入文件并运行命令：该扩展不会在受限模式下启动或连接服务，并且在从空窗口选择目录时会再次请求确认。

安装

在扩展视图（Ctrl/Cmd+Shift+X）中搜索 DeepSeek Harness Launcher，或从 Marketplace、Open VSX 或 GitHub Releases 安装 .vsix。

快速开始

1. 打开并信任一个项目文件夹，然后点击状态栏中的 DSH 或运行 DeepSeek Harness Launcher: Open。
2. 首次运行会通过 npm 获取 DSH。状态栏会显示 DSH Working…；点击它可以取消或查看输出。
3. 页面打开后，在 Harness 中的 Settings → Models 下添加你的 API 密钥，然后在 Choose workspace 中确认一个目录并开始会话。

workingDirectory 是 DSH 的启动目录和默认工作区上下文，它会影响 AGENTS.md、CLAUDE.md、cwd 下的 .env 以及类似文件。

命令和状态栏

Open 是主要命令：当服务器未运行时它会启动服务器，当服务器已运行时它会直接打开。

| 命令 | 用途 |
| --- | --- |
| Open | 如有需要则启动，或打开正在运行的 UI |
| Start Server | 启动服务器而不打开页面 |
| Open in Browser / Open in VS Code | 如有需要则启动，然后在所选位置打开 |
| Stop Server | 停止托管的服务器；如果清理失败，请再次运行它 |
| Restart Server | 应用新设置；当 workingDirectory 未更改时复用所选目录 |
| Cancel Current Operation | 取消进行中的环境检查、启动、重启或连接 |
| Connect to Running Server… | 连接到此环境中现有的 DSH |
| Disconnect External Server | 停止跟踪外部 DSH，但不停止其进程 |
| Copy Access URL | 复制客户端可以使用的完整地址 |
| Show Output / Open Settings | 打开输出面板或扩展设置 |

状态栏显示：盾牌 + DSH（不受信任）、DSH（未运行）、DSH Working…（点击取消或查看输出）、DSH Stopping…（点击查看输出）、DSH: port（由此窗口托管）、链接图标 + DSH: port（外部服务器）、DSH: port*（设置已更改；点击重启并应用），或错误图标 + DSH（悬停查看详情，点击查看恢复操作）。

设置

| 设置 | 默认值 | 描述 |
| --- | --- | --- |
| startupBehavior | manual | manual 按需启动；start 在 VS Code 打开时静默启动；startAndOpen 启动并打开 |
| openLocation | browser | 主命令使用系统 browser 或 VS Code 的 editor |
| port | 0 | 自动选择一个空闲端口。当固定端口被占用时，扩展不会附加到其他实例 |
| startupTimeout | 120 | 等待 DSH 就绪的最长秒数 |
| workingDirectory | 空 | 启动和默认工作区上下文；支持绝对路径、相对路径、~ 和 ${workspaceFolder}。相对路径需要打开的工作区文件夹 |
| webArgs | [] | 额外的 DSH Web 参数（不得包含 --host、--port 或 --patch） |
| environment | {} | 进程环境变量；可以覆盖 PATH，不能覆盖 DSH_HOME |

托管服务器和外部服务器

- 托管服务器由扩展启动。其数据存放在扩展的全局存储中，因此模型凭据、设置和会话在各个项目之间共享。单写入者租约可确保配置文件安全；另一个 VS Code 窗口会自动连接到正在运行的共享实例，而不是启动一个竞争进程。“Stop Server”会等待会话清理完成，然后强制结束它并确认端口已释放。
- 在此环境中，外部服务器只能通过 HTTP 回环地址显式连接（例如 http://127.0.0.1:3080）。它仅支持打开、复制、刷新和断开连接；扩展永远不会停止它，并且它保留自己的数据目录。
- 同一本地或远程 VS Code 环境中的所有项目使用一个 DSH 应用程序配置文件，并复用其正在运行的实例。本地、SSH、WSL 和容器环境保留单独的全局存储，因为它们运行在不同的机器/文件系统上。

远程、WSL 和容器
Node/npx、workingDirectory、相对路径、环境变量和连接地址都在工作区所在的环境中解析。系统浏览器通过 openExternal 打开，它会解析 localhost 转发；内置页面和“Copy Access URL”使用 asExternalUri。使用自动端口时，VS Code 返回的确切非环回 authority 会被添加到 DSH Host 允许列表中；如果无法确定转发的 authority，扩展会安全失败。

DSH 仅监听 127.0.0.1，但转发可见性由 VS Code、Codespaces 或 Dev Tunnels 控制。请将转发的端口保持为 Private，不要分享转发的 URL。

安全

- 仅在完全信任的项目中使用 Harness。workingDirectory 及任何添加的目录都可能被 agent 读取、写入和执行。Workspace Trust 不是文件系统沙箱。
- 扩展始终传递 --host 127.0.0.1，拒绝让用户覆盖监听地址，并且不支持会改写此边界的补丁。
- 上游 Web 服务没有适合公共互联网的身份验证或 TLS。首次启动会从 npm 下载固定版本的顶层 DSH；传递依赖仍可能发生变化。
- API 密钥、模型配置和会话由 DSH 写入扩展的全局应用程序配置文件，并在同一环境中的各项目间共享。此扩展不读取 API 密钥，也不包含任何遥测。

故障排除

未找到 Node.js / npx 或版本不受支持：在扩展的运行时环境中运行 node --version；Remote 使用远程 Node。集成终端可能由 nvm 初始化，而 Extension Host 的 PATH 未同步；请在 vscode-dsh.environment 中提供绝对 PATH。

首次启动很慢：npx 会下载 DSH 及其依赖项。点击状态栏中的“Show Output”，或增加 startupTimeout。

固定端口已被占用：改回 port: 0。如果该端口是你自己启动的 DSH 实例，请使用“Connect to Running Server…”。

页面打开了但会话无法工作：在 Settings → Models 下配置模型，然后在 Choose workspace 下添加并选择一个目录；参见官方 Web UI 指南。

内置页面空白或受限：改用 Open in Browser，并检查输出面板以及 Remote 端口转发的 Private 设置。

服务器意外退出：将鼠标悬停在错误状态上以查看原因，并选择恢复操作。受管进程必须先确认清理完成，才允许重启。

反馈与许可证

- 扩展问题：joygqz/vscode-dsh Issues
- DSH 使用问题：DeepSeek Harness Discussions
- 许可证：MIT