@noob-stupid/dsh-plugin-console 0.3.52 → 0.3.53

package/README.md

@@ -308,7 +308,7 @@ MIT
 
 The layered-refactor preview lives in its **own repository**: [**`Noob-stupid/dsh-plugin-hub-refactor`**](https://github.com/Noob-stupid/dsh-plugin-hub-refactor)
 
-- **What it is**: the monolithic `lib/index.js` (7637 lines) split into layers — `lib/index.js` **142 lines** + `lib/server/**` **36 modules**; **feature-equivalent to `0.3.52`**, maintainability only;
+- **What it is**: the monolithic `lib/index.js` (7637 lines) split into layers — `lib/index.js` **142 lines** + `lib/server/**` **36 modules**; **feature-equivalent to `0.3.53`**, maintainability only;
 - **Verified**: 18 test suites green · 8 architecture-guard assertions · **47/47 routes identical** (`status` + response fields) against the stable build;
 - **Not yet exercised**: real framework upgrade / rollback, restart guardian, real install/uninstall, component start/stop, real AI run, Gitee OAuth (~10–25% long-tail risk, subjective);
-- **For everyday use** stick to npm `@noob-stupid/dsh-plugin-console@0.3.52`, or `main` of this repo.
+- **For everyday use** stick to npm `@noob-stupid/dsh-plugin-console@0.3.53`, or `main` of this repo.

package/README.zh.md

@@ -275,8 +275,8 @@ MIT
 
 分层重构预览线在**独立仓库**：[**`Noob-stupid/dsh-plugin-hub-refactor`**](https://github.com/Noob-stupid/dsh-plugin-hub-refactor)
 
-- **它是什么**：把单体 `lib/index.js`（7637 行）拆成分层结构 —— `lib/index.js` **142 行** + `lib/server/**` **36 个模块**，**功能与 `0.3.52` 等价**，只为可维护性；
+- **它是什么**：把单体 `lib/index.js`（7637 行）拆成分层结构 —— `lib/index.js` **142 行** + `lib/server/**` **36 个模块**，**功能与 `0.3.53` 等价**，只为可维护性；
 - **已验证**：18 套测试全绿 · 8 条架构守卫断言 · 与稳定版逐条对打 **47 条路由，`status` + 响应字段 47/47 一致**；
 - **尚未实测**：真框架升级 / 真回滚、重启守护链路、真装真卸、组件进程启停、AI 真跑、Gitee OAuth 回调（长尾风险主观估计 **10%~25%**）；
-- **日常使用请继续用**：npm `@noob-stupid/dsh-plugin-console@0.3.52`，或本仓库 `main`。
+- **日常使用请继续用**：npm `@noob-stupid/dsh-plugin-console@0.3.53`，或本仓库 `main`。
 - 请多反馈问题

package/lib/client.js

@@ -203,6 +203,10 @@ window.__ModuleLoader__.load({
 			loadingDetails: "正在读取详情…",
 			githubLoggedIn: "已登录 GitHub：",
 			githubCornerOut: "未登录 GitHub",
+			githubLoginViaApp: "GitHub 登录",
+			githubLoginOpened: "已打开 GitHub 授权窗口，请在页面上输入验证码完成授权…",
+			githubLoginUnavailable: "无法使用窗口登录",
+			githubLoginOrToken: "或用 Token 登录",
 			githubLoginTip: "粘贴 GitHub Token 登录（fine-grained，需 read:user 权限）。登录后可用代码搜索（按子包名搜索）并提高 API 限额；也可用 dsh-github-login 插件登录。",
 			githubTokenPlaceholder: "粘贴 token（ghp_… 或 github_pat_…）",
 			githubLoginBtn: "登录",
@@ -584,6 +588,10 @@ window.__ModuleLoader__.load({
                     hubUpdateAvailable: "Download update",
                     cleanResiduals: "Clean residual backups",
 			githubCornerOut: "Not signed in to GitHub",
+			githubLoginViaApp: "GitHub login",
+			githubLoginOpened: "Authorization window opened — enter the code on the GitHub page to finish",
+			githubLoginUnavailable: "Window login unavailable",
+			githubLoginOrToken: "Or sign in with a token",
 			githubLoginTip: "Paste a GitHub token to sign in (fine-grained, needs the read:user scope). Signing in enables code search (search by subpackage name) and raises API rate limits; you can also sign in with the dsh-github-login plugin.",
 			githubTokenPlaceholder: "Paste token (ghp_… or github_pat_…)",
 			githubLoginBtn: "Sign in",
@@ -1906,16 +1914,6 @@ window.__ModuleLoader__.load({
 				document.addEventListener("mousedown", onDown);
 				return () => document.removeEventListener("mousedown", onDown);
 			}, [sourceMenuOpen]);
-			// GitHub 登录面板：点击外部收起（与搜索源菜单同一模式）
-			react.useEffect(() => {
-				if (!ghLoginOpen) return;
-				const onDown = (event) => {
-					const area = document.getElementById("pc-ghlogin");
-					if (area && !area.contains(event.target)) setGhLoginOpen(false);
-				};
-				document.addEventListener("mousedown", onDown);
-				return () => document.removeEventListener("mousedown", onDown);
-			}, [ghLoginOpen]);
 			// 已安装搜索：点击搜索区以外且无内容时立即收起（无延迟）
 			react.useEffect(() => {
 				if (!installedSearchOpen) return;
@@ -1943,6 +1941,69 @@ window.__ModuleLoader__.load({
 				);
 			}, []);
 			react.useEffect(() => { refresh(); }, [refresh]);
+			// ── GitHub 登录态的两个读数：面板里多处要用（徽章文案、菜单项、内联子面板）──
+			const ghAuthed = state.status === "ready" && state.data.github !== undefined && state.data.github.loggedIn === true;
+			const ghLoginName = state.status === "ready" && state.data.github !== undefined && state.data.github.login !== null && state.data.github.login !== undefined
+				? state.data.github.login
+				: "unknown";
+			// 设备码登录的轮询句柄：拿到登录态就停，用户手动收起菜单也停（不留后台空转的定时器）
+			const ghPollRef = react.useRef(null);
+			const stopGhPoll = react.useCallback(() => {
+				if (ghPollRef.current !== null) { window.clearInterval(ghPollRef.current); ghPollRef.current = null; }
+			}, []);
+			// 组件卸载时收尾（本面板是长驻 UI，正常不卸载，但热重载/关闭面板会）
+			react.useEffect(() => () => stopGhPoll(), [stopGhPoll]);
+			// 菜单收起 = 用户手动关掉了这次登录尝试 → 立刻停止轮询（对应"最多 60s 或用户手动关闭"）
+			react.useEffect(() => { if (!sourceMenuOpen) stopGhPoll(); }, [sourceMenuOpen, stopGhPoll]);
+			// 窗口登录开始后等登录态：每 2s 问一次 /state，最多 60s。
+			// 为什么只能轮询：设备码流程在**另一个进程**里完成（用户在 GitHub 页面上输验证码授权），
+			// 本插件收不到任何回调，只能盯 <DSH_HOME>/github-auth.json（/state 的 github 字段）有没有变。
+			const startGhPoll = () => {
+				stopGhPoll();
+				const deadline = Date.now() + 60000;
+				ghPollRef.current = window.setInterval(() => {
+					call("/plugin-console/state").then(
+						(snap) => {
+							const github = snap !== null && snap !== undefined ? snap.github : null;
+							if (github !== null && github !== undefined && github.loggedIn === true) {
+								stopGhPoll();
+								setMessage(t("githubLoginOk").replace("{login}", github.login ?? ""));
+								refresh();
+								return;
+							}
+							if (Date.now() >= deadline) stopGhPoll();
+						},
+						// 单次失败不中断：授权期间用户可能正在重启服务，下一拍再问
+						() => { if (Date.now() >= deadline) stopGhPoll(); },
+					);
+				}, 2000);
+			};
+			// 菜单里的主入口「GitHub 登录」：首选设备码窗口流程（在 GitHub 页面上输验证码），
+			// 通道不可用才降级到 token 粘贴子面板（token 是兜底，不是正路）。
+			const githubOpenLogin = () => {
+				if (ghLoginBusy) return;
+				setGhLoginBusy(true);
+				// 先给一句反馈：环回调用最长要等 8s，中间没有提示会让人以为点了没反应
+				setMessage(t("githubLoginOpened"));
+				call("/plugin-console/github-open-login", {}).then(
+					(r) => {
+						setGhLoginBusy(false);
+						if (r !== null && r !== undefined && r.started === true) {
+							setMessage(t("githubLoginOpened"));
+							startGhPoll();
+							return;
+						}
+						// 服务端回 started:false 时一定带 reason（插件没装/没有 exe/平台不支持），照念给用户
+						setMessage(t("githubLoginUnavailable") + "：" + (r !== null && r !== undefined && typeof r.reason === "string" ? r.reason : ""));
+						setGhLoginOpen(true);
+					},
+					(error) => {
+						setGhLoginBusy(false);
+						setMessage(t("githubLoginFail") + "：" + (error?.message ?? ""));
+						setGhLoginOpen(true);
+					},
+				);
+			};
 			// 粘贴 token 登录：成功后清空输入 + 收起面板 + 刷新登录态（让徽章/代码搜索立刻用上新身份）；
 			// 失败**不清空输入**——用户多半是复制时多带了空格/少了一段，保留原文才好改。
 			const githubLogin = () => {
@@ -3683,14 +3744,19 @@ setMessage(t("failed") + "：" + (data?.reason ?? "未知"));
 						el("button", {
 							type: "button",
 							className: styles.ghpill,
+							// 外观回退：市场页只有**这一颗** pill，登录态体现在它的绿色描边上（data-on），
+							// 不再单独占一颗登录徽章
+							"data-on": ghAuthed ? "true" : "false",
 							title: t("searchSourceTitle"),
 							"aria-label": t("searchSourceTitle"),
 							onClick: () => setSourceMenuOpen((v) => !v),
 						},
-							// 这一颗是「搜索源」选择器：只报当前源名。登录态搬去右边的 GitHub 徽章
-							// （原来它顺手显示登录态，导致"未登录 GitHub"看着像徽章却点开的是源菜单）
-							t("sourceOf") + ((searchSourcesList !== null ? searchSourcesList.find((s) => s.id === searchSource)?.name : undefined)
-								?? (searchSource === "gitee" ? "Gitee" : searchSource)),
+							// 源选在 GitHub 时这颗 pill 顺手报登录态（回到上一批之前的形态）；
+							// 选别的源时只报源名 —— 否则"未登录 GitHub"看着像徽章却点开的是源菜单
+							searchSource === "github"
+								? (ghAuthed ? t("githubLoggedIn") + ghLoginName : t("githubCornerOut"))
+								: t("sourceOf") + ((searchSourcesList !== null ? searchSourcesList.find((s) => s.id === searchSource)?.name : undefined)
+									?? (searchSource === "gitee" ? "Gitee" : searchSource)),
 							" ▾"),
 						sourceMenuOpen
 							? el("div", { className: styles.sourceMenu },
@@ -3708,37 +3774,47 @@ setMessage(t("failed") + "：" + (data?.reason ?? "未知"));
 											try { localStorage.setItem("pc-search-source", s.id); } catch {}
 											setSourceMenuOpen(false);
 										},
-									}, s.name)))
+									}, s.name)),
+								// ── 登录区（登录入口收进这颗 pill 的菜单里，不再单独一颗徽章）──
+								el("div", { style: { height: 1, margin: "4px 2px", background: "var(--dsw-alias-border-l2)" } }),
+								ghAuthed
+									// 已登录：这行只报状态（点了把状态念到消息栏，不做别的）
+									? el("button", {
+										type: "button",
+										className: styles.sourceOpt,
+										"data-active": "true",
+										title: t("githubLoginTip"),
+										onClick: () => setMessage(t("githubLoggedIn") + ghLoginName),
+									}, t("githubLoggedIn") + ghLoginName)
+									// 未登录：主入口走设备码窗口登录；窗口不可用时它自己会展开下面的 token 子面板
+									: el("button", {
+										type: "button",
+										className: styles.sourceOpt,
+										disabled: ghLoginBusy,
+										title: t("githubLoginTip"),
+										onClick: githubOpenLogin,
+									}, t("githubLoginViaApp")),
+								// 次要入口：token 兜底（已登录时也留着 —— 换账号/换 token 就靠它）
+								el("button", {
+									type: "button",
+									className: styles.sourceOpt,
+									onClick: () => setGhLoginOpen((v) => !v),
+								}, t("githubLoginOrToken")),
+								// token 兜底子面板：窗口登录不可用（插件没装/非 Windows/没有 exe）时自动展开；
+								// 也可以从上面「或用 Token 登录」主动开合。样式内联，不为它改 CSS 表。
+								ghLoginOpen
+									? el("div", { style: { display: "flex", flexDirection: "column", gap: 6, width: 280, boxSizing: "border-box", padding: "2px 2px 4px" } },
+										el("p", { className: styles.message, style: { margin: 0 } }, t("githubLoginTip")),
+										el("input", {
+											type: "password",
+											placeholder: t("githubTokenPlaceholder"),
+											value: ghToken,
+											onChange: (event) => setGhToken(event.currentTarget.value),
+											style: { width: "100%", boxSizing: "border-box" },
+										}),
+										el("button", { type: "button", className: styles.toggle, disabled: ghLoginBusy || ghToken.trim() === "", onClick: githubLogin }, t("githubLoginBtn")))
+									: null)
 							: null,
-						// 「未登录 GitHub / 已登录 GitHub：xxx」徽章：原来只是展示（点了没反应），
-						// 现在点开内联登录面板（粘贴 PAT 即登录），面板样式内联，避免为它改 CSS 表。
-						el("div", { id: "pc-ghlogin", style: { position: "relative", display: "inline-flex" } },
-							el("button", {
-								type: "button",
-								className: styles.ghpill,
-								"data-on": state.status === "ready" && state.data.github && state.data.github.loggedIn ? "true" : "false",
-								title: t("githubLoginTip"),
-								"aria-label": t("githubLoginTip"),
-								onClick: () => setGhLoginOpen((v) => !v),
-							},
-								state.status === "ready" && state.data.github && state.data.github.loggedIn
-									? t("githubLoggedIn") + (state.data.github.login ?? "unknown")
-									: t("githubCornerOut")),
-							ghLoginOpen
-								? el("div", { style: { position: "absolute", right: 0, top: "calc(100% + 6px)", zIndex: 95, width: 300, boxSizing: "border-box", border: "1px solid var(--dsw-alias-border-l2)", background: "var(--dsw-alias-bg-layer-1)", borderRadius: 8, padding: 10, display: "flex", flexDirection: "column", gap: 8, textAlign: "left", boxShadow: "0 8px 24px rgba(0,0,0,.18)" } },
-									el("p", { className: styles.message, style: { margin: 0 } }, t("githubLoginTip")),
-									state.status === "ready" && state.data.github && state.data.github.loggedIn
-										? el("p", { className: styles.message, style: { margin: 0 } }, t("githubLoggedIn") + (state.data.github.login ?? "unknown"))
-										: null,
-									el("input", {
-										type: "password",
-										placeholder: t("githubTokenPlaceholder"),
-										value: ghToken,
-										onChange: (event) => setGhToken(event.currentTarget.value),
-										style: { width: "100%", boxSizing: "border-box" },
-									}),
-									el("button", { type: "button", className: styles.toggle, disabled: ghLoginBusy || ghToken.trim() === "", onClick: githubLogin }, t("githubLoginBtn")))
-								: null),
 					)),
 				(aiRunning || aiJobsList.some((x) => x.status === "running"))
 					? el("button", {

package/lib/index.js

@@ -5555,6 +5555,55 @@ async function handle(ctx, req, res) {
     return
   }
 
+  if (pathname === `${ROUTE_PREFIX}/github-open-login`) {
+    // 设备码（窗口）登录：唤起独立插件 dsh-github-login 的登录窗口 —— 登录的首选通道，token 只是兜底。
+    //
+    // 为什么是"调另一个插件的 HTTP 接口"而不是自己实现设备码：Device Flow + 桌面窗口 + 令牌落盘
+    // 已经由那个插件实现好了，它挂在**同一个宿主 webServer** 上（源码：<profile>/node_modules/
+    // dsh-github-login/lib/index.js）：
+    //   POST /github-auth/open    → { ok:true, launched:"<exe 路径>" } 或 { ok:true, launched:false, hint }
+    //   GET  /github-auth/status  → { ok, loggedIn, login }
+    // 为什么失败也回 200：这个能力是**外挂**的 —— 插件可能没装、装了也可能没打包 exe、当前 profile
+    // 也可能没把它挂上（2026-09-20 实测：本机装了它，但跑着的宿主里 GET /github-auth/status 仍是 404）。
+    // 那是"这条通道现在不可用"，不是"服务端出错"：回 500 只会让用户看到一句看不懂的报错，还看不出
+    // "该走 token 兜底"这条正路。所以统一回 200 + started:false + 可读 reason，由前端决定降级。
+    const port = webPort(ctx)
+    const base = `http://127.0.0.1:${port}`
+    const unavailable = '未检测到 dsh-github-login 插件（或当前平台不支持它的登录窗口）'
+    const fallback = (detail) => {
+      sendJson(res, 200, { ok: true, started: false, reason: detail ? `${unavailable}：${detail}` : unavailable })
+    }
+    let opened = null
+    try {
+      const response = await fetch(`${base}/github-auth/open`, { method: 'POST', signal: AbortSignal.timeout(8000) })
+      if (!response.ok) {
+        fallback(`对方接口返回 HTTP ${response.status}`)
+        return
+      }
+      opened = await response.json()
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error)
+      // fetch 的 "fetch failed" 不带 cause 等于没说；超时原文也没有信息量 —— 都压成一行可读文案
+      const cause = error?.cause?.code ?? error?.cause?.message ?? ''
+      fallback(/abort/iu.test(message) ? '调用超时（8000ms）' : (cause ? `${message}（${cause}）` : message))
+      return
+    }
+    // 对方"接口在、但本机没有登录工具 exe"时回 { ok:true, launched:false, hint }：窗口其实没起来。
+    // 这里必须跟着报 started:false —— 报 true 会让前端开 60s 轮询，等一个永远不会出现的登录。
+    if (opened?.launched === false) {
+      fallback(typeof opened.hint === 'string' && opened.hint !== '' ? opened.hint : '对方未启动登录窗口（未找到 DSH-GitHub-Login 可执行文件）')
+      return
+    }
+    // 顺手把对方的登录态透传给前端（best-effort：拿不到就 status:null，不影响"窗口已打开"这个结论）
+    let status = null
+    try {
+      const stateRes = await fetch(`${base}/github-auth/status`, { signal: AbortSignal.timeout(2000) })
+      if (stateRes.ok) status = await stateRes.json()
+    } catch {}
+    sendJson(res, 200, { ok: true, started: true, status })
+    return
+  }
+
   if (pathname === `${ROUTE_PREFIX}/details`) {
     const { entryId } = body
     if (typeof entryId !== 'string' || !/^[A-Za-z0-9_:.-]{1,80}$/u.test(entryId)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noob-stupid/dsh-plugin-console",
-  "version": "0.3.52",
+  "version": "0.3.53",
   "description": "DSH plugin management panel & marketplace: one-click enable/disable, multi-source market (GitHub/Gitee/custom), static-index market (500+ plugins / 300 skills), skills, suites, and one-click framework upgrade.",
   "repository": {
     "type": "git",