@mrrisega/dsh-remote 0.6.7 → 0.6.9-beta.1

package/README.md

@@ -60,7 +60,7 @@ dsh-remote 是一个轻量的**隧道模式**远程控制方案：电脑端运
 
 - **登录后 bridge 自动连上，全程零刷新**：面板自动补运行环境 → 拉起 bridge → 显示「正在连接中继…」，连上后自动变成「已连接 ✅」并刷新二维码与设备列表；失败有可读原因、自动重试倒计时和「复制诊断信息」。
 - **手机端自动等待电脑上线**：空设备列表不再让人干等或手动刷新，电脑一上线设备自己出现。
-- **安装引导改版**：有插件市场入口就搜索 `dsh-remote` 安装（不用敲命令）；没有就复制一条命令；两条路都收敛到「登录后稍等，电脑会自己出现」。
+- **安装引导改版**：有插件市场入口就在市场里搜索 **`dsh-remote-web`** 安装（不用敲命令；搜索词是包名 `dsh-remote-web`，不是 `dsh-remote`）；没有就复制一条命令；两条路都收敛到「登录后稍等，电脑会自己出现」。
 - **安装输出更干净**：不再重复打印同一段引导，结尾只给一份汇总（地址 / 自启动服务 / 下一步）；装完当下 dsh web 没开着也会如实说明「打开 dsh web 后 bridge 会自动启动」，不再像报错。
 - **macOS 26 自启动死角已修**：macOS 26 会把 `gui/<uid>` 会话域置为 on-demand-only，`RunAtLoad` / `KeepAlive` 失效（服务只登记不启动，`runs = 0`）。现在优先用 `user/<uid>` 域启动（该域仍支持开机自启与崩溃自愈），失败才回退 `gui/<uid>` + `kickstart`（只拉起这一次，会**明确告知**不支持崩溃自愈），再不行退化为后台进程（现在能用、无自启）。自启动服务的 PATH 也补了 `/usr/sbin`、`/sbin`（bridge 要调 `ioreg`）。
 

package/clients/dsh-remote/mobile-adapter.mjs

@@ -259,8 +259,9 @@ html[data-dsh-ma-fs="3"] { --dsh-ma-fs-scale: 1.32; -webkit-text-size-adjust: 13
    用户至少还能从这里"返回设备列表"自救(这是 2026-09-19 死局的兜底出口)。 */
 button.dsh-ma-fab {
   position: fixed;
-  right: max(10px, env(safe-area-inset-right));
-  bottom: calc(16px + env(safe-area-inset-bottom));
+  /* 位置由 JS 计算后写 inline left/top（默认右上角，可拖动；见 SCRIPT 里的 fabPos）；
+     CSS 只给尺寸/层级/指针语义 —— 用 left/top 而不是 right/bottom，拖动才不会被"贴边"钉住。 */
+  left: auto; top: auto; right: 10px; bottom: auto;
   z-index: 400;
   width: 46px; height: 46px; padding: 0;
   display: flex; align-items: center; justify-content: center;
@@ -270,10 +271,12 @@ button.dsh-ma-fab {
   border: .5px solid var(--dsw-alias-border-l3, rgba(127,127,127,.3));
   box-shadow: 0 2px 12px rgba(0,0,0,.2);
   color: var(--dsw-alias-label-primary, #111);
-  cursor: pointer; touch-action: manipulation;
+  cursor: grab; touch-action: none; /* 触屏拖动不被页面滚动抢走 */
+  user-select: none; -webkit-user-select: none;
   -webkit-tap-highlight-color: transparent;
 }
 button.dsh-ma-fab:active { transform: scale(.94); }
+button.dsh-ma-fab.dsh-ma-fab-dragging { cursor: grabbing; transform: scale(1.06); }
 button.dsh-ma-fab .dsh-ma-fab-lock {
   position: absolute; top: -3px; right: -3px;
   font-size: 12px; line-height: 1; padding: 2px 3px; border-radius: 999px;
@@ -283,6 +286,7 @@ button.dsh-ma-fab .dsh-ma-fab-lock {
 /* 菜单卡片:fixed 贴右下，最大高度受限可滚动 */
 div.dsh-ma-menu {
   position: fixed;
+  /* 打开时按悬浮按钮的位置重算（按钮在上半屏→菜单挂下方；靠左→左对齐），见 placeMenu() */
   right: max(10px, env(safe-area-inset-right));
   bottom: calc(70px + env(safe-area-inset-bottom));
   z-index: 401;
@@ -688,11 +692,64 @@ const SCRIPT = `(() => {
         '<div class="dsh-ma-menu-note">返回后可重新选择设备；端到端加密需在设备列表页重新解锁（会话密钥只存在本机内存里，刷新即失效）。</div>';
       document.body.appendChild(menu);
 
+      /* ---- 悬浮按钮的位置：默认**右上角**（原来在右下角，正好压住输入框的发送按钮）；
+              可拖动，位置按"最近的角 + 距边偏移"记忆 —— 旋转屏幕/换窗口宽度都不会跑到屏幕外。 ---- */
+      const FAB_KEY = "dsh-ma-fab-pos";
+      const FAB_SIZE = 46, FAB_EDGE = 10;
+      const readFabPos = () => {
+        try {
+          const raw = window.localStorage && window.localStorage.getItem(FAB_KEY);
+          const p = raw ? JSON.parse(raw) : null;
+          if (p && (p.h === "left" || p.h === "right") && (p.v === "top" || p.v === "bottom")
+            && typeof p.dx === "number" && typeof p.dy === "number") return p;
+        } catch (e) { /* 忽略 */ }
+        return null;
+      };
+      const defaultFabPos = () => ({ h: "right", v: "top", dx: FAB_EDGE, dy: FAB_EDGE });
+      let fabPos = readFabPos() || defaultFabPos();
+      const fabXY = (pos) => {
+        const vw = window.innerWidth || 360, vh = window.innerHeight || 640;
+        return {
+          left: pos.h === "left" ? pos.dx : vw - FAB_SIZE - pos.dx,
+          top: pos.v === "top" ? pos.dy : vh - FAB_SIZE - pos.dy,
+        };
+      };
+      const clampFabXY = (xy) => {
+        const vw = window.innerWidth || 360, vh = window.innerHeight || 640;
+        return {
+          left: Math.max(4, Math.min(xy.left, vw - FAB_SIZE - 4)),
+          top: Math.max(4, Math.min(xy.top, vh - FAB_SIZE - 4)),
+        };
+      };
+      const applyFabPos = () => {
+        const xy = clampFabXY(fabXY(fabPos));
+        fab.style.left = Math.round(xy.left) + "px";
+        fab.style.top = Math.round(xy.top) + "px";
+        return xy;
+      };
+      const saveFabPos = () => {
+        try { window.localStorage && window.localStorage.setItem(FAB_KEY, JSON.stringify(fabPos)); } catch (e) { /* 忽略 */ }
+      };
+      /** 拖动落点 → "最近的角 + 偏移"（保留用户的意图，同时保证换尺寸后仍在屏内）。 */
+      const fabPosFromXY = (xy) => {
+        const vw = window.innerWidth || 360, vh = window.innerHeight || 640;
+        const h = xy.left + FAB_SIZE / 2 < vw / 2 ? "left" : "right";
+        const v = xy.top + FAB_SIZE / 2 < vh / 2 ? "top" : "bottom";
+        return {
+          h: h, v: v,
+          dx: h === "left" ? Math.max(0, xy.left) : Math.max(0, vw - FAB_SIZE - xy.left),
+          dy: v === "top" ? Math.max(0, xy.top) : Math.max(0, vh - FAB_SIZE - xy.top),
+        };
+      };
+
       const fab = document.createElement("button");
       fab.type = "button";
       fab.className = "dsh-ma-fab";
-      fab.setAttribute("aria-label", "远程控制菜单");
+      fab.setAttribute("aria-label", "远程控制菜单（可拖动）");
+      fab.title = "远程控制：字号 / 加密状态 / 返回设备列表（可拖动移动位置）";
       fab.innerHTML = '<span class="dsh-ma-fab-ico">字</span><span class="dsh-ma-fab-lock" data-role="lock">🔒</span>';
+      fab.style.left = Math.round(clampFabXY(fabXY(fabPos)).left) + "px";
+      fab.style.top = Math.round(clampFabXY(fabXY(fabPos)).top) + "px";
       document.body.appendChild(fab);
 
       const fsRange = menu.querySelector('input[type="range"]');
@@ -743,13 +800,80 @@ const SCRIPT = `(() => {
       [600, 2000, 5000].forEach((ms) => setTimeout(renderE2ee, ms)); // shim 可能晚于本层挂牌
 
       /* ---- 交互 ---- */
+      /* 菜单跟随按钮：按钮在上半屏 → 菜单挂在它下方；按钮靠左 → 菜单左对齐（都不超出视口）。 */
+      const placeMenu = () => {
+        try {
+          const r = fab.getBoundingClientRect();
+          const vw = window.innerWidth || 360, vh = window.innerHeight || 640;
+          const mr = menu.getBoundingClientRect();
+          const mw = mr.width || Math.min(vw * 0.86, 320);
+          const mh = mr.height || 300;
+          const GAP = 8, EDGE = 8;
+          menu.style.top = "auto"; menu.style.bottom = "auto";
+          if (r.top + r.height / 2 < vh / 2) {
+            menu.style.top = Math.round(Math.max(EDGE, Math.min(r.bottom + GAP, vh - mh - EDGE))) + "px";
+          } else {
+            menu.style.bottom = Math.round(Math.max(EDGE, vh - r.top + GAP)) + "px";
+          }
+          menu.style.left = "auto"; menu.style.right = "auto";
+          if (r.left + r.width / 2 < vw / 2) {
+            menu.style.left = Math.round(Math.max(EDGE, Math.min(r.left, vw - mw - EDGE))) + "px";
+          } else {
+            menu.style.right = Math.round(Math.max(EDGE, Math.min(vw - r.right, vw - mw - EDGE))) + "px";
+          }
+        } catch (e) { /* 定位失败不影响功能（退回 CSS 默认位置） */ }
+      };
       const closeMenu = () => { menu.hidden = true; };
-      const openMenu = () => { renderE2ee(); menu.hidden = false; };
+      const openMenu = () => { renderE2ee(); menu.hidden = false; placeMenu(); };
+      let suppressClickUntil = 0; // 拖完的那一下不要当成"点击打开菜单"
+      let tapHandledAt = 0;        // 轻点已在 pointerup 里处理过（避免 click 再翻一次）
+      const toggleMenu = () => { if (menu.hidden) openMenu(); else closeMenu(); };
       fab.addEventListener("click", (e) => {
         e.stopPropagation(); e.preventDefault();
-        if (menu.hidden) openMenu(); else closeMenu();
+        if (Date.now() < suppressClickUntil) return;      // 刚拖完 → 不算点击
+        if (Date.now() - tapHandledAt < 800) return;      // 轻点已在 pointerup 处理 → 不重复开合
+        toggleMenu();                                     // 键盘/老浏览器兜底
       });
       menu.addEventListener("click", (e) => e.stopPropagation());
+
+      /* ---- 拖动：pointer 事件 + 指针捕获（手指拖出按钮范围也不断线）；拖动阈值 6px 区分"点击"与"拖动" ---- */
+      let fabDrag = null;
+      fab.addEventListener("pointerdown", (e) => {
+        if (e.button !== undefined && e.button !== 0) return; // 只认左键/单指
+        const xy = clampFabXY(fabXY(fabPos));
+        fabDrag = { id: e.pointerId, sx: e.clientX, sy: e.clientY, ox: xy.left, oy: xy.top, moved: false };
+        try { if (fab.setPointerCapture) fab.setPointerCapture(e.pointerId); } catch (e2) { /* 老浏览器忽略 */ }
+        // ⚠️ 这里**不能** preventDefault：实测它会连带掐掉随后的 click 事件（Chrome 触摸语义），
+        //    结果是"按钮点了没反应"。防滚动交给 CSS 的 touch-action:none，轻点交给 pointerup 处理。
+      });
+      fab.addEventListener("pointermove", (e) => {
+        if (!fabDrag || e.pointerId !== fabDrag.id) return;
+        const dx = e.clientX - fabDrag.sx, dy = e.clientY - fabDrag.sy;
+        if (!fabDrag.moved && Math.abs(dx) + Math.abs(dy) < 6) return; // 阈值内视为点击（细微抖动不挪位）
+        if (!fabDrag.moved) { fabDrag.moved = true; fab.classList.add("dsh-ma-fab-dragging"); closeMenu(); }
+        const xy = clampFabXY({ left: fabDrag.ox + dx, top: fabDrag.oy + dy });
+        fab.style.left = Math.round(xy.left) + "px";
+        fab.style.top = Math.round(xy.top) + "px";
+      });
+      const endFabDrag = (e) => {
+        if (!fabDrag || (e && e.pointerId !== undefined && e.pointerId !== fabDrag.id)) return;
+        const moved = fabDrag.moved;
+        fabDrag = null;
+        try { fab.classList.remove("dsh-ma-fab-dragging"); } catch (e2) { /* 忽略 */ }
+        if (!moved) {
+          // 轻点（没超过拖动阈值）→ 在这里开合菜单：pointerdown 不再 preventDefault 之后，
+          // 触摸场景的 click 并不总是可靠地跟上来，pointerup 才是稳的那个点。
+          tapHandledAt = Date.now();
+          toggleMenu();
+          return;
+        }
+        fabPos = fabPosFromXY(clampFabXY({ left: parseFloat(fab.style.left) || 0, top: parseFloat(fab.style.top) || 0 }));
+        saveFabPos();
+        suppressClickUntil = Date.now() + 400; // 拖动结束后的 click 事件不算"点开菜单"
+      };
+      fab.addEventListener("pointerup", endFabDrag);
+      fab.addEventListener("pointercancel", endFabDrag);
+      fab.addEventListener("lostpointercapture", endFabDrag);
       if (fsRange) {
         fsRange.addEventListener("input", (e) => { e.stopPropagation(); setLevel(Number(fsRange.value), true); });
         fsRange.addEventListener("click", (e) => e.stopPropagation());
@@ -770,6 +894,10 @@ const SCRIPT = `(() => {
         if (t === fab || (t && t.closest && t.closest(".dsh-ma-menu, .dsh-ma-fab"))) return;
         closeMenu();
       });
+      try {
+        window.addEventListener("resize", () => { applyFabPos(); if (!menu.hidden) placeMenu(); }, { passive: true });
+        window.addEventListener("orientationchange", () => { applyFabPos(); if (!menu.hidden) placeMenu(); }, { passive: true });
+      } catch (e9) { /* 忽略 */ }
       const devEl = menu.querySelector(".dsh-ma-menu-dev");
       if (devEl) {
         const d = deviceIdOfPath();

package/clients/dsh-remote/test/mobile-adapter-runtime.test.mjs

@@ -362,3 +362,80 @@ test("多端适配：悬浮按钮与字号样式的 CSS 必须在 @media(max-wid
   assert.match(out, /html\[data-dsh-ma-fs="3"\]/, "字号档位样式也应在媒体查询之外（电脑端同样生效）");
   assert.match(out, /z-index:\s*40[01]/, "悬浮按钮/菜单层级要高于遮罩(290)，遮罩异常时仍是自救出口");
 });
+
+// ── 悬浮按钮位置：默认右上角 + 可拖动（2026-09-19 用户反馈） ──────────────────────
+// 现场：按钮原来固定在右下角，**正好压住输入框的发送按钮**；用户要求默认挪到右上角并支持拖动。
+
+test("悬浮按钮：默认在右上角（不再压住输入区的发送按钮）", () => {
+  const env = runAdapter(harness({ width: 390 }));
+  const fab = findFab(env);
+  assert.ok(fab, "悬浮按钮应存在");
+  // 默认 = 距右上角各 10px：left = 390 - 46 - 10 = 334，top = 10
+  assert.equal(fab.style.top, "10px", "默认应贴右上角（top 小）");
+  assert.equal(fab.style.left, "334px", "默认应贴右上角（left 靠右）");
+});
+
+test("悬浮按钮：拖动后位置改变并持久化，且拖完那一下不算点击", () => {
+  const env = runAdapter(harness({ width: 390 }));
+  const fab = findFab(env);
+  const menu = findMenu(env);
+  // 起始为默认右上角 (334,10)；按下点 (340,20) → 拖到 (140,420)：位移 -200/+400
+  fab.dispatch("pointerdown", { pointerId: 7, clientX: 340, clientY: 20 });
+  fab.dispatch("pointermove", { pointerId: 7, clientX: 140, clientY: 420 }); // 位移远超 6px 阈值
+  fab.dispatch("pointerup", { pointerId: 7, clientX: 140, clientY: 420 });
+  assert.equal(fab.style.left, "134px", "按手指位移平移（抓住哪就从哪拖，不瞬移到指尖）");
+  assert.equal(fab.style.top, "410px", "按手指位移平移");
+  const saved = JSON.parse(env.win.localStorage.getItem("dsh-ma-fab-pos") || "null");
+  assert.ok(saved && saved.h && saved.v, "位置应被持久化（按最近的角 + 偏移）");
+  assert.equal(saved.h, "left", "落点在左半屏 → 记成左锚");
+  assert.equal(saved.v, "bottom", "落点在下半屏 → 记成下锚");
+  assert.equal(saved.dx, 134, "左锚的偏移 = 距左边距离");
+  assert.equal(saved.dy, 344, "下锚的偏移 = 距下边距离（800-46-410）");
+  // 拖完紧接着的 click 不应打开菜单（否则拖到一半就弹菜单，很难用）
+  fab.dispatch("click");
+  assert.equal(menu.hidden, true, "拖动结束后的 click 不得当作点击打开菜单");
+});
+
+test("悬浮按钮：轻点（pointerdown+pointerup 不移动）开合菜单 —— 触屏的主路径", () => {
+  const env = runAdapter(harness({ width: 390 }));
+  const fab = findFab(env);
+  const menu = findMenu(env);
+  assert.equal(menu.hidden, true, "初始应收起");
+  // 触摸路径：pointerdown → pointerup（无位移）→ 菜单应当开；不能再依赖 click（曾被 preventDefault 掐掉）
+  fab.dispatch("pointerdown", { pointerId: 3, clientX: 340, clientY: 30 });
+  fab.dispatch("pointerup", { pointerId: 3, clientX: 340, clientY: 30 });
+  assert.equal(menu.hidden, false, "轻点应打开菜单");
+  // 再轻点一次 → 收起
+  fab.dispatch("pointerdown", { pointerId: 4, clientX: 340, clientY: 30 });
+  fab.dispatch("pointerup", { pointerId: 4, clientX: 340, clientY: 30 });
+  assert.equal(menu.hidden, true, "再轻点应收起");
+  // 位置不应被"轻点"改动
+  assert.equal(fab.style.left, "334px", "轻点不得移动按钮");
+});
+
+test("悬浮按钮：位置跨会话记忆（读 localStorage），越界会被夹回视口内", () => {
+  const env = harness({ width: 390 });
+  env.win.localStorage.setItem("dsh-ma-fab-pos", JSON.stringify({ h: "left", v: "top", dx: 12, dy: 34 }));
+  runAdapter(env);
+  const fab = findFab(env);
+  assert.equal(fab.style.left, "12px", "左锚 → 用 dx");
+  assert.equal(fab.style.top, "34px", "上锚 → 用 dy");
+
+  // 越界（dx 巨大）→ 夹回屏内：left ≤ 390-46-4
+  const env2 = harness({ width: 390 });
+  env2.win.localStorage.setItem("dsh-ma-fab-pos", JSON.stringify({ h: "left", v: "top", dx: 9999, dy: 0 }));
+  runAdapter(env2);
+  assert.equal(findFab(env2).style.left, "340px", "越界位置必须被夹进视口（不能跑到屏幕外）");
+});
+
+test("悬浮按钮：菜单跟随按钮位置（按钮在上半屏 → 菜单挂下方；靠左 → 左对齐）", () => {
+  const env = runAdapter(harness({ width: 390 }));
+  const fab = findFab(env);
+  const menu = findMenu(env);
+  fab._rect = { left: 20, top: 12, right: 66, bottom: 58, width: 46, height: 46 }; // 左上角
+  fab.dispatch("click");
+  assert.equal(menu.hidden, false, "点击应打开菜单");
+  assert.equal(menu.style.top, "66px", "按钮在上半屏 → 菜单挂在按钮下方（bottom+8）");
+  assert.equal(menu.style.left, "20px", "按钮靠左 → 菜单左对齐到按钮");
+  assert.equal(menu.style.right, "auto", "左对齐时不应残留 right");
+});

package/docs/telemetry.md

@@ -63,7 +63,7 @@
 `node_missing` · `node_too_old` · `npm_unreachable` · `npm_eacces` · `platform_unsupported` ·
 `runtime_install_timeout` · `launchd_failed` · `bridge_exit` · `bind_conflict` · `bind_device_limit` ·
 `npx_cmd_unavailable` · `registry_timeout` · `install_script_missing` · `npx_exit_nonzero` ·
-`npx_output_encoding` · `unknown`
+`npx_output_encoding` · `update_stalled`（更新进程长时间无输出、判定卡住）· `unknown`
 
 > 原始错误文本**绝不外发**（它可能含文件路径、用户名、主机名）：只做白名单归类，
 > 归不进去的一律记 `unknown`。
@@ -72,6 +72,10 @@
 > `npx_output_encoding` 是 2026-09 为定位「Windows 上装不上运行环境」而拆细的形态
 > （命令调不起来 / 注册表超时 / 包或安装脚本缺失 / 退出码非零 / 输出乱码）——
 > 它们仍然只是**枚举值**，不包含任何原始文本。
+>
+> `update_stalled`（0.6.9 新增）：更新进程**活着但长时间没有任何输出**（中国网络访问 npm 官方源的
+> 典型失败形态是"挂起"而非快速失败）。它被单列出来，是为了让"卡死"这一类在统计里可见 ——
+> 此前它只会落进 `unknown` 或干脆不产生事件，导致规模被持续低估。
 
 ## 3. 不采集什么（硬边界）
 

package/dsh-setup.mjs

@@ -7,7 +7,7 @@
  *   dsh-remote settings                        提示如何登录（独立设置页已移除，见 dsh web 面板）
  *   dsh-remote run                             前台运行 bridge（调试/守护）
  *   dsh-remote status                          查看配置与服务状态
- *   dsh-remote plugin [--uninstall]            手动安装/卸载 dsh web 远程控制插件
+ *   dsh-remote plugin [--uninstall]            手动安装/卸载 dsh web 远程访问插件
  *
  * setup 选项（全部可选）:
  *   --server <wss://host:port> --key <访问密钥>   自建模式（不填则连默认云端服务）
@@ -18,8 +18,8 @@
  * 行为:
  *   1. 写入配置 <CONFIG_DIR>/.dsh-config.json（0600；npm 安装时为 ~/.dsh-remote/）
  *   2. 生成自启动服务（macOS launchd / Linux systemd），随 dsh web(3080) 存活自动保活
- *   3. 自动把远程控制插件装进 dsh web 设置页（若检测到 profile）
- *   4. 登录/连接配置在 dsh web → 设置 → 「远程控制」面板完成（SaaS 注册登录 / 自建切换）
+ *   3. 自动把远程访问插件装进 dsh web 设置页（若检测到 profile）
+ *   4. 登录/连接配置在 dsh web → 设置 → 「远程访问」面板完成（SaaS 注册登录 / 自建切换）
  *      自建 CLI 用户也可用 `dsh-remote setup --server … --key …`（无需再打开设置页）
  */
 
@@ -160,14 +160,14 @@ function printHelp() {
   dsh-remote settings     显示登录/连接配置指引（独立设置页已移除）
   dsh-remote run          前台运行 bridge（调试）
   dsh-remote status       查看配置与服务状态
-  dsh-remote plugin       手动安装 dsh web 远程控制插件（--uninstall 卸载）
+  dsh-remote plugin       手动安装 dsh web 远程访问插件（--uninstall 卸载）
   dsh-remote repair       修复插件挂载（dsh web 起不来时用；只碰 profile，不联网）
   dsh-remote --help       显示本用法（等同 dsh-remote help）
 
 自建模式（可选）:
   dsh-remote setup --server wss://你的域名:端口 --key 访问密钥
 
-登录/连接配置: 打开 dsh web → 设置 → 「远程控制」→ 注册或登录手机号即可
+登录/连接配置: 打开 dsh web → 设置 → 「远程访问」→ 注册或登录手机号即可
 （自建用户切「自建服务」标签或直接用上方 setup 命令，无需另开页面）。
 文档: ${REPO_URL}
 `);
@@ -848,7 +848,7 @@ function installAutostart() {
 }
 
 // ---------- settings：旧独立设置页已移除（引导到 dsh web 插件面板） ----------
-// 云服务用户在 dsh web → 设置 → 「远程控制」面板即可注册/登录（自建切换也在此面板）；
+// 云服务用户在 dsh web → 设置 → 「远程访问」面板即可注册/登录（自建切换也在此面板）；
 // 独立设置页(127.0.0.1:3499)与面板功能完全重复、且暴露自建表单给普通用户造成困惑,已移除。
 // 保留 `dsh-remote settings` 命令为“引导提示”,避免旧脚本/旧文档直接调它时报错。
 function settingsHint() {
@@ -856,7 +856,7 @@ function settingsHint() {
 dsh-remote：独立的本地设置页已移除。
 
 请直接在 dsh web 里完成登录/连接配置（无需任何命令）：
-  打开 dsh web → 设置 → 「远程控制」→ 注册或登录手机号即可（自建模式切换也在该面板）。
+  打开 dsh web → 设置 → 「远程访问」→ 注册或登录手机号即可（自建模式切换也在该面板）。
 
 自建用户若偏好命令行，可用：
   dsh-remote setup --server wss://你的域名:端口 --key 访问密钥
@@ -928,7 +928,7 @@ async function runBridge() {
     if (!saas && !local) {
       if (!warnedNoLogin) {
         warnedNoLogin = true;
-        console.log("⚠️ 尚未登录：请打开 dsh web → 设置 → 「远程控制」，注册/登录手机号（或切到自建模式）后自动启动。");
+        console.log("⚠️ 尚未登录：请打开 dsh web → 设置 → 「远程访问」，注册/登录手机号（或切到自建模式）后自动启动。");
       }
       return;
     }
@@ -1095,7 +1095,7 @@ async function setup(argv) {
   }
 
   // 插件是**进程启动时**装载的：刚装进 profile 的插件，运行中的 dsh web 里并没有
-  // （既没有 /dsh-remote/* 路由，也没有「设置 → 远程控制」面板项）。
+  // （既没有 /dsh-remote/* 路由，也没有「设置 → 远程访问」面板项）。
   // 这里做一个确定性判断：进程启动时间早于插件落盘时间 → 必须重启 dsh web 才生效。
   const pluginDir = path.join(resolveProfileDir(argv), PLUGIN_LOCAL_DIR);
   const pluginMtime = fs.existsSync(path.join(pluginDir, "lib", "index.js"))
@@ -1148,7 +1148,7 @@ async function setup(argv) {
   if (needRestart && !noRestart && webUp) {
     console.log("");
     console.log("ℹ 检测到运行中的 dsh web 早于本次插件安装 —— 插件只在进程启动时装载，");
-    console.log("  所以「设置 → 远程控制」面板暂时还没出现。正在为你重启 dsh web（2 秒后执行，Ctrl-C 可跳过）…");
+    console.log("  所以「设置 → 远程访问」面板暂时还没出现。正在为你重启 dsh web（2 秒后执行，Ctrl-C 可跳过）…");
     sleepSync(2000);
     restartResult = restartDshWeb();
     if (restartResult.ok) {
@@ -1193,7 +1193,7 @@ async function setup(argv) {
     L.push(`   服务器: ${cfg.tunnel_url}`);
     L.push(`   手机端: 打开 ${cfg.tunnel_url.replace(/^ws/, "https")}/app/ ，用访问密钥登录`);
   } else {
-    L.push(`   远程控制地址: ${pub.app_url || DEFAULT_APP_URL}`);
+    L.push(`   远程访问地址: ${pub.app_url || DEFAULT_APP_URL}`);
   }
   L.push(svcSkipped
     ? `   自启动服务: ${svcState}，可用 \`dsh-remote run\` 手动运行 bridge`
@@ -1239,10 +1239,10 @@ async function setup(argv) {
   } else if (hotMounted) {
     L.push("");
     L.push("   下一步: 插件已热加载（无需重启 dsh web）——刷新一下浏览器页面，");
-    L.push("          再打开 设置 → 「远程控制」→ 注册/登录手机号即可。");
+    L.push("          再打开 设置 → 「远程访问」→ 注册/登录手机号即可。");
   } else if (needRestart && restartResult && restartResult.ok) {
     L.push("");
-    L.push("   下一步: dsh web 已重启，直接打开 http://127.0.0.1:3080 → 设置 → 「远程控制」→ 注册/登录手机号。");
+    L.push("   下一步: dsh web 已重启，直接打开 http://127.0.0.1:3080 → 设置 → 「远程访问」→ 注册/登录手机号。");
   } else if (needRestart && pluginResult && pluginResult.hotPatch && pluginResult.changed) {
     // patch 已写入但探测窗口内没等到面板接口:热加载很可能还在进行(插件节点半启动+注册路由)。
     // 这种情况**不能**直接让用户重启 —— 先让他等几秒刷新,再给兜底方案。
@@ -1251,7 +1251,7 @@ async function setup(argv) {
       L.push(`ℹ 插件已按热加载方式登记，但运行中的 dsh web 仍在用旧版本（${runningSeen} → 期望 ${pkgVersion()}）：`);
       L.push("   刷新页面即可（浏览器半会跟着更新）；若刷新后功能仍不对，再重启一次 dsh web。");
     } else {
-      L.push("ℹ 插件已按热加载方式登记（patch 已写入），若「设置 → 远程控制」还没出现：");
+      L.push("ℹ 插件已按热加载方式登记（patch 已写入），若「设置 → 远程访问」还没出现：");
       L.push("   等几秒后刷新页面即可；仍未出现再重启一次 dsh web（命令见 README）。");
     }
   } else if (needRestart) {
@@ -1261,15 +1261,15 @@ async function setup(argv) {
     L.push("   请手动执行（任选其一）：");
     L.push("     launchctl kickstart -k gui/$(id -u)/com.dshweb.dev     # 用 launchd 托管时");
     L.push("     kill $(lsof -ti tcp:3080 -sTCP:LISTEN) && dsh web --no-open   # 手动启动时");
-    L.push("   重启后：打开 http://127.0.0.1:3080 → 设置 → 「远程控制」→ 注册/登录手机号。");
+    L.push("   重启后：打开 http://127.0.0.1:3080 → 设置 → 「远程访问」→ 注册/登录手机号。");
   } else {
     L.push("");
-    L.push("   下一步: 打开 dsh web → 设置 → 「远程控制」→ 注册/登录手机号即可（无需任何命令）。");
+    L.push("   下一步: 打开 dsh web → 设置 → 「远程访问」→ 注册/登录手机号即可（无需任何命令）。");
   }
   console.log("\n" + L.join("\n") + "\n");
 }
 
-// ---------- plugin：安装/卸载 dsh web 远程控制插件 ----------
+// ---------- plugin：安装/卸载 dsh web 远程访问插件 ----------
 /** 当前插件名（2026-09 由 dsh-remote-ui 更名；dsh-remote-web = dsh-remote 的 dsh web 插件半）。 */
 const PLUGIN_ID = "dsh-remote-web";
 /** 更名前的历史插件名（≤0.4.9）：升级安装/卸载时一并清理，避免旧 id 残留导致重复激活。 */
@@ -2113,7 +2113,7 @@ else if (cmd === "status") {
   console.log("配置文件:", CONFIG_PATH);
   console.log("连接模式:", local ? `自建服务（${cfg.tunnel_url || "未设置服务器地址"}）` : `SaaS 云端服务（${cfg.phone || "未配置账号"}）`);
   console.log("API:", cfg.api_url || (local ? "（自建模式无需账号 API）" : DEFAULT_API));
-  console.log("远程地址/登录: 打开 dsh web → 设置 → 「远程控制」查看与操作");
+  console.log("远程地址/登录: 打开 dsh web → 设置 → 「远程访问」查看与操作");
   // 插件挂载诊断：报障时一眼看出是"链接坏了"还是"别的毛病"
   const profileDir = resolveProfileDir([]);
   if (fs.existsSync(path.join(profileDir, "package.json"))) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.6.7",
+  "version": "0.6.9-beta.1",
   "description": "手机远程控制 DeepSeek Harness · Remote control DeepSeek Harness (dsh web) from any phone browser — 100% 全功能 App 级体验：发消息、看工具执行、审批权限、改设置、管凭据，含特权操作，免内网穿透。一条命令安装 npx @mrrisega/dsh-remote。Mobile remote control for DSH, self-host or SaaS, no server needed on LAN.",
   "keywords": [
     "deepseek-harness",