@gehennawu/dsh-service 0.28.0 → 0.30.0

package/README.en.md

@@ -10,7 +10,7 @@ A service-control and operations plugin for self-hosted DSH Web. Provides safe r
 
 The Settings panel "Service Control" page has nine top-level tabs: **Overview, Notifications, Health, Model stats, Quota lookup, Backups, Skills, Subagents, Restart**; the Restart, Quota lookup, Skills, and Subagents tabs can each enable a quick entry at the bottom of the settings left navigation (off by default).
 
-The plugin also appears under **Plugins → Plugin configuration**, with eight host-level switches enabled by default: **Health diagnostics, Model statistics, Quota lookup, Backup maintenance, Task notifications, Skill manager, Subagent model, and the `/healthz` liveness endpoint**. Disabling one hides its UI, stops the associated polling/subscriptions, and makes the Host reject that capability; Overview and Restart remain available. All eight switches are live settings: disabling or re-enabling them requires neither a page reload nor a DSH Web restart. Statistics refreshes, quota requests, or backup operations already in flight are allowed to finish; quota re-enablement preserves existing cache, TTL, and backoff state, so its UI and calls return immediately but a new upstream request is not guaranteed at once.
+The plugin also appears under **Plugins → Plugin configuration**, with nine host-level switches enabled by default: **Health diagnostics, Model statistics, Quota lookup, Backup maintenance, Task notifications, Skill manager, Subagent model, Mobile adaptation, and the `/healthz` liveness endpoint**. Disabling one hides its UI, stops the associated polling/subscriptions, and makes the Host reject that capability; Overview and Restart remain available. All nine switches are live settings: disabling or re-enabling them requires neither a page reload nor a DSH Web restart. Statistics refreshes, quota requests, or backup operations already in flight are allowed to finish; quota re-enablement preserves existing cache, TTL, and backoff state, so its UI and calls return immediately but a new upstream request is not guaranteed at once.
 
 ### Version and updates
 
@@ -97,6 +97,16 @@ The plugin also appears under **Plugins → Plugin configuration**, with eight h
 - Bell icon in the conversation input bar toggles the master switch quickly
 - All toggles persist across page reloads
 
+### Mobile adaptation
+
+- On by default; active only on phones or narrow windows (viewport <1024px, matching the official shell's sidebar collapse breakpoint). Desktop widths are completely unaffected
+- Sidebar becomes a drawer: the official sidebar slides into a left overlay drawer — a translucent floating button on the left edge toggles it, and tapping the backdrop or any session row closes it automatically. The preview/file-tree details column becomes a right overlay instead of squeezing the conversation area. Open/close goes through DSH's official `layout` service; no host DOM reparenting
+- Modals become bottom sheets: settings dialogs turn into bottom sheets (rounded top corners, internal scrolling), and the settings left navigation becomes a horizontally scrollable top strip
+- Touch details: adds `viewport-fit=cover` automatically and respects notch safe areas; double-tap no longer zooms the page; text inputs stay ≥16px so iOS no longer auto-zooms on focus
+- Transparent large-JSON compression: the host compresses JSON responses ≥4KB with gzip/brotli chosen from the browser's `Accept-Encoding` (long session histories can reach tens of MB — compression noticeably speeds up first paint). Small payloads and other content types pass through byte-identical; SSE streams are untouched
+- The "Mobile adaptation" switch in "Plugins → Plugin configuration" turns everything off: the host compression patch is restored and all UI enhancements unmount, returning to the native layout immediately without a restart
+- Debug mode: append `?dshsvc-mobile-debug=1` to the URL to show a floating diagnostics chip (viewport size / breakpoint state / drawer & details state / JS error count). For debugging only
+
 ### External liveness probe
 
 - `GET` / `HEAD /healthz` returns empty HTTP 200; other methods return 405

package/README.md

@@ -10,7 +10,7 @@
 
 设置页「服务控制」面板包含九个顶部标签：**概览、通知、健康诊断、模型统计、额度查询、备份维护、技能、子代理、重启**；重启、额度查询、技能与子代理标签还可在设置页左侧标签列底部开启快捷入口（默认关闭）。
 
-插件同时出现在「插件 → 插件配置」，提供八个默认开启的宿主级开关：**健康诊断、模型统计、额度查询、备份维护、任务通知、技能管理、子代理模型、`/healthz` 探活端点**。关闭后不仅隐藏对应界面，也会停止相关轮询/订阅并由宿主拒绝对应能力；概览与重启固定保留。设置写入 DSH settings，八项均为热生效：关闭或重新开启都无需刷新页面或重启 DSH Web。已在途的统计刷新、额度请求或备份操作允许完成；额度重新开启时保留既有缓存、TTL 与退避状态，因此可立即恢复界面和调用，但不保证立刻重新请求上游。
+插件同时出现在「插件 → 插件配置」，提供九个默认开启的宿主级开关：**健康诊断、模型统计、额度查询、备份维护、任务通知、技能管理、子代理模型、移动端适配、`/healthz` 探活端点**。关闭后不仅隐藏对应界面，也会停止相关轮询/订阅并由宿主拒绝对应能力；概览与重启固定保留。设置写入 DSH settings，九项均为热生效：关闭或重新开启都无需刷新页面或重启 DSH Web。已在途的统计刷新、额度请求或备份操作允许完成；额度重新开启时保留既有缓存、TTL 与退避状态，因此可立即恢复界面和调用，但不保证立刻重新请求上游。
 
 ### 版本与更新
 
@@ -97,6 +97,16 @@
 - 对话栏内铃铛图标快速切换总开关
 - 各开关在页面刷新后保持
 
+### 移动端适配
+
+- 默认开启，仅在手机竖屏或窄窗口（视口 <1024px，与官方外壳的侧栏折叠断点一致）下生效，桌面宽度完全无感
+- 侧栏变抽屉：官方侧栏整体收进左侧 overlay 抽屉——左缘半透明悬浮按钮开合、点背板或点选任意会话后自动收起；预览/文件树详情列变右侧浮层，不再挤压会话区。开合走 DSH 官方 `layout` 服务，不重挂宿主 DOM
+- 模态弹窗底部化：设置等对话框变为底部 sheet（上圆角、内部滚动），设置页左列导航变为顶部横向滑动条
+- 触屏细节：自动补 `viewport-fit=cover` 并避让刘海安全区；按钮双击不再触发页面缩放；文本输入框保持 ≥16px，iOS 聚焦时不再自动放大
+- 大 JSON 响应透明压缩：宿主对 ≥4KB 的 JSON 响应按浏览器 `Accept-Encoding` 自动 gzip/brotli 异步压缩（长会话历史可达十几 MB，压缩后首屏明显提速），小体积与其他类型字节级透传，SSE 流不受影响
+- 「插件 → 插件配置」的「移动端适配」开关可整体关闭：关闭后宿主压缩补丁还原、界面增强全部卸载，立即回到原生布局，热生效无需重启
+- 调试模式：URL 追加 `?dshsvc-mobile-debug=1` 显示浮动诊断条（视口尺寸 / 断点状态 / 抽屉与详情列状态 / JS 错误计数），仅调试用途
+
 ### 外部探活
 
 - `GET` / `HEAD /healthz` 返回空的 HTTP 200，其他方法返回 405

package/client.js

@@ -26,6 +26,15 @@ window.__ModuleLoader__.load({
       'tabs.skills': '技能',
       'tabs.subagent': '子代理',
       'features.subagentRoute': '子代理模型',
+      'features.mobileAdaptation': '移动端适配',
+      'mobile.fab.label': '打开侧栏菜单',
+      'mobile.debug.title': '移动端诊断',
+      'mobile.debug.viewport': '视口',
+      'mobile.debug.drawer': '抽屉',
+      'mobile.debug.details': '预览列',
+      'mobile.debug.errors': 'JS 错误',
+      'mobile.debug.stateOn': '开',
+      'mobile.debug.stateOff': '关',
       'subagent.title': '子代理模型',
       'subagent.hint': '控制「未显式指定模型」的子代理委派使用哪个模型；显式指定了模型的派生（预设钉死、其他插件注入、调用参数携带）不受影响。',
       'subagent.mode.label': '模式',
@@ -517,6 +526,15 @@ window.__ModuleLoader__.load({
       'tabs.skills': 'Skills',
       'tabs.subagent': 'Subagents',
       'features.subagentRoute': 'Subagent model',
+      'features.mobileAdaptation': 'Mobile adaptation',
+      'mobile.fab.label': 'Open sidebar menu',
+      'mobile.debug.title': 'Mobile diagnostics',
+      'mobile.debug.viewport': 'Viewport',
+      'mobile.debug.drawer': 'Drawer',
+      'mobile.debug.details': 'Details',
+      'mobile.debug.errors': 'JS errors',
+      'mobile.debug.stateOn': 'on',
+      'mobile.debug.stateOff': 'off',
       'subagent.title': 'Subagent model',
       'subagent.hint': 'Controls which model a subagent delegation uses when no model was explicitly specified; delegations with an explicit route (pinned preset, another plugin, call arguments) are unaffected.',
       'subagent.mode.label': 'Mode',
@@ -1091,7 +1109,7 @@ window.__ModuleLoader__.load({
         if (number >= 1e3) return `${Math.round(number / 1e2) / 10}K`
         return number.toLocaleString()
       }
-      const DEFAULT_FEATURES = { healthDiagnostics: true, modelUsage: true, quotaLookup: true, backupMaintenance: true, taskNotifications: true, healthz: true, skillManager: true, subagentRoute: true }
+      const DEFAULT_FEATURES = { healthDiagnostics: true, modelUsage: true, quotaLookup: true, backupMaintenance: true, taskNotifications: true, healthz: true, skillManager: true, subagentRoute: true, mobileAdaptation: true }
       const featureScope = ctx.settingsScope.bind({ namespace: NS })
       const featureSnapshot = () => featureScope.getSnapshot()
       const featureValue = () => Object.assign({}, DEFAULT_FEATURES, featureSnapshot().value || {})
@@ -2249,15 +2267,15 @@ window.__ModuleLoader__.load({
         quotaCreatePortal = null
       }
 
-      /** 窄视口判定：matchMedia 优先（可订阅变化），缺席时 innerWidth 兜底；
-       * 无 window（SSR/测试）一律宽视口，维持圆环上方锚定弹层。断点 480px 与外壳窄容器一致。 */
+      /** 移动视口判定：与 v0.30 整体适配共用 1023px 断点；matchMedia 优先，
+       * 缺席时 innerWidth 兜底。无 window（SSR/测试）一律宽视口，维持圆环上方锚定。 */
       function quotaNarrowViewport() {
         if (typeof window === 'undefined' || window === null) return false
         if (typeof window.matchMedia === 'function') {
-          const query = window.matchMedia('(max-width: 480px)')
+          const query = window.matchMedia('(max-width: 1023px)')
           return typeof query.matches === 'boolean' ? query.matches : false
         }
-        return typeof window.innerWidth === 'number' && window.innerWidth <= 480
+        return typeof window.innerWidth === 'number' && window.innerWidth <= 1023
       }
 
       function QuotaRing(props) {
@@ -2284,12 +2302,12 @@ window.__ModuleLoader__.load({
         const [open, setOpen] = useState(false)
         const rootRef = useRef(null)
         const panelRef = useRef(null)
-        // 窄视口（手机竖屏）：弹层 portal 到 body 视口居中；宽视口保持圆环上方锚定。
+        // 移动视口：弹层 portal 到 body，在对话区域下半部保持水平居中；宽视口保持圆环上方锚定。
         // matchMedia change 订阅让旋转/拖宽窗口时弹层几何实时迁移，open 态不丢。
         const [narrow, setNarrow] = useState(quotaNarrowViewport)
         useEffect(() => {
           if (typeof window === 'undefined' || window === null || typeof window.matchMedia !== 'function') return undefined
-          const query = window.matchMedia('(max-width: 480px)')
+          const query = window.matchMedia('(max-width: 1023px)')
           const sync = () => setNarrow(query.matches)
           sync()
           if (typeof query.addEventListener === 'function') query.addEventListener('change', sync)
@@ -2361,8 +2379,8 @@ window.__ModuleLoader__.load({
           ? React.createElement('div', { style: { marginTop: '8px', fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)' } },
               row.refreshing === true ? translate('quota.refreshing') : translate('quota.updated', { time: formatClockTime(row.fetchedAt) }))
           : null
-        // 面板先构造、再决定挂载方式：窄视口 portal 到 document.body 后 fixed 视口居中
-        // （根因见 quotaCreatePortal 处注释）；宽视口或 react-dom 缺席时锚定圆环上方（原行为）。
+        // 面板先构造、再决定挂载方式：移动视口 portal 到 document.body 后 fixed，
+        // 水平居中、垂直中心下移到屏幕高度 75%；宽视口或 react-dom 缺席时锚定圆环上方。
         const centered = open && narrow && quotaCreatePortal !== null
           && typeof document !== 'undefined' && document.body !== null && document.body !== undefined
         const triggerNode = React.createElement('button', {
@@ -2393,7 +2411,7 @@ window.__ModuleLoader__.load({
           'aria-label': translate('quota.panel.title'),
           'data-testid': 'quota-ring-panel',
           style: centered
-            ? { position: 'fixed', left: '50%', top: '50%', transform: 'translate(-50%, -50%)', zIndex: 1000, boxSizing: 'border-box', width: 'min(280px, calc(100vw - 32px))', maxHeight: 'calc(100dvh - 96px)', overflowY: 'auto', padding: '12px', borderRadius: '12px', background: 'var(--dsw-specific-menu)', border: '1px solid var(--dsw-alias-border-inverted)', boxShadow: 'var(--dsw-shadow-lv3)' }
+            ? { position: 'fixed', left: '50%', top: '75%', transform: 'translate(-50%, -50%)', zIndex: 1000, boxSizing: 'border-box', width: 'min(280px, calc(100vw - 32px))', maxHeight: 'min(560px, calc(100dvh - 176px))', overflowY: 'auto', padding: '12px', borderRadius: '12px', background: 'var(--dsw-specific-menu)', border: '1px solid var(--dsw-alias-border-inverted)', boxShadow: 'var(--dsw-shadow-lv3)' }
             : { position: 'absolute', bottom: 'calc(100% + 8px)', right: 0, zIndex: 100, boxSizing: 'border-box', width: '240px', padding: '12px', borderRadius: '12px', background: 'var(--dsw-specific-menu)', border: '1px solid var(--dsw-alias-border-inverted)', boxShadow: 'var(--dsw-shadow-lv3)' },
         },
           React.createElement('div', { style: { display: 'flex', alignItems: 'baseline', gap: '6px' } },
@@ -2470,7 +2488,7 @@ window.__ModuleLoader__.load({
         }, React.createElement('path', { d: 'M3 5.25 7 9l4-3.75', fill: 'none', stroke: 'currentColor', strokeWidth: 1.4, strokeLinecap: 'round', strokeLinejoin: 'round' }))),
         open ? React.createElement('div', { style: { margin: '0 16px', padding: '12px 0 8px', borderTop: '1px solid var(--dsw-alias-border-l2)' } },
           React.createElement('div', { style: { fontSize: '12px', fontWeight: 700 } }, translate('features.optional')),
-          ['healthDiagnostics', 'modelUsage', 'quotaLookup', 'backupMaintenance', 'taskNotifications', 'skillManager', 'subagentRoute'].map(row),
+          ['healthDiagnostics', 'modelUsage', 'quotaLookup', 'backupMaintenance', 'taskNotifications', 'skillManager', 'subagentRoute', 'mobileAdaptation'].map(row),
           React.createElement('div', { style: { fontSize: '12px', fontWeight: 700, marginTop: '8px', paddingTop: '10px', borderTop: '1px solid var(--dsw-alias-border-l1)' } }, translate('features.external')),
           row('healthz'),
           !writable ? React.createElement('p', { style: { margin: '6px 0 0', fontSize: '11px', color: 'var(--dsw-alias-label-tertiary)' } }, translate('features.readOnly')) : null) : null)
@@ -4481,6 +4499,532 @@ window.__ModuleLoader__.load({
         const unsubscribe = featureScope.subscribe(sync)
         return () => { unsubscribe(); if (dispose !== null) dispose() }
       })
+
+      // ─── 移动端适配引擎（v0.30）─────────────────────────────────────────
+      // 断点与官方外壳一致取 <1024px（AppFrame 的 SIDEBAR_AUTO_COLLAPSE）。
+      // 全部规则作用域于 html[data-dshsvc-mobile] 属性下；抽屉开合走官方
+      // ctx.layout 服务，不重挂宿主 DOM。桌面 ≥1024px 或功能关闭时零效果。
+      const MOBILE_ACTIVE_QUERY = '(max-width: 1023px)'
+      const MOBILE_DEBUG_PARAM = 'dshsvc-mobile-debug'
+      const MOBILE_CSS = `
+/* 侧栏/详情列改 absolute 后会退出 grid 排版流，中列会被自动放置进第 1 轨
+   （0px）而整屏变黑 —— 三列必须用 grid-column 显式钉位，绝不依赖子元素顺序。 */
+html[data-dshsvc-mobile] [data-dshsvc-frame] { grid-template-columns: 0px minmax(0, 1fr) 0px !important; }
+html[data-dshsvc-mobile] [data-dshsvc-sidebar] { grid-column: 1 !important; grid-row: 1 !important; }
+html[data-dshsvc-mobile] [data-dshsvc-center] { grid-column: 2 !important; grid-row: 1 !important; }
+html[data-dshsvc-mobile] [data-dshsvc-details] { grid-column: 3 !important; grid-row: 1 !important; }
+/* 侧栏/详情列 → overlay 抽屉。两条铁律：
+   ① 隐藏禁用 transform —— 设置模态（未 portal）长在本列子树里，
+      transform 会成为其 fixed 定位的包含块；
+   ② 离屏偏移必须用 vw 长度而非百分比 —— 这些列带显式 grid-column 钉位
+      （修中列黑屏所需），绝对定位子项的包含块会变成那格 grid area（0px 宽），
+      百分比对 0 取值全变 0，元素被超约束解算推回屏内盖住会话。 */
+html[data-dshsvc-mobile] [data-dshsvc-sidebar] {
+  position: absolute !important;
+  top: 0 !important;
+  bottom: 0 !important;
+  left: calc(-100vw - 24px) !important;
+  /* 外壳 sidebar slot 的原生展开内容固定 280px；外层也必须同宽，否则右侧
+     会露出一条只有 sidebarCol 背景、没有内容的空带。窄于 280px 时按视口裁切。 */
+  width: min(100vw, 280px) !important;
+  border-right: none !important;
+  z-index: 32;
+  transition: left var(--ds-transition-duration-slow, .25s) var(--ds-ease-in-out, ease);
+}
+html[data-dshsvc-mobile] [data-dshsvc-frame]:not([data-sidebar-collapsed]) [data-dshsvc-sidebar] {
+  left: 0 !important;
+  box-shadow: 8px 0 32px rgba(0, 0, 0, .22);
+}
+/* 详情列（预览/文件树）→ 移动端永久离屏。官方 computeColumns 在窄视口恒为
+   0 宽（原生手机本就不显示该列），抽屉化只会用空态盖住会话且关闭路径
+   与 backdrop/抽屉状态纠缠（真机反馈）。引擎在激活与属性观察时会自愈式
+   closeDetails()，保证 store 也是干净的关闭态。 */
+html[data-dshsvc-mobile] [data-dshsvc-details] {
+  position: absolute !important;
+  top: 0 !important;
+  bottom: 0 !important;
+  right: calc(-100vw - 24px) !important;
+  width: min(92vw, 420px) !important;
+  z-index: 30;
+}
+/* 模态 → 全屏面板：外壳 portal 根是 fixed inset:0 flex 容器（无 transform，
+   无 containing-block 陷阱），dialog 改 absolute 四边拉满即可。
+   真机反馈：底部 sheet 顶部留空难看 → 顶部贴顶、圆角归零；
+   刘海/home 条遮挡由 dialog 自身 env() padding 补回。 */
+html[data-dshsvc-mobile] div[role="presentation"]:has(> [role="dialog"][aria-modal="true"]) {
+  padding: 0 !important;
+}
+html[data-dshsvc-mobile] [role="dialog"][aria-modal="true"] {
+  position: absolute !important;
+  top: 0 !important;
+  right: 0 !important;
+  bottom: 0 !important;
+  left: 0 !important;
+  margin: 0 !important;
+  width: 100% !important;
+  max-width: none !important;
+  max-height: none !important;
+  height: 100% !important;
+  border-radius: 0 !important;
+  overflow: hidden auto !important;
+  flex-direction: column !important;
+  padding-top: env(safe-area-inset-top, 0px) !important;
+  padding-bottom: env(safe-area-inset-bottom, 0px) !important;
+}
+/* 插件市场（dshmarket）在 ≤560px 媒体查询里把设置导航 display:none 藏掉
+   独占面板（其自有 CSS：[role=dialog]:has([data-dsh-market-root])>nav），
+   手机上会把用户困在市场分区 —— 用更高优先级把横滑标签条顶回来。 */
+html[data-dshsvc-mobile] [role="dialog"]:has([data-dsh-market-root]) > nav { display: flex !important; }
+/* 设置页标签条：nav 从 188px 竖列变顶部横滑条（宽度与列向必须显式推翻）。
+   右侧留 52px 给钉到角落的关闭钮。 */
+html[data-dshsvc-mobile] [role="dialog"] nav {
+  flex-direction: row !important;
+  align-items: center !important;
+  gap: 6px !important;
+  width: auto !important;
+  flex: none !important;
+  padding: 8px 52px 0 12px !important;
+  overflow-x: auto !important;
+  overflow-y: hidden !important;
+  border-right: none !important;
+  border-bottom: 1px solid var(--dsw-alias-border-l2);
+}
+html[data-dshsvc-mobile] [role="dialog"] nav > div { flex: none !important; }
+html[data-dshsvc-mobile] [role="dialog"] [class*="navList"] { flex-direction: row !important; }
+html[data-dshsvc-mobile] [role="dialog"] [class*="navCell"] { white-space: nowrap !important; flex: none !important; }
+/* 关闭钮钉到设置页右上角并压到面板顶层（原生在内容区头行、导航条下方，
+   会被横滑条/内容重叠遮挡——用户点名要顶层）；加不透明圆形底衬保证任何
+   内容上都可辨识，底衬与钮同节点、随之置顶。类哈希 VOzbGW_ 取自
+   dsh-client-ui-settings-general SettingsRoot.module.css（rc.2），升级需复核 */
+html[data-dshsvc-mobile] [role="dialog"][aria-modal="true"] [class*="VOzbGW_close"] {
+  position: absolute !important;
+  top: calc(env(safe-area-inset-top, 0px) + 9px) !important;
+  right: 10px !important;
+  z-index: 60;
+  background-color: var(--dsw-specific-menu, var(--dsw-alias-bg-layer-1)) !important;
+  border: 1px solid var(--dsw-alias-border-l2) !important;
+  border-radius: 999px !important;
+  box-shadow: var(--dsw-shadow-lv2, 0 4px 12px rgba(0, 0, 0, .12)) !important;
+}
+/* 设置/任意模态打开时藏抽屉钮：抽屉列自带 z-index:32 层叠上下文会把模态的
+   z1000 封顶在 32，body 级 z33 的钮反而浮在设置页上（真机实测）。:has 不支持时
+   退化为旧行为（钮仍显示），无副作用。 */
+html[data-dshsvc-mobile] body:has([role="dialog"][aria-modal="true"]) [data-dshsvc-fab] {
+  display: none !important;
+}
+/* composer 底行单行紧凑：外壳原生 flex-wrap:wrap 在窄屏把图标/模型名折成两行。
+   收紧间距 + 禁换行 + 最宽触发钮限宽省略。类哈希 uV2eYG_/Sh0Q9G_/pXSMma_ 取自
+   dsh-client-ui-conversation composer（rc.2），升级需复核。 */
+html[data-dshsvc-mobile] [class*="uV2eYG_row"] {
+  flex-wrap: nowrap !important;
+  column-gap: 4px !important;
+  padding-left: 10px !important;
+  padding-right: 10px !important;
+}
+html[data-dshsvc-mobile] [class*="uV2eYG_row"] > * { min-width: 0 !important; }
+html[data-dshsvc-mobile] [class*="uV2eYG_tools"],
+html[data-dshsvc-mobile] [class*="uV2eYG_modes"],
+html[data-dshsvc-mobile] [class*="uV2eYG_trailing"] { gap: 6px !important; min-width: 0 !important; }
+html[data-dshsvc-mobile] [class*="uV2eYG_trailing"] { margin-left: auto !important; }
+html[data-dshsvc-mobile] [class*="Sh0Q9G_trigger"] { max-width: 38vw !important; }
+html[data-dshsvc-mobile] [class*="pXSMma_workspace"] { max-width: 30vw !important; }
+/* 工作区侧板（fixed z25 层内的 nArs4W_panel z40）开屏后会盖住它自己的外部
+   开关钮（tab bar 行 nArs4W_toggleButton）——手机上抽屉一开就再没有任何
+   可点的关闭入口（真机反馈「关不上」本体）。把开关钮提到面板之上，
+   恢复「同一颗钮开/关」语义。 */
+html[data-dshsvc-mobile] [class*="nArs4W_toggleButton"] {
+  position: relative !important;
+  z-index: 45 !important;
+}
+/* 会话底部统计条：外壳原生 white-space:nowrap + ellipsis 截断（StatsLine），
+   改横向滑动查看全文。类哈希 FJxK0a_ 取自 dsh-client-ui-conversation/
+   StatsLine.module.css（0.1.1-rc.2），外壳升级后需复核。 */
+html[data-dshsvc-mobile] [class*="FJxK0a_root"] {
+  overflow-x: auto !important;
+  overflow-y: hidden !important;
+  text-overflow: clip !important;
+  -webkit-overflow-scrolling: touch;
+  scrollbar-width: none !important;
+}
+html[data-dshsvc-mobile] [class*="FJxK0a_root"]::-webkit-scrollbar { display: none !important; }
+/* 左上角抽屉钮：悬停/按压用外壳交互底色；会话头部预留按钮位防遮面包屑 */
+html[data-dshsvc-mobile] [data-dshsvc-fab]:hover,
+html[data-dshsvc-mobile] [data-dshsvc-fab]:active { background: var(--dsw-alias-interactive-bg-hover) !important; }
+html[data-dshsvc-mobile] [data-dshsvc-frame] > :nth-child(2) header { padding-left: 46px !important; }
+/* 刘海安全区：viewport-fit=cover 后由 env() 补回遮挡区 */
+html[data-dshsvc-mobile] body {
+  padding-top: env(safe-area-inset-top, 0px);
+  padding-bottom: env(safe-area-inset-bottom, 0px);
+  box-sizing: border-box;
+}
+/* 双击缩放与 iOS 聚焦放大 */
+html[data-dshsvc-mobile] button,
+html[data-dshsvc-mobile] a,
+html[data-dshsvc-mobile] [role="button"],
+html[data-dshsvc-mobile] input,
+html[data-dshsvc-mobile] textarea,
+html[data-dshsvc-mobile] select { touch-action: manipulation; }
+html[data-dshsvc-mobile] input:not([type="checkbox"]):not([type="radio"]):not([type="button"]):not([type="submit"]):not([type="reset"]),
+html[data-dshsvc-mobile] textarea { font-size: max(16px, 1em) !important; }
+/* composer 防挤压：保守规则，真机反馈后迭代 */
+html[data-dshsvc-mobile] [class*="toolbar" i] { flex-wrap: wrap !important; min-width: 0 !important; max-width: 100% !important; }
+html[data-dshsvc-mobile] [class*="composer" i] { min-width: 0 !important; max-width: 100% !important; }
+html[data-dshsvc-mobile] [class*="inputTriggers" i] > *,
+html[data-dshsvc-mobile] [class*="toolbar" i] button { flex: none !important; }
+`
+
+      function createMobileAdaptation() {
+        const state = {
+          active: false,
+          mq: null,
+          mqHandler: null,
+          frameObserver: null,
+          mountObserver: null,
+          workspaceObserver: null,
+          errorHandler: null,
+          resizeHandler: null,
+          styleTag: null,
+          backdrop: null,
+          fab: null,
+          debugChip: null,
+          debugEnabled: false,
+          errorCount: 0,
+          drawerOpen: false,
+          detailsOpen: false,
+          workspaceOpen: false,
+          lastFabDisplay: null,
+          lastBackdropDisplay: null,
+        }
+
+        const layoutService = () => {
+          try { return typeof ctx.get === 'function' ? ctx.get('layout') : undefined } catch (_) { return undefined }
+        }
+
+        const syncSurfaces = () => {
+          // 详情列移动端永久离屏（CSS），backdrop 只服务侧栏抽屉；
+          // 若外部把详情打开（openDetails），这里自愈式收掉，避免空态盖屏。
+          if (state.detailsOpen) {
+            const layout = layoutService()
+            if (layout !== undefined) {
+              try { layout.closeDetails() } catch (_) {}
+            }
+            state.detailsOpen = false
+          }
+          // 抽屉开启时收起 FAB：关闭走外壳原生侧栏钮或外侧遮罩，绝不在
+          // 抽屉面板上叠画第二套关闭件（真机反馈：
+          // 那只会变成糊在侧栏 logo 上的不明物）。工作区侧板同理互斥。
+          // 变化才写：innerHTML/display 若无条件重写会喂活 body 级观察器死循环。
+          const nextDisplay = (state.drawerOpen || state.workspaceOpen) ? 'none' : 'flex'
+          if (state.fab !== null && state.lastFabDisplay !== nextDisplay) {
+            state.lastFabDisplay = nextDisplay
+            state.fab.style.display = nextDisplay
+          }
+          const backdropNext = state.drawerOpen ? 'block' : 'none'
+          if (state.backdrop !== null && state.lastBackdropDisplay !== backdropNext) {
+            state.lastBackdropDisplay = backdropNext
+            state.backdrop.style.display = backdropNext
+          }
+          if (state.debugEnabled && state.debugChip !== null) updateDebugChip()
+        }
+
+        /** body 级监听的节流入口：同帧多次变更合并为一次读改（脏标记 + 单发调度），
+            回调内严格「无变化不写 DOM」，杜绝 观察器→写DOM→再触发 的自激循环。 */
+        let syncScheduled = false
+        const scheduleSync = () => {
+          if (syncScheduled || !state.active) return
+          syncScheduled = true
+          // 定时器可能活过宿主环境/测试清理期——回调整体兜底，绝不外抛
+          setTimeout(() => {
+            syncScheduled = false
+            if (!state.active) return
+            try {
+              readOverlayState()
+              syncSurfaces()
+            } catch (_) {}
+          }, 50)
+          // 追踪采样：外壳的显隐走过渡动画，50ms 那次读到的可能是动画前旧值；
+          // 动画落定后再校准两次，否则 UI 僵在旧状态、要再碰一下屏幕才刷新。
+          for (const delay of [400, 900]) {
+            setTimeout(() => {
+              if (!state.active) return
+              try { readOverlayState(); syncSurfaces() } catch (_) {}
+            }, delay)
+          }
+        }
+
+        const readOverlayState = () => {
+          const frame = document.querySelector('[data-dshsvc-frame]')
+          state.drawerOpen = frame !== null && !frame.hasAttribute('data-sidebar-collapsed')
+          state.detailsOpen = frame !== null && !frame.hasAttribute('data-details-collapsed')
+          // 工作区侧板（外壳 tab 系统 nArs4W_panel）：可见 = 任一匹配节点解除
+          // PanelHidden 且进入视口。注意 panelBody 等 同哈希同名 子串节点会混入
+          // querySelector 匹配，必须逐个甄别取「或」，否则状态时对时错。
+          state.workspaceOpen = false
+          try {
+            for (const el of document.querySelectorAll('[class*="nArs4W_panel"]')) {
+              const cls = typeof el.className === 'string' ? el.className : ''
+              if (/nArs4W_panelHidden/.test(cls)) continue
+              const rect = el.getBoundingClientRect()
+              if (rect.width > 0 && rect.left < window.innerWidth - 2 && getComputedStyle(el).visibility !== 'hidden') {
+                state.workspaceOpen = true
+                break
+              }
+            }
+          } catch (_) { state.workspaceOpen = false }
+        }
+
+        const FAB_OPEN_ICON =
+          '<svg width="18" height="18" viewBox="0 0 16 16" fill="none" aria-hidden="true">' +
+          '<rect x="1.75" y="2.75" width="12.5" height="10.5" rx="2" stroke="currentColor" stroke-width="1.5"/>' +
+          '<line x1="6.25" y1="3.5" x2="6.25" y2="12.5" stroke="currentColor" stroke-width="1.5"/></svg>'
+
+        const updateDebugChip = () => {
+          const chip = state.debugChip
+          if (chip === null) return
+          const onOff = (value) => (value ? t('mobile.debug.stateOn') : t('mobile.debug.stateOff'))
+          chip.textContent = [
+            `${t('mobile.debug.viewport')} ${window.innerWidth}×${window.innerHeight}`,
+            `≤1023 ${onOff(state.active)}`,
+            `${t('mobile.debug.drawer')} ${onOff(state.drawerOpen)}`,
+            `${t('mobile.debug.details')} ${onOff(state.detailsOpen)}`,
+            `${t('mobile.debug.errors')} ${state.errorCount}`,
+          ].join(' · ')
+        }
+
+        /** 给外壳三栏骨架打自有标记属性；找不到骨架（异常布局）时返回 false 跳过抽屉件。 */
+        const tagShellFrame = () => {
+          // overlayLayer 是 frame 的子元素且带官方 data-shell-overlay 属性（源码核实）
+          const overlayLayer = document.querySelector('[data-shell-overlay]')
+          const frame = overlayLayer !== null ? overlayLayer.parentNode : null
+          if (frame === null || frame === document.documentElement) return false
+          frame.setAttribute('data-dshsvc-frame', '')
+          let sawSidebar = false
+          let sawCenter = false
+          let sawDetails = false
+          for (const child of frame.children) {
+            const className = typeof child.className === 'string' ? child.className : ''
+            if (!sawSidebar && /sidebarCol/.test(className)) {
+              child.setAttribute('data-dshsvc-sidebar', '')
+              sawSidebar = true
+            } else if (!sawCenter && /centerCol/.test(className)) {
+              child.setAttribute('data-dshsvc-center', '')
+              sawCenter = true
+            } else if (!sawDetails && /detailsCol/.test(className)) {
+              child.setAttribute('data-dshsvc-details', '')
+              sawDetails = true
+            }
+          }
+          return true
+        }
+
+        /** 建 backdrop/FAB 并接上抽屉状态观察。外壳骨架就绪才算成功；
+            手机直接窄屏冷加载时骨架往往还没挂载（真机反馈：抽屉钮缺失 +
+            官方 rail 残留，就是这个竞态），失败则由 watchForShell 重试。 */
+        const buildSurfaces = () => {
+          if (state.fab !== null) return true
+          if (!tagShellFrame()) return false
+          state.backdrop = document.createElement('div')
+          state.backdrop.setAttribute('data-dshsvc-backdrop', '')
+          state.backdrop.setAttribute('aria-hidden', 'true')
+          Object.assign(state.backdrop.style, {
+            position: 'fixed', inset: '0', zIndex: '31', display: 'none',
+            background: 'rgba(0,0,0,.42)', backdropFilter: 'blur(1px)',
+          })
+          state.backdrop.addEventListener('click', () => {
+            const layout = layoutService()
+            if (layout === undefined) return
+            if (state.drawerOpen) layout.toggleSidebar()
+          })
+          document.body.appendChild(state.backdrop)
+
+          state.fab = document.createElement('button')
+          state.fab.type = 'button'
+          state.fab.setAttribute('data-dshsvc-fab', '')
+          state.fab.setAttribute('aria-label', t('mobile.fab.label'))
+          // 样式对齐外壳幽灵图标钮（设置关闭钮同族：28px 圆形、透明底、主题色），
+          // 位置钉会话头部左上角（safe-area 感知），图标为侧栏面板开关。
+          Object.assign(state.fab.style, {
+            position: 'fixed',
+            left: 'calc(env(safe-area-inset-left, 0px) + 10px)',
+            top: 'calc(env(safe-area-inset-top, 0px) + 12px)',
+            width: '32px', height: '32px', borderRadius: '16px', zIndex: '33', display: 'flex',
+            alignItems: 'center', justifyContent: 'center',
+            border: 'none', background: 'transparent', color: 'var(--dsw-alias-label-primary)',
+            padding: '0', cursor: 'pointer', touchAction: 'manipulation',
+          })
+          state.fab.innerHTML =
+            '<svg width="18" height="18" viewBox="0 0 16 16" fill="none" aria-hidden="true">' +
+            '<rect x="1.75" y="2.75" width="12.5" height="10.5" rx="2" stroke="currentColor" stroke-width="1.5"/>' +
+            '<line x1="6.25" y1="3.5" x2="6.25" y2="12.5" stroke="currentColor" stroke-width="1.5"/></svg>'
+          // 标准 click 是唯一激活路径：浏览器会把一次触屏手势归一为一个 click，
+          // 同时保留鼠标、键盘与辅助技术支持。不得在 pointerdown 提前翻转再按时间窗
+          // 吞合成 click——主线程忙时 click 可晚到时间窗外，导致同一短按开后又关，
+          // 表现成「必须长按才能打开」。touch-action:manipulation 已消除旧式点按延迟。
+          state.fab.addEventListener('click', () => {
+            const layout = layoutService()
+            if (layout !== undefined) layout.toggleSidebar()
+          })
+          document.body.appendChild(state.fab)
+          readOverlayState()
+
+          // 不在 sidebarCol 上代理关闭：侧栏右上角已有外壳原生 toggle。若祖先再监听
+          // click，同一事件会先由按钮关闭、再冒泡触发第二次 toggle，结果立即重新打开。
+          // 抽屉关闭路径只保留原生 toggle 与外侧 backdrop，两者职责互不重叠。
+
+          // 工作区侧板（nArs4W_panel，fixed z25 层）不受三栏属性驱动；
+          // body 级监听只置脏标记、单发调度处理（绝不在回调里同步写 DOM，
+          // 否则 写DOM→再触发→再写 的自激循环会打满主线程，页面永久转圈）
+          try {
+            state.workspaceObserver = new MutationObserver(() => { scheduleSync() })
+            state.workspaceObserver.observe(document.body, { attributes: true, childList: true, subtree: true })
+          } catch (_) {
+            state.workspaceObserver = null
+          }
+
+          // frame 属性观察是抽屉状态主驱动：同步处理（监听范围受控、无自激风险）
+          state.frameObserver = new MutationObserver(() => {
+            readOverlayState()
+            syncSurfaces()
+          })
+          const frame = document.querySelector('[data-dshsvc-frame]')
+          if (frame !== null) state.frameObserver.observe(frame, { attributes: true, attributeFilter: ['data-sidebar-collapsed', 'data-details-collapsed'] })
+
+          if (state.mountObserver !== null) { state.mountObserver.disconnect(); state.mountObserver = null }
+          syncSurfaces()
+          return true
+        }
+
+        /** 外壳骨架晚挂载的重试观察：AppFrame 一进 DOM 就补建抽屉件。 */
+        const watchForShell = () => {
+          if (state.mountObserver !== null || typeof MutationObserver !== 'function') return
+          try {
+            state.mountObserver = new MutationObserver(() => { buildSurfaces() })
+            state.mountObserver.observe(document.documentElement, { childList: true, subtree: true })
+          } catch (_) {
+            state.mountObserver = null
+          }
+        }
+
+        const ensureViewportCover = () => {
+          for (const meta of document.querySelectorAll('meta[name="viewport"]')) {
+            const content = meta.getAttribute('content') || ''
+            if (/(^|,)\s*viewport-fit\s*=/.test(content)) continue
+            meta.setAttribute('content', content.trim() === '' ? 'viewport-fit=cover' : content.trim() + ', viewport-fit=cover')
+          }
+        }
+
+        const activate = () => {
+          if (state.active) return
+          if (layoutService() === undefined) return // 无官方 layout 服务时不出交互件，避免不可收起的抽屉
+          state.active = true
+          // 全部规则的作用域开关：CSS 与 DOM 标记都以它为门
+          document.documentElement.setAttribute('data-dshsvc-mobile', '')
+          ensureViewportCover()
+          state.styleTag = document.createElement('style')
+          state.styleTag.dataset.plugin = '@gehennawu/dsh-service'
+          state.styleTag.dataset.pluginCss = '@gehennawu/dsh-service/mobile.css'
+          state.styleTag.textContent = MOBILE_CSS
+          document.head.appendChild(state.styleTag)
+          if (!buildSurfaces()) watchForShell()
+
+          let debugRequested = false
+          try { debugRequested = new URLSearchParams(window.location.search).has(MOBILE_DEBUG_PARAM) } catch (_) {}
+          if (debugRequested) {
+            state.debugEnabled = true
+            state.errorHandler = () => {
+              state.errorCount += 1
+              updateDebugChip()
+            }
+            window.addEventListener('error', state.errorHandler)
+            state.resizeHandler = () => updateDebugChip()
+            window.addEventListener('resize', state.resizeHandler)
+            state.debugChip = document.createElement('div')
+            state.debugChip.setAttribute('data-dshsvc-debug', '')
+            Object.assign(state.debugChip.style, {
+              position: 'fixed', left: '8px', bottom: 'calc(env(safe-area-inset-bottom, 0px) + 8px)',
+              zIndex: '60', maxWidth: '94vw', padding: '4px 8px', borderRadius: '8px',
+              font: '11px/1.5 var(--ds-font-family-code, monospace)',
+              background: 'var(--dsw-alias-bg-layer-2, #333)', color: 'var(--dsw-alias-label-primary, #eee)',
+              pointerEvents: 'none', whiteSpace: 'nowrap', overflow: 'hidden', textOverflow: 'ellipsis',
+            })
+            state.debugChip.title = t('mobile.debug.title')
+            document.body.appendChild(state.debugChip)
+            updateDebugChip()
+          }
+          syncSurfaces()
+        }
+
+        const deactivate = () => {
+          if (!state.active) return
+          state.active = false
+          state.drawerOpen = false
+          state.detailsOpen = false
+          document.documentElement.removeAttribute('data-dshsvc-mobile')
+          if (state.frameObserver !== null) { state.frameObserver.disconnect(); state.frameObserver = null }
+          if (state.workspaceObserver !== null) { state.workspaceObserver.disconnect(); state.workspaceObserver = null }
+          if (state.mountObserver !== null) { state.mountObserver.disconnect(); state.mountObserver = null }
+          if (state.errorHandler !== null) window.removeEventListener('error', state.errorHandler)
+          if (state.resizeHandler !== null) window.removeEventListener('resize', state.resizeHandler)
+          state.errorHandler = null
+          state.resizeHandler = null
+          for (const el of [state.styleTag, state.backdrop, state.fab, state.debugChip]) {
+            if (el !== null && el.isConnected) el.remove()
+          }
+          for (const el of document.querySelectorAll('[data-dshsvc-frame],[data-dshsvc-sidebar],[data-dshsvc-center],[data-dshsvc-details]')) {
+            el.removeAttribute('data-dshsvc-frame')
+            el.removeAttribute('data-dshsvc-sidebar')
+            el.removeAttribute('data-dshsvc-center')
+            el.removeAttribute('data-dshsvc-details')
+          }
+          state.styleTag = null
+          state.backdrop = null
+          state.fab = null
+          state.debugChip = null
+          state.debugEnabled = false
+        }
+
+        const evaluate = () => {
+          const want = featureEnabled('mobileAdaptation') && state.mmqMatches()
+          if (want) activate()
+          else deactivate()
+        }
+
+        const dispose = () => {
+          deactivate()
+          if (state.mq !== null && state.mqHandler !== null) {
+            if (typeof state.mq.removeEventListener === 'function') state.mq.removeEventListener('change', state.mqHandler)
+            else if (typeof state.mq.removeListener === 'function') state.mq.removeListener('change', state.mqHandler)
+          }
+          state.mqHandler = null
+        }
+
+        // matchMedia 惰性创建：测试环境可能只提供最小桩
+        try {
+          state.mq = window.matchMedia(MOBILE_ACTIVE_QUERY)
+        } catch (_) {
+          state.mq = null
+        }
+        state.mmqMatches = () => {
+          try { return state.mq !== null && state.mq.matches === true } catch (_) { return false }
+        }
+        if (state.mq !== null) {
+          state.mqHandler = () => evaluate()
+          if (typeof state.mq.addEventListener === 'function') state.mq.addEventListener('change', state.mqHandler)
+          else if (typeof state.mq.addListener === 'function') state.mq.addListener(state.mqHandler)
+        }
+
+        return { evaluate, dispose }
+      }
+
+      const mobileEngine = createMobileAdaptation()
+      ctx.effect(() => {
+        const unsubscribeFeatures = featureScope.subscribe(() => mobileEngine.evaluate())
+        mobileEngine.evaluate()
+        return () => {
+          unsubscribeFeatures()
+          mobileEngine.dispose()
+        }
+      }, 'dsh-service mobile adaptation')
     }
 
     exports.inject = inject

package/index.js

@@ -9,6 +9,8 @@ import { basename, dirname, join, relative, resolve, sep } from 'node:path'
 import { createRequire } from 'node:module'
 import { fileURLToPath } from 'node:url'
 import https from 'node:https'
+import { brotliCompress, constants as zlibConstants, gzip } from 'node:zlib'
+import { ServerResponse as NodeServerResponse } from 'node:http'
 import z from '@deepseek-ai/schemastery'
 
 const require = createRequire(import.meta.url)
@@ -26,6 +28,7 @@ const DEFAULT_FEATURE_SETTINGS = Object.freeze({
   healthz: true,
   skillManager: true,
   subagentRoute: true,
+  mobileAdaptation: true,
 })
 const FeatureSettingsSchema = z.object({
   healthDiagnostics: z.boolean().default(true),
@@ -36,6 +39,7 @@ const FeatureSettingsSchema = z.object({
   healthz: z.boolean().default(true),
   skillManager: z.boolean().default(true),
   subagentRoute: z.boolean().default(true),
+  mobileAdaptation: z.boolean().default(true),
 })
 const NPM_REGISTRY = 'https://registry.npmjs.org/'
 const MAX_NPM_RESPONSE_BYTES = 256 * 1024
@@ -3103,6 +3107,261 @@ function resolveSubagentInjection(request, config, options = {}) {
 }
 
 
+// ── 移动端适配·宿主半（v0.30）：大 JSON 响应透明压缩 ─────────────────────────
+// 长会话的 history JSON 可达数十 MB，手机网络下首屏极慢。给 http.ServerResponse.prototype
+// 打补丁：JSON 响应延迟到 end 收尾，按请求 Accept-Encoding 选 br > gzip 异步压缩；
+// 小体积与其他 content-type 字节级透传。插件卸载或功能关闭时经 disposer 还原原型。
+// 设计边界：ndjson / event-stream 这类增量流即使带 json 字样也绝不缓冲；
+// 不经 writeHead 显式带头对象的响应（statusCode + setHeader、Node 隐式头）识别不到，
+// 一律透传。
+
+/** 不值得压缩的下限：更小的 JSON 按原始头字节级回放。 */
+const MOBILE_COMPRESS_MIN_BYTES = 4 * 1024
+/** 超过该体积跳过压缩：避免「原文 + 压缩结果」双份内存尖峰。 */
+const MOBILE_COMPRESS_MAX_BYTES = 64 * 1024 * 1024
+const MOBILE_BROTLI_QUALITY = 5
+const MOBILE_GZIP_LEVEL = 6
+
+/**
+ * content-type 是否值得走延迟压缩路径：JSON 且非增量流。
+ * @param {unknown} contentType - 响应头 content-type 原始值（可空）。
+ * @returns {boolean} true 表示可以缓冲到 end 再决定。
+ */
+export function isCompressibleJsonType(contentType) {
+  const value = String(contentType ?? '').toLowerCase()
+  if (!value.includes('json')) return false
+  // ndjson / event-stream 是持续增量流，整体缓冲会破坏消费语义。
+  return !value.includes('ndjson') && !value.includes('event-stream')
+}
+
+/**
+ * 从 Accept-Encoding 请求头选编解码器；br 优先于 gzip。
+ * @param {unknown} acceptEncoding - 请求头原值（可空）。
+ * @returns {'br'|'gzip'|null} 客户端不接受的编码时返回 null（透传）。
+ */
+export function pickCompressionEncoding(acceptEncoding) {
+  const accepted = String(acceptEncoding ?? '').toLowerCase()
+  if (/\bbr\b/.test(accepted)) return 'br'
+  if (/\bgzip\b/.test(accepted)) return 'gzip'
+  return null
+}
+
+/**
+ * 向既有 Vary 值追加一个 token；已有（大小写不敏感）则原样返回。
+ * @param {unknown} existing - 现有 Vary 头值。
+ * @param {string} token - 要追加的 token。
+ * @returns {string} 合并后的 Vary 值。
+ */
+export function appendVaryToken(existing, token) {
+  const current = existing === null || existing === undefined ? '' : String(existing)
+  if (current.toLowerCase().includes(token.toLowerCase())) return current
+  return current === '' ? token : `${current}, ${token}`
+}
+
+/**
+ * 用 zlib 异步压缩一个完整 body（不阻塞事件循环）。
+ * @param {Buffer} body - 待压缩字节。
+ * @param {'br'|'gzip'} encoding - 目标编码。
+ * @returns {Promise<Buffer>} 压缩结果。
+ */
+function compressBodyAsync(body, encoding) {
+  return new Promise((resolvePromise, rejectPromise) => {
+    const settle = (error, result) => (error ? rejectPromise(error) : resolvePromise(result))
+    if (encoding === 'br') {
+      brotliCompress(body, { params: { [zlibConstants.BROTLI_PARAM_QUALITY]: MOBILE_BROTLI_QUALITY } }, settle)
+    } else {
+      gzip(body, { level: MOBILE_GZIP_LEVEL }, settle)
+    }
+  })
+}
+
+/**
+ * 把 write/end 缓冲期收到的 chunk 归一化为 Buffer 追加进 pending。
+ * @param {{chunks: Buffer[]}} pending - 延迟响应状态。
+ * @param {unknown} chunk - write/end 的 chunk 参数。
+ * @param {string|undefined} encoding - Node 流编码参数（字符串 chunk 时生效）。
+ * @returns {void}
+ */
+function bufferPendingChunk(pending, chunk, encoding) {
+  if (chunk === null || chunk === undefined) return
+  if (Buffer.isBuffer(chunk)) pending.chunks.push(chunk)
+  else if (ArrayBuffer.isView(chunk)) pending.chunks.push(Buffer.from(chunk.buffer, chunk.byteOffset, chunk.byteLength))
+  else if (typeof chunk === 'string') pending.chunks.push(Buffer.from(chunk, encoding || 'utf8'))
+  else pending.chunks.push(Buffer.from(String(chunk)))
+}
+
+/**
+ * 解析 Node write/end 的可选参数序列（encoding 字符串 / callback）。
+ * @param {unknown[]} rest - 除 chunk 外的剩余参数。
+ * @returns {{encoding?: string, callbacks: Function[]}} 解析结果。
+ */
+function parseStreamRestArgs(rest) {
+  const parsed = { callbacks: [] }
+  for (const item of rest) {
+    if (typeof item === 'string') parsed.encoding = item
+    else if (typeof item === 'function') parsed.callbacks.push(item)
+  }
+  return parsed
+}
+
+/**
+ * 以暂存的原始实参回放 writeHead（透传路径：头集合与调用方所写完全一致）。
+ * @param {import('node:http').ServerResponse} res - 目标响应。
+ * @param {Function} originalWriteHead - 未打补丁的 writeHead。
+ * @param {unknown[]} storedArgs - 首次 writeHead 的实参副本。
+ * @returns {import('node:http').ServerResponse} writeHead 返回值。
+ */
+function replayStoredWriteHead(res, originalWriteHead, storedArgs) {
+  if (storedArgs.length === 0) return originalWriteHead.call(res, 200)
+  return originalWriteHead.apply(res, storedArgs)
+}
+
+/**
+ * 回放 writeHead，但把头集合替换为压缩路径的最终头对象。
+ * @param {import('node:http').ServerResponse} res - 目标响应。
+ * @param {Function} originalWriteHead - 未打补丁的 writeHead。
+ * @param {unknown[]} storedArgs - 首次 writeHead 的实参副本。
+ * @param {Record<string, unknown>} headers - 最终头集合（含压缩相关头）。
+ * @returns {import('node:http').ServerResponse} writeHead 返回值。
+ */
+function replayStoredWriteHeadWithHeaders(res, originalWriteHead, storedArgs, headers) {
+  const args = storedArgs.slice()
+  if (typeof args[1] === 'string') args[2] = headers
+  else args[1] = headers
+  return originalWriteHead.apply(res, args)
+}
+
+/**
+ * 安装大 JSON 响应透明压缩补丁。进程内单例：重复安装返回既有 disposer。
+ * @returns {() => void} 还原原型方法的 disposer（身份校验，只摘自己的补丁）。
+ */
+export function installMobileResponseCompression() {
+  const proto = NodeServerResponse.prototype
+  // 已装补丁的守卫放在 ensure 层；此处仍做二次防御，避免测试直调时叠加。
+  if (proto.writeHead?.name === 'mobileCompressWriteHead') return () => {}
+  const originalWriteHead = proto.writeHead
+  const originalWrite = proto.write
+  const originalEnd = proto.end
+
+  /** @type {WeakMap<import('node:http').ServerResponse, object>} 每响应延迟状态，仅 JSON 响应收尾前存在。 */
+  const pendingByResponse = new WeakMap()
+
+  function mobileCompressWriteHead(...args) {
+    try {
+      const headerArg = typeof args[1] === 'string' ? args[2] : args[1]
+      // 只有「显式携带头对象」的 writeHead 才考虑延迟：Node 的隐式头路径
+      // (_implicitHeader → writeHead(statusCode)) 也走这里，若延迟会让原始
+      // end 在未发头的 socket 上直写 body，破坏线上的帧结构。
+      // setHeader 风格的响应因此保持透传（fail-open）。
+      if (headerArg === undefined || headerArg === null || typeof headerArg !== 'object') {
+        return originalWriteHead.apply(this, args)
+      }
+      // 判定用头集合 = 当前已 setHeader 的 + 本次 writeHead 实参里的（后者覆盖前者），
+      // 让「setHeader 后再 writeHead(200, {…})」这类写法也能被识别。
+      const merged = { ...this.getHeaders(), ...headerArg }
+      const encoding = pickCompressionEncoding(this.req?.headers?.['accept-encoding'])
+      if (
+        encoding === null ||
+        merged['content-encoding'] !== undefined ||
+        !isCompressibleJsonType(merged['content-type'])
+      ) return originalWriteHead.apply(this, args)
+      // 延迟收尾：先不发头、不落盘，等 end 时按实际体积决定压缩还是原样回放。
+      pendingByResponse.set(this, { writeHeadArgs: args.slice(), chunks: [], encoding })
+      return this
+    } catch (_) {
+      // 判定阶段的任何意外都退回透传，不影响宿主原有响应行为。
+      return originalWriteHead.apply(this, args)
+    }
+  }
+
+  function mobileCompressWrite(chunk, ...rest) {
+    const pending = pendingByResponse.get(this)
+    if (pending === undefined) return originalWrite.call(this, chunk, ...rest)
+    const { encoding, callbacks } = parseStreamRestArgs(rest)
+    bufferPendingChunk(pending, chunk, encoding)
+    // 缓冲期的 write 回调立即以成功触发：这些 JSON 路由无人依赖背压/drain 时序，
+    // 与其让调用方挂在一个永不触发的回调上，不如语义上视作「已接收」。
+    for (const callback of callbacks) {
+      try { callback(null) } catch (_) {}
+    }
+    return true
+  }
+
+  function mobileCompressEnd(chunk, ...rest) {
+    const pending = pendingByResponse.get(this)
+    if (pending === undefined) {
+      return chunk === undefined
+        ? originalEnd.apply(this, rest)
+        : originalEnd.call(this, chunk, ...rest)
+    }
+    pendingByResponse.delete(this)
+    if (chunk !== undefined) bufferPendingChunk(pending, chunk, parseStreamRestArgs(rest).encoding)
+    const [endCallback] = parseStreamRestArgs(rest).callbacks
+    const body = Buffer.concat(pending.chunks)
+
+    // 透传收尾：原始 writeHead 实参 + 原始 body，字节级等价于未打补丁的行为。
+    const finishPassthrough = () => {
+      replayStoredWriteHead(this, originalWriteHead, pending.writeHeadArgs)
+      if (body.length === 0) return originalEnd.call(this, endCallback)
+      return originalEnd.call(this, body, endCallback)
+    }
+
+    if (body.length < MOBILE_COMPRESS_MIN_BYTES || body.length > MOBILE_COMPRESS_MAX_BYTES) return finishPassthrough()
+
+    // 最终头集合 = 已 setHeader 的 + 暂存 writeHead 实参里的（后者覆盖前者，符合
+    // Node writeHead 语义）。注意补丁延迟了原始 writeHead，getHeaders() 里不会有
+    // 实参头的身影，必须显式并进来；writeHead 之后又 setHeader 的路径同样兼容。
+    const storedHeaderArg = typeof pending.writeHeadArgs[1] === 'string' ? pending.writeHeadArgs[2] : pending.writeHeadArgs[1]
+    const finalHeaders = {
+      ...this.getHeaders(),
+      ...(storedHeaderArg && typeof storedHeaderArg === 'object' ? storedHeaderArg : {}),
+    }
+    if (!isCompressibleJsonType(finalHeaders['content-type'])) return finishPassthrough()
+
+    finalHeaders['content-encoding'] = pending.encoding
+    delete finalHeaders['content-length']
+    finalHeaders.vary = appendVaryToken(finalHeaders.vary, 'Accept-Encoding')
+
+    compressBodyAsync(body, pending.encoding).then((compressed) => {
+      finalHeaders['content-length'] = compressed.length
+      replayStoredWriteHeadWithHeaders(this, originalWriteHead, pending.writeHeadArgs, finalHeaders)
+      originalWrite.call(this, compressed)
+      originalEnd.call(this, endCallback)
+    }, finishPassthrough)
+    return this
+  }
+
+  proto.writeHead = mobileCompressWriteHead
+  proto.write = mobileCompressWrite
+  proto.end = mobileCompressEnd
+  return () => {
+    if (proto.writeHead === mobileCompressWriteHead) proto.writeHead = originalWriteHead
+    if (proto.write === mobileCompressWrite) proto.write = originalWrite
+    if (proto.end === mobileCompressEnd) proto.end = originalEnd
+  }
+}
+
+let activeMobileCompressionDispose = null
+
+/**
+ * 进程内单例入口：确保压缩补丁处于安装状态，返回用于还原的 disposer。
+ * 每次调用都返回独立的托管包装：任一包装释放都会真正还原补丁并清掉单例标记，
+ * 后续再 ensure 会重新安装（绝不出现「标记还在、补丁已摘」的假活状态）。
+ * @returns {() => void} disposer。
+ */
+export function ensureMobileResponseCompression() {
+  if (activeMobileCompressionDispose === null) activeMobileCompressionDispose = installMobileResponseCompression()
+  const inner = activeMobileCompressionDispose
+  let released = false
+  return () => {
+    if (released || activeMobileCompressionDispose === null) return
+    released = true
+    activeMobileCompressionDispose = null
+    inner()
+  }
+}
+
+
 function apply(ctx) {
   const dshHome = resolveDshHome()
   let featureSettings = DEFAULT_FEATURE_SETTINGS
@@ -3398,6 +3657,27 @@ function apply(ctx) {
     for (const controller of quotaAbortControllers) controller.abort()
     quotaAbortControllers.clear()
   }, 'dsh-service quota upstream disposal')
+  // ── 移动端适配（v0.30）：大 JSON 响应压缩随功能开关热挂卸 ────────────────
+  let mobileCompressionDispose = null
+  const syncMobileCompression = () => {
+    if (featureEnabled('mobileAdaptation')) {
+      if (mobileCompressionDispose === null) mobileCompressionDispose = ensureMobileResponseCompression()
+    } else if (mobileCompressionDispose !== null) {
+      mobileCompressionDispose()
+      mobileCompressionDispose = null
+    }
+  }
+  ctx.effect(() => {
+    featureSettingsListeners.add(syncMobileCompression)
+    syncMobileCompression()
+    return () => {
+      featureSettingsListeners.delete(syncMobileCompression)
+      if (mobileCompressionDispose !== null) {
+        mobileCompressionDispose()
+        mobileCompressionDispose = null
+      }
+    }
+  }, 'dsh-service mobile response compression')
   const commands = ctx.get('commands')
   if (commands !== undefined) {
     ctx.effect(() => commands.register({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gehennawu/dsh-service",
-  "version": "0.28.0",
+  "version": "0.30.0",
   "description": "DSH Web 自托管运维面板：安全重启、健康监控、备份和 Linux 权限维护。",
   "type": "module",
   "scripts": {