# @d0nj/dsh-tui 中文文档

规范地址：https://npmcn.com/package/%40d0nj/dsh-tui/

版本：1\.2\.47
npm 元数据更新时间：2026-11-09T08:52:23.923Z
中文译文更新时间：2026-11-11T07:44:43.217Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40d0nj/dsh-tui
原文对照：https://npmcn.com/package/%40d0nj/dsh-tui/?lang=original
项目主页：https://github.com/d0nj/dsh-tui#readme
源码仓库：https://github.com/d0nj/dsh-tui

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2 MB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-11-08T20:04:09.558Z
- 最新版本发布：2026-11-09T08:52:23.750Z
- 近 30 天下载量：5276（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：29（近 12 个月 29 个）

## 中文简介

Derminal UI for DeepSeek Harness:以"墨子"表示的完整DSH简介.

## 安装

```sh
npm install @d0nj/dsh-tui
```

也可以使用：`pnpm add @d0nj/dsh-tui`、`yarn add @d0nj/dsh-tui`、`bun add @d0nj/dsh-tui`

## README

# dsh-tui (法语)

**在你的终端深处.**

[![npm](https://img.shields.io/npm/v/%40d0nj%2Fdsh-tui?color=2563eb&label=npm)](https://www.npmjs.com/package/@d0nj/dsh-tui) [![license](https://img.shields.io/npm/l/%40d0nj%2Fdsh-tui?color=2563eb)](https://npmcn.com/package/%40d0nj/dsh-tui/LICENSE) [![node](https://img.shields.io/node/v/%40d0nj%2Fdsh-tui?color=2563eb)](https://npmcn.com/package/%40d0nj/dsh-tui/package.json)

`dsh-tui` 是一个完整的终端前端,用于 **[深搜索策略](https://github.com/deepseek-ai/deepseek-harness)**而不是一闪而过。 它安装为普通的DSH配置文件,因此它将和Web和桌面表面相同的主机——相同的基础组成,提供者,证书,插件,设置,和工具——划出整个东西 [墨迹](https://github.com/vadimdemedes/ink)。 。 。 .

```text
  ██████╗ ███████╗██╗  ██╗
  ██╔══██╗██╔════╝██║  ██║      DSH // CODING HARNESS
  ██║  ██║███████╗███████║
  ██║  ██║╚════██║██╔══██║      ❯ fix the flaky test
  ██████╔╝███████║██║  ██║
  ╚═════╝ ╚══════╝╚═╝  ╚═╝      ◆ the retry wrapper was racing the timeout; patched…

  ╭─ ❯ YOU ─────────────────────────────────────────────╮
  │ fix the flaky test                                  │
  ╰─────────────────────────────────────────────────────╯

  ╭─ 󰒋 larper · 󰚩 deepseek-v4.1-flash · █ max · 󰉋 ~/project · 󰊢 main ↑2 ─── 1.2M ──╮
  │ ❯ ▏                                                                          │
  ╰──────────────────────────────────────────────────────────── ctrl+s tasks ───╯
```

## 快开始

```sh
npm install -g @deepseek-ai/dsh@latest   # the Node-hosted harness
npm install -g @d0nj/dsh-tui      # this terminal surface
dsh-tui            # launch it
```

这就是整个设置。 软件包是一个真实的 DSH 插件及其 `dsh-tui`编号 :`dst` 发射装置 第一个运行自动初始化 `tui` 配置文件( 此需要) `pnpm`),然后发射您节点托管的带. 要用手动方式在现有的配置文件中注册它: `dsh plugin --profile tui add @d0nj/dsh-tui`; 之后 `dsh-tui` 财务报告和审定财务报表 `dsh --profile tui` 等同起来.

## 为什么是dsh-tui

-   **真正的绳子.** 主机,供应商,证书,MCP插件,设置,和工具与其他每个DSH表面相同. Token 会计、上下文压力和会话数据来自Web 和桌面客户端所用的同样的预测.
-   **一个从未浮起的甲板.** 聊天时拥有可选屏幕并显示为固定高音文档:甲板总是终端上行的最后一行,记录片卷就位,拖放选择保留突出显示的范围 `ctrl+c` 或右键单击副本.
-   **平滑的地方它的重要性.** 启动卡由帮助器进程驱动,而主机加载时,再在同一位置上交接到聊天卡. 全屏相框被逐行地分出,因此动画只重新粉刷了所改变的行.
-   **为长会所建.** 带有语法高亮输出和红色/绿色 diff 带、 Claude 代码风格的背景任务的工具卡 `/tasks` 工作表,现场收缩反馈, `/shake` 用于推倒大小过大的工具结果、引导和消息队列,以及一个等待的码头,该码头用自旋动词和已过期的时钟向您通报情况.
-   **所有DSH飞船.** 核准、提问、斜线命令、技能、预设、工作、时间表、工作空间和模型/主题/选手——在终端.
-   **包括电池.** 持久性 Java 脚本和 Python `eval` 细胞和真铬 [`browser`](https://github.com/deepseek-ai/deepseek-harness) 带有自动化的工具显示被压制.
-   **你的设置棒.** 说明理由的能见度、待办项目HUD、扩大的工具产出和主题在2008年发射时均被记住 `$DSH_HOME/tui/preferences.json`。 。 。 .

## 安装

### 所需资源

-   节点.js 20+
-   节点.js 20+和 `pnpm`那个.. **节点** 建造 `@deepseek-ai/dsh` (单位:千美元)`npm install -g @deepseek-ai/dsh`; 桌面应用程序运行时间无法托管终端 UI )
-   一个真彩色终端: Kitty, iTerm2, Windows 终端, Ghostty, 或 Wez Term
-   仅使用 Python 3.8+ `eval` 单元格; Chromium 在第一次使用时下载 `browser` 工具

### 配置设置

```sh
dsh-tui install
```

这创造了一个最小 `tui` 剖面图: `dsh-base` 财务报告和审定财务报表 `dsh-web-app` 主机捆绑加终端表面. 您的其他配置文件没有复制任何内容 。 要添加插件, 请像其它配置文件一样使用 :

```sh
dsh plugin --profile tui add <package>
# or edit ~/.dsh/profiles/tui/cordis.patch.yml
```

### 运行

```sh
dsh-tui                    # new session
dsh-tui --continue         # most recent session in this directory
dsh-tui --resume <id>      # a specific saved session
dsh-tui --model deepseek-v4.1-flash --effort max
```

### 从退票

```sh
bun install
bun run build
bun run install:profile
bun run start
```

**所有旗帜**

| 旗帜 | 含义 |
| --- | --- |
| `--cwd <dir>` | 新会话工作目录 |
| `--resume <id>` | 打开已保存的会话 |
| `--continue` | 为目录打开最近的会话 |
| `--model <model>` | 型号编号或 `provider/model` |
| `--effort <level>` | 选定模式的推理工作 |
| `--theme <name>` | `deepseek` (违约), `basalt`, (中文(简体) ), `obsidian`, (中文(简体) ), `dark`, (中文(简体) ), `limestone`, (中文(简体) ), `light` |
| `--symbols <preset>` | 格言: `nerd` (违约), `unicode`, (中文(简体) ), `ascii` |
| `--ascii` | 缩写 `--symbols ascii` |
| `--yolo` | 自动批准许可请求 |
| `--no-splash` | 没有欢迎卡的靴子(装载器仍为动画) |

## 权限模式

`/mode` 在第一个消息适用于下一个消息之前.

| 模式 | 沙盒 | 核准 |
| --- | --- | --- |
| `/mode write` | `workspace-write` (默认) | 在工作空间外询问 |
| `/mode read` | `read-only` | 询问 |
| `/mode yolo` | `danger-full-access` | 自动操作 |

`/mode` 没有争论, 显示积极的政策.

**密钥**

| 密钥 | 行动 |
| --- | --- |
| `enter` | 发送; 在飞行中引导运行的转弯 |
| `shift+enter` 编号 : `ctrl+j` | 新行 |
| `esc` | 取消转弯、关闭面板或清晰输入 |
| `ctrl+c` | 取消; 要退出两次 |
| `ctrl+d` | 输入为空时退出 |
| `ctrl+p` | 命令调色板 |
| `ctrl+b` | 专题小组讨论会 |
| `ctrl+s` 编号 : `alt+a` | 背景任务表 |
| `ctrl+v` | 附加剪贴板图像 |
| `ctrl+o` | 扩展工具输出 |
| `ctrl+t` | 显示或隐藏推理 |
| `ctrl+l` | 清除屏幕 |
| `up` 编号 : `down` | 输入历史 |
| `PgUp` 编号 : `PgDn`轮子 | 滚动记录 |
| `ctrl+home` 编号 : `ctrl+end` | 跳到顶部/ 活边 |
| 拖动 | 选择记录文本; 释放副本 |

**配置**

| 变量 | 目的 |
| --- | --- |
| `DSH_TUI_RUNTIME` | 节点托管的路径 `@deepseek-ai/dsh` 运行时间 |
| `DSH_TUI_PYTHON` | Python 解释器 `python` eval 单元格 |
| `DSH_TUI_TRACE=1` | 将时间写入 `<tmp>/dsh-tui/trace.log` |
| `DSH_TUI_FORCE_TTY=1` | 绕过交互- TTY 检查 |
| `DSH_TUI_BROWSER_INSTALL=0` | 跳过下载 Chrome 测试 |
| `PUPPETEER_EXECUTABLE_PATH` | 使用特定的铬/铬二进制 |

## 发展

`AGENTS.md` 包括建筑、变化和测试政策。 简本:

```sh
bun install
bun run typecheck
bun run test
bun run build && bun run sync
bun run start
```

## 贷项

互动设计灵感来自 **[哦,我的宝贝](https://github.com/can1357/oh-my-pi)** ——底板作曲,密集状态行和卡片式工具输出. 背景命令和任务随之而来 **克劳德代码**'模型:静态工具行,任务通知,和一个任务表面. DSH的渲染,布局,和glyph词汇是它自己的.

色彩数学的平面,持续时间/计算格式,会话-accent衍生,和glyph词汇由Oh-my-pi改编而来,MIT许可.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40d0nj/dsh-tui/LICENSE)

## 常见问题

### @d0nj/dsh-tui 是什么？

Derminal UI for DeepSeek Harness:以"墨子"表示的完整DSH简介\.

### 如何安装 @d0nj/dsh-tui？

在项目目录运行 npm install @d0nj/dsh-tui，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dst、dstui、dsh-tui，可以用 npx dst 直接运行。

### @d0nj/dsh-tui 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/d0nj\_\_dsh-tui 是否存在。

### @d0nj/dsh-tui 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @d0nj/dsh-tui 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @d0nj/dsh-tui 可以商用吗？

@d0nj/dsh-tui 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @d0nj/dsh-tui 的下载量有多少？

根据 npm 官方下载统计，@d0nj/dsh-tui 在 2026/10/11 – 2026/11/09 这 30 天内被下载 5,276 次，日均约 176 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @d0nj/dsh-tui 还在维护吗？

最新版本 1\.2\.47 发布于 2026/11/09（1 天前）；至今共发布 29 个版本，其中过去 12 个月发布了 29 个；首次发布于 2026/11/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。