@wingsky-1/dsh-gzip
DSH Web GUI 的 /api 响应 gzip 压缩插件：为远程/低带宽链路开启 /api 响应压缩，解决大响应无压缩导致的会话历史加载超时失败
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @wingsky-1/dsh-gzip@0.1.9Gzip 以 @wingsky-1/dsh-gzip 发布，当前版本为 0.1.9。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
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/31/4。
前提：已安装 DeepSeek Harness 且 dsh web 可正常启动（未全局安装 dsh 见下方「未全局安装 dsh」）。
dsh plugin --profile web add @wingsky-1/dsh-gzip
dsh plugin --profile web remove @wingsky-1/dsh-gzip
dsh plugin --profile web update @wingsky-1/dsh-gzip
安装 / 卸载 / 更新后都需重启一次
dsh web（bundle 层只在启动时组合）生效。
registry 尚未同步到最新、或最新版在你的环境有问题时，可在包名后追加 @版本号：
dsh plugin --profile web add @wingsky-1/dsh-gzip@0.1.8
若本机没有全局 dsh 命令，用 npx 临时拉起（底层调用 pnpm，仍需本机装好 pnpm 与 Node.js）：
npx @deepseek-ai/dsh plugin --profile web add @wingsky-1/dsh-gzip
npx @deepseek-ai/dsh plugin --profile web remove @wingsky-1/dsh-gzip
npx @deepseek-ai/dsh plugin --profile web update @wingsky-1/dsh-gzip
# 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。/api、/plugins 及未来第三方
prefix）——直接替换 webServer.prefixes 中对应 route.handler（运行时替换
立即生效）；webServer.exact，DshRoute.kind:"exact"）——与
prefix 一致地套用 gzip 包装，解决插件常用 exact 路由（history 大 JSON、
各插件 health、web-file-preview 文件预览等）不被压缩的问题；webServer.fallback）——覆盖 /assets/* 静态资源、
/ 与 SPA fallback 的 index.html；register / registerFallback patch 仅作兜底，覆盖本插件先装配或后续重新
注册的情形。level（1..9）可调，非法值自动归一。text/event-stream）、zip 导出、HEAD 请求（无
body）、带 Range 的请求（保留范围语义）、未协商 gzip、已自带
content-encoding、不可压缩 content-type（application/octet-stream、
image/* 等）——一律不压缩、原样透传。核心保险是 content-type 白名单判断，
与路由 is exact 还是 prefix 无关。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 不注册。
MIT。压缩包装逻辑借鉴上游 040822/dsh-gzip（MIT）。