feat: 接入 mnote web tree shell 与主页链路整理

- 增加 mnote-web tree/command 支持与前端 MnoteWebTreeShell 集成
- 调整 sidebar、documents、runtime config 与 dev/prod server 配套逻辑
- 补充 homepage/tree shell smoke 脚本并更新 harness 进度文件

wolai-frontend/src/lib/runtime-config.ts

@@ -22,6 +22,16 @@ export type MnoteRuntimeConfig = {
   onlyofficeProxyOriginWeb?: string;
   onlyofficeCallbackOriginWeb?: string;
   onlyofficeCallbackOriginDesktop?: string;
+  /**
+   * Rust Web 主入口，仅用于客户端渐进增强能力（例如独立 tree shell）。
+   * 说明：禁止把它作为主页面 SSR 首屏依赖。
+   */
+  mnoteWebBaseUrl?: string;
+  /**
+   * 是否启用 Rust Web tree shell 客户端增强。
+   * 说明：实验壳必须显式开启，禁止仅因配置了 mnoteWebBaseUrl 就自动进入主界面链路。
+   */
+  mnoteWebTreeShellEnabled?: boolean;
   /**
    * 是否为桌面端（Electron）运行。
    */
@@ -43,12 +53,50 @@ declare global {
   }
 }
 
+const parseRuntimeBoolean = (value: unknown): boolean | undefined => {
+  if (typeof value === "boolean") {
+    return value;
+  }
+  if (typeof value !== "string") {
+    return undefined;
+  }
+  const normalized = value.trim().toLowerCase();
+  if (!normalized) {
+    return undefined;
+  }
+  if (["1", "true", "yes", "on"].includes(normalized)) {
+    return true;
+  }
+  if (["0", "false", "no", "off"].includes(normalized)) {
+    return false;
+  }
+  return undefined;
+};
+
 const readFromEnv = (): MnoteRuntimeConfig => ({
   useConvex: process.env.USE_CONVEX === "1" || process.env.NEXT_PUBLIC_USE_CONVEX === "1",
   supabaseUrl: process.env.NEXT_PUBLIC_SUPABASE_URL,
   supabaseInternalUrl: process.env.SUPABASE_INTERNAL_URL,
   supabaseAnonKey: process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY,
   backendUrl: process.env.NEXT_PUBLIC_BACKEND_URL ?? process.env.BACKEND_URL,   
+  ...((process.env.NEXT_PUBLIC_MNOTE_WEB_BASE_URL ?? process.env.MNOTE_WEB_BASE_URL) !== undefined
+    ? {
+        mnoteWebBaseUrl:
+          process.env.NEXT_PUBLIC_MNOTE_WEB_BASE_URL ??
+          process.env.MNOTE_WEB_BASE_URL,
+      }
+    : {}),
+  ...(parseRuntimeBoolean(
+    process.env.NEXT_PUBLIC_MNOTE_WEB_TREE_SHELL_ENABLED ??
+      process.env.MNOTE_WEB_TREE_SHELL_ENABLED,
+  ) !== undefined
+    ? {
+        mnoteWebTreeShellEnabled: parseRuntimeBoolean(
+          process.env.NEXT_PUBLIC_MNOTE_WEB_TREE_SHELL_ENABLED ??
+            process.env.MNOTE_WEB_TREE_SHELL_ENABLED,
+        ),
+      }
+    : {}),
   onlyofficeBaseUrl: process.env.NEXT_PUBLIC_ONLYOFFICE_BASE_URL,
   onlyofficeStorageHostOverride: process.env.NEXT_PUBLIC_ONLYOFFICE_STORAGE_HOST_OVERRIDE,
   onlyofficeProxyOrigin: process.env.NEXT_PUBLIC_ONLYOFFICE_PROXY_ORIGIN,
@@ -63,9 +111,12 @@ const readFromPublicJson = (): Partial<MnoteRuntimeConfig> => {
     // 桌面端运行时 process.cwd() 会被 Electron 切到 desktop-next 根目录。
     // 网页端运行时 process.cwd() 通常为 wolai-frontend。
      
-    const fs = require("fs") as typeof import("fs");
-     
-    const path = require("path") as typeof import("path");
+    // 说明：这里不能直接写 `require("fs")` / `require("path")`，
+    // 否则客户端 bundle 在解析该模块时会把它们也当成浏览器依赖，触发持续重编译或空白页。
+    // 仅在服务端运行时通过惰性 require 读取本地 public/mnote-env.json。
+    const runtimeRequire = new Function("return require")() as NodeJS.Require;
+    const fs = runtimeRequire("node:fs") as typeof import("fs");
+    const path = runtimeRequire("node:path") as typeof import("path");
 
     // 说明：Next standalone 产物的 server.js 会执行 `process.chdir(__dirname)`，
     // 导致 process.cwd() 变成 `.next/standalone`，此时 public/mnote-env.json 位于上层目录。
@@ -152,9 +203,15 @@ const normalizeRuntimeConfig = (cfg: MnoteRuntimeConfig): MnoteRuntimeConfig =>
       cfg.onlyofficeCallbackOriginDesktop ||
       "";
 
+  const mnoteWebBaseUrl = (cfg.mnoteWebBaseUrl ?? "").trim().replace(/\/+$/, "");
+  const mnoteWebTreeShellEnabled =
+    parseRuntimeBoolean(cfg.mnoteWebTreeShellEnabled) ?? false;
+
   return {
     ...cfg,
     isDesktop,
+    mnoteWebBaseUrl,
+    mnoteWebTreeShellEnabled,
     onlyofficeBaseUrl,
     onlyofficeStorageHostOverride,
     onlyofficeProxyOrigin,