dsh-pocket 1.7.4 → 1.7.5

package/README.en.md

@@ -91,6 +91,11 @@ On the same page click "**Enable anywhere**" → wait for the tunnel (first run
 - LAN mode exposes nothing publicly; only devices on the same network can reach it.
 - Built for personal use; the PIN lives in `$DSH_HOME/dsh-pocket/token` and is re-rolled by restarting the public tunnel.
 
+## 💻 DSH Desktop
+
+- In the desktop app, **QR screen-mirroring works**; **update/restart are managed by the desktop app** (auto-disabled here).
+- ⚠️ The desktop **advanced mode** doesn't support phone access yet (it disables the web layout; the phone gets no layout service → blank screen). Switch back to **compatibility** mode and restart; phones opening an advanced-mode page will see a clear notice overlay.
+
 ## 🩹 Troubleshooting (traps users step on)
 
 | Symptom | Cause & fix |

package/README.md

@@ -91,6 +91,11 @@ npx @deepseek-ai/dsh web
 - 局域网模式不暴露公网，只有同一网络内的设备能访问
 - 适合个人自用；密码存本机 `$DSH_HOME/dsh-pocket/token`，可随时重开公网换新
 
+## 💻 DSH Desktop（桌面版）
+
+- 桌面版里 dsh-pocket 的**扫码同屏**正常可用；**更新/重启由桌面版管理**（插件内这两项自动停用）
+- ⚠️ 桌面端 **advanced 模式**暂不支持手机访问（该模式禁用网页布局、手机拿不到 layout 服务，会白屏）——请切回 **compatibility** 模式后重启；advanced 模式下手机打开会看到明确的提示层
+
 ## 🩹 常见问题（别踩的坑）
 
 | 现象 | 原因与解决 |

package/lib/index.js

@@ -19,7 +19,7 @@ import { homedir } from 'node:os';
 import { createPocketService } from './service.mjs';
 import { installPocketRpc } from './web-rpc.js';
 import { restartHost } from './restart.js';
-import { desktopEnvPatchScript, DEFAULT_INJECT } from './proxy.mjs';
+import { desktopEnvPatchScript, advancedNoticeScript, DEFAULT_INJECT } from './proxy.mjs';
 
 const name = 'dsh-pocket';
 const inject = ['connection', 'webServer'];
@@ -152,6 +152,19 @@ export function apply(ctx, config = {}, internals = {}) {
     logger.info('dsh-pocket: DSH Desktop detected — update/restart disabled here | 检测到桌面端环境，更新/重启已关闭');
   }
 
+  // 桌面端 advanced 模式检测（issue #19）：dsh-plugin-desktop 的 mode 配置存在
+  // $DSH_HOME/settings.yaml 的 dsh-plugin-desktop 命名空间下。advanced 组合禁用网页版
+  // ui-layout、手机页面又拿不到桌面 layout → 手机访问白屏，这里注入覆盖层提示用户切回。
+  const desktopAdvanced = isDesktop && (() => {
+    try {
+      const raw = readFileSync(join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'settings.yaml'), 'utf8');
+      return /dsh-plugin-desktop\s*:\s*[\s\S]{0,300}?mode\s*:\s*advanced/i.test(raw);
+    } catch { return false; }
+  })();
+  if (desktopAdvanced) {
+    logger.warn('dsh-pocket: DSH Desktop advanced mode — phone access unsupported, injecting notice | 桌面端 advanced 模式：手机访问暂不支持，已注入提示');
+  }
+
   const service = internals.service ?? createPocketService({
     dshPort,
     port: internals.port ?? config.port ?? 3081,
@@ -160,7 +173,10 @@ export function apply(ctx, config = {}, internals = {}) {
     // 桌面端：手机扫码访问的页面缺 dsh-desktop-mode/platform 参数会让 dsh-plugin-desktop
     // client 崩溃（issue #3/#4）。给代理注入「桌面参数补丁」（history.replaceState 补齐参数，
     // 无跳转；compatibility 模式不套桌面布局，避免移动端按钮叠加）。保留默认 polyfill。
-    injectHtml: isDesktop ? DEFAULT_INJECT + desktopEnvPatchScript(process.platform) : undefined,
+    // advanced 模式再加警告覆盖层（issue #19）。
+    injectHtml: isDesktop
+      ? DEFAULT_INJECT + desktopEnvPatchScript(process.platform) + (desktopAdvanced ? advancedNoticeScript() : '')
+      : undefined,
     // 公网访问密码（issue #13）：仅公网隧道 Host 强制；局域网免密码
     auth: {
       getToken: () => getAccessToken(),

package/lib/proxy.mjs

@@ -52,6 +52,16 @@ function isCompressed(headers) {
 /** 默认注入到经代理的 HTML 文档里：crypto.randomUUID polyfill（非安全上下文必需）。 */
 export const DEFAULT_INJECT = RANDOM_UUID_POLYFILL;
 
+/**
+ * DSH Desktop advanced 模式不支持的提示覆盖层（issue #19）。
+ * advanced 组合会禁用网页版 ui-layout，而桌面 layout 只在 advanced client 提供——
+ * 手机页面被注入 compatibility 后无任何 layout 服务 → 启动白屏（Failed to load plugins）。
+ * 该脚本在页面上叠加一个固定警告层，让用户明确知道原因（而不是无解白屏）。
+ */
+export function advancedNoticeScript() {
+  return `<script data-dsh-pocket-advanced-notice="1">!function(){try{var d=document.createElement('div');d.style.cssText='position:fixed;inset:0;z-index:2147483647;display:flex;align-items:center;justify-content:center;background:rgba(0,0,0,.55);color:#fff;font:15px/1.7 -apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif;text-align:center;padding:24px';d.textContent='DSH 桌面端处于 advanced 模式，手机访问暂不支持。请在桌面端设置中切回 compatibility 模式后重启。| DSH Desktop is in advanced mode — phone access is not supported yet. Switch back to compatibility in the desktop app and restart.';document.documentElement.appendChild(d);}catch(e){}}();</script>`;
+}
+
 // ---------- 可选访问令牌认证（issue #13） ----------
 // 只对公网隧道 Host（trycloudflare.com）强制；局域网免密码。
 // 登录成功后种 HttpOnly 会话 cookie（浏览器关闭失效）→ SPA 内部 API/WS 自动携带。

package/package.json

@@ -76,5 +76,5 @@
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "version": "1.7.4"
+  "version": "1.7.5"
 }