DeepSeek Harness (dsh) 是 DeepSeek 官方出品的命令行 / WebUI 工具。本文记录 Windows 从零安装全流程：前置依赖、全局安装、rc.6 版本已知 BUG 避坑、配置文件手动编写、第三方插件安装，以及官方验证可复现的完整卸载方案。

DeepSeek Harness (dsh) Windows 完整安装踩坑教程

dsh (@deepseek-ai/dsh)：DeepSeek 官方命令行 / WebUI 工具，版本 0.1.0-rc.6
⚠️ 重要提示：0.1.0-rc.6 存在已知 BUG：dsh profile create/list 等配置管理子命令失效，直接执行会报 --profile <name> is required，不要直接使用命令行创建配置文件。
环境要求：Node.js ≥ 20 LTS、npm；安装第三方插件额外需要 pnpm、git

一、前置依赖安装

1. Node.js

下载安装 Node.js 20 LTS，安装时勾选 Add to PATH。

验证（新开 CMD）：

1
2
node --version
npm -v

2. pnpm（安装 GitHub 来源插件必须，不能省略）

打开 PowerShell 执行安装脚本：

1
iwr https://get.pnpm.io/install.ps1 -useb | iex

安装完成后完全关闭所有终端，重新打开 CMD，刷新环境变量。

1
pnpm -v

输出版本号即为成功。

3. Git

安装 Git 并勾选加入系统 PATH，用于拉取 GitHub 插件源码。

验证：

1
git --version

二、全局安装 dsh

1
npm install -g @deepseek-ai/dsh

安装完成校验版本：

1
dsh --version

输出 0.1.0-rc.6，代表安装成功。

❗ 不要直接输入 dsh 回车，会直接报错缺少 --profile，rc.6 不能直接用命令行创建 profile。

三、创建配置档案 Profile（rc.6 避坑：优先 WebUI 图形化配置）

  1. 直接启动内置 Web 服务：

    1
    dsh web

    浏览器自动打开，访问地址：http://127.0.0.1:3080

  2. 网页内进入【设置 - Setting】→ New Profile

    • Profile 名称：default
    • provider：deepseek
    • api-key：填入你的 DeepSeek API Key
    • base-url：https://api.deepseek.com（默认直接回车）
    • default_text_model：deepseek-chat

    保存配置。

配置文件实际存放路径：C:\Users\你的用户名\.dsh\config.toml

备选方案：手动编写配置文件（不启动 Web）

打开路径 C:\Users\czhdq\.dsh\，新建 config.toml：

1
2
3
4
5
[profiles.default]
provider = "deepseek"
api_key = "sk-xxxxxxxxxxxxxxxx"
base_url = "https://api.deepseek.com"
default_text_model = "deepseek-chat"

保存后进入命令行交互对话：

1
dsh --profile default

单次直接提问（不进入交互式 shell）：

1
dsh --profile default chat "你好"

环境变量临时绕过 profile（快速测试）：

1
2
set DEEPSEEK_API_KEY=sk-xxx
dsh chat "测试输出hello"

四、安装第三方插件示例（gal-view）

示例：安装 github:Ayase34/gal-view#main 插件
前提：pnpm、git 已经安装并在环境变量，终端重启生效。

1
dsh plugin --profile web add github:Ayase34/gal-view#main

报错处理：allowBuilds 提示

打开文件：C:\Users\czhdq\.dsh\profiles\web\pnpm-workspace.yaml，写入内容：

1
allowBuilds: true

保存，再次执行插件安装命令。

插件安装完成后启动 web：

1
dsh --profile web web

在网页插件面板启用 gal-view。

五、已知 BUG 清单（rc.6 版本）

❌ dsh profile create default、dsh profile list 命令失效，报错 --profile <name> is required

解决：全部配置操作优先走 WebUI 图形界面，不要用命令行 profile 子命令。

❌ 加载 GitHub 远程插件系统必须依赖 pnpm，npm 无法替代。

✅ dsh --version 不受 bug 影响，可正常输出版本。

降级备选（rc.5，修复 profile 命令 bug）

如果你希望使用命令行管理 profile 档案，可以降级版本：

1
2
npm uninstall -g @deepseek-ai/dsh
npm install -g @deepseek-ai/dsh@0.1.0-rc.5

降级后可以正常执行：

1
2
dsh profile create default
dsh profile list

六、常用命令汇总

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
# 查看版本
dsh --version

# 启动 WebUI
dsh web

# 指定 profile 进入交互终端
dsh --profile default

# 单次提问
dsh --profile default chat "你的问题"

# 插件管理
dsh plugin --profile web add github:xxx/xxx#branch
dsh plugin --profile web list

七、故障排查清单

  • pnpm 不是内部命令：关闭全部终端窗口，重新打开 CMD；确认 pnpm 安装完成并且加入系统 PATH。
  • API 调用报错：核对 api-key、余额、base-url、模型名称。
  • 插件构建失败：确认 Node ≥ 20，pnpm 正常，修改 pnpm-workspace.yaml 开启 allowBuilds: true。
  • profile 命令报错（rc.6）：不要使用 profile 子命令，改用 WebUI 配置，或者降级 rc.5。

八、dsh 完整卸载教程（官方验证、可复现）

本章节为实测有效的 Windows 完整卸载方案，包含全局程序卸载、本地配置/插件残留清理、卸载校验，彻底清除 dsh 所有相关文件，无残留、不影响后续重装。

1. 核心全局卸载命令

打开任意 CMD/PowerShell 终端，执行 npm 全局卸载命令，彻底移除 dsh 程序本体（通用所有版本 rc.5/rc.6）：

1
npm uninstall -g @deepseek-ai/dsh

执行完毕无报错，即为程序卸载完成。

2. 清理本地残留配置与插件文件（关键步骤）

dsh 安装后会在用户目录生成独立配置文件夹，仅卸载程序不会删除该目录，残留文件可能导致后续重装报错、配置冲突，需手动删除：

打开 Windows 用户目录，路径如下（替换为自己的电脑用户名）：

1
C:\Users\你的用户名\.dsh\

直接删除 .dsh 整个文件夹，该目录包含所有 profile 配置、已安装插件、pnpm 工作区配置、会话缓存等全部残留数据。

3. 卸载完整性校验

关闭所有终端，重新打开 CMD，执行校验命令，无版本输出、提示”不是内部或外部命令”，代表彻底卸载干净：

1
dsh --version

4. 补充：关联依赖无需卸载说明

教程前置安装的 Node.js、pnpm、git 为通用开发依赖，并非 dsh 专属依赖，卸载 dsh 无需卸载以上工具，不影响电脑其他项目使用。

5. 重装前置提示

若后续需要重装 dsh，必须完成以上「卸载程序 + 清理残留文件夹」两步操作，仅卸载程序直接重装，大概率出现配置报错、插件加载失败、profile 异常等问题。

九、推荐的插件

dsh 插件市场

4000+ 个社区插件，逛一逛，点一下，装好——多数插件连重启都不用。更新、卸载、实时安装进度，零遥测。

1
dsh plugin --profile web add dshmarket

billion-context

上下文压缩插件，兼顾小窗口（100k 上下文足矣）、省 token（省 5 倍 token）和超长会话（数月级别几十亿 token 单会话）。

1
dsh plugin --profile web add billion-context

DeepSeek-Balance-Whale-Widget

右下角常驻的小鲸鱼挂件：余额、今日已用与每轮对话消耗（含峰谷价），余额预警与今日预算的泡泡内容都可编辑；泡泡点击序列模块化自定义，支持并列加权 A/B、随机台词与随机图片；内置 30+ 厂商模板（OpenAI / OpenRouter / Kimi / 硅基流动 / 方舟 / 智谱 / MiniMax 等），按模型查余额与订阅额度；另有任务结束音效、导入音频、自定义角色与资源管理。数据全在本机，无遥测。

1
dsh plugin --profile web add dsh-whale-widget

dsh-skills-manager

在设置里管理本地 DSH 技能，并只读查看公共 Agent 技能。

1
dsh plugin --profile web add @michengai/dsh-skills-manager

dsh-client-ui-skin-maid-atelier

DSH Web 鲸鱼娘皮肤系列（深海女仆工坊 maid-atelier）。

1
dsh plugin --profile web add @smalltailqwq/dsh-client-ui-skin-maid-atelier