文章摘要
DeepSeek Harness官方网页版交互体验待优化，社区推出桌面客户端DSH Desktop和终端界面工具dsh - TUI。文章给出安装教程，两款工具都要求Node.js版本满足^22.19或者=24，dsh - TUI还要求pnpm不低于10。分别介绍了桌面版和CLI版安装步骤、配置方法、测试指令及CLI版常用命令等，还指出了dsh - TUI适用人群和非交互使用场景。

DeepSeek Harness 官方网页版推出后，不少用户反馈交互体验有待优化。针对这一情况，社区涌现出两款高星开源工具，分别是桌面客户端和终端界面工具，我们将通过保姆级教程带你完成部署。

目前两款工具的社区热度都很高：

  • DSH Desktop：原生macOS和Windows桌面应用，当前Star数约8.5k，将Electron、Node.js和Harness打包集成，无需额外配置Node环境和端口管理。
  • dsh-TUI：类Claude Code的终端界面工具，Star数约1.5k，完全兼容官方Harness的Agent、会话、工具、Skills、MCP和权限服务。

安装前：共同的环境要求

两款工具都有基础环境要求：Node.js版本需要满足^22.19或者>=24，我们推荐直接使用Node 24版本进行部署。其中dsh-TUI额外要求pnpm版本不低于10。

你可以通过以下命令检查当前环境版本：

node --version
pnpm --version

本次教程的实测环境为：macOS Apple Silicon，Node.js v24.19.0，pnpm 11.19.0，对应安装的工具版本分别为@deepseek-ai/dsh@0.1.0-rc.6和@deepseek-harness-tui/dsh-tui@0.7.1。如果后续想要使用最新版本，可以将版本号替换为@latest。

如果你的环境中还没有配置pnpm，可以通过以下命令快速启用：

corepack enable pnpm
npm --version

桌面版Web UI部署教程

桌面版工具将所有依赖打包为安装包，普通用户无需额外配置开发环境，直接安装即可使用。

项目官方仓库地址：https://github.com/anywhere-labs/deepseek-harness-desktop

1. 下载桌面版安装包

访问项目官方下载站，根据你的操作系统选择对应的安装包：

  • macOS版本：适配Apple Silicon芯片，要求macOS 12及以上系统
  • Windows版本：提供x64架构的安装包

2. 完成系统安装

macOS用户：打开下载好的DMG镜像文件，将DSH Desktop应用拖入Applications文件夹即可完成安装。

Windows用户：直接运行下载的exe安装程序，按照系统向导完成安装流程即可。

本次教程使用的macOS 2.0.0安装包已经通过系统签名和公证检查，可以直接从应用目录正常启动。

3. 首次启动与配置

首次启动时，DSH Desktop会自动在本地创建默认配置文件，并启动Harness后台服务，初次启动耗时会比后续启动稍长。整个使用过程中无需额外打开浏览器或保留终端窗口，应用会自动管理服务的启动、停止和恢复。

你可以通过点击左下角的「设置」按钮进入模型配置页面，在DeepSeek卡片中填写你的API Key。如果还没有API Key，可以前往DeepSeek开放平台进行申请。

这里有一个重要的使用习惯：配置API Key时不要进行截图操作，也不要将Key写入会提交到Git版本控制的文件中，避免密钥泄露。

4. 添加工作区与测试

回到主界面后，点击工作区旁边的添加按钮，选择你想要关联的项目文件夹。首次使用建议新建一个空的dsh-demo文件夹，不要直接选择用户主目录、下载目录或者存放私人文件的目录，避免意外修改敏感文件。

新建会话时建议保持默认配置：Agent选择标准模式，权限设置为Workspace Write，模型使用默认模型即可。

你可以发送第一条简单测试指令：「阅读当前目录，告诉我这里有哪些文件。先不要修改任何内容。」，如果工具能够正常返回目录文件信息，说明桌面版部署已经成功。

CLI版dsh-TUI部署教程

dsh-TUI是社区维护的终端界面工具，使用体验更接近Claude Code，适合喜欢全键盘操作的开发者使用。

项目官方仓库地址：https://github.com/ccch1mneyyy/dsh-TUI

1. 安装官方命令与工具

在终端中执行以下全局安装命令，完成官方Harness命令行工具和dsh-TUI的安装：

npm install -g @deepseek-ai/dsh@0.1.0-rc.6 @deepseek-harness-tui/dsh-tui@0.7.1

安装完成后，再次确认pnpm版本不低于10：

pnpm --version

2. 启动CLI界面

进入你想要关联的项目目录后，执行dsh-tui命令启动终端界面。第一次运行时，dsh-TUI会自动创建名为dsh-tui的配置文件并安装必要的插件，网络较慢时需要耐心等待片刻。

当你看到终端右上角显示dsh-TUI的版本号，以及底部的当前模型和工作区信息时，代表CLI界面已经加载完成。

3. 配置API Key

对于macOS和Linux系统，你可以在启动dsh-TUI的同一个终端中直接设置环境变量：

export DEEPSEEK_API_KEY='你的 DeepSeek API Key'
dsh-tui

如果你使用自定义的兼容网关端点，还需要额外添加环境变量配置：

export DEEPSEEK_BASE_URL='https://你的网关地址/v1'

同样需要注意：不要将API Key写入会提交到Git的脚本文件或者.env配置文件中。如果已经启动了TUI再修改环境变量，需要退出当前会话后重新运行才能生效。

4. 环境自检

进入dsh-TUI界面后，你可以输入/doctor命令进行环境自检，该命令会显示当前Node版本、系统架构、配置的模型信息、关联的工作目录、凭据状态和会话存储位置。

本次教程的隔离测试环境没有配置真实的API Key，所以自检结果会显示API key: not configured，但不影响其他基础项的正常检测。

5. 发送第一条测试任务

你可以输入以下测试指令来验证工具功能：「先阅读当前项目，不要修改文件。告诉我启动入口、主要依赖和最值得先修的一个问题。」

6. 常用命令与快捷键

以下是dsh-TUI的常用命令：

/help        查看所有命令和快捷键说明
/doctor      检查当前运行环境
/model       切换使用的AI模型
/preset      切换Agent预设配置
/permissions 查看权限说明
/new         新建会话
/resume      恢复历史会话
/compact     压缩过长的上下文内容
/cost        查看当前会话的token用量
/mcp         查看MCP连接状态
/theme       切换终端主题

常用的快捷键可以先记住这四个：

Enter        发送当前输入的消息
Shift+Enter  手动换行，不发送消息
Ctrl+C       中断当前对话回合；空闲状态下连按两次可以退出工具
Ctrl+O       展开或收起思考过程、工具参数和输出内容

7. 适用人群

dsh-TUI适合以下类型的用户使用：

  • 喜欢全键盘操作，偏好高效开发流程的用户
  • 经常在VS Code内置终端中编写代码的开发者
  • 需要通过SSH协议操作远程服务器的开发人员
  • 熟悉Claude Code的使用逻辑，希望快速上手终端工具的用户

8. 非交互CLI使用场景

dsh-TUI本身是交互式终端界面，如果你只需要在脚本或者CI流程中执行单次任务，可以使用官方提供的Headless Profile模式：

dsh --profile headless "阅读当前项目，输出模块清单和三个风险点"

该命令会直接打印最终结果后退出，适合批处理任务和自动化脚本使用，不建议首次使用工具时通过该方式入门。

如果本文对你有帮助，欢迎分享给更多需要的开发者。

以上内容不代表本平台立场，仅供读者参考