Choose native PowerShell or WSL2 first

Use native PowerShell when your repositories, Node installation, browser, and daily shell already live on Windows. Use WSL2 when the repository and its dependencies already run inside Linux. Mixing a Windows Node process with a WSL workspace creates path, permission, and executable-resolution problems that look like DSH failures.

  • Keep the DSH process and workspace in the same environment.
  • Open the Web UI from the host browser only after the process reports its listening address.
  • Do not treat a community one-click package as official unless DeepSeek links to it.

Native PowerShell path

Confirm Node and npm in the same PowerShell session, then launch the official package. The current npm metadata does not declare a minimum Node engine, so HarnessBase will publish a tested version floor only after retaining clean-environment results.

PowerShell quick start · powershell
node --version
npm --version
npx @deepseek-ai/dsh web

WSL2 path

Install and run Node inside the chosen distribution, keep the workspace in its Linux filesystem, and run the same official package command there. Avoid switching between /mnt/c paths and Linux-owned paths while diagnosing an installation.

WSL2 environment check · bash
uname -a
node --version
npm --version
npx @deepseek-ai/dsh web

Verify more than “the page opened”

A complete startup check includes the process staying alive, the expected address resolving, the model setup opening, a workspace being selectable, and one small read-only task completing. Plugin paths and shell tools must then resolve inside the same environment.

  • Process remains active without a crash loop.
  • Web UI opens at the address printed by DSH; the official default is 127.0.0.1:3080.
  • Model configuration can be saved without exposing the key in screenshots or logs.
  • Workspace paths resolve from the process environment.
  • A read-only first task finishes before broader permissions are granted.

What remains before this page is indexable

HarnessBase will run a clean Windows 11 PowerShell test and a clean WSL2 test, record Node/DSH versions, retain startup output, verify workspace behavior, and test at least one plugin path. Until then this page is deliberately excluded from the sitemap.

Sources and evidence boundary

Primary sources establish product facts. HarnessBase labels direct testing separately and does not convert community observations into verified results.

Target query cluster: DeepSeek Harness Windows · install DeepSeek Harness on Windows · DeepSeek Harness WSL2