DeepSeek Harness 网页版和桌面端怎么选?DSH plugin 两种形态区别
DeepSeek Harness 的网页版与桌面端不是两个产品,而是同一套 Web 应用的两种载体:网页版靠 dsh web 启动、浏览器访问 127.0.0.1:3080;桌面端是把它包进一个 Electron 应用,界面在应用窗口里加载(来源)。 这篇按三个方向讲清区别:两种形态分别是什么、能力上有哪些差异、以及你该怎么选。
DSH plugin 概览:先记住「一套应用、两种外壳」
关键事实是:桌面端是包裹了完整 dsh Web 应用的 Electron 壳,不是另写的一套客户端。 理解了这一点,后面所有差异都能顺着推出来——它们跑同一套界面逻辑、同一套插件机制,区别在于「外壳怎么启动、暴露给谁、带不带便携运行时」。
| 维度 | 网页版(dsh web) | 桌面端(DeepSeek Harness Desktop) |
|---|---|---|
| 载体 | 本地 Web 服务 + 浏览器 | Electron 应用窗口 |
| 入口 | 浏览器打开 127.0.0.1:3080 | 直接打开应用 |
| 对应 profile | web | desktop(CLI 不接管) |
| 对外暴露 | 可配 --public-url 对外 | 不出浏览器地址栏 |
DSH plugin 两种形态分别是什么:浏览器里的 Web UI 与独立桌面应用
网页版是一个本地 Web 服务,桌面端是一个把界面锁在应用窗口内的 Electron 应用。 分开看它们的入口与启动方式:
- 网页版 — 用
dsh web(或npx @deepseek-ai/dsh web)启动,服务默认监听127.0.0.1:3080,在任意浏览器访问该地址即可使用(来源)。预期:终端打印本地地址,浏览器里出现完整操作界面。 - 桌面端 — 从官网下载 dmg / exe 安装后直接打开应用,界面通过应用内
dsh-app://协议加载,不会跳到浏览器(来源)。预期:启动后停在应用窗口内的加载页,随后进入界面。
一个容易踩的坑:桌面端不面向浏览器,别指望在地址栏敲 127.0.0.1:3080 打开桌面端;它默认监听的是操作系统分配的临时端口,本就与网页版的固定 3080 错开。
DSH plugin 能力与差异对照:插件生态、本地能力、跨设备访问与资源占用
两者的插件机制完全一致(都从同一个插件市场加插件),差异集中在本地能力、对外可达性与运行环境。 逐项对照:
| 能力维度 | 网页版 | 桌面端 |
|---|---|---|
| 插件生态 | 同一套插件与市场;装在 web profile | 同一套插件与市场;装在 desktop profile |
| 本地文件 / 会话 | 与终端同机,直接读写工作区 | 同机,界面内提供原生目录选择框 |
| 跨设备访问 | 可对外暴露,别的设备浏览器能访问 | 界面锁在应用窗口,不适合跨设备 |
| 运行环境 | 用系统自带的 Node / 包管理器 | 随包内置 Node、pnpm、Python 运行时 |
| 监听端口 | 默认 3080(固定) | 操作系统分配(不撞 3080) |
几点展开:
- 插件生态一致,但不自动同步。 两种形态都从同一个插件市场装插件,命令与安装体验相同;但插件落在各自的 profile 里——装在 web profile 的不会自动出现在 desktop profile,换形态要在新环境里重装一遍。找插件、装插件、看同类实现都可以走 DSH Plugin Hub。
- 本地能力差别不大。 两者都跑在同一台机器上,都能读写工作区;桌面端额外提供挂在应用窗口上的原生目录选择框,网页版走宿主自己的目录选择器。
- 对外可达性是分水岭。 网页版是标准本地 Web 服务,可用
--public-url与反向代理对外发布,从而在手机或另一台电脑上访问;桌面端为单机使用设计,不面向浏览器地址栏。跨设备访问相关配置见《DeepSeek Harness 手机访问》。 - 运行环境与占用不同。 网页版依赖你系统里的 Node 与包管理器;桌面端自带独立的 Node、pnpm 与 Python 分发,包操作全用内置运行时,代价是安装包更大、占用的磁盘更多。
DSH plugin 该怎么选:快速上手选 Web UI,常驻与本地集成选桌面端
选型只看两件事:要不要跨设备、要不要少折腾环境。 对照选择:
- 只想最快用上 → 选网页版。一条
npx @deepseek-ai/dsh web命令、浏览器打开即用,适合体验与临时使用。预期:几分钟内进入界面。 - 天天用、要当桌面应用常驻 → 选桌面端。装上即开,不占终端窗口,自带运行时省去环境配置。预期:双击图标直接进入界面。
- 要跨设备 / 远程访问 → 选网页版。它天然是可对外暴露的 Web 服务,配合对外地址使用。预期:其他设备浏览器可访问同一份会话数据。
- 要命令行管理插件、写脚本 → 选网页版。
dsh plugin --profile web ...这类命令直接作用于 web profile,与脚本化流程衔接顺畅。
两者共享哪些配置?共享数据、不共享可执行层。 会话、设置与密钥都落在同一个 $DSH_HOME(默认 ~/.dsh),所以换个形态不必重配模型;但可执行包、node_modules 与锁文件各自独立,插件按 profile 分开装。桌面端的 profile 由它自己独占,命令行不能启动或修改。

使用 DSH plugin 的注意事项
网页版与桌面端都是这枚 DSH插件(DeepSeek插件)的载体,以下几条注意点两者都适用。 逐条如下:
- 别混用 profile:网页版是 web profile,桌面端独占 desktop profile,插件与配置按 profile 生效,排查问题时先确认装在哪一边。
- 桌面端不接浏览器:它用应用内协议加载界面,地址栏访问无效,也不做对外服务。
- 端口不冲突:网页版固定 3080,桌面端默认系统分配,两者可同时运行。
- 数据别乱搬:
$DSH_HOME里存着会话与凭据,迁移或清理前先确认影响。 - 首次都要配模型:无论哪种形态,第一步都是在设置里填模型提供方与密钥,否则会话用不了。
来源:dsh CLI README、DeepSeek Harness 桌面端 README、dshplugin/dsh-plugin-hub
常见问题
两个都是官方形态,桌面端本质是包裹了完整 dsh Web 应用的 Electron 壳。 网页版用 dsh web 启动,在浏览器里访问;桌面端把这些打包成一个独立应用,界面通过应用内协议加载,不必开浏览器。它们跑的是同一套 Web 应用,不是两套不同的产品。
桌面端默认监听操作系统分配的端口,因此不会和网页版固定的 3080 撞车。 网页版 dsh web 默认绑定 127.0.0.1:3080;桌面端同样绑定 127.0.0.1,但端口由系统分配,只有显式给 webserver 配置端口时才会改。所以两者可以同时开着互不抢占。
插件机制完全一样,但插件装在各自的 profile 里,需要分别安装。 网页版装在 web profile,桌面端在它独占的 desktop profile 里。两者共享同一套插件市场与安装命令,但不会自动同步已装插件,换形态后要在对应环境里重新装一遍。
跨设备访问要靠网页版配合对外地址,桌面端是给本机用的。 网页版是标准的本地 Web 服务,可以借助 --public-url 与反向代理对外暴露,从而在别的设备浏览器里访问;桌面端把界面锁在应用窗口内,不面向浏览器地址栏,不适合跨设备。
会话、设置与凭据共享,可执行包与插件各自独立。 两者都读同一个 $DSH_HOME 数据根,所以模型密钥、会话历史是通的;但可执行包、node_modules 与锁文件不共用,插件按 profile 分开,改一边不会弄坏另一边的版本。
相关术语
- Web UI(dsh web)
- Web UI 是 DeepSeek Harness 在浏览器里操作界面的形态,由 `dsh web` 子命令启动,默认在 127.0.0.1:3080 提供本地 Web 服务。它属于 web profile。— dsh CLI README
- DeepSeek Harness 桌面端
- DeepSeek Harness 桌面端是包裹完整 dsh Web 应用的 Electron 应用,界面经应用内 `dsh-app://` 协议加载,不面向浏览器地址栏,插件与运行环境由应用自带的运行时管理。— DeepSeek Harness 桌面端 README
- profile(形态对应的工作环境)
- profile 是 DeepSeek Harness 里一套有序的插件与配置栈,网页版对应 web profile、桌面端独占 desktop profile。插件装在哪个 profile,就只影响那个环境。— dsh CLI README
- $DSH_HOME
- $DSH_HOME 是 DeepSeek Harness 的数据根目录,默认位于 ~/.dsh,会话、设置、凭据与插件都存放在这里,网页版与桌面端共享同一份。— DeepSeek Harness 桌面端 README
来源
- dsh CLI README· deepseek-ai
- DeepSeek Harness 桌面端 README· deepseek-ai
- dshplugin/dsh-plugin-hub· dshplugin