@mrrisega/dsh-remote 0.4.9 → 0.5.0

package/README.md

@@ -77,7 +77,7 @@ npx @mrrisega/dsh-remote setup --server wss://<你的域名>:端口 --key <访
 `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 与本地文件，之后市场卸载或直接重启均可完成卸载）。
@@ -109,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

@@ -44,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 {
@@ -462,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 = [];
@@ -501,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;
       }
@@ -535,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, {
@@ -555,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 { /* 缺失/悬空 → 重建 */ }
@@ -576,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: 拷贝 → 我们管
 
@@ -651,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` 再一键安装。");
 }
 
@@ -673,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}）。`);
@@ -681,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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.4.9",
+  "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.9";
+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";