安装

在 DeepSeek Harness 里通过 dsh-market 安装

dsh plugin --profile web add dshmarket

或使用命令行

dsh plugin --profile web add @wingsky-1/dsh-gzip

装任何插件都等于在你的机器上跑第三方代码，权限和你本人一样大——能读你的文件、用你的凭据、访问网络。请先审阅源码，并尽量锁定 commit（github:owner/repo#sha）。

README

DSH Web GUI 的响应 gzip 压缩插件：为远程 / 低带宽链路开启 /api 响应、静态资源（/assets/* 与 index.html）以及插件客户端 bundle（/plugins/<pkg>/client.js）的 gzip 压缩，解决「历史加载失败：The user aborted a request.（internal）」的问题并显著减小前端资源传输体积。

为什么需要

DSH Web GUI 加载会话历史时，一页历史可能包含全部流式 chunk 事件，响应体可达 4~13MB 且服务端默认不压缩；浏览器侧 RPC 又有 30s 硬超时。在低带宽链路（easytier / ZeroTier / Tailscale / 移动网络）上会直接超时失败。

本插件在服务端对可压缩的响应做 gzip 压缩：同一页历史压缩后约 1.2MB，实测加载时间由约 36s 降到约 3s（隔离环境）；前端主 bundle（~~744KB）与各插件 client.js 压缩后约为原体积 1/3~~1/4。

安装

# 默认安装 npm 的 latest（当前最新发布版，无需指定版本号）
dsh plugin --profile web add @wingsky-1/dsh-gzip

安装后重启一次 dsh web。

验证

# 1. 健康检查（回环）
curl -s http://127.0.0.1:3080/api/dsh-gzip/health
# → {"ok":true,"plugin":"dsh-gzip","mounted":"replace","handlers":{"api":"replace","plugins":"replace","fallback":"replace"},...}

# 2. 响应头带 content-encoding: gzip
curl -s -D - -o /dev/null -X POST http://127.0.0.1:3080/api/session.list \
  -H "Content-Type: application/json" -H "Accept-Encoding: gzip" \
  -d '{"type":"client-request","rpcId":"test","method":"session.list","payload":{}}' \
  | grep -i content-encoding

mounted 反映 /api 的实际接管方式（replace / register-patch）； handlers 分别报告 api / plugins / fallback 三个接管面的状态，见下方「工作原理」。

工作原理

压缩条件：请求 Accept-Encoding 协商 gzip（q=0 视为拒绝）且响应 content-type 可压缩（JSON / JSON 系 / text）且未自带 content-encoding。
接管范围（多分支、无时序依赖）：
- 已注册的 prefix 命名路由全量接管（含 /api、/plugins 及未来第三方 prefix）——直接替换 webServer.prefixes 中对应 route.handler（运行时替换立即生效）；
- exact 路由同样接管（webServer.exact，DshRoute.kind:"exact"）——与 prefix 一致地套用 gzip 包装，解决插件常用 exact 路由（history 大 JSON、各插件 health、web-file-preview 文件预览等）不被压缩的问题；
- fallback 席位接管（webServer.fallback）——覆盖 /assets/* 静态资源、 / 与 SPA fallback 的 index.html；
- register / registerFallback patch 仅作兜底，覆盖本插件先装配或后续重新注册的情形。
压缩级别可配置：默认 level 1（静态文本场景 3~~6ms/文件，压缩率约 −66~~−77%）；配置 level（1..9）可调，非法值自动归一。
实例级遮蔽：writeHead / write / end 仅在本请求的 ServerResponse 实例上替换，不动任何 prototype，请求结束自然释放；gzip 背压与 res 的 drain 事件桥接。

安全模型

豁免原样透传：SSE（text/event-stream）、zip 导出、HEAD 请求（无 body）、带 Range 的请求（保留范围语义）、未协商 gzip、已自带 content-encoding、不可压缩 content-type（application/octet-stream、 image/* 等）——一律不压缩、原样透传。核心保险是 content-type 白名单判断，与路由 is exact 还是 prefix 无关。
只作用于响应体：不做任何缓存语义（不补 Cache-Control / ETag）；健康检查路由 loopback 围栏（非回环 403 / 方法错 405），仅回环可访问。
无全局副作用：卸载恢复被替换的 prefix / exact handler、fallback 与 register / registerFallback（replace 场景身份级恢复）；wrap 幂等（HMR 重载后二次 apply 不重复包裹）；enabled: false 时不注册任何东西。
依赖非公开字段：主挂点读取 webServer.prefixes、webServer.exact 与 webServer.fallback （实例公开字段但非官方 API），registerFallback 亦非官方方法（判存在性后 patch）。上游改结构时自动退化到备用挂点，若时序不利则表现为「不压缩、不报错」——安全降级，可用 health 路由诊断 handlers 状态。

定位

过渡方案：根治在上游（历史响应瘦身 / 官方压缩 / 超时策略），上游修复后本插件自然退场；即使失效也只是「不压缩」，不会破坏任何功能。

开发

# 源码在 src/*.ts，改后必须 build（dsh 直接 import lib 产物）
pnpm --filter @wingsky-1/dsh-gzip build
node test/smoke.ts

冒烟测试覆盖：q 值解析、SSE / 已编码 / HEAD / Range 豁免、真实 zlib 压缩解压一致、level 归一与生效、prefix 全量接管（/api、/plugins）、fallback 接管与 registerFallback 兜底、非 /api 路由不受影响、卸载恢复、health 路由（GET 200 / POST 405 / 非回环 403 且含 handlers）、enabled: false 不注册。