dshx-terminal 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；暂不能直接安装（需源码编译或环境不满足）：要求 dsh 0.1.0-rc.6，而最新版为 0.2.1-rc.2。

dshx-terminal 兼容性怎么样？

暂不能直接安装（需源码编译或环境不满足）：要求 dsh 0.1.0-rc.6，而最新版为 0.2.1-rc.2。

dshx-terminal 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dshx-terminal 还在维护吗？

GitHub 5 星。最近一次上游提交在 2026/8/14。

终端交互前端 Maydaytyh/dshx-terminal

DeepSeek Harnessv0.4.2

Maydaytyh82 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

在命令行里直接与 Agent 对话并执行工具

30.2/100

综合分

GitHub 星标

npm 周下载

—/5

用户评分

数据截至 2026/9/17 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

自动兼容检查未通过：要求 dsh 0.1.0-rc.6，而最新版为 0.2.1-rc.2。以下命令仍可尝试，但可能失败。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add Maydaytyh/dshx-terminal

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：需留意

是什么[目录]—

dsh 原生插件 · ui

暂无时间戳·判据 →

装得上吗[实装验证]!

静态安装检查未通过，可能需要源码安装

L4 · 真实安装等级说明 →

数据截至 2026/11/02·判据 →

安全吗[自动扫描]—

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

数据截至 2026/11/04·判据 →

还在维护吗[仓库]—

更新放缓：最近一次提交在 82 天前

暂无时间戳·判据 →

图例：✓ 通过! 需注意— 未判定 / 无数据· 「未判定」= 本站尚无数据，不代表插件有问题

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

可信度证据

安装兼容性检查需源码安装

要求 dsh 0.1.0-rc.6，而最新版为 0.2.1-rc.2

展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出，未做人工实机验证——能装不等于用着没问题。

✓npm 包dshx-terminal @ 0.4.2

✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足

✗dsh CLI 依赖要求 0.1.0-rc.6 · 最新 0.2.1-rc.2 不兼容

✓入口文件main/exports/bin 已声明

源码安装时若 pnpm 拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑。

验证方式：npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/20 04:29:22

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件

查看扫描证据（共 17 处，展示前 17 条）

读取本地文件
lib/state.js:22
const parsed = JSON.parse(await readFile(path, 'utf8'))
写入本地文件
lib/state.js:47
await mkdir(dirname(path), { recursive: true, mode: 0o700 })
写入本地文件
lib/state.js:49
await writeFile(temporary, `${JSON.stringify(state, null, 2)}\n`, { mode: 0o600 })
写入本地文件
lib/state.js:50
await rename(temporary, path)
读取本地文件
lib/bootstrap.js:10
const packageJson = JSON.parse(readFileSync(join(packageRoot, 'package.json'), 'utf8'))
读取本地文件
lib/bootstrap.js:27
return JSON.parse(readFileSync(path, 'utf8'))
读取本地文件
lib/bootstrap.js:65
if (existsSync(artifactPath)) return artifactPath
写入本地文件
lib/bootstrap.js:66
mkdirSync(artifactDirectory, { recursive: true, mode: 0o700 })
执行外部命令固定命令
lib/bootstrap.js:67
const packed = spawnSync(
读取本地文件
lib/bootstrap.js:73
if (packed.status !== 0 || !existsSync(artifactPath)) {
执行外部命令固定命令
lib/bootstrap.js:80
const check = spawnSync('corepack', [`pnpm@${PINNED_PNPM_VERSION}`, '--version'], { encoding: 'utf8' })
写入本地文件
lib/bootstrap.js:87
writeFileSync(
写入本地文件
lib/bootstrap.js:93
writeFileSync(shimPath, `#!/bin/sh\nexec corepack pnpm@${PINNED_PNPM_VERSION} "$@"\n`, { mode: 0o755 })
写入本地文件
lib/bootstrap.js:94
chmodSync(shimPath, 0o755)
删除本地文件递归
lib/bootstrap.js:98
dispose: () => { rmSync(shimDirectory, { recursive: true, force: true }) },
执行外部命令来自配置/变量
lib/bootstrap.js:109
result = spawnSync(
读取本地文件
lib/bootstrap.js:127
if (!existsSync(join(home, 'profiles', PROFILE_NAME, 'package.json'))) {

扫描于 2026/11/4（1 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/dsh@deepseek-ai/dsh-agent@deepseek-ai/dsh-code-runtime-worker-thread@deepseek-ai/dsh-llm@deepseek-ai/dsh-session@deepseek-ai/dsh-session-stats@deepseek-ai/dsh-tool-ask-user@deepseek-ai/schemastery

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

功能亮点

命令行对话Agent
执行工具

DeepSeek Harness 非官方原生交互式终端前端

README

由 DeepSeek 最新模型翻译生成

展开完整文档（README 剩余 1 节）

dshx

npm version
GitHub release

dshx 是 DeepSeek Harness 的原生交互式终端前端。它直接使用 Harness 的 Agent、工具、沙箱、权限确认、会话持久化和用户追问服务，不需要打开浏览器。

[!IMPORTANT]
这是社区维护的非官方项目，与 DeepSeek 没有隶属或背书关系。

平台支持

dshx 不是 macOS 专用程序，CLI 本身使用跨平台 Node.js API，发布包也没有设置操作系统限制。

| 平台 | 状态 | 说明 |
| macOS Apple Silicon | 已验证 | 当前主要开发与回归环境 |
| Linux x64 / ARM64 | 支持 | 推荐 Ubuntu、Debian 等 glibc 发行版；依赖包含对应 Linux 原生组件，正式 Linux CI 尚在补充 |
| Alpine / musl | 未完整验证 | 部分原生依赖可能需要额外构建工具 |
| Windows | 实验性 | 启动逻辑已做路径兼容，但尚未完整回归 |

安装

需要 Node.js 22.19.x 或 Node.js 24+，并确保 corepack 命令可用。dshx 会通过 Corepack 固定使用 pnpm 11.7.0 初始化自己的 Harness profile。

macOS 和 Linux 使用相同的 npm 安装方式。先检查运行环境：

node --version
corepack --version

如果系统没有 corepack，先安装并启用：

npm install -g corepack
corepack enable

通过 npm 安装（推荐）：

npm install -g dshx-terminal
dshx --version

也可以从 GitHub Release 下载、校验并安装：

curl -LO https://github.com/Maydaytyh/dshx-terminal/releases/download/v0.4.2/dshx-terminal-0.4.2.tgz
curl -LO https://github.com/Maydaytyh/dshx-terminal/releases/download/v0.4.2/dshx-terminal-0.4.2.tgz.sha256
shasum -a 256 -c dshx-terminal-0.4.2.tgz.sha256
npm install -g ./dshx-terminal-0.4.2.tgz
dshx --version

上面的校验命令适用于 macOS；Linux 通常使用：

sha256sum -c dshx-terminal-0.4.2.tgz.sha256

需要通过本机 7890 代理下载安装依赖时，先设置：

export HTTP_PROXY=http://127.0.0.1:7890
export HTTPS_PROXY=http://127.0.0.1:7890
export ALL_PROXY=socks5://127.0.0.1:7890

在远程 Linux 服务器上，127.0.0.1:7890 指服务器自身；如果代理运行在另一台机器，需要换成该代理对服务器可访问的地址。

设置 DeepSeek API Key：

export DEEPSEEK_API_KEY="your-api-key"

也可以写入 ~/.dsh/.credentials.yaml：

DEEPSEEK_API_KEY: "your-api-key"

首次真正运行 dshx 时会自动创建独立的 ~/.dsh/profiles/dshx 配置。

使用

在项目目录启动：

cd /path/to/project
dshx

也可以带上第一条任务，完成后继续对话：

dshx "先阅读这个项目并告诉我如何运行"

一次性执行并退出：

dshx -p "列出项目里最大的三个文件"

恢复当前目录最近的会话：

dshx --continue

常用选项：

-C, --cwd 指定工作目录 -c, --continue 恢复当前目录最近会话 -r, --resume 恢复指定会话 -p, --print 一次性运行 --permission-mode read-only | workspace-write | danger-full-access --tools native | code | both --endpoint 切换并保存当前命名端点 --dangerously-skip-permissions 完全访问且不再询问（谨慎使用）

交互中输入 /help 可查看 /permission、/compact、/plan、/goal 等 Harness 命令。按 Ctrl-C 可取消正在运行的任务；空闲时按 Ctrl-C 退出。

可以直接粘贴多行 prompt。粘贴内容中的换行会暂时显示为 ␤，不会提前提交；检查内容后再按一次 Enter，dshx 会将它作为一个完整的多行 prompt 发送。

模型与状态 dshx 使用与 Harness 网页端相同的模型目录和会话统计投影。任务运行时，终端底部会显示一条约每秒更新一次的实时状态栏，包括当前模型、运行阶段或工具、耗时、TTFT、生成速度、输出 Token、Prompt Cache 命中率和上下文占用：

● deepseek-official/DeepSeek-V4-Flash · 生成中 8.4s · TTFT 0.9s · ~38.6 tok/s · 输出 ~326 · 缓存 82% · 上下文 12%

流式阶段的输出 Token 和生成速度带 ~，表示根据当前字符流与本地计时估算；提供方返回 usage 后会切换为精确 Token。缓存信息只能在模型提供 usage 后计算，在此之前显示 —。每轮完成后则使用 Harness 的精确累计投影，显示当前模型、轮次、模型与工具耗时、TTFT、生成速度、Token 用量、缓存命中率和上下文占用；统计会随会话一起持久化，不受历史分页或上下文压缩影响。

deepseek-official/DeepSeek-V4-Flash | 2 轮 · 4 步 | 模型 18.2s · 工具 1.1s | 缓存命中 82% | 输入 18.4K · 输出 1.2K | 上下文 12%

实时状态栏只在交互式 TTY 中启用；--print、管道和重定向输出不会包含终端控制字符。

交互式选择模型与推理强度：

/model

也可以直接指定路由：

/model deepseek-official/deepseek-v4-pro high

查看完整状态、Token 与 Prompt Cache 明细：

/status
/usage

其中输入 Token 与网页端口径一致，由未缓存输入、缓存读取和缓存写入三个互不重叠的部分组成；缓存命中率为缓存读取占全部输入的比例。上下文占用优先使用 Harness 对下一次请求的投影值，因此执行 /compact 后会立即更新。

多个 API 端点

可以在 Harness 的 ~/.dsh/settings.yaml 中保存多个命名端点。activeEndpoint 是默认使用的端点；每个端点只保存 Base URL 和凭据引用，不保存 API Key 明文：

dshx-terminal:
activeEndpoint: official
endpoints:
official:
description: DeepSeek 官方 API baseURL: https://api.deepseek.com apiKeyEnv: DEEPSEEK_API_KEY proxy: description: OpenAI 兼容代理 baseURL: https://proxy.example.com/v1 apiKeyEnv: PROXY_API_KEY

对应密钥继续放在 ~/.dsh/.credentials.yaml：

DEEPSEEK_API_KEY: "sk-official"
PROXY_API_KEY: "sk-proxy"

保护凭据文件：

chmod 600 ~/.dsh/.credentials.yaml

运行中交互选择端点，或者直接按名称切换：

/endpoint
/endpoint proxy

也可以在启动时切换；该选择会写回 activeEndpoint，后续启动继续使用：

dshx --endpoint proxy

切换通过 Harness 设置服务热更新，下一次模型请求立即使用新的 baseURL 和 apiKeyEnv。运行中直接编辑当前端点定义也会自动同步。Base URL 会拼接 /chat/completions，因此代理服务使用 OpenAI 风格路径时通常应配置到 /v1；端点需要兼容 DeepSeek 的流式 Chat Completions 请求和响应。

默认权限模式是 workspace-write：Agent 可以读取文件，并在当前工作目录及受控临时目录写入；其他超出工作区的写操作会在终端里征求许可。

卸载

npm uninstall -g dshx-terminal

如果不再需要会话和独立 profile，可另外删除 ~/.dsh/profiles/dshx 与 ~/.dsh/dshx-state.json。

许可证

本项目使用 MIT License。DeepSeek Harness 本身也采用 MIT License。