# @askdkc/dsh-cli 中文文档

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

版本：0\.14\.18
npm 元数据更新时间：2026-10-31T22:30:15.095Z
中文译文更新时间：2026-11-06T23:30:12.686Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：19.4 MB，2840 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：37 个
- peer 依赖：@deepseek-ai/cordis \*，@deepseek-ai/dsh-llm \*，@deepseek-ai/dsh-agent \*，@deepseek-ai/dsh-skill \*，@deepseek-ai/dsh-persona \*，@deepseek-ai/dsh-session \*，@deepseek-ai/dsh-storage \*，@deepseek-ai/dsh-web-app \*，@deepseek-ai/schemastery \*，@deepseek-ai/dsh-commands \*，@deepseek-ai/dsh-settings \*，@deepseek-ai/dsh-terminal \*，@deepseek-ai/dsh-llm-pi-ai \*，@deepseek-ai/dsh-workspace \*，@deepseek-ai/dsh-tool-cordis \*，@deepseek-ai/dsh-atomic-write \*，@deepseek-ai/dsh-storage-json \*，@deepseek-ai/dsh-system-prompt \*，@deepseek-ai/dsh-terminal-bash \*，@deepseek-ai/dsh-tool-ask-user \*，@deepseek-ai/dsh-tool-subagent \*，@deepseek-ai/dsh-user-approval \*，@deepseek-ai/dsh-storage-domain \*，@deepseek-ai/dsh-user-questions \*，@deepseek-ai/dsh-ptc-runtime-node \*，@deepseek-ai/dsh-agent-instructions \*，@deepseek-ai/dsh-cordis-host-runner \*，@deepseek-ai/dsh-tool-bash-persistent \*，@deepseek-ai/dsh-agent-preset-registry \*
- 首次发布：2026-09-27T10:13:34.580Z
- 最新版本发布：2026-10-31T22:30:14.968Z
- 近 30 天下载量：8221（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：34（近 12 个月 34 个）

## 中文简介

DeepSeek Harness代理机,会话和工具的交互式终端接口.

## 安装

```sh
npm install @askdkc/dsh-cli
```

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

## README

![dsh-cli animated whale logo](https://npmcn.com/package/%40askdkc/dsh-cli/docs/assets/readme/logo-en.svg)

**联合国** | [简体中文](https://npmcn.com/package/%40askdkc/dsh-cli/README_ZH.md) | [日本語](https://npmcn.com/package/%40askdkc/dsh-cli/README_JA.md)

[![CI](https://github.com/askdkc/dsh-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/askdkc/dsh-cli/actions/workflows/ci.yml) [![MIT License](https://img.shields.io/badge/license-MIT-263146?style=flat-square)](https://npmcn.com/package/%40askdkc/dsh-cli/LICENSE) ![Public beta](https://img.shields.io/badge/status-public%20beta-7da1de?style=flat-square) [![GitHub stars](https://img.shields.io/github/stars/askdkc/dsh-cli?style=flat-square&color=4b6fff)](https://github.com/askdkc/dsh-cli/stargazers)

# dsh-cli (英语)

> DeepSeek Harness的交互式终端UI插件.

这是Dkc独立开发的叉子 [烟囱的dsh-TUI](https://github.com/ccch1mneyyy/dsh-TUI)。 。 。 .

## 不带菊子就跑一次

```sh
dsh-cli --ignore-kiokuko
dsh-cli --ignore-kiokuko --resume <session-id>
```

`dsh-cli` 独立工作; Kiokuko 是可选的. `--ignore-kiokuko` 防止 `kiokuko-dsh` 及其从装入的子路径插件(包括模型集成) 在他们的进口、服务、工具或钩子运行之前 它会省略 Kiokuko的捆绑效果,同时保留清晰的外形,家和 `--patch` 覆盖和其他插件。 Kiokuko 提供的提供者/工具没有. 现有会话历史仍然存在; 恢复无法重新启用插件 .

此选项不会解开任何内容或保存一个退出设置 。 临时 使用后删除组成文件; 下一次发射时不用旗帜 普通的简介。 这是一个启动选项,而不是卸载命令 已经运行的会话 . `--dump-config` 显示有效的启动树; 无法将 schema/ default- only turn 和 profile 替换与此组合 选项。 如果主机无法安全地构成排除, 启动失败 而不是默默地装入Kiokuko。 正常主机启动内务管理 和明确的会话设置编辑仍然遵循主机的正常行为.

## 预览

![Recorded dsh-cli session with an animated pixel whale.](https://npmcn.com/package/%40askdkc/dsh-cli/docs/assets/readme/preview-en.svg)

## 要点

-   流出Markdown,工具卡,图像,美人鱼图,以及键盘的完成.
-   像素鲸,活活的工作状态,上下文栏,TPS仪表,以及可点击的时间表.
-   包含恢复、分叉、倒带、背景工作和导出的会话管理.
-   DSH预设,技能,MCP,目标,子代理,提供者认证,以及扩展.
-   认证OpenAI,克洛德,OpenCode,OpenRouter,赫尔梅斯代理,和Infron.
-   为长会话虚拟渲染和绑定缓存.
-   通过单独的 LSP 提供者进行可选范围代码分析;见 [代码分析设置和当前接受限制](https://npmcn.com/package/%40askdkc/dsh-cli/docs/code-intelligence.en.md)。 。 。 .
-   通过单独的可选常用 Lisp 模式 `kiokuko-dsh` 插件, 哪个 必须在相同的配置文件中安装;见 [奇库子 Lisp 设置](https://npmcn.com/package/%40askdkc/dsh-cli/#readme-optional-kiokuko-lisp-mode)。 。 。 .

## 快速启动

要求数 [节点.js](https://nodejs.org/en) `>=22.19.0`页:1 [深搜索策略](https://github.com/deepseek-ai/deepseek-harness) 来源 安装了依赖关系的退出,以及 `DEEPSEEK_API_KEY`我们的目标是支持 当前 DSH API 。 与安装的软件包和 上游默认分支, 没有发布许可列表; 见 [规 则 .md](https://npmcn.com/package/%40askdkc/dsh-cli/ADAPTER.md)。 。 。 .

克隆递归取子模块. 在现有检出中, 运行 `git submodule update --init --recursive` 安装前.

```sh
git clone --recurse-submodules https://github.com/askdkc/dsh-cli.git
cd dsh-cli
pnpm install --frozen-lockfile
pnpm build
node scripts/with-publish-manifest.mjs npm pack --ignore-scripts
TARBALL="$PWD/askdkc-dsh-cli-$(node -p "require('./package.json').version").tgz"

cd ~/DIR/TO/deepseek-harness
pnpm dsh plugin --profile dsh-cli add "@askdkc/dsh-cli@file:${TARBALL}"
pnpm dsh --profile dsh-cli
```

替换 `~/DIR/TO/deepseek-harness` 与您的退出路径。 第一次互动 发射登记册 `dsh-cli`; 打开一个新的 shell, 然后从您的工程目录中运行 . 被管理的命令保存已建的“ Harness” 检查出路径, 所以另设全局 DSH安装是不必要的. 节奏 `plugin add` 刷新已有管理 命令;不需要手工登记。 明确 `DSH_CLI_DSH_ROOT` 覆盖已保存的路径. 为了更新这个叉子,重建并重新安装了柏油球. `/update` 使用登记册.

使用名称 `@askdkc/dsh-cli@file:...` 用于本地 tarball 更新的表格。 一个赤裸的 沥青球路径会失败 `ENOENT` 当 pnpm 解析上一个 `file:` 依赖性 其档案已被删除. `TARBALL` 保存归档的绝对路径; 通过 转到安装命令而不是执行它.

关于 PATH 设置和安装问题,见 [开始](https://npmcn.com/package/%40askdkc/dsh-cli/docs/getting-started.en.md)。 。 。 .

## 可选 Kiokuko Lisp 模式

Lisp 模式由单独的 [`kiokuko-dsh`](https://github.com/askdkc/kiokuko-dsh) 插件. dsh- cli 供应 终端提示和 `/kioku-lisp` 命令处理,但插件必须是 安装在同一DSH配置文件中 :

```sh
cd ~/DIR/TO/deepseek-harness
pnpm dsh plugin --profile dsh-cli add kiokuko-dsh
```

启用配置文件中的 Lisp `cordis.patch.yml` (默认) `~/.dsh/profiles/dsh-cli/cordis.patch.yml`,然后重新启动 `dsh-cli`数字 :

```yaml
- id: kiokuko-dsh
  config:
    enabled: true
    lisp:
      enabled: true
      sbclPath: sbcl
```

需要一个工作有效的SBCL; Linux 还需要有用户的 Bubblewrap, PID, 以及 网络命名空间。 配置文件被隔离, 因此将插件添加到另一个 配置文件,例如 `web`,不启用 Lisp 模式 `dsh-cli`没有 插头, `/kioku-lisp` 无法选择 Lisp 模式。 与 插件启用, 启动等待, 激活超过 30 秒 停止启动 与诊断.

重新启动后, `/kioku-lisp status` 报告Lisp是否可用。 编码 请求可以提供 Lisp 选择,或者 `/kioku-lisp enable` 打开它 会议闭幕。 见 [开始](https://npmcn.com/package/%40askdkc/dsh-cli/docs/getting-started.en.md#optional-kiokuko-lisp-workflow) 同意、管理下的行动和指挥时间.

## 使用

`Enter` 发送, `Tab` 完成时, `Ctrl+Enter` 中断和发送,双倍 `Esc` 倒倒而来. 新闻 `?` 用于快捷键.

工作状态线遵循每个被接受的英文、日文请求,或 中国人。 含糊不清的简短请求保留了该届届会以前的进度语言; `/lang` 单独控制接口的其余部分.

`/resume` 打开会话管理器; `/auth` 连接提供者和 `/model` 选择一个模型. `/bg` 保持会话运行到TUI退出. 见 [交互和命令](https://npmcn.com/package/%40askdkc/dsh-cli/docs/interaction.en.md) 详细参考.

`/model` 打开一个带有 Favorites, News, 和提供者部分的中心取取器 . `/model seek deep` 以命令独立搜索打开; 精确 `/model provider/model-id` 直接开关。 在拾取器中,使用 `Ctrl+F` 改为 切换一个最爱, `Ctrl+A` 连接提供者,以及 `Esc` 关闭.

要导入 Claude 代码、 Codex、 OMP、 zcode 或 Grok 构建对话框, 运行 `dsh-cli migrate` 以查看现有的历史,然后 `dsh-cli migrate <agent> [--dry-run]`。工具流量不导入. 见 [会话迁移](https://npmcn.com/package/%40askdkc/dsh-cli/docs/migrate.en.md)。 。 。 .

## 文档

-   [开始](https://npmcn.com/package/%40askdkc/dsh-cli/docs/getting-started.en.md) • 妇女 [VS 代码](https://npmcn.com/package/%40askdkc/dsh-cli/docs/vscode.en.md)
-   [互动](https://npmcn.com/package/%40askdkc/dsh-cli/docs/interaction.en.md) • 妇女 [配置](https://npmcn.com/package/%40askdkc/dsh-cli/docs/configuration.en.md) • 妇女 [主题](https://npmcn.com/package/%40askdkc/dsh-cli/docs/themes.en.md)
-   [结构和限制](https://npmcn.com/package/%40askdkc/dsh-cli/docs/architecture.en.md) • 妇女 [所有文件](https://npmcn.com/package/%40askdkc/dsh-cli/docs/README.md)
-   [插件开发](https://npmcn.com/package/%40askdkc/dsh-cli/docs/plugins.en.md) • 妇女 [捐款](https://npmcn.com/package/%40askdkc/dsh-cli/docs/contributing.en.md)

## 承认

像素鲸的22个手绘相框和闲散动画来自 [{\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你这混蛋](https://github.com/lhh010/dsh-ui-whale) 以 [@lhh010 (英语)](https://github.com/lhh010) (BSD-3-Clause) (英语). 谢谢你的艺术和灵感

社区项目和配套工具: [朋友的链接](https://npmcn.com/package/%40askdkc/dsh-cli/docs/links.md)。 。 。 .

## 许可证

[麻省理工学院](https://npmcn.com/package/%40askdkc/dsh-cli/LICENSE)。保留烟囱的原始版权通知; dkc's 版权通知覆盖了叉子的独立开发.

## 常见问题

### @askdkc/dsh-cli 是什么？

DeepSeek Harness代理机,会话和工具的交互式终端接口\.

### 如何安装 @askdkc/dsh-cli？

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

### @askdkc/dsh-cli 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @askdkc/dsh-cli 支持 ESM 还是 CommonJS？

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

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

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

### @askdkc/dsh-cli 可以商用吗？

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

### @askdkc/dsh-cli 的下载量有多少？

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

### @askdkc/dsh-cli 还在维护吗？

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