DEEPSEEK HARNESS · 终端版

把 DeepSeek Harness搬进终端。

读代码、运行工具、与 Agent 一起完成工作。DeepSeek Harness 的能力,在你熟悉的终端里展开。

macOS · Linux · Windows Terminal运行时 0.2.1-rc.5

dsh-tui 界面示意
> 修一下挂了的 scroll 测试
任务已完成 · 过程详情
⏺ read_file({"file_path":"src/render/scroll.ts"}) ✓ 84 行
⏺ edit_file({"file_path":"src/render/scroll.ts"}) ✓
⏺ bash("pnpm vitest run scroll") ✓ 12 通过
结果

✔ estimateEntryRows 现在把(还有 N 条)那行也算进去了

问 dsh 任何问题…
tui-01e62198deepseek-v4-flashworkspace-write
一个需求,看得见的过程,清晰的结果。

专注你的工作

少一点切换,多一点专注。

不离开代码,不打断思路。选模型、接工具、继续上次的对话,都在终端里完成。

带选择器的斜杠命令

/model 、/permission 、/mcp add、/skill 都会弹出选择器,列出真正挂载了的东西 —— 选一个,不用猜名字。

系统命令转义

!git status 直接跑并把输出显示出来;!! 还会把它交给模型。!cd 切了目录就一直生效。

文件提及

@src/pro 加 Tab 把完整路径补进你的消息。不会在背后偷偷读文件 —— 模型拿路径自己用工具打开。

图片附件

把图片拖到终端里,路径会从正文摘掉、作为附件发出,消息里留一行 chip 说明发了什么。

审批会留下记录

需要你点头的工具调用会弹出带参数的卡片。答案留在 transcript 里,所以恢复会话时不会看到一个"莫名没跑"的调用。

Skills

/skill 列出你的装配挂载的、允许用户调用的 skill。Tab 填进命令行,Enter 直接跑。

随时接回的 session

/sessions 列出存下来的会话,/resume last 回到最新那条,/history hide 让 transcript 从新内容开始。

融入你的环境

/theme dark|light 会先 OSC 11 探测你的终端,/language en|zh 切换界面语言,/keybinds vim 加一层 normal 模式。

从这里开始

打开终端,进入工作状态。

选择你使用的终端,安装匹配的运行时,再连接自己的模型。

完整安装指南、密钥配置与故障恢复
Node ≥ 22.19npm + Gitcurl / curl.exe

选择终端,开始安装

macOS / Linux
curl -fsSL --connect-timeout 15 --max-time 120 https://raw.githubusercontent.com/Qyn77/dsh-tui/main/install.sh | bash

macOS / Linux

Windows · PS7
curl.exe -fsSL --connect-timeout 15 --max-time 120 https://raw.githubusercontent.com/Qyn77/dsh-tui/main/scripts/install.mjs -o "$env:TEMP\dsh-tui-install.mjs" && node "$env:TEMP\dsh-tui-install.mjs"

Windows PowerShell 7

curl.exe 下载脚本,随后由 Node 执行。请先装好 PowerShell 7,运行 TUI 使用 Windows Terminal + PowerShell 7;不要把这条命令粘到系统自带的 PowerShell 5.1。

Windows · CMD
curl.exe -fsSL --connect-timeout 15 --max-time 120 https://raw.githubusercontent.com/Qyn77/dsh-tui/main/scripts/install.mjs -o "%TEMP%\dsh-tui-install.mjs" && node "%TEMP%\dsh-tui-install.mjs"

Windows CMD —— 仅用于安装;运行请用 Windows Terminal + PowerShell 7

curl.exe 下载脚本,随后由 Node 执行。请先装好 PowerShell 7,运行 TUI 使用 Windows Terminal + PowerShell 7;不要把这条命令粘到系统自带的 PowerShell 5.1。

前置条件与安装详情

先准备 Node ≥ 22.19(含 npm)、Git、curl,以及能访问 GitHub/npm 的网络。安装器会检查环境,缺少条件时停止并提示;不会自动安装系统前置工具。

  • 以上命令三选一。Windows 即使通过 CMD 安装,也需要先装好 PowerShell 7。
  • 从当前源码构建,launcher/base/TUI 固定为 0.2.1-rc.5。无需全局 dsh 或 pnpm,不要替换为 npm latest/next。
  • 检查目录写权限、至少 1 GiB 空间和依赖源连接,激活前验证原生模块。源码构建和备份可能需要更多空间。
Windows 为什么也用 curl?

Windows 10(1803 起)和 Windows 11 自带 curl.exe。它负责下载脚本,Node 负责执行安装。写成 curl.exe 是为了避免 Windows PowerShell 5.1 中 curl 别名的歧义。本站 PowerShell 命令需要 PowerShell 7;CMD 的环境变量语法不同,请选择对应标签。

微软官方:Windows 中的 curl ↗

连接你的模型

使用 DeepSeek 官方 API 时,在本地编辑 ~/.dsh/.env(Windows 为 %USERPROFILE%\.dsh\.env),保留其他配置,将下面占位符换成自己的 Key。不要把真实密钥发到聊天或提交到仓库。

.env
DEEPSEEK_API_KEY=YOUR_DEEPSEEK_API_KEY
凭据优先级与第三方 API
  • macOS/Linux 保存后执行 chmod 600 ~/.dsh/.env;记事本保存为 .env,不要变成 .env.txt。自定义 --home / DSH_HOME 时使用实际目录。
  • 凭据优先级:托管 .credentials.yaml → 进程环境变量 → 项目 .env → home .env。已由桌面版管理的同名 Key,请从桌面版凭据设置更新。
  • 第三方 API 还需要在 TUI profile 配置对应服务地址、模型和凭据映射。

回到终端,开始对话

新开终端,然后启动
dsh-tui

Windows 需完全退出再打开 Windows Terminal,并使用 PowerShell 7。修改凭据后重启 TUI,通过 /provider 和 /model 选择提供方与模型。

已经安装了 Harness 桌面版?
  • 相同 DSH_HOME 可共用凭据存储与 home 根配置;桌面版专属模型、默认模型和插件配置不会自动导入 TUI profile。
  • 安装器独立安装固定版本的 Harness 运行时。桌面版内置 Node 不能替代终端 PATH 上的 Node/npm/Git;桌面版本身不是前置条件。
  • 2026-11-09 核对了桌面版 0.2.2-rc.1 与 TUI 运行时 0.2.1-rc.5 的存储兼容性,未发起真实模型请求:能打开界面不等于凭据有效。自动导入桌面版配置仍是待办。

需要时,随手查阅

上手最先会用到的几条

常用操作,一个斜杠就能找到。需要时展开,不必记住每条命令。

完整的命令与按键表
/help
打印可用的斜杠命令
/model
显示当前模型;/model 打开所有已挂载 provider 的选择器
/mcp
已连接的 MCP 服务器和它们的工具;/mcp add 连一个新的
/permission
选择「沙箱 + 审批」打包预设
/context
上下文窗口、本次 session 的 token 开销、当前占用多少
/copy
把最新回复用 OSC 52 送进剪贴板 —— SSH 下也有效
! <命令>
跑一条系统命令;!! 还会把它给模型看
/exit
退出 REPL
看文档 ↗