dsh-web-network-optimizer（Web 网络优化器）

中文 | English

⚠️ 已废弃（DEPRECATED）——请勿在 dsh ≥ 0.1.2 上安装

DeepSeek Harness 更新到最新版（0.1.2-rc.1，2026-09 起为 npm latest）后，官方已完整内置本插件的全部功能，本插件不再需要、停止维护：

• 响应压缩 —— @deepseek-ai/dsh-host-webserver 内置 gzip（profile 配置 compression: gzip，压缩级别/阈值可调），本地与远程访问一视同仁；
• 浏览器缓存 —— 插件 client bundle 不再按文件 URL 下发，全部改走 @deepseek-ai/dsh-client-modules 的内容寻址 combo（/plugins/??…&rev=<内容sha1>）并下发 Cache-Control: immutable：URL 即内容哈希、更新必然换 rev、rev 不匹配即拒绝加载——缓存永远新鲜，不存在"缓存没跟上更新"的死角；
• 断线自动重连 —— 官方 ConnectionController 自带指数退避自动重连与离线感知（navigator.onLine），恢复后数据自动重同步。

本插件基于的是上述功能出现之前的旧版架构（逐条包装 webServer 路由表 + 按文件 URL 分发 client bundle），在新架构下既失去作用对象、又与之冲突——主实例升级到 0.1.2-rc.1 后即因安装本插件而启动异常，随后被禁用摘除。本插件只在 dsh 0.1.x（≤ 0.1.1-rc.2）上有意义；package.json 已用 peerDependencies 把允许的 dsh 版本限定为 @deepseek-ai/dsh >=0.1.0-rc.2 <=0.1.1-rc.2，包管理器会据此提示不兼容。

已升级到 dsh ≥ 0.1.2 的用户请卸载：dsh plugin --profile <name> remove dsh-web-network-optimizer。

dsh网页端网络优化：通过缓存与压缩技术降低传输，从而大幅提升网页加载速度；同时提供网络断连指示与自动断网重连功能。非常适合追求极致性能或网络不稳定用户使用。

Network optimization for the DSH web UI: reduces transfer size with caching and compression to greatly speed up page loading, plus a connection-drop indicator and automatic reconnection. Ideal for users pursuing peak performance or using unstable networks.

1. 连接守护——手机切后台后运营商静默断网导致"界面永久卡死"：自动检测、1 秒内自动恢复，连接状态以会话标题左侧的小圆点常显（绿=正常 / 灰=检查中 / 红脉冲=异常），点圆点可手动强制重连；
2. 响应压缩——所有可压缩响应下发 brotli、gzip 兜底，本地回环与远程访问行为一致；
3. 浏览器缓存——/assets/* 与 favicon 文件名即内容哈希，更新必然换 URL，下发 Cache-Control: immutable，二次访问近乎零传输；插件 client.js（rev= URL）保留 no-cache 并由本插件补发 ETag——每次加载只做条件再验证，内容未变服务器答 304（仅响应头几十字节），变了自动换新，近乎零流量且永远新鲜；
4. 分插件流量账本——设置 → Web 网络优化器 面板，实时看到每个插件本次加载与累计占用多少流量、压缩省了多少、缓存命中情况；
5. 缓存自检——怀疑浏览器缓存没跟上更新时，面板提供 DevTools 手动清缓存的三选一指引，一键复制菜单操作。

实测效果

完整加载 GUI（87 个静态请求）：首屏静态流量 8.1 MB → 1.54 MB（−81%），缓存命中后二次访问静态零传输；最大 API /api/session.list 2.18 MB → 144 KB（−93%）。

连接守护

手机切到后台后，运营商往往静默切断 TCP 连接。浏览器被冻结、感知不到断开，WebSocket 状态停在 OPEN，连接控制器认为连接健康。回到前台：界面看起来还"活着"，但实时数据全部断流——分不清"它没在动"还是"我网络断了"。

本插件在页面回前台时（以及每 30 秒心跳）主动探测连接的真实状态；发现旧连接已死、而网络与服务端都活着时，由服务端销毁旧连接、控制器走既有重连逻辑。恢复过程完整保留页面内存状态——草稿、滚动位置、输入内容原样保留，卡住的界面"自己活了"。

你看到什么

会话标题左侧常显一枚小圆点——颜色即状态，悬停展开文字：

圆点	含义
🟢 绿	连接正常
⚪ 灰	检查中 / 重连中
🔴 红（脉冲）	离线 / 异常 / 正在恢复
🟢 绿（"已恢复 ✓"）	重连完成，5 秒后回到常亮

点击圆点 = 手动强制重连——任何时候怀疑它卡了，点一下就有确定的结果。

安装

dsh plugin --profile web add dsh-web-network-optimizer@latest

卸载：

dsh plugin --profile web remove dsh-web-network-optimizer

卸载时路由包装完整还原；账本文件保留在 ~/.dsh/storages/dsh-web-network-optimizer/ 供回看，孤儿缓存由浏览器配额自动回收。

缓存语义：/assets 与 favicon 靠内容哈希文件名——更新时内容变化 → 新文件名 → 新 URL，旧缓存自然失效，故可放心 immutable；插件 client.js 用 no-cache + ETag——每次加载带条件请求，未变答 304、变了答新内容，不依赖 URL 变化，杜绝"缓存没跟上"的死角（immutable 意味着浏览器永不发请求，任何服务端手段都追不上文件变化，故只用于文件名自带哈希的资源）。

缓存自检：极端场景（浏览器异常缓存、代理改写等）仍可能让旧内容残留。浏览器没有开放清除 HTTP 缓存的 JS 指令，面板「缓存自检」给出 DevTools 菜单操作的三选一指引（右键重载按钮「清空缓存并硬性重新加载」/ Network 面板「禁用缓存」/ Application 面板「清除站点数据」），一键复制、手动执行一次即可。

开发

npm run build          # 校验并产出 lib/index.js
npm run build:client   # 校验并产出 lib/client.js
dsh plugin --profile web add /path/to/dsh-web-network-optimizer   # 本地目录安装（开发用）

License

MIT