dsh-plugin 1.0.0 → 1.1.1

package/src/client/styles/Modal.module.css

@@ -113,6 +113,28 @@
   padding: 6px 10px;
 }
 
+/* 可能需要命令行辅助的插件提示（webInstallable=false）：中性说明，仍允许尝试一键安装 */
+.cliOnlyHint {
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--hub-text-secondary);
+  background: var(--hub-bg-hover);
+  border-radius: 6px;
+  padding: 6px 10px;
+}
+
+/* 安装失败引导：红色醒目，提示复制命令到 dsh 终端手动执行（原生依赖构建脚本需人工放行） */
+.failedCopyHint {
+  font-size: 12px;
+  line-height: 18px;
+  font-weight: 500;
+  color: var(--hub-danger-text);
+  background: var(--hub-danger-tint);
+  border: 1px solid var(--hub-danger-border-soft);
+  border-radius: 6px;
+  padding: 6px 10px;
+}
+
 .modalRow {
   display: flex;
   align-items: baseline;
@@ -723,18 +745,29 @@
   padding-right: 2px;
 }
 
-/* 每条通知 = 一张独立卡片：左侧圆形状态徽标 + 右侧内容列，
-   徽标垂直居中于整条（失败条目下方还有修复/提 Issue 动作，比成功条目高） */
+/* 每条通知 = 一张独立卡片：纵向布局 —— 上(徽标+内容)行、下(时间戳)行；
+   徽标与文字在 .noticeRowMain 里水平垂直居中，时间戳独立一行不参与居中 */
 .noticeRow {
   display: flex;
-  align-items: center;
-  gap: 10px;
+  flex-direction: column;
+  align-items: stretch;
+  gap: 6px;
   padding: 10px 12px;
   border: 1px solid var(--hub-border-2);
   border-radius: 8px;
   background: var(--hub-bg-2);
 }
 
+/* 徽标 + 内容列一行：徽标与文字垂直居中（失败条目下方还有修复/提 Issue 动作，
+   徽标仍与该行文字对齐，而非被下方动作拉偏） */
+.noticeRowMain {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  width: 100%;
+  min-width: 0;
+}
+
 /* 圆形状态徽标：成功 = 绿底白勾；失败 = 红底白叉（用户要求的「红色圆形 + 白色图形」语义） */
 .noticeBadgeOk,
 .noticeBadgeFail {
@@ -867,7 +900,14 @@
   text-decoration: underline;
 }
 
-.failTime {
+/* 每条通知底部的完整时间戳：YYYY-MM-DD HH:mm:ss，靠右下角展示 */
+.noticeFoot {
+  display: flex;
+  justify-content: flex-end;
+  align-items: center;
+}
+
+.noticeTime {
   flex-shrink: 0;
   font-size: 11px;
   line-height: 16px;
@@ -875,6 +915,40 @@
   font-variant-numeric: tabular-nums;
 }
 
+/* 每条通知右侧的单条删除按钮：小号透明 X，靠右对齐，hover 变红提示可删，可单独移除该条 */
+.noticeRemove {
+  margin-left: auto;
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 22px;
+  height: 22px;
+  color: var(--hub-text-tertiary);
+  background: transparent;
+  border: none;
+  border-radius: 5px;
+  cursor: pointer;
+  user-select: none;
+  transition: color 120ms ease, background 120ms ease;
+}
+
+.noticeRemove:hover {
+  color: var(--hub-danger-text);
+  background: var(--hub-danger-tint);
+}
+
+/* 成功通知卡片（时间戳已并入头部行）：删除按钮不再用 auto margin 顶到最右，
+   由时间戳的 margin-left:auto 把「时间 + 删除」整体推到行尾 —— 图标文字与
+   时间垂直居中，卡片只有一行内容，整体居中不顶头 */
+.noticeRowOk .noticeRemove {
+  margin-left: 0;
+}
+
+.noticeRowOk .noticeTime {
+  margin-left: auto;
+}
+
 /* 记录内的复制按钮：纯灰文字、无边框，低调隐蔽，点击即可复制该条完整错误日志 */
 .failCopy {
   flex-shrink: 0;
@@ -963,3 +1037,244 @@
   border: 1px solid var(--hub-warning-border);
   border-radius: 6px;
 }
+
+/* —— 「关注我们」弹窗 —— */
+
+/* 关注弹窗：比普通弹窗略宽，给 Markdown 介绍 + 反馈群二维码留出阅读空间；
+   max-width 覆盖普通弹窗的 calc(100vw - 32px)，窄屏时仍不贴边 */
+.aboutModal {
+  width: 460px;
+  max-width: calc(100vw - 48px);
+}
+
+/* Markdown 内容区：固定最大高度内滚动，介绍文字 + 二维码不把弹窗撑爆；
+   样式沿用 hubUpdateNotes 的 12px 基线，仅二维码图片单独约束最大尺寸 */
+.aboutContent {
+  flex: 1 1 auto;
+  min-height: 0;
+  max-height: 340px;
+  overflow-y: auto;
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--hub-text-secondary);
+  background: var(--hub-bg-2);
+  border: 1px solid var(--hub-border-2);
+  border-radius: 8px;
+  padding: 10px 12px;
+}
+
+.aboutContent > *:first-child {
+  margin-top: 0;
+}
+
+.aboutContent > *:last-child {
+  margin-bottom: 0;
+}
+
+.aboutContent h2,
+.aboutContent h3,
+.aboutContent h4,
+.aboutContent h5 {
+  margin: 10px 0 4px;
+  font-size: 13px;
+  font-weight: 600;
+  line-height: 20px;
+  color: var(--hub-text-primary);
+}
+
+.aboutContent h2 {
+  font-size: 14px;
+}
+
+.aboutContent p {
+  margin: 4px 0;
+}
+
+.aboutContent ul,
+.aboutContent ol {
+  margin: 4px 0;
+  padding-left: 18px;
+}
+
+.aboutContent li {
+  margin: 2px 0;
+}
+
+.aboutContent code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: 11px;
+  background: var(--hub-bg-hover);
+  border-radius: 4px;
+  padding: 1px 4px;
+  color: var(--hub-text-primary);
+}
+
+.aboutContent pre {
+  margin: 6px 0;
+  background: var(--hub-bg-1);
+  border: 1px solid var(--hub-border-2);
+  border-radius: 6px;
+  padding: 8px 10px;
+  overflow-x: auto;
+}
+
+.aboutContent pre code {
+  background: none;
+  padding: 0;
+  border-radius: 0;
+}
+
+.aboutContent blockquote {
+  margin: 6px 0;
+  padding: 2px 10px;
+  border-left: 3px solid var(--hub-brand);
+  background: var(--hub-bg-hover);
+  border-radius: 0 6px 6px 0;
+  color: var(--hub-text-tertiary);
+}
+
+.aboutContent a {
+  color: var(--hub-brand);
+  text-decoration: none;
+}
+
+.aboutContent a:hover {
+  color: var(--hub-brand-hover);
+  text-decoration: underline;
+}
+
+/* 内容里的图片（反馈群二维码）：居中、最大高度受控，不撑破弹窗：
+   当图片自身更窄时收缩到实际宽度（不强行拉满铺平） */
+.aboutContent img {
+  display: block;
+  margin: 8px auto;
+  max-width: 100%;
+  max-height: 220px;
+  border-radius: 8px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);
+}
+
+/* 更新时间小字：弱化展示在内容区下方 */
+.aboutMeta {
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--hub-text-tertiary);
+}
+
+/* —— Hub 自我更新说明弹窗 —— */
+
+/* 更新说明弹窗：比普通弹窗略宽，给变更记录留出阅读空间 */
+.hubUpdateModal {
+  width: 520px;
+  max-width: calc(100vw - 48px);
+}
+
+/* 版本 / 发布时间元信息行：小号标签并排，弱化但可读 */
+.hubUpdateMeta {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 4px 14px;
+  font-size: 12px;
+  line-height: 18px;
+}
+
+.hubUpdateMetaItem {
+  color: var(--hub-text-tertiary);
+}
+
+/* Markdown 变更记录区：固定最大高度内滚动，长更新记录不把弹窗撑爆；
+   子元素（标题/列表/代码块/引用）继承 12px 基线，仅标题加大加粗 */
+.hubUpdateNotes {
+  flex: 1 1 auto;
+  min-height: 0;
+  max-height: 300px;
+  overflow-y: auto;
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--hub-text-secondary);
+  background: var(--hub-bg-2);
+  border: 1px solid var(--hub-border-2);
+  border-radius: 8px;
+  padding: 10px 12px;
+}
+
+.hubUpdateNotes > *:first-child {
+  margin-top: 0;
+}
+
+.hubUpdateNotes > *:last-child {
+  margin-bottom: 0;
+}
+
+.hubUpdateNotes h2,
+.hubUpdateNotes h3,
+.hubUpdateNotes h4,
+.hubUpdateNotes h5 {
+  margin: 10px 0 4px;
+  font-size: 13px;
+  font-weight: 600;
+  line-height: 20px;
+  color: var(--hub-text-primary);
+}
+
+.hubUpdateNotes h2 {
+  font-size: 14px;
+}
+
+.hubUpdateNotes p {
+  margin: 4px 0;
+}
+
+.hubUpdateNotes ul,
+.hubUpdateNotes ol {
+  margin: 4px 0;
+  padding-left: 18px;
+}
+
+.hubUpdateNotes li {
+  margin: 2px 0;
+}
+
+.hubUpdateNotes code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: 11px;
+  background: var(--hub-bg-hover);
+  border-radius: 4px;
+  padding: 1px 4px;
+  color: var(--hub-text-primary);
+}
+
+.hubUpdateNotes pre {
+  margin: 6px 0;
+  background: var(--hub-bg-1);
+  border: 1px solid var(--hub-border-2);
+  border-radius: 6px;
+  padding: 8px 10px;
+  overflow-x: auto;
+}
+
+.hubUpdateNotes pre code {
+  background: none;
+  padding: 0;
+  border-radius: 0;
+}
+
+.hubUpdateNotes blockquote {
+  margin: 6px 0;
+  padding: 2px 10px;
+  border-left: 3px solid var(--hub-brand);
+  background: var(--hub-bg-hover);
+  border-radius: 0 6px 6px 0;
+  color: var(--hub-text-tertiary);
+}
+
+.hubUpdateNotes a {
+  color: var(--hub-brand);
+  text-decoration: none;
+}
+
+.hubUpdateNotes a:hover {
+  color: var(--hub-brand-hover);
+  text-decoration: underline;
+}

package/src/client/styles/tokens.module.css

@@ -53,9 +53,9 @@ body[data-ds-dark-theme] {
   --hub-btn-hover: var(--dsw-alias-button-primary-hover, #43454a);
 
   /* success */
-  --hub-success: var(--dsw-alias-state-success-primary, #1a7f37);
-  --hub-success-tint: rgba(34, 197, 94, 0.14);
-  --hub-success-border: var(--dsw-alias-state-success-secondary, rgba(26, 127, 55, 0.3));
+  --hub-success: #16a34a;
+  --hub-success-tint: rgba(22, 163, 74, 0.12);
+  --hub-success-border: rgba(22, 163, 74, 0.3);
 
   /* warning (amber) */
   --hub-warn: var(--dsw-alias-state-warn-primary, #b8860b);
@@ -83,4 +83,9 @@ body[data-ds-dark-theme] {
 /* 暗色下的计数胶囊底色：白半透明，深色底上更可辨 */
 body[data-ds-dark-theme] {
   --hub-bg-btn: rgba(255, 255, 255, 0.12);
+
+  /* 暗色下的成功绿：提亮一档，对勾在深底上清晰且不刺眼 */
+  --hub-success: #22c55e;
+  --hub-success-tint: rgba(34, 197, 94, 0.16);
+  --hub-success-border: rgba(34, 197, 94, 0.35);
 }

package/src/client/types.ts

@@ -46,7 +46,9 @@ export interface HubPlugin {
   topics?: string[]
   features?: string[]
   description?: string
-  source?: { repo?: string }
+  source?: { repo?: string; npmPackage?: string }
+  /** 能否网页一键安装：false = 仅支持命令行/git/本地构建安装（缺省视为 true 可安装） */
+  install?: { webInstallable?: boolean }
   compatibility?: { status?: string }
   dates?: { repoUpdatedAt?: string; addedAt?: string }
   stats?: { stargazers_count?: number; forks_count?: number }

package/src/server/http/routes.ts

@@ -10,7 +10,8 @@ import { homedir, release } from 'node:os'
 import { dirname, join, resolve } from 'node:path'
 import { spawn } from 'node:child_process'
 import { activeTask, cancelTask, dumpLoaderEntries, getTask, githubTarget, hasQueuedTarget, listPendingRestarts, readProfileArg, startPluginMutation, validPackageName, type LoaderHandle } from '../services/install.ts'
-import { recordInstalledVersion, readInstalledVersions, removeInstalledVersion } from '../services/installed-versions.ts'
+import { recordInstalledVersion, recordResolvedNpmPackage, readInstalledVersions, removeInstalledVersion } from '../services/installed-versions.ts'
+import { resolveNpmPackage } from '../services/npm-resolve.ts'
 import { preflightTarget } from '../services/preflight.ts'
 
 export interface WebRoute {
@@ -172,17 +173,44 @@ export function mountPluginHubRoutes(webServer: WebServerService, profile: strin
           const rawRepo = typeof body === 'object' && body !== null && typeof (body as { repo?: unknown }).repo === 'string'
             ? (body as { repo: string }).repo.trim()
             : ''
+          // 前端决策的展示用仓库名（owner/repo）：npm 安装时 body.repo 是包名，display 用于
+          // 待重启行 / 任务恢复时展示仓库名，保证用户无感知（安装通道变化不改变所见目标）
+          const displayRepo = typeof body === 'object' && body !== null && typeof (body as { display?: unknown }).display === 'string'
+            ? (body as { display: string }).display.trim()
+            : rawRepo
           // 目标语法两态：owner/repo → github 源（走装前预检）；npm 包名（@scope/name 或 name）→ 信任 registry 直接安装
           const repoTarget = githubTarget(rawRepo)
-          const target = repoTarget ?? (repoTarget === null && validPackageName(rawRepo) ? rawRepo : null)
+          let target: string | null = repoTarget ?? (repoTarget === null && validPackageName(rawRepo) ? rawRepo : null)
           if (target === null) {
             sendJson(response, 400, { error: 'unsupported install target' })
             return
           }
+          // npm 优先：git 目标先反查该仓库的官方 npm 包，命中则改走 npm 通道。
+          // git 分发常缺构建产物/子模块导致 prepare 必败，而 npm 包是作者发布的
+          // 完整产物，成功率高得多；未命中或查询失败保留 github 直装（不阻塞安装，
+          // 预检仍会兜底拦截 git 分发缺入口文件的情况）。通用机制，不针对具体插件。
+          // 反查本身计入「已尝试的安装方式」：组织 scope 与 GitHub 用户名不一致时仅凭
+          // 仓库名猜不到包名，失败提 Issue 时作者看到我们查过的命令就能直接指认正确包名。
+          const attempts: string[] = []
+          if (repoTarget !== null) {
+            const npmName = await resolveNpmPackage(rawRepo)
+            if (npmName !== null) {
+              target = npmName
+              attempts.push(`npm registry search: \`npm search repository:${rawRepo}\` → found \`${npmName}\``)
+              // 持久化 repo → npm 包名映射：目录数据未下发 npmPackage（组织 scope 与 GitHub
+              // 用户名不一致）时，客户端仍能通过 /installed 的 versions 把依赖 key 匹配回仓库，
+              // 列表立即显示「已安装」，避免安装成功后仍显示可安装
+              recordResolvedNpmPackage(profile, rawRepo, npmName)
+            } else {
+              attempts.push(`npm registry search: \`npm search repository:${rawRepo}\` → no matching package found (falling back to git install)`)
+            }
+          }
           // 重复安装防护：非更新请求命中已安装目标时直接拒绝，不重复跑 CLI
           // （否则 CLI 会因「已存在」失败，且用户看到的是莫名其妙的报错）；
-          // 更新请求（mode: 'update'）放行，CLI 的 add 对已存在依赖是 pnpm 原位覆盖重装
-          const already = installedByRepo(readInstalled(profile), target)
+          // 更新请求（mode: 'update'）放行，CLI 的 add 对已存在依赖是 pnpm 原位覆盖重装。
+          // 命中判定双通道：npm 包名按 dependencies 键直接命中，github: 目标按 spec 值匹配。
+          const installed = readInstalled(profile)
+          const already = installedByRepo(installed, target) ?? (installed[target] !== undefined ? target : null)
           if (already !== null && mode !== 'update') {
             sendJson(response, 409, { error: `already installed: ${already}` })
             return
@@ -194,13 +222,16 @@ export function mountPluginHubRoutes(webServer: WebServerService, profile: strin
           }
           // 安装前预检：仅新安装走预检（github 源分发改入口文件缺失时直接拦截）。
           // 更新是已信任目标的覆盖重装，跳过预检避免重复下载 tarball。
-          // 只支持官方默认安装方式（dsh plugin add github:owner/repo），不做任何 npm 兜底降级；
-          // [packaging] 前缀供客户端归类为「插件未适配官方默认安装方式」并引导去仓库提 Issue
+          // npm 包信任 registry 直接放行；github 源拦截时标记 [packaging] 前缀，
+          // 供客户端归类为「插件分发不完整」并引导去仓库提 Issue
           if (already === null) {
             const preflight = await preflightTarget(target)
             if (!preflight.ok) {
+              // 预检拦截（git 分发缺入口文件）：同步 400 返回，附上已尝试的安装方式，
+              // 客户端失败弹窗提 Issue 时一并贴给作者
               sendJson(response, 400, {
-                error: `[packaging] ${target}: does not support the official default install method — the git distribution lacks build output (the entry file ${preflight.missing ?? '?'} declared in package.json is not in the repository). Report to the author.`,
+                error: `[packaging] ${target}: plugin distribution is incomplete — the entry file ${preflight.missing ?? '?'} declared in package.json is not present in the git distribution (build output not committed). Report to the author.`,
+                attempts,
               })
               return
             }
@@ -217,6 +248,10 @@ export function mountPluginHubRoutes(webServer: WebServerService, profile: strin
             action: 'add',
             profile,
             target,
+            // npm 安装时 target 是包名：displayTarget 固定展示仓库名，待重启行/前端恢复不受通道变化影响
+            displayTarget: githubTarget(displayRepo) ?? undefined,
+            // 已尝试的安装方式（npm 反查）：实际执行命令由 spawn 时追加，失败 issue 一并展示
+            attempts,
             timeoutMs: COMMAND_TIMEOUT_MS,
             env: { ...process.env, CI: 'true' },
           })

package/src/server/services/install-types.ts

@@ -13,6 +13,12 @@ export interface InstallTask {
   id: number
   /** 操作目标：`github:<owner>/<repo>`（安装）或 npm 包名（卸载），冲突/恢复时需要展示给用户 */
   target: string
+  /** 展示用目标（owner/repo）：npm 安装时 target 是包名，前端恢复用此字段显示仓库名，保持用户无感知 */
+  displayTarget?: string
+  /** 尝试过的安装方式（npm registry 反查 + 实际执行的 CLI 命令，按先后顺序）：
+   *  失败提 Issue 时如实贴给作者，作者据此反推正确的 npm 包名（组织 scope 与 GitHub 用户名不一致时
+   *  仅凭仓库名猜不到，作者看到我们查过/试过的命令就能直接指认）。 */
+  attempts: string[]
   action: 'add' | 'remove'
   /** 队列语义：pending 排队中 / running 执行中 / done / failed / cancelled（用户取消） */
   status: 'pending' | 'running' | 'done' | 'failed' | 'cancelled'
@@ -22,6 +28,8 @@ export interface InstallTask {
   progress: number
   /** Newest output lines first (consumer shows the tail). */
   lines: string[]
+  /** 完成后是否仍需宿主重启才生效：卸载时 loader 已即时移除 → false；否则 true（弹窗据此给重启选项） */
+  needsRestart: boolean
 }
 
 /** 子进程启动参数（复用宿主 dsh 入口，或回退到 PATH 上的 `dsh`）。 */

package/src/server/services/installed-versions.ts

@@ -27,6 +27,9 @@ export interface InstalledVersionRecord {
   /** 安装时的仓库最近更新时间（ISO，GitHub pushed_at）；无 release 仓库的更新依据 */
   updatedAt: string
   installedAt: string
+  /** npm 优先通道反查命中的官方 npm 包名（repo → 包名映射）：目录数据可能未下发
+   *  npmPackage（组织 scope 与 GitHub 用户名不一致），客户端据此把依赖 key 匹配回仓库 */
+  npmPackage?: string
 }
 
 export type InstalledVersionTable = Record<string, InstalledVersionRecord>
@@ -47,7 +50,23 @@ export function readInstalledVersions(profile: string): InstalledVersionTable {
 /** Record the catalog signals (version + repo updated time) present at install time for one repo. */
 export function recordInstalledVersion(profile: string, repo: string, version: string, updatedAt: string): void {
   const table = readInstalledVersions(profile)
-  table[repo.toLowerCase()] = { version, updatedAt, installedAt: new Date().toISOString() }
+  const key = repo.toLowerCase()
+  // 合并写入：保留已记录的 npmPackage（npm 优先通道的 repo → 包名映射），
+  // 客户端同步版本信号时不能把它覆盖掉
+  table[key] = { ...table[key], version, updatedAt, installedAt: new Date().toISOString() }
+  writeVersions(profile, table)
+}
+
+/**
+ * Record the npm package name resolved for a repo (npm-first install channel).
+ * Called at `/install` time so the mapping exists even before the task finishes;
+ * harmless when the repo is not (yet) installed — the client only treats a repo
+ * as installed when its dependency key actually exists.
+ */
+export function recordResolvedNpmPackage(profile: string, repo: string, npmPackage: string): void {
+  const table = readInstalledVersions(profile)
+  const key = repo.toLowerCase()
+  table[key] = { ...table[key], npmPackage }
   writeVersions(profile, table)
 }
 

package/src/server/services/loader.ts

@@ -60,13 +60,15 @@ function nameMatches(entryName: string | undefined, target: string): boolean {
 }
 
 /**
- * 卸载成功后从运行中 loader 停用指定包的条目，使卸载立即生效（刷新页面不再
- * 加载已卸载的 client bundle，也无需重启）。做法：按 name 扫描
+ * 卸载成功后从运行中 loader 停用指定包的条目。做法：按 name 扫描
  * `loader.entries()`（含嵌套子树），对每个匹配条目
  * `entry.update({ disabled: true })` 做 live-disable —— fiber 被 dispose，
  * client-modules 对账后不再把它写进 `__DSH_BOOT__`，页面刷新即恢复。
- * 返回 true = 无需重启（条目已停用，或本就没加载过）；false = 未能停用，
- * 需登记「待重启清理」兜底。宿主关键包（@deepseek-ai/* 与本插件自身）一律跳过。
+ * 返回 true = 无需重启（仅当宿主从未加载过它：磁盘已干净）；
+ * 其余一律 false = 需要重启：要么 disable 失败需「待重启清理」兜底，
+ * 要么 disable 成功但该插件曾在 loader 中存活——带 UI 的插件（侧边栏面板等
+ * 宿主启动时渲染的槽位）disable 后不会主动摘除，不重启面板一直残留。
+ * 宿主关键包（@deepseek-ai/* 与本插件自身）一律跳过。
  */
 export async function removeLoadedEntry(loader: LoaderHandle, name: string): Promise<boolean> {
   if (name === 'dsh-plugin' || name.startsWith('@deepseek-ai/')) return false
@@ -95,8 +97,13 @@ export async function removeLoadedEntry(loader: LoaderHandle, name: string): Pro
     if (!found) {
       // 运行中 loader 无该条目：宿主从未加载过它（装完未重启），磁盘已干净，无需重启
       console.log(`[hub-uninstall] no live entry for ${name}; nothing to disable`)
+      return true
     }
-    return true
+    // 找到并停用了 live entry：逻辑层已卸载（刷新页面不再加载其 client bundle），
+    // 但带 UI 的插件（侧边栏面板等）是宿主启动时渲染的槽位，disable 不会主动摘除，
+    // 不重启面板会一直残留 → 返回「需要重启」，弹窗给出「立即重启」，面板立即消失
+    console.log(`[hub-uninstall] disabled live entry for ${name}; UI may persist until restart`)
+    return false
   })()
   const result = await Promise.race([
     removal.catch((error) => {

package/src/server/services/npm-resolve.ts

@@ -0,0 +1,67 @@
+/**
+ * npm 包反查：git 分发不完整（缺构建产物/子模块）导致安装失败时，用 npm
+ * registry 的搜索接口按 repository 地址反查该仓库对应的官方 npm 包。
+ *
+ * 这是通用机制，不针对任何具体插件：只要作者发布了 repository 指向该
+ * GitHub 仓库的 npm 包（scope 名与 GitHub 用户名是否一致无所谓），就能命中，
+ * 从而把「git 直装必败」的插件切换到 npm 通道安装。命中结果带内存缓存，
+ * 避免同一会话内重复查询 registry。
+ */
+import { get } from 'node:https'
+
+/** 反查缓存：repo 小写 → npm 包名（null 表示已确认无对应 npm 包）。 */
+const cache = new Map<string, string | null>()
+
+/** 单次 registry 查询超时（ms）：慢网络下失败返回 null，不阻塞安装流程。 */
+const REQUEST_TIMEOUT_MS = 8000
+
+/**
+ * 反查 repo（`owner/repo`）对应的官方 npm 包名；未命中、网络异常或超时返回 null。
+ * 返回 null 不代表仓库一定没有 npm 包，只代表本次未能确认 —— 调用方应保留
+ * 原有错误路径，反查只是额外的一次尝试。
+ */
+export function resolveNpmPackage(repo: string): Promise<string | null> {
+  const key = repo.toLowerCase()
+  if (cache.has(key)) return Promise.resolve(cache.get(key) ?? null)
+  const name = searchRepo(repo)
+  name.then((found) => cache.set(key, found)).catch(() => cache.set(key, null))
+  return name
+}
+
+/** 用 npm search 接口按 repository 地址反查，并做铁证校验（包元数据必须指向该仓库）。 */
+function searchRepo(repo: string): Promise<string | null> {
+  const [owner, name] = repo.split('/')
+  if (owner === undefined || name === undefined || name === '') return Promise.resolve(null)
+  const url = `https://registry.npmjs.org/-/v1/search?text=${encodeURIComponent(`repository:${owner}/${name}`)}&size=10`
+  return new Promise((resolve) => {
+    const req = get(url, { timeout: REQUEST_TIMEOUT_MS }, (res) => {
+      if (res.statusCode !== 200) {
+        res.resume()
+        resolve(null)
+        return
+      }
+      let body = ''
+      res.on('data', (chunk: Buffer) => { body += chunk.toString() })
+      res.on('end', () => {
+        try {
+          const data = JSON.parse(body) as { objects?: Array<{ package?: { name?: unknown; links?: { repository?: unknown }; repository?: { url?: unknown } } }> }
+          const needle = `github.com/${owner}/${name}`.toLowerCase()
+          for (const obj of data.objects ?? []) {
+            const pkg = obj.package
+            if (typeof pkg?.name !== 'string' || pkg.name === '') continue
+            const repoUrl = String(pkg.repository?.url ?? pkg.links?.repository ?? '')
+            if (repoUrl.toLowerCase().includes(needle)) {
+              resolve(pkg.name)
+              return
+            }
+          }
+          resolve(null)
+        } catch {
+          resolve(null)
+        }
+      })
+    })
+    req.on('timeout', () => req.destroy())
+    req.on('error', () => resolve(null))
+  })
+}