@noob-stupid/dsh-plugin-console 0.3.51 → 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.51`**, 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.51`, 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.51` 等价**，只为可维护性；
+- **它是什么**：把单体 `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.51`，或本仓库 `main`。
+- **日常使用请继续用**：npm `@noob-stupid/dsh-plugin-console@0.3.53`，或本仓库 `main`。
 - 请多反馈问题

package/lib/client.js

@@ -203,6 +203,15 @@ 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: "登录",
+			githubLoginOk: "已登录 GitHub：{login}",
+			githubLoginFail: "登录失败",
 			hubUpdateAvailable: "下载更新",
 			cleanResiduals: "清理残余备份",
 					searchInstalledPlaceholder: "搜索已安装插件（名称或 id）",
@@ -579,6 +588,15 @@ 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",
+			githubLoginOk: "Signed in to GitHub: {login}",
+			githubLoginFail: "Sign-in failed",
 					searchInstalledPlaceholder: "Search installed plugins (name or id)",
 			extraFilter: "Installed",
 			extraFilterAll: "All",
@@ -1703,6 +1721,10 @@ window.__ModuleLoader__.load({
 				try { const s = localStorage.getItem("pc-search-source"); return s === "gitee" ? s : "github"; } catch { return "github"; }
 			});
 			const [sourceMenuOpen, setSourceMenuOpen] = react.useState(false);
+			// GitHub 登录：徽章点开内联面板，token 只在「浏览器 → 本机服务端」之间走，服务端不回显
+			const [ghLoginOpen, setGhLoginOpen] = react.useState(false);
+			const [ghToken, setGhToken] = react.useState("");
+			const [ghLoginBusy, setGhLoginBusy] = react.useState(false);
 			// "不再提醒"：勾选后 AI 兜底自动同意，不再弹窗（可在市场底部恢复提醒）
 			const [aiRemember, setAiRemember] = react.useState(() => {
 				try { return localStorage.getItem("pc-ai-remember") === "1"; } catch { return false; }
@@ -1919,6 +1941,89 @@ 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 = () => {
+				const token = ghToken.trim();
+				if (token === "" || ghLoginBusy) return;
+				setGhLoginBusy(true);
+				call("/plugin-console/github-login", { token }).then(
+					(r) => {
+						setGhLoginBusy(false);
+						setMessage(t("githubLoginOk").replace("{login}", r?.login ?? ""));
+						setGhToken("");
+						setGhLoginOpen(false);
+						refresh();
+					},
+					(error) => {
+						setGhLoginBusy(false);
+						setMessage(t("githubLoginFail") + "：" + (error?.message ?? ""));
+					},
+				);
+			};
 			const loadDetails = (entry) => {
 				if (details !== null && details.entryId === entry.entryId) {
 					setDetails(null);
@@ -3639,15 +3744,17 @@ setMessage(t("failed") + "：" + (data?.reason ?? "未知"));
 						el("button", {
 							type: "button",
 							className: styles.ghpill,
-							"data-on": state.status === "ready" && state.data.github && state.data.github.loggedIn ? "true" : "false",
+							// 外观回退：市场页只有**这一颗** pill，登录态体现在它的绿色描边上（data-on），
+							// 不再单独占一颗登录徽章
+							"data-on": ghAuthed ? "true" : "false",
 							title: t("searchSourceTitle"),
 							"aria-label": t("searchSourceTitle"),
 							onClick: () => setSourceMenuOpen((v) => !v),
 						},
+							// 源选在 GitHub 时这颗 pill 顺手报登录态（回到上一批之前的形态）；
+							// 选别的源时只报源名 —— 否则"未登录 GitHub"看着像徽章却点开的是源菜单
 							searchSource === "github"
-								? (state.status === "ready" && state.data.github && state.data.github.loggedIn
-									? t("githubLoggedIn") + (state.data.github.login ?? "unknown")
-									: t("githubCornerOut"))
+								? (ghAuthed ? t("githubLoggedIn") + ghLoginName : t("githubCornerOut"))
 								: t("sourceOf") + ((searchSourcesList !== null ? searchSourcesList.find((s) => s.id === searchSource)?.name : undefined)
 									?? (searchSource === "gitee" ? "Gitee" : searchSource)),
 							" ▾"),
@@ -3667,7 +3774,46 @@ 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,
 					)),
 				(aiRunning || aiJobsList.some((x) => x.status === "running"))

package/lib/index.js

@@ -13,7 +13,7 @@
  * 移除该块即恢复；HMR 监视器会自动重组合，无需重启。
  */
 import { readFile, writeFile } from 'node:fs/promises'
-import { readFileSync, writeFileSync, existsSync, statSync, rmSync, readdirSync, mkdirSync, copyFileSync, realpathSync } from 'node:fs'
+import { readFileSync, writeFileSync, existsSync, statSync, rmSync, readdirSync, mkdirSync, copyFileSync, realpathSync, chmodSync } from 'node:fs'
 import { execFile, spawn } from 'node:child_process'
 import { promisify } from 'node:util'
 import { dirname, join, basename, sep } from 'node:path'
@@ -1800,14 +1800,19 @@ const GH_BIN_CANDIDATES = [
   join(homedir(), 'scoop', 'shims', 'gh.exe'),
 ]
 
-function githubViaGh(apiPath) {
+/** gh CLI 通道。传 token 时用 GH_TOKEN/GITHUB_TOKEN 环境变量**覆盖 gh 的 keyring 凭据** ——
+ * 这是"校验某个 token 是否有效"时唯一安全的用法：否则 gh 会拿本机已登录的身份作答，
+ * 一个填错的 token 也会"验证成功"（详见 /github-login 路由里的说明）。 */
+function githubViaGh(apiPath, token = null) {
+  // 环境变量而不是命令行参数：token 不能出现在进程命令行（同机其他进程可见）
+  const env = token === null ? undefined : { ...process.env, GH_TOKEN: token, GITHUB_TOKEN: token }
   return new Promise((resolve, reject) => {
     const attempt = (index) => {
       if (index >= GH_BIN_CANDIDATES.length) {
         reject(new Error('gh api 兜底失败：未找到 gh CLI'))
         return
       }
-      execFile(GH_BIN_CANDIDATES[index], ['api', apiPath, '--jq', '.'], { windowsHide: true, timeout: 45000, maxBuffer: 8 * 1024 * 1024 }, (error, stdout) => {
+      execFile(GH_BIN_CANDIDATES[index], ['api', apiPath, '--jq', '.'], { windowsHide: true, timeout: 45000, maxBuffer: 8 * 1024 * 1024, ...(env === undefined ? {} : { env }) }, (error, stdout) => {
         if (error) {
           // ENOENT = 该路径不存在，继续下一个候选；其他错误（网络/认证）直接失败
           if (error.code === 'ENOENT') {
@@ -1866,6 +1871,52 @@ async function githubText(url, signal, token = null) {
   return body
 }
 
+/**
+ * 用**给定 token 专属**的通道取当前用户（GitHub 登录名校验用）。
+ *
+ * 为什么不能直接用 githubJson：它内部会与 gh CLI 通道并行竞速（raceFirst2xx），而 gh 默认用
+ * 本机 keyring 里已有的凭据、完全忽略我们传入的 token —— 本机装着已登录的 gh 时，一个填错的
+ * token 也会因 gh 通道 2xx 而"验证成功"（2026-09-20 实测：本机 gh 登录 Noob-stupid，ghp_aaa…
+ * 拿到的是 Noob-stupid），于是错误 token 被写进 github-auth.json，顶掉用户真实登录态。
+ *
+ * 两条通道都只认用户给的这个 token（gh 走 GH_TOKEN 环境变量覆盖 keyring 凭据）：
+ *   · https（官方 + 镜像）：通用主通道，无子进程
+ *   · gh：node:https 被中间设备劫持时（本机实测 "unable to verify the first certificate"）
+ *         的唯一可用通道 —— 少了它，本机贴对 token 也会被判成"令牌无效"
+ * 两条通道认证的是同一个 token，所以谁先成功都等价；一旦某条给出 401/403（令牌本身不对），
+ * 立刻采信，不等另一条慢超时。
+ */
+async function githubJsonUserWithToken(token) {
+  const viaHttps = (async () => {
+    const res = await githubRequest(`${GITHUB_API}/user`, { token })
+    const status = res.statusCode ?? 0
+    const body = await collectBody(res)
+    // 与 githubJson 同一套错误语义：限流单独说明，其余只报 HTTP 状态（都不含 token）
+    if (status === 403 && Number(res.headers['x-ratelimit-remaining'] ?? '1') === 0) {
+      throw new Error('GitHub 接口限流已用尽，请稍后再试')
+    }
+    if (status < 200 || status >= 300) throw new Error(`GitHub 请求失败 (HTTP ${status})`)
+    return JSON.parse(body)
+  })()
+  const attempts = [viaHttps, githubViaGh('/user', token)]
+  return await new Promise((resolve, reject) => {
+    let pending = attempts.length
+    let firstError = null
+    for (const attempt of attempts) {
+      attempt.then(resolve, (error) => {
+        const message = error instanceof Error ? error.message : String(error)
+        if (/HTTP (?:401|403)/u.test(message)) {
+          reject(error)
+          return
+        }
+        if (firstError === null) firstError = error
+        pending -= 1
+        if (pending === 0) reject(firstError)
+      })
+    }
+  })
+}
+
 /** 用 curl 子进程请求 JSON（绕过本机中间设备对 node:https TLS 指纹的拦截；curl 走系统网络栈）。 */
 async function curlJson(url, timeout = 15000, headers = {}, { ipv4 = false } = {}) {
   const bin = process.platform === 'win32' ? 'curl.exe' : 'curl'
@@ -4820,12 +4871,28 @@ async function runInstallJob(job, ctx) {
       if (pkg.private === true) {
         // 私有 monorepo 根：自动列出子包作为候选（把人工修复经验自动化），聚合包优先
         subpackageMode = true
-        candidates = await subpackageCandidates(job.repo, branch)
-        if (candidates.length === 0) {
+        // 2026-09-20 事故（用户点装 zhu1090093659/dsh-web，报"未发现子包"）：该仓库根包确实
+        // private: true，但 main/dev 各有 22 个子包目录。失败原因是当时市场索引源全挂、网络受限，
+        // subpackageCandidates() 读不到列表 —— 旧代码只有"有没有子包"一个出口，把**没读到**
+        // 报成了**不存在**，直接把用户带偏。教训：探测失败必须与确定性结论分开表达。
+        let subs = await subpackageCandidates(job.repo, branch)
+        if (subs.length === 0) {
+          // 读不到时先换一条分支重试：meta 探测失败时 branch 恒为 main，而默认分支为 dev 的仓库
+          // （本例 dsh-web 就是 dev 为默认分支）main 上的子包布局可能不同/为空；
+          // 换分支几乎零成本，却能把"分支取错"这一类假失败挡在报错之前。
+          const altBranch = branch === 'main' ? 'dev' : 'main'
+          subs = await subpackageCandidates(job.repo, altBranch)
+          if (subs.length > 0) job.subpackageNote = `子包列表取自 ${altBranch} 分支（默认分支探测可能失败）`
+        }
+        if (subs.length === 0) {
           job.status = 'failed'
-          job.error = `仓库 ${job.repo} 的根包未发布到 npm（private: true）且未发现子包；请到"查看"详情确认`
+          // 文案要点：说清"这是读不到、不是没有"，并给出可直接复制的安装命令 ——
+          // 用户看到"未发现子包"会去翻仓库找，而真相多半只是本次网络没读成。
+          job.error = `仓库 ${job.repo} 的根包未发布到 npm（private: true），且本次没能读到它的子包列表（多为网络受限/超时，不代表没有子包）。请重试；或在「查看」详情里确认子包名后直接安装，例如：dsh plugin --profile web add @linxin666/dsh-web-all`
+          job.probeReason = 'subpackages-unreadable'
           return
         }
+        candidates = subs
         job.subpackages = candidates
       } else {
         candidates = [pkg.name]
@@ -5432,6 +5499,111 @@ async function handle(ctx, req, res) {
 
   const body = await readBody(req)
 
+  if (pathname === `${ROUTE_PREFIX}/github-login`) {
+    // GitHub 登录（市场页「未登录 GitHub」徽章 → 内联面板）：用粘贴的 token 换登录名并写入
+    // <DSH_HOME>/github-auth.json —— 与独立插件 dsh-github-login 同一份文件、同一格式 { token, login }。
+    //
+    // 三条安全约束（改这里时不要破）：
+    //   ① token 只进不出：响应只回 login，绝不回显 token，也不写任何日志（日志会落进 console 文件）
+    //   ② 先校验形状再发网络请求：明显不是 PAT 的串不浪费一次 GitHub 往返
+    //   ③ 落盘尽量收紧权限（POSIX 0600；Windows 无此权限模型，失败忽略）
+    const token = typeof body?.token === 'string' ? body.token.trim() : ''
+    // classic（ghp_/gho_/ghu_/ghs_/ghr_）与 fine-grained（github_pat_）两种 PAT 形状
+    if (!/^(?:gh[pousr]_[A-Za-z0-9]{20,255}|github_pat_[A-Za-z0-9_]{20,255})$/u.test(token)) {
+      sendError(res, 400, '令牌格式不正确（应为 GitHub personal access token，ghp_/github_pat_ 开头）')
+      return
+    }
+    // 为什么不用 githubJson 校验：它内部会与 gh CLI 通道并行竞速（raceFirst2xx），而 gh 默认用
+    // 本机 keyring 里已有的凭据、**完全忽略我们传入的 token**。本机装了已登录的 gh 时，一个填错的
+    // token 也会因 gh 通道 2xx 而"验证成功"（2026-09-20 实测：本机 gh 登录 Noob-stupid，ghp_aaa…
+    // 能拿到 Noob-stupid），于是错误 token 被写进 github-auth.json，把用户真实登录态顶掉。
+    // githubJsonUserWithToken 的两条通道都只认用户给的这个 token（详见其注释）。
+    let login = null
+    try {
+      const me = await githubJsonUserWithToken(token)
+      login = typeof me?.login === 'string' && me.login !== '' ? me.login : null
+    } catch (error) {
+      // gh 通道的原始报错带 execFile 的 "Command failed: gh api …" 命令回显与多行 stderr，
+      // 压成一行再给用户看（原文只含状态与命令名，不含 token —— 我们从不把 token 传进命令行）
+      const message = (error instanceof Error ? error.message : String(error))
+        .replace(/Command failed:[^\n]*\n?/gu, '')
+        .replace(/\s+/gu, ' ')
+        .trim()
+      // 与"子包列表读不到 ≠ 不存在"同一课：**"没验成"不等于"令牌无效"**。通道全挂（证书/超时/DNS）
+      // 时报"令牌无效"会把用户往错的方向带（去重新生成 token），必须分开说；文案里仍然不带 token 本身。
+      const transport = /证书|certificate|超时|timeout|ECONN|ENOTFOUND|EAI_AGAIN|getaddrinfo|socket|network|aborted|未找到 gh CLI/iu.test(message)
+      sendError(res, 400, transport
+        ? `无法连接 GitHub 校验令牌（网络/证书问题，不代表令牌无效，可重试）：${message}`
+        : `令牌无效或权限不足：${message}`)
+      return
+    }
+    if (login === null) {
+      sendError(res, 400, '令牌无效或权限不足：GitHub 未返回登录名')
+      return
+    }
+    const authFile = join(dshHome(), 'github-auth.json')
+    try {
+      mkdirSync(dshHome(), { recursive: true })
+      // mode 只在新建时生效，所以再显式 chmod 一次：老文件可能是 0644（token 不该对同机其他用户可读）
+      await writeFile(authFile, `${JSON.stringify({ token, login }, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 })
+      try { chmodSync(authFile, 0o600) } catch {}
+    } catch (error) {
+      sendError(res, 500, `写入登录状态失败：${error instanceof Error ? error.message : String(error)}`)
+      return
+    }
+    sendJson(res, 200, { ok: true, login })
+    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.51",
+  "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",