dsh-plugin 1.3.8 → 1.3.10

package/client/client.js

@@ -290,6 +290,13 @@ 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 后重试。这不是插件本身的问题。",
+			failPnpmStoreHint: "安装器调用 pnpm 时报「store 位置不匹配」（ERR_PNPM_UNEXPECTED_STORE）：你的 profile 目录里旧插件依赖是用另一个大版本的 pnpm 生成的，当前 pnpm 出于安全不认旧目录，导致任何插件装进该 profile 都会失败。请删除该 profile 目录下的 node_modules 与 pnpm-lock.yaml（可先到「系统日志」或 ~/.dsh/profiles/<profile>/hub.log 查看完整报错），再重新安装。这不是插件本身的问题。",
+			installChannelNpm: "NPM 包",
+			installChannelGit: "GitHub 源码",
+			installChannelDsh: "DSH 命令",
+			installEntryLine: "安装入口：{c}。",
 			reportIssue: "去插件仓库提交 Issue",
 			detail: "打开详情",
 			noResult: "没有找到匹配的插件",
@@ -606,6 +613,13 @@ 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.",
+			failPnpmStoreHint: "pnpm reported an unexpected store location (ERR_PNPM_UNEXPECTED_STORE): the profile directory was previously set up with a different major version of pnpm, and the current pnpm refuses to reuse it — no plugin can be installed into that profile. Delete node_modules and pnpm-lock.yaml under the profile directory (see System Logs or ~/.dsh/profiles/<profile>/hub.log for the full output), then reinstall. 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 +672,42 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$11
 		});
 		var Header_module_css_default = {
-			"headerRight": "qikqja_headerRight",
+			"headerTitleRow": "qikqja_headerTitleRow",
+			"tabs": "qikqja_tabs",
+			"adText": "qikqja_adText",
 			"resultCount": "qikqja_resultCount",
+			"logoIcon": "qikqja_logoIcon",
+			"tabCount": "qikqja_tabCount",
+			"tabActive": "qikqja_tabActive",
 			"adBanner": "qikqja_adBanner",
 			"segLabel": "qikqja_segLabel",
-			"adBadge": "qikqja_adBadge",
-			"search": "qikqja_search",
-			"root": "qikqja_root",
-			"headerTitleRow": "qikqja_headerTitleRow",
-			"resultSeg": "qikqja_resultSeg",
-			"tabCount": "qikqja_tabCount",
+			"segGroup": "qikqja_segGroup",
 			"githubIcon": "qikqja_githubIcon",
-			"title": "qikqja_title",
-			"segBtn": "qikqja_segBtn",
-			"tabs": "qikqja_tabs",
-			"versionBtn": "qikqja_versionBtn",
+			"tagline": "qikqja_tagline",
 			"aboutBtn": "qikqja_aboutBtn",
-			"logoIcon": "qikqja_logoIcon",
-			"controls": "qikqja_controls",
-			"taglineLink": "qikqja_taglineLink",
-			"hubUpdateBadge": "qikqja_hubUpdateBadge",
-			"copyIcon": "qikqja_copyIcon",
-			"segBtnActive": "qikqja_segBtnActive",
+			"root": "qikqja_root",
+			"versionBtn": "qikqja_versionBtn",
 			"searchRow": "qikqja_searchRow",
-			"adText": "qikqja_adText",
-			"tabActive": "qikqja_tabActive",
-			"githubLink": "qikqja_githubLink",
+			"segBtnActive": "qikqja_segBtnActive",
+			"version": "qikqja_version",
+			"tab": "qikqja_tab",
+			"langBtn": "qikqja_langBtn",
+			"adArrow": "qikqja_adArrow",
+			"headerRight": "qikqja_headerRight",
 			"tabsRow": "qikqja_tabsRow",
-			"sortGroup": "qikqja_sortGroup",
+			"search": "qikqja_search",
+			"title": "qikqja_title",
 			"header": "qikqja_header",
-			"langBtn": "qikqja_langBtn",
+			"hubUpdateBadge": "qikqja_hubUpdateBadge",
+			"controls": "qikqja_controls",
 			"brandTitle": "qikqja_brandTitle",
-			"tagline": "qikqja_tagline",
-			"tab": "qikqja_tab",
-			"segGroup": "qikqja_segGroup",
-			"version": "qikqja_version",
-			"adArrow": "qikqja_adArrow"
+			"resultSeg": "qikqja_resultSeg",
+			"segBtn": "qikqja_segBtn",
+			"adBadge": "qikqja_adBadge",
+			"sortGroup": "qikqja_sortGroup",
+			"taglineLink": "qikqja_taglineLink",
+			"copyIcon": "qikqja_copyIcon",
+			"githubLink": "qikqja_githubLink"
 		};
 		//#endregion
 		//#region \0dsh-css:src/client/styles/Modal.module.css.mjs
@@ -712,136 +726,136 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$10
 		});
 		var Modal_module_css_default = {
-			"modalClose": "BiQ1zG_modalClose",
-			"queuedHint": "BiQ1zG_queuedHint",
+			"helpModal": "BiQ1zG_helpModal",
+			"aboutModal": "BiQ1zG_aboutModal",
+			"noticeRowUpdate": "BiQ1zG_noticeRowUpdate",
+			"detailLink": "BiQ1zG_detailLink",
+			"failNetworkTarget": "BiQ1zG_failNetworkTarget",
+			"pendingRowStatus": "BiQ1zG_pendingRowStatus",
+			"detailUpdateHint": "BiQ1zG_detailUpdateHint",
+			"noticeBadgeFail": "BiQ1zG_noticeBadgeFail",
+			"queueRow": "BiQ1zG_queueRow",
+			"noticeRowMain": "BiQ1zG_noticeRowMain",
+			"noticeRemove": "BiQ1zG_noticeRemove",
 			"resultCheckIcon": "BiQ1zG_resultCheckIcon",
-			"modalActions": "BiQ1zG_modalActions",
+			"progressTrack": "BiQ1zG_progressTrack",
+			"detailStatusRunning": "BiQ1zG_detailStatusRunning",
+			"linkIcon": "BiQ1zG_linkIcon",
+			"noticeIgnore": "BiQ1zG_noticeIgnore",
 			"logModal": "BiQ1zG_logModal",
-			"modalCopy": "BiQ1zG_modalCopy",
-			"restartLater": "BiQ1zG_restartLater",
-			"queueSectionTitle": "BiQ1zG_queueSectionTitle",
-			"noticeMain": "BiQ1zG_noticeMain",
-			"failRepo": "BiQ1zG_failRepo",
+			"modalCmdText": "BiQ1zG_modalCmdText",
+			"aboutContent": "BiQ1zG_aboutContent",
+			"noticeFoot": "BiQ1zG_noticeFoot",
+			"queuedHint": "BiQ1zG_queuedHint",
+			"modalInstall": "BiQ1zG_modalInstall",
+			"resultDesc": "BiQ1zG_resultDesc",
+			"queueRowTrack": "BiQ1zG_queueRowTrack",
+			"noticeUpdateGo": "BiQ1zG_noticeUpdateGo",
+			"result": "BiQ1zG_result",
+			"modalCmdCopy": "BiQ1zG_modalCmdCopy",
+			"modalWide": "BiQ1zG_modalWide",
+			"resultCheck": "BiQ1zG_resultCheck",
 			"noticeList": "BiQ1zG_noticeList",
-			"noticeIgnore": "BiQ1zG_noticeIgnore",
-			"modalTitleBusy": "BiQ1zG_modalTitleBusy",
+			"failEmpty": "BiQ1zG_failEmpty",
 			"detailLabel": "BiQ1zG_detailLabel",
-			"detailPathActions": "BiQ1zG_detailPathActions",
-			"modalDesc": "BiQ1zG_modalDesc",
-			"modalCloseIcon": "BiQ1zG_modalCloseIcon",
-			"noticeRowUpdate": "BiQ1zG_noticeRowUpdate",
+			"noticeRow": "BiQ1zG_noticeRow",
 			"modalLabel": "BiQ1zG_modalLabel",
-			"modalLink": "BiQ1zG_modalLink",
-			"failDiagBtn": "BiQ1zG_failDiagBtn",
-			"restartNowWarning": "BiQ1zG_restartNowWarning",
-			"trustHint": "BiQ1zG_trustHint",
-			"linkIcon": "BiQ1zG_linkIcon",
+			"detailValue": "BiQ1zG_detailValue",
+			"failedCopyHint": "BiQ1zG_failedCopyHint",
+			"failKindUninstall": "BiQ1zG_failKindUninstall",
+			"toastFail": "BiQ1zG_toastFail",
+			"detailPath": "BiQ1zG_detailPath",
+			"noticeMain": "BiQ1zG_noticeMain",
+			"confirmIconWrap": "BiQ1zG_confirmIconWrap",
 			"detailStatusPending": "BiQ1zG_detailStatusPending",
-			"detailStatusRunning": "BiQ1zG_detailStatusRunning",
-			"failCopy": "BiQ1zG_failCopy",
+			"restartLater": "BiQ1zG_restartLater",
+			"failBigIssue": "BiQ1zG_failBigIssue",
+			"modalDesc": "BiQ1zG_modalDesc",
+			"hubUpdateMeta": "BiQ1zG_hubUpdateMeta",
+			"dangerConfirm": "BiQ1zG_dangerConfirm",
+			"progressFill": "BiQ1zG_progressFill",
+			"detailMono": "BiQ1zG_detailMono",
+			"detailStars": "BiQ1zG_detailStars",
+			"queueRowStatus": "BiQ1zG_queueRowStatus",
+			"progress": "BiQ1zG_progress",
+			"noticeBadgeOk": "BiQ1zG_noticeBadgeOk",
+			"queueRowHead": "BiQ1zG_queueRowHead",
+			"errorHint": "BiQ1zG_errorHint",
+			"failDiagBtn": "BiQ1zG_failDiagBtn",
+			"overlayIn": "BiQ1zG_overlayIn",
 			"progressHead": "BiQ1zG_progressHead",
+			"failHead": "BiQ1zG_failHead",
 			"detailPathBtn": "BiQ1zG_detailPathBtn",
-			"progress": "BiQ1zG_progress",
-			"hubUpdateMetaItem": "BiQ1zG_hubUpdateMetaItem",
-			"resultDesc": "BiQ1zG_resultDesc",
 			"confirmPrimary": "BiQ1zG_confirmPrimary",
-			"noticeTime": "BiQ1zG_noticeTime",
-			"queueRowBody": "BiQ1zG_queueRowBody",
-			"failNetworkTarget": "BiQ1zG_failNetworkTarget",
-			"noticeVersion": "BiQ1zG_noticeVersion",
+			"modalCopy": "BiQ1zG_modalCopy",
 			"modal": "BiQ1zG_modal",
-			"failKindInstall": "BiQ1zG_failKindInstall",
-			"noticeBadgeFail": "BiQ1zG_noticeBadgeFail",
-			"detailStatusText": "BiQ1zG_detailStatusText",
-			"modalCancel": "BiQ1zG_modalCancel",
-			"result": "BiQ1zG_result",
-			"errorTitle": "BiQ1zG_errorTitle",
-			"modalCmdText": "BiQ1zG_modalCmdText",
-			"progressFill": "BiQ1zG_progressFill",
-			"toastIn": "BiQ1zG_toastIn",
-			"confirmIconDanger": "BiQ1zG_confirmIconDanger",
-			"noticeRow": "BiQ1zG_noticeRow",
-			"noticeRowOk": "BiQ1zG_noticeRowOk",
-			"modalIn": "BiQ1zG_modalIn",
+			"modalActions": "BiQ1zG_modalActions",
+			"resultTitle": "BiQ1zG_resultTitle",
+			"errorBox": "BiQ1zG_errorBox",
 			"cliOnlyHint": "BiQ1zG_cliOnlyHint",
-			"queueRowStatus": "BiQ1zG_queueRowStatus",
-			"failEmpty": "BiQ1zG_failEmpty",
-			"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",
+			"detailModal": "BiQ1zG_detailModal",
+			"modalTitleQueued": "BiQ1zG_modalTitleQueued",
+			"modalHead": "BiQ1zG_modalHead",
+			"failCopy": "BiQ1zG_failCopy",
+			"modalIn": "BiQ1zG_modalIn",
+			"noticeBadgeIcon": "BiQ1zG_noticeBadgeIcon",
+			"modalLink": "BiQ1zG_modalLink",
+			"noticeVersion": "BiQ1zG_noticeVersion",
+			"failList": "BiQ1zG_failList",
+			"failRepo": "BiQ1zG_failRepo",
+			"trustHint": "BiQ1zG_trustHint",
+			"detailPathActions": "BiQ1zG_detailPathActions",
+			"queueRowBody": "BiQ1zG_queueRowBody",
+			"modalTitleBusy": "BiQ1zG_modalTitleBusy",
+			"restartNow": "BiQ1zG_restartNow",
+			"errorTitle": "BiQ1zG_errorTitle",
 			"aboutMeta": "BiQ1zG_aboutMeta",
-			"detailRow": "BiQ1zG_detailRow",
-			"resultRestarting": "BiQ1zG_resultRestarting",
-			"noticeUpdateGo": "BiQ1zG_noticeUpdateGo",
-			"failClear": "BiQ1zG_failClear",
-			"errorHint": "BiQ1zG_errorHint",
-			"modalValue": "BiQ1zG_modalValue",
-			"toast": "BiQ1zG_toast",
+			"noticeTime": "BiQ1zG_noticeTime",
+			"noticeTextOk": "BiQ1zG_noticeTextOk",
+			"progressFillFail": "BiQ1zG_progressFillFail",
 			"queueRowDesc": "BiQ1zG_queueRowDesc",
-			"progressText": "BiQ1zG_progressText",
-			"modalRow": "BiQ1zG_modalRow",
+			"failRow": "BiQ1zG_failRow",
+			"pendingRowActions": "BiQ1zG_pendingRowActions",
 			"errorModal": "BiQ1zG_errorModal",
-			"modalBody": "BiQ1zG_modalBody",
+			"detailArrow": "BiQ1zG_detailArrow",
+			"modalCancel": "BiQ1zG_modalCancel",
+			"restartNowWarning": "BiQ1zG_restartNowWarning",
+			"modalCloseIcon": "BiQ1zG_modalCloseIcon",
+			"toastIn": "BiQ1zG_toastIn",
+			"hubUpdateNotes": "BiQ1zG_hubUpdateNotes",
+			"detailGrid": "BiQ1zG_detailGrid",
+			"failClear": "BiQ1zG_failClear",
+			"overlay": "BiQ1zG_overlay",
+			"modalValue": "BiQ1zG_modalValue",
+			"noticeRowOk": "BiQ1zG_noticeRowOk",
 			"queueRowTarget": "BiQ1zG_queueRowTarget",
-			"errorBox": "BiQ1zG_errorBox",
 			"queueSection": "BiQ1zG_queueSection",
-			"detailStars": "BiQ1zG_detailStars",
-			"detailPathText": "BiQ1zG_detailPathText",
-			"pendingRowStatus": "BiQ1zG_pendingRowStatus",
+			"failKind": "BiQ1zG_failKind",
+			"modalClose": "BiQ1zG_modalClose",
+			"modalBody": "BiQ1zG_modalBody",
+			"queueRowPct": "BiQ1zG_queueRowPct",
+			"toast": "BiQ1zG_toast",
+			"hubUpdateModal": "BiQ1zG_hubUpdateModal",
 			"failPrepareHint": "BiQ1zG_failPrepareHint",
+			"errorCopySoft": "BiQ1zG_errorCopySoft",
 			"noticeHead": "BiQ1zG_noticeHead",
-			"failList": "BiQ1zG_failList",
-			"resultTitle": "BiQ1zG_resultTitle",
-			"noticeBadgeOk": "BiQ1zG_noticeBadgeOk",
-			"progressTrack": "BiQ1zG_progressTrack",
-			"failKind": "BiQ1zG_failKind",
-			"detailPath": "BiQ1zG_detailPath",
-			"failedCopyHint": "BiQ1zG_failedCopyHint",
+			"detailRow": "BiQ1zG_detailRow",
 			"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",
-			"detailValue": "BiQ1zG_detailValue",
-			"detailModal": "BiQ1zG_detailModal",
 			"modalCmd": "BiQ1zG_modalCmd",
-			"noticeFoot": "BiQ1zG_noticeFoot",
-			"modalTitleQueued": "BiQ1zG_modalTitleQueued",
-			"noticeTextOk": "BiQ1zG_noticeTextOk",
-			"progressFillFail": "BiQ1zG_progressFillFail",
-			"noticeRowMain": "BiQ1zG_noticeRowMain",
-			"overlayIn": "BiQ1zG_overlayIn",
-			"restartNow": "BiQ1zG_restartNow",
-			"failRow": "BiQ1zG_failRow",
+			"uninstallConfirm": "BiQ1zG_uninstallConfirm",
+			"detailPathText": "BiQ1zG_detailPathText",
+			"stripCancel": "BiQ1zG_stripCancel",
+			"failKindInstall": "BiQ1zG_failKindInstall",
+			"resultRestarting": "BiQ1zG_resultRestarting",
 			"modalTitle": "BiQ1zG_modalTitle",
-			"modalHead": "BiQ1zG_modalHead",
-			"pendingRowActions": "BiQ1zG_pendingRowActions",
-			"modalWide": "BiQ1zG_modalWide",
-			"detailGrid": "BiQ1zG_detailGrid",
-			"aboutModal": "BiQ1zG_aboutModal",
-			"detailUpdateHint": "BiQ1zG_detailUpdateHint",
-			"hubUpdateModal": "BiQ1zG_hubUpdateModal",
-			"failKindUninstall": "BiQ1zG_failKindUninstall",
-			"queueRowHead": "BiQ1zG_queueRowHead"
+			"noticeTextFail": "BiQ1zG_noticeTextFail",
+			"hubUpdateMetaItem": "BiQ1zG_hubUpdateMetaItem",
+			"progressText": "BiQ1zG_progressText",
+			"queueSectionTitle": "BiQ1zG_queueSectionTitle",
+			"detailStatusText": "BiQ1zG_detailStatusText",
+			"modalRow": "BiQ1zG_modalRow",
+			"confirmIconDanger": "BiQ1zG_confirmIconDanger"
 		};
 		//#endregion
 		//#region src/client/logic/install-command.ts
@@ -911,7 +925,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.10";
 		const CATEGORY_ORDER = [
 			"interface",
 			"session",
@@ -1544,7 +1558,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.10";
 			})();
 			(0, react.useMemo)(() => {
 				if (!plugins) return [];
@@ -1723,12 +1737,23 @@ 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
+		* - pnpmStore：pnpm 存在但报 store 位置不匹配（`ERR_PNPM_UNEXPECTED_STORE` / `Unexpected store
+		*   location`）—— profile 目录的 node_modules 是用不同大版本的 pnpm 生成的，当前 pnpm 不认，
+		*   任何插件装进该 profile 都会失败；不是插件问题（dsh-plugin-hub#14：macOS 下
+		*   `ERR_PNPM_UNEXPECTED_STORE` 被误归插件侧失败）→ 提示清理 profile 依赖目录重建，不引导提 Issue
 		* - network：安装前连通性预检拦截（服务端 `[network]` 标记）或底层连接失败
 		*   （ERR_PNPM_GIT_FETCH_FAILED / ETIMEDOUT / DNS 解析 / TLS 握手 / 代理拒绝）——
 		*   是本机网络不通/被墙/代理有问题，不是插件问题 → 提示检查网络，不引导提 Issue
@@ -1742,6 +1767,9 @@ 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_UNEXPECTED_STORE|Unexpected store location/i.test(message)) return "pnpmStore";
 			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 +1862,9 @@ 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 "pnpmStore": return "pnpm store version mismatch 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";
@@ -1881,9 +1912,13 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 						`- DSH: ${env.dshVersion ? `v${env.dshVersion}` : "unknown"}`,
 						`- Plugin Hub: v${PLUGIN_VERSION}`,
 						`- Node: ${env.nodeVersion}`,
+						`- pnpm: ${env.pnpmVersion ? `v${env.pnpmVersion}` : "unknown"}`,
+						`- npm: ${env.npmVersion ? `v${env.npmVersion}` : "unknown"}`,
+						`- git: ${env.gitVersion ? `v${env.gitVersion}` : "unknown"}`,
 						`- OS: ${env.platform} ${env.arch} (${env.release})`,
 						`- Profile: \`${env.profile}\``,
-						`- DSH Home: \`${env.dshHome}\``
+						`- DSH Home: \`${env.dshHome}\``,
+						`- Full log: \`~/.dsh/profiles/${env.profile}/hub.log\` (paste or attach for the full output)`
 					] : [],
 					`- Catalog: [${pluginSiteUrl(repo)}](${pluginSiteUrl(repo)})`,
 					"",
@@ -2035,6 +2070,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 +2188,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 +2288,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 +2334,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 +2373,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 +2391,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 +2399,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 +2419,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 +2447,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 +2460,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 +2476,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 +3265,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 === "pnpmStore" ? (0, react.createElement)("div", { className: Modal_module_css_default.failPrepareHint }, t("failPnpmStoreHint")) : 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 +3816,9 @@ 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 === "pnpmStore") return (0, react.createElement)("div", { className: Modal_module_css_default.failPrepareHint }, t("failPnpmStoreHint"));
 					if (kind === "network") return (0, react.createElement)("div", null, [
 						(() => {
 							const target = unreachableTargetOf(r.message);
@@ -3968,40 +4024,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",
+			"date": "_3XaZHa_date",
 			"retryBtn": "_3XaZHa_retryBtn",
 			"uninstallBtn": "_3XaZHa_uninstallBtn",
-			"installBtnInstalled": "_3XaZHa_installBtnInstalled",
+			"installBtn": "_3XaZHa_installBtn",
 			"state": "_3XaZHa_state",
-			"diagBtn": "_3XaZHa_diagBtn",
+			"stateTitle": "_3XaZHa_stateTitle",
 			"cardMain": "_3XaZHa_cardMain",
-			"cardSide": "_3XaZHa_cardSide",
+			"stats": "_3XaZHa_stats",
 			"topics": "_3XaZHa_topics",
-			"detailBtn": "_3XaZHa_detailBtn",
-			"cardHead": "_3XaZHa_cardHead",
-			"stateActions": "_3XaZHa_stateActions",
-			"footer": "_3XaZHa_footer",
-			"installBtnUpdate": "_3XaZHa_installBtnUpdate",
-			"actions": "_3XaZHa_actions",
-			"list": "_3XaZHa_list",
-			"stateTitle": "_3XaZHa_stateTitle",
+			"body": "_3XaZHa_body",
 			"updateBadge": "_3XaZHa_updateBadge",
-			"topic": "_3XaZHa_topic",
-			"star": "_3XaZHa_star",
-			"stateDesc": "_3XaZHa_stateDesc",
-			"verified": "_3XaZHa_verified",
-			"stats": "_3XaZHa_stats",
-			"date": "_3XaZHa_date",
 			"card": "_3XaZHa_card",
-			"cardTitle": "_3XaZHa_cardTitle",
-			"categoryBadge": "_3XaZHa_categoryBadge",
+			"installBtnCopied": "_3XaZHa_installBtnCopied",
+			"diagBtn": "_3XaZHa_diagBtn",
+			"desc": "_3XaZHa_desc",
+			"verified": "_3XaZHa_verified",
+			"list": "_3XaZHa_list",
 			"footLink": "_3XaZHa_footLink",
-			"body": "_3XaZHa_body",
+			"star": "_3XaZHa_star",
+			"topic": "_3XaZHa_topic",
+			"cardSide": "_3XaZHa_cardSide",
+			"installBtnInstalled": "_3XaZHa_installBtnInstalled",
 			"moreSentinel": "_3XaZHa_moreSentinel",
+			"cardHead": "_3XaZHa_cardHead",
+			"footer": "_3XaZHa_footer",
+			"stateDesc": "_3XaZHa_stateDesc",
 			"versionBadge": "_3XaZHa_versionBadge",
-			"installBtnCopied": "_3XaZHa_installBtnCopied"
+			"installBtnUpdate": "_3XaZHa_installBtnUpdate",
+			"stateActions": "_3XaZHa_stateActions",
+			"detailBtn": "_3XaZHa_detailBtn",
+			"actions": "_3XaZHa_actions",
+			"categoryBadge": "_3XaZHa_categoryBadge",
+			"fork": "_3XaZHa_fork",
+			"cardTitle": "_3XaZHa_cardTitle"
 		};
 		//#endregion
 		//#region src/client/hooks/useIncrementalList.ts
@@ -4209,14 +4265,14 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 		});
 		var SectionTabs_module_css_default = {
 			"tabCountActive": "_7tvizq_tabCountActive",
-			"tabActive": "_7tvizq_tabActive",
-			"noticeIcon": "_7tvizq_noticeIcon",
-			"tabIcon": "_7tvizq_tabIcon",
 			"noticeBtn": "_7tvizq_noticeBtn",
-			"noticeCount": "_7tvizq_noticeCount",
+			"tab": "_7tvizq_tab",
+			"tabIcon": "_7tvizq_tabIcon",
 			"root": "_7tvizq_root",
+			"tabActive": "_7tvizq_tabActive",
 			"tabCount": "_7tvizq_tabCount",
-			"tab": "_7tvizq_tab"
+			"noticeIcon": "_7tvizq_noticeIcon",
+			"noticeCount": "_7tvizq_noticeCount"
 		};
 		//#endregion
 		//#region src/client/components/layout/SectionTabs.tsx
@@ -4293,42 +4349,42 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$7
 		});
 		var InstalledView_module_css_default = {
-			"list": "_1nXeGW_list",
-			"rowDetail": "_1nXeGW_rowDetail",
-			"rowMain": "_1nXeGW_rowMain",
-			"exampleBadge": "_1nXeGW_exampleBadge",
+			"toolbar": "_1nXeGW_toolbar",
+			"segBtnActive": "_1nXeGW_segBtnActive",
 			"emptyTitle": "_1nXeGW_emptyTitle",
-			"segGroup": "_1nXeGW_segGroup",
-			"rowTitle": "_1nXeGW_rowTitle",
+			"rowDesc": "_1nXeGW_rowDesc",
+			"statusInactive": "_1nXeGW_statusInactive",
+			"exampleRow": "_1nXeGW_exampleRow",
+			"rowCategory": "_1nXeGW_rowCategory",
+			"rowActions": "_1nXeGW_rowActions",
+			"rowUpdate": "_1nXeGW_rowUpdate",
+			"versionBadge": "_1nXeGW_versionBadge",
+			"updateBadge": "_1nXeGW_updateBadge",
 			"root": "_1nXeGW_root",
-			"rowRepo": "_1nXeGW_rowRepo",
-			"rowRestart": "_1nXeGW_rowRestart",
-			"emptyDesc": "_1nXeGW_emptyDesc",
 			"row": "_1nXeGW_row",
-			"segBtn": "_1nXeGW_segBtn",
-			"rowUninstall": "_1nXeGW_rowUninstall",
-			"searchInput": "_1nXeGW_searchInput",
-			"versionBadge": "_1nXeGW_versionBadge",
-			"rowUpdate": "_1nXeGW_rowUpdate",
-			"exampleRow": "_1nXeGW_exampleRow",
-			"searchWrap": "_1nXeGW_searchWrap",
-			"segLabel": "_1nXeGW_segLabel",
+			"rowSourceTagHub": "_1nXeGW_rowSourceTagHub",
 			"rowMeta": "_1nXeGW_rowMeta",
-			"toolbar": "_1nXeGW_toolbar",
-			"updateBadge": "_1nXeGW_updateBadge",
-			"rowActions": "_1nXeGW_rowActions",
-			"segBtnActive": "_1nXeGW_segBtnActive",
 			"statusPending": "_1nXeGW_statusPending",
-			"segRow": "_1nXeGW_segRow",
-			"rowSourceTagHub": "_1nXeGW_rowSourceTagHub",
-			"rowTitleLine": "_1nXeGW_rowTitleLine",
-			"empty": "_1nXeGW_empty",
-			"rowDesc": "_1nXeGW_rowDesc",
-			"statusInactive": "_1nXeGW_statusInactive",
 			"rowSourceTagManual": "_1nXeGW_rowSourceTagManual",
-			"rowCategory": "_1nXeGW_rowCategory",
+			"rowDetail": "_1nXeGW_rowDetail",
+			"emptyDesc": "_1nXeGW_emptyDesc",
+			"rowUninstall": "_1nXeGW_rowUninstall",
+			"rowTitleLine": "_1nXeGW_rowTitleLine",
+			"rowSourceTag": "_1nXeGW_rowSourceTag",
 			"statusDot": "_1nXeGW_statusDot",
-			"rowSourceTag": "_1nXeGW_rowSourceTag"
+			"segRow": "_1nXeGW_segRow",
+			"segGroup": "_1nXeGW_segGroup",
+			"rowTitle": "_1nXeGW_rowTitle",
+			"rowRestart": "_1nXeGW_rowRestart",
+			"rowRepo": "_1nXeGW_rowRepo",
+			"segLabel": "_1nXeGW_segLabel",
+			"empty": "_1nXeGW_empty",
+			"segBtn": "_1nXeGW_segBtn",
+			"exampleBadge": "_1nXeGW_exampleBadge",
+			"searchWrap": "_1nXeGW_searchWrap",
+			"list": "_1nXeGW_list",
+			"rowMain": "_1nXeGW_rowMain",
+			"searchInput": "_1nXeGW_searchInput"
 		};
 		//#endregion
 		//#region src/client/components/views/InstalledView.tsx
@@ -4574,28 +4630,28 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$6
 		});
 		var CustomInstallView_module_css_default = {
-			"desc": "zISxCG_desc",
-			"installLabel": "zISxCG_installLabel",
+			"installBtn": "zISxCG_installBtn",
+			"helpLine": "zISxCG_helpLine",
+			"channelOffText": "zISxCG_channelOffText",
+			"installInputError": "zISxCG_installInputError",
 			"installInsertBtn": "zISxCG_installInsertBtn",
 			"installExample": "zISxCG_installExample",
-			"installBtn": "zISxCG_installBtn",
-			"channelOff": "zISxCG_channelOff",
-			"helpBody": "zISxCG_helpBody",
+			"installCardDisabled": "zISxCG_installCardDisabled",
 			"installCards": "zISxCG_installCards",
-			"installInput": "zISxCG_installInput",
-			"channelOffBtn": "zISxCG_channelOffBtn",
-			"helpNote": "zISxCG_helpNote",
-			"helpCmd": "zISxCG_helpCmd",
+			"installCardHead": "zISxCG_installCardHead",
+			"channelOff": "zISxCG_channelOff",
+			"desc": "zISxCG_desc",
 			"installCard": "zISxCG_installCard",
-			"helpLine": "zISxCG_helpLine",
-			"installRow": "zISxCG_installRow",
+			"helpCmd": "zISxCG_helpCmd",
+			"channelOffBtn": "zISxCG_channelOffBtn",
 			"installHelpBtn": "zISxCG_installHelpBtn",
-			"installCardDisabled": "zISxCG_installCardDisabled",
-			"root": "zISxCG_root",
-			"installCardHead": "zISxCG_installCardHead",
-			"installInputError": "zISxCG_installInputError",
+			"installRow": "zISxCG_installRow",
+			"installLabel": "zISxCG_installLabel",
+			"installInput": "zISxCG_installInput",
 			"installError": "zISxCG_installError",
-			"channelOffText": "zISxCG_channelOffText"
+			"root": "zISxCG_root",
+			"helpBody": "zISxCG_helpBody",
+			"helpNote": "zISxCG_helpNote"
 		};
 		//#endregion
 		//#region src/client/components/views/CustomInstallView.tsx
@@ -4723,8 +4779,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 +4794,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 					setGitError(t("gitInstallInvalid"));
 					return;
 				}
-				onInstallCustom(target);
+				onInstallCustom(target, { installChannel: "git" });
 				setGitQuery("");
 				setGitError("");
 			};
@@ -4747,7 +4806,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 +4941,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",
-			"textInput": "_506LLG_textInput",
-			"navIcon": "_506LLG_navIcon",
 			"proxyHint": "_506LLG_proxyHint",
 			"proxyHintOk": "_506LLG_proxyHintOk",
-			"navItemActive": "_506LLG_navItemActive",
-			"card": "_506LLG_card",
 			"resetBtn": "_506LLG_resetBtn",
+			"proxyControl": "_506LLG_proxyControl",
 			"settingTitle": "_506LLG_settingTitle",
 			"settingLabel": "_506LLG_settingLabel",
+			"navIcon": "_506LLG_navIcon",
+			"card": "_506LLG_card",
+			"navItemActive": "_506LLG_navItemActive",
 			"pageTitle": "_506LLG_pageTitle",
+			"navItem": "_506LLG_navItem",
+			"settingControlStack": "_506LLG_settingControlStack",
+			"pageDesc": "_506LLG_pageDesc",
+			"textInput": "_506LLG_textInput",
+			"controlDropdown": "_506LLG_controlDropdown",
+			"proxyHintFail": "_506LLG_proxyHintFail",
+			"pageHeader": "_506LLG_pageHeader",
 			"sidebar": "_506LLG_sidebar",
 			"settingRow": "_506LLG_settingRow",
-			"settingControlStack": "_506LLG_settingControlStack"
+			"content": "_506LLG_content",
+			"settingRowStack": "_506LLG_settingRowStack",
+			"settingDesc": "_506LLG_settingDesc",
+			"root": "_506LLG_root",
+			"settingControl": "_506LLG_settingControl"
 		};
 		//#endregion
 		//#region \0dsh-css:src/client/styles/Dropdown.module.css.mjs
@@ -4924,18 +4983,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",
+			"dropdownItem": "B_Gxsq_dropdownItem",
+			"dropdownItemLabel": "B_Gxsq_dropdownItemLabel",
+			"dropdownPanel": "B_Gxsq_dropdownPanel",
 			"dropdownCountActive": "B_Gxsq_dropdownCountActive",
-			"dropdownItemActive": "B_Gxsq_dropdownItemActive",
-			"dropdownLabel": "B_Gxsq_dropdownLabel",
-			"dropdownArrowOpen": "B_Gxsq_dropdownArrowOpen",
 			"dropdownFill": "B_Gxsq_dropdownFill",
-			"dropdownItemLabel": "B_Gxsq_dropdownItemLabel",
+			"dropdownItemActive": "B_Gxsq_dropdownItemActive",
 			"dropdown": "B_Gxsq_dropdown",
-			"dropdownPanel": "B_Gxsq_dropdownPanel",
 			"dropdownArrow": "B_Gxsq_dropdownArrow",
-			"dropdownItem": "B_Gxsq_dropdownItem"
+			"dropdownBtn": "B_Gxsq_dropdownBtn",
+			"dropdownCount": "B_Gxsq_dropdownCount",
+			"dropdownLabel": "B_Gxsq_dropdownLabel",
+			"dropdownArrowOpen": "B_Gxsq_dropdownArrowOpen"
 		};
 		//#endregion
 		//#region \0dsh-css:src/client/styles/Toggle.module.css.mjs
@@ -5056,29 +5115,29 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 			css: css$2
 		});
 		var DiagnosticsView_module_css_default = {
-			"envLabel": "k9eRya_envLabel",
-			"runBtn": "k9eRya_runBtn",
-			"panel": "k9eRya_panel",
-			"row": "k9eRya_row",
-			"summaryFail": "k9eRya_summaryFail",
-			"head": "k9eRya_head",
-			"display": "k9eRya_display",
-			"diagPulse": "k9eRya_diagPulse",
-			"badgeRunning": "k9eRya_badgeRunning",
-			"badgeIdle": "k9eRya_badgeIdle",
-			"envCopyBtn": "k9eRya_envCopyBtn",
 			"badgeOk": "k9eRya_badgeOk",
-			"badgeFail": "k9eRya_badgeFail",
-			"envTitle": "k9eRya_envTitle",
-			"name": "k9eRya_name",
+			"envRow": "k9eRya_envRow",
 			"meta": "k9eRya_meta",
-			"summaryOk": "k9eRya_summaryOk",
-			"envDesc": "k9eRya_envDesc",
+			"badgeRunning": "k9eRya_badgeRunning",
+			"badgeFail": "k9eRya_badgeFail",
 			"summary": "k9eRya_summary",
-			"summaryRunning": "k9eRya_summaryRunning",
+			"head": "k9eRya_head",
 			"headHint": "k9eRya_headHint",
-			"envRow": "k9eRya_envRow",
-			"badge": "k9eRya_badge"
+			"name": "k9eRya_name",
+			"summaryRunning": "k9eRya_summaryRunning",
+			"envCopyBtn": "k9eRya_envCopyBtn",
+			"row": "k9eRya_row",
+			"summaryFail": "k9eRya_summaryFail",
+			"envDesc": "k9eRya_envDesc",
+			"runBtn": "k9eRya_runBtn",
+			"diagPulse": "k9eRya_diagPulse",
+			"envTitle": "k9eRya_envTitle",
+			"display": "k9eRya_display",
+			"envLabel": "k9eRya_envLabel",
+			"badge": "k9eRya_badge",
+			"badgeIdle": "k9eRya_badgeIdle",
+			"panel": "k9eRya_panel",
+			"summaryOk": "k9eRya_summaryOk"
 		};
 		//#endregion
 		//#region src/client/components/views/DiagnosticsView.tsx
@@ -5253,57 +5312,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",
+			"footActions": "_3j77BW_footActions",
 			"pathLabel": "_3j77BW_pathLabel",
-			"pathText": "_3j77BW_pathText",
-			"badge": "_3j77BW_badge",
-			"badgeSuccess": "_3j77BW_badgeSuccess",
 			"badgeError": "_3j77BW_badgeError",
-			"catSystem": "_3j77BW_catSystem",
-			"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",
-			"linkBtn": "_3j77BW_linkBtn",
-			"pathDialogFoot": "_3j77BW_pathDialogFoot",
-			"foot": "_3j77BW_foot",
-			"catInstall": "_3j77BW_catInstall",
-			"catDiagnostics": "_3j77BW_catDiagnostics",
-			"pathDraft": "_3j77BW_pathDraft",
+			"btn": "_3j77BW_btn",
 			"clearBtn": "_3j77BW_clearBtn",
-			"footActions": "_3j77BW_footActions",
+			"foot": "_3j77BW_foot",
+			"pathDialog": "_3j77BW_pathDialog",
 			"head": "_3j77BW_head",
-			"footFail": "_3j77BW_footFail",
-			"entry": "_3j77BW_entry",
 			"logList": "_3j77BW_logList",
-			"more": "_3j77BW_more",
-			"badgeDebug": "_3j77BW_badgeDebug",
-			"footCount": "_3j77BW_footCount",
-			"catSettings": "_3j77BW_catSettings",
-			"btn": "_3j77BW_btn",
 			"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",
+			"badge": "_3j77BW_badge",
+			"actions": "_3j77BW_actions",
 			"badgeInfo": "_3j77BW_badgeInfo",
+			"catUninstall": "_3j77BW_catUninstall",
+			"catSettings": "_3j77BW_catSettings",
+			"pathDialogDesc": "_3j77BW_pathDialogDesc",
+			"search": "_3j77BW_search",
+			"headHint": "_3j77BW_headHint",
+			"footCount": "_3j77BW_footCount",
+			"catInstall": "_3j77BW_catInstall",
+			"catSystem": "_3j77BW_catSystem",
+			"filterChip": "_3j77BW_filterChip",
+			"empty": "_3j77BW_empty",
+			"more": "_3j77BW_more",
+			"pathDialogRow": "_3j77BW_pathDialogRow",
+			"time": "_3j77BW_time",
+			"filterChipActive": "_3j77BW_filterChipActive",
+			"pathDialogFoot": "_3j77BW_pathDialogFoot",
+			"filterBar": "_3j77BW_filterBar",
+			"badgeSuccess": "_3j77BW_badgeSuccess",
+			"previewRow": "_3j77BW_previewRow",
+			"list": "_3j77BW_list",
+			"badgeWarn": "_3j77BW_badgeWarn",
+			"panel": "_3j77BW_panel",
+			"footFail": "_3j77BW_footFail",
 			"catUpdate": "_3j77BW_catUpdate",
-			"searchInput": "_3j77BW_searchInput",
+			"pathDialogHint": "_3j77BW_pathDialogHint",
+			"badgeDebug": "_3j77BW_badgeDebug",
 			"catBadge": "_3j77BW_catBadge",
-			"catUninstall": "_3j77BW_catUninstall",
-			"pathDialogHint": "_3j77BW_pathDialogHint"
+			"catDiagnostics": "_3j77BW_catDiagnostics",
+			"footPath": "_3j77BW_footPath",
+			"searchInput": "_3j77BW_searchInput",
+			"headActions": "_3j77BW_headActions",
+			"entry": "_3j77BW_entry",
+			"message": "_3j77BW_message",
+			"pathText": "_3j77BW_pathText",
+			"linkBtn": "_3j77BW_linkBtn",
+			"pathDraft": "_3j77BW_pathDraft",
+			"pathRow": "_3j77BW_pathRow",
+			"pathDialogReset": "_3j77BW_pathDialogReset"
 		};
 		//#endregion
 		//#region src/client/components/modals/LogsModal.tsx
@@ -6154,6 +6213,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 +6368,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 +6578,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 +6587,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 						return;
 					}
 					setConfirmGlobalNpm(null);
+					setConfirmCustomChannel(opts.installChannel);
 					setConfirmIsUpdate(customTargetInstalled(target));
 					setConfirmCustomTarget(target);
 				}
@@ -6542,7 +6607,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.10" },
 				lang,
 				t,
 				hasUpdate: catalog.hubHasUpdate,
@@ -6651,6 +6716,7 @@ window.__ModuleLoader__.load({ id: "dsh-plugin", factory: (require) => {
 				onClose: () => {
 					setInstallDone(false);
 					setConfirmCustomTarget(null);
+					setConfirmCustomChannel(null);
 				},
 				onCopy: () => {
 					doCopy(`pnpm add ${confirmCustomTarget}`);
@@ -6659,7 +6725,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 +6745,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 +6754,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),