---
title: "用 Tianshu TUI 管理 DSH 多会话、审批与 LSP 诊断"
seo_title: "DSH Tianshu TUI 配置：多会话、审批与 LSP 工作流"
description: "在 DeepSeek Harness（DSH）中安装 Tianshu TUI，配置多会话、工具审批、Slash 命令、LSP、成本统计和可选视觉问答。"
canonical: https://52dsh.com/tutorials/huiliyi37-dsh-tianshu-tui-install-config/
authors: ["52DSH 编辑部"]
audience: []
outcomes: []
prerequisites: ["Node.js 与 pnpm","独立 tui Profile","真实交互式终端 TTY","可丢弃测试工作区"]
difficulty: advanced
estimated_action_time: null
next_steps: null
published_at: 2026-08-22
updated_at: 2026-10-02
verified_on: 2026-11-12
maintenance_status: stale
verification_level: source_reviewed
risk_level: high
dsh_version: 0.1.0-rc.8
plugin_id: huiliyi37-dsh-tianshu-tui
tutorial_kind: plugin_configuration
related_plugin_url: https://52dsh.com/plugins/huiliyi37-dsh-tianshu-tui/
---

# 用 Tianshu TUI 管理 DSH 多会话、审批与 LSP 诊断

在 DeepSeek Harness（DSH）中安装 Tianshu TUI，配置多会话、工具审批、Slash 命令、LSP、成本统计和可选视觉问答。

## DSH 0.2.0-rc.2 兼容提示（2026-10-02）

本页固定的天枢 TUI 0.1.2-rc.12 声明的 DSH 依赖范围只覆盖 0.1.x，DSH 0.2.0 起会[拒绝安装或在启动时停用](https://github.com/deepseek-ai/deepseek-harness/blob/639ed015397290b3745d163aafe02ffee4aa3f84/packages/boot/app-boot/src/plugin-compatibility.ts)这个版本。

- 上游 1.0.0-rc.2 声明兼容 0.2.0，但它的 29 个依赖中有 21 个是作者自行分叉的 DSH 核心包（`@huiliyi37/cordis`、`dsh-agent`、`dsh-fs`、`dsh-llm` 等），并接管 Agent 的命令与文件工具；这些分叉的源码仓库无法访问（作者说明为闭源），本站无法审阅，暂不推荐（见 [1.0.0-rc.2 的 package.json](https://github.com/huiliyi37/dsh-tianshu-tui/blob/2939f5f32198499b9867f76c0a8997032a508fdb/package.json)）。
- **使用 DSH 0.2.0-rc.2 的用户：目前没有本站推荐的天枢 TUI 版本。**
- 仍在 DSH 0.1.x 的用户：继续使用本页的组合，命令固定旧版 DSH。
- 本页已标记为待复核，依赖来源可以审阅后再更新。

升级 DSH 前怎样处理已装插件，见[已装插件被停用](/tutorials/dsh-update-uninstall/#升级到-020-后已装插件被停用)。

依据：[固定证据 1](https://github.com/huiliyi37/dsh-tianshu-tui/blob/1ff44e3dea8c677f48022c79887849df0248bccc/package.json)。

为 DSH 提供交互式终端界面，支持流式 Markdown、工具与审批卡片、多会话标签、主题、Slash 命令、LSP 诊断、成本统计和可选视觉问答。

如果你的目标是在终端中组合 DSH 多会话、审批卡片、LSP 和成本统计，本教程会说明如何在 DeepSeek Harness（DSH）中准备、安装、配置、验证和回退 dsh-tianshu-tui。本文锁定作者仓库提交 `1ff44e3dea8c`；已复核固定提交的原始资料，未进行运行实测。

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

## 先确认是否适合你

- **分类**：界面交互
- **风险等级**：high
- **核验证据**：source_reviewed
- **兼容性边界**：插件版本 0.1.2-rc.12，peer 依赖主要声明 DSH 0.1.0-rc.8 系列；本站完成固定提交静态审阅，未在真实 TTY、Windows、各类 LSP 或自动更新路径运行
- **主要权限关注**：复用 DSH 会话、Agent、工具、审批、凭据和子 Agent 服务；可读取工作区内 @ 引用文件、系统剪贴板，启动外部编辑器与语言服务器，并在 npm 安装来源下自动更新和重启宿主

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

## 安装前准备

**本页 DSH 命令版本：** `0.1.0-rc.8`。G1 按固定提交复核：天枢 TUI 0.1.2-rc.12 的 15 个 DSH peer 均为 ^0.1.0-rc.8，作者 README 要求宿主 CLI 为 0.1.0-rc.8，本页命令统一固定该版本，不再混用 0.1.1-rc.2。只代表静态审阅，不是插件运行通过；DSH 0.2.x 用户见上方兼容提示。

- **独立 tui Profile 与测试 DSH_HOME**：插件在 dsh-base 之上挂载 tui-runner，必须装进单独的 tui Profile，不要装进 web Profile。建议设置单独的 DSH_HOME 测试目录，与日常 ~/.dsh 和其他 TUI 插件隔离；作者也用这种方式绕开 ERR_FS_EISDIR。
- **真实 TTY、Node.js 与 pnpm**：在真实交互式终端中运行；Node.js 需 ^22.19 或 >=24，PATH 上要有 pnpm（dsh plugin 会转发给它）。模型凭据可用 DEEPSEEK_API_KEY 或官方登录流程。

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

## 安装 dsh-tianshu-tui

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

```bash
npx --yes @deepseek-ai/dsh@0.1.0-rc.8 plugin --profile tui add github:huiliyi37/dsh-tianshu-tui#1ff44e3dea8c
```

固定 Git 树已包含 lib/index.js，package.json 没有 prepare 或安装脚本，不需要放行构建，也不要运行作者的 build 或 npm test。pnpm 提示 peer missing 时按作者说明可忽略：peer 由同一 DSH 0.1.0-rc.8 宿主提供，不要另装 @deepseek-ai/* 包。只用本页带版本号的 npx 命令，不直接运行 PATH 上的 dsh。



## 插件专属配置

### 配置目标

- `$DSH_HOME/profiles/tui/cordis.patch.yml`：Profile 用户覆盖层；覆盖已有 id: tui-runner 行的 config，不要重复 insert。patch 会整体替换该行 config。
- `~/.dsh-tui/`：prefs.json（主题、密度、面板显隐）、input-history.json（最多 1000 条输入原文）和 update-cache.json（npm 更新检查缓存）；不随 DSH_HOME 变化。
- `TUI 内 /config 面板`：查看宿主设置、权限预设和凭据状态（只显示是否存在，不显示明文）；/yolo 与 Shift+Tab 的 always-approve 会放行全部审批，测试时不要开启。

### 环境变量

- `DEEPSEEK_API_KEY`（可选），敏感：模型 API Key；也可以改用官方 CLI 的登录流程。只用测试 Key，不写进命令历史或截图。
- `DSH_HOME`（可选）：DSH 数据目录；指向单独的测试目录可以隔离 Profile、会话和旧安装残留。
- `DSH_TUI_SKIP_UPDATE`（可选）：设为 1 时不执行自动升级。固定提交的实现会先查询 npm latest（缓存 1 小时）再判断该变量，因此它不能阻止这次联网查询。
- `DSH_TUI_UPDATE_REGISTRY`（可选）：自更新检查的 registry 列表（逗号分隔），默认 registry.npmjs.org，超时回退 registry.npmmirror.com。
- `EDITOR`（可选）：Ctrl+E 打开外部编辑器时使用的命令（也会读取 VISUAL），会启动本机程序。

### 可选：首次测试关闭 LSP 诊断与更新后自动重启

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

```yaml
- id: tui-runner
  config:
    lsp:
      enabled: false
    autoRestartOnUpdate: false
```

### 安装后设置

1. 以下是可自行执行的隔离验证步骤；52DSH 本轮没有安装或启动插件。
2. 在测试 DSH_HOME 下安装到 tui Profile 后，先运行 --dump-config，确认只有一个 tui-runner 行。
3. 需要关闭 LSP 时，在 $DSH_HOME/profiles/tui/cordis.patch.yml 写入上方覆盖，再导出配置确认生效。LSP 默认开启，TypeScript 语言服务会通过 npx -y 下载运行，其他语言服务按 PATH 探测。
4. 在真实终端用同一版本启动 tui Profile，看到欢迎页品牌 dsh-tianshu-tui 后再提问；Ctrl+Q 或 /exit 退出。


## 配置验证与成功结果

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

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

1. **导出 tui Profile 的组合配置**

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

   期望结果：出现 id: tui-runner、name 为 @huiliyi37/dsh-tianshu-tui 的一行，没有重复挂载；导出成功不代表 TUI 能启动。

2. **在真实 TTY 中启动同一 Profile，只问一个不涉及文件写入的问题**

   ```bash
   npx --yes @deepseek-ai/dsh@0.1.0-rc.8 --profile tui
   ```

   期望结果：欢迎页显示 dsh-tianshu-tui、会话短 id 和环境检查行，回答以流式方式出现；这是待执行的验证步骤，本站未运行。

## 第一次使用

- 在测试工作区输入“只列出当前目录的文件名，不要读取或修改文件”，观察工具卡和审批卡；不开启 /yolo，不用 @ 引用敏感文件。

## 数据、权限与凭据

**数据流：** 终端输入、附件、工作区文件摘要与剪贴板 → Tianshu TUI 适配层 → DSH 会话、模型、工具、审批和可选视觉模型 → 流式结果与状态渲染回终端；主题和输入偏好写入 ~/.dsh-tui。

**权限关注：** 复用 DSH 会话、Agent、工具、审批、凭据和子 Agent 服务；可读取工作区内 @ 引用文件、系统剪贴板，启动外部编辑器与语言服务器，并在 npm 安装来源下自动更新和重启宿主

**数据存储：** 会话、Profile 与凭据由 DSH 宿主保存在 DSH_HOME（默认 ~/.dsh）；TUI 自己在 ~/.dsh-tui 写入偏好、输入历史原文和更新检查缓存，不随 DSH_HOME 隔离。卸载插件不会删除这些文件。

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

## 卸载、回退与清理

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

```bash
npx --yes @deepseek-ai/dsh@0.1.0-rc.8 plugin --profile tui remove @huiliyi37/dsh-tianshu-tui
```

1. 退出 TUI 后在同一测试 DSH_HOME 下运行 npx --yes @deepseek-ai/dsh@0.1.0-rc.8 plugin --profile tui remove @huiliyi37/dsh-tianshu-tui，再导出配置确认 tui-runner 已消失。
2. 需要时删除测试 DSH_HOME 和 ~/.dsh-tui（含输入历史原文），并撤销测试 API Key；Agent 已改动的文件和已启动的语言服务不会因卸载回滚。

## 常见问题

### ERR_FS_EISDIR 或 Path is a directory .../@deepseek-ai/dsh

这是错误码，不是环境变量。PATH 上旧的 dsh 或 ~/.dsh/profiles/node_modules 里的旧安装与 0.1.0-rc.8 冲突；改用本页带版本号的 npx 命令，并换一个干净的 DSH_HOME 重新安装。

### 在 DSH 0.1.1-rc.2 或 0.2.x 下使用

本版本只按 0.1.0-rc.8 审阅：0.1.1-rc.2 不在 peer 声明范围内，本站没有验证能否加载；0.2.0 起宿主会拒绝安装或停用。请在 0.1.0-rc.8 的独立 Profile 中使用，不要为兼容强行改 peer 或混装版本。

### 启动后提示插件已更新或自动重启

本页用固定 Git 提交安装，按固定源码不会被自动改写成 npm 版本；如果看到更新提示，先确认 Profile 的 package.json 仍是本页安装目标，没有被改成 npm 包。

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

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

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

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

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

## 固定来源证据

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

- [README.md](https://github.com/huiliyi37/dsh-tianshu-tui/blob/1ff44e3dea8c677f48022c79887849df0248bccc/README.md)
- [docs/configuration.md](https://github.com/huiliyi37/dsh-tianshu-tui/blob/1ff44e3dea8c677f48022c79887849df0248bccc/docs/configuration.md)
- [README.en.md](https://github.com/huiliyi37/dsh-tianshu-tui/blob/1ff44e3dea8c677f48022c79887849df0248bccc/README.en.md)
- [docs/getting-started.md](https://github.com/huiliyi37/dsh-tianshu-tui/blob/1ff44e3dea8c677f48022c79887849df0248bccc/docs/getting-started.md)
- [vision-ask/README.md](https://github.com/huiliyi37/dsh-tianshu-tui/blob/1ff44e3dea8c677f48022c79887849df0248bccc/vision-ask/README.md)
- [docs/getting-started.en.md](https://github.com/huiliyi37/dsh-tianshu-tui/blob/1ff44e3dea8c677f48022c79887849df0248bccc/docs/getting-started.en.md)

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

## 原始来源

- https://github.com/huiliyi37/dsh-tianshu-tui
- https://github.com/huiliyi37/dsh-tianshu-tui/blob/1ff44e3dea8c677f48022c79887849df0248bccc/package.json
- https://github.com/huiliyi37/dsh-tianshu-tui/blob/1ff44e3dea8c677f48022c79887849df0248bccc/README.md
- https://github.com/deepseek-ai/deepseek-harness/blob/141eb6fef83422698aef7a981029e843e8161534/apps/cli/reference/README.zh.md
- https://github.com/huiliyi37/dsh-tianshu-tui/blob/1ff44e3dea8c677f48022c79887849df0248bccc/docs/configuration.md
- https://github.com/huiliyi37/dsh-tianshu-tui/blob/1ff44e3dea8c677f48022c79887849df0248bccc/README.en.md
- https://github.com/huiliyi37/dsh-tianshu-tui/blob/1ff44e3dea8c677f48022c79887849df0248bccc/docs/getting-started.md
