dsh web 的进程与数据流:浏览器、服务进程、profile 与 DSH_HOME 各管什么
dsh web 由四层组成:浏览器标签、服务进程、profile 依赖树、DSH_HOME 数据目录。 排错时先判断问题落在哪一层,比反复刷新页面有效得多。
dsh web 四层职责与一次请求的路径
四层职责不重叠,故障表现也不同。 对照如下:
| 层 | 负责 | 典型故障 |
|---|---|---|
| 浏览器 | 渲染页面、保存标签状态 | 缓存导致白屏、旧令牌 |
| 服务进程 | 提供页面与接口、调用模型 | 端口占用、进程退出 |
| profile | 决定加载哪些插件与依赖 | 插件缺失、版本冲突 |
| DSH_HOME | 保存配置、会话、凭据 | 会话看不到、配置不生效 |
四层里只有浏览器在客户端,其余三层都在本机。 所以「换台电脑打不开」和「同一台电脑换浏览器打不开」是两类完全不同的问题。
看完分工,再看一次请求在这四层之间怎么走。
理解路径,才能知道在哪一层看日志。 顺序固定:
- 浏览器把请求发到
127.0.0.1:3080,带上令牌; - 服务进程校验令牌,读取当前 profile;
- 服务根据 profile 加载插件与工具;
- 需要模型时,按配置调用提供方;
- 结果写入 DSH_HOME 下的会话目录;
- 服务把结果返回浏览器渲染。
第 2 步失败表现为认证提示,第 3 步失败表现为功能缺失,第 4 步失败表现为转圈。 三种表现对应三层,别混着查。
dsh web 错位一:端口通、页面空白
端口通只能证明服务在监听,不证明页面能渲染。 常见原因:
- 打开的是根地址而不是带令牌的 URL;
- 浏览器缓存了旧的失败状态;
- 服务刚启动,前端资源还没准备好;
- 端口被别的程序占用,返回的不是 DSH 页面。
判断方法:换无痕窗口再开一次。 无痕能开说明是缓存或旧令牌;无痕也开不了,再看服务日志。
还有两类容易被忽略的原因:
- 服务绑定的地址与浏览器访问的地址不一致,请求根本没到这个进程;
- 浏览器扩展拦截了本地请求,表现为请求发了但没有响应。
这两类都不需要重装。 前者改访问地址,后者换浏览器或禁用扩展验证。
dsh web 错位二:页面能开,插件不在
插件是否出现,由 profile 决定,不由浏览器决定。 三种情况:
- 插件装进了
web之外的 profile; - 装完没有重启,进程仍加载旧依赖;
- 插件加载失败,列表被跳过但页面正常。
判断顺序:先看已安装列表,再看启动日志的加载阶段。 列表有、日志正常、界面没有,通常是没重启;列表没有,则是装错了 profile(来源)。
dsh web 错位三:一端有会话,另一端看不到
会话归属由 DSH_HOME 决定,不由入口决定。 三种情况:
- 两个入口指向不同的 DSH_HOME;
- 一台是本机,一台是远程服务;
- 数据目录被清理或迁移过。
判断方法:先确认两端的 DSH_HOME 是否相同。 相同还看不到,才查会话索引与文件是否完整。
dsh web 定位顺序与这套结构的价值
按固定顺序查,避免来回跳。 四步:
- 浏览器层:换无痕窗口、换浏览器,排除缓存与扩展;
- 进程层:
lsof -i :3080看端口,终端看进程是否还在; - profile 层:确认当前 profile、插件列表与启动日志;
- 数据层:确认 DSH_HOME 指向、会话目录与文件权限。
四步的前两步只需一分钟,却能排掉一半问题。 直接从数据层开始查,通常会越查越乱。
走完四步,这套结构在日常使用里还有两个用处。
因为它能回答「该看哪份日志」。 浏览器问题看控制台,进程问题看终端输出,插件问题看启动日志,数据问题看目录与文件。
也能回答「换入口会不会丢东西」。 换入口只换第一层,profile 与数据仍在原处;换机器则要连同 DSH_HOME 一起迁移。
dsh web 下一步
先分层,再看具体配置。 想看三个入口怎么分工,读 三种入口怎么选;想看网页与终端会话是否互通,读 dsh web 与终端会话;想看插件装在哪个目录,读 插件安装位置;想先跑通首次使用,读 dsh web 第一次打开的五分钟。
常见问题
页面能打开但插件为空,问题通常出在 profile 层,而不是浏览器。当前 profile 没装插件、插件装在别的 profile、或启动时没加载对应 profile,都会出现列表为空但页面正常。
换浏览器后 dsh web 会话不见,通常是因为打开的不是同一份数据或同一个实例。会话存在 DSH_HOME 下,浏览器只是入口;地址不同、端口不同或数据目录不同,都会看到不同的会话列表。
浏览器标签关掉不影响服务,dsh web 的进程在终端里独立运行。确认方法是看终端是否仍在输出,或用 lsof -i :3080 查看端口是否仍被监听;要停服务应在终端按 Ctrl+C。
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 官方文档
来源
- dsh CLI README· deepseek-ai
- DeepSeek Harness 官方文档· deepseek-harness
- deepseek-harness 仓库· deepseek-ai