dsh-TUIEN

GETTING STARTED

dsh-TUI 安装与快速开始

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

运行环境要求

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

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