返回 DSH Guides

DSH Web UI 使用指南

DSH Web UI 使用指南：启动、登录报错与手机访问

DSH Web UI 是 DeepSeek Harness 官方的网页界面，一条命令就能打开，在浏览器里和 Agent 对话、改代码、跑命令。下面从启动讲到第一次配置、登录报错、手机和局域网访问，再到常用的增强插件，每一步都对照官方源码和文档核实过。

DeepSeek HarnessDSH PluginsDeveloper Preview

默认端口 3080

只监听本机 127.0.0.1:3080，换端口用 --port。

没有密码，靠登录链接

终端打印的网址带启动令牌，打开一次就登录 30 天。

改设置不用重启

在设置里保存 DeepSeek API Key 后立即可用。

本文目录+
01

怎么打开 DSH Web UI

DSH Web UI 不用单独安装。装好 Node.js 后，下面三种方式任选一种。启动后终端会打印访问地址，在本机启动还会自动用默认浏览器打开。

方式命令适合谁
npx（推荐）npx @deepseek-ai/dsh web第一次用，不想全局安装
已安装 dshdsh web全局安装过 @deepseek-ai/dsh，命令行能直接用 dsh
从源码运行pnpm dsh web克隆官方仓库，先跑过 pnpm install 和 pnpm run build

通过 SSH 登录服务器启动时，浏览器不会弹出，终端只打印地址，因为转发端口由你的 SSH 客户端或编辑器掌握。

02

dsh web 常用参数

参数写在 web 后面，比如 npx @deepseek-ai/dsh web --port 8080。"打不开""端口冲突"这类问题，多数靠下面几个参数解决。

参数作用例子
--port换端口；填 0 让系统挑一个空闲端口dsh web --port 8080
--no-open只启动服务，不打开浏览器dsh web --no-open
--host绑定本机某个网卡地址。必须是具体 IP，0.0.0.0 这类通配地址会被拒绝dsh web --host 192.168.1.20
--public-url + --trusted-host放在反向代理或域名后面时用--public-url https://app.example/ --trusted-host app.example
--tls-cert + --tls-key用自己的证书直接提供 HTTPS--tls-cert ./chain.pem --tls-key ./key.pem
03

authentication required 报错怎么解决

完整报错是 "dsh web authentication required; reopen the URL printed by dsh web"，意思是这个浏览器还没有登录正在运行的 DSH Web UI。

DSH Web UI 没有账号密码。每次启动时，终端打印的网址后面带一个 ?token= 启动令牌，浏览器打开这个网址后，用令牌换一个签名的登录 cookie，默认 30 天有效，之后再打开就不需要令牌。登录 cookie 按地址分开保存，localhost:3080 和 127.0.0.1:3080 算两个地址。

常见触发原因

  • 直接在地址栏输入 127.0.0.1:3080，或从书签打开，而这个浏览器从没打开过带令牌的网址。
  • 换了浏览器、用了无痕窗口，或清过 cookie。
  • 地址写法变了：把 127.0.0.1 换成 localhost，或者换了端口。
  • 复制网址时把 ?token= 后面的部分弄丢了。
  • 上次登录超过 30 天，cookie 过期。

解决方法

  1. 1回到运行 dsh web 的终端，找到它打印的完整网址（包含 ?token=）。
  2. 2用你要用的浏览器打开这个网址，不要删掉后面的参数。
  3. 3终端已经关掉或找不到网址时，按 Ctrl+C 停止（或关掉那个终端），重新运行 npx @deepseek-ai/dsh web，会打印新的网址。

带令牌的网址就是登录凭据，不要发到群里，也不要出现在截图里。

04

第一次使用：配模型、选工作区、跑第一个任务

dsh 进程会把启动时所在的目录当作默认位置，所以在项目目录里运行启动命令，选工作区最省事。模型设置里除了 DeepSeek，也能接其他提供方和 OpenAI 兼容的接口。

  1. 1打开「设置 → 模型」，填入在 DeepSeek 开放平台 申请的 API Key 并保存，马上生效，不用重启。
  2. 2点击「选择工作区」，添加你的项目目录并选中。没选工作区时输入框不能用，这是网页版"打不了字"最常见的原因。
  3. 3新建会话，发一个任务试试，比如"总结这个仓库的结构和主要模块"。Agent 会读写工作区文件、运行命令；按你的权限设置需要审批的操作，网页会先问你。
05

用手机、局域网或远程访问 DSH Web UI

DSH Web UI 默认只监听本机回环地址，手机和别的电脑打不开。按你的场景选一种做法：

场景做法要注意
同一 Wi-Fi 下用手机用 --host <电脑的局域网 IP> 启动，再在手机上打开终端打印的网址要填具体 IP；局域网是明文 HTTP，令牌会明文传输
手机扫码同屏安装 dsh-pocket 插件装之前看插件页的安全信号
反向代理或域名--public-url https://你的域名/ --trusted-host 你的域名不加 --trusted-host，所有接口都返回 403
SSH 隧道把本地 3080 端口转发到服务器，打开终端打印的网址不用改监听地址

dsh-pocket

1.9kGitHub stars

DSH Profile: web

电脑上跑 dsh web，手机扫码就能打开同一个界面，支持局域网和公网，实时同屏。

dsh plugin --profile web add dsh-pocket -w
看安全信号和兼容性

只把网址发给信任的人：网址里的令牌能直接登录，拿到的人可以让 Agent 在你的电脑上读写文件、运行命令。公网访问要用 HTTPS（反向代理或 --tls-cert / --tls-key），不要把 3080 端口直接暴露在公网。

06

DSH Web UI 增强插件

官方界面能对话、看文件、改设置，不少人还会装插件补上文件树、任务看板、插件市场。下面挑了常用的几款，星数实时读取。安装方法都一样，见插件安装指南。

DSH Web UI

8.8kGitHub stars

DSH Profile: web

Web UI 插件全家桶（npm 包 @linxin666/dsh-web-all）：任务看板、Git 视图、远程访问、Token 统计和皮肤中心。

dsh plugin --profile web add github:zhu1090093659/dsh-web
看安全信号和兼容性

dsh-market

8.6kGitHub stars

DSH Profile: web

在 DeepSeek Harness 里直接浏览、搜索、一键安装插件，不用敲命令。

dsh plugin --profile web add dshmarket
看安全信号和兼容性

DSH-taskboard

322GitHub stars

DSH Profile: web

本地任务看板，Agent 认领任务、回报进度，数据存在 SQLite。

dsh plugin --profile web add -w @shengsheng/dsh-taskboard
看安全信号和兼容性

dsh-web-ui 全家桶自带皮肤中心。用全家桶的，在它的皮肤中心里装皮肤，不要再单独安装同一款皮肤，两边适配不同，混装会让界面错乱。

07

更新、停止和设置保存在哪

操作方法
更新到最新版npx @deepseek-ai/dsh@latest web；全局安装的运行 npm i -g @deepseek-ai/dsh@latest
停止在运行它的终端按 Ctrl+C
外观设置~/.dsh/cordis.patch.yml（设置了 DSH_HOME 时在该目录下）
已装插件~/.dsh/profiles/web，每个 Profile 一个目录

DeepSeek Harness 还在开发者预览阶段，新版本会出现不兼容的改动。更新后某个插件出问题，先去它的插件页看有没有新版本。

常见问题

DSH Web UI、桌面版和 TUI 有什么区别？

+

Web UI 是 dsh web 在浏览器里打开的界面；桌面版是官方的桌面客户端，有自己的 desktop Profile，插件在应用的「插件」页里安装；TUI 是社区插件做的终端界面，比如 dsh-cc-tui。三者用的是同一个 DeepSeek Harness 内核。

3080 端口被占用怎么办？

+

用 --port 换一个端口，比如 npx @deepseek-ai/dsh web --port 3090。填 --port 0 会让系统自动挑一个空闲端口，以终端打印的地址为准。

DSH Web UI 能几个人一起用吗？

+

可以把带令牌的网址发给别人，但拿到的人都等于拿到了你这台电脑的完整权限，Agent 会以你的身份读写文件、运行命令。团队使用要放在反向代理后面，并限制能访问的网络。

DSH Web UI 能联网搜索吗？

+

Agent 联网搜索需要配置搜索提供方。不想申请 Key，可以装免费的搜索插件，比如 modsearch 或 dsh-free-search。

DSH Web UI 免费吗？

+

DeepSeek Harness 和 Web UI 都是 MIT 开源、免费使用；调用模型的费用由你填写的 API Key 对应的模型提供方收取。

一手资料

本文以 DeepSeek AI 官方 Harness 仓库与当前开发文档为主要依据；由于 Harness 仍处于 Developer Preview，具体命令与契约以后续官方版本为准。

DeepSeek Harness READMEWeb UI guidedsh CLI helpPublic deploymentsConnection (auth)

DSH Guides

继续阅读 DSH 指南

浏览 DeepSeek Harness 插件

DSH 插件安装指南

如何安装 DeepSeek Harness 插件

把 DSH Plugin 安装到正确的 Profile，理解 npm 与 GitHub 安装目标，检查最终插件树，并用明确的方式卸载和排查插件，而不是只看“安装成功”就默认已经生效。

阅读指南

DeepSeek Harness Skill 指南

DeepSeek Harness Skill 安装、目录与调用方法

DeepSeek Harness Skill 是写给 Agent 的操作说明：放进指定目录，Agent 会在合适的时候自己读，你也可以用 /名字 直接调用。下面讲清 Skill 和插件的区别、该放哪个目录、SKILL.md 怎么写、装了不显示怎么办。

阅读指南

DeepSeek Harness 皮肤指南

DeepSeek Harness 皮肤推荐与换肤教程

DeepSeek Harness 官方只带浅色、深色和跟随系统三种外观，想换鲸鱼娘、动态壁纸或毛玻璃，就要装社区做的皮肤插件。下面按风格整理热门皮肤，星数实时读取，并讲清网页版和桌面版怎么安装、怎么切换、出了问题怎么恢复。

阅读指南

DeepSeek Harness 插件推荐

DeepSeek Harness 插件推荐：必装插件和按用途精选

插件太多不知道装哪个？这份 DeepSeek Harness 插件推荐先给出 5 个必装插件，再按用途分组精选。每张卡片的星数和安装命令实时读取，挑选标准和我们不推荐的热门插件也写在下面。

阅读指南

DSH 插件开发指南

如何开发一个 DeepSeek Harness DSH Plugin

从最小 Cordis Plugin 模块开始，注册真正的模型能力，把插件打包成可安装的 DSH Bundle，验证完整加载链路，并按照当前 DeepSeek Harness 生态方式发布。

阅读指南

DeepSeek Harness 架构指南

DSH Plugin、Bundle 与 Profile 是什么关系？

理解 DeepSeek Harness 如何组合插件：Plugin 负责什么行为，Bundle 如何分发配置，Profile 启动什么组合，以及这些 Patch Layer 最终怎样构成真实运行的 Plugin Tree。

阅读指南