@noob-stupid/dsh-plugin-console 0.5.45 → 0.5.47

package/lib/client.js

@@ -458,6 +458,25 @@ window.__ModuleLoader__.load({
 			repoLandBusy: "克隆中…（大仓库可能较慢）",
 			repoLandDone: "已落地到：",
 			repoLandOpenFolder: "打开文件夹",
+			repoOpenDone: "已请求打开：",
+			repoOpenFailed: "打开文件夹失败：",
+			subpluginFound: "该仓库根目录没有清单，但插件在子目录 {dir}/ 下（{pkg}，标记：{markers}）—— 它不是「不是插件」，只是清单不在仓库根",
+			subpluginCopyDir: "复制子目录路径",
+			subpluginCopyName: "复制包名",
+			// 子目录插件的一键安装（0.5.47 加法）：识别出来之后**必须能装**，不能只给一段文字。
+			subpluginInstall: "从这个子目录安装",
+			subpluginInstallHint: "先按稀疏取源码把该子目录取到本地，再按既有本地目录来源（link:）装进 profile；清单校验与来源校验与其它安装路径同一套，装完照样收口（清单 + lock + 挂载行）",
+			// 「报失败前先核实已装」（0.5.47 改错）：已装 ⇒ 这句话是主行，历史失败折叠成次要信息。
+			alreadyInstalled: "已安装 v{version}（无需重装）",
+			alreadyInstalledNoVersion: "已安装（无需重装；版本号读不到）",
+			installedBadge: "已安装",
+			alreadyInstalledWhere: "命中：{where}",
+			whereDependencies: "依赖清单 dependencies",
+			whereBundles: "dsh.profile.bundles",
+			whereNodeModules: "node_modules",
+			failureSecondary: "历史失败（次要信息，仅供排查；已装上的插件无需重装）",
+			failureSecondaryShow: "显示历史失败",
+			failureSecondaryHide: "收起历史失败",
 			repoLandExists: "该仓库已存在，无需重复落地",
 			repoLandDirLabel: "保存路径",
 			repoLandSaveDir: "保存路径",
@@ -1018,6 +1037,25 @@ window.__ModuleLoader__.load({
 			repoLandBusy: "Cloning… (large repos may take a while)",
 			repoLandDone: "Landed at: ",
 			repoLandOpenFolder: "Open folder",
+			repoOpenDone: "Requested to open: ",
+			repoOpenFailed: "Failed to open folder: ",
+			subpluginFound: "This repository has no manifest at its root, but the plugin lives in the subdirectory {dir}/ ({pkg}, markers: {markers}) — it is not \"not a plugin\", the manifest is just not at the repository root",
+			subpluginCopyDir: "Copy subdirectory path",
+			subpluginCopyName: "Copy package name",
+			// One-click install from a subdirectory (0.5.47): recognition must come with a way to install.
+			subpluginInstall: "Install from this subdirectory",
+			subpluginInstallHint: "Fetches the subdirectory source (sparse) into a local folder, then installs it through the existing local-directory source (link:). Manifest and source validation are the same as for any other install path, and finalization (manifest + lock + mount row) still applies",
+			// "Verify it is actually installed before reporting failure" (0.5.47): this line is primary when it is.
+			alreadyInstalled: "Already installed v{version} (no reinstall needed)",
+			alreadyInstalledNoVersion: "Already installed (no reinstall needed; version unreadable)",
+			installedBadge: "Installed",
+			alreadyInstalledWhere: "Found in: {where}",
+			whereDependencies: "manifest dependencies",
+			whereBundles: "dsh.profile.bundles",
+			whereNodeModules: "node_modules",
+			failureSecondary: "Earlier failure (secondary, for diagnosis only; an installed plugin needs no reinstall)",
+			failureSecondaryShow: "Show earlier failure",
+			failureSecondaryHide: "Hide earlier failure",
 			repoLandExists: "Already exists — nothing to clone",
 			repoLandDirLabel: "Save path",
 			repoLandSaveDir: "Save path",
@@ -2229,7 +2267,10 @@ window.__ModuleLoader__.load({
 				if (!window.confirm(t("repoLandRemoveConfirm").replace("{repo}", item.repo))) return;
 				try {
 					await call("/plugin-console/repo-remove", { path: item.path });
-				} catch {}
+				} catch (error) {
+					// 2026-10-13 改错：删不掉时旧代码 `catch {}` 静默吞掉，用户看到的是"点了没反应、仓库还在"。
+					setMessage(t("safetySwitchFailed") + "：" + (error && typeof error.message === "string" && error.message !== "" ? error.message : t("safetySwitchFailed")));
+				}
 				repoLandRefresh();
 			}
 			async function repoLandStart() {
@@ -2245,9 +2286,22 @@ window.__ModuleLoader__.load({
 				}
 				setRepoLandBusy(false);
 			}
-			async function repoLandOpenFolder() {
-				if (repoLandResult === null || repoLandResult.ok !== true) return;
-				try { await call("/plugin-console/repo-open", { path: repoLandResult.path }); } catch {}
+			/** 打开仓库落地目录（2026-10-13 改错：**成功与失败都必须有结果**）。
+			* 旧实现 `try { await call(...) } catch {}` —— 非 2xx（路径被守卫拒绝 / 目录不存在 /
+			* 文件管理器起不来）全被吞掉，用户只看到"点了没反应"（真机实测报告）。
+			* 现在：服务端回结构化状态 → 成功显示"已在文件管理器中打开：<path>"（服务端的 note 也带上），
+			* 失败把**原因原样**显示（守卫拒绝的原因、目录不存在、spawn 失败的系统原话）。
+			* 供「刚落地」按钮与「已落地列表」每行的按钮共用（两处行为必须一致，别再各写一遍）。 */
+			async function repoLandOpenFolder(target) {
+				const path = typeof target === "string" && target !== "" ? target : (repoLandResult && repoLandResult.path);
+				if (!path) return;
+				try {
+					const data = await call("/plugin-console/repo-open", { path });
+					const note = data && typeof data.note === "string" && data.note !== "" ? "（" + data.note + "）" : "";
+					setMessage(t("repoOpenDone") + (data && data.path ? data.path : path) + note);
+				} catch (error) {
+					setMessage(t("repoOpenFailed") + (error && typeof error.message === "string" && error.message !== "" ? error.message : t("safetySwitchFailed")));
+				}
 			}
 			const sectionRef = react.useRef(null);
 			const [compCardTop, setCompCardTop] = react.useState(null);
@@ -2407,6 +2461,8 @@ window.__ModuleLoader__.load({
 			}, [state.status]);
 			// 已关闭的失败提示（用户点 × 后不再显示，服务重启后重置）
 			const [dismissedFailures, setDismissedFailures] = react.useState({});
+			// 「已装上的那次失败」里，历史失败正文是否展开（0.5.47 加法：默认收起 —— 次要信息不许喧宾夺主）
+			const [failureDetailOpen, setFailureDetailOpen] = react.useState({});
 			// 软件源管理
 			const [sourcesOpen, setSourcesOpen] = react.useState(false);
 			const [sourcesData, setSourcesData] = react.useState(null);
@@ -3647,7 +3703,9 @@ window.__ModuleLoader__.load({
 					() => { setSearchSourceName(""); setSearchSourceUrl(""); setSearchSourceHeaders(""); },
 				);
 			};
-			const startJob = (repo, packageName, source = "github", kind = "plugin", update = false) => {
+			// subdir 用于「从这个子目录安装」（0.5.47 加法）：服务端按它去读 <subdir>/package.json、
+			// 稀疏取该子目录源码、再按既有本地目录来源（link:）装。为空时请求体形状与改动前逐字相同。
+			const startJob = (repo, packageName, source = "github", kind = "plugin", update = false, subdir = null) => {
 				// 防并发（与 addLocal 一致）：已有安装/更新进行中时忽略新点击（更新按钮此前可绕过，
 				// 反复点击会产生几十个并发任务装同一插件）
 				if (installing !== null) {
@@ -3658,7 +3716,9 @@ window.__ModuleLoader__.load({
 				setReloadHint(false);
 				setRestartHint(false);
 				setMessage(null);
-				call("/plugin-console/install", { repo: repo ?? "", packageName, source, kind, update }).then(
+				const body = { repo: repo ?? "", packageName, source, kind, update };
+				if (subdir !== null && subdir !== undefined && String(subdir) !== "") body.subdir = String(subdir);
+				call("/plugin-console/install", body).then(
 					(data) => {
 						if (data && data.jobId) {
 							setJobs((prev) => ({
@@ -4804,7 +4864,7 @@ window.__ModuleLoader__.load({
 								? (repoLandResult.ok === true
 									? el("div", { className: styles.rowTop },
 										el("p", { className: styles.message, style: { flex: 1, minWidth: 0, wordBreak: "break-all" } }, t("repoLandDone") + repoLandResult.path),
-										el("button", { type: "button", className: styles.toggle, onClick: repoLandOpenFolder }, t("repoLandOpenFolder")))
+										el("button", { type: "button", className: styles.toggle, onClick: () => repoLandOpenFolder(repoLandResult.path) }, t("repoLandOpenFolder")))
 									: el("p", { className: styles.message, "data-error": "true" }, t("safetySwitchFailed") + "：" + (repoLandResult.error ?? "?")))
 								: null,
 							el("strong", { className: styles.name }, t("repoLandList") + "（" + repoLanded.length + "）"),
@@ -4814,7 +4874,7 @@ window.__ModuleLoader__.load({
 									repoLanded.map((item) =>
 										el("div", { key: item.repo, className: styles.rowTop },
 											el("strong", { className: styles.name, style: { flex: "1 1 auto" } }, item.repo),
-											el("button", { type: "button", className: styles.toggle, onClick: () => { call("/plugin-console/repo-open", { path: item.path }).catch(() => {}); } }, t("repoLandOpenFolder")),
+											el("button", { type: "button", className: styles.toggle, onClick: () => repoLandOpenFolder(item.path) }, t("repoLandOpenFolder")),
 											el("button", { type: "button", className: styles.trashBtn, title: t("repoLandRemoveConfirm"), "aria-label": t("repoLandRemoveConfirm"), onClick: () => repoLandRemove(item) }, "✕"))))
 							)))
 					: null,
@@ -5392,10 +5452,33 @@ window.__ModuleLoader__.load({
 										? el("span", { className: styles.tag, "data-user": "true" }, t("suiteComponentOk"))
 										: el("span", { className: styles.tag, "data-error": "true" }, t("suiteComponentFail"))),
 								r.note ? el("p", { className: styles.desc }, r.note) : null))))),
-				(state.status === "ready" ? state.data.recentFailures ?? [] : []).filter((job) => !dismissedFailures[job.jobId]).map((job) =>
-					el("div", { key: "fail-" + job.jobId, className: styles.detail },
+				(state.status === "ready" ? state.data.recentFailures ?? [] : []).filter((job) => !dismissedFailures[job.jobId]).map((job) => {
+					// ★ 0.5.47 改错（用户被误导过）：服务端在下发**之前**已经查过三处（依赖清单 /
+					// dsh.profile.bundles / node_modules）。已经装上时，「已安装 vX（无需重装）」是**主行**，
+					// 历史失败降级成次要信息（默认收起）—— 绝不让用户以为没装上、再点一次重试。
+					const evidence = job.installedEvidence !== null && job.installedEvidence !== undefined && job.installedEvidence.installed === true
+						? job.installedEvidence
+						: null;
+					const whereText = evidence === null
+						? ""
+						: (Array.isArray(evidence.where) ? evidence.where : []).map((w) => w === "dependencies" ? t("whereDependencies") : w === "bundles" ? t("whereBundles") : w === "node_modules" ? t("whereNodeModules") : String(w)).join(" / ");
+					const installedLine = evidence === null
+						? null
+						: (evidence.version === null || evidence.version === undefined
+							? t("alreadyInstalledNoVersion")
+							: t("alreadyInstalled").replace("{version}", String(evidence.version)))
+							+ (whereText === "" ? "" : " · " + t("alreadyInstalledWhere").replace("{where}", whereText));
+					const failureOpen = failureDetailOpen[job.jobId] === true;
+					// 子目录插件的一键安装（0.5.47 加法）：服务端给了结构化的可执行计划才渲染按钮
+					// （`install.action === "install-subdir"`）—— 只在文案里写"可以装"不算数。
+					const subInstall = job.subplugin !== null && job.subplugin !== undefined
+						&& job.subplugin.install !== null && job.subplugin.install !== undefined
+						&& job.subplugin.install.action === "install-subdir"
+						? job.subplugin.install
+						: null;
+					return el("div", { key: "fail-" + job.jobId, className: styles.detail },
 						el("div", { className: styles.rowTop },
-							el("span", { className: styles.phase, "data-phase": "failed" }, t("recentFailures")),
+							el("span", { className: styles.phase, "data-phase": evidence === null ? "failed" : "active" }, evidence === null ? t("recentFailures") : t("installedBadge")),
 							el("strong", { className: styles.name }, job.packageName ?? job.repo),
 							el("button", {
 								type: "button",
@@ -5404,14 +5487,61 @@ window.__ModuleLoader__.load({
 								"aria-label": t("dismissFailure"),
 								onClick: () => setDismissedFailures((prev) => ({ ...prev, [job.jobId]: true })),
 							}, "✕")),
-						el("p", { className: styles.message, "data-error": "true" }, job.error ?? ""),
+						installedLine === null
+							? el("p", { className: styles.message, "data-error": "true" }, job.error ?? "")
+							: el("p", { className: styles.message, "data-warn": "true" }, installedLine),
+						// 子目录插件（2026-10-13 加法，真机 Fei2411/DeepSeek-Bot）：服务端已判定"插件在
+						// <子目录>/ 下"，这里把结论**单独显示**（不用用户从一整段报错里找路径），
+						// 0.5.47 起再给**可点的一步**（不只是可复制的路径）。用 styles.message、不加新 class。
+						job.subplugin !== null && job.subplugin !== undefined
+							? el("p", { className: styles.message, "data-warn": "true" },
+								t("subpluginFound")
+									.replace("{dir}", String(job.subplugin.dir ?? "?"))
+									.replace("{pkg}", String(job.subplugin.packageName ?? "?"))
+									.replace("{markers}", Array.isArray(job.subplugin.markers) ? job.subplugin.markers.join(" / ") : "?"))
+							: null,
+						subInstall !== null
+							? el("div", { className: styles.rowTop },
+								el("button", {
+									type: "button",
+									className: styles.toggle,
+									title: t("subpluginInstallHint"),
+									onClick: () => startJob(job.repo, subInstall.packageName ?? job.packageName ?? null, job.source ?? "github", "plugin", false, subInstall.dir),
+								}, t("subpluginInstall") + " · " + String(subInstall.dir ?? "") + "/"))
+							: null,
+						job.subplugin !== null && job.subplugin !== undefined && typeof job.subplugin.dir === "string" && job.subplugin.dir !== ""
+							? el("div", { className: styles.rowTop },
+								el("button", { type: "button", className: styles.toggle, onClick: () => copyInstallCommand(String(job.subplugin.dir)) }, t("subpluginCopyDir")),
+								typeof job.subplugin.packageName === "string" && job.subplugin.packageName !== ""
+									? el("button", { type: "button", className: styles.toggle, onClick: () => copyInstallCommand(String(job.subplugin.packageName)) }, t("subpluginCopyName"))
+									: null)
+							: null,
 						...diagLines(job).map(diagLineEl),
 						el("div", { className: styles.rowTop },
 							el("button", { type: "button", className: styles.toggle, onClick: () => startJob(job.repo, job.packageName, job.source ?? "github") }, t("retry")),
-							job.hint === "repo-land"
+							// 历史失败（0.5.47）：已装上的插件这张卡里，失败正文与"重试"降级进可折叠的次要区
+							// —— 默认收起，用户不会被一句红色失败误导成"没装上"。
+							evidence !== null
+								? el("button", {
+									type: "button",
+									className: styles.toggle,
+									onClick: () => setFailureDetailOpen((prev) => ({ ...prev, [job.jobId]: failureOpen !== true })),
+								}, failureOpen ? t("failureSecondaryHide") : t("failureSecondaryShow"))
+								: null,
+							// 「仓库落地」一键克隆：hint=repo-land（旧结论）与 hint=subdir-plugin（插件在子目录里）
+							// 都要给 —— 后者的文案本身就写着"先按「仓库落地」克隆到本地查看该子目录"，
+							// 按钮若只在 repo-land 时渲染，那句话就指向一个不存在的入口。
+							job.hint === "repo-land" || job.hint === "subdir-plugin"
 								? el("button", { type: "button", className: styles.toggle, title: repoLandTitleText(), onClick: () => { setRepoLandOpen(true); repoLandEntry(job.repo); } }, t("repoLandEntry"))
-								: null)),
-				),
+								: null),
+						// 次要信息区（默认收起）：历史失败正文 + 服务端那句核实note + 诊断行，只在用户展开时显示
+						evidence !== null && failureOpen
+							? el("div", { className: styles.detail },
+								el("p", { className: styles.note }, t("failureSecondary")),
+								el("p", { className: styles.message, "data-error": "true" }, job.error ?? ""),
+								typeof evidence.note === "string" && evidence.note !== "" ? el("p", { className: styles.note }, evidence.note) : null)
+							: null)
+				}),
 				repoInfo !== null
 					? el("aside", { className: styles.floatPanel },
 						el("div", { className: styles.descTopbar },

package/lib/server/domain/bundle-refs.js

@@ -9,7 +9,10 @@
 // 注册前先按本模块读出的引用逐个 `resolvePackageJson` 核实，缺失即拒绝注册。
 
 import { existsSync, readFileSync } from 'node:fs'
-import { join } from 'node:path'
+import { readFile } from 'node:fs/promises'
+import { dirname, join } from 'node:path'
+import { DEFAULT_BUNDLES } from './install.js'
+import { resolvePackageJson } from '../infra/paths.js'
 
 /** 读取聚合包 `cordis.patch.yml` 的 insert 行 name 列表（注册前校验用）。
  *  解析形状与 install.js#ensureBundlePatchIntegrity 同构：`- insert:` 块下的
@@ -45,4 +48,41 @@ function readBundlePatchRefNames(profileDir, pkgName) {
   } catch { return [] }
 }
 
-export { readBundlePatchRefNames }
+/** 读取用户额外 bundle（非官方模板）的补丁插入行 id 与包名，用于"额外插件"判定。
+ * 2026-10-13 从 install-job.js 原样搬出（只搬移未改逻辑；那边贴着 600 行硬顶，
+ * 而这块与上面的 insert 行解析是同一件事），调用方经 install-job.js 的 re-export 取用，
+ * 对外导出名与行为一字未变（tests/test-architecture-guard 的接线断言要求导出名仍在）。 */
+async function readExtraBundleRows(profileDir) {
+  const rows = new Set()
+  try {
+    const manifest = JSON.parse(await readFile(join(profileDir, 'package.json'), 'utf8'))
+    const bundles = manifest.dsh?.profile?.bundles ?? []
+    for (const pkg of bundles) {
+      if (DEFAULT_BUNDLES.includes(pkg)) continue
+      try {
+        const pk = resolvePackageJson(pkg, profileDir)
+        const dir = dirname(pk ?? join(profileDir, 'node_modules', ...String(pkg).split('/'), 'package.json'))
+        const text = await readFile(join(dir, 'cordis.patch.yml'), 'utf8')
+        const lines = text.split(/\r?\n/u)
+        let inInsert = false
+        for (let index = 0; index < lines.length; index += 1) {
+          const line = lines[index]
+          if (/^- insert:\s*$/u.test(line)) {
+            inInsert = true
+            continue
+          }
+          if (/^- /u.test(line)) inInsert = false
+          if (!inInsert) continue
+          const idMatch = line.match(/^ {4}- id: ([A-Za-z0-9_.-]+)\s*$/u)
+          if (!idMatch) continue
+          rows.add(idMatch[1])
+          const nameMatch = (lines[index + 1] ?? '').match(/^ {6}name: ['"]([^'"]+)['"]\s*$/u)
+          if (nameMatch) rows.add(nameMatch[1])
+        }
+      } catch {}
+    }
+  } catch {}
+  return rows
+}
+
+export { readBundlePatchRefNames, readExtraBundleRows }

package/lib/server/domain/install-job.js

@@ -2,22 +2,24 @@
 // 分层 Step 8c-2 从 lib/index.js 搬出；形参由 ctx 收窄为 ports（调用方注入的窄接口），只搬移未改逻辑。
 // 分层分组：L1 · domain（边界由 tests/test-architecture-guard.mjs 断言）
 
-import { readFile } from 'node:fs/promises'
 import { dirname, join, resolve } from 'node:path'
 import { aiRepair } from './ai-run.js'
 import { maybeAutoAdaptCompat } from './compat.js'
 import { getReposDir } from './repoland.js'
 import { aiConsentFailureText, cleanupAttemptedCandidates, pnpmRemove } from './install-cleanup.js'
 import { GIT_CHANNEL_BUDGET_MS, GIT_MIN_ATTEMPT_MS, GIT_SPEC_TIMEOUT_MS, gitChannelBudgetMs, noteChannel, formatBudgetMs, tryGitChannel } from './git-channel.js'
-import { DEFAULT_BUNDLES, AI_CONSENT_TIMEOUT_MS, PNPM_INSTALL_TIMEOUT_MS, addBundleToManifest, backfillMissingDeps, curlManualInstall, detectBundleOnly, ensureBundlePatchIntegrity, githubReleaseInstall, pnpmInstall, raceInstallChannels, readGithubAuth, syncAggregateSubpackageVersions } from './install.js'
-import { readBundlePatchRefNames } from './bundle-refs.js' // 0.5.26 搬家：install.js 贴着 600 行硬顶
+import { AI_CONSENT_TIMEOUT_MS, PNPM_INSTALL_TIMEOUT_MS, addBundleToManifest, backfillMissingDeps, curlManualInstall, detectBundleOnly, ensureBundlePatchIntegrity, githubReleaseInstall, pnpmInstall, raceInstallChannels, readGithubAuth, syncAggregateSubpackageVersions } from './install.js'
+import { readBundlePatchRefNames, readExtraBundleRows } from './bundle-refs.js' // re-export（0.5.46 搬入；0.5.26 已搬 readBundlePatchRefNames）
 import { classifyInstallFailure, retryPnpmOnce } from './install-diagnose.js'
 import { jobLog } from './jobs.js'
 import { gatePrivateRoot } from './repo-size.js'
 import { tryPresetSourceChannel } from './preset-source.js'
 import { settlePresetOutcome } from './preset-in-package.js'
 import { alreadyInstalledTarget, verifyInstalledEntry } from './install-verify.js'
-import { applyNpmNameHint, expandSubpackageCandidates, fetchRepoPackage, fetchRepoPackageEx, fetchSubpackageNames, npmNameHintForRepo, packageProbeErrorText, subpackageCandidates } from './market.js'
+import { applyNpmNameHint, composeProbeFailureText, expandSubpackageCandidates, fetchRepoPackage, fetchRepoPackageEx, fetchSubdirPlugins, fetchSubpackageNames, npmNameHintForRepo, packageProbeErrorText, subpackageCandidates } from './market.js'
+import { decideNoRootManifest } from './subdir-detect.js'
+import { runSubdirInstallJob } from './subdir-install.js'
+import { bindMarketDeps, probeRootManifest } from './manifest-probe.js' // 0.5.47 接线：抓清单的额外通道 + 通道身份
 import { finalizeInstallPersistence } from './install-finalize.js'
 import { readPatchState, syncNameFromNote } from './patch.js'
 import { listEntries } from './runtime.js'
@@ -42,11 +44,9 @@ const RELEASE_CHANNEL_BUDGET = 3
  * 否则替身与 cordis 语义不一致，这类缺陷还会再溜过去一次。 */
 function channelImpls(ports) {
   const real = { pnpmInstall, curlManualInstall, raceInstallChannels, githubReleaseInstall, backfillMissingDeps }
-  //   生产路径上 ports 就是 cordis 的 ctx 代理，属性式读取未 inject 的名字会**同步抛**
-  //   `cannot get property "installChannels" without inject` —— 0.3.59 因此每一次安装都在这里失败。
-  //   正规写法是 ctx.get('installChannels')（Cordis 的可选读取，未声明也不抛，与本文件其它
-  //   ports.get('subagents') / ports.get('agents') 一致）；普通对象（测试替身/窄接口）才回退属性访问。
-  //   try/catch 保留 0.3.61 的兜底语义：万一还有别的 ctx 形状，宁可回落真实实现也不要炸掉安装。
+  //   生产路径上 ports 就是 cordis 的 ctx 代理，属性式读取未 inject 的名字会**同步抛**（0.3.59 每次安装
+  //   都在这里失败）⇒ 正规写法是 ctx.get('installChannels')（可选读取，未声明也不抛）；普通对象（测试
+  //   替身/窄接口）才回退属性访问。try/catch 保留 0.3.61 的兜底语义：宁可回落真实实现也别炸掉安装。
   let override = null
   try {
     override = typeof ports?.get === 'function' ? (ports.get('installChannels') ?? null) : (ports?.installChannels ?? null)
@@ -75,9 +75,8 @@ async function tryCandidateChannels({ job, ch, name, profileDir, registries, rep
   const patchPath = join(profileDir, 'cordis.patch.yml')
   let installedName = null
   let lastError = null
-  // 0.5.41 接线：这次成功装上的**来源**（`{ spec, origin, kind }`）—— 取样通道（curl tarball /
-  // GitHub release 资产）知道真实下载地址，收口那一步据此走 `pnpm add <spec>` 真装（依赖交给 pnpm）。
-  // registry 通道不填（既有流程一字不改）；git 通道也不填（它本来就是 pnpm 装的，清单里已是 pnpm 写的规格）。
+  // 0.5.41 接线：这次成功装上的**来源**（`{ spec, origin, kind }`）—— 取样通道（curl tarball / GitHub
+  // release 资产）知道真实下载地址，收口那一步据此走 `pnpm add <spec>` 真装；registry/git 通道都不填。
   let source = null
   // 加法优化：包已在 node_modules 且名字匹配时，不再重复安装/触发 EPERM，直接进入启用流程
   // （2026-09-27 搬进 install-verify.js#alreadyInstalledTarget：本文件贴着 600 行架构硬顶）
@@ -222,8 +221,12 @@ async function runInstallJob(job, ports, deps = {}) {
     fetchRepoPackage,
     fetchRepoPackageEx,
     fetchSubpackageNames,
+    fetchSubdirPlugins,
     subpackageCandidates,
     npmNameHint: npmNameHintForRepo,
+    // 技能仓库探测 + 默认分支探测也进袋子（2026-10-13，**测试安全**）：这两处原本是直接调用，离线测试
+    // 拦不住（本机实测会真的连 api.github.com/ghproxy/ghfast）。生产默认值与改动前逐字相同。
+    detectSkillRepo, fetchRepoMeta,
     ...(deps.marketProbes ?? {}),
   }
   // 展开实现必须跟随**注入的** fetchSubpackageNames（否则注入的探测桩会被绕过、悄悄去打真网络 ——
@@ -231,10 +234,22 @@ async function runInstallJob(job, ports, deps = {}) {
   if (deps.marketProbes?.expandSubpackages === undefined) {
     probes.expandSubpackages = (opts = {}) => expandSubpackageCandidates({ ...opts, deps: { fetchSubpackageNames: probes.fetchSubpackageNames } })
   }
+  // ★ 0.5.47：额外通道的 deps **绑在袋子上**（套装判定先探一次 2 参调用并缓存，只在调用点传 deps 会被绕过）
+  bindMarketDeps(probes, job, deps)
   const jobBudgetMs = Number.isFinite(deps.jobBudgetMs) && deps.jobBudgetMs > 0 ? deps.jobBudgetMs : 8 * 60 * 1000
   // 源码通道（体积门禁 + 稀疏取源码 + 预设装配）的注入缝：与 marketProbes 同一风格，生产调用方不传。
   const sourceDeps = deps.sourceDeps ?? {}
   const aiConsentTimeoutMs = Number.isFinite(deps.aiConsentTimeoutMs) && deps.aiConsentTimeoutMs > 0 ? deps.aiConsentTimeoutMs : AI_CONSENT_TIMEOUT_MS
+  // ★ 子目录插件（2026-10-13 加法，第二轮）：用户点了「从这个子目录安装」⇒ 走专门的子目录通道
+  //   （先落地该子目录，再按既有**本地目录来源** link: 装；判据与理由见 domain/subdir-install.js）。
+  //   位置刻意放在**任何仓库根探测之前**：这条路本来就不该按根包去探（真机 Fei2411/DeepSeek-Bot
+  //   根目录根本没有清单），否则会白跑一轮探测、还可能把结论带偏。
+  //   `channels` 沿用本文件唯一那个通道注入缝（channelImpls），不在这里另立一个说法。
+  if (typeof job.subdir === 'string' && job.subdir.trim() !== '') {
+    await runSubdirInstallJob(job, ports, { ...deps, channels: channelImpls(ports) })
+    job.finishedAt = Date.now()
+    return
+  }
   try {
     job.stage = 'preparing'
     // 2026-09-06 事故（室友机器）：对 deepseek-ai/deepseek-harness（框架本体仓库）点安装会按 bundle 规则
@@ -283,21 +298,35 @@ async function runInstallJob(job, ports, deps = {}) {
       const meta = job.repoMeta !== undefined ? job.repoMeta : await fetchRepoMeta(job.repo)
       const branch = meta?.default_branch ?? 'main'
       job.defaultBranch = branch // 批次 B-⑥：后续读子包一律以它打头（默认分支是 dev 的仓库不再读不到子包）
-      const rootProbe = job.rootPkgProbe !== undefined ? job.rootPkgProbe : await probes.fetchRepoPackageEx(job.repo, branch)
+      const rootProbe = await probeRootManifest({ job, probes, noteChannel, branch }) // 0.5.47 接线：额外通道 + 通道身份
       const { pkg, reason } = rootProbe
       if (pkg === null) {
         // 无 package.json：先探测是否技能仓库（含 SKILL.md）→ 自动转技能安装；
-        // 否则标记 hint=repo-land，前端给出「仓库落地」一键入口（克隆到本地目录）。
-        const skillProbe = await detectSkillRepo(job.repo, branch)
+        // 2026-10-13 改错（用户实测 Fei2411/DeepSeek-Bot）：**根目录没有清单 ≠ 这个仓库不是插件**。
+        // 真机该仓库根目录只有 docs/ + ds-bot/，而 ds-bot/package.json 同时带 dsh.client 与
+        // dsh.bundle.patch —— 旧代码在这里直接下"不是插件"的结论，结论错、也没给用户下一步。
+        // 现在先向下扫 1–2 层子目录（与 fetchSubpackageNames 的路径口径一致）：
+        //   · 扫到带 dsh 标记的清单 → 明说"插件在 <子目录>/ 下"并给出可复制的安装写法；
+        //   · 扫完确实没有 → 保持旧结论，但文案补上"已检查根目录与 N 层子目录"（诚实）。
+        const skillProbe = await (probes.detectSkillRepo ?? detectSkillRepo)(job.repo, branch)
         if (skillProbe.hasSkill) {
           job.kind = 'skill'
           await runSkillInstallJob(job, ports)
           return
         }
+        const decided = await decideNoRootManifest({
+          repo: job.repo,
+          branch,
+          reason,
+          probe: probes.fetchSubdirPlugins,
+          baseText: composeProbeFailureText(rootProbe, packageProbeErrorText(job.repo, branch, reason)),
+          source: job.source,
+        })
         job.status = 'failed'
-        job.hint = 'repo-land'
-        // 文案区分「抓取超时/不可达」与「真的没有」——旧代码两者共用一个出口，报错永远说"文件不存在"
-        job.error = packageProbeErrorText(job.repo, branch, reason)
+        job.hint = decided.hint
+        job.error = decided.error
+        job.subplugin = decided.subplugin
+        if (decided.hint === 'subdir-plugin') return
         job.probeReason = reason
         return
       }
@@ -562,37 +591,9 @@ async function runInstallJob(job, ports, deps = {}) {
     job.finishedAt = Date.now()
   }
 }
-/** 读取用户额外 bundle（非官方模板）的补丁插入行 id 与包名，用于"额外插件"判定。 */
-async function readExtraBundleRows(profileDir) {
-  const rows = new Set()
-  try {
-    const manifest = JSON.parse(await readFile(join(profileDir, 'package.json'), 'utf8'))
-    const bundles = manifest.dsh?.profile?.bundles ?? []
-    for (const pkg of bundles) {
-      if (DEFAULT_BUNDLES.includes(pkg)) continue
-      try {
-        const pk = resolvePackageJson(pkg, profileDir)
-        const dir = dirname(pk ?? join(profileDir, 'node_modules', ...String(pkg).split('/'), 'package.json'))
-        const text = await readFile(join(dir, 'cordis.patch.yml'), 'utf8')
-        const lines = text.split(/\r?\n/u)
-        let inInsert = false
-        for (let index = 0; index < lines.length; index += 1) {
-          const line = lines[index]
-          if (/^- insert:\s*$/u.test(line)) {
-            inInsert = true
-            continue
-          }
-          if (/^- /u.test(line)) inInsert = false
-          if (!inInsert) continue
-          const idMatch = line.match(/^ {4}- id: ([A-Za-z0-9_.-]+)\s*$/u)
-          if (!idMatch) continue
-          rows.add(idMatch[1])
-          const nameMatch = (lines[index + 1] ?? '').match(/^ {6}name: ['"]([^'"]+)['"]\s*$/u)
-          if (nameMatch) rows.add(nameMatch[1])
-        }
-      } catch {}
-    }
-  } catch {}
-  return rows
-}
-export { runInstallJob, pnpmRemove, readExtraBundleRows, cleanupAttemptedCandidates, aiConsentFailureText, tryCandidateChannels, channelImpls, RELEASE_CHANNEL_BUDGET, GIT_CHANNEL_BUDGET_MS, GIT_SPEC_TIMEOUT_MS, GIT_MIN_ATTEMPT_MS, gitChannelBudgetMs, noteChannel, formatBudgetMs }
+/** 读取用户额外 bundle（非官方模板）的补丁插入行 id 与包名，用于"额外插件"判定。
+ * 实现在 domain/bundle-refs.js（2026-10-13 搬出，只搬移未改逻辑：那边与 insert 行解析同属一件事，
+ * 这边腾出 600 行硬顶）；这里保留同名 re-export —— **对外导出名与调用点一个字都没变**。 */
+export { readExtraBundleRows }
+
+export { runInstallJob, pnpmRemove, cleanupAttemptedCandidates, aiConsentFailureText, tryCandidateChannels, channelImpls, RELEASE_CHANNEL_BUDGET, GIT_CHANNEL_BUDGET_MS, GIT_SPEC_TIMEOUT_MS, GIT_MIN_ATTEMPT_MS, gitChannelBudgetMs, noteChannel, formatBudgetMs }

package/lib/server/domain/install-verify.js

@@ -235,4 +235,62 @@ function alreadyInstalledTarget(profileDir, name, job = null) {
   return null
 }
 
-export { verifyInstalledEntry, verifyTarballDigest, entryFieldOf, alreadyInstalledTarget, MIRROR_HINT }
+/** 「其实已经装上了」的**三处核实**（2026-10-13 加法，用户被误导过）：
+ *   · ① profile `package.json` 的 `dependencies` 里有这个包（任何 spec 形态都算）；
+ *   · ② `dsh.profile.bundles` 里有它（bundle 层已注册）；
+ *   · ③ `node_modules/<包名>/package.json` 在盘上（真装着，顺便读出**版本号**）。
+ *
+ * 为什么要有它：面板的「最近安装失败」只看作业状态，于是会出现**明明已经装上了还报失败**的
+ * 误导（重试一次还可能把好端端的安装弄坏）。判据刻意是**三处任一命中即算已安装**——
+ * 缺哪一处是"持久化是否完整"的问题（由 persist.js 的 persisted 如实报），不是"装没装上"的问题。
+ * 只读、永不抛、绝不改动任何东西。返回 `{ installed, packageName, version, where, spec, note }`。 */
+function installedEvidence(profileDir, packageName) {
+  const name = typeof packageName === 'string' ? packageName.trim() : ''
+  if (name === '') return { installed: false, packageName: null, version: null, where: [], spec: null, note: null }
+  const dir = String(profileDir ?? '')
+  const where = []
+  let spec = null
+  try {
+    const manifest = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'))
+    const dep = manifest?.dependencies?.[name]
+    if (typeof dep === 'string' && dep !== '') { spec = dep; where.push('dependencies') }
+  } catch {}
+  try {
+    if (readBundles(dir).includes(name)) where.push('bundles')
+  } catch {}
+  let version = null
+  try {
+    const pkg = JSON.parse(readFileSync(join(dir, 'node_modules', ...name.split('/'), 'package.json'), 'utf8'))
+    if (pkg !== null && typeof pkg === 'object' && pkg.name === name) {
+      where.push('node_modules')
+      version = typeof pkg.version === 'string' && pkg.version !== '' ? pkg.version : null
+    }
+  } catch {}
+  const installed = where.length > 0
+  if (installed !== true) return { installed: false, packageName: name, version: null, where: [], spec, note: null }
+  const place = where.join('、')
+  const versionText = version === null ? '（node_modules 里读不到版本号）' : ` v${version}`
+  return {
+    installed: true,
+    packageName: name,
+    version,
+    where,
+    spec,
+    note: `${name} 其实已经装上了${versionText} —— 命中：${place}。`
+      + `最近一次安装报的失败**不代表没装上**（可能是重复安装/更新那一步失败），无需重装。`,
+  }
+}
+
+/** 失败作业 → 面板要显示的那段核实结果（名字从作业上按既有字段依次取，取不到就返回 null）。
+ * 顺序刻意是"最具体的先"：子目录插件点名的包名 → 本次作业的候选包名 → 子目录识别结果里的包名。
+ * 名字取不到时返回 null（**不下"没装上"的结论** —— 那正是我们要避免的误导）。 */
+function failedJobEvidence(profileDir, job) {
+  if (job === null || job === undefined) return null
+  const candidates = [job.packageName, job.candidateName, job.subplugin?.packageName, job.subplugin?.install?.packageName]
+  const name = candidates.find((n) => typeof n === 'string' && n.trim() !== '')
+  if (name === undefined) return null
+  return installedEvidence(profileDir, name)
+}
+
+export { verifyInstalledEntry, verifyTarballDigest, entryFieldOf, alreadyInstalledTarget, installedEvidence, failedJobEvidence, MIRROR_HINT }
+

package/lib/server/domain/install.js

@@ -536,6 +536,9 @@ function installJobView(job) {
     suiteNote: job.suiteNote ?? null, repoSize: job.repoSize ?? null,
     ...presetJobView(job),
     hint: job.hint ?? null,
+    // 子目录插件识别结果（2026-10-13 加法，真机 Fei2411/DeepSeek-Bot：插件在 ds-bot/ 而不是仓库根）：
+    // 下发结构化字段而不只塞进 error 文案 —— 面板要能**单独显示**（哪个子目录、包名、哪些 dsh 标记）。
+    subplugin: job.subplugin ?? null,
     // 子包级/套装级进度（2026-09-20 真装实测缺口：11 个子包的聚合仓库跑了 19 分钟，面板只显示
     // "安装中"，用户不知道在装第几个、还剩几个）。子包通道来自 install-job.js 候选循环维护的
     // candidateXxx；套装通道来自 suite.js 维护的 suiteProgress（clone/装配两阶段）。
@@ -554,6 +557,11 @@ function installJobView(job) {
     // 持久化判据（0.5.38 加法，见 domain/persist.js）：`persisted:false` ⇒ 面板必须报「未持久化」
     // （重启/任何一次 pnpm 操作后可能消失）并给出「一键钉住」动作 —— 绝不报"安装成功"。
     persisted: job.persisted ?? null, persistNote: job.persistNote ?? null, persist: job.persist ?? null,
+    // 「其实已经装上了」的核实结果（0.5.47 加法，见 install-verify.js#installedEvidence）：失败作业由路由在下发前**现查**三处覆盖。
+    installedEvidence: job.installedEvidence ?? null,
+    // 抓清单那一轮的**通道身份** + 本地落地落点（0.5.47 加法，见 domain/manifest-probe.js）：
+    // 面板据此显示"清单经 npm 镜像 / 本地落地 / 直连读到的"，本地命中时给出「从本地安装」的落点。
+    probe: job.probe ?? null, localDir: job.localDir ?? null, localHint: job.localHint ?? null,
   }
 }