## 引言

DeepSeek Harness（以下简称 dsh）的 v4flash 版本目前对 Linux 平台的适配是最佳的。在 Windows 原生终端中运行 dsh 时，会持续出现终端操作错误，具体表现为`失败BashError: subprocess-local: terminal inspection is unsupported on platform win32`，`Tool callError: The path . is not an absolute path, it should start with `/`. Maybe you meant /.?`等问题。对于希望在 Windows 上体验 dsh 与 v4flash 最佳工况的开发者来说，直接使用 Windows 原生环境并不理想。

一个成熟的解决方案是借助 Windows Subsystem for Linux 2（WSL2）构建 Linux 运行环境，再通过 Visual Studio Code 的远程开发能力连接 WSL，在 Linux 环境中启动 dsh web 服务，利用 WSL2 的 localhost 自动转发机制，从 Windows 浏览器访问 dsh 的 Web UI 与生成的代码产物。整个流程无需额外端口映射，也无需在 Windows 上安装 Linux 虚拟机或双系统，即可**单机获得接近原生 Linux 的开发体验**，同时，**`WSL+dsh+v4Flash+极简模式`也是开发者和社区公认的最具有性能和性价比的AI开发模式**。
![DSH和DS的友好互动](https://developer.qcloudimg.com/http-save/yehe-9584254/fa8a3c79a3e774a9b361bca4d609674b.jpg)

本文将从动机与思路出发，逐步说明环境准备、dsh 部署、远程连接、Web UI 使用以及成品网页浏览的完整操作，并给出推荐的最佳实践。

## 动机与思路

选择 WSL2 而非其他方案，主要基于三点考虑。
- 第一，WSL2 提供完整的 Linux 内核与系统调用兼容性，dsh 及其依赖可以按 Linux 原生方式安装运行，避免 Windows 下的终端兼容问题。
- 第二，WSL2 与 Windows 共享 localhost 网络，WSL 内启动的服务可以直接通过 Windows 的 `localhost` 访问，无需配置端口转发或防火墙规则。
- 第三，VSCode 的 Remote-WSL 扩展允许在 Windows 上使用熟悉的编辑器界面，同时将文件操作、终端、扩展运行在 WSL 环境中，实现真正的远程开发。

整体思路可以概括为：在 WSL2 中安装并启动 dsh web，通过 VSCode 远程连接 WSL 管理项目与终端，在 Windows 浏览器中访问 dsh Web UI 输入提示词，生成代码后使用 Live Server 在 WSL 内启动静态服务，最后在 Windows 浏览器中浏览成品网页。这一流程将 dsh 的计算与生成过程完全置于 Linux 环境，而交互与浏览则保留在 Windows 侧，兼顾了兼容性与易用性。

---

## 环境准备

### 安装 WSL2 与 Ubuntu

在 Windows 10 或 Windows 11 上，以管理员身份打开 PowerShell 或 Windows Terminal，执行以下命令安装 WSL 与 Ubuntu 发行版：

`wsl --install -d Ubuntu`

该命令会启用 WSL 功能、安装 WSL2 内核并下载 Ubuntu。安装完成后需要重启，重启后首次进入 Ubuntu 会提示创建用户名与密码，完成初始化即可。

验证 WSL 版本，在 PowerShell 中执行：

`wsl --list --verbose`

确保 Ubuntu 的版本列为 2。如果显示为 1，可执行 `wsl --set-version Ubuntu 2` 进行转换。

### 安装 VSCode 与 Remote-WSL 扩展

在 Windows 上安装 Visual Studio Code，然后打开扩展市场，搜索并安装 Remote-WSL 扩展。该扩展由 Microsoft 官方提供，用于连接 WSL 发行版并在其中进行远程开发。安装完成后，VSCode 左下角会出现远程连接按钮，点击后选择 Connect to WSL 即可连接到默认的 Ubuntu 发行版。

## 在 WSL 内安装并启动 dsh

进入 WSL 的 Ubuntu 终端，首先更新软件包列表并安装必要依赖。dsh 的具体安装方式取决于官方发布渠道，通常包括下载二进制文件或通过包管理器安装。以常见的二进制分发为例，在 WSL 终端中执行下载与解压操作，将可执行文件放置到 PATH 包含的目录，例如 `/usr/local/bin`。

安装完成后，验证 dsh 是否可用：

`dsh --version`

如果输出正常，说明 dsh 已在 Linux 环境中就绪。接下来启动 dsh web 服务。dsh web 通常会启动一个本地 Web 服务器，默认监听某个端口，例如 8080。在 WSL 终端中执行：

`dsh web --port 8080`

启动后终端会显示服务地址。由于 WSL2 的 localhost 转发机制，该服务会自动映射到 Windows 的 localhost，无需额外配置。此时在 Windows 浏览器中访问 `http://localhost:8080`，即可看到 dsh 的 Web UI。

## VSCode 远程连接与项目组织

在 Windows 的 VSCode 中，点击左下角远程连接按钮，选择 Connect to WSL，VSCode 会启动一个远程窗口，该窗口的文件系统与终端均运行在 WSL 的 Ubuntu 环境中。在远程窗口中打开一个项目目录，例如在 WSL 终端中创建 `/home/你的用户名/dsh-project`，然后在 VSCode 中选择打开该文件夹。

远程窗口的终端默认是 WSL 的 bash，可以直接在其中运行 dsh 相关命令。如果之前已在 WSL 终端中启动了 dsh web，该进程会持续运行，VSCode 远程终端可以查看其输出或重新启动。建议在 VSCode 远程终端中启动 dsh web，这样日志与错误信息可以集中查看，也方便随时停止与重启。

## 使用 dsh Web UI 生成代码

在 Windows 浏览器中打开 `http://localhost:8080`，进入 dsh Web UI，然后就可以愉快的Vibe Coding 了。dsh 会调用 v4flash 模型在 Linux 环境中完成推理与代码生成。生成过程完全在 WSL 内进行，不受 Windows 终端兼容问题影响。

生成完成后，在 VSCode 远程窗口中打开产物目录，即可查看、编辑生成的代码文件。

## 浏览成品网页

生成的代码产物通常是静态网页文件，包括 HTML、CSS、JavaScript 等。要在 Windows 浏览器中预览成品，推荐使用 Live Server 扩展。关键点在于，**Live Server 扩展必须安装到 WSL 端，而不是 Windows 端**。在 VSCode 远程窗口中打开扩展市场，搜索 Live Server，安装时注意扩展标题旁会显示 Install in WSL: Ubuntu，确保安装到远程环境。

安装完成后，在 VSCode 远程窗口的资源管理器中右键点击生成的 `index.html` 文件，选择 Open with Live Server。Live Server 会在 WSL 内启动一个静态文件服务器，默认端口为 5500。由于 WSL2 的 localhost 转发，Windows 浏览器可以直接访问 `http://localhost:5500` 查看成品网页。Live Server 支持热重载，修改代码后浏览器会自动刷新，便于迭代开发。

如果希望使用 Windows 本地的 VSCode 与 Live Server，也可以通过 WSL 的 UNC 路径访问文件。在 Windows 资源管理器地址栏输入 `\\wsl$\Ubuntu\home\你的用户名\项目路径`，即可浏览 WSL 文件系统。但该方案存在文件监听与扩展兼容问题，稳定性不如在 WSL 端运行 Live Server，因此仅作为备选。
![image](https://developer.qcloudimg.com/http-save/yehe-9584254/4f7d45225562fd4c3c11d3cd37ea197f.jpg)

## 划重点：最佳实践

### 文件系统位置

将项目文件放在 WSL 的 Linux 文件系统中，例如 `/home/你的用户名/` 下，而不是 Windows 的挂载盘符如 `/mnt/c/`。Linux 文件系统对文件权限、符号链接与 inotify 事件的支持更完整，dsh 与 Live Server 的运行更稳定。跨文件系统访问会降低性能并可能引发文件监听失效。

### 端口与转发

WSL2 的 localhost 转发仅对监听在 WSL 内的服务生效。如果 dsh web 或 Live Server 监听在 `127.0.0.1` 或 `0.0.0.0`，Windows 均可通过 `localhost` 访问。如果服务仅监听在 WSL 的特定 IP，需要检查配置。通常保持默认监听地址即可。

### 扩展安装位置

所有与远程开发相关的 VSCode 扩展，包括 Live Server、语言支持、格式化工具等，都应安装到 WSL 端。在远程窗口中安装扩展时，注意选择 Install in WSL。Windows 端的扩展不会在远程环境中生效，反之亦然。

### Docker 场景

如果 dsh 运行在 WSL 内的 Docker 容器中，需要在启动容器时映射端口。例如：

`docker run -p 8080:8080 镜像名`

之后同样通过 Windows 的 `http://localhost:8080` 访问。容器内的文件系统与 WSL 文件系统相互独立，代码产物需要挂载卷或复制到 WSL 文件系统，以便 VSCode 远程窗口访问。

### 终端与进程管理

在 VSCode 远程终端中运行 dsh web 时，关闭远程窗口不会终止后台进程。如果需要停止服务，可以在终端中按 Ctrl+C，或使用 `pkill dsh` 命令。建议使用 `tmux` 或 `screen` 管理长时间运行的 dsh 进程，避免终端关闭导致服务中断。

---

## 总结

通过 WSL2 运行 dsh，结合 VSCode 远程开发与 localhost 转发，可以在 Windows 上获得接近原生 Linux 的 dsh 使用体验。整个流程无需修改 dsh 源码，也无需在 Windows 上解决终端兼容问题，只需将计算与生成过程迁移到 WSL 环境，交互与浏览保留在 Windows 侧。这一方案不仅适用于 dsh，也适用于其他仅支持 Linux 的开发工具，为跨平台开发提供了一种低成本的解决路径。

对于希望体验 dsh 与 v4flash 最佳工况的开发者，推荐按照本文步骤搭建环境，将项目文件置于 WSL 文件系统，扩展安装到 WSL 端，并使用 Live Server 在 WSL 内启动静态服务。这样可以最大程度避免文件系统与终端兼容问题，专注于提示词设计与代码生成本身。

DeepSeek Harness（以下简称 dsh）的 v4flash 版本目前对 Linux 平台的适配是最佳的。在 Windows 原生终端中运行 dsh 时，会持续出现终端操作错误，具体表现为失败BashError: subprocess-local: terminal inspection is unsupported on platform win32，Tool callError: The path . is not an absolute path, it should start with /. Maybe you meant /.?等问题。对于希望在 Windows 上体验 dsh 与 v4flash 最佳工况的开发者来说，直接使用 Windows 原生环境并不理想。

通过 WSL 操作 DeepSeek Harness，实现 Linux 环境的远程开发

DeepSeek Harness（以下简称 dsh）的 v4flash 版本目前对 Linux 平台的适配是最佳的。在 Windows 原生终端中运行 dsh 时，会持续出现终端操作错误。可以通过WSL远程开发绕过这个问题，并得到更接近服务端的开发体验。

开发工具

操作系统

后端

在Windows上通过WSL2运行DeepSeek Harness（dsh）v4flash，可避免原生终端兼容错误。结合VSCode Remote-WSL开发，利用localhost自动转发访问WebUI，搭配LiveServer预览网页，获得接近Linux原生的AI编码体验。

文件系统

包管理器

服务器

虚拟机

防火墙

Windows

容器

Ubuntu

Linux

快速部署LLM、AI绘画等应用,助你玩转AIGC！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

通过 WSL 操作 DeepSeek Harness，实现 Linux 环境的远程开发-腾讯云开发者社区-腾讯云

通过 WSL 操作 DeepSeek Harness，实现 Linux 环境的远程开发

通过 WSL 操作 DeepSeek Harness，实现 Linux 环境的远程开发

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐