快速开始

August 26, 2026 · View on GitHub

dsh-tianshu-tui 是官方 DeepSeek Harness 的交互式终端 UI 插件。本文带你从零跑起来。 更详细的安装说明见根 README「安装」一节。

前置条件

  • Node.js ^22.19 || >=24
  • PATH 上有 pnpm(dsh plugin 会转发给它)
  • 运行模型需要 API key:环境变量 DEEPSEEK_API_KEY(或用官方 CLI 的登录流程)

不要直接敲 dsh。 若 PATH 上已有旧的 dsh(如 ~/.local/bin/dsh, dsh --version 不是 0.1.0-rc.6),会走到本地 staging,出现 ERR_FS_EISDIR / Path is a directory .../@deepseek-ai/dsh。请始终用下面的 npx 命令。

安装

# 1. 把插件装进 tui profile
npx -y @deepseek-ai/dsh plugin --profile tui add @huiliyi37/dsh-tianshu-tui

# 2. 启动
npx -y @deepseek-ai/dsh --profile tui

看到欢迎页品牌 dsh-tianshu-tui 即成功。Ctrl+Q 或 /exit 退出。

  • pnpm 可能提示 peer missing,可忽略:peer 由官方 dsh 宿主提供。
  • 已全局安装官方 CLI 且版本正确时,把 npx -y @deepseek-ai/dsh 换成 dsh。
  • 从 Git 安装:dsh plugin --profile tui add github:huiliyi37/dsh-tianshu-tui。

首次使用

启动后你会看到:

  • 欢迎页:品牌头 + 会话短 id + 环境检查行(API key / git 是否就绪)
  • 顶部栏:📁 cwd · 模型 · (git 分支 ●未提交数)
  • 底部三行:输入行(圆角框体)→ footer(模式徽标 + 快捷键提示)→ metrics 行 (模型 / 成本 / 上下文% / tokens / 耗时)

直接输入问题回车即可开始对话。常用操作:

想做什么怎么做
查看全部快捷键Ctrl+.
切换模型/model(回车后 ↑↓ 选择)或 /model <provider/model>
切换主题/theme(回车后 ↑↓ 选择)
新会话 / 恢复会话Ctrl+N / Ctrl+S
中断当前回复Ctrl+C
退出Ctrl+Q

常见问题

ERR_FS_EISDIR / Path is a directory ... ~/.dsh/profiles/node_modules 里有旧的安装 fallback 与官方 CLI 冲突。换干净目录:

DSH_HOME=/tmp/dsh-tianshu npx -y @deepseek-ai/dsh plugin --profile tui add @huiliyi37/dsh-tianshu-tui
DSH_HOME=/tmp/dsh-tianshu npx -y @deepseek-ai/dsh --profile tui

提示"插件已更新到 …,请重启 dsh 后生效" 自更新机制把 profile 里的包升到了 npm 新版本,重启即可。

不想联网检查更新 设 DSH_TUI_SKIP_UPDATE=1。

图片发不出去/模型说看不见图片 主模型不识图时,装配视觉桥插件(dsh-vision-bridge,provide visionBridge 服务) 或注入 vision 配置;两者皆无则图片不发送并警告(这是有意的 fails loud)。

需要模型可调 LSP 工具面 装配社区插件 omdsh-dev/dsh-lsp;TUI 展示桥 自动消费其 lsp 服务,与模型工具面共享同一 LSP server 集。

/preset 提示「agent-presets 服务不可用」 更新到本包含 agent 面装配的版本（plugin add 本包会连带装上官方预设包）。 命令是 /preset,不是 /presets。已装旧版的 profile 自更新后会带上新依赖。

下一步