安装前先看这几项
- 配置资料
- 配置资料完整
- 配置难度
- 较高
- 适合新手
- 建议具备相关经验
- 兼容状态
- 不兼容当前版本
- 验证状态
- 源码已审阅,未标记运行实测
本页目录(9)
按照固定来源完成安装、配置与验证
教程包含独立 Profile、精确安装目标、配置证据、最小验证任务、回退和数据清理。
这个插件能做什么
DSH TUI 0.18.0 提供终端会话、模型与预设切换、扩展管理和独立 CLI;本页固定 DSH 0.2.1-rc.5,使用独立 dsh-tui Profile 与真实 TTY。
需要DSH 界面、主题、侧边栏能力的用户。
该插件涉及较高配置难度或敏感权限,不建议在生产工作区直接试装。
安装前准备
- DSH 0.2.1-rc.5(必需):0.18.0 的 npm 包所声明 DSH peer 均接受 0.2.1-rc.5,已无 dsh-invariants 依赖。Node.js 要求 ^22.19 || >=24,需 pnpm 10+ 和真实 TTY;设置依赖配套 @deepseek-ai/schemastery >=3.18.3。以上为声明和源码静态复核,未验证加载、Windows、TTY、OAuth 或重启。
- 独立环境与备份(必需):使用独立 dsh-tui Profile、可丢弃工作区和受限系统账号,升级前保存依赖、锁文件、补丁和插件状态。
- 真实 TTY 与 pnpm 10+(必需):使用真实交互式终端;本轮没有验证 Windows、TTY、pnpm 11 或便携版,Node.js 采用 ^22.19 或 >=24。
如何安装 dsh-TUI
本页命令固定使用 DSH 0.2.1-rc.5,与 npm 默认版本分别维护。切换 DSH 前核对本插件的兼容记录;新版 Session API 与格式变化见0.1.3-alpha.1 升级说明。源码审阅不等于运行验证。
下面的命令使用本站核验的 DSH 基线,并锁定插件版本或 Git commit,避免默认分支变化导致安装内容漂移。本站已核对安装目标,但尚未在你的系统和 Profile 中实际执行。
- 安装到
dsh-tuiProfile- DSH 基线
0.2.1-rc.5- 安装来源
- npm 预构建包(锁定版本)
- 固定目标
@deepseek-harness-tui/[email protected]
B1 已复核 0.18.0 固定发行包、声明与源码,本文命令固定 DSH 0.2.1-rc.5;只代表静态审阅,不是插件运行通过。旧组合 0.12.0 + 0.2.0-rc.2 仅用于识别备份,不与新版交叉混装。
- 01检查 Node.js 与 pnpm
DSH 当前基线需要 Node.js 22.19 或 Node.js 24 及以上,并且
pnpm必须已在 PATH 中。先运行:环境检查node --version && pnpm --version - 02安装到独立终端 Profile
这条命令会把插件加入
dsh-tuiProfile,并在插件声明 DSH Bundle 时自动加入配置层。npm 预构建包(锁定版本)npx --yes @deepseek-ai/[email protected] plugin --profile dsh-tui add @deepseek-harness-tui/[email protected] - 03确认 Bundle 已进入配置
安装成功后先导出组合配置,不启动 Agent。输出中应能找到包名 @deepseek-harness-tui/dsh-tui或对应 Bundle 层。
检查配置npx --yes @deepseek-ai/[email protected] --profile dsh-tui --dump-config - 04启动并完成最小验证
在真实交互式终端(TTY)中启动同一 Profile,只测试一个只读任务;Web 页面是否出现不能作为 TUI 加载依据。
在终端启动 DSH TUInpx --yes @deepseek-ai/[email protected] --profile dsh-tui
测试不通过时先停止 DSH,再从同一 Profile 移除插件。移除后重新运行配置检查,确认对应 Bundle 层已经消失;插件自己创建的数据和外部账号配置可能需要另行清理。
npx --yes @deepseek-ai/[email protected] plugin --profile dsh-tui remove @deepseek-harness-tui/dsh-tui插件专属配置
$DSH_HOME/profiles/dsh-tui/cordis.patch.yml- 用户覆盖层;与依赖清单、锁文件和 pnpm-workspace.yaml 一同备份。
~/.dsh-tui/settings.json 与 extension-grants.json- 前者保存各后端共用偏好,后者保存带 scope 的扩展授权;升级前一起备份。
环境变量
DEEPSEEK_API_KEY· 可选 · 敏感- 仅 deepseek-official API 路由需要;账号登录另走独立凭据路径。
DEEPSEEK_BASE_URL· 可选- 覆盖 API 端点并影响余额查询接收方,改网关前确认数据流。
DSH_TELEMETRY_MODE· 可选- DISABLED 控制 OTel 会话日志通道,不会同时关闭 API 请求中的插件清单与会话日志元数据。
独立 TUI Profile 的模型与显示设置 · yaml。示例中的账号、路径和凭据占位符必须替换,不要提交真实密钥。
- id: dsh-tui
config:
provider: deepseek-official
model: deepseek-flash
effort: max
fullscreen: false- 以下为可自行执行的隔离验证步骤;52DSH 本轮未安装或启动插件。
- 停止旧进程后用固定版本安装命令更新,同一 Profile 不混用全局启动器与不同 DSH 版本。
- 在测试项目的真实终端启动同一 dsh-tui Profile;先查看 /permission 与 /preset status,检查实际 sandbox 和 approval。
- 不在本次最小任务中使用 /update、OAuth 登录、后端 SDK 安装或扩展安装。
配置检查与成功结果
- 01核对精确宿主、包版本和唯一挂载行;导出配置成功不算运行验证。复制验证命令
npx --yes @deepseek-ai/[email protected] --profile dsh-tui --dump-config期望结果:配置引用 @deepseek-harness-tui/[email protected] 对应包,未出现重复挂载;继续验证前先核对权限。
- 02在真实 TTY 中启动同一 Profile,创建空会话,仅询问一句公开事实。
期望结果:终端显示 0.18.0,流式输出可见;未触发更新或文件修改。这是待执行的验证步骤。
第一次使用建议这样验证
- 用 /resume 查看测试会话,再用 /new 创建空会话;仅发送只读问题并检查模型与权限。
它可能接触哪些数据和能力
安装或启用扩展可写 ~/.dsh-tui/extension-grants.json,按组件及 scope 授权,不能假定每项授权都会单独弹窗;该机制不隔离第三方 Node 代码。更新器可写 Profile 依赖、锁文件与 pnpm-workspace.yaml,并启动安装进程或重启;按实际宿主/后端核对 sandbox 与 approval。
数据存储:TUI 设置、扩展授权、输入历史及重启日志位于 ~/.dsh-tui;会话、Provider 凭据和 OAuth 凭据分别由宿主及相关后端保存,凭据位置以固定配置为准。
请注意:“源码已审阅”说明本站检查到的证据范围,不等于安全认证。重要工作区应锁定版本、备份数据并在最小权限下测试。
故障排查与数据清理
- TUI 没有出现或启动即退出
- 核对真实 TTY、Node.js、pnpm、实际 Profile 与 schemastery 版本,保存脱敏启动错误,不通过安装更多插件排查。
- 更新失败或全局启动器仍是旧版
- 停止更新流程并检查安装器是否退出,恢复 Profile 备份;全局启动器与 Profile 包需一致。不要用 /update 复现本文固定版本。
- 停止同一 Profile 的 DSH,再运行 npx --yes @deepseek-ai/[email protected] plugin --profile dsh-tui remove @deepseek-harness-tui/dsh-tui;导出配置确认已移除。
- 恢复升级前整套 Profile 和插件状态备份,不混用新旧状态;卸载不会撤销文件修改、子会话或外部授权。
深入审计:兼容性、数据流与来源
兼容性与审阅记录
兼容性说明
2026-11-06 复查:本页固定的 0.18.0 不兼容当前默认 DSH 0.2.2-rc.1:36 项 DSH peer 都是精确版本列表,最高只到 0.2.1-rc.5;安装命令继续固定 DSH 0.2.1-rc.5,npm 上尚无更新版本。原声明:0.18.0 的 npm 包所声明 DSH peer 均接受 0.2.1-rc.5,已无 dsh-invariants 依赖。Node.js 要求 ^22.19 || >=24,需 pnpm 10+ 和真实 TTY;设置依赖配套 @deepseek-ai/schemastery >=3.18.3。以上为声明和源码静态复核,未验证加载、Windows、TTY、OAuth 或重启。
数据流
会话与凭据由 DSH 及所选后端保存,TUI 偏好和扩展授权位于 ~/.dsh-tui;余额查询携带凭据访问配置的 API 端点。0.18.0 继承官方请求元数据与反馈遥测配置,不能再声称 TUI 默认禁用全部遥测;通知和渲染日志可能包含对话片段。
源码审阅结论
2026-11-01 B1:重新取得 npm 0.18.0,SHA-512 与 npm integrity 一致,两个 registry ECDSA 签名验证通过,发行 tag 解引用至固定提交。provenance 声明的摘要与工作流提交匹配,但未完成 Sigstore 信任链验证;未独立重建发行产物。已按固定源码复核配置、授权、持久化与恢复边界,批准带风险说明的 source_reviewed;未安装或执行插件、未用真实凭据。
来源与维护信息
本页根据固定提交的仓库、包清单和本站审阅资料生成。版本变化后,请重新核对作者说明。
- 来源快照
08f3df46cca1- 固定提交
1d0d946f459d- 许可证
- MIT
- 主要语言
- TypeScript
- 中文资料
- 有完整中文配置资料