Breeze136/dsh-oneclick

dsh-oneclick

英文 | 简体中文

官方 DeepSeek Harness Web 应用的一键式 Windows 安装程序。

它的存在是因为手动安装路径存在一些会阻碍非技术用户的棘手问题：在任何东西能正常工作之前，你需要先安装 Node.js；DSH CLI 必须在 PATH 上；插件需要 pnpm；知识库插件需要 Python 以及约 1.2 GB 的检索模型；而 Web 应用的入口 URL 带有一个每进程令牌，普通的 http://127.0.0.1:3080 书签无法复现它（从未访问过的浏览器会收到 401；首次访问后，一个 30 天的 cookie 会让它正常工作）。这个安装程序会完成所有这些工作，验证每一次下载，并留下一个开箱即用的桌面快捷方式。

安装

有终端 —— 无需先下载任何东西：

npx dsh-oneclick

没有终端 —— 下载最新版本，解压到任意位置，然后双击 install.cmd。

两种方式运行的是同一个安装程序。这就是全部的手动操作：重新运行它会更新所有过期的内容，并跳过其他一切。

安装进行到一半时，它会提供作者自己的 dsh-kb-rag 知识库插件。这个提供是推荐，而非必需——回答 n 是一个正常的选择，而不是降级的安装。它的作用明确说明了两种情况下具体会发生什么变化。

它的作用

| 步骤 | 操作 |
|---|---|
| 1 | Node.js —— 使用现有安装；如果没有，则将官方 Windows zip 解压到 %LOCALAPPDATA%\DSH\node（无需管理员权限，不触碰系统 PATH） |
| 2 | DSH CLI + pnpm —— npm install -g @deepseek-ai/dsh pnpm（官方 CLI，随附 Web 应用） |
| 3 | 快捷方式 —— 一个名为 DeepSeek Harness 的桌面快捷方式，用于启动 Web 应用并打开浏览器 |
| 4 | kb-rag 知识库——提供，但非必需 —— 此插件是安装程序作者的另一个开源项目，因此安装程序推荐它并询问一次（dsh plugin --profile web add dsh-kb-rag@）。按 Enter 安装它；n 跳过它，让你得到纯净的官方 DSH |
| 5 | 引擎（仅在使用插件时） —— 委托给插件自带的 scripts/install.ps1 来安装 Python 依赖和约 1.2 GB 的检索模型 |

步骤 4 和 5 是唯一涉及作者自己的作品而非 DeepSeek 的步骤。推荐是真诚的，但退出也同样真诚：回答 n 会给你完全官方的设置，不会改变运行中的其他任何内容，并且除非你再次运行安装程序，否则它不会再次询问。

一切都按用户安装。不注册任何服务，不向启动项添加任何内容，并且 ~/.dsh 下的任何现有会话、工作区或凭据都不会被删除——重新运行只会更新插件。

要求

- Windows 10 或更高版本，64 位
- 约 8 GB 可用磁盘空间（Node、DSH、Python 环境和模型）
- 互联网连接。在官方主机速度较慢的地方会使用镜像；
在中国大陆，默认使用 npmmirror（软件包）、腾讯（pip）和 hf-mirror（模型），这些都是经过实测而非猜测得出的。

选项

双击 install.cmd 无需任何参数。标志有两种拼写形式，含义完全相同——选择与你安装方式对应的那一种即可：

| 你想要的效果 | npx 方式 | 发布压缩包 |
|---|---|---|
| 仅检查机器，不做任何更改 | npx dsh-oneclick --check | install.cmd -CheckOnly |
| 打印计划，不安装任何内容 | npx dsh-oneclick --dry-run | install.cmd -DryRun |
| 仅测试下载通道 | npx dsh-oneclick --self-test | install.cmd -SelfTest |
| 仅安装官方 DSH，不含 kb-rag | npx dsh-oneclick --no-plugin | install.cmd -SkipPlugin |
| 跳过约 1.2 GB 的检索模型 | npx dsh-oneclick --no-models | install.cmd -NoModels |
| 不创建桌面快捷方式 | npx dsh-oneclick --no-shortcut | install.cmd -NoShortcut |
| 固定插件版本 | npx dsh-oneclick --plugin-version 1.6.7 | install.cmd -PluginVersion 1.6.7 |
| 从不提示 | npx dsh-oneclick --yes | install.cmd -Yes |
| 完整列表 | npx dsh-oneclick --help | 参见 tools/install.ps1 顶部的参数块 |

其余开关——-SkipNode、-SkipDshCli、-SkipEngine、-WorkDir、-PipMirror、-NpmRegistry、-NoPause——在两种方式中都存在，名称如该参数块所示；npx 原样接受 PowerShell 拼写形式。

离线或镜像安装

安装程序会先检查自身旁边的 payload/ 目录。将 node-v24.21.0-win-x64.zip（官方 Node 压缩包，sha256 已对照官方 SHASUMS256.txt 校验）放入该目录，就不会再下载 Node。其余所有内容仍从 npm 获取。

发布压缩包

如果要把它交给不想碰终端的人，请使用该 zip：解压后双击 install.cmd。它包含相同的安装程序，外加三份简短的中文指南——GETTING-STARTED.txt、MODEL-SETUP.txt 和 NEXT-STEPS.txt——它也是文件分享网站和 U 盘场景下的安装方式，因为在这些场景中无法使用 npx。

从仓库根目录重新构建它：

powershell -NoProfile -ExecutionPolicy Bypass -File tools\make-release.ps1

该脚本会为恰好进入压缩包的那些文件重新生成 sha256.txt，并打印压缩包自身的 SHA-256，这就是要随下载一起发布的值。

安装之后

首次启动会要求提供模型提供商和 API 密钥，然后要求提供工作区。发布压缩包中的 MODEL-SETUP.txt 会逐步讲解这两项，包括在哪里创建密钥。快捷方式的服务器在一个最小化的控制台窗口中运行；关闭该窗口即会停止服务器。

范围与免责声明

这是一个第三方辅助脚本。它并非由 DeepSeek 发布，运行它也不会让你的安装变成“官方”——它是通过官方渠道（npm install -g @deepseek-ai/dsh）安装官方软件包，
这是官方文档要求你做的。

桌面快捷方式使用 DeepSeek 标志，以便图标能标识它启动的是什么。DeepSeek 的名称和标志归其所有者所有；关于图标文件的确切来源及其许可证说明，请参见 assets/ICON-SOURCE.txt。

布局

bin.mjs                  npx 入口点（标志转换 + 移交给 install.ps1）
package.json             npm 包清单（bin、files、version）
install.cmd              发布压缩包的双击入口
tools/install.ps1        安装程序
tools/dsh-web.ps1        桌面快捷方式背后的启动器
tools/make-release.ps1   构建发布压缩包
assets/                  图标 + 其来源
payload/                 将官方 Node zip 放在此处以进行离线安装
GETTING-STARTED.txt      初学者指南（中文）
MODEL-SETUP.txt          模型/API 密钥操作说明（中文）
NEXT-STEPS.txt           安装程序完成后立即要做的事（中文）
COMPAT.md                与 kb-rag 插件的约定（包名、配置文件、引擎入口、标志）
sha256.txt               发布压缩包中每个文件的哈希值
VERSION.txt              版本号 + 维护者变更日志（两种分发途径均不附带）

一个仓库，两种分发途径，各自只附带其受众所需的内容：npm 包添加 bin.mjs + package.json，发布压缩包添加 install.cmd 和中文指南。tools/make-release.ps1 将 npm 文件（以及 VERSION.txt 和它自身）从 zip 中排除；package.json 的 files 列表将仅维护者使用的文件从 tarball 中排除。版本一致性检查使 VERSION.txt、tools/install.ps1 和 package.json 保持同步，并在它们不一致时拒绝构建。

这三份初学者指南（以及安装程序自身的注释）用中文编写，因为发布压缩包正是为这一受众构建的；本 README 为英文，而 README_CN.md 为中文。

许可证

MIT — 参见 LICENSE。