@mrrisega/dsh-remote 0.4.8 → 0.5.0

package/README.md

@@ -63,12 +63,9 @@ dsh-remote 是一个轻量的**隧道模式**远程控制方案：电脑端运
 npx @mrrisega/dsh-remote
 ```
 
-安装完成后运行下面命令打开设置页，用手机号+密码登录即可（注册在手机端完成，
-登录后 bridge 自动启动）：
-
-```bash
-npx @mrrisega/dsh-remote settings
-```
+安装完成后**无需任何命令**：打开 dsh web → 设置 → 「远程控制」，注册/登录手机号即可
+（注册在手机端完成，登录后 bridge 自动启动；自建用户在同一面板切「自建服务」标签）。
+原来的独立设置页（`dsh-remote settings`）已移除，避免与插件面板重复造成困惑。
 
 自建模式（自己部署了 relay-router，无需账号体系）：
 
@@ -76,11 +73,11 @@ npx @mrrisega/dsh-remote settings
 npx @mrrisega/dsh-remote setup --server wss://<你的域名>:端口 --key <访问密钥>
 ```
 
-其他命令：`settings`（设置页）、`status`（查看状态）、`run`（前台调试）、
+其他命令：`status`（查看状态）、`run`（前台调试）、`settings`（仅显示登录指引）、
 `plugin`（重装/卸载 dsh web 插件）。运行 `npx @mrrisega/dsh-remote --help` 查看完整说明。
 
 > **版本与更新 / 卸载**：dsh 官方插件市场目前不提供更新按钮，也不会改写用户补丁（因此市场
-> 卸载会提示「仍通过 insert 引用 dsh-remote-ui」而拒绝）。插件设置面板里已内置管理入口
+> 卸载会提示「仍通过 insert 引用 dsh-remote-web」而拒绝）。插件设置面板里已内置管理入口
 > （dsh web → 设置 → 「远程控制」→「🔄 版本与更新」卡片）：显示当前版本、自动检测 npm 新版、
 > **一键在线更新**（后台补运行环境并重启 bridge，完成后重启 dsh web 生效）、以及**彻底卸载**
 > （移除补丁 include / 依赖 / bundle 与本地文件，之后市场卸载或直接重启均可完成卸载）。
@@ -112,7 +109,7 @@ npx @mrrisega/dsh-remote setup --server wss://<你的域名>:端口 --key <访
 | relay-router | `packages/relay-router/` | 中继服务器：bridge 注册表、实时设备列表、HTTP/WS 透明代理、配额 |
 | bridge | `clients/dsh-remote/` | 电脑端守护进程：连 router 注册，把转发帧代理到本地 `dsh web`；心跳自愈 |
 | PWA | `clients/dsh-web/native.html` | 手机端：登录 / 注册 / 设备选择（单文件，零构建） |
-| dsh web 插件 | `packages/dsh-remote-ui/` | 设置页「远程控制」面板：连接模式 / 账号 / bridge 启停 / 反馈 |
+| dsh web 插件 | `packages/dsh-remote-web/` | 设置页「远程控制」面板：连接模式 / 账号 / bridge 启停 / 反馈 |
 | 部署脚本 | `deploy/` | `install-open.sh` 自建引导、nginx 参考配置、Dockerfile / compose |
 
 测试：`npm test`（router 契约 + 插件 + bridge 全部单测与回归）。

package/clients/dsh-remote/dsh-bridge.mjs

@@ -137,7 +137,7 @@ function saveLocalConfig(cfg) {
 }
 
 /**
- * Harness 浏览器会话 Cookie(由 dsh-remote-ui 插件在进程内换取后写入
+ * Harness 浏览器会话 Cookie(由 dsh-remote-web 插件在进程内换取后写入
  * <relayDir>/.harness-cookie.json)。新版 dsh web(0.1.2+)对每个请求校验该 Cookie,
  * 不带则 401 → 手机端白页;bridge 对所有上游 HTTP/WS 请求自动携带,让手机表现为已授权浏览器。
  */

package/dsh-setup.mjs

@@ -4,7 +4,7 @@
  *
  * 用法:
  *   dsh-remote [setup] [选项]                 一键安装（默认命令，无需任何参数）
- *   dsh-remote settings                        打开本地设置页（登录账号 / 自建配置）
+ *   dsh-remote settings                        提示如何登录（独立设置页已移除，见 dsh web 面板）
  *   dsh-remote run                             前台运行 bridge（调试/守护）
  *   dsh-remote status                          查看配置与服务状态
  *   dsh-remote plugin [--uninstall]            手动安装/卸载 dsh web 远程控制插件
@@ -19,10 +19,10 @@
  *   1. 写入配置 <CONFIG_DIR>/.dsh-config.json（0600；npm 安装时为 ~/.dsh-remote/）
  *   2. 生成自启动服务（macOS launchd / Linux systemd），随 dsh web(3080) 存活自动保活
  *   3. 自动把远程控制插件装进 dsh web 设置页（若检测到 profile）
- *   4. 登录在设置页完成: dsh-remote settings（手机号+密码，或自建密钥）
+ *   4. 登录/连接配置在 dsh web → 设置 → 「远程控制」面板完成（SaaS 注册登录 / 自建切换）
+ *      自建 CLI 用户也可用 `dsh-remote setup --server … --key …`（无需再打开设置页）
  */
 
-import http from "node:http";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
@@ -35,7 +35,6 @@ const IS_NPM_INSTALL = THIS_DIR.includes(`${path.sep}node_modules${path.sep}`);
 // 配置目录：npm 安装时放在用户目录（node_modules 内不可写）；仓库开发时放在仓库根。
 const CONFIG_DIR = process.env.DSH_RELAY_DIR || (IS_NPM_INSTALL ? path.join(os.homedir(), ".dsh-remote") : THIS_DIR);
 const CONFIG_PATH = path.join(CONFIG_DIR, ".dsh-config.json");
-const SETTINGS_PORT = 3499;
 // 默认云端服务地址（服务商 SaaS 入口；自建用户用 --server/--key 指向自己的 router）
 const DEFAULT_API = "https://n.risegao.cn:13443/relay-api";
 const DEFAULT_APP_URL = "https://n.risegao.cn:13443/app/";
@@ -45,7 +44,7 @@ const REPO_URL = "https://github.com/mrRisega/dsh-remote";
 // npx 每次安装的缓存目录（~/.npm/_npx/<hash>）不固定：缓存一旦清理，指向它的自启动服务
 // 就会像“找不到模块”一样崩溃。因此 npm 形态安装时把 dsh-setup.mjs + clients + 依赖(ws)
 // 固化到 CONFIG_DIR（~/.dsh-remote），自启动服务只指向这个稳定路径。
-// 插件（dsh-remote-ui）的“运行环境已就绪”判断同样以 CONFIG_DIR/dsh-setup.mjs 为准。
+// 插件（dsh-remote-web；2026-09 前为 dsh-remote-ui）的“运行环境已就绪”判断同样以 CONFIG_DIR/dsh-setup.mjs 为准。
 
 function pkgVersion() {
   try {
@@ -281,97 +280,20 @@ function installAutostart() {
   return { path: svcPath, status: r };
 }
 
-// ---------- 设置页（本地 HTTP：远程地址 + 账号/自建配置） ----------
-function serveSettings() {
-  const cfg = loadConfig();
-  const server = http.createServer(async (req, res) => {
-    const url = new URL(req.url, `http://127.0.0.1:${SETTINGS_PORT}`);
-    const send = (code, body, type = "text/html") => {
-      res.writeHead(code, { "Content-Type": type + "; charset=utf-8" });
-      res.end(body);
-    };
-
-    if (req.method === "POST" && url.pathname === "/api/config") {
-      let raw = "";
-      for await (const c of req) raw += c;
-      try {
-        const body = JSON.parse(raw);
-        const local = Boolean(body.local_key || body.server);
-        if (local) {
-          if (!body.server || !body.local_key) {
-            return send(400, JSON.stringify({ ok: false, message: "自建模式需要服务器地址与访问密钥" }), "application/json");
-          }
-          cfg.tunnel_url = normalizeTunnelUrl(body.server);
-          cfg.local_key = String(body.local_key).trim();
-          delete cfg.phone; delete cfg.password;
-        } else {
-          if (!body.phone || !body.password) {
-            return send(400, JSON.stringify({ ok: false, message: "SaaS 模式需要手机号与密码" }), "application/json");
-          }
-          cfg.phone = body.phone; cfg.password = body.password;
-          applySaaSMode(cfg); // 清自建残留,api/tunnel 权威重算
-        }
-        // 自动获取服务端下发的 bridge_secret（device-login 共享密钥，一键安装开箱即用）
-        if (!cfg.bridge_secret && !cfg.local_key) {
-          const pub = await fetchPublicConfig(cfg.api_url || DEFAULT_API);
-          if (pub.bridge_secret) cfg.bridge_secret = String(pub.bridge_secret);
-        }
-        saveConfig(cfg);
-        const r = restartBridgeService();
-        return send(200, JSON.stringify({ ok: true, service: r.ok ? "running" : (r.status || "failed") }), "application/json");
-      } catch { return send(400, JSON.stringify({ ok: false, message: "JSON 解析失败" }), "application/json"); }
-    }
+// ---------- settings：旧独立设置页已移除（引导到 dsh web 插件面板） ----------
+// 云服务用户在 dsh web → 设置 → 「远程控制」面板即可注册/登录（自建切换也在此面板）；
+// 独立设置页(127.0.0.1:3499)与面板功能完全重复、且暴露自建表单给普通用户造成困惑,已移除。
+// 保留 `dsh-remote settings` 命令为“引导提示”,避免旧脚本/旧文档直接调它时报错。
+function settingsHint() {
+  console.log(`
+dsh-remote：独立的本地设置页已移除。
 
-    const mode = cfg.local_key ? "自建服务" : "SaaS 云端服务";
-    const pub = await fetchPublicConfig(cfg.api_url || DEFAULT_API);
-    const remoteUrl = pub.app_url || (cfg.local_key ? (cfg.tunnel_url || "") : DEFAULT_APP_URL);
-
-    const html = `<!doctype html><html lang="zh-CN"><head><meta charset="utf-8"/>
-<meta name="viewport" content="width=device-width,initial-scale=1"/>
-<title>dsh-remote 设置</title>
-<style>
-body{font-family:-apple-system,"PingFang SC","Microsoft YaHei",sans-serif;background:#0d1117;color:#e6edf3;max-width:520px;margin:0 auto;padding:24px}
-h1{font-size:18px}label{display:block;font-size:13px;color:#8b949e;margin:14px 0 6px}
-input{width:100%;padding:11px 13px;border-radius:8px;border:1px solid #30363d;background:#161b22;color:#e6edf3;font-size:15px;box-sizing:border-box}
-button{width:100%;padding:13px;border-radius:8px;border:none;background:#2f81f7;color:#fff;font-size:15px;font-weight:600;cursor:pointer;margin-top:16px}
-.card{background:#161b22;border:1px solid #30363d;border-radius:12px;padding:18px;margin-bottom:16px}
-.url{background:#010409;border:1px solid #30363d;border-radius:8px;padding:12px;font-family:monospace;font-size:14px;word-break:break-all}
-.msg{font-size:13px;margin-top:10px;min-height:18px}.ok{color:#3fb950}.err{color:#f85149}
-</style></head><body>
-<h1>dsh-remote 设置</h1>
-<div class="card"><h3 style="margin:0 0 8px">📱 远程控制地址（当前模式：${mode}）</h3>
-<div class="url">${remoteUrl || "（未配置）"}</div>
-<div style="font-size:12px;color:#8b949e;margin-top:8px">手机浏览器打开此地址，即可远程控制本机 dsh web。</div></div>
-<div class="card"><h3 style="margin:0 0 4px">🔑 连接配置</h3>
-<div style="font-size:12px;color:#8b949e;margin-bottom:8px">二选一：填手机号密码（SaaS），或填服务器地址+访问密钥（自建）。</div>
-<label>SaaS 手机号</label><input id="phone" value="${cfg.phone || ""}" autocomplete="tel"/>
-<label>SaaS 密码</label><input id="pass" type="password" placeholder="••••••••" autocomplete="current-password"/>
-<div style="height:1px;background:#30363d;margin:16px 0"></div>
-<label>自建服务器地址（wss://host:port）</label><input id="server" value="${cfg.tunnel_url || ""}" placeholder="wss://relay.example.com"/>
-<label>自建访问密钥</label><input id="lkey" type="password" value="${cfg.local_key || ""}" placeholder="访问密钥"/>
-<button onclick="save()">保存并生效</button>
-<div class="msg" id="msg"></div></div>
-<script>
-async function save(){
-  const m=document.getElementById("msg");m.className="msg";m.textContent="保存中...";
-  const local = document.getElementById("lkey").value.trim() !== "" || document.getElementById("server").value.trim() !== "";
-  try{
-    const r=await fetch("/api/config",{method:"POST",headers:{"content-type":"application/json"},
-      body:JSON.stringify(local
-        ? {server:document.getElementById("server").value.trim(),local_key:document.getElementById("lkey").value.trim()}
-        : {phone:document.getElementById("phone").value.trim(),password:document.getElementById("pass").value})});
-    const d=await r.json();
-    if(d.ok){m.className="msg ok";m.textContent = d.service==="running" ? "✅ 已保存并生效，无需手动重启" : "✅ 已保存（服务状态: "+(d.service||"未知")+"，可运行 dsh-remote setup 修复）";}
-    else{m.className="msg err";m.textContent=d.message||"保存失败";}
-  }catch(e){m.className="msg err";m.textContent="保存失败: "+e.message;}
-}
-</script></body></html>`;
-    return send(200, html);
-  });
-  server.listen(SETTINGS_PORT, "127.0.0.1", () => {
-    console.log(`\n✅ 设置页已打开: http://127.0.0.1:${SETTINGS_PORT}`);
-    console.log("   在浏览器中配置账号或自建连接，查看远程控制地址。Ctrl-C 关闭。\n");
-  });
+请直接在 dsh web 里完成登录/连接配置（无需任何命令）：
+  打开 dsh web → 设置 → 「远程控制」→ 注册或登录手机号即可（自建模式切换也在该面板）。
+
+自建用户若偏好命令行，可用：
+  dsh-remote setup --server wss://你的域名:端口 --key 访问密钥
+`);
 }
 
 // ---------- run：前台跑 bridge（带配置 + 自启动 watcher） ----------
@@ -400,7 +322,7 @@ async function runBridge() {
     if (!saas && !local) {
       if (!warnedNoLogin) {
         warnedNoLogin = true;
-        console.log("⚠️ 尚未登录：打开设置页 `dsh-remote settings` 登录账号（或配置自建密钥）后自动启动。");
+        console.log("⚠️ 尚未登录：请打开 dsh web → 设置 → 「远程控制」，注册/登录手机号（或切到自建模式）后自动启动。");
       }
       return;
     }
@@ -540,31 +462,39 @@ async function setup(argv) {
 }
 
 // ---------- plugin：安装/卸载 dsh web 远程控制插件 ----------
-const PLUGIN_MARKER_START = "# >>> dsh-remote-ui (managed by dsh-remote plugin; do not edit)";
-const PLUGIN_MARKER_END = "# <<< dsh-remote-ui";
+/** 当前插件名（2026-09 由 dsh-remote-ui 更名；dsh-remote-web = dsh-remote 的 dsh web 插件半）。 */
+const PLUGIN_ID = "dsh-remote-web";
+/** 更名前的历史插件名（≤0.4.9）：升级安装/卸载时一并清理，避免旧 id 残留导致重复激活。 */
+const PLUGIN_LEGACY_IDS = ["dsh-remote-ui"];
+/** 当前名 + 全部历史名。 */
+const PLUGIN_ALL_IDS = [PLUGIN_ID, ...PLUGIN_LEGACY_IDS];
+const PLUGIN_MARKER_START = `# >>> ${PLUGIN_ID} (managed by dsh-remote plugin; do not edit)`;
+const PLUGIN_MARKER_END = `# <<< ${PLUGIN_ID}`;
 /** 插件在 profile 内的固定本地目录(安装时整目录拷贝)。 */
-const PLUGIN_LOCAL_DIR = "dsh-remote-ui-plugin";
+const PLUGIN_LOCAL_DIR = `${PLUGIN_ID}-plugin`;
+/** 片段是否涉及本插件(当前名或任一历史名)。 */
+const pluginRef = (s) => PLUGIN_ALL_IDS.some((id) => s.includes(id));
 
 /**
- * include 块。name 必须是【裸包名】'dsh-remote-ui'：
- *  - 加载器据此 import 节点半(dsh-remote-ui 由 node_modules 链接解析);
+ * include 块。name 必须是【裸包名】'${PLUGIN_ID}'（≤0.4.9 为 'dsh-remote-ui'）：
+ *  - 加载器据此 import 节点半(${PLUGIN_ID} 由 node_modules 链接解析);
  *  - dsh 客户端模块系统(@deepseek-ai/dsh-client-modules)用 require.resolve(
  *    '<name>/package.json') 从 profile 解析该包并读取 package.json 的
  *    dsh.client 声明 → 注入浏览器半(设置面板 UI)。相对文件路径入口只会加载
  *    节点半、不会注入 UI —— 0.3.7/0.3.8 曾因此丢设置页。
- * 链接由安装器自建(node_modules/dsh-remote-ui → 拷贝出的目录),不依赖 pnpm/npm。
+ * 链接由安装器自建(node_modules/${PLUGIN_ID} → 拷贝出的目录),不依赖 pnpm/npm。
  */
 function pluginBlock(relayDir) {
   return `${PLUGIN_MARKER_START}
 - insert:
-    - id: dsh-remote-ui
-      name: 'dsh-remote-ui'
+    - id: ${PLUGIN_ID}
+      name: '${PLUGIN_ID}'
       config:
         relayDir: '${relayDir}'
 ${PLUGIN_MARKER_END}`;
 }
 
-/** 移除 patch 中所有引用 dsh-remote-ui 的条目块（含其前置注释），返回剩余内容。 */
+/** 移除 patch 中所有引用本插件（当前或历史名）的条目块（含其前置注释），返回剩余内容。 */
 function stripPluginEntries(patch) {
   const lines = patch.split("\n");
   const out = [];
@@ -579,10 +509,10 @@ function stripPluginEntries(patch) {
         block.push(lines[j]);
         j++;
       }
-      if (block.join("\n").includes("dsh-remote-ui")) {
+      if (pluginRef(block.join("\n"))) {
         // 连带删除块前的连续注释（旧版条目说明 / 管理标记），以及块后的收尾标记行
         while (out.length && /^\s*#/.test(out[out.length - 1])) out.pop();
-        if (j < lines.length && /^\s*#/.test(lines[j]) && lines[j].includes("dsh-remote-ui")) j++;
+        if (j < lines.length && /^\s*#/.test(lines[j]) && pluginRef(lines[j])) j++;
         i = j;
         continue;
       }
@@ -613,10 +543,14 @@ function normalizePatchBase(patch) {
 
 /**
  * 把插件整目录拷贝进 profile 的固定子目录并返回该目录。
- * 源(本包 packages/dsh-remote-ui)可能在 npx 临时缓存里,因此必须拷到 profile 内持久化,
+ * 源(本包 packages/${PLUGIN_ID})可能在 npx 临时缓存里,因此必须拷到 profile 内持久化,
  * include 用相对路径直接指向拷贝出的入口,不写依赖、不跑任何包管理器。
  */
 function copyPluginIntoProfile(profileDir, pluginDir) {
+  // 清理历史名残留目录（≤0.4.9 的 dsh-remote-ui-plugin），避免与新版并存
+  for (const id of PLUGIN_LEGACY_IDS) {
+    try { fs.rmSync(path.join(profileDir, `${id}-plugin`), { recursive: true, force: true }); } catch { /* ignore */ }
+  }
   const dest = path.join(profileDir, PLUGIN_LOCAL_DIR);
   fs.rmSync(dest, { recursive: true, force: true });
   fs.cpSync(pluginDir, dest, {
@@ -633,11 +567,15 @@ function copyPluginIntoProfile(profileDir, pluginDir) {
   return dest;
 }
 
-/** 把插件挂到 <profile>/node_modules/dsh-remote-ui(裸包名解析需要),指向拷贝目录;缺失/指错时重建。 */
+/** 把插件挂到 <profile>/node_modules/<PLUGIN_ID>(裸包名解析需要),指向拷贝目录;缺失/指错时重建。 */
 function ensurePluginLinked(profileDir, pluginLocalDir) {
   const nmDir = path.join(profileDir, "node_modules");
-  const nmPlugin = path.join(nmDir, "dsh-remote-ui");
+  const nmPlugin = path.join(nmDir, PLUGIN_ID);
   fs.mkdirSync(nmDir, { recursive: true });
+  // 清理历史名链接（node_modules/dsh-remote-ui），避免解析到旧拷贝
+  for (const id of PLUGIN_LEGACY_IDS) {
+    try { fs.rmSync(path.join(nmDir, id), { recursive: true, force: true }); } catch { /* ignore */ }
+  }
   try {
     if (fs.realpathSync(nmPlugin) === pluginLocalDir) return false;
   } catch { /* 缺失/悬空 → 重建 */ }
@@ -654,50 +592,64 @@ function ensurePluginLinked(profileDir, pluginLocalDir) {
 function declarePluginDep(pkgFile) {
   const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf8"));
   pkg.dependencies = pkg.dependencies || {};
-  pkg.dependencies["dsh-remote-ui"] = `file:./${PLUGIN_LOCAL_DIR}`;
+  for (const id of PLUGIN_LEGACY_IDS) { delete pkg.dependencies[id]; }
+  pkg.dependencies[PLUGIN_ID] = `file:./${PLUGIN_LOCAL_DIR}`;
   fs.writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + "\n");
 }
 
-/** 把 dsh-remote-ui 加入 dsh.profile.bundles（幂等）。返回是否发生变更。 */
+/** 把 PLUGIN_ID 加入 dsh.profile.bundles（幂等；顺带移除历史名条目）。返回是否发生变更。 */
 function ensureBundleEntry(pkgFile) {
   const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf8"));
   const bundles = pkg.dsh && pkg.dsh.profile && Array.isArray(pkg.dsh.profile.bundles)
     ? pkg.dsh.profile.bundles
     : null;
-  if (bundles && bundles.includes("dsh-remote-ui")) return false;
+  if (bundles && bundles.includes(PLUGIN_ID)) {
+    const hadLegacy = bundles.some((b) => PLUGIN_LEGACY_IDS.includes(b));
+    if (hadLegacy) {
+      pkg.dsh.profile.bundles = bundles.filter((b) => !PLUGIN_LEGACY_IDS.includes(b));
+      fs.writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + "\n");
+      return true;
+    }
+    return false;
+  }
   pkg.dsh = pkg.dsh || {};
   pkg.dsh.profile = pkg.dsh.profile || {};
-  pkg.dsh.profile.bundles = bundles || [];
-  pkg.dsh.profile.bundles.push("dsh-remote-ui");
+  pkg.dsh.profile.bundles = (bundles || []).filter((b) => !PLUGIN_LEGACY_IDS.includes(b) && b !== PLUGIN_ID);
+  pkg.dsh.profile.bundles.push(PLUGIN_ID);
   fs.writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + "\n");
   return true;
 }
 
-/** 从 dsh.profile.bundles 移除 dsh-remote-ui（幂等）。返回是否发生变更。 */
+/** 从 dsh.profile.bundles 移除本插件（当前或历史名，幂等）。返回是否发生变更。 */
 function removeBundleEntry(pkgFile) {
   const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf8"));
   const bundles = pkg.dsh && pkg.dsh.profile && Array.isArray(pkg.dsh.profile.bundles)
     ? pkg.dsh.profile.bundles
     : null;
-  if (!bundles || !bundles.includes("dsh-remote-ui")) return false;
-  pkg.dsh.profile.bundles = bundles.filter((b) => b !== "dsh-remote-ui");
+  if (!bundles) return false;
+  const filtered = bundles.filter((b) => !PLUGIN_ALL_IDS.includes(b));
+  if (filtered.length === bundles.length) return false;
+  pkg.dsh.profile.bundles = filtered;
   fs.writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + "\n");
   return true;
 }
 
 /**
- * 插件安装(pluginCmd 非卸载分支)收敛策略 —— 2026-09-06「重复 ID 崩溃」根治：
- * dsh-remote-ui 是带 dsh.bundle.patch 的 bundle：package.json 的 dsh.profile.bundles
+ * 插件安装(pluginCmd 非卸载分支)收敛策略 —— 2026-09-06「重复 ID 崩溃」根治；
+ * 2026-09 插件由 dsh-remote-ui 更名 dsh-remote-web，本函数同时兼容清理旧名残留：
+ * dsh-remote-web 是带 dsh.bundle.patch 的 bundle：package.json 的 dsh.profile.bundles
  * 声明它后，加载器会自动应用插件自带的 cordis.patch.yml（节点半+浏览器半的唯一激活点）。
  * 若用户级 cordis.patch.yml 再手工 insert 同一个 id，dsh web 启动即报“重复 ID”崩溃。
  * 因此本命令【绝不写用户 include】，只负责：让插件以 bundle 形态可解析，
- * 并清理历史遗留的 include 块。市场形态(github:/npm 依赖)则完全交由市场管理，只清理 include。
+ * 并清理历史遗留的 include 块与旧名(≤0.4.9 dsh-remote-ui)痕迹。
+ * 市场形态(github:/npm 依赖)则完全交由市场管理，只清理 include。
  */
 function convergePluginActivation(profileDir, pkgFile, patchFile, pluginDir, patch) {
   const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf8"));
-  const dep = pkg.dependencies && pkg.dependencies["dsh-remote-ui"];
+  const legacyDep = PLUGIN_LEGACY_IDS.map((id) => pkg.dependencies && pkg.dependencies[id]).find((v) => v !== undefined);
+  const dep = (pkg.dependencies && pkg.dependencies[PLUGIN_ID]) ?? legacyDep;
   const inBundles = !!(pkg.dsh && pkg.dsh.profile && Array.isArray(pkg.dsh.profile.bundles)
-    && pkg.dsh.profile.bundles.includes("dsh-remote-ui"));
+    && pkg.dsh.profile.bundles.some((b) => PLUGIN_ALL_IDS.includes(b)));
   const marketManaged = dep && !String(dep).startsWith("file:"); // github:/npm: 等由市场/包管理器管源码
   const managedByUs = !dep || String(dep).startsWith("file:");   // 无依赖或 file: 拷贝 → 我们管
 
@@ -729,17 +681,17 @@ function convergePluginActivation(profileDir, pkgFile, patchFile, pluginDir, pat
     const linked = ensurePluginLinked(profileDir, pluginLocalDir); // 自建 node_modules 链接
     stripInclude("bundle patch 已是唯一激活点");     // 清历史 include
     console.log(addedBundle
-      ? "✅ 已加入 dsh.profile.bundles（dsh-remote-ui 自带 patch 自动生效）"
-      : "ℹ dsh.profile.bundles 已含 dsh-remote-ui");
+      ? `✅ 已加入 dsh.profile.bundles（${PLUGIN_ID} 自带 patch 自动生效）`
+      : `ℹ dsh.profile.bundles 已含 ${PLUGIN_ID}`);
     console.log(linked
-      ? `✅ 已建立 node_modules/dsh-remote-ui → ${pluginLocalDir}（免包管理器即可解析）`
-      : "✅ node_modules/dsh-remote-ui 已就绪");
+      ? `✅ 已建立 node_modules/${PLUGIN_ID} → ${pluginLocalDir}（免包管理器即可解析）`
+      : `✅ node_modules/${PLUGIN_ID} 已就绪`);
     console.log(`✅ 插件安装完成（bundle 形态，无用户 include）。配置目录: ${CONFIG_DIR}`);
     return;
   }
 
   // 异常形态：有非 file: 依赖但不在 bundles（无法靠 bundle patch 激活）
-  console.log(`ℹ 检测到依赖 dsh-remote-ui(${dep}) 但未声明在 dsh.profile.bundles——插件不会激活。`);
+  console.log(`ℹ 检测到依赖 ${PLUGIN_ID}(${dep}) 但未声明在 dsh.profile.bundles——插件不会激活。`);
   console.log("   请在 dsh 插件市场重新添加该插件，或先执行 `dsh-remote plugin --uninstall` 再一键安装。");
 }
 
@@ -751,7 +703,7 @@ async function pluginCmd(argv) {
     : process.env.DSH_PROFILE_DIR || path.join(os.homedir(), ".dsh", "profiles", "web");
   const pkgFile = path.join(profileDir, "package.json");
   const patchFile = path.join(profileDir, "cordis.patch.yml");
-  const pluginDir = path.join(THIS_DIR, "packages/dsh-remote-ui");
+  const pluginDir = path.join(THIS_DIR, "packages", PLUGIN_ID);
 
   if (!fs.existsSync(pkgFile) || !fs.existsSync(patchFile)) {
     console.error(`❌ 未找到 dsh web profile（${profileDir}）。`);
@@ -759,31 +711,37 @@ async function pluginCmd(argv) {
     process.exit(1);
   }
   if (!fs.existsSync(pluginDir)) {
-    console.error(`❌ 本包缺少 packages/dsh-remote-ui（${pluginDir}）。`);
+    console.error(`❌ 本包缺少 packages/${PLUGIN_ID}（${pluginDir}）。`);
     process.exit(1);
   }
 
   const patch = fs.readFileSync(patchFile, "utf8");
 
   if (uninstall) {
-    // 移除 patch 中的插件条目（兼容旧版无标记条目）
+    // 移除 patch 中的插件条目（兼容旧版无标记条目；旧名 dsh-remote-ui 一并清理）
     const newPatch = stripPluginEntries(patch);
     if (newPatch !== patch) {
       fs.writeFileSync(patchFile, newPatch);
       console.log(`✅ 已从 ${patchFile} 移除插件条目`);
     } else {
-      console.log("ℹ patch 中未发现 dsh-remote-ui 条目。");
+      console.log(`ℹ patch 中未发现 ${PLUGIN_ID}（或历史名）条目。`);
+    }
+    // 清理本地目录与链接：当前名 + 历史名(dsh-remote-ui-plugin / node_modules/dsh-remote-ui)
+    for (const id of PLUGIN_ALL_IDS) {
+      fs.rmSync(path.join(profileDir, `${id}-plugin`), { recursive: true, force: true });
+      fs.rmSync(path.join(profileDir, "node_modules", id), { recursive: true, force: true });
     }
-    fs.rmSync(path.join(profileDir, PLUGIN_LOCAL_DIR), { recursive: true, force: true });
-    fs.rmSync(path.join(profileDir, "node_modules", "dsh-remote-ui"), { recursive: true, force: true });
     try {
       const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf8"));
-      if (pkg.dependencies) delete pkg.dependencies["dsh-remote-ui"];
-      fs.writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + "\n");
+      let removed = false;
+      for (const id of PLUGIN_ALL_IDS) {
+        if (pkg.dependencies && pkg.dependencies[id] !== undefined) { delete pkg.dependencies[id]; removed = true; }
+      }
+      if (removed) fs.writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + "\n");
     } catch { /* ignore */ }
     // 同步移除 bundles 声明，避免“bundles 引用已删除包 → dsh web 启动报错”
     try {
-      if (removeBundleEntry(pkgFile)) console.log("✅ 已从 dsh.profile.bundles 移除 dsh-remote-ui");
+      if (removeBundleEntry(pkgFile)) console.log(`✅ 已从 dsh.profile.bundles 移除 ${PLUGIN_ID}`);
     } catch { /* ignore */ }
     console.log("✅ 卸载完成。重启 dsh web 生效。");
     return;
@@ -802,7 +760,7 @@ const raw = process.argv[2];
 const cmd = raw && !raw.startsWith("-") ? raw : "setup";
 const args = raw && !raw.startsWith("-") ? process.argv.slice(3) : process.argv.slice(2);
 if (cmd === "setup" || cmd === "install") await setup(args);
-else if (cmd === "settings") serveSettings();
+else if (cmd === "settings") settingsHint();
 else if (cmd === "run") await runBridge();
 else if (cmd === "plugin") await pluginCmd(process.argv.slice(3));
 else if (cmd === "status") {
@@ -811,13 +769,13 @@ 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("远程地址: 运行 settings 查看最新");
+  console.log("远程地址/登录: 打开 dsh web → 设置 → 「远程控制」查看与操作");
 } else {
   console.log(`dsh-remote — 手机远程控制 dsh web（隧道模式）
 
 用法:
   dsh-remote              一键安装（默认命令，无需任何参数；含插件与自启动）
-  dsh-remote settings     打开本地设置页（登录账号 / 自建配置）
+  dsh-remote settings     显示登录/连接配置指引（独立设置页已移除）
   dsh-remote run          前台运行 bridge（调试）
   dsh-remote status       查看配置与服务状态
   dsh-remote plugin       手动安装 dsh web 远程控制插件（--uninstall 卸载）
@@ -825,7 +783,8 @@ else if (cmd === "status") {
 自建模式（可选）:
   dsh-remote setup --server wss://你的域名:端口 --key 访问密钥
 
-登录: 安装后运行 \`dsh-remote settings\`，用手机号+密码登录（或配置自建密钥）。
+登录/连接配置: 打开 dsh web → 设置 → 「远程控制」→ 注册或登录手机号即可
+（自建用户切「自建服务」标签或直接用上方 setup 命令，无需另开页面）。
 文档: ${REPO_URL}
 `);
   process.exit(cmd === "help" ? 0 : 1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.4.8",
+  "version": "0.5.0",
   "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",
@@ -37,7 +37,7 @@
   "files": [
     "dsh-setup.mjs",
     "clients/dsh-remote",
-    "packages/dsh-remote-ui",
+    "packages/dsh-remote-web",
     "docs/self-hosting.md"
   ],
   "workspaces": [
@@ -50,9 +50,9 @@
   "scripts": {
     "test": "npm run test:router && npm run test:plugin && npm run test:bridge",
     "test:router": "node --test packages/relay-router/test/native-device-selection.test.mjs packages/relay-router/test/quotas.test.mjs",
-    "test:plugin": "node --test --test-concurrency=1 packages/dsh-remote-ui/test/*.test.mjs",
+    "test:plugin": "node --test --test-concurrency=1 packages/dsh-remote-web/test/*.test.mjs",
     "test:bridge": "node --test clients/dsh-remote/test/*.test.mjs",
-    "check": "node --check clients/dsh-remote/dsh-bridge.mjs && node --check dsh-setup.mjs && node --check packages/dsh-remote-ui/lib/index.js && node --check packages/dsh-remote-ui/lib/client.js && bash -n deploy/install-open.sh"
+    "check": "node --check clients/dsh-remote/dsh-bridge.mjs && node --check dsh-setup.mjs && node --check packages/dsh-remote-web/lib/index.js && node --check packages/dsh-remote-web/lib/client.js && bash -n deploy/install-open.sh"
   },
   "dependencies": {
     "ws": "^8.18.0"

package/packages/{dsh-remote-ui → dsh-remote-web}/README.md

@@ -1,4 +1,8 @@
-# dsh-remote-ui — 公网远程控制 dsh web 的插件
+# dsh-remote-web — 公网远程控制 dsh web 的插件
+
+> 曾用名 **dsh-remote-ui**（≤0.4.9）；2026-09 更名 **dsh-remote-web** —— 本插件是
+> dsh-remote 全家桶的 **dsh web 插件半**（远程控制宿主插件，不是纯 UI/皮肤插件），
+> 名称与功能定位一致。旧名安装可由新版 `dsh-setup.mjs` 自动迁移/清理。
 
 > **给 DeepSeek Harness（dsh web）一个「随时随地」的公网入口。**
 > 安装后在 dsh web 的设置页登录账号，即得到一个专属的**加密远程地址**：人在办公室外、
@@ -57,8 +61,8 @@ npx @mrrisega/dsh-remote plugin --uninstall
 
 What it does:
 
-- `package.json` dependency: `"dsh-remote-ui": "link:<包目录>/packages/dsh-remote-ui"`
-- `cordis.patch.yml` insert: `{ id: dsh-remote-ui, name: 'dsh-remote-ui', config: { relayDir: '~/.dsh-remote' } }`
+- `package.json` dependency: `"dsh-remote-web": "link:<包目录>/packages/dsh-remote-web"`
+- `cordis.patch.yml` insert: `{ id: dsh-remote-web, name: 'dsh-remote-web', config: { relayDir: '~/.dsh-remote' } }`
 - runs `pnpm install` (fallback `npm install`) in the profile
 
 Restart `dsh web` afterwards. Manual alternative: edit the two files above and
@@ -75,7 +79,7 @@ restart.
 dsh --profile web --port 3090 --no-open   # verify on a separate port, 3080 untouched
 ```
 
-Verify: `/` `__DSH_BOOT__` contains `dsh-remote-ui`; `/plugins/dsh-remote-ui/client.js`
+Verify: `/` `__DSH_BOOT__` contains `dsh-remote-web`; `/plugins/dsh-remote-web/client.js`
 200; `/dsh-remote/status` returns JSON; panel renders in headless Chrome.
 
 ## Known limitations

package/packages/{dsh-remote-ui → dsh-remote-web}/cordis.patch.yml

@@ -1,7 +1,7 @@
-# dsh-remote-ui — dsh web 远程控制插件（dsh-remote 的插件半）
+# dsh-remote-web — dsh web 远程控制插件（dsh-remote 的插件半）
 # 提供设置页「远程控制」面板与同源 /dsh-remote/* 路由。
 # relayDir 默认取 ~/.dsh-remote（与 npx @mrrisega/dsh-remote 写入的
 # .dsh-config.json 相同），也可在面板或 entry config 中覆盖。
 - insert:
-    - id: dsh-remote-ui
-      name: 'dsh-remote-ui'
+    - id: dsh-remote-web
+      name: 'dsh-remote-web'

package/packages/{dsh-remote-ui → dsh-remote-web}/lib/client.js

@@ -1,4 +1,4 @@
-// dsh-remote-ui — browser half（手写 bundle，无需构建）
+// dsh-remote-web — browser half（手写 bundle，无需构建）
 //
 // 格式遵循 dsh 浏览器插件约定（双半插件，bundle 手写无构建）：
 //   window.__ModuleLoader__.load({ id: <包名>, factory: (require) => {...} })
@@ -14,7 +14,7 @@
 //   - shell.overlay：满意度弹窗（安装体验至少 1 小时后弹出，只弹一次）
 // 所有数据经同源 /dsh-remote/* 宿主路由读写（node 半提供）。
 window.__ModuleLoader__.load({
-  id: "dsh-remote-ui",
+  id: "dsh-remote-web",
   factory: (require) => {
     var module = { exports: {} };
     var exports = module.exports;
@@ -31,7 +31,7 @@ window.__ModuleLoader__.load({
     // 面板主体内嵌于 DSH Web「设置」页的 settings.section 栏目（官方扩展点），
     // 不再使用侧边栏入口与全窗浮动层，故不再需要 .dru-entry/.dru-backdrop/.dru-panel。
     var styleEl = document.createElement("style");
-    styleEl.setAttribute("data-plugin", "dsh-remote-ui");
+    styleEl.setAttribute("data-plugin", "dsh-remote-web");
     styleEl.textContent = [
       // 设置页栏目容器（nav 选中后渲染在 settings.section 内容区）
       ".dru-settings-section{max-width:720px;display:flex;flex-direction:column;gap:14px;padding-top:2px}",

package/packages/{dsh-remote-ui → dsh-remote-web}/lib/index.js

@@ -1,4 +1,4 @@
-// dsh-remote-ui — node half (host plugin)
+// dsh-remote-web — node half (host plugin)（2026-09 由 dsh-remote-web 更名；卸载/清理兼容旧名）
 //
 // 提供 /dsh-remote/* 同源 HTTP 路由，供浏览器半的配置面板调用：
 //   - 读写 dsh-remote-open/.dsh-config.json（0600）
@@ -144,7 +144,7 @@ function sweepStaleMarkers(relayDir) {
     if (dead === false || (dead === null && expired)) {
       try { rmSync(p, { force: true }); } catch { /* ignore */ }
       appendLogLine(relayDir, AUTO_INSTALL_LOG,
-        `[dsh-remote-ui] 清理残留标记 ${name}（pid=${info.pid ?? "?"}, at=${new Date(info.at).toISOString()}${dead === false ? ", 进程已死" : ", 已超时"}）`);
+        `[dsh-remote-web] 清理残留标记 ${name}（pid=${info.pid ?? "?"}, at=${new Date(info.at).toISOString()}${dead === false ? ", 进程已死" : ", 已超时"}）`);
     }
   }
 }
@@ -392,13 +392,13 @@ function ensureRuntime(relayDir) {
     child.on("error", (e) => {
       clear();
       appendLogLine(relayDir, AUTO_INSTALL_LOG, `[auto-install] 启动失败: ${e.message}`);
-      console.warn(`[dsh-remote-ui] 自动安装子进程启动失败: ${e.message}`);
+      console.warn(`[dsh-remote-web] 自动安装子进程启动失败: ${e.message}`);
     });
     child.unref();
-    console.log(`[dsh-remote-ui] 检测到缺少桌面运行环境,已在后台自动安装(日志: ${log}),完成后将自动启动 bridge`);
+    console.log(`[dsh-remote-web] 检测到缺少桌面运行环境,已在后台自动安装(日志: ${log}),完成后将自动启动 bridge`);
     return false;
   } catch (e) {
-    console.warn(`[dsh-remote-ui] 自动安装启动失败: ${e.message}`);
+    console.warn(`[dsh-remote-web] 自动安装启动失败: ${e.message}`);
     try { rmSync(marker, { force: true }); } catch { /* ignore */ }
     return false;
   }
@@ -789,7 +789,7 @@ async function proxyFeedback(relayDir, req, res, pathname) {
   const url = new URL(suffix.replace(/^\//, ""), base);
   const headers = {
     "x-dsh-device": cfg.device_id || "",
-    "x-dsh-client": "dsh-remote-ui/0.1.0",
+    "x-dsh-client": `dsh-remote-web/${PLUGIN_VERSION}`,
   };
   if (cfg.phone) headers["x-dsh-phone"] = String(cfg.phone);
   const auth = req.headers.authorization;
@@ -836,8 +836,13 @@ async function proxyFeedback(relayDir, req, res, pathname) {
 
 // ---------- 自管理：版本 / 在线更新 / 彻底卸载（面板内“版本与更新”卡片） ----------
 
+/** 插件 id / 包名（2026-09 由 dsh-remote-ui 更名）。 */
+const PLUGIN_ID = "dsh-remote-web";
+/** 更名前 id（≤0.4.9）：彻底卸载/清理时一并移除，防旧拷贝残留。 */
+const PLUGIN_LEGACY_IDS = ["dsh-remote-ui"];
+const PLUGIN_ALL_IDS = [PLUGIN_ID, ...PLUGIN_LEGACY_IDS];
 /** 插件自身发布版本（与 dsh-remote 根包同步递增）。 */
-const PLUGIN_VERSION = "0.4.8";
+const PLUGIN_VERSION = "0.5.0";
 const UPDATE_LOG = ".dsh-update.log";
 const UPDATE_MARKER = ".dsh-update-running";
 
@@ -925,25 +930,37 @@ function uninstallSelf(relayDir, profileDir, patchFile, pkgFile) {
   const out = { removedPatch: false, removedDep: false, removedDir: false, removedBundle: false };
   try {
     const patch = readFileSync(patchFile, "utf8");
+    // 兼容当前与历史（dsh-remote-ui）两种管理标记
     const cleaned = patch
-      .replace(/\n?# >>> dsh-remote-ui .*?# <<< dsh-remote-ui\s*/s, "\n")
+      .replace(/\n?# >>> dsh-remote-(?:web|ui) .*?# <<< dsh-remote-(?:web|ui)\s*/s, "\n")
       .replace(/\n{3,}/g, "\n\n")
       .trimEnd() + "\n";
     if (cleaned !== patch) { writeFileSync(patchFile, cleaned); out.removedPatch = true; }
   } catch { /* 无 patch 忽略 */ }
   try {
     const pkg = JSON.parse(readFileSync(pkgFile, "utf8"));
-    if (pkg.dependencies && pkg.dependencies["dsh-remote-ui"]) { delete pkg.dependencies["dsh-remote-ui"]; out.removedDep = true; }
+    if (pkg.dependencies) {
+      let removed = false;
+      for (const id of PLUGIN_ALL_IDS) {
+        if (pkg.dependencies[id] !== undefined) { delete pkg.dependencies[id]; removed = true; }
+      }
+      if (removed) out.removedDep = true;
+    }
     const bundles = pkg.dsh && pkg.dsh.profile && Array.isArray(pkg.dsh.profile.bundles) ? pkg.dsh.profile.bundles : null;
     if (bundles) {
-      const i = bundles.indexOf("dsh-remote-ui");
-      if (i >= 0) { bundles.splice(i, 1); out.removedBundle = true; }
+      const filtered = bundles.filter((b) => !PLUGIN_ALL_IDS.includes(b));
+      if (filtered.length !== bundles.length) {
+        pkg.dsh.profile.bundles = filtered;
+        out.removedBundle = true;
+      }
     }
     if (out.removedDep || out.removedBundle) writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + "\n");
   } catch { /* 无 package.json 忽略 */ }
   try {
-    rmSync(join(profileDir, "dsh-remote-ui-plugin"), { recursive: true, force: true });
-    rmSync(join(profileDir, "node_modules", "dsh-remote-ui"), { recursive: true, force: true });
+    for (const id of PLUGIN_ALL_IDS) {
+      rmSync(join(profileDir, `${id}-plugin`), { recursive: true, force: true });
+      rmSync(join(profileDir, "node_modules", id), { recursive: true, force: true });
+    }
     out.removedDir = true;
   } catch { /* ignore */ }
   return out;
@@ -957,8 +974,10 @@ function registerRoutes(ctx, relayDir) {
   let profileDir = join(homedir(), ".dsh", "profiles", "web");
   try {
     const here = fileURLToPath(import.meta.url);
-    // 依次尝试两种安装布局；split()[0] 未命中时返回原串，需显式判断后再试下一种
-    let m = here.split("/dsh-remote-ui-plugin/")[0];
+    // 依次尝试两种安装布局（当前名优先，历史名兜底）；split()[0] 未命中时返回原串，需显式判断后再试下一种
+    let m = here.split("/dsh-remote-web-plugin/")[0];
+    if (m === here) m = here.split("/node_modules/dsh-remote-web/")[0];
+    if (m === here) m = here.split("/dsh-remote-ui-plugin/")[0];
     if (m === here) m = here.split("/node_modules/dsh-remote-ui/")[0];
     if (m !== here) profileDir = m;
   } catch { /* 保持默认 */ }
@@ -1272,7 +1291,7 @@ function registerRoutes(ctx, relayDir) {
           return;
         }
         Promise.resolve(route.handler(req, res)).catch((e) => {
-          ctx.logger?.warn?.(`dsh-remote-ui: ${route.method} ${route.path} failed: ${e?.stack || e}`);
+          ctx.logger?.warn?.(`dsh-remote-web: ${route.method} ${route.path} failed: ${e?.stack || e}`);
           if (!res.headersSent) sendJson(res, 500, { ok: false, error: String(e?.message || e) });
           else res.end();
         });
@@ -1297,10 +1316,10 @@ export function apply(ctx, config = {}) {
   UNINSTALLED_DIRS.delete(relayDir);
   // 清理上次进程残留的安装/更新 marker（宿主被重启/强杀时子进程清理回调会丢失）
   sweepStaleMarkers(relayDir);
-  ctx.effect(() => registerRoutes(ctx, relayDir), "dsh-remote-ui: /dsh-remote routes");
+  ctx.effect(() => registerRoutes(ctx, relayDir), "dsh-remote-web: /dsh-remote routes");
   // 0.1.2-rc.1+ 浏览器会话代持：换取 Harness 会话 Cookie 供 bridge 上游携带（手机点设备不再 401 白页）
-  ctx.effect(() => scheduleHarnessMint(ctx, relayDir), "dsh-remote-ui: harness browser-session mint");
+  ctx.effect(() => scheduleHarnessMint(ctx, relayDir), "dsh-remote-web: harness browser-session mint");
   // 插件市场一键全功能:缺桌面运行环境则自动安装,登录后自动拉起 bridge(不依赖用户跑 npx)
-  ctx.effect(() => scheduleRuntime(relayDir), "dsh-remote-ui: runtime self-provision");
-  ctx.logger?.info?.(`dsh-remote-ui: /dsh-remote routes ready (relayDir=${relayDir})`);
+  ctx.effect(() => scheduleRuntime(relayDir), "dsh-remote-web: runtime self-provision");
+  ctx.logger?.info?.(`dsh-remote-web: /dsh-remote routes ready (relayDir=${relayDir})`);
 }

package/packages/{dsh-remote-ui → dsh-remote-web}/package.json

@@ -1,7 +1,7 @@
 {
-  "name": "dsh-remote-ui",
-  "version": "0.1.0",
-  "description": "公网远程控制 DeepSeek Harness（dsh web）：安装即得专属加密地址，人在外面也能用手机访问电脑上的 dsh——无需同一局域网/WiFi、无需公网 IP 与内网穿透，全程加密；手机端 100% 还原电脑体验（对话/工具/审批/设置）。技术用户可选自建服务，流量走自己的服务器。Remote control DeepSeek Harness (dsh web) from anywhere over the public internet — install, get an encrypted URL, use it from your phone on any network (dual-half cordis plugin: Settings panel + same-origin /dsh-remote routes).",
+  "name": "dsh-remote-web",
+  "version": "0.5.0",
+  "description": "公网远程控制 DeepSeek Harness（dsh web）：安装即得专属加密地址，人在外面也能用手机访问电脑上的 dsh——无需同一局域网/WiFi、无需公网 IP 与内网穿透，全程加密；手机端 100% 还原电脑体验（对话/工具/审批/设置）。技术用户可选自建服务，流量走自己的服务器。Remote control DeepSeek Harness (dsh web) from anywhere over the public internet — install, get an encrypted URL, use it from your phone on any network (dual-half cordis plugin: Settings panel + same-origin /dsh-remote routes). (2026-09 由 dsh-remote-ui 更名 / renamed from dsh-remote-ui; dsh-remote 的 dsh web 插件半，不是纯 UI/皮肤插件)",
   "type": "module",
   "main": "lib/index.js",
   "exports": {
@@ -33,11 +33,11 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/mrRisega/dsh-remote.git",
-    "directory": "packages/dsh-remote-ui"
+    "directory": "packages/dsh-remote-web"
   },
   "bugs": {
     "url": "https://github.com/mrRisega/dsh-remote/issues"
   },
-  "homepage": "https://github.com/mrRisega/dsh-remote/tree/main/packages/dsh-remote-ui#readme",
+  "homepage": "https://github.com/mrRisega/dsh-remote/tree/main/packages/dsh-remote-web#readme",
   "license": "PolyForm-Noncommercial-1.0.0"
 }

package/packages/{dsh-remote-ui → dsh-remote-web}/test/feedback-proxy.test.mjs

@@ -58,7 +58,7 @@ test("反馈代理：附加设备身份/手机号，透传 thread_token", async
     assert.equal(echo.url, "/api/feedback");
     assert.equal(echo.headers["x-dsh-device"], "dev-testproxy123");
     assert.equal(echo.headers["x-dsh-phone"], "13800000000");
-    assert.equal(echo.headers["x-dsh-client"], "dsh-remote-ui/0.1.0");
+    assert.equal(echo.headers["x-dsh-client"], "dsh-remote-web/0.5.0");
     assert.equal(echo.headers.authorization, "Bearer thread-token-abc");
     assert.equal(echo.body.category, "bug");
 

package/packages/{dsh-remote-ui → dsh-remote-web}/test/settings-entry.test.mjs

@@ -1,4 +1,4 @@
-// dsh-remote-ui 浏览器半回归：面板入口迁移进「设置」页 settings.section 官方扩展点。
+// dsh-remote-web 浏览器半回归（2026-09 前名 dsh-remote-ui）：面板入口迁移进「设置」页 settings.section 官方扩展点。
 // 覆盖：栏目注册（id/order/label）、侧边栏入口与浮动面板移除、账号区无「切换账号」、
 // 「关于 dsh-remote」说明卡片、退出登录/切换连接账号清理反馈线程凭据、首次安装红点引导。
 import assert from "node:assert/strict";