dsh-mesh-access 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # 更新日志
 
+## 1.0.3 — 静态资源长缓存（给慢链路减负）
+
+上游返回的 `/assets/*.js|css` **没有** `cache-control`，也没有 `etag` / `last-modified`，浏览器无法判断新鲜度，重载时只能整套重新下载（一套 1.5–3 MB）。在组网这种 250 KB/s、往返 500 ms 的链路上，一次重连就等于重传一遍，越重连越慢、越慢越容易再断。
+
+- 反代对 `/assets/<带哈希>.(js|css|woff2|png|svg|webp)` 补上 `cache-control: public, max-age=31536000, immutable`；
+- 文件名本身带内容哈希，所以长缓存是安全的（换版本 = 换文件名）。
+
+## 1.0.2 — 把卖点改成「手机远程控制」
+
+功能没变，只是把话说对：这东西最主要的用法是**用手机远程控制电脑上的 DSH**（同一个实例、同一份会话），
+「笔记本 / NAS / 电视盒子也能开」降级成附加卖点。
+
+- README 中英开头改成手机优先；
+- npm 描述、市场条目中英描述同步；
+- 面板副标题改成「用手机远程控制：手机浏览器打开就是你在电脑上用的那个 DSH」。
+
 ## 1.0.1 — 修「一直重新连接中」
 
 `Origin` 没有跟着 `Host` 一起改写，DSH 的 WebSocket 升级被自己的同源校验挡成 **403**，

package/README.en.md

@@ -1,7 +1,11 @@
 # dsh-mesh-access
 
-Expose the **running** DeepSeek Harness web UI on a mesh/VPN interface — from inside the server,
-without a second instance, without SSH, without touching the router.
+**Control your DSH from your phone.** Open the address in a phone browser and you get the very
+same UI you are using on the desktop — same instance, same session list, same context. No SSH,
+no second `dsh`, no router to touch.
+
+Under the hood it mounts the running DeepSeek Harness web UI onto a mesh/VPN interface, from
+inside the server process.
 
 [English](#what-it-does) | [中文](README.md)
 

package/README.md

@@ -1,7 +1,9 @@
 # dsh-mesh-access
 
-把**正在运行**的 DeepSeek Harness 网页界面挂到组网网卡上 —— 在服务进程内部完成，
-不需要第二个实例，不需要 SSH，也不用碰路由器。
+**用手机远程控制电脑上的 DSH。** 手机浏览器打开，就是你在电脑上正在用的那个界面 ——
+同一个实例、同一份会话、同一份上下文，不需要 SSH，不需要第二个 `dsh`，也不用碰路由器。
+
+底层做法是把正在运行的 DeepSeek Harness 网页界面挂到组网网卡上，在服务进程内部完成。
 
 [中文](#它做什么) | [English](README.en.md)
 
@@ -130,3 +132,30 @@ curl -s http://127.0.0.1:3080/api/dsh-mesh-access/status
 ## 许可
 
 MIT。
+
+## 常见问题
+
+**页面能打开、侧边栏也有，但底部一直「重新连接中…」，工作区列表空着**
+
+这是 1.0.0 的 bug，升级到 **1.0.1** 即可。原因：反代把 `Host` 改写成上游（`127.0.0.1:3080`）却没改 `Origin`，DSH 对 WebSocket 升级做同源校验，浏览器带着 `Origin: http://<组网IP>:<端口>` 过来，两边不一致 → 上游直接 `403 Forbidden`。于是普通 HTTP 全通（页面能开、API 能查），实时通道一次都没握上手，浏览器每几秒重试一次，看起来就像“网络一直断”。
+
+自查一行就够：
+
+```bash
+curl -s -o /dev/null -w '%{http_code}\n' --http1.1 \
+  -H 'Connection: Upgrade' -H 'Upgrade: websocket' \
+  -H 'Sec-WebSocket-Version: 13' -H 'Sec-WebSocket-Key: dGhlIHNhbXBsZSBub25jZQ==' \
+  -H "Origin: http://<组网IP>:<端口>" \
+  -b <你浏览器的 cookie> \
+  http://<组网IP>:<端口>/api/remote.mux
+```
+
+`101` 是正常，`403` 就是中了这个 bug。
+
+**改了端口或组网 IP，面板上的地址还能用吗**
+
+不能。反代一开出来，监听地址和上游端口就固定了；「访问地址」里的 token 也是按当时的地址签的。换了就点「关闭」→「在组网地址上开端口」，重新复制地址。
+
+**组网里的设备打开地址却超时**
+
+先确认那台设备能路由到组网 IP（`ping <组网IP>`），再确认本机防火墙放行该端口。Linux 上 `firewall-cmd --zone=<组网域> --list-ports`，Windows 上查该端口的入站规则。

package/lib/client.js

@@ -140,7 +140,7 @@ window.__ModuleLoader__.load({
         'div',
         { style: S.wrap },
         h('div', { style: S.h1 }, '组网访问'),
-        h('div', { style: S.sub }, '把当前这个 DSH 实例搬到组网网卡上，组网内任意设备直接打开，不用第二个实例、不用 SSH。'),
+        h('div', { style: S.sub }, '用手机远程控制：手机浏览器打开就是你在电脑上用的那个 DSH——同一实例、同一份会话，不用第二个实例，不用 SSH。'),
 
         h(
           Card, { title: '当前状态' },

package/lib/index.js

@@ -88,6 +88,9 @@ function createProxy({ listenAddress, listenPort, upstream, upstreamPort }) {
   // 上游地址，就必须把 Origin 一起改写成上游的 origin；否则浏览器的 WebSocket 升级
   // 永远 403，界面上表现成「一直重新连接中」。
   const upstreamOrigin = `http://${target}`
+  // 带内容哈希的静态资源（/assets/index-BXV-oxvX.js 这种）
+  const CACHEABLE = /\/assets\/[^?]+\.(?:js|css|woff2?|png|svg|webp)$/
+
   const rewrite = (headers) => {
     const h = { ...headers }
     const incomingHost = headers.host ?? ''
@@ -102,7 +105,13 @@ function createProxy({ listenAddress, listenPort, upstream, upstreamPort }) {
     const up = http.request(
       { host: upstream, port: upstreamPort, method: req.method, path: req.url, headers: rewrite(req.headers) },
       (r) => {
-        res.writeHead(r.statusCode ?? 502, r.headers)
+        const headers = { ...r.headers }
+        // 前端资源文件名带内容哈希，可以放心长缓存。上游没给 cache-control / etag，
+        // 浏览器就只能每次重新下载（一套 1.5–3 MB），在组网这种慢链路上等于每次重连都重传一遍。
+        if (r.statusCode === 200 && CACHEABLE.test(req.url || '')) {
+          headers['cache-control'] = 'public, max-age=31536000, immutable'
+        }
+        res.writeHead(r.statusCode ?? 502, headers)
         r.pipe(res)
       },
     )

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-mesh-access",
-  "version": "1.0.1",
-  "description": "Expose the DSH web UI on a mesh/VPN interface (StarVPN, Tailscale, WireGuard tun) from inside the running server: in-process reverse proxy + status panel, so any device on the mesh — phone, laptop, NAS — opens it in a browser. No second instance.",
+  "version": "1.0.3",
+  "description": "Control your DSH from your phone: opens a port on the mesh/VPN interface from inside the running server process, so a phone browser gets the same instance and the same session list — no SSH, no second dsh. Also reachable from another PC, a GUI NAS, or a TV box.",
   "type": "module",
   "main": "lib/index.js",
   "exports": {