dsh-jiuling-remote-mobile 1.0.17 → 1.0.18

package/lib/client.js

@@ -415,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 () {
@@ -539,6 +571,10 @@ window.__ModuleLoader__.load({
 						// 必须作废，否则用户会看到上一台电脑的目录。
 						clearDesktopDirCache();
 						patch({ path: null, listing: null });
+						// ⚠️ 前端那份模型目录是**永久缓存**的（见 `reloadModelCatalog`），
+						// 不作废的话用户接下来看到的仍然是配对前那份手机模型列表 ——
+						// 就是用户报的「模型列表还是没同步」。
+						reloadModelCatalog();
 					},
 					function (reason) {
 						if (!aliveRef.current) return;

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;
@@ -1569,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;
+		}
 
 		/**
 		 * 电脑上的模型目录。
@@ -1615,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;

package/package.json

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