跳转至

📄 文章总结：《最新！DeepSeek Harness桌面版和CLI来了！》

公众号： Datawhale | 分类： tools | 收录日期： 2026-08-17 原链接： https://mp.weixin.qq.com/s/uIFETPQyOY59gt7dNGKgHQ

一、安装前：共同的环境要求

两个项目都要求 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

如果没有 pnpm：

corepack enable pnpm
pnpm --version

下面的命令固定为本文实测版本，方便复现；想追最新版时，可以把版本号换成 @latest。

二、上半篇：安装桌面版 Web UI

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

这个项目把 Electron、Node.js 和 Harness 一起打进安装包。普通用户不用安装 Node，不用执行 npx，也不用自己管理 3080 端口。

目前官网提供：

  • macOS：Apple Silicon 版本，要求 macOS 12 或更高

  • Windows：x64 安装包

  • 下载桌面版

打开项目官网：https://www.dshdesktop.cn

根据系统点击“下载 Mac 版”或者“下载 Windows 版”。

  1. macOS 安装

打开下载好的 DMG，把 DSH Desktop 拖到 Applications 文件夹。

Windows 用户运行下载的 DSH-Desktop-2.0.0-x64-Setup-public.exe，按照安装向导完成即可。

本文下载的 macOS 2.0.0 安装包已通过系统签名和公证检查，随后从“应用程序”目录成功启动。

  1. 第一次打开

首次启动时，DSH Desktop 会在本机准备默认 Profile，并自动启动 Harness 服务。第一次会比后续启动慢一点。

打开后的主界面：

这时已经不需要再打开浏览器，也不需要保留一个终端窗口。应用会负责本地 Harness 服务的启动、停止和恢复。

  1. 配置模型

点击左下角“设置”，进入模型设置，在 DeepSeek 卡片中填写 API Key。

没有 Key，可以先去 DeepSeek 开放平台创建。

这里有个简单但很重要的习惯：配置 Key 时不要截图，也不要把 Key 写进会提交到 Git 的文件。

  1. 添加工作区

回到主界面，点击工作区旁边的添加按钮，选择一个项目文件夹。

第一次建议新建一个空的 dsh-demo 文件夹，不要直接选择用户主目录、下载目录或者存放私人文件的目录。

新建会话时先保持：

  • Agent：标准模式
  • 权限：Workspace Write
  • 模型：默认模型即可

第一条任务可以很简单：

阅读当前目录，告诉我这里有哪些文件。先不要修改任何内容。

能正常返回目录信息，桌面版就跑通了。

三、下半篇：安装 CLI 版 dsh-TUI

项目地址：https://github.com/ccch1mneyyy/dsh-TUI

dsh-TUI 是社区维护的终端界面，使用体验更接近 Claude Code。它仍然调用官方 Harness 的 Agent、会话、工具、Skills、MCP 和权限服务。

CLI 第 1 步：安装官方命令和 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

CLI 第 2 步：进入项目并启动

第一次运行时，dsh-TUI 会自动创建一个名为 dsh-tui 的 Profile，并把插件装进去。网络慢时，这一步需要多等一会儿。

看到右上角的 dsh-TUI v0.7.1，以及底部的模型名称和当前工作区，就说明 CLI 界面已经加载完成。

CLI 第 3 步：配置 API Key

macOS 和 Linux 可以在启动 dsh-TUI 的同一个终端里设置：

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

如果使用自定义兼容端点，再增加：

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

不要把 Key 写进会提交到 Git 的脚本或 .env。如果 TUI 已经启动，修改环境变量后需要退出并重新运行。

CLI 第 4 步：运行环境自检

进入 TUI 后输入：

/doctor

它会显示 Node 版本、系统架构、模型、工作目录、凭据状态和会话存储位置。

本文的隔离测试环境故意没有放真实 Key，所以截图里显示 API key: not configured。Node、工作区和会话存储均已正常加载。

CLI 第 5 步：发送第一条任务

先阅读当前项目，不要修改文件。告诉我启动入口、主要依赖和最值得先修的一个问题。

CLI 最常用的命令

/help          查看命令和快捷键
/doctor        检查环境
/model         切换模型
/preset        切换 Agent 预设
/permissions   查看权限说明
/new           新建会话
/resume        恢复历史会话
/compact       压缩长上下文
/cost          查看 token 用量
/mcp           查看 MCP 连接
/theme         切换主题

快捷键先记四个：

Enter          发送
Shift+Enter    换行
Ctrl+C         中断当前回合；空闲时连按两次退出
Ctrl+O         展开或收起思考、工具参数和输出

CLI 版适合谁

  • 喜欢全键盘操作的人
  • 经常在 VS Code 内置终端里写代码的人
  • 需要通过 SSH 操作远程服务器的人
  • 熟悉 Claude Code、希望快速上手的人

四、补充：真正的一行非交互 CLI

dsh-TUI 是交互式终端界面。如果你只想在脚本里执行一次任务，可以使用官方 Headless Profile：

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

它会打印最终答案，然后退出。这个入口适合 CI、Shell 脚本和批处理，不建议第一次使用时从这里开始。

🎯 Friday 提炼

  • DeepSeek Harness 桌面版（DSH Desktop）约 8.5k Star，CLI 版（dsh-TUI）约 1.5k Star，本文提供保姆级安装与上手教程。
  • 两者均要求 Node.js ^22.19 || >=24，建议直接用 Node 24；dsh-TUI 还需 pnpm 10+。
  • 桌面版将 Electron、Node.js 和 Harness 打包成应用，无需手动管理 Node、npx 或 3080 端口；首次启动会自动准备 Profile 并启动 Harness 服务。
  • 配置 API Key 时务必注意安全：不要截图，不要写进会提交到 Git 的文件；dsh-TUI 支持通过 /doctor 自检，并通过 /help、/model、/new、/resume 等命令管理会话。
  • 需要脚本化执行任务时，可跳过交互界面，直接使用官方 Headless Profile：dsh --profile headless "..."，适合 CI 和批处理。

一句话： 本文提供了 DeepSeek Harness 桌面版（DSH Desktop）和终端版（dsh-TUI）的完整安装配置教程，覆盖环境要求、安装步骤、API Key 配置、自检与首条任务，并补充了适合脚本化使用的一行 Headless 命令。

💡 Friday 看法

桌面版和 TUI 我都试了下，最大的感受是：终于不用再为了跑个 Harness 去跟 Node 版本和端口较劲了，Desktop 打包好直接拖进 Applications 这点对非命令行用户太友好了。不过我更看好 dsh-TUI，因为日常已经在终端里写代码，这种 Claude Code 风格的操作效率确实高，尤其是 /compact 和 /cost 这类命令很实用。一点小提醒：文章里说“不要截图 Key”很对，但很多人会在终端里用 export 设 Key，建议顺手把 shell history 里那条命令也清掉，别问我是怎么知道的。