前言¶
DSH 的插件化思路，是把扩展能力拆成可安装、可启用的插件。对于希望在终端里使用 DeepSeek Harness 的开发者来说，dsh-tui 解决的是一个具体问题：把 DSH 包装成一个 minimal TUI，也就是一个 interactive terminal surface for DeepSeek Harness。它由 xiaoshihou514 维护，许可证为 MIT。
这里需要区分一下：社区插件目录是独立站点，不等于官方应用商店；本文也不把 dsh-tui 写成 DeepSeek / 幻方的官方组件。下面基于已核实事实介绍它是什么、怎么装、怎么启用，以及安装前需要看哪些东西。
这是什么¶
dsh-tui 的一句话定位是：
A minimal TUI for DSH.
在已核实资料里，它的另一个描述是：
An interactive terminal surface for DeepSeek Harness
也就是说，它不是另一个独立聊天客户端，而是给 DSH 提供终端交互形态的插件。维护者是 xiaoshihou514，许可证是 MIT。
核心功能¶
已核实的能力比较直接：
- 为 DSH 提供 minimal TUI。
- 作为 DeepSeek Harness 的交互式终端界面。
- 插件通过 DSH profile 启用，示例命令是
dsh --profile tui。 - 插件包含
dsh bundle patch配置，指向./cordis.patch.yml。
这里的 dsh bundle patch 可以理解为插件对 DSH bundle 的补丁声明。已核实资料中的配置为：
{
"dsh": {
"bundle": {
"patch": "./cordis.patch.yml"
}
}
}
安装与启用¶
已核实资料给出的命令序列是：
npm i -g @deepseek-ai/dsh
dsh plugin --profile tui add "github:xiaoshihou514/dsh-tui#main"
第一条命令用于全局安装 @deepseek-ai/dsh。已核实资料没有明确说明这条命令是否是安装 dsh-tui 的必要前置步骤；如果本机已经具备可用的 DSH CLI，可以直接执行第二条。
第二条命令在 tui profile 下添加插件：
dsh plugin --profile tui add "github:xiaoshihou514/dsh-tui#main"
添加完成后，用下面的命令启用这个 profile：
dsh --profile tui
典型用法¶
典型路径很短：
1、全局安装 DSH CLI（如果尚未安装）：
npm i -g @deepseek-ai/dsh
2、在 tui profile 中添加 dsh-tui：
dsh plugin --profile tui add "github:xiaoshihou514/dsh-tui#main"
3、以 TUI profile 启动 DSH：
dsh --profile tui
这个用法的关键在于 --profile tui。它不是普通的一次 dsh 调用，而是把 dsh-tui 放到一个独立的 profile 里运行，便于和其他 DSH 插件或配置分开。
环境与依赖¶
已核实资料里能确认的运行环境信息如下：
"engines": {
"node": "^22.19.0 || >=24"
}
这意味着 Node.js 版本建议落在 ^22.19.0 或 >=24。另外，package.json 声明了包管理器：
"packageManager": "pnpm@11.19.0"
以及发布访问配置：
"publishConfig": {
"access": "public"
}
在 peerDependencies 方面，已核实资料确认包含以下版本约束：
{
"@deepseek-ai/cordis": "^4.0.0",
"@deepseek-ai/cordis-plugin-loader": "^1.0.2",
"@deepseek-ai/dsh-agent": "^0.1.0-rc.5"
}
完整 peerDependencies 列表在已核实资料中被截断，不能据此判断全部依赖。安装前建议直接查看仓库里的 package.json。
适用场景与注意¶
适合这些场景：
- 你已经在用 DSH，但希望有一个 terminal TUI 的交互入口。
- 你希望在
tuiprofile 下单独启用终端界面，不直接影响其他 profile。 - 你想找一个 MIT 许可、由社区维护的 DSH 插件。
安装前建议做三件事：
1、检查源码。插件以当前 dsh 进程权限运行，代码能影响该进程内的行为。
2、检查许可证和依赖。本文已核实许可证为 MIT；peerDependencies 列表存在截断，需要以仓库 package.json 为准。
3、确认 DSH 版本兼容性。npm i -g @deepseek-ai/dsh 出现在已核实用法示例中，但是否为必要前置步骤未明确说明，建议根据本机 DSH 安装状态判断。
社区目录链接只表示该插件有一个目录页入口，不代表它是官方应用商店中的组件。
