cloud-web-corejs 1.0.54-dev.755 → 1.0.54-dev.756

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cloud-web-corejs",
   "private": false,
-  "version": "1.0.54-dev.755",
+  "version": "1.0.54-dev.756",
   "scripts": {
     "dev": "vue-cli-service serve",
     "lint": "eslint --ext .js,.vue src",

package/src/microRouter/index.js

@@ -22,6 +22,12 @@ const REGISTRY_TIMEOUT = 8000;
 const CONTAINER_WRAPPER_ID = "Appmicro";
 const DEBUG_APP_CODE_REG = /^[A-Za-z][A-Za-z0-9_-]*$/;
 
+// 本机调试的约定默认值：包内兜底，各应用 settings.js 无需声明。
+// 需要偏离约定（改端口 / 调真实 appCode 的菜单派发）才在应用 settings.js 里覆盖，
+// 或用 ?microDebug=appB=http://... 单次指定。
+const DEBUG_DEFAULT_APP_CODE = "debugApp";
+const DEBUG_DEFAULT_ENTRY = "http://localhost:17527/";
+
 // 保活管理：appCode → { instance, el }；离开子应用路由只隐藏容器不卸载，
 // 切回直接显示并经 update 生命周期同步路由，页面状态（页签/表格/表单）得以保留
 let microAppConfigs = {};
@@ -68,19 +74,52 @@ export function getAppRegistry() {
 }
 
 /**
- * 本机调试覆盖，两种形态（localStorage 优先）：
- * 1) settings.microDebugEnabled = true —— 本地起主应用时免设 localStorage，
- *    直接按 settings.microDebugAppCode/microDebugEntry 挂载调试子应用；
- *    仅非 production 构建生效，防误留 true 发版后所有用户被指向 localhost。
- * 2) localStorage.micro_app_debug —— 仅当前浏览器生效，用于"发布环境主应用 +
- *    本机子应用"的联调，不影响其他用户。四档写法：
+ * 从 URL 读调试开关并落盘 localStorage，读到后即从地址栏抹掉（避免被收藏/分享扩散）。
+ * 支持 hash 前后两种位置：?microDebug=xx#/... 与 #/...?microDebug=xx。
+ * 取值同 localStorage 四档写法；microDebug=off 清除调试态。
+ * 存在意义：settings.microDebugEnabled 是构建期常量、全体用户共用，生产构建里必须失效；
+ * 生产环境主应用要装本机子应用，只能靠这种"按浏览器生效"的通道。
+ */
+function readDebugFromUrl() {
+  const href = window.location.href || "";
+  const matched = href.match(/[?&]microDebug=([^&#]*)/);
+  if (!matched) return;
+  const value = decodeURIComponent(matched[1] || "").trim();
+  try {
+    if (!value || value === "off" || value === "0") {
+      window.localStorage.removeItem(DEBUG_STORAGE_KEY);
+    } else {
+      window.localStorage.setItem(DEBUG_STORAGE_KEY, value);
+    }
+  } catch (e) {
+    console.error("[microRouter] 调试开关写入 localStorage 失败：", e.message);
+    return;
+  }
+  try {
+    const cleaned = href
+      .replace(/([?&])microDebug=[^&#]*&?/, "$1")
+      .replace(/[?&](?=#|$)/, ""); // 抹掉后可能残留的空查询串
+    window.history.replaceState(null, "", cleaned);
+  } catch (e) {
+    // replaceState 失败不影响开关本身，忽略
+  }
+}
+
+/**
+ * 本机调试覆盖，三种触发方式（localStorage 优先于 settings 开关）：
+ * 1) URL 参数 ?microDebug=xx —— 任何环境（含生产构建）都生效，值写入 localStorage
+ *    后自动从地址栏抹掉；?microDebug=off 清除。生产环境主应用只能用这种。
+ * 2) localStorage.micro_app_debug —— 仅当前浏览器生效，不影响其他用户。四档写法：
  *   "1"                          → settings.microDebugAppCode + microDebugEntry
  *   "appB"                       → appB + 默认调试入口
- *   "appB=http://localhost:9530/" → 指定入口；多个用逗号分隔，可混写
+ *   "appB=http://localhost:17528/" → 指定入口；多个用逗号分隔，可混写
  *   '[{"appCode":"..","entry":".."}]' → 完整条目数组
+ * 3) settings.microDebugEnabled = true —— 本地起主应用时免设 localStorage；
+ *    仅非 production 构建生效，防误留 true 发版后所有用户被指向 localhost。
  * 与注册表按 appCode 合并：已存在的条目覆盖 entry 并强制 enabled，不存在的追加。
  */
 function getDebugOverrides() {
+  readDebugFromUrl();
   let raw = null;
   try {
     raw = window.localStorage.getItem(DEBUG_STORAGE_KEY);
@@ -89,8 +128,8 @@ function getDebugOverrides() {
   }
   raw = raw ? raw.trim() : "";
   const defaults = {
-    appCode: settings.microDebugAppCode || "",
-    entry: settings.microDebugEntry || "",
+    appCode: settings.microDebugAppCode || DEBUG_DEFAULT_APP_CODE,
+    entry: settings.microDebugEntry || DEBUG_DEFAULT_ENTRY,
   };
   let restoreHint
     = "删除 localStorage." + DEBUG_STORAGE_KEY + " 后刷新恢复";