dsh-TUIEN
安装与快速开始

dsh-TUI 安装与快速开始

从准备运行环境到进入第一个 DeepSeek Harness TUI 会话，这里集中说明安装、启动和日常更新所需的步骤。

本页内容
  1. 运行环境要求
  2. 整合包安装（新手推荐）
  3. npm 一键安装
  4. 首次启动与会话恢复
  5. 更新与故障排查

运行环境要求

dsh-TUI 是 DeepSeek Harness 的终端界面插件，需要真实终端 TTY。推荐使用支持现代终端能力的 Windows Terminal、iTerm2、kitty、WezTerm、Ghostty 或常见 Linux 终端。

  • Node.js ^22.19 或 24 及以上版本
  • pnpm 10 或更高版本
  • 官方 @deepseek-ai/dsh CLI
  • 运行模型所需的 DEEPSEEK_API_KEY

整合包安装（新手推荐）

不会敲命令？从官网首页下载整合包，解压后双击 install.bat（macOS / Linux 运行 sh install.sh）。脚本会自动检查并安装 Node.js（Windows 下通过 winget）、pnpm、官方 dsh CLI 与 dsh-TUI，并引导配置 DEEPSEEK_API_KEY，全程只需按几次回车。

  • 官网直链：https://dshtui.com（国内可直接访问）
  • GitHub 镜像：ccch1mneyyy/dsh-TUI Releases 的 dsh-tui-setup.zip
  • npm 官方源失败时脚本自动切换 npmmirror 镜像

npm 一键安装

全局安装官方 CLI 与 dsh-TUI 插件。插件会提供 dsh-tui 直达命令，不需要手动修改 DSH 核心文件。

npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui

首次启动与会话恢复

首次运行会自动初始化 dsh-tui profile。后续可以直接启动新会话，或使用 --resume 恢复上一次会话。

dsh-tui

# 恢复最近会话
dsh-tui --resume

更新与故障排查

TUI 会在后台检查 npm 新版本，发现更新后可输入 /update 自动更新并重启恢复会话。若启动失败，先确认 Node、pnpm 和 dsh 命令均能在当前终端中执行。

  • 使用 node --version 与 pnpm --version 核对版本
  • 使用 /doctor 检查环境和配置
  • 确认 API Key 已注入当前 Shell
  • Windows 下优先使用 Windows Terminal 或 PowerShell 7