@mrrisega/dsh-remote 0.8.2-beta.2 → 0.8.2

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

@@ -189,7 +189,7 @@ let UPSTREAM = (() => {
 // 微信机器人通道总开关:DSH_WECHAT=0 关闭(默认开启)。控制面只 bind 回环,且必须带 bridge_secret。
 const WECHAT_DISABLED = String(process.env.DSH_WECHAT || "") === "0";
 // 默认云端服务地址（dsh-remote setup 会显式传入；自建模式无需账号 API）
-const API_BASE = (process.env.DSH_BRIDGE_API || "https://n.risegao.cn:13443/relay-api").replace(/\/+$/, "");
+const API_BASE = (process.env.DSH_BRIDGE_API || "https://dsh.ruichengai.com:13443/relay-api").replace(/\/+$/, "");
 const EMAIL = process.env.DSH_BRIDGE_EMAIL || "";
 // 手机号优先;兼容旧的 DSH_BRIDGE_EMAIL(过渡期)
 const PHONE = process.env.DSH_BRIDGE_PHONE || EMAIL;

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

@@ -908,7 +908,7 @@ const SCRIPT = `(() => {
   void 0;
 
 
-  /* —— 主机门解除(2026-09):镜像页(如 n.risegao.cn)经设备流认证回连同一台 127.0.0.1:3080,
+  /* —— 主机门解除(2026-09):镜像页(如 n.risegao.cn / dsh.ruichengai.com)经设备流认证回连同一台 127.0.0.1:3080,
      桥已把 Host 回环化并剥 Origin(不扩大信任面)。官方客户端以 transport.ownsHost 判定
      「自有主机」,非回环域名下不置 true 会把设置页置为 memory(不可用)镜像 →
      模型/提供方设置无法加载(“Settings are unavailable in this browser”)。

package/dsh-setup.mjs

@@ -44,9 +44,29 @@ const CONFIG_DIR = process.env.DSH_RELAY_DIR || path.join(os.homedir(), ".dsh-re
 const CONFIG_PATH = path.join(CONFIG_DIR, ".dsh-config.json");
 // 默认云端服务地址（服务商 SaaS 入口；自建用户用 --server/--key 指向自己的 router）
 // DSH_RELAY_DEFAULT_API 可覆盖（测试脚本指向本地死端口，避免兜底路径打到生产）。
+// 【2026-11-14 企业域名迁移】官方 SaaS 入口 → dsh.ruichengai.com（旧域名仍在服役，双域名并存）
 const DEFAULT_API = String(process.env.DSH_RELAY_DEFAULT_API || "").trim()
-  || "https://n.risegao.cn:13443/relay-api";
-const DEFAULT_APP_URL = "https://n.risegao.cn:13443/app/";
+  || "https://dsh.ruichengai.com:13443/relay-api";
+const DEFAULT_APP_URL = "https://dsh.ruichengai.com:13443/app/";
+
+/** 官方云端「旧域名 → 新域名」映射。只认 hostname 精确匹配，自建地址原样返回。 */
+const OFFICIAL_HOST_MIGRATION = new Map([["n.risegao.cn", "dsh.ruichengai.com"]]);
+
+/** 把官方旧域名改写成新域名（保留端口/路径）；其它地址原样返回。与插件半同规则。 */
+function migrateOfficialUrl(raw) {
+  const s = String(raw == null ? "" : raw).trim();
+  if (!s) return s;
+  let u;
+  try {
+    u = new URL(s);
+  } catch {
+    return s;
+  }
+  const to = OFFICIAL_HOST_MIGRATION.get(u.hostname);
+  if (!to) return s;
+  u.hostname = to;
+  return u.toString().replace(/\/+$/, "");
+}
 const REPO_URL = "https://github.com/mrRisega/dsh-remote";
 
 // ---------- 平台（0.6.7 起支持 Windows） ----------
@@ -538,7 +558,9 @@ function deriveTunnelUrl(apiUrl) {
 function applySaaSMode(cfg) {
   delete cfg.local_key;
   delete cfg.server; // 旧字段兜底
-  cfg.api_url = String(cfg.api_url || DEFAULT_API).replace(/\/+$/, "");
+  // 2026-11-14 企业域名迁移：存量配置里的官方旧域名顺手改写（幂等，自建地址不动）
+  const api = migrateOfficialUrl(String(cfg.api_url || DEFAULT_API).replace(/\/+$/, ""));
+  cfg.api_url = api || DEFAULT_API;
   cfg.tunnel_url = deriveTunnelUrl(cfg.api_url);
   return cfg;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.8.2-beta.2",
+  "version": "0.8.2",
   "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",

package/packages/dsh-remote-web/lib/client.js

@@ -2071,7 +2071,7 @@ window.__ModuleLoader__.load({
     //   注意：被邀请人**没有任何额外奖励**（trial_days = 0），所以禁止任何「双方都得」的写法。
     var INVITE_RULE_FALLBACK = { n: 1, days: 3 };
     // ── 套餐约定：**先读线上真形状** ─────────────────────────────────────────
-    // 线上实测（GET https://n.risegao.cn:13443/relay-api/api/public-config）：
+    // 线上实测（GET https://dsh.ruichengai.com:13443/relay-api/api/public-config）：
     //   plans.free    = { max_mbps: 1,  monthly_gb: 1 }
     //   plans.pro     = { max_mbps: 5,  monthly_gb: 20, devices: 1,  monthly_resets: 5 }
     //   plans.pro_max = { max_mbps: 10, monthly_gb: 60, devices: 10, online: 3 }
@@ -2549,7 +2549,7 @@ window.__ModuleLoader__.load({
           var acct = (b && b.ok && b.account) ? b.account : null;
           if (!acct || !acct.invite_code) { setPopupInvite({ code: "" }); return; }
           api("/dsh-remote/remote-url").then(function (u) {
-            var base = (u && u.remoteUrl) || "https://n.risegao.cn:13443/app/";
+            var base = (u && u.remoteUrl) || "https://dsh.ruichengai.com:13443/app/";
             // 特性检测：public-config 里带了 invite_rule 就用服务端数值；没带 → 0 = 不显示具体数字。
             // 🔒 用 firstNum 只判「缺没缺」：`n/days` 配成 0 是合法的「活动关闭」态，
             //    不能被 `> 0` 这样写吃掉再回落成 1/3（后端 `|| 3 / || 15` 的同款坑）。
@@ -5413,7 +5413,7 @@ window.__ModuleLoader__.load({
         var ruleDays = inv.days;
         var trialDays = Number(pub && pub.trial_days) > 0 ? Number(pub.trial_days) : 0; // 注册送礼（关闭时不下发/为 0）
         var code = (account && account.invite_code) || "";
-        var base = (st && st.remoteUrl) || (pub && pub.app_url) || "https://n.risegao.cn:13443/app/";
+        var base = (st && st.remoteUrl) || (pub && pub.app_url) || "https://dsh.ruichengai.com:13443/app/";
         var link = code ? base.replace(/\/+$/, "") + "/?invite=" + encodeURIComponent(code) : "";
         var loggedInSaaS = !!(st && st.config && st.config.phone);
         var records = (inviteData && inviteData.records) || [];

package/packages/dsh-remote-web/lib/index.js

@@ -92,9 +92,43 @@ const DEFAULT_RELAY_DIR = process.env.DSH_RELAY_DIR || join(homedir(), ".dsh-rem
 // DSH_RELAY_DEFAULT_API 只改「配置里根本没写 api_url」时的兜底：测试脚本把它指向本地死端口，
 // 这样任何**在临时目录被拆掉之后**才跑到的后台请求（如装机上报的重试）都不会打生产。
 // 真实故障形态见 test/wechat-bind-telemetry.test.mjs 的注释：用例拆目录 → 读到空配置 → 回落生产。
+//
+// 【2026-11-14 企业域名迁移】官方 SaaS 入口从 n.risegao.cn 迁到 dsh.ruichengai.com。
+// 这里只改「新装默认值」；存量用户配置由 migrateOfficialUrl() 在装载/启动时一次性改写。
+// 两个域名在 NAS 上是**并存**的（同一套后端、各自证书），所以迁移期间谁都不会断。
 const DEFAULT_API = String(process.env.DSH_RELAY_DEFAULT_API || "").trim()
-  || "https://n.risegao.cn:13443/relay-api";
-const DEFAULT_APP_URL = "https://n.risegao.cn:13443/app/";
+  || "https://dsh.ruichengai.com:13443/relay-api";
+const DEFAULT_APP_URL = "https://dsh.ruichengai.com:13443/app/";
+
+/**
+ * 官方云端的「旧域名 → 新域名」映射（2026-11-14）。
+ *
+ * 为什么需要它：存量用户 `.dsh-config.json` 里写死的是
+ * `https://n.risegao.cn:13443/relay-api`。只改默认值的话，**老用户永远还在连旧域名**，
+ * 而产品预期是「升级上去就用新域名」。所以装载时做一次幂等改写。
+ *
+ * 边界（故意收得很窄，别扩大）：
+ *   · 只认 **hostname 精确等于**旧官方域名；自建/自定义地址一律原样返回；
+ *   · 端口、路径、查询串全部保留（内网自建用户即便解析到同名 host 也不受影响）；
+ *   · 非法 URL 原样返回，绝不抛错。
+ */
+const OFFICIAL_HOST_MIGRATION = new Map([["n.risegao.cn", "dsh.ruichengai.com"]]);
+
+/** 把官方旧域名改写成新域名（保留端口/路径），其它地址原样返回。纯函数，便于单测。 */
+export function migrateOfficialUrl(raw) {
+  const s = String(raw == null ? "" : raw).trim();
+  if (!s) return s;
+  let u;
+  try {
+    u = new URL(s);
+  } catch {
+    return s;
+  }
+  const to = OFFICIAL_HOST_MIGRATION.get(u.hostname);
+  if (!to) return s;
+  u.hostname = to;
+  return u.toString().replace(/\/+$/, "");
+}
 
 // ---------- 上游 dsh web 地址（bridge/watcher 都要连它，绝不写死 3080） ----------
 //
@@ -772,11 +806,41 @@ function saveConfig(relayDir, cfg) {
 function applySaaSMode(cfg) {
   delete cfg.local_key;
   delete cfg.server;
-  cfg.api_url = String(cfg.api_url || DEFAULT_API).replace(/\/+$/, "");
+  // 2026-11-14 企业域名迁移：存量配置里的官方旧域名顺手改写（幂等，自建地址不动）
+  const api = migrateOfficialUrl(String(cfg.api_url || DEFAULT_API).replace(/\/+$/, ""));
+  cfg.api_url = api || DEFAULT_API;
   cfg.tunnel_url = cfg.api_url.replace(/\/relay-api\/?$/, "").replace(/^https/, "wss");
   return cfg;
 }
 
+/**
+ * 装载时的一次性域名迁移（2026-11-14 企业域名迁移）。
+ *
+ * 与 applySaaSMode 里的改写互补：那条只在「登录 / 启动桥」时跑，本条让**插件一装载**
+ * 就把配置摆正，避免刷新页面后仍有一段时间打旧域名。
+ * 幂等：已迁移过就什么都不做；自建模式（有 local_key）与自定义地址一律不动。
+ */
+function migrateLegacyConfigAtBoot(relayDir, ctx) {
+  try {
+    const cfg = loadConfig(relayDir);
+    if (!cfg || !cfg.api_url || cfg.local_key) return false;
+    const next = migrateOfficialUrl(cfg.api_url);
+    if (!next || next === cfg.api_url) return false;
+    cfg.api_url = next;
+    // 隧道地址只在它**也指向官方旧域名**时才改写：自建用户可能留着自定义 tunnel_url，
+    // 没有 local_key 的老配置也不能被顺手改掉（那会让桥连到别人的服务器）。
+    if (cfg.tunnel_url) {
+      const tunnel = migrateOfficialUrl(cfg.tunnel_url);
+      if (tunnel) cfg.tunnel_url = tunnel;
+    }
+    saveConfig(relayDir, cfg);
+    ctx?.logger?.info?.("dsh-remote-web: 云端地址已迁移到企业域名 dsh.ruichengai.com");
+    return true;
+  } catch {
+    return false; // 迁移失败绝不影响装载
+  }
+}
+
 // ---------- 安装/配对自检 + 配对信息备份（2026-10-17 事故） ----------
 //
 // 事故：用户本机 `~/.dsh-remote`（bridge 运行时 + **账号配对信息/设备密钥**）被误删 →
@@ -3826,7 +3890,7 @@ async function communityInfo(relayDir) {
  * 软着陆：public-config 不可达 / 非对象 / 字段缺失全部回兜底并 `ok:true`。
  * 协议链接**永远不该**成为购买流程的故障点（打不开也不影响旁边的「升级 / 续费」按钮）。
  */
-export const DEFAULT_PURCHASE_AGREEMENT_URL = "https://n.risegao.cn:13443/relay-api/api/purchase-agreement";
+export const DEFAULT_PURCHASE_AGREEMENT_URL = "https://dsh.ruichengai.com:13443/relay-api/api/purchase-agreement";
 
 /** 从 public-config 解析协议 URL（纯函数，便于单测：优先级 + 安全过滤 + 降级一次看完）。 */
 export function purchaseAgreementUrlFrom(publicConfig) {
@@ -9662,6 +9726,9 @@ export function apply(ctx, config = {}) {
   // 记住宿主 ctx：上游地址要问 dsh web 自己的监听端口（见 upstreamUrl）。
   // 存 ctx 而不是当场取端口：apply 可能早于 webServer.listen 完成，端口那时还是 0/undefined。
   webServerCtx = ctx;
+  // 2026-11-14 企业域名迁移：存量配置里的官方旧域名（n.risegao.cn）一次性改写到
+  // dsh.ruichengai.com。幂等；自建模式（有 local_key）一律不动。
+  migrateLegacyConfigAtBoot(relayDir, ctx);
   // 上游地址落盘（0.6.12）：系统自启拉起的守护没有本进程的 env，只认这个文件。
   publishUpstream(relayDir);
   // 【0.6.15】问不到自己监听端口时（飞牛/NAS 实测就是这种情况）主动发现一次并固化：

package/packages/dsh-remote-web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-web",
-  "version": "0.8.2-beta.2",
+  "version": "0.8.2",
   "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",

package/packages/dsh-remote-web/runtime/clients/dsh-remote/dsh-bridge.mjs

@@ -189,7 +189,7 @@ let UPSTREAM = (() => {
 // 微信机器人通道总开关:DSH_WECHAT=0 关闭(默认开启)。控制面只 bind 回环,且必须带 bridge_secret。
 const WECHAT_DISABLED = String(process.env.DSH_WECHAT || "") === "0";
 // 默认云端服务地址（dsh-remote setup 会显式传入；自建模式无需账号 API）
-const API_BASE = (process.env.DSH_BRIDGE_API || "https://n.risegao.cn:13443/relay-api").replace(/\/+$/, "");
+const API_BASE = (process.env.DSH_BRIDGE_API || "https://dsh.ruichengai.com:13443/relay-api").replace(/\/+$/, "");
 const EMAIL = process.env.DSH_BRIDGE_EMAIL || "";
 // 手机号优先;兼容旧的 DSH_BRIDGE_EMAIL(过渡期)
 const PHONE = process.env.DSH_BRIDGE_PHONE || EMAIL;

package/packages/dsh-remote-web/runtime/clients/dsh-remote/mobile-adapter.mjs

@@ -908,7 +908,7 @@ const SCRIPT = `(() => {
   void 0;
 
 
-  /* —— 主机门解除(2026-09):镜像页(如 n.risegao.cn)经设备流认证回连同一台 127.0.0.1:3080,
+  /* —— 主机门解除(2026-09):镜像页(如 n.risegao.cn / dsh.ruichengai.com)经设备流认证回连同一台 127.0.0.1:3080,
      桥已把 Host 回环化并剥 Origin(不扩大信任面)。官方客户端以 transport.ownsHost 判定
      「自有主机」,非回环域名下不置 true 会把设置页置为 memory(不可用)镜像 →
      模型/提供方设置无法加载(“Settings are unavailable in this browser”)。

package/packages/dsh-remote-web/runtime/clients/dsh-web/native.html

@@ -328,7 +328,8 @@
  * 本页面同时被 SaaS 与自建部署使用;自建部署(其他域名)不加载、不采集任何数据。 */
 var _hmt = _hmt || [];
 (function() {
-  if (location.hostname !== "n.risegao.cn") return; // 非官方 SaaS 域名:跳过采集
+  // 官方 SaaS 域名集合（2026-11-14 企业域名迁移：新旧域名并存，两个都算官方）
+  if (["n.risegao.cn", "dsh.ruichengai.com"].indexOf(location.hostname) === -1) return; // 非官方 SaaS 域名:跳过采集
   var hm = document.createElement("script");
   hm.src = "https://hm.baidu.com/hm.js?9ec1d21cfebe4404b427e8fb44289f42";
   var s = document.getElementsByTagName("script")[0];
@@ -346,7 +347,7 @@ var _hmt = _hmt || [];
   <button id="btn-logout" class="hidden">退出</button>
   <span id="dsh-e2ee-badge" class="hidden" title="端到端加密状态"></span>
   <div class="spacer"></div>
-  <a class="nav-link" href="https://n.risegao.cn:8085/" target="_blank" rel="noopener">官网</a>
+  <a class="nav-link" href="https://dsh.ruichengai.com:8085/" target="_blank" rel="noopener">官网</a>
 </header>
 
 <main id="view-main">

package/packages/dsh-remote-web/runtime/dsh-setup.mjs

@@ -44,9 +44,29 @@ const CONFIG_DIR = process.env.DSH_RELAY_DIR || path.join(os.homedir(), ".dsh-re
 const CONFIG_PATH = path.join(CONFIG_DIR, ".dsh-config.json");
 // 默认云端服务地址（服务商 SaaS 入口；自建用户用 --server/--key 指向自己的 router）
 // DSH_RELAY_DEFAULT_API 可覆盖（测试脚本指向本地死端口，避免兜底路径打到生产）。
+// 【2026-11-14 企业域名迁移】官方 SaaS 入口 → dsh.ruichengai.com（旧域名仍在服役，双域名并存）
 const DEFAULT_API = String(process.env.DSH_RELAY_DEFAULT_API || "").trim()
-  || "https://n.risegao.cn:13443/relay-api";
-const DEFAULT_APP_URL = "https://n.risegao.cn:13443/app/";
+  || "https://dsh.ruichengai.com:13443/relay-api";
+const DEFAULT_APP_URL = "https://dsh.ruichengai.com:13443/app/";
+
+/** 官方云端「旧域名 → 新域名」映射。只认 hostname 精确匹配，自建地址原样返回。 */
+const OFFICIAL_HOST_MIGRATION = new Map([["n.risegao.cn", "dsh.ruichengai.com"]]);
+
+/** 把官方旧域名改写成新域名（保留端口/路径）；其它地址原样返回。与插件半同规则。 */
+function migrateOfficialUrl(raw) {
+  const s = String(raw == null ? "" : raw).trim();
+  if (!s) return s;
+  let u;
+  try {
+    u = new URL(s);
+  } catch {
+    return s;
+  }
+  const to = OFFICIAL_HOST_MIGRATION.get(u.hostname);
+  if (!to) return s;
+  u.hostname = to;
+  return u.toString().replace(/\/+$/, "");
+}
 const REPO_URL = "https://github.com/mrRisega/dsh-remote";
 
 // ---------- 平台（0.6.7 起支持 Windows） ----------
@@ -538,7 +558,9 @@ function deriveTunnelUrl(apiUrl) {
 function applySaaSMode(cfg) {
   delete cfg.local_key;
   delete cfg.server; // 旧字段兜底
-  cfg.api_url = String(cfg.api_url || DEFAULT_API).replace(/\/+$/, "");
+  // 2026-11-14 企业域名迁移：存量配置里的官方旧域名顺手改写（幂等，自建地址不动）
+  const api = migrateOfficialUrl(String(cfg.api_url || DEFAULT_API).replace(/\/+$/, ""));
+  cfg.api_url = api || DEFAULT_API;
   cfg.tunnel_url = deriveTunnelUrl(cfg.api_url);
   return cfg;
 }

package/packages/dsh-remote-web/test/official-domain-migration.test.mjs

@@ -0,0 +1,160 @@
+/**
+ * 官方域名迁移契约（2026-11-14 企业域名迁移：n.risegao.cn → dsh.ruichengai.com）
+ *
+ * 为什么必须钉住：
+ *   ① 默认值散在三处（插件半 lib/index.js、桥半 dsh-bridge.mjs、安装器 dsh-setup.mjs），
+ *      只改一处就会出现"新装用新域名、却把用户带去旧域名"的半吊子状态；
+ *   ② 存量用户配置里写的是旧域名，只改默认值等于**老用户永远不迁移**；
+ *   ③ 迁移只允许动「官方旧域名」，自建地址一旦被顺手改写，用户会直接连不上自己的服务器。
+ *
+ * 因此这里同时钉：纯函数行为、三处默认值一致、以及 apply() 里确实调用了装载期迁移。
+ */
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { apply, migrateOfficialUrl } from "../lib/index.js";
+
+const NEW = "dsh.ruichengai.com";
+
+test("旧官方域名 → 新域名：端口/路径/查询串原样保留", () => {
+  assert.equal(
+    migrateOfficialUrl("https://n.risegao.cn:13443/relay-api"),
+    `https://${NEW}:13443/relay-api`
+  );
+  assert.equal(migrateOfficialUrl("https://n.risegao.cn:13443"), `https://${NEW}:13443`);
+  assert.equal(
+    migrateOfficialUrl("https://n.risegao.cn/relay-api?x=1"),
+    `https://${NEW}/relay-api?x=1`
+  );
+});
+
+test("幂等：已经是新域名时再迁移不变", () => {
+  const once = migrateOfficialUrl("https://n.risegao.cn:13443/relay-api");
+  assert.equal(migrateOfficialUrl(once), once);
+});
+
+test("自建/自定义地址一律原样返回（绝不能顺手改写用户自己的服务器）", () => {
+  for (const u of [
+    `https://${NEW}:13443/relay-api`,
+    "https://relay.example.com/relay-api",
+    "https://relay.example.com:8443/relay-api",
+    "http://127.0.0.1:1/relay-api",
+    // 相似但不同的 host：必须不被当成官方旧域名
+    "https://n.risegao.cn.evil.com/relay-api",
+    "https://evil-n.risegao.cn/relay-api",
+  ]) {
+    assert.equal(migrateOfficialUrl(u), u, `${u} 不该被改写`);
+  }
+});
+
+test("空值/非法值原样返回，不抛错（迁移失败绝不能拖垮装载）", () => {
+  for (const v of [null, undefined, "", "   ", "not a url", "n.risegao.cn:13443"]) {
+    assert.doesNotThrow(() => migrateOfficialUrl(v));
+  }
+  assert.equal(migrateOfficialUrl(""), "");
+  assert.equal(migrateOfficialUrl("not a url"), "not a url");
+});
+
+test("跨文件不变量：插件半/桥半/安装器的默认云端地址必须一致且是新域名", async () => {
+  const root = new URL("../../../", import.meta.url);
+  const files = {
+    插件半: new URL("packages/dsh-remote-web/lib/index.js", root),
+    桥半: new URL("clients/dsh-remote/dsh-bridge.mjs", root),
+    安装器: new URL("dsh-setup.mjs", root),
+  };
+  for (const [label, url] of Object.entries(files)) {
+    const src = await readFile(url, "utf8");
+    assert.ok(
+      src.includes(`https://${NEW}:13443/relay-api`),
+      `${label} 的默认 relay-api 必须指向 ${NEW}`
+    );
+    assert.ok(
+      !src.includes('|| "https://n.risegao.cn:13443/relay-api"'),
+      `${label} 不得再把旧域名当默认值`
+    );
+  }
+});
+
+test("装载期迁移确实接在 apply() 上（否则老用户永远不迁移）", async () => {
+  const root = new URL("../../../", import.meta.url);
+  const src = await readFile(new URL("packages/dsh-remote-web/lib/index.js", root), "utf8");
+  assert.match(src, /migrateLegacyConfigAtBoot\(relayDir, ctx\)/, "apply() 必须调用装载期迁移");
+  assert.match(src, /OFFICIAL_HOST_MIGRATION = new Map\(\[\s*\["n\.risegao\.cn", "dsh\.ruichengai\.com"\]/, "迁移映射必须存在");
+  // 自建模式不能被动：有 local_key 时必须直接返回
+  assert.match(src, /if \(!cfg \|\| !cfg\.api_url \|\| cfg\.local_key\) return false;/, "自建模式必须跳过迁移");
+});
+
+/** 最小宿主 ctx：只提供 apply() 会用到的东西（与 community-qr-ui.test.mjs 同一套做法）。 */
+function fakeHost() {
+  return {
+    webServer: { register() { return () => {}; } },
+    effect(reg) { return typeof reg === "function" ? reg() : () => {}; },
+    logger: { info() {}, warn() {} },
+  };
+}
+
+/**
+ * 隔离器：`apply()` 会做系统操作与 profile 路径推导，必须同时压住
+ *   · DSH_RELAY_SKIP_SERVICE=1（绝不碰 launchd/systemd/npx）
+ *   · HOME 指向临时目录（绝不动真实 ~/.dsh / ~/Library/LaunchAgents）
+ * 仓库的 setup-output.test.mjs 对这条有静态护栏，别改成 delete 而不伪造 HOME。
+ */
+function isolateHostEnv(home) {
+  const saved = { HOME: process.env.HOME, SKIP: process.env.DSH_RELAY_SKIP_SERVICE };
+  process.env.HOME = home;
+  process.env.DSH_RELAY_SKIP_SERVICE = "1";
+  return () => {
+    if (saved.HOME === undefined) delete process.env.HOME;
+    else process.env.HOME = saved.HOME;
+    if (saved.SKIP === undefined) process.env.DSH_RELAY_SKIP_SERVICE = "1"; // 保持隔离，不强求 unset
+    else process.env.DSH_RELAY_SKIP_SERVICE = saved.SKIP;
+  };
+}
+
+async function withConfig(cfg) {
+  const dir = await mkdtemp(path.join(os.tmpdir(), "dsh-domain-mig-"));
+  const file = path.join(dir, ".dsh-config.json");
+  await writeFile(file, JSON.stringify(cfg, null, 2));
+  return { dir, file, cleanup: () => rm(dir, { recursive: true, force: true }) };
+}
+
+test("装载期迁移（端到端）：存量旧域名配置被改写并落盘", async () => {
+  const t = await withConfig({
+    phone: "13800000000", password: "pw", device_id: "dev-x",
+    api_url: "https://n.risegao.cn:13443/relay-api",
+    tunnel_url: "wss://n.risegao.cn",
+  });
+  const restore = isolateHostEnv(t.dir);
+  try {
+    apply(fakeHost(), { relayDir: t.dir });
+    const cfg = JSON.parse(await readFile(t.file, "utf8"));
+    assert.equal(cfg.api_url, "https://dsh.ruichengai.com:13443/relay-api");
+    assert.equal(cfg.tunnel_url, "wss://dsh.ruichengai.com");
+    // 其它字段必须原样保留（迁移只动地址）
+    assert.equal(cfg.phone, "13800000000");
+    assert.equal(cfg.device_id, "dev-x");
+  } finally {
+    restore();
+    t.cleanup();
+  }
+});
+
+test("装载期迁移（端到端）：自建模式与自定义地址一律不动", async () => {
+  const t = await withConfig({
+    phone: "13800000000", password: "pw",
+    local_key: "lk", tunnel_url: "wss://relay.example.com",
+    api_url: "https://n.risegao.cn:13443/relay-api",
+  });
+  const restore = isolateHostEnv(t.dir);
+  try {
+    apply(fakeHost(), { relayDir: t.dir });
+    const cfg = JSON.parse(await readFile(t.file, "utf8"));
+    assert.equal(cfg.api_url, "https://n.risegao.cn:13443/relay-api", "自建模式不得被改写");
+    assert.equal(cfg.tunnel_url, "wss://relay.example.com");
+  } finally {
+    restore();
+    t.cleanup();
+  }
+});

package/packages/dsh-remote-web/test/purchase-agreement-proxy.test.mjs

@@ -21,7 +21,9 @@ import { apply, DEFAULT_PURCHASE_AGREEMENT_URL, purchaseAgreementUrlFrom } from
 const FALLBACK = DEFAULT_PURCHASE_AGREEMENT_URL;
 
 test("兜底常量就是业主约定的正式兜底地址（企业端 /api/purchase-agreement 的 302/200 入口）", () => {
-  assert.equal(FALLBACK, "https://n.risegao.cn:13443/relay-api/api/purchase-agreement");
+  // 2026-11-14 企业域名迁移：兜底地址随官方域名一起迁到 dsh.ruichengai.com
+  // （同一套企业端后端，路径不变；旧域名在过渡期仍在服役，但不再是"约定地址"）
+  assert.equal(FALLBACK, "https://dsh.ruichengai.com:13443/relay-api/api/purchase-agreement");
 });
 
 test("纯函数：public-config.agreement_url 优先；非 http(s)/相对/缺失一律回兜底", () => {