dsh-tui/dsh-tui 预览 preview

dsh-tui/dsh-tui

为DeepSeek Harness代理提供Claude Code风格的终端UI,作为一个树外dsh插件包。

Project Overview项目介绍

This repository is a DSH-native terminal user interface (TUI) bundle for DeepSeek Harness agents, providing a Claude Code / Codex-style interactive chat experience directly in your terminal. It is distributed as an out-of-tree DSH plugin bundle that builds on the official @deepseek-ai/dsh-base bundle, so you get full access to the entire DSH plugin ecosystem including shell tools, filesystem utilities, custom skills, and pre-built workflows, with no forked code required. To install it, you first need to have Node.js version 22.19 or newer and the DSH CLI installed globally via npm, then run the dsh plugin add command to install it to a new profile.

Once installed, you can launch a new DSH TUI session in your current working directory with a simple dsh command, or resume an existing saved session by passing the session ID to the --resume flag. It supports streaming model output and reasoning rendered as Markdown, collapsible tool call cards, built-in approval dialogs, path auto-completion for file references, and a suite of configurable slash commands to manage models and sessions. A standing todo panel, context pressure and token usage status bar, and customizable color themes are all included out of the box to tailor the experience to your preferences.

dsh-tui is under active development and targets the pre-release release candidate line of DSH, so users should expect occasional breaking changes until upstream DSH stabilizes. It is distributed under the open-source MIT license, with the original TUI code recovered from the DeepSeek Harness repository history and upstream copyright preserved. You can use it with DeepSeek's official cloud API or self-host a local DeepSeek-compatible endpoint on your own hardware, which requires only a simple one-line configuration change to your DSH settings file, no extra steps needed.

这是DeepSeek Harness生态下的一款原生交互式终端前端(TUI),作为DSH插件包发布,为DSH代理提供类似Claude Code / Codex风格的终端聊天界面。它基于@earendil-works/pi-tui开发,叠加在官方的@deepseek-ai/dsh-base包之上,可完整复用DSH官方Web端已有的全部插件生态、工具、技能和工作流,无需二次分叉改造。

开发者可以通过DSH CLI安装,要求Node版本为^22.19或更高,安装后可通过dsh命令在当前目录启动新会话,也可恢复已保存的历史会话。它支持流式模型输出推理、工具调用卡片展示、计划审核、路径自动补全、待办面板、令牌用量统计等功能,还可根据终端环境自动检测真彩色,支持配置自定义主题。

项目目前处于活跃开发阶段,依赖预发布版本的DSH,在上游稳定前可能存在不兼容变更。项目基于MIT许可证发布,原始TUI实现源自DeepSeek Harness仓库历史,保留原有上游版权。使用本工具需要配置DeepSeek API密钥,同时也支持本地部署DeepSeek兼容端点接入。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 35 stars - an early-stage project星标 35,属于早期项目
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-tui/dsh-tui

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

READMEREADME

@dsh-tui/dsh-tui

English | 中文

An interactive terminal (TUI) front door for DeepSeek Harness agents — a Claude Code / Codex-style chat interface in your terminal, installed as an out-of-tree dsh plugin bundle. Built on @earendil-works/pi-tui.

It composes over the official @deepseek-ai/dsh-base bundle, so the whole plugin ecosystem — shell and filesystem tools, skills, subagents, workflows, sandbox approvals — is the same one the official web surface uses. Nothing is forked.

A dsh-tui session

Features

  • Streaming model output and reasoning, rendered as Markdown
  • Tool-call cards with terminal / diff / generic render intents; Ctrl+O cycles collapsed → expanded → hidden
  • Approval and ask_user_question dialogs, plan-mode review included
  • @file path autocomplete and @session reference cards
  • Slash commands: /model (with reasoning-effort selection), /resume, /compact, /details, /help, and every command other plugins register
  • Standing todo panel, token usage and context-pressure status line, session titles
  • Configurable theme; truecolor detected from COLORTERM

Install

Requires Node ^22.19 || >=24 and the dsh CLI (npm i -g @deepseek-ai/dsh@next).

dsh plugin --profile tui add @dsh-tui/dsh-tui
dsh --profile tui                                      # start a session in the current directory
dsh --profile tui --resume <session-id>                # resume a persisted session

To track the repo instead of the npm release, use add github:dsh-tui/dsh-tui. Git-hosted plugins build on install via their prepare script, which pnpm blocks until you allow it: if that add fails, append the key it prints under allowBuilds in ~/.dsh/profiles/tui/pnpm-workspace.yaml and re-run —

allowBuilds:
  "@dsh-tui/dsh-tui": true

Set DEEPSEEK_API_KEY in your environment (or a .env in the launch directory or $DSH_HOME).

Local / self-hosted DeepSeek endpoints

No code changes needed — pick one:

  1. Environment: DEEPSEEK_BASE_URL=http://localhost:8000/v1 alongside DEEPSEEK_API_KEY.
  2. Settings (hot-reloaded): $DSH_HOME/settings.yaml

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-interconnect 下一个 Next dsh-plugin-session-delete →