dsh-vscode-mode 0.1.56 → 0.1.58

package/lib/client.js

@@ -107,6 +107,92 @@ window.__ModuleLoader__.load({
 			} catch (e) {}
 		}
 		//#endregion
+		//#region src/shared/logger.ts
+		/**
+		* dsh-vscode-mode — 统一日志核心（双面共享，平台中立）。
+		* 输出规范：
+		* - 格式：`[dsh-vscode-mode][:scope] 消息`；前缀只在模块内部拼接，业务代码禁止手写前缀
+		* - 级别语义：debug=诊断明细 / info=装配与路由里程碑 / warn=降级与兼容回退 / error=失败
+		* - 出口：host 面经 bindHostLog(ctx) 绑定 ctx.logger（缺失回退 console）；client 面固定 console
+		* - 诊断文件通道（edrv.debug → ~/.dsh/dsh-vscode-mode/logs/）见 debugLog.ts，与本模块前缀共用
+		* 新增日志一律 `import { log } from '../log.js'`（client 为 './log.js'）后调 log.debug/info/warn/error；
+		* 子域日志用 log.child('scope')，禁止另起 console。
+		* 作者 ddj 2026-09-08
+		*/
+		/** 插件统一日志前缀（与包安装名一致）。 */
+		const LOG_PREFIX = "[dsh-vscode-mode]";
+		/** 默认级别到 console 方法名的映射。 */
+		const CONSOLE_METHODS = {
+			debug: "debug",
+			info: "info",
+			warn: "warn",
+			error: "error"
+		};
+		/**
+		* 默认出口：console（级别直映方法；方法缺失时静默丢弃，不抛错）。
+		* @author ddj 2026年09月08号
+		* @returns console 出口
+		*/
+		function consoleSink() {
+			return (level, line) => {
+				const emit = console[CONSOLE_METHODS[level]];
+				if (typeof emit === "function") emit.call(console, line);
+			};
+		}
+		/**
+		* 拼一行日志：`[dsh-vscode-mode][:scope] 消息`（scope 为空省略冒号段）。
+		* @author ddj 2026年09月08号
+		* @param scope 子域（可空）
+		* @param message 消息文本
+		* @returns 整行文本
+		*/
+		function formatLine(scope, message) {
+			const text = String(message);
+			return scope ? LOG_PREFIX + ":" + scope + " " + text : LOG_PREFIX + " " + text;
+		}
+		/**
+		* 日志器工厂（内部）：emit 时读共享出口状态，保证父 bind 后子实例跟随。
+		* @author ddj 2026年09月08号
+		* @param state 共享出口状态
+		* @param scope 子域文本（可空）
+		* @returns 日志器
+		*/
+		function makeLogger(state, scope) {
+			const emit = (level, message) => state.sink(level, formatLine(scope, message));
+			return {
+				debug: (message) => emit("debug", message),
+				info: (message) => emit("info", message),
+				warn: (message) => emit("warn", message),
+				error: (message) => emit("error", message),
+				bind(next) {
+					state.sink = next;
+				},
+				child(next) {
+					return makeLogger(state, scope ? scope + "." + next : next);
+				}
+			};
+		}
+		/**
+		* 创建插件日志器（默认 console 出口；host 面单例由 bindHostLog 换到 ctx.logger）。
+		* @author ddj 2026年09月08号
+		* @param sink 初始出口（缺省 console）
+		* @param scope 初始子域（业务方一般经 child 派生，不直接传）
+		* @returns 日志器
+		*/
+		function createLogger(sink = consoleSink(), scope = "") {
+			return makeLogger({ sink }, scope);
+		}
+		//#endregion
+		//#region src/client/log.ts
+		/**
+		* dsh-vscode-mode client — 日志单例（全 client 面唯一日志入口）。
+		* client 无 ctx.logger 服务，固定 console 出口；格式/级别语义与 host 面一致（shared/logger.ts）。
+		* 用法：`import { log } from './log.js'` → `log.debug/info/warn/error(msg)`；子域用 `log.child('scope')`。
+		* 作者 ddj 2026-09-08
+		*/
+		/** client 面插件日志单例。 */
+		const log = createLogger();
+		//#endregion
 		//#region src/client/sidebarBridge.ts
 		/**
 		* dsh-vscode-mode client — 侧边栏编辑区桥：可选探测 dsh-better-sidebar 的
@@ -224,7 +310,7 @@ window.__ModuleLoader__.load({
 			try {
 				return ensureSideEditor(path, focusDiff) === true;
 			} catch (error) {
-				console.warn("[dsh-vscode-mode] 侧栏编辑器打开失败（" + String(error) + "），已回退");
+				log.warn("侧栏编辑器打开失败（" + String(error) + "），已回退");
 				return false;
 			}
 		}
@@ -260,7 +346,7 @@ window.__ModuleLoader__.load({
 						try {
 							registerLegacyFallback();
 						} catch (error) {
-							console.warn("[dsh-vscode-mode] 回退注册失败（" + String(error) + "）");
+							log.warn("回退注册失败（" + String(error) + "）");
 						}
 					}
 					return false;
@@ -282,7 +368,7 @@ window.__ModuleLoader__.load({
 						cwd: scope?.cwd
 					});
 				} catch (error) {
-					console.warn("[dsh-vscode-mode] openTab 失败（" + String(error) + "）");
+					log.warn("openTab 失败（" + String(error) + "）");
 					return false;
 				}
 				if (sideEditorMounted) window.dispatchEvent(new CustomEvent("edrv:open-editor", { detail: {
@@ -303,13 +389,13 @@ window.__ModuleLoader__.load({
 					component: renderTab
 				});
 			} catch (error) {
-				console.warn("[dsh-vscode-mode] 侧边栏 Tab 注册失败（" + String(error) + "）");
+				log.warn("侧边栏 Tab 注册失败（" + String(error) + "）");
 				if (!fallbackInstalled) {
 					fallbackInstalled = true;
 					try {
 						registerLegacyFallback();
 					} catch (inner) {
-						console.warn("[dsh-vscode-mode] 回退注册失败（" + String(inner) + "）");
+						log.warn("回退注册失败（" + String(inner) + "）");
 					}
 				}
 				return () => {};
@@ -6413,14 +6499,14 @@ window.__ModuleLoader__.load({
 		function registerSlotSafely(ctx, spec, render) {
 			const slots = ctx?.slots;
 			if (!slots || typeof slots.inject !== "function" || typeof slots.register !== "function") {
-				console.warn("[dsh-vscode-mode] slots 服务不可用，跳过 slot " + spec.name);
+				log.warn("slots 服务不可用，跳过 slot " + spec.name);
 				return null;
 			}
 			try {
 				const disposer = slots.inject(spec.name, () => slots.register(spec, render));
 				return typeof disposer === "function" ? disposer : null;
 			} catch (error) {
-				console.warn("[dsh-vscode-mode] slot " + spec.name + " 注册失败（" + String(error) + "），已跳过");
+				log.warn("slot " + spec.name + " 注册失败（" + String(error) + "），已跳过");
 				return null;
 			}
 		}
@@ -8914,12 +9000,12 @@ window.__ModuleLoader__.load({
 			if (!params) return;
 			const referrer = options.referrer ?? (typeof document !== "undefined" ? document.referrer : "");
 			if (!referrerAllowed(referrer, options.origin ?? (typeof location !== "undefined" ? location.origin : ""))) {
-				console.warn("[dsh-vscode-mode] 已忽略跨源深链请求（referrer=" + referrer + "）");
+				log.warn("已忽略跨源深链请求（referrer=" + referrer + "）");
 				return;
 			}
 			stripCurrentUrl();
 			openDeepLink(ctx, params).catch((error) => {
-				console.warn("[dsh-vscode-mode] 深链打开失败：" + String(error));
+				log.warn("深链打开失败：" + String(error));
 				toastDom("深链打开失败：" + String(error?.message ?? error));
 			});
 		}
@@ -11776,8 +11862,8 @@ window.__ModuleLoader__.load({
 			let selected = autoValue("auto");
 			/** 0.1.3+ 会话文件链接路由（remote.session.openWorkspacePath）是否已安装（compatSummary 展示用）。 */
 			let remoteOpenInstalled = false;
-			/** 两条文件链接路由共用的路由日志（openPathRouter / remoteOpenRouter）。 */
-			const routeLogger = (message) => console.warn("[dsh-vscode-mode] " + message);
+			/** 两条文件链接路由共用的路由日志（openPathRouter / remoteOpenRouter；统一走插件日志器）。 */
+			const routeLogger = (message) => log.warn(message);
 			/** 两条路由共用的 FileOpenContext：当前会话 id 与工作区 cwd。 */
 			const openContext = () => {
 				const current = sessions?.list?.getSnapshot?.();
@@ -11877,7 +11963,7 @@ window.__ModuleLoader__.load({
 			let remoteRetries = 0;
 			const retryRemoteOpen = () => {
 				if (remoteOpenInstalled || remoteRetries >= 15) {
-					if (!remoteOpenInstalled) console.warn("[dsh-vscode-mode] 未探测到 remote.session.openWorkspacePath，0.1.3+ 会话文件链接路由未安装");
+					if (!remoteOpenInstalled) log.warn("未探测到 remote.session.openWorkspacePath，0.1.3+ 会话文件链接路由未安装");
 					return;
 				}
 				remoteRetries += 1;
@@ -11895,12 +11981,12 @@ window.__ModuleLoader__.load({
 						logger: routeLogger
 					});
 					if (!disposer) {
-						console.warn("[dsh-vscode-mode] remote.session 存在但 openWorkspacePath 不可补丁，会话文件链接路由未安装");
+						log.warn("remote.session 存在但 openWorkspacePath 不可补丁，会话文件链接路由未安装");
 						return;
 					}
 					remoteOpenInstalled = true;
 					ctx.effect(() => disposer, "vscode-mode: remote file link routing");
-					console.info("[dsh-vscode-mode] 已安装 0.1.3+ 会话文件链接路由（remote.session.openWorkspacePath）");
+					log.info("已安装 0.1.3+ 会话文件链接路由（remote.session.openWorkspacePath）");
 				}, 2e3);
 			};
 			retryRemoteOpen();
@@ -11971,7 +12057,7 @@ window.__ModuleLoader__.load({
 					if (sideService !== void 0) return;
 					sideService = detectSidebarService(ctx);
 					if (sideService !== void 0) {
-						console.info("[dsh-vscode-mode] 检测到 dsh-better-sidebar，切换侧边栏编辑形态");
+						log.info("检测到 dsh-better-sidebar，切换侧边栏编辑形态");
 						applySideForm();
 					} else retrySideService();
 				}, 2e3);