dsh-tianshu-tui 是官方 DeepSeek Harness 上的交互式终端 TUI 面板插件仓库 huiliyi37/dsh-tianshu-tui 在站点快照里是 286 星Apache-2.0 许可npm registry latest 为huiliyi37/dsh-tianshu-tui1.0.0-rc.2。它的安装流程本身不复杂但几个前提条件比较特殊直接照抄网上的通用教程很容易卡住。下面这五个陷阱都来自仓库 README 的安装与已知限制章节症状、成因与处置一并写清楚。同类插件的中文清单与安装形态可以先对照 完整插件清单与汉化避坑指南 建立整体印象再往下看细节。装之前先确认三件事第一确认本机 Node 满足^22.19 || 24装 1.0.0-rc.2 时还要到 node ≥ 24.4。第二确认 pnpm 可用没有就corepack enable。第三敲一次dsh --version如果它低于 0.2.0-rc.1说明 PATH 上有个旧二进制后面一律用pnpm dlx deepseek-ai/dshnext绕过。这三步花不了多少时间却能挡掉下面一大半问题。五个安装陷阱坑一 · npm 卡死并抛内存溢出现象。用 npm 安装官方 CLIdeepseek-ai/dsh时命令卡住数分钟后抛出JavaScript heap out of memory安装进程直接中断。原因。npm 11 是 Node 24 自带的版本而官方 CLI 的依赖树较大有 60 子包npm 11 在解析和安装这棵依赖树时会内存溢出这是实测复现的现象。解决。改用 pnpm 完成安装或者走npx -y pnpm dlx ...如果你此前正用npx -y deepseek-ai/dsh并且已经卡住或报 heap OOM直接切到 pnpm 即可。坑二 · 装进 web profile 后看不到界面现象。按网上通用的 DeepSeek Harness 插件教程把包装进了webprofile启动之后看不到任何 TUI 界面只有原来的界面或干脆没有变化。原因。本插件是一个终端 TUI 面板它必须装进tuiprofile并且要带--profile tui启动profile 不对插件自然不会装配到你会话真正进入的那条路径上。解决。安装和启动两条命令都统一带上--profile tui安装是plugin --profile tui add启动是--profile tui前后保持一致。若你还打算改用一键脚本或从 Git 安装同样要落在tuiprofile 上。坑三 · 装了不兼容的宿主版本现象。安装时直接报 peer 或版本不兼容或者装完看起来是成功了但一启动就出错。原因。本包要求宿主 DSH ≥ 0.2.0-rc.1而 npm 上的 latest 仍停留在 0.1.7 线与本包并不兼容此外 1.0.0-rc.2 另需 node ≥ 24.4。解决。宿主统一使用deepseek-ai/dshnext它对应 0.2.0 线同时把本机 Node 提到满足 node ≥ 24.4 的版本再重新装配。坑四 · 启动报路径是目录的错误现象。启动时报ERR_FS_EISDIR提示Path is a directory .../deepseek-ai/dsh看起来像是文件系统出了问题。原因。你的 PATH 上已经存在一个旧的dsh例如~/.local/bin/dsh版本低于 0.2.0-rc.1于是命令走到了本地 staging 目录上。解决。始终使用pnpm dlx deepseek-ai/dshnext ...这条完整命令或者先执行dsh --version确认当前解析到的版本再决定是否绕过它。如果换干净方式后仍然报同样的错那是~/.dsh/profiles/node_modules里旧安装的 fallback 与官方 CLI 冲突可以换一个干净的DSH_HOME再启动。坑五 · 在工作区根目录打包导致加载失败现象。自己动手构建 bundle 之后插件加载必定失败。原因。如果是在 DeepSeek Harness 工作区根目录对本包运行 tsdown会把尚未发布的deepseek-ai/dsh-root写进 bundle产物因此无法正常加载。解决。不要在 DSH 工作区根目录打包本插件如果你只是从 Git 安装仓库里已经包含lib/index.js根本不需要再自行打包。这五个陷阱的共同点它们全都不是「命令敲错」而是前提条件没对齐包管理器、profile 名、宿主版本线、PATH 上的旧二进制、以及构建所处目录。对照 README 的安装章节逐条核一遍比事后翻报错快得多。需要提醒的是本站静态扫描给它的结论是 含敏感能力且尚未做人工风险分级——能力清单与危险判定是两回事安装前请自行判断。总结五个陷阱的共性是「前提条件」而非「命令本身」——pnpm、tuiprofile、0.2.0 线宿主、PATH 上的旧 dsh、以及打包目录任何一项不对都会表现为装不上或起不来想对照同类插件的中文清单与安装形态见 完整插件清单与汉化避坑指南。适合与不适合适合已经用 pnpm 管依赖、Node 与宿主版本都满足 0.2.0 线的开发者习惯在终端内完成长会话、需要会话恢复与分支回退的人希望工具卡上直接看到 LSP 诊断徽标的用户想先在一键脚本里跑通再逐步自定义配置的初学者。不适合只能停留在 npm latest 0.1.7 线、且短期无法升级宿主的环境Node 版本低于 22.19 又无法升级的机器必须依赖鼠标交互、不接受纯终端键盘界面的使用习惯。标签dsh-tianshu-tui、DeepSeek Harness、安装避坑、终端 TUI本文由 DeepSeek Harness Hub 自动整理数据来源于插件详情页。 
长河君 · 2026/10/13 9:53:54 · 阅读 1.2k 装 dsh-tianshu-tui 之前，先避开这五个安装陷阱
dsh-tianshu-tui 是官方 DeepSeek Harness 上的交互式终端 TUI 面板插件仓库 huiliyi37/dsh-tianshu-tui 在站点快照里是 286 星Apache-2.0 许可npm registry latest 为huiliyi37/dsh-tianshu-tui1.0.0-rc.2。它的安装流程本身不复杂但几个前提条件比较特殊直接照抄网上的通用教程很容易卡住。下面这五个陷阱都来自仓库 README 的安装与已知限制章节症状、成因与处置一并写清楚。同类插件的中文清单与安装形态可以先对照 完整插件清单与汉化避坑指南 建立整体印象再往下看细节。装之前先确认三件事第一确认本机 Node 满足^22.19 || 24装 1.0.0-rc.2 时还要到 node ≥ 24.4。第二确认 pnpm 可用没有就corepack enable。第三敲一次dsh --version如果它低于 0.2.0-rc.1说明 PATH 上有个旧二进制后面一律用pnpm dlx deepseek-ai/dshnext绕过。这三步花不了多少时间却能挡掉下面一大半问题。五个安装陷阱坑一 · npm 卡死并抛内存溢出现象。用 npm 安装官方 CLIdeepseek-ai/dsh时命令卡住数分钟后抛出JavaScript heap out of memory安装进程直接中断。原因。npm 11 是 Node 24 自带的版本而官方 CLI 的依赖树较大有 60 子包npm 11 在解析和安装这棵依赖树时会内存溢出这是实测复现的现象。解决。改用 pnpm 完成安装或者走npx -y pnpm dlx ...如果你此前正用npx -y deepseek-ai/dsh并且已经卡住或报 heap OOM直接切到 pnpm 即可。坑二 · 装进 web profile 后看不到界面现象。按网上通用的 DeepSeek Harness 插件教程把包装进了webprofile启动之后看不到任何 TUI 界面只有原来的界面或干脆没有变化。原因。本插件是一个终端 TUI 面板它必须装进tuiprofile并且要带--profile tui启动profile 不对插件自然不会装配到你会话真正进入的那条路径上。解决。安装和启动两条命令都统一带上--profile tui安装是plugin --profile tui add启动是--profile tui前后保持一致。若你还打算改用一键脚本或从 Git 安装同样要落在tuiprofile 上。坑三 · 装了不兼容的宿主版本现象。安装时直接报 peer 或版本不兼容或者装完看起来是成功了但一启动就出错。原因。本包要求宿主 DSH ≥ 0.2.0-rc.1而 npm 上的 latest 仍停留在 0.1.7 线与本包并不兼容此外 1.0.0-rc.2 另需 node ≥ 24.4。解决。宿主统一使用deepseek-ai/dshnext它对应 0.2.0 线同时把本机 Node 提到满足 node ≥ 24.4 的版本再重新装配。坑四 · 启动报路径是目录的错误现象。启动时报ERR_FS_EISDIR提示Path is a directory .../deepseek-ai/dsh看起来像是文件系统出了问题。原因。你的 PATH 上已经存在一个旧的dsh例如~/.local/bin/dsh版本低于 0.2.0-rc.1于是命令走到了本地 staging 目录上。解决。始终使用pnpm dlx deepseek-ai/dshnext ...这条完整命令或者先执行dsh --version确认当前解析到的版本再决定是否绕过它。如果换干净方式后仍然报同样的错那是~/.dsh/profiles/node_modules里旧安装的 fallback 与官方 CLI 冲突可以换一个干净的DSH_HOME再启动。坑五 · 在工作区根目录打包导致加载失败现象。自己动手构建 bundle 之后插件加载必定失败。原因。如果是在 DeepSeek Harness 工作区根目录对本包运行 tsdown会把尚未发布的deepseek-ai/dsh-root写进 bundle产物因此无法正常加载。解决。不要在 DSH 工作区根目录打包本插件如果你只是从 Git 安装仓库里已经包含lib/index.js根本不需要再自行打包。这五个陷阱的共同点它们全都不是「命令敲错」而是前提条件没对齐包管理器、profile 名、宿主版本线、PATH 上的旧二进制、以及构建所处目录。对照 README 的安装章节逐条核一遍比事后翻报错快得多。需要提醒的是本站静态扫描给它的结论是 含敏感能力且尚未做人工风险分级——能力清单与危险判定是两回事安装前请自行判断。总结五个陷阱的共性是「前提条件」而非「命令本身」——pnpm、tuiprofile、0.2.0 线宿主、PATH 上的旧 dsh、以及打包目录任何一项不对都会表现为装不上或起不来想对照同类插件的中文清单与安装形态见 完整插件清单与汉化避坑指南。适合与不适合适合已经用 pnpm 管依赖、Node 与宿主版本都满足 0.2.0 线的开发者习惯在终端内完成长会话、需要会话恢复与分支回退的人希望工具卡上直接看到 LSP 诊断徽标的用户想先在一键脚本里跑通再逐步自定义配置的初学者。不适合只能停留在 npm latest 0.1.7 线、且短期无法升级宿主的环境Node 版本低于 22.19 又无法升级的机器必须依赖鼠标交互、不接受纯终端键盘界面的使用习惯。标签dsh-tianshu-tui、DeepSeek Harness、安装避坑、终端 TUI本文由 DeepSeek Harness Hub 自动整理数据来源于插件详情页。