---
title: "安装 DSH TUI 0.18.0 并核对配置与权限"
seo_title: "DSH TUI 0.18.0 教程：配置、迁移与权限"
description: "在 DeepSeek Harness（DSH）0.2.1-rc.5 使用 DSH TUI 0.18.0，了解固定安装、旧配置迁移、持久化、权限与失败回退；仅静态审阅，未运行验证。"
canonical: https://52dsh.com/tutorials/ccch1mneyyy-dsh-tui-install-config/
authors: ["52DSH 编辑部"]
audience: []
outcomes: []
prerequisites: ["Node.js 与 pnpm","独立 dsh-tui Profile","真实交互式终端 TTY","可丢弃测试工作区"]
difficulty: advanced
estimated_action_time: null
next_steps: null
published_at: 2026-08-22
updated_at: 2026-11-06
verified_on: 2026-11-01
maintenance_status: stale
verification_level: source_reviewed
risk_level: high
dsh_version: 0.2.1-rc.5
plugin_id: ccch1mneyyy-dsh-tui
tutorial_kind: plugin_configuration
related_plugin_url: https://52dsh.com/plugins/ccch1mneyyy-dsh-tui/
---

# 安装 DSH TUI 0.18.0 并核对配置与权限

在 DeepSeek Harness（DSH）0.2.1-rc.5 使用 DSH TUI 0.18.0，了解固定安装、旧配置迁移、持久化、权限与失败回退；仅静态审阅，未运行验证。

## 当前默认 DSH 0.2.2-rc.1 提醒（2026-11-06）

**本页固定的 0.18.0 不兼容当前默认 DSH 0.2.2-rc.1：36 项 DSH peer 都是精确版本列表，最高只到 0.2.1-rc.5。** npm 默认版本已改为 0.2.2-rc.1，未锁版本的 `npx @deepseek-ai/dsh` 会取得它，并在安装或启动时拒绝本插件。下方命令继续固定 DSH 0.2.1-rc.5，这个组合仍按 B1 记录适用；2026-11-06 npm 上尚无 TUI 新版本。不要用版本豁免强装，等作者发布声明支持 0.2.2 的版本。升级宿主前先看[0.2.2-rc.1 升级检查](/tutorials/dsh-update-uninstall/#022-rc1默认版本升级检查)。依据：[兼容判断实现](https://github.com/deepseek-ai/deepseek-harness/blob/66491b05e3f05ad35bcdd4f6cd7ed26041d9e3db/packages/boot/app-boot/src/plugin-compatibility.ts)。

## B1 固定版本维护记录（2026-11-01）

本页从 0.12.0 升级至 0.18.0，安装目标与 DSH 命令已同步更新。此前 11-01 的候选暂缓记录保存在批次审核历史中；本轮补齐发行包绑定与配置/权限静态审阅后，转为带风险说明的 source_reviewed，不提升为运行验证。

重新取得 npm 精确版，SHA-512 与元数据一致；registry 的两条 ECDSA 签名验证通过。发行 tag 解引用与本页 40 位提交一致。provenance 声明的摘要与工作流提交已比对，但未验证完整 Sigstore 信任链，未独立重建产物。发行包不附带 src，静态 bundle 与源代码不能据此宣称可复现构建。

以上不是安全认证，也没有执行安装、登录、模型请求、迁移、终端、远程或更新流程。使用前按下文迁移与退出路径逐项核对。

依据：[固定证据 1](https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/package.json)、[固定证据 2](https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/LICENSE)。

DSH TUI 0.18.0 提供终端会话、模型与预设切换、扩展管理和独立 CLI；本页固定 DSH 0.2.1-rc.5，使用独立 dsh-tui Profile 与真实 TTY。

如果你的目标是在真实终端配置独立 TUI Profile、扩展授权与受控更新，本教程会说明如何在 DeepSeek Harness（DSH）中准备、安装、配置、验证和回退 dsh-TUI。本文锁定作者仓库提交 `1d0d946f459d`；已复核固定提交的原始资料，未进行运行实测。

> 对应插件：[查看 dsh-TUI 的功能、权限与兼容性说明](/plugins/ccch1mneyyy-dsh-tui/)。先确认它适合你的工作流，再执行安装。

## 本次版本与使用入口

本站从 0.12.0 升至固定 0.18.0，配套命令改为 DSH 0.2.1-rc.5。下面使用独立 `dsh-tui` Profile；请在真实交互式终端运行 `npx --yes @deepseek-ai/dsh@0.2.1-rc.5 --profile dsh-tui`。全局启动器 `dsh-tui` / `dst` 是作者另一条入口，可能读取不同全局 DSH 和包版本，本页不要求全局安装。不要用 DSH Web 页面是否出现来判断 TUI 是否加载。

## 先确认是否适合你

- **分类**：界面交互
- **风险等级**：high
- **核验证据**：source_reviewed
- **兼容性边界**：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/extension-grants.json，按组件及 scope 授权，不能假定每项授权都会单独弹窗；该机制不隔离第三方 Node 代码。更新器可写 Profile 依赖、锁文件与 pnpm-workspace.yaml，并启动安装进程或重启；按实际宿主/后端核对 sandbox 与 approval。

如果你准备在重要工作区使用，先阅读插件详情页的权限和数据流说明；“源码已审阅”或“资料已整理”都不等于安全认证。

## 安装前准备

**本页 DSH 命令版本：** `0.2.1-rc.5`。B1 已复核 0.18.0 固定发行包、声明与源码，本文命令固定 DSH 0.2.1-rc.5；只代表静态审阅，不是插件运行通过。旧组合 0.12.0 + 0.2.0-rc.2 仅用于识别备份，不与新版交叉混装。

- **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。

1. 安装 Node.js 22.19、Node.js 24 或项目当前声明支持的更高版本，并确认 `pnpm` 可用。
2. 使用独立的 `dsh-tui` Profile 和可丢弃测试工作区，不直接连接生产目录。
3. 备份当前 Profile 配置，并记录安装前的 `--dump-config` 输出。
4. 核对固定来源中的外部服务、账号、运行时和平台限制。
5. 需要凭据时只准备测试凭据；本页识别到的候选变量包括 `DEEPSEEK_API_KEY`、`DEEPSEEK_BASE_URL`、`DSH_TELEMETRY_MODE`。

## 安装 dsh-TUI

52DSH 使用目录中记录的精确安装目标，避免直接跟随可能变化的默认分支：

```bash
npx --yes @deepseek-ai/dsh@0.2.1-rc.5 plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui@0.18.0
```

GitHub 源码插件如果被 pnpm 拦截构建脚本，先检查终端提示的具体包和脚本。只在 `dsh-tui` Profile 中放行确实需要的构建项，不要全局放行未知依赖。



## 插件专属配置

### 配置目标

- `$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 的模型与显示设置

证据：[固定来源](https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/docs/configuration.md)。按上方配置目标使用本段内容；如有占位符，替换为测试值。

```yaml
- id: dsh-tui
  config:
    provider: deepseek-official
    model: deepseek-flash
    effort: max
    fullscreen: false
```

### 安装后设置

1. 以下为可自行执行的隔离验证步骤；52DSH 本轮未安装或启动插件。
2. 停止旧进程后用固定版本安装命令更新，同一 Profile 不混用全局启动器与不同 DSH 版本。
3. 在测试项目的真实终端启动同一 dsh-tui Profile；先查看 /permission 与 /preset status，检查实际 sandbox 和 approval。
4. 不在本次最小任务中使用 /update、OAuth 登录、后端 SDK 安装或扩展安装。


### 从 0.12.0 迁移设置与授权

先停止 TUI，备份 Profile 的 package.json、锁文件、cordis.patch.yml、pnpm-workspace.yaml 以及 `~/.dsh-tui`。0.18.0 的常规设置首次从 Profile 或旧 `settings.yaml` 导入 `~/.dsh-tui/settings.json`，之后各后端共用；其他插件设置仍交给宿主。覆盖 Loader 行时 `config` 整块替换，不能把片段当深合并。

扩展安装/启用流程会按组件声明添加具名、带 scope 的授权；安装前可读声明时可能先写授权再加载，失败尽力回滚。npm 声明需安装后读取，流程另有授权步骤；不要据此保证所有路径逐项确认。旧字符串 grant 不再自动授权，旧 deny 保守保留；损坏或未知结构的授权文件会拒写并警告，安装不一定中止。授权文件不能充当 OS 沙箱。

0.18.0 的 bundle 继承官方 sandbox、approval 与遥测配置；旧版 Windows `danger-full-access` 和 `never` 风险应作为升级前检查背景，不是此版本所有平台的固定默认值。实际权限仍须查看当前 Profile、预设及所选后端。

## 配置验证与成功结果

先导出配置，再在真实 TTY 中启动同一 Profile 的终端界面：

```bash
npx --yes @deepseek-ai/dsh@0.2.1-rc.5 --profile dsh-tui --dump-config
npx --yes @deepseek-ai/dsh@0.2.1-rc.5 --profile dsh-tui
```

1. **核对精确宿主、包版本和唯一挂载行；导出配置成功不算运行验证。**

   ```bash
   npx --yes @deepseek-ai/dsh@0.2.1-rc.5 --profile dsh-tui --dump-config
   ```

   期望结果：配置引用 @deepseek-harness-tui/dsh-tui@0.18.0 对应包，未出现重复挂载；继续验证前先核对权限。

2. **在真实 TTY 中启动同一 Profile，创建空会话，仅询问一句公开事实。**

   期望结果：终端显示 0.18.0，流式输出可见；未触发更新或文件修改。这是待执行的验证步骤。

## 第一次使用

- 用 /resume 查看测试会话，再用 /new 创建空会话；仅发送只读问题并检查模型与权限。

### 自更新和重启的写入范围

`/update` 会更新并重启，`dsh-tui update` 只做更新阶段；它们不承诺留在本文 0.18.0。更新器会改写 Profile 的 `pnpm-workspace.yaml`，补充 `allowBuilds: false`、异平台可选包过滤，并可能为目标/原版本写入 `minimumReleaseAgeExclude`，绕过对应包的新包等待期。还会调用安装器、处理失败残留并对齐全局启动器；便携版另走下载替换二进制的路径。本轮没有运行这些流程，也没有核对 Windows 便携安装器。

需要复现本页时使用上方精确版本命令。更新失败先停止，保存脱敏日志，恢复整套 Profile 备份；不要在安装进程未退出时再次更新或手工删包。Claude/Codex 后端、登录与 SDK 安装另行配置，不作为本页最小验证。

## 数据、权限与凭据

**数据流：** 会话与凭据由 DSH 及所选后端保存，TUI 偏好和扩展授权位于 ~/.dsh-tui；余额查询携带凭据访问配置的 API 端点。0.18.0 继承官方请求元数据与反馈遥测配置，不能再声称 TUI 默认禁用全部遥测；通知和渲染日志可能包含对话片段。

**权限关注：** 安装或启用扩展可写 ~/.dsh-tui/extension-grants.json，按组件及 scope 授权，不能假定每项授权都会单独弹窗；该机制不隔离第三方 Node 代码。更新器可写 Profile 依赖、锁文件与 pnpm-workspace.yaml，并启动安装进程或重启；按实际宿主/后端核对 sandbox 与 approval。

**数据存储：** TUI 设置、扩展授权、输入历史及重启日志位于 ~/.dsh-tui；会话、Provider 凭据和 OAuth 凭据分别由宿主及相关后端保存，凭据位置以固定配置为准。

真实 Token、API Key、Cookie 和账号 ID 不应写进 Git 仓库、网页截图或公开 Issue。测试结束后撤销临时凭据。

## 卸载、回退与清理

停止 DSH 后，从同一个 Profile 移除包：

```bash
npx --yes @deepseek-ai/dsh@0.2.1-rc.5 plugin --profile dsh-tui remove @deepseek-harness-tui/dsh-tui
```

1. 停止同一 Profile 的 DSH，再运行 npx --yes @deepseek-ai/dsh@0.2.1-rc.5 plugin --profile dsh-tui remove @deepseek-harness-tui/dsh-tui；导出配置确认已移除。
2. 恢复升级前整套 Profile 和插件状态备份，不混用新旧状态；卸载不会撤销文件修改、子会话或外部授权。

### 凭据、日志与上报边界

余额查询使用配置端点与凭据，切换网关前确认接收方。官方组合的插件清单、会话日志请求元数据及反馈 OTel 是不同通道；`DSH_TELEMETRY_MODE=DISABLED` 只控制 OTel，不能替代其他开关。系统通知可能携带最后回复片段，Windows 通知注册会写用户注册表。排障后清理渲染与重启日志，卸载不会自动撤销外部 OAuth 授权。

## 常见问题

### TUI 没有出现或启动即退出

核对真实 TTY、Node.js、pnpm、实际 Profile 与 schemastery 版本，保存脱敏启动错误，不通过安装更多插件排查。

### 更新失败或全局启动器仍是旧版

停止更新流程并检查安装器是否退出，恢复 Profile 备份；全局启动器与 Profile 包需一致。不要用 /update 复现本文固定版本。

### 安装成功但页面或命令没有出现

先运行 `--dump-config` 确认 Bundle 已进入 `dsh-tui` Profile，再在真实 TTY 中启动同一 Profile，检查 Node.js、pnpm 与终端错误。不要通过反复扩大权限来解决加载问题。

### 插件运行后没有得到预期结果

把问题缩小到本页的最小验证任务，检查作者文档要求的变量、外部服务和平台限制。保存终端错误原文，并核对当前安装目标是否仍对应本页固定提交。

作者提供了独立故障文档，可从下方“固定来源证据”进入；本页没有把整份 README 复制过来。

## 固定来源证据

以下资料是本文配置结论的依据：

- [README.md](https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/README.md)
- [docs/configuration.md](https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/docs/configuration.md)
- [docs/README.md](https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/docs/README.md)
- [docs/configuration.en.md](https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/docs/configuration.en.md)
- [docs/getting-started.en.md](https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/docs/getting-started.en.md)
- [docs/user-guide.en.md](https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/docs/user-guide.en.md)

继续查看：[返回 dsh-TUI 插件详情页](/plugins/ccch1mneyyy-dsh-tui/)，重新核对兼容性、权限、同类插件和来源状态。

## 原始来源

- https://github.com/ccch1mneyyy/dsh-TUI
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/package.json
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/LICENSE
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/cordis.patch.yml
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/README_ZH.md
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/docs/configuration.md
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/docs/getting-started.md
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/src/dsh-adapter/grant-file.ts
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/src/dsh-adapter/plugin-install.ts
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/src/dsh-adapter/plugin-manage.ts
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/src/adapter/standard/grants.ts
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/src/update.ts
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/src/deepseekBalance.ts
- https://github.com/deepseek-ai/deepseek-harness/blob/b830ec950faba0a46dda564be3e2d854afed94f1/packages/boot/app-boot/src/plugin-compatibility.ts
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/README.md
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/docs/README.md
- https://github.com/ccch1mneyyy/dsh-TUI/blob/1d0d946f459da5149aba64cc6cc0ef7da304053c/docs/configuration.en.md
