dsh-desktop-embed 1.0.0 → 1.1.0

package/README.md

@@ -69,6 +69,44 @@ curl -s http://127.0.0.1:8799/embed/setup -H 'sec-fetch-site: none' | grep -o 'n
 
 手机端更直接：点按钮 → 填两个值 → 页面里出现电脑版界面，且**地址栏仍是 127.0.0.1**。
 
+## 为什么第一次打开慢，以及 1.1.0 做了什么
+
+手机上第一次打开要等一两分钟，主要不是「电脑慢」，是这条链路上重复了太多工作：
+
+- 每取一个资源都新建一条 TCP + TLS 连接；界面的框架资源有几十个，手机上每次握手几百毫秒，串起来就是一分钟。
+- 入口页引用的主 JS 单文件约 940 KB，从中继直取实测 **6.05 秒**。
+- 用户在点按钮之后才开始取，前面这段时间完全是干等。
+
+1.1.0 加了四件事：
+
+| 改动 | 效果（同一台中继上实测） |
+|---|---|
+| 连接池（keep-alive，`maxSockets 16`） | 同一台中继的请求复用连接，不再每次重新握手 |
+| 启动时预热：先把入口页和它引用的 `/assets`、`/plugins` 资源拉进内存缓存 | 点按钮时框架资源已经在本地 |
+| 静态资源缓存（按内容哈希为键，上限 96 MB）+ 并发请求合并 | 主 JS `941436 B`：中继直取 **6.05 s** → 命中缓存 **1.7 ms** |
+| `/embed` 加载进度层（步骤文案 + 秒表 + 「已预热 n/m」） | 不再是白屏干等；实测「页面载入 → 界面就绪」约 **4.5 s**（缓存热） |
+
+预热是**自动**的：插件启动时若已有配置就立即开始，保存设置后也会再跑一次。缓存只在内存里，DSH 重启就没了——重启后的第一次打开会慢一些，之后又是快的。
+
+排查「为什么还是慢」：
+
+```bash
+curl http://127.0.0.1:<手机 DSH 端口>/api/dsh-embed/status
+```
+
+返回里的 `cache.entries` / `cache.bytes` / `warm`（资产数、成功数、耗时）就是预热结果；`warm.ok=false` 时看 `warm.error`。
+
+## 手机上的排版
+
+iframe 与外层不同源（端口不同），外层改不了里面的 DOM，所以排版修补放在代理这一层：给经过的入口页注入一张样式表，规则全部关在 `@media (max-width: 1023px) and (pointer: coarse)` 里——
+
+- 按钮、`[role=button|tab|menuitem|option]` 最小 40×40，输入框最小高 40 且字号 16px（小于 16px 时 iOS / 部分安卓会放大页面）
+- 侧栏 / 抽屉最大 `88vw`，不再盖住全部内容
+- 表格横向滚动而不是撑破页面，图片视频限宽，正文禁止横向溢出
+- 文本域底部留 `env(safe-area-inset-bottom)`，软键盘弹起时输入框不被顶掉
+
+桌面上这条 media query 不匹配，所以不影响电脑端观感。
+
 ## 已知限制
 
 1. **`Secure` cookie 不能用明文 http 送过去。** 中继的 `dsh_pair` 带 `Secure`；手机 → 中继这一段如果是 `https://`（中继本身就是 https，正常情况都满足），代理拿着 cookie 发请求没问题。但如果你的 `bridgeUrl` 指向一个 http 桥，插件只是拿它当「取链接的信使」，不拿它传 cookie，所以照样可用。

package/index.js

@@ -41,10 +41,10 @@
  * cookie 只留在内存里，进程重启就重铸一枚；设备会话本身仍然沿用
  * `~/.dsh/remote-web-ui-devices.json`，重启 `dsh web` 不会掉。
  */
-import { randomBytes } from 'node:crypto'
+import { createHash, randomBytes } from 'node:crypto'
 import { existsSync, readFileSync, renameSync, writeFileSync } from 'node:fs'
-import { createServer, request as httpRequest } from 'node:http'
-import { request as httpsRequest } from 'node:https'
+import { Agent as HttpAgent, createServer, request as httpRequest } from 'node:http'
+import { Agent as HttpsAgent, request as httpsRequest } from 'node:https'
 import { createRequire } from 'node:module'
 import { homedir } from 'node:os'
 import { dirname, join, resolve } from 'node:path'
@@ -60,6 +60,23 @@ const CONFIG_FILE_NAME = 'dsh-embed.json'
 const GATE_COOKIE = 'dsh_embed'
 const TARGET_COOKIE = 'dsh_pair'
 
+/**
+ * 这两条是「第一次打开要等一两分钟」的主要来源：每个资源都新建一条 TCP+TLS
+ * 连接，手机上每次握手几百毫秒，几十个资源排下来就是一分钟。改成 keep-alive
+ * 池以后同一台中继上的请求复用同一条连接。
+ */
+const httpAgent = new HttpAgent({ keepAlive: true, keepAliveMsecs: 20000, maxSockets: 16 })
+const httpsAgent = new HttpsAgent({ keepAlive: true, keepAliveMsecs: 20000, maxSockets: 16 })
+
+/** 静态资源（带内容哈希的文件名）可以长期缓存；入口页 5 分钟内有效。 */
+const MAX_CACHE_ENTRY = 4 * 1024 * 1024
+const MAX_CACHE_BYTES = 96 * 1024 * 1024
+const ENTRY_TTL_MS = 5 * 60 * 1000
+
+function agentFor(target) {
+  return target.protocol === 'https:' ? httpsAgent : httpAgent
+}
+
 /**
  * 定位随 harness 一起安装的 schemastery；找不到就不导出 Config，
  * 插件仍然可以用文件 / 环境变量配置。裸 `import` 在插件目录里解析不到，
@@ -168,6 +185,11 @@ function createState() {
     actualPort: 0,
     gate: randomBytes(8).toString('hex'),
     minting: null,
+    cache: new Map(),
+    cacheBytes: 0,
+    inflight: new Map(),
+    warming: null,
+    warm: null,
   }
 }
 
@@ -257,6 +279,119 @@ function ensureSession(state, cfg) {
   return state.minting
 }
 
+/** 直接向中继取一份（预热专用，不走浏览器那一层）。 */
+function fetchThrough(state, path, method = 'GET') {
+  return new Promise((resolvePromise, rejectPromise) => {
+    const target = new URL(path, state.relay)
+    const mod = target.protocol === 'https:' ? httpsRequest : httpRequest
+    const req = mod(
+      {
+        protocol: target.protocol,
+        hostname: target.hostname,
+        port: target.port || undefined,
+        method,
+        path: upstreamPath(path),
+        headers: {
+          host: target.host,
+          cookie: state.cookie,
+          accept: '*/*',
+          'accept-encoding': 'identity',
+          'user-agent': 'dsh-embed-prewarm/1.1',
+        },
+        agent: agentFor(target),
+      },
+      (up) => {
+        const chunks = []
+        let size = 0
+        up.on('data', (chunk) => {
+          size += chunk.length
+          if (size > MAX_CACHE_ENTRY * 2) {
+            up.destroy()
+            rejectPromise(new Error('响应超过预热上限'))
+            return
+          }
+          chunks.push(chunk)
+        })
+        up.on('end', () =>
+          resolvePromise({ status: up.statusCode ?? 0, type: String(up.headers['content-type'] || ''), body: Buffer.concat(chunks) }),
+        )
+        up.on('error', rejectPromise)
+      },
+    )
+    req.on('error', rejectPromise)
+    req.end()
+  })
+}
+
+/** 从入口页里挑出要预热的资源（只认本地的 /assets、/plugins）。 */
+function extractAssets(html) {
+  const out = []
+  const seen = new Set()
+  const re = /(?:src|href)\s*=\s*["']([^"']+)["']/g
+  let match
+  while ((match = re.exec(html))) {
+    let value = match[1].trim()
+    if (!value || value.startsWith('data:') || value.startsWith('http://') || value.startsWith('https://')) continue
+    if (value.startsWith('./')) value = value.slice(1)
+    // 入口页里有两种写法：`./assets/x.js` 和裸相对的 `plugins/??a,b,c`
+    if (!value.startsWith('/') && (value.startsWith('assets/') || value.startsWith('plugins/'))) value = `/${value}`
+    if (!value.startsWith('/assets/') && !value.startsWith('/plugins/')) continue
+    if (seen.has(value)) continue
+    seen.add(value)
+    out.push(value)
+  }
+  return out
+}
+
+/**
+ * 预热：用户点按钮之前，先把入口页和它引用的资源拉进内存缓存。
+ * 这样 iframe 真正启动时，界面框架的那几十个请求全部命中本地缓存。
+ */
+function prewarm(state, cfg) {
+  if (state.warming) return state.warming
+  state.warming = (async () => {
+    const started = Date.now()
+    const report = { ok: false, assets: 0, fetched: 0, bytes: 0, ms: 0, at: Date.now(), error: '' }
+    try {
+      await ensureSession(state, cfg)
+      const entry = await fetchThrough(state, ENTRY_PATH)
+      if (entry.status !== 200) throw new Error(`入口页 HTTP ${entry.status}`)
+      cacheSet(state, ENTRY_PATH, 'text/html; charset=utf-8', entry.body)
+      report.bytes += entry.body.length
+      const list = extractAssets(entry.body.toString('utf8')).slice(0, 32)
+      report.assets = list.length
+      let cursor = 0
+      const worker = async () => {
+        while (cursor < list.length) {
+          const item = list[cursor++]
+          if (cacheGet(state, item)) {
+            report.fetched += 1
+            continue
+          }
+          try {
+            const got = await fetchThrough(state, item)
+            if (got.status === 200) {
+              cacheSet(state, item, got.type, got.body)
+              report.bytes += got.body.length
+              report.fetched += 1
+            }
+          } catch {}
+        }
+      }
+      await Promise.all([worker(), worker(), worker(), worker()])
+      report.ok = true
+    } catch (error) {
+      report.error = error?.message ?? String(error)
+      state.lastError = report.error
+    } finally {
+      report.ms = Date.now() - started
+      state.warm = report
+      state.warming = null
+    }
+  })()
+  return state.warming
+}
+
 const HOP_BY_HOP = new Set([
   'connection',
   'keep-alive',
@@ -347,6 +482,76 @@ function upstreamPath(rawUrl) {
   return `${pathname}${url.search}`
 }
 
+/** 只有静态资源进缓存：带内容哈希，路径一变就是新文件，不存在脏读。 */
+function cacheableKey(req) {
+  if (req.method !== 'GET' && req.method !== 'HEAD') return ''
+  let pathname = '/'
+  try {
+    pathname = new URL(req.url || '/', 'http://placeholder.invalid').pathname || '/'
+  } catch {
+    return ''
+  }
+  if (pathname === '/') return ENTRY_PATH
+  if (pathname.startsWith('/assets/')) return pathname
+  if (pathname.startsWith('/plugins/')) return pathname
+  return ''
+}
+
+function cacheGet(state, key) {
+  const hit = state.cache.get(key)
+  if (!hit) return null
+  if (key === ENTRY_PATH && Date.now() - hit.at > ENTRY_TTL_MS) {
+    state.cache.delete(key)
+    state.cacheBytes -= hit.body.length
+    return null
+  }
+  // LRU：命中就挪到末尾
+  state.cache.delete(key)
+  state.cache.set(key, hit)
+  return hit
+}
+
+function cacheSet(state, key, type, body) {
+  if (!body || body.length === 0 || body.length > MAX_CACHE_ENTRY) return
+  const old = state.cache.get(key)
+  if (old) {
+    state.cache.delete(key)
+    state.cacheBytes -= old.body.length
+  }
+  state.cache.set(key, { type: type || 'application/octet-stream', body, at: Date.now() })
+  state.cacheBytes += body.length
+  while (state.cacheBytes > MAX_CACHE_BYTES && state.cache.size > 1) {
+    const [oldestKey, oldest] = state.cache.entries().next().value
+    state.cache.delete(oldestKey)
+    state.cacheBytes -= oldest.body.length
+  }
+}
+
+/**
+ * 手机上的排版修补：直接注入 iframe 里那份文档。
+ * iframe 与外层不同源（端口不同），外层改不了它的 DOM，只能在代理这一层注入；
+ * 全部规则都在 `(max-width: 1023px) and (pointer: coarse)` 里，桌面上完全无副作用。
+ */
+const MOBILE_CSS = `@media (max-width: 1023px) and (pointer: coarse) {
+  html { -webkit-text-size-adjust: 100%; }
+  body { overflow-x: hidden; }
+  button, [role="button"], [role="tab"], [role="menuitem"], [role="option"] { min-height: 40px; min-width: 40px; }
+  input, select, textarea { min-height: 40px; font-size: 16px; }
+  [class*="drawer"], aside { max-width: 88vw; }
+  table { display: block; overflow-x: auto; }
+  textarea { padding-bottom: max(10px, env(safe-area-inset-bottom)); }
+}`
+
+/** 给 iframe 里的文档报进度用；只 postMessage，不碰 DOM。 */
+const PROGRESS_SCRIPT = `<script id="dsh-embed-progress">(function(){var send=function(t){try{parent.postMessage({source:'dsh-embed',type:t},'*')}catch(e){}};send('dom');addEventListener('load',function(){send('load')});var n=0,t=setInterval(function(){if(window.__DSH_BOOT_READY__){send('boot');clearInterval(t)}if(++n>480)clearInterval(t)},250)})()<\/script>`
+
+function injectIntoHtml(html) {
+  const style = `<style id="dsh-embed-mobile">${MOBILE_CSS}</style>`
+  let out = html.includes('</head>') ? html.replace('</head>', `${style}</head>`) : style + html
+  out = out.includes('</body>') ? out.replace('</body>', `${PROGRESS_SCRIPT}</body>`) : out + PROGRESS_SCRIPT
+  return out
+}
+
 /**
  * 通用反向代理：路径、方法、请求体、响应体一律原样转发，cookie 服务端注入。
  * 上游 401 时重铸一次再重试（设备会话过期 / cookie 被顶掉的常见情形）。
@@ -363,16 +568,60 @@ function proxyOnce(state, clientReq, clientRes, retried = false) {
   if (target.origin !== state.relay) {
     return sendHtml(clientRes, 400, page('地址不对', '<p>只代理同一个中继。</p>'))
   }
+  const cacheKey = cacheableKey(clientReq)
+  if (cacheKey) {
+    const hit = cacheGet(state, cacheKey)
+    if (hit) {
+      // 入口页命中也要补注入（缓存里存的是原始 HTML），
+      // 注入后长度会变，content-length 必须按最终 body 算，否则响应会被截断。
+      const body = cacheKey === ENTRY_PATH ? Buffer.from(injectIntoHtml(hit.body.toString('utf8'))) : hit.body
+      clientRes.writeHead(200, {
+        'content-type': hit.type,
+        'content-length': String(body.length),
+        'cache-control': cacheKey === ENTRY_PATH ? 'no-cache' : 'public, max-age=31536000, immutable',
+        'x-dsh-embed-cache': 'hit',
+      })
+      clientRes.end(body)
+      return
+    }
+    // 预热和真实请求撞在一起时只发一次上游请求
+    const pending = state.inflight.get(cacheKey)
+    if (pending) {
+      pending
+        .catch(() => {})
+        .then(() => proxyOnce(state, clientReq, clientRes, retried))
+      return
+    }
+  }
+
   const mod = target.protocol === 'https:' ? httpsRequest : httpRequest
+  const wanted = upstreamPath(clientReq.url)
   const upstream = mod({
     protocol: target.protocol,
     hostname: target.hostname,
     port: target.port || undefined,
     method: clientReq.method,
-    path: upstreamPath(clientReq.url),
+    path: wanted,
     headers: upstreamHeaders(clientReq.headers, state.cookie, target.host),
-    agent: false,
+    agent: agentFor(target),
   })
+  if (cacheKey) {
+    let settle
+    const done = new Promise((r) => {
+      settle = r
+    })
+    state.inflight.set(cacheKey, done)
+    const clear = () => {
+      if (state.inflight.get(cacheKey) === done) state.inflight.delete(cacheKey)
+      settle()
+    }
+    upstream.on('close', clear)
+    upstream.on('error', clear)
+    upstream.on('response', (up) => {
+      up.on('end', clear)
+      up.on('error', clear)
+    })
+  }
   upstream.on('response', (up) => {
     if (up.statusCode === 401 && !retried && state.canRemint) {
       up.resume()
@@ -381,10 +630,71 @@ function proxyOnce(state, clientReq, clientRes, retried = false) {
         .then(() => proxyOnce(state, clientReq, clientRes, true))
         .catch((error) => proxyOnce(state, clientReq, clientRes, true) ?? sendHtml(clientRes, 502, page('上游失败', `<p>${escapeHtml(error?.message)}</p>`)))
     }
+    const type = String(up.headers['content-type'] || '')
+    const status = up.statusCode ?? 502
+
+    // 入口页：缓冲下来做两件事——写进缓存、注入手机排版与进度脚本
+    if (status === 200 && type.includes('text/html') && (cacheKey === ENTRY_PATH || wanted === ENTRY_PATH)) {
+      const chunks = []
+      up.on('data', (chunk) => chunks.push(chunk))
+      up.on('end', () => {
+        const raw = Buffer.concat(chunks)
+        cacheSet(state, ENTRY_PATH, 'text/html; charset=utf-8', raw)
+        const body = Buffer.from(injectIntoHtml(raw.toString('utf8')))
+        const headers = downstreamHeaders(up.headers, state.relay)
+        headers['content-type'] = 'text/html; charset=utf-8'
+        headers['content-length'] = String(body.length)
+        headers['cache-control'] = 'no-cache'
+        headers['x-dsh-embed-injected'] = 'mobile'
+        clientRes.writeHead(200, headers)
+        clientRes.end(body)
+      })
+      up.on('error', () => {
+        if (!clientRes.headersSent) sendHtml(clientRes, 502, page('上游失败', '<p>入口页读取中断。</p>'))
+        else clientRes.destroy()
+      })
+      return
+    }
+
+    // 静态资源：边转发边存，超过上限就放弃缓存但照常转发
+    if (status === 200 && cacheKey && !type.includes('text/html')) {
+      const chunks = []
+      let size = 0
+      let streaming = false
+      up.on('data', (chunk) => {
+        if (streaming) return
+        chunks.push(chunk)
+        size += chunk.length
+        if (size > MAX_CACHE_ENTRY) {
+          streaming = true
+          const headers = downstreamHeaders(up.headers, state.relay)
+          clientRes.writeHead(status, headers)
+          clientRes.write(Buffer.concat(chunks))
+          chunks.length = 0
+        }
+      })
+      up.on('end', () => {
+        if (streaming) {
+          clientRes.end()
+          return
+        }
+        const body = Buffer.concat(chunks)
+        cacheSet(state, cacheKey, type || 'application/octet-stream', body)
+        const headers = downstreamHeaders(up.headers, state.relay)
+        headers['content-length'] = String(body.length)
+        headers['cache-control'] = 'public, max-age=31536000, immutable'
+        headers['x-dsh-embed-cache'] = 'miss'
+        clientRes.writeHead(status, headers)
+        clientRes.end(body)
+      })
+      up.on('error', () => clientRes.destroy())
+      return
+    }
+
     const headers = downstreamHeaders(up.headers, state.relay)
     const location = rewriteLocation(up.headers.location, state.relay)
     if (location) headers.location = location
-    clientRes.writeHead(up.statusCode ?? 502, headers)
+    clientRes.writeHead(status, headers)
     up.pipe(clientRes)
   })
   upstream.on('error', (error) => {
@@ -417,7 +727,7 @@ function proxyUpgrade(state, req, socket, head) {
     method: 'GET',
     path: upstreamPath(req.url),
     headers,
-    agent: false,
+    agent: agentFor(target),
   })
   upstream.on('upgrade', (up, upSocket, upHead) => {
     const lines = [`HTTP/1.1 101 ${up.statusMessage || 'Switching Protocols'}`]
@@ -477,20 +787,73 @@ function page(title, body, extraHead = '') {
 </style>${extraHead}</head><body><main>${body}</main></body></html>`
 }
 
-/** iframe 外壳：整页只有一个 iframe，唯一的外壳元素是一个小齿轮。 */
+/** iframe 外壳：iframe + 一层加载进度（纯 CSS 动画，界面一就绪就淡出）。 */
 function embedPage(state, port) {
   const src = `http://127.0.0.1:${port}/`
+  const origin = `http://127.0.0.1:${port}`
+  const warm = state.warm?.ok ? `<span id="dsh-embed-warm">已预热 ${state.warm.fetched}/${state.warm.assets}</span>` : ''
+  const overlay = `<div id="dsh-embed-cover">
+  <div class="ring"></div>
+  <b>正在打开桌面版</b>
+  <p id="dsh-embed-step">正在建立配对…</p>
+  <span id="dsh-embed-time">0s</span>
+  ${warm}
+  <a href="/embed/setup">设置</a>
+</div>`
+  const script = `<script>(function(){
+  var cover=document.getElementById('dsh-embed-cover')
+  var step=document.getElementById('dsh-embed-step')
+  var clock=document.getElementById('dsh-embed-time')
+  var frame=document.getElementById('dsh-embed-frame')
+  var t0=Date.now(), hints=[[0,'正在建立配对…'],[6,'正在下载界面资源（第一次最慢）…'],[20,'正在启动界面插件…'],[45,'中继这条路有点慢，还在下载…']]
+  var timer=setInterval(function(){
+    var s=Math.round((Date.now()-t0)/1000)
+    clock.textContent=s+'s'
+    var pick=0
+    for(var i=0;i<hints.length;i++){ if(s>=hints[i][0]) pick=i }
+    if(step.textContent!==hints[pick][1]) step.textContent=hints[pick][1]
+  },500)
+  function done(){
+    if(!cover||cover.dataset.done) return
+    cover.dataset.done='1'
+    window.__DSH_EMBED_READY_MS__=Math.round(performance.now())
+    clearInterval(timer)
+    cover.style.opacity='0'; cover.style.pointerEvents='none'
+    setTimeout(function(){ if(cover&&cover.parentNode) cover.parentNode.removeChild(cover) },500)
+  }
+  window.addEventListener('message',function(e){
+    if(e.origin!=='${origin}') return
+    var d=e.data
+    if(d&&d.source==='dsh-embed'&&(d.type==='load'||d.type==='boot')) done()
+  })
+  frame.addEventListener('load',function(){ setTimeout(done,600) })
+  setTimeout(function(){ if(cover&&!cover.dataset.done) step.textContent='还没回来：确认电脑上 bridge.py 在跑，或回设置页重填地址。' },180000)
+})()<\/script>`
   return page(
     '桌面版 DSH',
-    `<iframe src="${escapeHtml(src)}" title="桌面版 DSH"
+    `<iframe id="dsh-embed-frame" src="${escapeHtml(src)}" title="桌面版 DSH"
        allow="clipboard-read; clipboard-write; microphone; camera"
        style="position:fixed;inset:0;width:100%;height:100%;border:0;background:#fff"></iframe>
+     ${overlay}
      <a href="/embed/setup" title="中转与端口设置"
         style="position:fixed;right:10px;bottom:calc(10px + env(safe-area-inset-bottom));z-index:2147483000;
                width:40px;height:40px;border-radius:20px;background:rgba(0,0,0,.45);color:#fff;
                display:flex;align-items:center;justify-content:center;text-decoration:none;
-               font:18px/1 system-ui">⚙</a>`,
-    '<style>body{margin:0;padding:0;overflow:hidden}</style>',
+               font:18px/1 system-ui">⚙</a>
+     ${script}`,
+    `<style>
+  body{margin:0;padding:0;overflow:hidden}
+  #dsh-embed-cover{position:fixed;inset:0;z-index:2147483600;background:#0f1115;color:#e8e8ea;
+    display:flex;flex-direction:column;align-items:center;justify-content:center;gap:10px;
+    font:15px/1.6 system-ui,-apple-system,"Segoe UI",sans-serif;transition:opacity .4s}
+  #dsh-embed-cover b{font-size:17px;font-weight:600}
+  #dsh-embed-cover p{margin:0;color:#9aa0a6;font-size:14px;max-width:80vw;text-align:center}
+  #dsh-embed-cover span{color:#6b7280;font-size:13px}
+  #dsh-embed-cover a{color:#7aa2ff;font-size:14px;text-decoration:none;margin-top:4px}
+  .ring{width:38px;height:38px;border-radius:50%;border:3px solid rgba(255,255,255,.15);
+    border-top-color:#7aa2ff;animation:dsh-embed-spin 1s linear infinite}
+  @keyframes dsh-embed-spin{to{transform:rotate(360deg)}}
+</style>`,
   )
 }
 
@@ -553,6 +916,10 @@ async function apply(ctx, rawConfig) {
   state.remint = () => ensureSession(state, cfgOf())
   state.canRemint = true
 
+  // 配置里已经有中转地址就先把配对拿好、把资源预热好。
+  // 既修掉「重启 DSHA 后不重填设置就打不开」，也让用户点按钮时资源已经在内存里。
+  if (cfgOf().bridgeUrl) void prewarm(state, cfgOf())
+
   // ---- 回环代理 -----------------------------------------------------------
   const proxy = createServer((req, res) => {
     if (!gateOk(state, req)) {
@@ -631,6 +998,7 @@ async function apply(ctx, rawConfig) {
       } catch (error) {
         return sendHtml(res, 502, setupPage(state, next, `配对失败：${error?.message ?? error}`))
       }
+      void prewarm(state, next)
       res.writeHead(303, { location: EMBED_PATH, 'cache-control': 'no-store' })
       res.end()
     },
@@ -655,6 +1023,12 @@ async function apply(ctx, rawConfig) {
         bridgeUrl: live.bridgeUrl,
         configPath: configPath(),
         embedPath: EMBED_PATH,
+        cache: {
+          entries: state.cache.size,
+          bytes: state.cacheBytes,
+          budget: MAX_CACHE_BYTES,
+        },
+        warm: state.warm,
       })
     },
   })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-desktop-embed",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Embed the desktop DSH UI inside DSHA's WebView instead of handing it to the system browser: a loopback reverse proxy on the phone plus an iframe shell page.",
   "type": "module",
   "license": "MIT",