cyjyyd/dsh-ssh-tui 预览 preview

cyjyyd/dsh-ssh-tui

DeepSeek Harness 增强插件:dsh-tui。你可以在终端中使用DeepSeek Harness,在SSH环境下性能优化。

Project Overview项目介绍

dsh-ssh-tui is a native DeepSeek Harness terminal plugin built specifically for remote SSH workflows, such as working on corporate jump servers, headless servers, or connections with high latency. Unlike the official headless mode that only outputs the final result to stdout after a full task completes, this plugin renders the entire workflow process in real time directly in your terminal. It uses pure ANSI incremental rendering and does not require a browser to run. To install it, you can use the official DSH CLI without cloning the repository locally: run dsh plugin --profile tui add dsh-ssh-tui@latest then launch it with dsh --profile tui.

This plugin packs a full set of terminal UI features optimized for low-bandwidth connections, including folding model thinking by default to save space, card-based display of tool calls, git-style diff displays for file edits, and scrollable history for past session review. It also supports Codex-style auto-approval, which automatically allows safe operations like reading files and editing workspace code, rejects inherently dangerous commands such as sudo and curl|sh, and sends ambiguous unclassifiable commands to a sub-agent for AI review. It is ideal for developers who primarily work and code via SSH connections on remote servers.

dsh-ssh-tui requires Node.js version 22.19 or higher, and a pre-installed DeepSeek Harness CLI to function properly. It supports a wide range of configuration options via environment variables, such as adjusting the render interval for weak networks, disabling terminal bells, setting terminal color depth, and enabling a pure line mode that is friendly to screen readers and output logging. It is open source under the permissive MIT license, so users can freely use, modify, and distribute the code without any commercial or non-commercial restrictions.

dsh-ssh-tui 是专为 DeepSeek Harness 开发的原生终端插件,面向跳板机、无桌面服务器和高延迟 SSH 连接场景设计。它采用纯 ANSI 增量重绘技术,不需要浏览器即可运行,能在终端中完整渲染 DeepSeek Harness 的全工作流交互过程,而非像官方 headless 模式那样只输出最终结果,非常适合仅通过终端操作远程服务器的开发场景。

它支持模型思考流、工具调用、子代理进度的实时流式展示和 markdown 渲染,对非核心内容默认折叠节省屏幕空间。同时支持类 Codex 的自动审批模式,自动放行安全操作、拒绝危险命令,对无法判定的操作还可接入子代理 AI 复核。用户可通过 DSH 官方 CLI 一键安装,不需要本地克隆仓库,替换 profile 名称即可安装到自定义配置文件。

它要求 Node.js 22.19 及以上版本,需要预先安装好 DeepSeek Harness CLI,兼容 Windows、Linux、macOS 下绝大多数常见终端。它支持多种环境配置选项,比如为弱网调整刷新间隔、关闭终端响铃、开启适合读屏器的纯行模式等。项目采用 MIT 许可证开源,用户可免费使用、修改和分发代码。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 2 stars - very few users, little community feedback星标只有 2,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile tui add dsh-ssh-tui@latest

把 cyjyyd/dsh-ssh-tui 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-ssh-tui

npm npm downloads CI dshfind

A resilient terminal frontend for DeepSeek Harness.

纯 ANSI · 增量重绘 · SSH 断线重接 · Windows / ConPTY · Host-aware activation · 无需浏览器

连接可以断,终端可以换,Harness 可以升级;正在工作的会话不应该因此变得脆弱。

English: README.en.md


30 秒开始

需要 Node.js ≥ 22.19 和 DeepSeek Harness CLI。

npm i -g @deepseek-ai/dsh
dsh plugin --profile tui add dsh-ssh-tui@latest
dsh --profile tui

恢复旧会话:

dsh --profile tui --resume

更新:

dsh plugin --profile tui add dsh-ssh-tui@latest

dsh plugin 由 profile 内的 pnpm 管理依赖。更新时请显式带 @latest,否则已有 lockfile 可能继续沿用旧版本。

Windows 用户见 Windows 指南。


为什么会有这个 TUI

DeepSeek Harness 已经有 Web、headless 和不断扩展的插件生态。

dsh-ssh-tui 不试图把浏览器搬进终端。

它解决另一类问题:

连接不可靠

SSH 会断、笔记本会合盖、网络会切换、跳板机会超时。

正在运行的回合不应该因为显示终端消失,就和整个 Harness Host 一起死亡。

dsh-ssh-tui 将 Host 与显示端分离:

Harness session
      │
      ▼
   TUI Host
      │
      ├── 当前 SSH / terminal
      │
      └── 断线后重新 attach

忙碌中的 Host 可以在显示端离开后继续存在;重新连接后,同一条命令即可接回。


终端环境并不统一

Linux PTY、Windows ConPTY、SSH、旧控制台、不同 OSC / mouse / clipboard 能力,并不是同一种终端。

本项目不会假定:

process.stdin/stdout == terminal == display == host

而是显式区分:

Harness Host
    ↓
Display Transport
    ↓
Terminal Capability

TTY 是一种能力,不是宿主存在的前提。

这也是为什么在没有真实终端的 Host 中,插件应该安全地不激活,而不是让宿主一起崩掉。


Harness 本身仍在快速变化

本项目把 兼容性当成功能维护,而不是发版后顺便测试。

当前声明窗口:

DeepSeek Harness 状态
0.1.7-rc.1 / 0.1.7-rc.2 ✅ 支持
0.2.0-rc.1 / 0.2.0-rc.2 ✅ 支持
0.1.5 及更早 ❌ 自 dsh-ssh-tui 0.8.0 起不再支持

声明范围:

>=0.1.7-rc.1 <0.1.8
|| >=0.2.0-rc.1 <0.2.1

发布前会针对支持线重新安装依赖并运行类型检查、测试和真实终端探针。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-math-olympiad 下一个 Next dsh-remote-explorer →