dsh-plugin 1.3.8 → 1.3.9

package/client/client.js

@@ -290,6 +290,12 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			failNetworkHint: "安装前检测到网络不通：无法连接到安装源（可能是断网、DNS 解析失败、被防火墙拦截，或代理配置有问题）。这不是插件本身的问题 —— 请检查网络连接，或到「设置」里确认 HTTP 代理配置，再到「系统诊断」运行一次连通性检测，然后重试。",
 			failNetworkTarget: "无法访问 {url} —— 你的网络连接不通",
 			failNetworkRunDiag: "去系统诊断检测网络",
+			failDshMissingHint: "系统找不到 dsh 命令（dsh 未加入系统 PATH），无法调用安装器执行安装。请确认 DeepSeek Harness 已正确安装、dsh 已加入 PATH（或重新安装），然后重试。这不是插件本身的问题。",
+			failPnpmMissingHint: "安装器找到了 dsh，但系统里没有 pnpm 命令（dsh 用它来管理 profile 插件）。请先安装 pnpm（如 npm install -g pnpm），确认 pnpm 已加入 PATH 后重试。这不是插件本身的问题。",
+			installChannelNpm: "NPM 包",
+			installChannelGit: "GitHub 源码",
+			installChannelDsh: "DSH 命令",
+			installEntryLine: "安装入口：{c}。",
 			reportIssue: "去插件仓库提交 Issue",
 			detail: "打开详情",
 			noResult: "没有找到匹配的插件",
@@ -606,6 +612,12 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			failNetworkHint: "The network could not be reached before install: the install source is unreachable (offline, DNS failure, firewall block, or a misconfigured proxy). This is not a problem with the plugin itself — please check your connection, confirm the HTTP proxy in Settings, run a connectivity check under System Diagnostics, then retry.",
 			failNetworkTarget: "Cannot reach {url} — your network connection is down",
 			failNetworkRunDiag: "Run a network diagnostic",
+			failDshMissingHint: "The dsh command could not be found (it is not on the system PATH), so the installer could not run. Please make sure DeepSeek Harness is installed correctly and dsh is on your PATH (or reinstall it), then retry. This is not a problem with the plugin itself.",
+			failPnpmMissingHint: "The installer found dsh, but pnpm is missing on this machine (dsh uses it to manage profile plugins). Please install pnpm first (e.g. npm install -g pnpm), make sure it is on your PATH, then retry. This is not a problem with the plugin itself.",
+			installChannelNpm: "NPM package",
+			installChannelGit: "GitHub source",
+			installChannelDsh: "DSH command",
+			installEntryLine: "Install entry: {c}.",
 			reportIssue: "Report an Issue to the plugin repo",
 			detail: "Open details",
 			noResult: "No plugins match your search",
@@ -658,42 +670,42 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$11
 		});
 		var Header_module_css_default = {
-			"headerRight": "qikqja_headerRight",
-			"resultCount": "qikqja_resultCount",
+			"tagline": "qikqja_tagline",
+			"tab": "qikqja_tab",
 			"adBanner": "qikqja_adBanner",
-			"segLabel": "qikqja_segLabel",
 			"adBadge": "qikqja_adBadge",
+			"sortGroup": "qikqja_sortGroup",
 			"search": "qikqja_search",
-			"root": "qikqja_root",
-			"headerTitleRow": "qikqja_headerTitleRow",
-			"resultSeg": "qikqja_resultSeg",
-			"tabCount": "qikqja_tabCount",
-			"githubIcon": "qikqja_githubIcon",
-			"title": "qikqja_title",
-			"segBtn": "qikqja_segBtn",
-			"tabs": "qikqja_tabs",
-			"versionBtn": "qikqja_versionBtn",
-			"aboutBtn": "qikqja_aboutBtn",
-			"logoIcon": "qikqja_logoIcon",
-			"controls": "qikqja_controls",
-			"taglineLink": "qikqja_taglineLink",
-			"hubUpdateBadge": "qikqja_hubUpdateBadge",
-			"copyIcon": "qikqja_copyIcon",
-			"segBtnActive": "qikqja_segBtnActive",
-			"searchRow": "qikqja_searchRow",
+			"tabsRow": "qikqja_tabsRow",
 			"adText": "qikqja_adText",
+			"logoIcon": "qikqja_logoIcon",
 			"tabActive": "qikqja_tabActive",
-			"githubLink": "qikqja_githubLink",
-			"tabsRow": "qikqja_tabsRow",
-			"sortGroup": "qikqja_sortGroup",
 			"header": "qikqja_header",
-			"langBtn": "qikqja_langBtn",
-			"brandTitle": "qikqja_brandTitle",
-			"tagline": "qikqja_tagline",
-			"tab": "qikqja_tab",
+			"versionBtn": "qikqja_versionBtn",
+			"segBtnActive": "qikqja_segBtnActive",
+			"aboutBtn": "qikqja_aboutBtn",
+			"githubIcon": "qikqja_githubIcon",
 			"segGroup": "qikqja_segGroup",
+			"segBtn": "qikqja_segBtn",
+			"headerRight": "qikqja_headerRight",
+			"langBtn": "qikqja_langBtn",
+			"resultSeg": "qikqja_resultSeg",
+			"githubLink": "qikqja_githubLink",
 			"version": "qikqja_version",
-			"adArrow": "qikqja_adArrow"
+			"copyIcon": "qikqja_copyIcon",
+			"headerTitleRow": "qikqja_headerTitleRow",
+			"resultCount": "qikqja_resultCount",
+			"adArrow": "qikqja_adArrow",
+			"brandTitle": "qikqja_brandTitle",
+			"controls": "qikqja_controls",
+			"segLabel": "qikqja_segLabel",
+			"searchRow": "qikqja_searchRow",
+			"taglineLink": "qikqja_taglineLink",
+			"tabs": "qikqja_tabs",
+			"title": "qikqja_title",
+			"hubUpdateBadge": "qikqja_hubUpdateBadge",
+			"tabCount": "qikqja_tabCount",
+			"root": "qikqja_root"
 		};
 		//#endregion
 		//#region \0dsh-css:src/client/styles/Modal.module.css.mjs
@@ -712,136 +724,136 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$10
 		});
 		var Modal_module_css_default = {
-			"modalClose": "BiQ1zG_modalClose",
-			"queuedHint": "BiQ1zG_queuedHint",
-			"resultCheckIcon": "BiQ1zG_resultCheckIcon",
-			"modalActions": "BiQ1zG_modalActions",
-			"logModal": "BiQ1zG_logModal",
+			"modalCmdText": "BiQ1zG_modalCmdText",
+			"result": "BiQ1zG_result",
+			"failKind": "BiQ1zG_failKind",
+			"progressText": "BiQ1zG_progressText",
+			"progressFill": "BiQ1zG_progressFill",
+			"hubUpdateMeta": "BiQ1zG_hubUpdateMeta",
+			"aboutModal": "BiQ1zG_aboutModal",
+			"failedCopyHint": "BiQ1zG_failedCopyHint",
+			"modalCloseIcon": "BiQ1zG_modalCloseIcon",
+			"confirmIcon": "BiQ1zG_confirmIcon",
+			"modalIn": "BiQ1zG_modalIn",
+			"noticeBadgeOk": "BiQ1zG_noticeBadgeOk",
+			"failClear": "BiQ1zG_failClear",
 			"modalCopy": "BiQ1zG_modalCopy",
-			"restartLater": "BiQ1zG_restartLater",
-			"queueSectionTitle": "BiQ1zG_queueSectionTitle",
+			"failKindInstall": "BiQ1zG_failKindInstall",
+			"modalCmdCopy": "BiQ1zG_modalCmdCopy",
+			"progressFillFail": "BiQ1zG_progressFillFail",
+			"detailUpdateHint": "BiQ1zG_detailUpdateHint",
+			"queueRowTarget": "BiQ1zG_queueRowTarget",
+			"toastFail": "BiQ1zG_toastFail",
+			"modalValue": "BiQ1zG_modalValue",
+			"noticeRowOk": "BiQ1zG_noticeRowOk",
+			"noticeFoot": "BiQ1zG_noticeFoot",
+			"detailStatusRunning": "BiQ1zG_detailStatusRunning",
+			"modalCancel": "BiQ1zG_modalCancel",
+			"queueRowTrack": "BiQ1zG_queueRowTrack",
+			"errorCopySoft": "BiQ1zG_errorCopySoft",
+			"cliOnlyHint": "BiQ1zG_cliOnlyHint",
+			"queueRowBody": "BiQ1zG_queueRowBody",
+			"noticeBadgeIcon": "BiQ1zG_noticeBadgeIcon",
+			"failHead": "BiQ1zG_failHead",
+			"uninstallConfirm": "BiQ1zG_uninstallConfirm",
+			"detailRow": "BiQ1zG_detailRow",
+			"errorModal": "BiQ1zG_errorModal",
+			"progress": "BiQ1zG_progress",
+			"failPrepareHint": "BiQ1zG_failPrepareHint",
+			"detailPathText": "BiQ1zG_detailPathText",
+			"hubUpdateNotes": "BiQ1zG_hubUpdateNotes",
+			"toast": "BiQ1zG_toast",
 			"noticeMain": "BiQ1zG_noticeMain",
-			"failRepo": "BiQ1zG_failRepo",
-			"noticeList": "BiQ1zG_noticeList",
-			"noticeIgnore": "BiQ1zG_noticeIgnore",
-			"modalTitleBusy": "BiQ1zG_modalTitleBusy",
-			"detailLabel": "BiQ1zG_detailLabel",
-			"detailPathActions": "BiQ1zG_detailPathActions",
 			"modalDesc": "BiQ1zG_modalDesc",
-			"modalCloseIcon": "BiQ1zG_modalCloseIcon",
-			"noticeRowUpdate": "BiQ1zG_noticeRowUpdate",
-			"modalLabel": "BiQ1zG_modalLabel",
-			"modalLink": "BiQ1zG_modalLink",
-			"failDiagBtn": "BiQ1zG_failDiagBtn",
-			"restartNowWarning": "BiQ1zG_restartNowWarning",
-			"trustHint": "BiQ1zG_trustHint",
-			"linkIcon": "BiQ1zG_linkIcon",
-			"detailStatusPending": "BiQ1zG_detailStatusPending",
-			"detailStatusRunning": "BiQ1zG_detailStatusRunning",
-			"failCopy": "BiQ1zG_failCopy",
+			"queueRow": "BiQ1zG_queueRow",
+			"resultCheck": "BiQ1zG_resultCheck",
+			"modalClose": "BiQ1zG_modalClose",
 			"progressHead": "BiQ1zG_progressHead",
-			"detailPathBtn": "BiQ1zG_detailPathBtn",
-			"progress": "BiQ1zG_progress",
-			"hubUpdateMetaItem": "BiQ1zG_hubUpdateMetaItem",
+			"detailLabel": "BiQ1zG_detailLabel",
+			"failRow": "BiQ1zG_failRow",
+			"noticeList": "BiQ1zG_noticeList",
+			"linkIcon": "BiQ1zG_linkIcon",
+			"queueRowHead": "BiQ1zG_queueRowHead",
+			"restartLater": "BiQ1zG_restartLater",
+			"modalRow": "BiQ1zG_modalRow",
+			"noticeTextOk": "BiQ1zG_noticeTextOk",
 			"resultDesc": "BiQ1zG_resultDesc",
-			"confirmPrimary": "BiQ1zG_confirmPrimary",
-			"noticeTime": "BiQ1zG_noticeTime",
-			"queueRowBody": "BiQ1zG_queueRowBody",
-			"failNetworkTarget": "BiQ1zG_failNetworkTarget",
-			"noticeVersion": "BiQ1zG_noticeVersion",
+			"detailPath": "BiQ1zG_detailPath",
 			"modal": "BiQ1zG_modal",
-			"failKindInstall": "BiQ1zG_failKindInstall",
-			"noticeBadgeFail": "BiQ1zG_noticeBadgeFail",
-			"detailStatusText": "BiQ1zG_detailStatusText",
-			"modalCancel": "BiQ1zG_modalCancel",
-			"result": "BiQ1zG_result",
+			"noticeUpdateGo": "BiQ1zG_noticeUpdateGo",
+			"progressTrack": "BiQ1zG_progressTrack",
+			"detailPathActions": "BiQ1zG_detailPathActions",
+			"aboutMeta": "BiQ1zG_aboutMeta",
+			"stripCancel": "BiQ1zG_stripCancel",
+			"overlayIn": "BiQ1zG_overlayIn",
+			"detailLink": "BiQ1zG_detailLink",
+			"modalWide": "BiQ1zG_modalWide",
+			"modalActions": "BiQ1zG_modalActions",
+			"noticeTextFail": "BiQ1zG_noticeTextFail",
+			"detailPathBtn": "BiQ1zG_detailPathBtn",
+			"failBigIssue": "BiQ1zG_failBigIssue",
 			"errorTitle": "BiQ1zG_errorTitle",
-			"modalCmdText": "BiQ1zG_modalCmdText",
-			"progressFill": "BiQ1zG_progressFill",
-			"toastIn": "BiQ1zG_toastIn",
-			"confirmIconDanger": "BiQ1zG_confirmIconDanger",
+			"noticeTime": "BiQ1zG_noticeTime",
+			"queueSection": "BiQ1zG_queueSection",
+			"failRepo": "BiQ1zG_failRepo",
+			"helpModal": "BiQ1zG_helpModal",
 			"noticeRow": "BiQ1zG_noticeRow",
-			"noticeRowOk": "BiQ1zG_noticeRowOk",
-			"modalIn": "BiQ1zG_modalIn",
-			"cliOnlyHint": "BiQ1zG_cliOnlyHint",
-			"queueRowStatus": "BiQ1zG_queueRowStatus",
-			"failEmpty": "BiQ1zG_failEmpty",
+			"modalHead": "BiQ1zG_modalHead",
+			"errorBox": "BiQ1zG_errorBox",
+			"confirmIconWrap": "BiQ1zG_confirmIconWrap",
+			"confirmIconDanger": "BiQ1zG_confirmIconDanger",
+			"noticeRemove": "BiQ1zG_noticeRemove",
+			"restartNow": "BiQ1zG_restartNow",
+			"modalTitle": "BiQ1zG_modalTitle",
+			"modalBody": "BiQ1zG_modalBody",
+			"toastIn": "BiQ1zG_toastIn",
+			"failList": "BiQ1zG_failList",
+			"failKindUninstall": "BiQ1zG_failKindUninstall",
 			"detailMono": "BiQ1zG_detailMono",
-			"stripCancel": "BiQ1zG_stripCancel",
-			"errorCopySoft": "BiQ1zG_errorCopySoft",
-			"toastFail": "BiQ1zG_toastFail",
-			"resultCheck": "BiQ1zG_resultCheck",
-			"helpModal": "BiQ1zG_helpModal",
-			"modalCmdCopy": "BiQ1zG_modalCmdCopy",
-			"hubUpdateNotes": "BiQ1zG_hubUpdateNotes",
-			"dangerConfirm": "BiQ1zG_dangerConfirm",
-			"queueRow": "BiQ1zG_queueRow",
-			"confirmIcon": "BiQ1zG_confirmIcon",
-			"noticeTextFail": "BiQ1zG_noticeTextFail",
-			"hubUpdateMeta": "BiQ1zG_hubUpdateMeta",
-			"failHead": "BiQ1zG_failHead",
 			"aboutContent": "BiQ1zG_aboutContent",
-			"aboutMeta": "BiQ1zG_aboutMeta",
-			"detailRow": "BiQ1zG_detailRow",
-			"resultRestarting": "BiQ1zG_resultRestarting",
-			"noticeUpdateGo": "BiQ1zG_noticeUpdateGo",
-			"failClear": "BiQ1zG_failClear",
-			"errorHint": "BiQ1zG_errorHint",
-			"modalValue": "BiQ1zG_modalValue",
-			"toast": "BiQ1zG_toast",
+			"overlay": "BiQ1zG_overlay",
+			"noticeIgnore": "BiQ1zG_noticeIgnore",
+			"hubUpdateModal": "BiQ1zG_hubUpdateModal",
+			"modalCmd": "BiQ1zG_modalCmd",
+			"noticeRowUpdate": "BiQ1zG_noticeRowUpdate",
+			"noticeHead": "BiQ1zG_noticeHead",
+			"queuedHint": "BiQ1zG_queuedHint",
+			"queueSectionTitle": "BiQ1zG_queueSectionTitle",
 			"queueRowDesc": "BiQ1zG_queueRowDesc",
-			"progressText": "BiQ1zG_progressText",
-			"modalRow": "BiQ1zG_modalRow",
-			"errorModal": "BiQ1zG_errorModal",
-			"modalBody": "BiQ1zG_modalBody",
-			"queueRowTarget": "BiQ1zG_queueRowTarget",
-			"errorBox": "BiQ1zG_errorBox",
-			"queueSection": "BiQ1zG_queueSection",
-			"detailStars": "BiQ1zG_detailStars",
-			"detailPathText": "BiQ1zG_detailPathText",
 			"pendingRowStatus": "BiQ1zG_pendingRowStatus",
-			"failPrepareHint": "BiQ1zG_failPrepareHint",
-			"noticeHead": "BiQ1zG_noticeHead",
-			"failList": "BiQ1zG_failList",
-			"resultTitle": "BiQ1zG_resultTitle",
-			"noticeBadgeOk": "BiQ1zG_noticeBadgeOk",
-			"progressTrack": "BiQ1zG_progressTrack",
-			"failKind": "BiQ1zG_failKind",
-			"detailPath": "BiQ1zG_detailPath",
-			"failedCopyHint": "BiQ1zG_failedCopyHint",
-			"detailDim": "BiQ1zG_detailDim",
-			"queueRowTrack": "BiQ1zG_queueRowTrack",
-			"modalInstall": "BiQ1zG_modalInstall",
-			"noticeRemove": "BiQ1zG_noticeRemove",
-			"queueRowPct": "BiQ1zG_queueRowPct",
-			"overlay": "BiQ1zG_overlay",
-			"uninstallConfirm": "BiQ1zG_uninstallConfirm",
-			"confirmIconWrap": "BiQ1zG_confirmIconWrap",
-			"failBigIssue": "BiQ1zG_failBigIssue",
-			"noticeBadgeIcon": "BiQ1zG_noticeBadgeIcon",
-			"detailArrow": "BiQ1zG_detailArrow",
-			"detailLink": "BiQ1zG_detailLink",
+			"resultRestarting": "BiQ1zG_resultRestarting",
 			"detailValue": "BiQ1zG_detailValue",
-			"detailModal": "BiQ1zG_detailModal",
-			"modalCmd": "BiQ1zG_modalCmd",
-			"noticeFoot": "BiQ1zG_noticeFoot",
-			"modalTitleQueued": "BiQ1zG_modalTitleQueued",
-			"noticeTextOk": "BiQ1zG_noticeTextOk",
-			"progressFillFail": "BiQ1zG_progressFillFail",
+			"errorHint": "BiQ1zG_errorHint",
+			"dangerConfirm": "BiQ1zG_dangerConfirm",
 			"noticeRowMain": "BiQ1zG_noticeRowMain",
-			"overlayIn": "BiQ1zG_overlayIn",
-			"restartNow": "BiQ1zG_restartNow",
-			"failRow": "BiQ1zG_failRow",
-			"modalTitle": "BiQ1zG_modalTitle",
-			"modalHead": "BiQ1zG_modalHead",
-			"pendingRowActions": "BiQ1zG_pendingRowActions",
-			"modalWide": "BiQ1zG_modalWide",
+			"confirmPrimary": "BiQ1zG_confirmPrimary",
+			"resultCheckIcon": "BiQ1zG_resultCheckIcon",
+			"detailModal": "BiQ1zG_detailModal",
+			"failEmpty": "BiQ1zG_failEmpty",
+			"failDiagBtn": "BiQ1zG_failDiagBtn",
+			"detailArrow": "BiQ1zG_detailArrow",
+			"detailStatusText": "BiQ1zG_detailStatusText",
+			"logModal": "BiQ1zG_logModal",
+			"modalLabel": "BiQ1zG_modalLabel",
+			"queueRowPct": "BiQ1zG_queueRowPct",
+			"queueRowStatus": "BiQ1zG_queueRowStatus",
+			"detailDim": "BiQ1zG_detailDim",
+			"modalInstall": "BiQ1zG_modalInstall",
+			"modalTitleBusy": "BiQ1zG_modalTitleBusy",
+			"detailStatusPending": "BiQ1zG_detailStatusPending",
+			"resultTitle": "BiQ1zG_resultTitle",
+			"noticeVersion": "BiQ1zG_noticeVersion",
+			"failNetworkTarget": "BiQ1zG_failNetworkTarget",
+			"detailStars": "BiQ1zG_detailStars",
 			"detailGrid": "BiQ1zG_detailGrid",
-			"aboutModal": "BiQ1zG_aboutModal",
-			"detailUpdateHint": "BiQ1zG_detailUpdateHint",
-			"hubUpdateModal": "BiQ1zG_hubUpdateModal",
-			"failKindUninstall": "BiQ1zG_failKindUninstall",
-			"queueRowHead": "BiQ1zG_queueRowHead"
+			"modalLink": "BiQ1zG_modalLink",
+			"failCopy": "BiQ1zG_failCopy",
+			"pendingRowActions": "BiQ1zG_pendingRowActions",
+			"modalTitleQueued": "BiQ1zG_modalTitleQueued",
+			"hubUpdateMetaItem": "BiQ1zG_hubUpdateMetaItem",
+			"noticeBadgeFail": "BiQ1zG_noticeBadgeFail",
+			"restartNowWarning": "BiQ1zG_restartNowWarning",
+			"trustHint": "BiQ1zG_trustHint"
 		};
 		//#endregion
 		//#region src/client/logic/install-command.ts
@@ -911,7 +923,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 		* tsdown 构建时用 define 把 __PLUGIN_VERSION__ 替换成 package.json 的版本号；
 		* node --test 直接 import 本模块时该标识符不存在，typeof 守卫兜底为空串。
 		*/
-		const PLUGIN_VERSION = "1.3.8";
+		const PLUGIN_VERSION = "1.3.9";
 		const CATEGORY_ORDER = [
 			"interface",
 			"session",
@@ -1544,7 +1556,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			*/
 			const hubHasUpdate = (() => {
 				if (!hubUpdateInfo) return false;
-				return hubUpdateInfo.version !== "1.3.8";
+				return hubUpdateInfo.version !== "1.3.9";
 			})();
 			(0, react.useMemo)(() => {
 				if (!plugins) return [];
@@ -1723,12 +1735,19 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			return next;
 		}
 		/**
-		* 失败归类，五态。无论底层机制如何（pnpm 白名单拦截 / 构建脚本被忽略 / prepare 失败），
+		* 失败归类，七态。无论底层机制如何（pnpm 白名单拦截 / 构建脚本被忽略 / prepare 失败），
 		* 对用户而言结果都一样 —— 当前安装通道（npm 或 git）装不上，就是插件分发/依赖的问题，
-		* 一律引导提 Issue；唯一的两个例外是本机环境问题（npm 版本过低 / 网络不通）：
+		* 一律引导提 Issue；唯一的例外是本机环境问题（npm 版本过低 / 找不到 dsh / 找不到 pnpm / 网络不通）：
 		* - npmTooOld：失败输出含 npm arborist 的 `edgesOut` 崩溃特征（build-ideal-tree.js 解 peer 依赖时
 		*   内部抛错，npm 11.6.0 前必现的已知缺陷，npm/cli#8261、#9787），或服务端已核实本机版本低于
 		*   阈值并打了 `[npm-too-low]` 标记 —— 是本机 npm 版本过低/自身缺陷，不是插件问题 → 引导升级 npm
+		* - dshMissing：安装器 spawn 的 `dsh` 命令找不到（Windows cmd「不是内部或外部命令」/ POSIX
+		*   「command not found」/ spawn ENOENT）—— 是本机 DSH 未正确安装或不在 PATH，不是插件问题
+		*   → 提示检查 PATH/重装 DSH，不引导提 Issue
+		* - pnpmMissing：dsh 存在但调用的 `pnpm` 找不到（dsh 报 `pnpm not found on PATH`/POSIX
+		*   「pnpm: command not found」/ spawn ENOENT）—— 本机缺 pnpm（dsh 用 pnpm 管理 profile 插件），
+		*   不是插件问题（dsh-plugin-hub#13：Linux 下 `dsh: pnpm not found on PATH` 被误归插件侧失败）
+		*   → 提示安装/开启 pnpm，不引导提 Issue
 		* - network：安装前连通性预检拦截（服务端 `[network]` 标记）或底层连接失败
 		*   （ERR_PNPM_GIT_FETCH_FAILED / ETIMEDOUT / DNS 解析 / TLS 握手 / 代理拒绝）——
 		*   是本机网络不通/被墙/代理有问题，不是插件问题 → 提示检查网络，不引导提 Issue
@@ -1742,6 +1761,8 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 		*/
 		function classifyFailure(message) {
 			if (/\[npm-too-low\]|edgesOut/i.test(message)) return "npmTooOld";
+			if (/\[pnpm-missing\]|pnpm not found|pnpm: command not found|spawn pnpm ENOENT|'pnpm' 不是内部或外部命令|"pnpm" 不是内部或外部命令|pnpm['"]?\s*is not recognized/i.test(message)) return "pnpmMissing";
+			if (/\[dsh-missing\]|不是内部或外部命令|is not recognized as an internal or external command|command not found|spawn dsh ENOENT/i.test(message)) return "dshMissing";
 			if (/ERR_PNPM_IGNORED_BUILDS|Ignored build scripts:|ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED/i.test(message)) return "pnpmIgnoredBuild";
 			if (/\[network\]|ERR_PNPM_GIT_FETCH_FAILED|ETIMEDOUT|ECONNREFUSED|ECONNRESET|ENOTFOUND|EAI_AGAIN|EPIPE|EHOSTUNREACH|ENETUNREACH|getaddrinfo|Could not connect|Could not resolve host|Network unreachable|Failed to connect|socket hang up|CERT_HAS_EXPIRED|SSL certificate problem|\bTLS\b|\bSSL\b/i.test(message)) return "network";
 			if (/\[packaging\]|entry file missing/i.test(message)) return "pluginPrepare";
@@ -1834,6 +1855,8 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 		function reasonTitleOf(kind) {
 			switch (kind) {
 				case "npmTooOld": return "npm too old to install";
+				case "dshMissing": return "dsh command not found on the user machine";
+				case "pnpmMissing": return "pnpm command not found on the user machine";
 				case "pnpmIgnoredBuild": return "build scripts blocked by pnpm allowlist";
 				case "pluginPrepare": return "plugin distribution incomplete";
 				case "network": return "network failure on the user side";
@@ -2035,6 +2058,11 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 		/** 安装/卸载请求超时（ms）：服务端 preflight + npm 反查可能耗时（各自都有超时，合计约 20~30s），
 		*  给足余量；超时主动中止，避免服务端 preflight 网络挂起时前端永久卡「安装中 0%」。 */
 		const REQUEST_TIMEOUT_MS = 6e4;
+		/** 入口渠道的 i18n key：NPM 包 / GitHub 源码 / DSH 命令。 */
+		const channelKeyOf = (channel) => channel === "git" ? "installChannelGit" : channel === "dsh" ? "installChannelDsh" : "installChannelNpm";
+		/** 失败消息的入口溯源前缀：自定义安装（带渠道）在错误正文顶部精准指出从哪张卡片发起；
+		*  目录插件安装（无渠道）返回 null，错误正文保持原样。 */
+		const entryLineOf = (t, channel) => channel ? t("installEntryLine", { c: t(channelKeyOf(channel)) }) : null;
 		function useTaskQueue(opts) {
 			const { t, langKey, refreshInstalled, onInstallDone, onUninstallDone, onError, installPlugin, installCustomTarget, installGlobalTarget, uninstallPlugin, uninstallName, installedName, resolvePending } = opts;
 			const [queue, setQueue] = (0, react.useState)([]);
@@ -2148,8 +2176,9 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 						onInstallDone(modalTaskRef.current === q.id, q.repo, q.needsRestart, q.action === "update");
 					}
 				} else {
-					const detail = lines.length > 0 ? [...lines].reverse().join("\n") : q.kind === "uninstall" ? t("uninstallFail") : t("installFail");
-					onError(detail, q.repo, q.kind, q.command, q.attempts, q.action === "update");
+					const rawDetail = lines.length > 0 ? [...lines].reverse().join("\n") : q.kind === "uninstall" ? t("uninstallFail") : t("installFail");
+					const entry = entryLineOf(t, q.channel);
+					onError(entry ? `${entry}\n${rawDetail}` : rawDetail, q.repo, q.kind, q.command, q.attempts, q.action === "update");
 				}
 				maybeStopPoll();
 			};
@@ -2247,7 +2276,8 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 									progress: typeof a.progress === "number" ? a.progress : prevTask?.progress ?? 0,
 									lines: Array.isArray(a.lines) ? a.lines : prevTask?.lines ?? [],
 									attempts: Array.isArray(a.attempts) ? a.attempts : prevTask?.attempts ?? [],
-									needsRestart: typeof a.needsRestart === "boolean" ? a.needsRestart : prevTask?.needsRestart ?? true
+									needsRestart: typeof a.needsRestart === "boolean" ? a.needsRestart : prevTask?.needsRestart ?? true,
+									channel: a.installChannel === "npm" || a.installChannel === "git" || a.installChannel === "dsh" ? a.installChannel : prevTask?.channel
 								});
 							}
 							const keepOpt = prev.filter((q) => q.optimistic && !next.some((x) => x.id === q.id));
@@ -2292,7 +2322,8 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 								progress: typeof a.progress === "number" ? a.progress : 0,
 								lines: Array.isArray(a.lines) ? a.lines : [],
 								attempts: Array.isArray(a.attempts) ? a.attempts : [],
-								needsRestart: typeof a.needsRestart === "boolean" ? a.needsRestart : true
+								needsRestart: typeof a.needsRestart === "boolean" ? a.needsRestart : true,
+								channel: a.installChannel === "npm" || a.installChannel === "git" || a.installChannel === "dsh" ? a.installChannel : void 0
 							};
 						});
 						if (items.length > 0 || pendingRef.current.length > 0) {
@@ -2330,6 +2361,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 					lines: [],
 					optimistic: true,
 					command: input.command,
+					channel: input.channel,
 					action: input.update ? "update" : "add",
 					attempts: [],
 					needsRestart: true
@@ -2347,6 +2379,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 							source: input.source,
 							mode: input.update ? "update" : void 0,
 							...langKey ? { lang: langKey } : {},
+							...input.channel ? { installChannel: input.channel } : {},
 							...input.globalNpm && input.globalNpm.length > 0 ? { globalNpm: input.globalNpm } : {}
 						}),
 						signal: controller.signal
@@ -2354,7 +2387,9 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 					const data = await res.json();
 					if (!data.ok || typeof data.task !== "number") {
 						applyQueue((prev) => prev.filter((x) => x.id !== tempId));
-						onError(data.error || `HTTP ${res.status}`, input.repo, "install", input.command, data.attempts);
+						const entry = entryLineOf(t, input.channel);
+						const msg = data.error || `HTTP ${res.status}`;
+						onError(entry ? `${entry}\n${msg}` : msg, input.repo, "install", input.command, data.attempts);
 						return;
 					}
 					const taskId = data.task;
@@ -2372,7 +2407,9 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 				} catch (err) {
 					applyQueue((prev) => prev.filter((x) => x.id !== tempId));
 					const reason = err?.name === "AbortError" ? t("requestTimeout") : err instanceof Error && err.message ? err.message : String(err ?? "");
-					onError(reason ? `${t("installFail")} — ${reason}` : t("installFail"), input.repo, "install", input.command);
+					const entry = entryLineOf(t, input.channel);
+					const msg = reason ? `${t("installFail")} — ${reason}` : t("installFail");
+					onError(entry ? `${entry}\n${msg}` : msg, input.repo, "install", input.command);
 				} finally {
 					window.clearTimeout(timeout);
 					submittingRef.current.delete(input.repo);
@@ -2398,6 +2435,8 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			};
 			/** 命令行安装：用户手输 npm 包名或 GitHub 地址，走 custom 源（受安全开关控制）。
 			*  update=true 时对已安装目标放行覆盖重装（与目录插件「更新」同一语义）。
+			*  channel=入口渠道（NPM 包 / GitHub 源码 / DSH 命令卡片）：上报服务端落日志，
+			*  失败弹窗/通知据此精准溯源。
 			*  队列展示/防重一律用归一化身份（owner/repo 或 npm 包名）：与服务端 /active 合并、
 			*  弹窗目标匹配同口径，npm 包名透传不受影响。 */
 			const installCustom = async (raw, opts) => {
@@ -2409,11 +2448,12 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 					repo,
 					command: `pnpm add ${target}`,
 					source: "custom",
-					update: opts?.update
+					update: opts?.update,
+					channel: opts?.channel
 				});
 			};
 			/** 全局 npm 安装（官方 README 的 `npm install -g <pkgs>`）：不进任何 profile、无需宿主重启。
-			*  队列展示/防重用包列表空格拼接的身份（与服务端 target 同口径）。 */
+			*  队列展示/防重用包列表空格拼接的身份（与服务端 target 同口径）；入口渠道固定为 npm（NPM 包卡片）。 */
 			const installGlobalNpm = async (pkgs, opts) => {
 				const list = (pkgs ?? []).map((p) => p.trim()).filter((p) => p !== "");
 				if (list.length === 0) return;
@@ -2424,7 +2464,8 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 					command: `npm install -g ${identity}`,
 					source: "custom",
 					globalNpm: list,
-					update: opts?.update
+					update: opts?.update,
+					channel: opts?.channel ?? "npm"
 				});
 			};
 			/** 卸载入队核心：按 npm 包名直卸（目录插件与自定义安装共用，弹窗进度匹配同源）。 */
@@ -3212,7 +3253,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			}, repo) : null, (0, react.createElement)("button", {
 				className: Modal_module_css_default.errorCopySoft,
 				onClick: () => onCopy(copyText)
-			}, t("errorCopy"))), (0, react.createElement)("pre", { className: Modal_module_css_default.errorBox }, message), failureKind === "npmTooOld" ? (0, react.createElement)("div", { className: Modal_module_css_default.failPrepareHint }, t(npmVersion ? "failNpmTooLowV" : "failNpmTooLow", npmVersion ? { v: npmVersion } : void 0)) : failureKind === "network" ? (0, react.createElement)("div", null, [
+			}, t("errorCopy"))), (0, react.createElement)("pre", { className: Modal_module_css_default.errorBox }, message), failureKind === "npmTooOld" ? (0, react.createElement)("div", { className: Modal_module_css_default.failPrepareHint }, t(npmVersion ? "failNpmTooLowV" : "failNpmTooLow", npmVersion ? { v: npmVersion } : void 0)) : failureKind === "dshMissing" ? (0, react.createElement)("div", { className: Modal_module_css_default.failPrepareHint }, t("failDshMissingHint")) : failureKind === "pnpmMissing" ? (0, react.createElement)("div", { className: Modal_module_css_default.failPrepareHint }, t("failPnpmMissingHint")) : failureKind === "network" ? (0, react.createElement)("div", null, [
 				(() => {
 					const target = unreachableTargetOf(message);
 					return target ? (0, react.createElement)("div", { className: Modal_module_css_default.failNetworkTarget }, t("failNetworkTarget", { url: target })) : null;
@@ -3763,6 +3804,8 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 						const v = npmTooLowVersion(r.message);
 						return (0, react.createElement)("div", { className: Modal_module_css_default.failPrepareHint }, t(v ? "failNpmTooLowV" : "failNpmTooLow", v ? { v } : void 0));
 					}
+					if (kind === "dshMissing") return (0, react.createElement)("div", { className: Modal_module_css_default.failPrepareHint }, t("failDshMissingHint"));
+					if (kind === "pnpmMissing") return (0, react.createElement)("div", { className: Modal_module_css_default.failPrepareHint }, t("failPnpmMissingHint"));
 					if (kind === "network") return (0, react.createElement)("div", null, [
 						(() => {
 							const target = unreachableTargetOf(r.message);
@@ -3968,40 +4011,40 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$9
 		});
 		var List_module_css_default = {
-			"desc": "_3XaZHa_desc",
-			"fork": "_3XaZHa_fork",
-			"installBtn": "_3XaZHa_installBtn",
-			"retryBtn": "_3XaZHa_retryBtn",
-			"uninstallBtn": "_3XaZHa_uninstallBtn",
-			"installBtnInstalled": "_3XaZHa_installBtnInstalled",
+			"list": "_3XaZHa_list",
+			"cardSide": "_3XaZHa_cardSide",
 			"state": "_3XaZHa_state",
+			"star": "_3XaZHa_star",
+			"installBtnInstalled": "_3XaZHa_installBtnInstalled",
+			"verified": "_3XaZHa_verified",
+			"stats": "_3XaZHa_stats",
 			"diagBtn": "_3XaZHa_diagBtn",
-			"cardMain": "_3XaZHa_cardMain",
-			"cardSide": "_3XaZHa_cardSide",
-			"topics": "_3XaZHa_topics",
-			"detailBtn": "_3XaZHa_detailBtn",
-			"cardHead": "_3XaZHa_cardHead",
-			"stateActions": "_3XaZHa_stateActions",
-			"footer": "_3XaZHa_footer",
-			"installBtnUpdate": "_3XaZHa_installBtnUpdate",
+			"updateBadge": "_3XaZHa_updateBadge",
+			"date": "_3XaZHa_date",
 			"actions": "_3XaZHa_actions",
-			"list": "_3XaZHa_list",
+			"footer": "_3XaZHa_footer",
+			"installBtnCopied": "_3XaZHa_installBtnCopied",
+			"stateActions": "_3XaZHa_stateActions",
 			"stateTitle": "_3XaZHa_stateTitle",
-			"updateBadge": "_3XaZHa_updateBadge",
+			"uninstallBtn": "_3XaZHa_uninstallBtn",
 			"topic": "_3XaZHa_topic",
-			"star": "_3XaZHa_star",
-			"stateDesc": "_3XaZHa_stateDesc",
-			"verified": "_3XaZHa_verified",
-			"stats": "_3XaZHa_stats",
-			"date": "_3XaZHa_date",
+			"versionBadge": "_3XaZHa_versionBadge",
+			"installBtnUpdate": "_3XaZHa_installBtnUpdate",
 			"card": "_3XaZHa_card",
-			"cardTitle": "_3XaZHa_cardTitle",
-			"categoryBadge": "_3XaZHa_categoryBadge",
-			"footLink": "_3XaZHa_footLink",
+			"stateDesc": "_3XaZHa_stateDesc",
+			"desc": "_3XaZHa_desc",
+			"cardMain": "_3XaZHa_cardMain",
+			"fork": "_3XaZHa_fork",
+			"cardHead": "_3XaZHa_cardHead",
 			"body": "_3XaZHa_body",
+			"footLink": "_3XaZHa_footLink",
+			"cardTitle": "_3XaZHa_cardTitle",
+			"topics": "_3XaZHa_topics",
+			"retryBtn": "_3XaZHa_retryBtn",
 			"moreSentinel": "_3XaZHa_moreSentinel",
-			"versionBadge": "_3XaZHa_versionBadge",
-			"installBtnCopied": "_3XaZHa_installBtnCopied"
+			"detailBtn": "_3XaZHa_detailBtn",
+			"categoryBadge": "_3XaZHa_categoryBadge",
+			"installBtn": "_3XaZHa_installBtn"
 		};
 		//#endregion
 		//#region src/client/hooks/useIncrementalList.ts
@@ -4208,15 +4251,15 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$8
 		});
 		var SectionTabs_module_css_default = {
-			"tabCountActive": "_7tvizq_tabCountActive",
-			"tabActive": "_7tvizq_tabActive",
-			"noticeIcon": "_7tvizq_noticeIcon",
-			"tabIcon": "_7tvizq_tabIcon",
-			"noticeBtn": "_7tvizq_noticeBtn",
+			"tabCount": "_7tvizq_tabCount",
 			"noticeCount": "_7tvizq_noticeCount",
+			"noticeIcon": "_7tvizq_noticeIcon",
 			"root": "_7tvizq_root",
-			"tabCount": "_7tvizq_tabCount",
-			"tab": "_7tvizq_tab"
+			"tab": "_7tvizq_tab",
+			"noticeBtn": "_7tvizq_noticeBtn",
+			"tabCountActive": "_7tvizq_tabCountActive",
+			"tabActive": "_7tvizq_tabActive",
+			"tabIcon": "_7tvizq_tabIcon"
 		};
 		//#endregion
 		//#region src/client/components/layout/SectionTabs.tsx
@@ -4293,42 +4336,42 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$7
 		});
 		var InstalledView_module_css_default = {
-			"list": "_1nXeGW_list",
+			"toolbar": "_1nXeGW_toolbar",
+			"statusPending": "_1nXeGW_statusPending",
+			"rowUninstall": "_1nXeGW_rowUninstall",
 			"rowDetail": "_1nXeGW_rowDetail",
-			"rowMain": "_1nXeGW_rowMain",
-			"exampleBadge": "_1nXeGW_exampleBadge",
+			"segLabel": "_1nXeGW_segLabel",
+			"searchWrap": "_1nXeGW_searchWrap",
+			"rowSourceTag": "_1nXeGW_rowSourceTag",
 			"emptyTitle": "_1nXeGW_emptyTitle",
-			"segGroup": "_1nXeGW_segGroup",
-			"rowTitle": "_1nXeGW_rowTitle",
-			"root": "_1nXeGW_root",
-			"rowRepo": "_1nXeGW_rowRepo",
-			"rowRestart": "_1nXeGW_rowRestart",
+			"segBtn": "_1nXeGW_segBtn",
+			"exampleBadge": "_1nXeGW_exampleBadge",
 			"emptyDesc": "_1nXeGW_emptyDesc",
+			"statusDot": "_1nXeGW_statusDot",
+			"empty": "_1nXeGW_empty",
 			"row": "_1nXeGW_row",
-			"segBtn": "_1nXeGW_segBtn",
-			"rowUninstall": "_1nXeGW_rowUninstall",
-			"searchInput": "_1nXeGW_searchInput",
-			"versionBadge": "_1nXeGW_versionBadge",
-			"rowUpdate": "_1nXeGW_rowUpdate",
+			"statusInactive": "_1nXeGW_statusInactive",
+			"rowRepo": "_1nXeGW_rowRepo",
+			"rowMain": "_1nXeGW_rowMain",
 			"exampleRow": "_1nXeGW_exampleRow",
-			"searchWrap": "_1nXeGW_searchWrap",
-			"segLabel": "_1nXeGW_segLabel",
+			"searchInput": "_1nXeGW_searchInput",
 			"rowMeta": "_1nXeGW_rowMeta",
-			"toolbar": "_1nXeGW_toolbar",
+			"versionBadge": "_1nXeGW_versionBadge",
 			"updateBadge": "_1nXeGW_updateBadge",
-			"rowActions": "_1nXeGW_rowActions",
-			"segBtnActive": "_1nXeGW_segBtnActive",
-			"statusPending": "_1nXeGW_statusPending",
-			"segRow": "_1nXeGW_segRow",
-			"rowSourceTagHub": "_1nXeGW_rowSourceTagHub",
+			"root": "_1nXeGW_root",
+			"segGroup": "_1nXeGW_segGroup",
+			"list": "_1nXeGW_list",
+			"rowSourceTagManual": "_1nXeGW_rowSourceTagManual",
 			"rowTitleLine": "_1nXeGW_rowTitleLine",
-			"empty": "_1nXeGW_empty",
 			"rowDesc": "_1nXeGW_rowDesc",
-			"statusInactive": "_1nXeGW_statusInactive",
-			"rowSourceTagManual": "_1nXeGW_rowSourceTagManual",
+			"rowSourceTagHub": "_1nXeGW_rowSourceTagHub",
+			"rowUpdate": "_1nXeGW_rowUpdate",
 			"rowCategory": "_1nXeGW_rowCategory",
-			"statusDot": "_1nXeGW_statusDot",
-			"rowSourceTag": "_1nXeGW_rowSourceTag"
+			"segRow": "_1nXeGW_segRow",
+			"rowActions": "_1nXeGW_rowActions",
+			"segBtnActive": "_1nXeGW_segBtnActive",
+			"rowTitle": "_1nXeGW_rowTitle",
+			"rowRestart": "_1nXeGW_rowRestart"
 		};
 		//#endregion
 		//#region src/client/components/views/InstalledView.tsx
@@ -4575,27 +4618,27 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 		});
 		var CustomInstallView_module_css_default = {
 			"desc": "zISxCG_desc",
-			"installLabel": "zISxCG_installLabel",
-			"installInsertBtn": "zISxCG_installInsertBtn",
-			"installExample": "zISxCG_installExample",
-			"installBtn": "zISxCG_installBtn",
-			"channelOff": "zISxCG_channelOff",
+			"root": "zISxCG_root",
+			"installInputError": "zISxCG_installInputError",
 			"helpBody": "zISxCG_helpBody",
-			"installCards": "zISxCG_installCards",
-			"installInput": "zISxCG_installInput",
-			"channelOffBtn": "zISxCG_channelOffBtn",
-			"helpNote": "zISxCG_helpNote",
 			"helpCmd": "zISxCG_helpCmd",
-			"installCard": "zISxCG_installCard",
+			"helpNote": "zISxCG_helpNote",
+			"installCardDisabled": "zISxCG_installCardDisabled",
+			"channelOff": "zISxCG_channelOff",
+			"channelOffBtn": "zISxCG_channelOffBtn",
+			"installExample": "zISxCG_installExample",
+			"installError": "zISxCG_installError",
 			"helpLine": "zISxCG_helpLine",
+			"channelOffText": "zISxCG_channelOffText",
+			"installCard": "zISxCG_installCard",
+			"installBtn": "zISxCG_installBtn",
+			"installInput": "zISxCG_installInput",
+			"installCards": "zISxCG_installCards",
 			"installRow": "zISxCG_installRow",
-			"installHelpBtn": "zISxCG_installHelpBtn",
-			"installCardDisabled": "zISxCG_installCardDisabled",
-			"root": "zISxCG_root",
 			"installCardHead": "zISxCG_installCardHead",
-			"installInputError": "zISxCG_installInputError",
-			"installError": "zISxCG_installError",
-			"channelOffText": "zISxCG_channelOffText"
+			"installHelpBtn": "zISxCG_installHelpBtn",
+			"installLabel": "zISxCG_installLabel",
+			"installInsertBtn": "zISxCG_installInsertBtn"
 		};
 		//#endregion
 		//#region src/client/components/views/CustomInstallView.tsx
@@ -4723,8 +4766,11 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 					setNpmError(t("npmInstallInvalid"));
 					return;
 				}
-				if (parsed.kind === "global") onInstallCustom(raw, { globalNpm: parsed.pkgs });
-				else onInstallCustom(parsed.target);
+				if (parsed.kind === "global") onInstallCustom(raw, {
+					installChannel: "npm",
+					globalNpm: parsed.pkgs
+				});
+				else onInstallCustom(parsed.target, { installChannel: "npm" });
 				setNpmQuery("");
 				setNpmError("");
 			};
@@ -4735,7 +4781,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 					setGitError(t("gitInstallInvalid"));
 					return;
 				}
-				onInstallCustom(target);
+				onInstallCustom(target, { installChannel: "git" });
 				setGitQuery("");
 				setGitError("");
 			};
@@ -4747,7 +4793,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 					setCmdError(t("dshCmdInvalid"));
 					return;
 				}
-				onInstallCustom(parsed.target);
+				onInstallCustom(parsed.target, { installChannel: "dsh" });
 				setCmdQuery("");
 				setCmdError("");
 			};
@@ -4882,30 +4928,30 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$5
 		});
 		var SettingsView_module_css_default = {
-			"proxyControl": "_506LLG_proxyControl",
-			"settingRowStack": "_506LLG_settingRowStack",
-			"settingDesc": "_506LLG_settingDesc",
 			"pageDesc": "_506LLG_pageDesc",
-			"proxyHintFail": "_506LLG_proxyHintFail",
-			"controlDropdown": "_506LLG_controlDropdown",
-			"pageHeader": "_506LLG_pageHeader",
-			"root": "_506LLG_root",
-			"navItem": "_506LLG_navItem",
-			"content": "_506LLG_content",
-			"settingControl": "_506LLG_settingControl",
+			"settingDesc": "_506LLG_settingDesc",
 			"textInput": "_506LLG_textInput",
-			"navIcon": "_506LLG_navIcon",
+			"proxyControl": "_506LLG_proxyControl",
 			"proxyHint": "_506LLG_proxyHint",
-			"proxyHintOk": "_506LLG_proxyHintOk",
-			"navItemActive": "_506LLG_navItemActive",
-			"card": "_506LLG_card",
+			"settingControlStack": "_506LLG_settingControlStack",
 			"resetBtn": "_506LLG_resetBtn",
-			"settingTitle": "_506LLG_settingTitle",
 			"settingLabel": "_506LLG_settingLabel",
-			"pageTitle": "_506LLG_pageTitle",
+			"navIcon": "_506LLG_navIcon",
+			"pageHeader": "_506LLG_pageHeader",
+			"settingTitle": "_506LLG_settingTitle",
+			"proxyHintFail": "_506LLG_proxyHintFail",
+			"root": "_506LLG_root",
+			"card": "_506LLG_card",
 			"sidebar": "_506LLG_sidebar",
+			"navItemActive": "_506LLG_navItemActive",
+			"content": "_506LLG_content",
+			"settingControl": "_506LLG_settingControl",
+			"proxyHintOk": "_506LLG_proxyHintOk",
+			"navItem": "_506LLG_navItem",
 			"settingRow": "_506LLG_settingRow",
-			"settingControlStack": "_506LLG_settingControlStack"
+			"controlDropdown": "_506LLG_controlDropdown",
+			"settingRowStack": "_506LLG_settingRowStack",
+			"pageTitle": "_506LLG_pageTitle"
 		};
 		//#endregion
 		//#region \0dsh-css:src/client/styles/Dropdown.module.css.mjs
@@ -4924,18 +4970,18 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$4
 		});
 		var Dropdown_module_css_default = {
-			"dropdownCount": "B_Gxsq_dropdownCount",
-			"dropdownBtn": "B_Gxsq_dropdownBtn",
-			"dropdownCountActive": "B_Gxsq_dropdownCountActive",
-			"dropdownItemActive": "B_Gxsq_dropdownItemActive",
 			"dropdownLabel": "B_Gxsq_dropdownLabel",
+			"dropdownArrow": "B_Gxsq_dropdownArrow",
 			"dropdownArrowOpen": "B_Gxsq_dropdownArrowOpen",
-			"dropdownFill": "B_Gxsq_dropdownFill",
-			"dropdownItemLabel": "B_Gxsq_dropdownItemLabel",
-			"dropdown": "B_Gxsq_dropdown",
 			"dropdownPanel": "B_Gxsq_dropdownPanel",
-			"dropdownArrow": "B_Gxsq_dropdownArrow",
-			"dropdownItem": "B_Gxsq_dropdownItem"
+			"dropdownItem": "B_Gxsq_dropdownItem",
+			"dropdownCount": "B_Gxsq_dropdownCount",
+			"dropdown": "B_Gxsq_dropdown",
+			"dropdownItemLabel": "B_Gxsq_dropdownItemLabel",
+			"dropdownFill": "B_Gxsq_dropdownFill",
+			"dropdownCountActive": "B_Gxsq_dropdownCountActive",
+			"dropdownItemActive": "B_Gxsq_dropdownItemActive",
+			"dropdownBtn": "B_Gxsq_dropdownBtn"
 		};
 		//#endregion
 		//#region \0dsh-css:src/client/styles/Toggle.module.css.mjs
@@ -4954,9 +5000,9 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$3
 		});
 		var Toggle_module_css_default = {
-			"toggle": "k-cD4G_toggle",
 			"toggleOn": "k-cD4G_toggleOn",
-			"knob": "k-cD4G_knob"
+			"knob": "k-cD4G_knob",
+			"toggle": "k-cD4G_toggle"
 		};
 		//#endregion
 		//#region src/client/components/ui/Toggle.tsx
@@ -5057,28 +5103,28 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 		});
 		var DiagnosticsView_module_css_default = {
 			"envLabel": "k9eRya_envLabel",
-			"runBtn": "k9eRya_runBtn",
-			"panel": "k9eRya_panel",
-			"row": "k9eRya_row",
+			"meta": "k9eRya_meta",
+			"badgeIdle": "k9eRya_badgeIdle",
 			"summaryFail": "k9eRya_summaryFail",
 			"head": "k9eRya_head",
 			"display": "k9eRya_display",
-			"diagPulse": "k9eRya_diagPulse",
-			"badgeRunning": "k9eRya_badgeRunning",
-			"badgeIdle": "k9eRya_badgeIdle",
+			"runBtn": "k9eRya_runBtn",
+			"summaryRunning": "k9eRya_summaryRunning",
+			"badgeFail": "k9eRya_badgeFail",
+			"envDesc": "k9eRya_envDesc",
 			"envCopyBtn": "k9eRya_envCopyBtn",
+			"badge": "k9eRya_badge",
 			"badgeOk": "k9eRya_badgeOk",
-			"badgeFail": "k9eRya_badgeFail",
-			"envTitle": "k9eRya_envTitle",
-			"name": "k9eRya_name",
-			"meta": "k9eRya_meta",
 			"summaryOk": "k9eRya_summaryOk",
-			"envDesc": "k9eRya_envDesc",
+			"badgeRunning": "k9eRya_badgeRunning",
+			"row": "k9eRya_row",
 			"summary": "k9eRya_summary",
-			"summaryRunning": "k9eRya_summaryRunning",
+			"diagPulse": "k9eRya_diagPulse",
+			"panel": "k9eRya_panel",
+			"envTitle": "k9eRya_envTitle",
 			"headHint": "k9eRya_headHint",
-			"envRow": "k9eRya_envRow",
-			"badge": "k9eRya_badge"
+			"name": "k9eRya_name",
+			"envRow": "k9eRya_envRow"
 		};
 		//#endregion
 		//#region src/client/components/views/DiagnosticsView.tsx
@@ -5253,57 +5299,57 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$1
 		});
 		var LogsView_module_css_default = {
-			"filterBar": "_3j77BW_filterBar",
-			"list": "_3j77BW_list",
-			"pathDialogRow": "_3j77BW_pathDialogRow",
-			"pathLabel": "_3j77BW_pathLabel",
-			"pathText": "_3j77BW_pathText",
-			"badge": "_3j77BW_badge",
+			"head": "_3j77BW_head",
+			"searchInput": "_3j77BW_searchInput",
 			"badgeSuccess": "_3j77BW_badgeSuccess",
-			"badgeError": "_3j77BW_badgeError",
-			"catSystem": "_3j77BW_catSystem",
+			"badgeInfo": "_3j77BW_badgeInfo",
+			"catBadge": "_3j77BW_catBadge",
+			"catInstall": "_3j77BW_catInstall",
 			"empty": "_3j77BW_empty",
-			"pathDialogReset": "_3j77BW_pathDialogReset",
-			"previewRow": "_3j77BW_previewRow",
-			"filterChip": "_3j77BW_filterChip",
-			"actions": "_3j77BW_actions",
-			"time": "_3j77BW_time",
-			"headHint": "_3j77BW_headHint",
-			"panel": "_3j77BW_panel",
-			"headActions": "_3j77BW_headActions",
+			"search": "_3j77BW_search",
+			"clearBtn": "_3j77BW_clearBtn",
+			"pathDialogDesc": "_3j77BW_pathDialogDesc",
+			"filterBar": "_3j77BW_filterBar",
 			"linkBtn": "_3j77BW_linkBtn",
+			"moreEnd": "_3j77BW_moreEnd",
+			"catUninstall": "_3j77BW_catUninstall",
+			"btn": "_3j77BW_btn",
+			"panel": "_3j77BW_panel",
 			"pathDialogFoot": "_3j77BW_pathDialogFoot",
-			"foot": "_3j77BW_foot",
-			"catInstall": "_3j77BW_catInstall",
-			"catDiagnostics": "_3j77BW_catDiagnostics",
-			"pathDraft": "_3j77BW_pathDraft",
-			"clearBtn": "_3j77BW_clearBtn",
-			"footActions": "_3j77BW_footActions",
-			"head": "_3j77BW_head",
-			"footFail": "_3j77BW_footFail",
-			"entry": "_3j77BW_entry",
 			"logList": "_3j77BW_logList",
 			"more": "_3j77BW_more",
+			"footPath": "_3j77BW_footPath",
+			"list": "_3j77BW_list",
+			"footActions": "_3j77BW_footActions",
+			"filterChipActive": "_3j77BW_filterChipActive",
+			"previewRow": "_3j77BW_previewRow",
+			"badgeWarn": "_3j77BW_badgeWarn",
+			"pathDialog": "_3j77BW_pathDialog",
+			"pathDraft": "_3j77BW_pathDraft",
+			"pathDialogHint": "_3j77BW_pathDialogHint",
+			"badge": "_3j77BW_badge",
+			"headHint": "_3j77BW_headHint",
+			"pathText": "_3j77BW_pathText",
 			"badgeDebug": "_3j77BW_badgeDebug",
-			"footCount": "_3j77BW_footCount",
 			"catSettings": "_3j77BW_catSettings",
-			"btn": "_3j77BW_btn",
+			"actions": "_3j77BW_actions",
+			"headActions": "_3j77BW_headActions",
+			"badgeError": "_3j77BW_badgeError",
 			"event": "_3j77BW_event",
-			"search": "_3j77BW_search",
-			"pathRow": "_3j77BW_pathRow",
-			"badgeWarn": "_3j77BW_badgeWarn",
-			"message": "_3j77BW_message",
-			"filterChipActive": "_3j77BW_filterChipActive",
-			"pathDialogDesc": "_3j77BW_pathDialogDesc",
-			"moreEnd": "_3j77BW_moreEnd",
-			"footPath": "_3j77BW_footPath",
-			"pathDialog": "_3j77BW_pathDialog",
-			"badgeInfo": "_3j77BW_badgeInfo",
+			"foot": "_3j77BW_foot",
+			"catSystem": "_3j77BW_catSystem",
+			"pathLabel": "_3j77BW_pathLabel",
+			"pathDialogRow": "_3j77BW_pathDialogRow",
+			"pathDialogReset": "_3j77BW_pathDialogReset",
+			"footCount": "_3j77BW_footCount",
 			"catUpdate": "_3j77BW_catUpdate",
-			"searchInput": "_3j77BW_searchInput",
-			"catBadge": "_3j77BW_catBadge",
-			"catUninstall": "_3j77BW_catUninstall",
-			"pathDialogHint": "_3j77BW_pathDialogHint"
+			"catDiagnostics": "_3j77BW_catDiagnostics",
+			"entry": "_3j77BW_entry",
+			"filterChip": "_3j77BW_filterChip",
+			"time": "_3j77BW_time",
+			"message": "_3j77BW_message",
+			"pathRow": "_3j77BW_pathRow",
+			"footFail": "_3j77BW_footFail"
 		};
 		//#endregion
 		//#region src/client/components/modals/LogsModal.tsx
@@ -6154,6 +6200,9 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			/** 命令行安装确认弹窗：记录待安装的裸目标（npm 包名 / GitHub 地址，DSH 命令已剥成裸目标）——
 			*  与应用商店同一套确认/进度/结果弹窗，提供时 plugin 传 null 走 customTarget 模式 */
 			const [confirmCustomTarget, setConfirmCustomTarget] = (0, react.useState)(null);
+			/** 自定义安装入口渠道（三张卡片之一）：随确认弹窗记录，提交时上报服务端，
+			*  报错/日志据此精准溯源「从哪个入口发起」（npm 全局安装固定为 'npm'） */
+			const [confirmCustomChannel, setConfirmCustomChannel] = (0, react.useState)(null);
 			/** 全局 npm 安装确认弹窗（官方 `npm install -g <pkgs>`）：记录原始命令 + 解析出的包列表，
 			*  走与应用商店同一套确认/进度/结果弹窗（plugin 传 null，InstallModal 走 globalNpm 模式） */
 			const [confirmGlobalNpm, setConfirmGlobalNpm] = (0, react.useState)(null);
@@ -6306,6 +6355,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 					if (e.key === "Escape") {
 						setConfirmPlugin(null);
 						setConfirmCustomTarget(null);
+						setConfirmCustomChannel(null);
 						setConfirmGlobalNpm(null);
 						setUninstallPlugin(null);
 						setUninstallItem(null);
@@ -6515,6 +6565,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 					queue.clearModalTask();
 					if (opts?.globalNpm && opts.globalNpm.length > 0) {
 						setConfirmCustomTarget(null);
+						setConfirmCustomChannel(null);
 						setConfirmIsUpdate(false);
 						setConfirmGlobalNpm({
 							raw,
@@ -6523,6 +6574,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 						return;
 					}
 					setConfirmGlobalNpm(null);
+					setConfirmCustomChannel(opts.installChannel);
 					setConfirmIsUpdate(customTargetInstalled(target));
 					setConfirmCustomTarget(target);
 				}
@@ -6542,7 +6594,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 				openSection: settingsSection,
 				onConsumedOpenSection: () => setSettingsSection(null)
 			}), showHubUpdate && (0, react.createElement)(HubUpdateModal, {
-				info: catalog.hubUpdateInfo ?? { version: "1.3.8" },
+				info: catalog.hubUpdateInfo ?? { version: "1.3.9" },
 				lang,
 				t,
 				hasUpdate: catalog.hubHasUpdate,
@@ -6651,6 +6703,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 				onClose: () => {
 					setInstallDone(false);
 					setConfirmCustomTarget(null);
+					setConfirmCustomChannel(null);
 				},
 				onCopy: () => {
 					doCopy(`pnpm add ${confirmCustomTarget}`);
@@ -6659,7 +6712,10 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 						kind: "copied"
 					});
 				},
-				onInstall: () => void queue.installCustom(confirmCustomTarget, confirmIsUpdate ? { update: true } : void 0),
+				onInstall: () => void queue.installCustom(confirmCustomTarget, {
+					update: confirmIsUpdate,
+					channel: confirmCustomChannel ?? "npm"
+				}),
 				onRestart: () => setShowRestartConfirm(true)
 			}), confirmGlobalNpm && (0, react.createElement)(InstallModal, {
 				plugin: null,
@@ -6676,6 +6732,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 				onClose: () => {
 					setInstallDone(false);
 					setConfirmGlobalNpm(null);
+					setConfirmCustomChannel(null);
 				},
 				onCopy: () => {
 					doCopy(`npm install -g ${confirmGlobalNpm.pkgs.join(" ")}`);
@@ -6684,7 +6741,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 						kind: "copied"
 					});
 				},
-				onInstall: () => void queue.installGlobalNpm(confirmGlobalNpm.pkgs),
+				onInstall: () => void queue.installGlobalNpm(confirmGlobalNpm.pkgs, { channel: "npm" }),
 				onRestart: () => setShowRestartConfirm(true)
 			}), (uninstallPlugin || uninstallItem) && (0, react.createElement)(UninstallModal, {
 				plugin: uninstallPlugin ?? pluginOfItem(uninstallItem),