XMoon/dsh-pi-tui 预览 preview

XMoon/dsh-pi-tui

DeepSeek Harness (dsh) 的第三方 TUI 模式,基于 pi-tui 的私有分支构建。

Project Overview项目介绍

dsh-pi-tui is a terminal frontend built specifically for DeepSeek Harness (DSH) on top of the Pi TUI framework. It is distributed as a standalone DSH bundle on npm, and users must install it into a DSH profile after installing DSH itself to start using it. It provides a full set of terminal interactive features including streaming chat, tool call display, session management, subagent support, command history search, local shell integration, approval workflows, and settings panels. All core runtime capabilities such as model access, tool execution, and permission management are still handled by the underlying DSH installation.

To install the latest stable release, users first install DSH globally via npm with the required allow-scripts flag, then add the dsh-pi-tui package to the pi-tui profile, and launch DSH with that profile to start using it. The tool includes many quality-of-life features such as Focus Mode that aggregates in-progress thinking and tool calls, full session export to local markdown, cross-range input history search, a dedicated subagent task center, and two distinct local shell modes. It is designed for users who prefer working exclusively in a terminal environment and want to use DSH without a graphical interface.

The project requires Node.js version ^22.19.0 or any version 24 and higher to run, and there is a strict version compatibility matrix between dsh-pi-tui and DSH versions. Users are explicitly warned not to mix the stable release channel with the preview next channel, as this can cause unexpected incompatibility errors. dsh-pi-tui is open source under the MIT license, and it includes complete documentation for local development, testing, and third-party extension development.

dsh-pi-tui 是基于 Pi TUI 开发的 DeepSeek Harness(DSH)终端前端,需要作为独立的 DSH bundle 安装到 DSH profile 中使用,发布在 npm 注册表供用户下载安装。它提供流式对话、工具调用、会话管理、Subagent、历史搜索、Shell 交互、权限审批与设置等完整终端交互能力,模型、工具、会话、权限、Skills、规划等核心运行时能力仍由 DSH 本身提供。

用户需要先安装 DSH,再通过几条命令行即可完成 dsh-pi-tui 稳定版安装,之后指定 pi-tui 配置文件即可启动使用。它支持聚合过程内容的 Focus 模式、包含导出在内的完整会话管理、多范围输入历史搜索、Subagent 任务中心、两种本地 Shell 模式等功能,面向偏好终端工作环境、希望无 GUI 使用 DSH 的用户。

它要求环境依赖 Node.js 版本为 ^22.19.0 或 >=24,且 dsh-pi-tui 和 DSH 之间有严格的版本匹配要求,用户不能混用稳定版和 next 预览通道,否则可能出现不兼容问题。项目以 MIT 许可证开源,支持本地开发测试,同时提供完整的文档供开发者进行扩展开发。

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

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

READMEREADME

dsh-pi-tui

English | 简体中文

npm license

基于 Pi TUI 的 DeepSeek Harness 终端前端。

dsh-pi-tui 作为独立的 dsh bundle 安装到 profile 中,提供流式对话、工具调用、会话管理、Subagent、历史搜索、Shell、审批与设置等终端交互。模型、工具、Session、权限、Skills、Plan、Goal、Subagent 等运行时能力仍由 DeepSeek Harness 提供。

dsh-pi-tui

安装到 DSH Profile

Stable / latest

稳定版是普通用户的推荐渠道。请先安装 DSH,再将 TUI 添加到 pi-tui profile:

npm install -g --allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty @deepseek-ai/dsh@latest
dsh plugin --profile pi-tui -- add @xmoon76/dsh-pi-tui@latest
dsh --profile pi-tui

Next / npm 线(验证)

预览安装使用 DSH 的 alpha channel 与 TUI 的 next channel;安装 DSH 时需要显式允许其原生安装脚本:

npm install -g --allow-scripts=@deepseek-ai/dsh-subprocess-local,koffi,node-pty @deepseek-ai/dsh@alpha
dsh plugin --profile pi-tui -- add @xmoon76/dsh-pi-tui@next
dsh --profile pi-tui

隔离的 npm 驱动仍按本 checkout 声明的精确 DSH 版本运行,并执行完整的 build/test/package 路径:

pnpm compat:dsh:npm

具体的稳定版最低版本、next 兼容范围和回退路径见兼容性文档。

环境要求

  • DeepSeek Harness
  • Node.js ^22.19.0 || >=24

DSH 与 TUI 版本对应(重要)

TUI 包版本 对应的官方 DSH tags 说明
0.5.0(stable / @latest) dsh-v0.1.7-rc.2、dsh-v0.2.0-rc.1 当前稳定版;最低 0.1.7-rc.2,精确验证目标 0.2.0-rc.1
0.4.9(stable,历史) dsh-v0.1.7-rc.2 上一稳定版;0.1.7-rc.2 runtime 的兼容 TUI
0.4.8(stable,历史) dsh-v0.1.7-rc.1 上一稳定版;0.1.7-rc.1 runtime 的兼容 TUI
0.4.6(stable,历史) dsh-v0.1.5-rc.1、dsh-v0.1.5-rc.2 上一稳定版;0.1.5 runtime 的兼容 TUI
0.4.7-alpha.2(next,历史) dsh-v0.1.6-alpha.2 上一条 next 线;0.1.6-alpha.2 runtime 的兼容 TUI

不要把稳定线与 @next 预发布线混装。0.5.0 的整个 DSH peer floor 统一为 >=0.1.7-rc.2(rc.2 的 preset registry 精确 peer dsh-agent,更宽的旧 floor 已无法满足独立 tarball 安装),精确验证与推荐升级目标是已发布的 0.2.0-rc.1 family;旧 runtime 会在正常的不兼容边界以非零状态失败, 请按上表安装配对的 TUI 线。完整的历史兼容矩阵和 fallback 命令见 兼容性文档;要查看 @next 的最新集成状态,请看 next 分支 README。

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-deepseek-usage-panel 下一个 Next dsh-update-checker →