ChatGPTClaudeGrok / X / CursorGemini

dsh web 的进程与数据流:浏览器、服务进程、profile 与 DSH_HOME 各管什么

概念与架构发布于 2026-11-02作者: DeepSeek Plugin 插件市场
dsh web架构profileDSH_HOME排查
dsh web 出问题时,先要判断问题在浏览器、服务进程、profile 还是数据目录。本文用四层结构讲清一次请求怎么走,以及三类常见错位怎么快速定位。

dsh web 由四层组成:浏览器标签、服务进程、profile 依赖树、DSH_HOME 数据目录。 排错时先判断问题落在哪一层,比反复刷新页面有效得多。

dsh web 四层职责与一次请求的路径

四层职责不重叠,故障表现也不同。 对照如下:

层负责典型故障
浏览器渲染页面、保存标签状态缓存导致白屏、旧令牌
服务进程提供页面与接口、调用模型端口占用、进程退出
profile决定加载哪些插件与依赖插件缺失、版本冲突
DSH_HOME保存配置、会话、凭据会话看不到、配置不生效

四层里只有浏览器在客户端,其余三层都在本机。 所以「换台电脑打不开」和「同一台电脑换浏览器打不开」是两类完全不同的问题。

看完分工,再看一次请求在这四层之间怎么走。

理解路径,才能知道在哪一层看日志。 顺序固定:

  1. 浏览器把请求发到 127.0.0.1:3080,带上令牌;
  2. 服务进程校验令牌,读取当前 profile;
  3. 服务根据 profile 加载插件与工具;
  4. 需要模型时,按配置调用提供方;
  5. 结果写入 DSH_HOME 下的会话目录;
  6. 服务把结果返回浏览器渲染。

第 2 步失败表现为认证提示,第 3 步失败表现为功能缺失,第 4 步失败表现为转圈。 三种表现对应三层,别混着查。

dsh web 错位一:端口通、页面空白

端口通只能证明服务在监听,不证明页面能渲染。 常见原因:

  1. 打开的是根地址而不是带令牌的 URL;
  2. 浏览器缓存了旧的失败状态;
  3. 服务刚启动,前端资源还没准备好;
  4. 端口被别的程序占用,返回的不是 DSH 页面。

判断方法:换无痕窗口再开一次。 无痕能开说明是缓存或旧令牌;无痕也开不了,再看服务日志。

还有两类容易被忽略的原因:

  1. 服务绑定的地址与浏览器访问的地址不一致,请求根本没到这个进程;
  2. 浏览器扩展拦截了本地请求,表现为请求发了但没有响应。

这两类都不需要重装。 前者改访问地址,后者换浏览器或禁用扩展验证。

dsh web 错位二:页面能开,插件不在

插件是否出现,由 profile 决定,不由浏览器决定。 三种情况:

  1. 插件装进了 web 之外的 profile;
  2. 装完没有重启,进程仍加载旧依赖;
  3. 插件加载失败,列表被跳过但页面正常。

判断顺序:先看已安装列表,再看启动日志的加载阶段。 列表有、日志正常、界面没有,通常是没重启;列表没有,则是装错了 profile(来源)。

dsh web 错位三:一端有会话,另一端看不到

会话归属由 DSH_HOME 决定,不由入口决定。 三种情况:

  1. 两个入口指向不同的 DSH_HOME;
  2. 一台是本机,一台是远程服务;
  3. 数据目录被清理或迁移过。

判断方法:先确认两端的 DSH_HOME 是否相同。 相同还看不到,才查会话索引与文件是否完整。

dsh web 定位顺序与这套结构的价值

按固定顺序查,避免来回跳。 四步:

  1. 浏览器层:换无痕窗口、换浏览器,排除缓存与扩展;
  2. 进程层:lsof -i :3080 看端口,终端看进程是否还在;
  3. profile 层:确认当前 profile、插件列表与启动日志;
  4. 数据层:确认 DSH_HOME 指向、会话目录与文件权限。

四步的前两步只需一分钟,却能排掉一半问题。 直接从数据层开始查,通常会越查越乱。

走完四步,这套结构在日常使用里还有两个用处。

因为它能回答「该看哪份日志」。 浏览器问题看控制台,进程问题看终端输出,插件问题看启动日志,数据问题看目录与文件。

也能回答「换入口会不会丢东西」。 换入口只换第一层,profile 与数据仍在原处;换机器则要连同 DSH_HOME 一起迁移。

dsh web 下一步

先分层,再看具体配置。 想看三个入口怎么分工,读 三种入口怎么选;想看网页与终端会话是否互通,读 dsh web 与终端会话;想看插件装在哪个目录,读 插件安装位置;想先跑通首次使用,读 dsh web 第一次打开的五分钟。

来源:dsh CLI README、DeepSeek Harness 官方文档、deepseek-harness 仓库

ChatGPTClaudeGrok / X / CursorGemini

常见问题

dsh web 页面能打开但插件列表是空的,问题出在哪一层?

页面能打开但插件为空,问题通常出在 profile 层,而不是浏览器。当前 profile 没装插件、插件装在别的 profile、或启动时没加载对应 profile,都会出现列表为空但页面正常。

为什么同一个 dsh web 地址,换个浏览器登录后会话就不见了?

换浏览器后 dsh web 会话不见,通常是因为打开的不是同一份数据或同一个实例。会话存在 DSH_HOME 下,浏览器只是入口;地址不同、端口不同或数据目录不同,都会看到不同的会话列表。

dsh web 的浏览器标签关掉后本地服务还在跑吗,应该怎么确认?

浏览器标签关掉不影响服务,dsh web 的进程在终端里独立运行。确认方法是看终端是否仍在输出,或用 lsof -i :3080 查看端口是否仍被监听;要停服务应在终端按 Ctrl+C。

dsh web 端口能通、页面也能开,但发消息一直没有反应,该查哪一层?

dsh web 端口与页面正常但发消息无反应,问题在服务到模型这一段,而不是浏览器层。先看服务日志有没有请求记录,再看模型提供方与 Key 配置,最后确认网络能否到达模型端点。

相关术语

dsh web
dsh web 是 DeepSeek Harness 的浏览器入口,由本地服务进程提供页面与接口,默认监听 127.0.0.1:3080。— dsh CLI README
服务进程
服务进程是执行 dsh web 命令后常驻的本地进程,负责提供页面、处理请求并调用模型与工具。— DeepSeek Harness 官方文档
profile
profile 是 DeepSeek Harness 的具名组装环境,决定加载哪些插件与依赖,不同 profile 的能力不同。— dsh CLI README
DSH_HOME
DSH_HOME 是数据根目录,保存配置、会话、插件与凭据,多个入口共用同一份数据。— DeepSeek Harness 官方文档

来源