dsh-jiuling-remote-mobile 1.0.16 → 1.0.18

package/lib/client.js

@@ -230,6 +230,37 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(styleTag);
 		}
 
+		/**
+		 * 电脑目录的**访问缓存**：`电脑路径 → listing`（模块级，跨对话框开关存活）。
+		 *
+		 * ## 为什么必须有（用户报障原文）
+		 *
+		 * 「为什么我点击添加工作区的时候，每次点击电脑都要重新加载一遍目录，
+		 * 这就算了，我加载好之后，随便点击一个文件夹，文件夹里面的内容还要重新加载
+		 * 一遍」—— 同一个电脑目录，每次进「电脑」页签、每次点进同一个文件夹，
+		 * 都要重走一趟「手机 → Cloudflare 隧道 → 电脑」，一个来回 1～3 秒。
+		 * 用户要的是「加载一次，后续直接从本地读」。
+		 *
+		 * ## 为什么放模块级而不是组件内 ref
+		 *
+		 * 对话框每次打开都是**新挂载的组件**，组件内的 ref 一关就没了 —— 那样
+		 * 「关掉再打开又转一遍圈」，正是用户抱怨的第一个现象。放模块级则一次加载
+		 * 整条会话内都命中。
+		 *
+		 * ⚠️ 键是**电脑路径**原样（`C:\Users\...`），`''` 表示根目录 —— 与
+		 * `bridge('listDesktop')` 的入参完全一致，不做任何改写。
+		 *
+		 * ⚠️ **失效只有两条路**：用户点「刷新」（见 `refreshAll`），
+		 * 或者那一次加载失败（见下面的 catch）。不做 TTL 轮询 —— 用户明确要的是
+		 * 「加载一次就直接从本地读」。
+		 */
+		var desktopDirCache = {};
+
+		/** 清掉访问缓存（配对 / 解绑 / 切页签时调用，避免跨电脑串味）。 */
+		function clearDesktopDirCache() {
+			desktopDirCache = {};
+		}
+
 		/**
 		 * 调宿主桥的一条 RPC（令牌只在引擎进程里，浏览器侧不持有）。
 		 *
@@ -384,6 +415,38 @@ window.__ModuleLoader__.load({
 				};
 			}, []);
 
+			/**
+			 * 让官方前端的模型目录**失效重载**。
+			 *
+			 * ## ⚠️ 这一步为什么不能省
+			 *
+			 * 官方 `ModelCatalogDirectory` 在页面加载时就 `load()` 一次并进入
+			 * `status === 'ready'`，此后**点菜单一个请求都不发**
+			 * （`dsh-client-ui-model-selection/lib/client.js:100`：ready 时直接
+			 * 返回旧值）。所以「配对之后模型列表变成电脑的」这件事，只把宿主那边的
+			 * 缓存换掉是**看不见的** —— 前端那一层永远捧着配对前拉到的手机列表。
+			 *
+			 * 这正是用户报的「预设列表正确地加载了电脑预设，但模型列表还是没同步」：
+			 * 预设走 `remoteExportList`，**没有缓存层**、每次重读，所以它是对的。
+			 *
+			 * `modelDirectories` 是官方那个服务实例（`super(ctx, "modelDirectories")`），
+			 * `.catalog.refresh()` 就是官方在 `llm/adapters-updated` 时走的同一条路 ——
+			 * 走公开方法，不碰前端 bundle 内部类。
+			 *
+			 * `ctx.get` 拿不到服务时静默跳过（见 `injected()` 里 `modelDirectories`
+			 * 的注释）：最坏是回到「要点一下刷新按钮」的旧行为，不会报错。
+			 */
+			var reloadModelCatalog = function () {
+				try {
+					var models = props.modelDirectories;
+					if (models && models.catalog && typeof models.catalog.refresh === 'function') {
+						models.catalog.refresh();
+					}
+				} catch (error) {
+					/* 服务结构变了就只更新宿主缓存，不打扰用户 */
+				}
+			};
+
 			// 每次打开都回到「手机」页签，避免上次停在电脑目录造成困惑。
 			react.useEffect(
 				function () {
@@ -424,6 +487,16 @@ window.__ModuleLoader__.load({
 						patch({ loading: false, listing: null, error: null });
 						return undefined;
 					}
+					// ⚠️ **电脑目录命中缓存就直接铺回去，不打桥**（用户报障：来回点文件夹
+					// 每次都重新加载）。缓存键用 `''` 表示根，与 `listDesktop` 的入参一致。
+					if (tab === 'desktop') {
+						var key = path === null ? '' : path;
+						var hit = desktopDirCache[key];
+						if (hit !== undefined) {
+							patch({ loading: false, listing: hit, error: null });
+							return undefined;
+						}
+					}
 					patch({ loading: true, error: null });
 					var load =
 						tab === 'desktop'
@@ -432,10 +505,16 @@ window.__ModuleLoader__.load({
 					load.then(
 						function (listing) {
 							if (!aliveRef.current) return;
+							if (tab === 'desktop') {
+								desktopDirCache[path === null ? '' : path] = listing;
+							}
 							patch({ loading: false, listing: listing });
 						},
 						function (reason) {
 							if (!aliveRef.current) return;
+							// ⚠️ 失败**要清掉这一格缓存**：留着的话用户再点进来会看到
+							// 上一次的旧内容，而以为自己看的是电脑现状。
+							if (tab === 'desktop') delete desktopDirCache[path === null ? '' : path];
 							patch({
 								loading: false,
 								listing: null,
@@ -488,7 +567,14 @@ window.__ModuleLoader__.load({
 							code: '',
 							message: { kind: 'ok', text: '配对成功，正在连接电脑…' },
 						});
+						// ⚠️ 换了一台电脑，旧缓存里的路径完全无效（甚至同名不同机）——
+						// 必须作废，否则用户会看到上一台电脑的目录。
+						clearDesktopDirCache();
 						patch({ path: null, listing: null });
+						// ⚠️ 前端那份模型目录是**永久缓存**的（见 `reloadModelCatalog`），
+						// 不作废的话用户接下来看到的仍然是配对前那份手机模型列表 ——
+						// 就是用户报的「模型列表还是没同步」。
+						reloadModelCatalog();
 					},
 					function (reason) {
 						if (!aliveRef.current) return;
@@ -520,6 +606,8 @@ window.__ModuleLoader__.load({
 							code: '',
 							message: { kind: 'ok', text: '已解绑，请到电脑上生成新的配对码' },
 						});
+						// 解绑后旧凭据作废，缓存里的目录不该再露出来。
+						clearDesktopDirCache();
 						patch({ path: null, listing: null });
 					},
 					function (reason) {
@@ -611,11 +699,16 @@ window.__ModuleLoader__.load({
 				if (pairState.refreshing) return;
 				patchPair({ refreshing: true, refreshNote: null });
 				var target = state.tab === 'desktop' ? loc.path : '';
+				// ⚠️ **「刷新」必须清掉访问缓存**，否则新列表铺回 `listing` 之后，
+				// 用户一离开再回来又命中旧的那一格，看起来就是「刷新没生效」。
+				// 连同整棵已缓存的树一起作废：电脑上的目录可能已经变了。
+				clearDesktopDirCache();
 				bridge('refreshAll', target === '' ? {} : { path: target }).then(
 					function (result) {
 						if (!aliveRef.current) return;
-						// 目录树：直接把新列表铺回去（正在看的这一层）。
+						// 目录树：直接把新列表铺回去（正在看的这一层），并写回缓存。
 						if (result && result.directory && result.directory.ok) {
+							desktopDirCache[target === '' ? '' : target] = result.directory.value;
 							patch({ listing: result.directory.value });
 						}
 						// 模型：让官方目录失效重载，下一次打开菜单就是电脑的。

package/lib/index.js

@@ -678,7 +678,7 @@ export function apply(ctx) {
 	const watchers = new Set();
 
 	/**
-	 * 电脑侧的静默缓存：`{ catalog, presets, at }`。
+	 * 电脑侧的静默缓存：`{ catalog, presets, directory, at }`。
 	 *
 	 * ## 为什么要缓存（用户需求原文）
 	 *
@@ -686,10 +686,17 @@ export function apply(ctx) {
 	 * 以及目录树这样体验会好很多……因为一般项目目录是不会变的，可以提前加载」。
 	 *
 	 * 配对后立刻拉一次，之后前端一打开模型菜单就有内容，不用等一轮往返。
-	 * 目录树**不进这个缓存** —— 它按路径变化，缓存了反而会显示过期内容，
-	 * 由前端每次进目录时实时拉。
+	 *
+	 * ⚠️ **`directory` 只缓存「根」那一层**（`listDirectory` 不给 path 时返回的
+	 * home），因为「点开电脑页签」是每次都逃不掉的第一步，而它现在必然要过一轮
+	 * 隧道往返 —— 用户看到的就是那个转圈（原话：「还是有一个加载过程，
+	 * 不能预加载吗」）。
+	 *
+	 * **整棵目录树不进缓存**：电脑上几万个目录，全拉一遍既慢又没意义，而且
+	 * 会大面积显示过期内容。点进子目录仍然实时拉（前端另有 `desktopDirCache`
+	 * 兜住「同一层来回点」）。根目录的过期窗口由「刷新」按钮关闭。
 	 */
-	const desktopCache = { catalog: null, presets: null, at: 0 };
+	const desktopCache = { catalog: null, presets: null, directory: null, at: 0 };
 
 	/**
 	 * 静默预拉电脑的模型目录与预设列表。
@@ -703,7 +710,7 @@ export function apply(ctx) {
 	 */
 	const prefetchDesktop = async (why) => {
 		if (config.token === EMPTY_TOKEN) return;
-		const [catalog, presets] = await Promise.all([
+		const [catalog, presets, directory] = await Promise.all([
 			callRemote(config, 'modelCatalog', {}).catch((error) => {
 				ctx.logger?.warn?.(`[dsh-remote-mobile] 预拉模型列表失败（${why}）: ${String(error?.message ?? error)}`);
 				return null;
@@ -712,16 +719,49 @@ export function apply(ctx) {
 				ctx.logger?.warn?.(`[dsh-remote-mobile] 预拉预设列表失败（${why}）: ${String(error?.message ?? error)}`);
 				return null;
 			}),
+			// 根目录那一层：不带 path ⇒ 电脑返回它的 home，正是用户点开
+			// 「电脑」页签第一眼看到的东西。见 `desktopCache.directory` 的注释。
+			callRemote(config, 'listDirectory', {}).catch((error) => {
+				ctx.logger?.warn?.(`[dsh-remote-mobile] 预拉目录树失败（${why}）: ${String(error?.message ?? error)}`);
+				return null;
+			}),
 		]);
 		if (catalog !== null) desktopCache.catalog = catalog;
 		if (presets !== null) desktopCache.presets = presets;
+		if (directory !== null) desktopCache.directory = directory;
 		desktopCache.at = Date.now();
 		const models = catalog?.groups?.reduce((n, g) => n + (g.models?.length ?? 0), 0) ?? 0;
+		const dirs = directory?.entries?.length ?? directory?.items?.length ?? 0;
 		ctx.logger?.info?.(
-			`[dsh-remote-mobile] 已预拉电脑数据（${why}）：${models} 个模型、${presets?.presets?.length ?? 0} 个预设`,
+			`[dsh-remote-mobile] 已预拉电脑数据（${why}）：${models} 个模型、${presets?.presets?.length ?? 0} 个预设、根目录 ${dirs} 项`,
 		);
 	};
 
+	/**
+	 * 取电脑的模型目录，缓存为空就**当场拉一次**。
+	 *
+	 * ⚠️ **不能只依赖配对时的预拉**。那是异步的后台动作，而前端页面一加载
+	 * 就会调一次 `modelCatalog`（`ModelCatalogDirectory` 构造后立刻 `load()`，
+	 * 见 `dsh-client-ui-model-selection/lib/client.js:354`）—— 谁先到谁决定
+	 * 用户看到什么。拿不到电脑那份就返回手机本地列表，症状正是用户报的
+	 * 「预设列表正确地加载了电脑预设，但模型列表还是没同步」：预设走
+	 * `remoteExportList`，**没有缓存层**、每次重读，所以它是对的。
+	 *
+	 * @returns 电脑的模型目录；拉不到时 `null`。
+	 */
+	const desktopCatalog = async () => {
+		if (desktopCache.catalog !== null) return desktopCache.catalog;
+		try {
+			desktopCache.catalog = await callRemote(config, 'modelCatalog', {});
+			return desktopCache.catalog;
+		} catch (error) {
+			ctx.logger?.warn?.(
+				`[dsh-remote-mobile] 取电脑模型列表失败: ${String(error?.message ?? error)}`,
+			);
+			return null;
+		}
+	};
+
 	/**
 	 * 把电脑的模型目录并进手机本地的目录。
 	 *
@@ -1152,8 +1192,10 @@ export function apply(ctx) {
 			const originalCatalog = controller.modelCatalog.bind(controller);
 			controller.modelCatalog = async (...args) => {
 				const local = await originalCatalog(...args);
-				if (!paired() || desktopCache.catalog === null) return local;
-				return mergeCatalog(local, desktopCache.catalog);
+				if (!paired()) return local;
+				const desktop = await desktopCatalog();
+				if (desktop === null) return local;
+				return mergeCatalog(local, desktop);
 			};
 			undo.push(() => {
 				controller.modelCatalog = originalCatalog;
@@ -1379,6 +1421,10 @@ export function apply(ctx) {
 								// 解绑要能停掉全部旧连接、清掉全部搬运状态（见 `unpair`）。
 								follows,
 								mirrorStates,
+								// ⚠️ **必须显式传进来**：`handleBridge` 是模块级函数，作用域里
+								// 没有 `apply()` 的闭包变量；漏传就是 `workspaceMap is not defined`，
+								// 用户点「在此新建对话」时必然失败（1.0.16 的真实报障）。
+								workspaceMap,
 								persist: () => saveRemoteSessions(remoteSessions, ctx.logger),
 								// 模型/预设的静默缓存：配对后预拉、刷新按钮回写（见 desktopCache）。
 								desktopCache,
@@ -1556,7 +1602,7 @@ function desktopPathOfMirror(workspaceMap, dir) {
  *
  * @param ctx - Cordis 上下文。
  * @param config - 远程配置。
- * @param io - `{ remoteSessions, follow, follows, mirrorStates, persist, body }`。
+ * @param io - `{ remoteSessions, follow, follows, mirrorStates, persist, workspaceMap, body }`。
  */
 async function handleBridge(ctx, config, io) {
 	const params = io.body?.params ?? {};
@@ -1565,9 +1611,24 @@ async function handleBridge(ctx, config, io) {
 		case 'ping':
 			return callRemote(config, 'ping', {});
 
-		/** 列电脑上的目录。 */
-		case 'listDesktop':
-			return callRemote(config, 'listDirectory', { path: params.path });
+		/**
+		 * 列电脑上的目录。
+		 *
+		 * ⚠️ **根那层命中预拉缓存就直接回，不打隧道**：用户点开「电脑」页签时
+		 * 看的正是这一层，而它每一轮往返都要穿过 Cloudflare 隧道 ——
+		 * 那就是用户抱怨的那个「还是有一个加载过程」（原话：「目录树都提前存档
+		 * 手机本地了，为什么还是还加载呢，不能预加载吗」）。
+		 *
+		 * 只在**没给 path**（= 要 home）且预拉成功过时才走缓存。子目录照旧实时拉，
+		 * 前端 `desktopDirCache` 负责「同一层来回点」，两边分工见各自的注释。
+		 */
+		case 'listDesktop': {
+			const wantRoot = params.path === undefined || params.path === null || params.path === '';
+			if (wantRoot && io.desktopCache?.directory != null) return io.desktopCache.directory;
+			const listing = await callRemote(config, 'listDirectory', { path: params.path });
+			if (wantRoot && io.desktopCache !== undefined) io.desktopCache.directory = listing;
+			return listing;
+		}
 
 		/**
 		 * 电脑上的模型目录。
@@ -1611,9 +1672,23 @@ async function handleBridge(ctx, config, io) {
 			// ⚠️ 刷新到的模型/预设要**写回缓存**，否则「刷新按钮」只更新了它自己
 			// 那份响应，前端模型菜单读的是宿主拦截器里的缓存 —— 用户会看到
 			// 「点了刷新，模型列表没变」。
+			//
+			// 根目录那一层同理：刷完不回写的话，用户接下来点开「电脑」页签
+			// 命中的还是**刷新前**那份预拉缓存，看起来就是「刷新没生效」。
+			//
+			// ⚠️ **判据是「拉回来的这一层就是缓存的那一层」**（同 path），
+			// 不是「有没有带 path」：前端在根层点刷新时传的是当前显示的绝对路径
+			// （`loc.path`，也就是 home），照样是带 path 的一次调用 —— 只看
+			// `params.path` 空不空会把根层刷新漏掉。
 			if (io.desktopCache !== undefined) {
 				if (result.models?.ok === true) io.desktopCache.catalog = result.models.value;
 				if (result.presets?.ok === true) io.desktopCache.presets = result.presets.value;
+				if (
+					result.directory?.ok === true &&
+					io.desktopCache.directory?.path === result.directory.value?.path
+				) {
+					io.desktopCache.directory = result.directory.value;
+				}
 				io.desktopCache.at = Date.now();
 			}
 			return result;
@@ -1640,7 +1715,7 @@ async function handleBridge(ctx, config, io) {
 			// 这里给它一个**电脑目录专属的镜像工作区**（标题 = 电脑目录末段），
 			// 而不是手机的「默认工作区」—— 否则所有远程会话都堆在「默认工作区」
 			// 底下，看起来就像「建完又回到默认工作去了」（见 `ensureDesktopWorkspace`）。
-			const workspace = await ensureDesktopWorkspace(ctx, params.path, workspaceMap);
+			const workspace = await ensureDesktopWorkspace(ctx, params.path, io.workspaceMap);
 			const cwd = workspace.path;
 			// ⚠️ **必须走 `sessionController.create`，不能走 `ctx.sessions.create`。**
 			//
@@ -1770,4 +1845,4 @@ async function handleBridge(ctx, config, io) {
 	}
 }
 
-export { callRemote, mirrorEvent, loadConfig, DEFAULT_ENDPOINT, CONFIG_PATH, PAIR_ENDPOINT, claimPairing };
+export { callRemote, mirrorEvent, loadConfig, DEFAULT_ENDPOINT, CONFIG_PATH, PAIR_ENDPOINT, claimPairing, handleBridge };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-jiuling-remote-mobile",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "DSH 远程目录（手机端）：在选文件夹流程里多出「电脑」页签，进入电脑目录、在电脑上发起对话，并把电脑的实时消息流同步到手机本地界面（只传文本，不映射桌面）。",
   "type": "module",
   "main": "./lib/index.js",