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 许可证开源,支持本地开发测试,同时提供完整的文档供开发者进行扩展开发。
请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】,检查通过再动手。
插件:dsh-pi-tui(XMoon/dsh-pi-tui)
仓库:https://github.com/XMoon/dsh-pi-tui
本站详情页:https://www.yhbd.top/plugins/xmoon-dsh-pi-tui/
本站登记:类型 client · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 19 · 最近提交 2026-10-03 · 主语言 TypeScript
按下面顺序执行,每步先把结论告诉我,再进入下一步:
【1 兼容性检查】
① 我这边:DSH 版本、Node 版本、操作系统、当前 profile(web / desktop)。
② 读它的 README、package.json、插件 manifest,列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对,结论只写「满足 / 不满足 / 未知」三种;不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突:命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。
【2 安全性检查】
① 仓库可信度:和上面「本站登记」是否一致;star / fork 数、创建时间、最近提交,是否归档或长期停更。
② 安装脚本:逐行看 package.json 的 preinstall / install / postinstall,以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名,立刻停下来告诉我,不要继续装。
③ 依赖:列出新增依赖,标出无人维护、或与知名包拼写近似的可疑包(typosquatting)。
④ 权限与副作用:它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限(filesystem / network / shell / clipboard 等),以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限,或权限明显超出功能所需,先停下来问我。
【3 安装】
上面两步没有「不满足」和「高危项」时才执行;用官方推荐方式安装,不要自行提权。
【4 汇报】
用表格输出:检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜,也不要替我决定。
Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH:它会先核对兼容性与安全性(逐条给「满足 / 不满足 / 未知」),确认没问题再安装,有高危项会停下来问你。框内可滚动,复制到的是完整提示词;安装命令不一定准确,发给 DSH 更稳。
- 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 | 简体中文
基于 Pi TUI 的 DeepSeek Harness 终端前端。
dsh-pi-tui 作为独立的 dsh bundle 安装到 profile 中,提供流式对话、工具调用、会话管理、Subagent、历史搜索、Shell、审批与设置等终端交互。模型、工具、Session、权限、Skills、Plan、Goal、Subagent 等运行时能力仍由 DeepSeek Harness 提供。

安装到 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 →
reactive-resume/reactive-resume
PM-Shawn/Abu-Cowork
WSK-build/DSHBox
FlashingChen/dsh-desktop-hub
sagirimo/BioDSH
Nexus-Aethra/DSHBox