dsh web 的浏览器兼容与体验优化：DeepSeek Harness 网页端的常见拦截

DeepSeek Harness 的 dsh web 对浏览器有三条隐含要求：现代 JavaScript、WebSocket 长连接、本地存储。 不满足时不会提示「浏览器不支持」，而是表现为页面能开但用不了，所以排查顺序固定为：换现代浏览器 → 无痕窗口排除扩展 → 检查代理是否透传连接升级。企业策略封死浏览器时，桌面端与 CLI 是现成替代。

DeepSeek Harness dsh web 的三条隐含要求与三种替代方案

一句话结论：能渲染页面 ≠ 能用；真正决定可用性的是长连接与本地存储，而这两项恰恰最容易被环境拦掉。

1. 现代 JavaScript 能力：新语法与 API 不被旧内核支持时，脚本会直接报错，页面可能只渲染出一半。
2. WebSocket 长连接：dsh web 的实时数据靠它推送；被拦时表现为「界面在但数据不刷新」。
3. 本地存储：前端需要保存一些本地状态（会话偏好、界面设置一类）；隐私模式或严格存储策略下可能失效。
4. 判据速记：能显示但不响应 → 先想长连接与扩展；整页空白 → 先想脚本与新语法支持。

方案 A：换现代浏览器（最省事）

一句话结论：先在同机器上用另一个现代浏览器打开一次——这一分钟的动作能立刻把「浏览器问题」与「服务问题」分开。

1. 用另一个现代浏览器打开同一地址（Chrome / Edge / Firefox / Safari 任一较新版本）。
2. 能正常工作 → 问题在原浏览器：继续按第 4 节排扩展与策略。
3. 两个浏览器都不行 → 问题不在浏览器，转向服务端与网络（见 局域网访问 dsh web 的三步排查）。
4. 顺手确认长连接是否建立：浏览器开发者工具的连接面板里应能看到长连接已建立；看不到就是被拦了。

方案 B：在受限浏览器里做减法（企业策略场景）

一句话结论：策略锁死时，能做的只有三件事——用无痕排除扩展、关掉可能拦截的扩展、避开会触发限制的访问方式（如 http 明文）。

1. 无痕 / 隐私窗口验证：无痕模式默认不加载扩展，能一次排除扩展因素；能正常用就回到正常窗口逐个关扩展定位。
2. 关掉隐私类与脚本管理类扩展：广告拦截、脚本拦截、部分安全插件都会拦长连接，对本站点放行即可。
3. 避免混合内容：用 http 访问而页面内又试图建立安全连接时会被拦；统一用 https（见 给 dsh web 配反向代理与 HTTPS）。
4. 策略层面无解的证书问题：企业网关做 TLS 拦截时，需要让设备信任企业根证书，用户侧改不了策略本身。

方案 C：换成桌面端或 CLI（兜底）

一句话结论：浏览器这条路走不通时别硬扛——DeepSeek Harness 本身不只是网页端，桌面端与 CLI 是能力上更完整的替代。

1. 桌面端：官方桌面应用不受浏览器策略约束，图形体验最接近网页端。
2. CLI：dsh 本体就是命令行工具，网页端只是其中一种入口；在受限环境里直接命令行使用往往最省事。
3. 远程访问替代：在另一台不受限的设备上跑服务、当前设备只当显示端。
4. 取舍：三条替代的插件能力与网页端不完全等价，用之前先在 DSH Plugin Hub 核对你要用的插件在目标入口是否可用。

DSH plugin 网页端被拦的四种常见情形与处置

一句话结论：扩展、策略、混合内容、旧内核——四类各自有独立判据，别混在一起试。

DeepSeek Harness 网页端体验优化三件事

一句话结论：优化目标只有一个——把「累积量」压小；长会话、多标签、高缩放在低配设备上会互相放大。

1. 长会话滚动慢：内容量是主因（代码块、表格、公式越多越吃力）。优化路径是拆会话、定期新开、必要时压缩上下文；换浏览器只能缓解。
2. 多标签占用高：每个标签是一份独立前端实例，资源占用近似线性增长。只留在用标签，用站内会话切换代替多开。
3. 分辨率与缩放：低分辨率 + 高缩放会让重排更频繁；把浏览器缩放调到 100% 通常在低配设备上更顺。
4. 顺手看占用：浏览器自带的任务管理器能直接看到该标签的 CPU 与内存，先确认瓶颈是什么再谈优化。

DSH plugin 排查注意事项

一句话结论：浏览器类问题先做「换浏览器 + 无痕」两步排除，两步之后还异常才进服务端——顺序错了会白折腾。

1. 换浏览器 / 无痕两步是成本最低的排除法，几乎一分钟出结论。
2. 开发者工具的两个面板（控制台 + 网络/连接）能给出定性判据：脚本报错 vs 连接失败。
3. 代理在场时别漏它：反代没透传连接升级同样会表现为长连接失败（见反代一文的三大硬要求）。
4. 企业环境优先换入口，不要在策略层面反复试。
5. 插件功能与页面能力分开看：页面正常但插件不可用，属于插件侧问题（权限/依赖/沙箱），不是浏览器问题。
6. 修复状态如实：本文三条隐含要求由 dsh web 的前端实现方式推导（长连接与本地状态是现代 Web 应用的通用依赖），未逐版本核对具体兼容清单；dsh web 的适配范围以官方仓库说明与你自己环境的表现实测为准。

排查到「页面能开但功能不可用」时，可以用 DSH Plugin Hub 页面做一次交叉验证：它能正常打开就说明是浏览器侧问题，打不开则回到服务端与网络。

来源：apps/cli/README.md、apps/desktop/README.zh.md、MDN · WebSocket API。