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

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.52`**, 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.52`, 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.52` 等价**，只为可维护性；
 - **已验证**：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.52`，或本仓库 `main`。
 - 请多反馈问题

package/lib/client.js

@@ -203,6 +203,11 @@ window.__ModuleLoader__.load({
 			loadingDetails: "正在读取详情…",
 			githubLoggedIn: "已登录 GitHub：",
 			githubCornerOut: "未登录 GitHub",
+			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 +584,11 @@ window.__ModuleLoader__.load({
                     hubUpdateAvailable: "Download update",
                     cleanResiduals: "Clean residual backups",
 			githubCornerOut: "Not signed in to GitHub",
+			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 +1713,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; }
@@ -1892,6 +1906,16 @@ 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;
@@ -1919,6 +1943,26 @@ window.__ModuleLoader__.load({
 				);
 			}, []);
 			react.useEffect(() => { refresh(); }, [refresh]);
+			// 粘贴 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,17 +3683,14 @@ 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",
 							title: t("searchSourceTitle"),
 							"aria-label": t("searchSourceTitle"),
 							onClick: () => setSourceMenuOpen((v) => !v),
 						},
-							searchSource === "github"
-								? (state.status === "ready" && state.data.github && state.data.github.loggedIn
-									? t("githubLoggedIn") + (state.data.github.login ?? "unknown")
-									: t("githubCornerOut"))
-								: t("sourceOf") + ((searchSourcesList !== null ? searchSourcesList.find((s) => s.id === searchSource)?.name : undefined)
-									?? (searchSource === "gitee" ? "Gitee" : searchSource)),
+							// 这一颗是「搜索源」选择器：只报当前源名。登录态搬去右边的 GitHub 徽章
+							// （原来它顺手显示登录态，导致"未登录 GitHub"看着像徽章却点开的是源菜单）
+							t("sourceOf") + ((searchSourcesList !== null ? searchSourcesList.find((s) => s.id === searchSource)?.name : undefined)
+								?? (searchSource === "gitee" ? "Gitee" : searchSource)),
 							" ▾"),
 						sourceMenuOpen
 							? el("div", { className: styles.sourceMenu },
@@ -3669,6 +3710,35 @@ setMessage(t("failed") + "：" + (data?.reason ?? "未知"));
 										},
 									}, s.name)))
 							: 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

@@ -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,62 @@ 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}/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.52",
   "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",