🐳 DeepSeek Harness（dsh）部署指南

版本：v3.0　·　更新日期：2026 年 10 月 24 日

本文只保留 部署方式、转跳链接、配图 三项干货，覆盖 本地款（桌面/本机部署）与 浏览器款（浏览器插件部署）两大类方式，按步骤操作即可跑通。

📑 目录

一、下载与转跳链接
二、本地款 · 部署方式
三、浏览器款 · 部署方式
四、入场动画插件部署
五、相关资源链接

一、下载与转跳链接

🔗 DeepSeek Harness 官方

资源	链接
官网（中文）	https://deepseekharness.online/
官网（英文）	https://www.deepseek.com/harness/en/
桌面客户端下载	https://dsharness.app/zh/download/
GitHub 源码	https://github.com/deepseek-ai/deepseek-harness
DSH Desktop FAQ	https://dsharness.app/zh/faq/
浏览器插件目录	https://www.dshplugin.store/category/browser
dsh 社区指南	https://dsharness.io/zh

⚙️ 环境依赖

资源	链接
Node.js	https://nodejs.org/

DeepSeek Harness 品牌形象

图 1：DeepSeek Harness 品牌形象

DeepSeek 官方 Logo

图 2：DeepSeek 官方 Logo

二、本地款 · 部署方式

「本地款」= 在你自己电脑上运行的部署方式，适合个人日常使用，数据密钥都留在本机，私密安全。

方案 1：桌面客户端（最省事）

打开下载页：https://dsharness.app/zh/download/
Windows 下载 DSH.Desktop_0.2.17_x64-setup.exe；macOS 下载对应 .dmg
双击安装，按向导完成
启动后登录 DeepSeek 账号，领取限时 300 万 Token

⚠️ Windows 注意：出现 SmartScreen 提示时，核对校验值后点「更多信息 → 仍要运行」。

方案 2：npm 快速启动（命令行）

需先安装 Node.js（https://nodejs.org/）：

# 全局安装
npm i -g @deepseek-ai/dsh

# 启动 Web UI
npx @deepseek-ai/dsh web

启动后浏览器打开：http://127.0.0.1:3080

方案 3：源码本地部署（开发者）

git clone https://github.com/deepseek-ai/deepseek-harness
cd deepseek-harness
npm install
npm run dev

🛠 本地款部署排错

问题	解决办法
提示没有 Node.js	安装 Node.js 18+：https://nodejs.org/
浏览器打不开	确认 `http://127.0.0.1:3080`，防火墙放行 3080 端口
装插件报权限错	见下文「allowBuilds 授权」

三、浏览器款 · 部署方式

「浏览器款」= 以 Chrome/Firefox 扩展插件形式部署，让 AI Agent 能操控你的真实浏览器，或在浏览器侧边栏直接嵌入 dsh 界面。

3.1 dsh-browser（Chrome 侧边栏扩展）

作用：Chrome 侧边栏扩展，让 DeepSeek Harness 直接操控你的浏览器，无需视觉能力
开发者：@omdsh-dev（869★）
插件页：https://www.dshplugin.store/plugin/omdsh-dev/dsh-browser

# DSH 侧安装对应插件
dsh plugin --profile web add github:omdsh-dev/dsh-browser

3.2 dsh-chrome（内嵌完整 dsh Web UI）

作用：Chrome 侧边栏嵌入完整的 dsh Web UI + 页面读取、HTTP 抓取、浏览器控制
开发者：@stuarthu
插件页：https://www.dshplugin.store/plugin/stuarthu/dsh-chrome

dsh plugin --profile web add github:stuarthu/dsh-chrome

3.3 dsh-browser-control（Chrome 扩展 + DSH 插件）

作用：Chrome 浏览器扩展 + DeepSeek Harness 插件，让 AI Agent 直接操控你的真实浏览器
开发者：@caob23
插件页：https://www.dshplugin.store/plugin/caob23/dsh-browser-control

dsh plugin --profile web add github:caob23/dsh-browser-control

3.4 dsh-browser-crossplatform（跨平台浏览器扩展）

作用：桌面端 DSH 配套浏览器扩展，模型读取当前页面为带编号文本并执行点击/输入/滚动/导航/管理标签，可开启图像识别
开发者：@youbaiyun
插件页：https://www.dshplugin.store/plugin/youbaiyun/dsh-browser-crossplatform

dsh plugin --profile web add github:youbaiyun/dsh-browser-crossplatform

3.5 浏览器款部署要点

步骤	说明
1	先在本地启动 dsh：`npx @deepseek-ai/dsh web`，确保服务运行
2	安装浏览器扩展：Chrome 网上应用店加载对应扩展
3	安装 DSH 配套插件：用 `dsh plugin add` 安装对应插件包
4	重启 + 强刷：重启 dsh 服务，浏览器 `Ctrl+Shift+R` 强刷
5	连接授权：在扩展中授权连接本机 dsh，即可让 AI 操控浏览器

💡 更多浏览器插件：完整列表见 https://www.dshplugin.store/category/browser，按 Star 数筛选可信插件。

四、入场动画插件部署

插件：NativeDog1/dsh-boot-animation（UI 增强插件） 介绍页：https://awesome-dsh-plugin.com/p/NativeDog1/dsh-boot-animation/

DSH 鲸鱼图标

图 3：DSH 鲸鱼图标

安装命令

# 从 GitHub 安装（首次运行询问 allowBuilds 授权）
dsh plugin --profile web add github:NativeDog1/dsh-boot-animation

# 或从 npm 安装（发布后）
dsh plugin --profile web add dsh-boot-animation

安装后重启

# 先停掉正在运行的 dsh web，再重新启动
dsh web

装完没反应？

强制刷新浏览器缓存：Ctrl+Shift+R（普通 F5 不够）
重启 dsh 服务

allowBuilds 授权

从 GitHub 安装时可能报错 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED / ERR_PNPM_IGNORED_BUILDS：

dsh 会打印需要加入 allowBuilds 的精确 key
加到 profile 的 pnpm-workspace.yaml，重新安装即可

使用自己的片头视频

# 放入自定义视频
mkdir -p ~/.dsh/boot-animation/videos
cp my-intro.mp4 ~/.dsh/boot-animation/videos/

# 查看当前生效视频
curl http://127.0.0.1:3080/dsh-boot-animation/status.json

支持的 dsh 版本

DSH 版本	状态
`0.1.5-rc.x` / `0.1.7-rc.x`	✅ 支持
`0.2.0-rc.x`	✅ 支持

五、相关资源链接

资源	链接
dsh 插件市场	https://awesome-dsh-plugin.com/
dsh 插件商店（浏览器类）	https://www.dshplugin.store/category/browser
DeepSeek Harness 插件教程	https://deepseek-plugin.org/zh/learn/install-plugins
dsh 快速上手	https://dshai.org/quickstart
dsh 中文社区	https://dsharness.io/zh
Node.js 下载	https://nodejs.org/

说明：工具版本、下载地址、功能以各官方网站最新发布为准。插件会运行第三方代码，请安装可信来源并注意安全。

DeepSeek Harness（dsh）部署指南