dsh-plugin 1.0.0 → 1.1.0

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

@@ -723,18 +723,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 +878,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 +893,29 @@
   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);
+}
+
 /* 记录内的复制按钮：纯灰文字、无边框，低调隐蔽，点击即可复制该条完整错误日志 */
 .failCopy {
   flex-shrink: 0;

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,7 @@ export interface HubPlugin {
   topics?: string[]
   features?: string[]
   description?: string
-  source?: { repo?: string }
+  source?: { repo?: string; npmPackage?: string }
   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'

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/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))
+  })
+}

package/src/server/services/task-queue.ts

@@ -36,20 +36,25 @@ export interface ActiveTaskInfo {
   status: 'pending' | 'running'
   progress: number
   lines: string[]
+  /** 尝试过的安装方式（npm 反查 + 实际执行命令）：失败时前端 issue 预填需要 */
+  attempts: string[]
 }
 
 /** All non-terminal tasks in queue order (running first, then pending). Lets the client resume a queue after a page reload. */
 export function activeTask(): ActiveTaskInfo[] {
   const found: ActiveTaskInfo[] = []
+  // 展示目标用 displayTarget（owner/repo）：安装 target 可能被服务端切成 npm 包名
+  // （npm 反查命中），队列恢复/待重启展示对用户保持仓库名无感知
+  const show = (task: InstallTask): string => task.displayTarget ?? task.target
   for (const item of queue) {
     const task = item.task
     if (task.status === 'pending') {
-      found.push({ id: task.id, target: task.target, action: task.action, status: 'pending', progress: task.progress, lines: task.lines.slice(0, MAX_TASK_LINES) })
+      found.push({ id: task.id, target: show(task), action: task.action, status: 'pending', progress: task.progress, lines: task.lines.slice(0, MAX_TASK_LINES), attempts: task.attempts })
     }
   }
   tasks.forEach((task) => {
     if (task.status === 'running') {
-      found.unshift({ id: task.id, target: task.target, action: task.action, status: 'running', progress: task.progress, lines: task.lines.slice(0, MAX_TASK_LINES) })
+      found.unshift({ id: task.id, target: show(task), action: task.action, status: 'running', progress: task.progress, lines: task.lines.slice(0, MAX_TASK_LINES), attempts: task.attempts })
     }
   })
   return found
@@ -162,8 +167,10 @@ export function startPluginMutation(options: {
   displayTarget?: string
   /** 运行中 loader：卸载成功后主动移除条目、立即生效（缺失时卸载仍需重启清理） */
   uninstallLoader?: LoaderHandle
+  /** 入队前已尝试的安装方式（npm registry 反查等）：失败提 Issue 时如实展示；实际执行的命令由 spawn 时追加 */
+  attempts?: string[]
 }): InstallTask {
-  const task: InstallTask = { id: nextTaskId, target: options.target, action: options.action, status: 'pending', timedOut: false, exitCode: null, progress: 0, lines: [] }
+  const task: InstallTask = { id: nextTaskId, target: options.target, displayTarget: options.displayTarget, action: options.action, status: 'pending', timedOut: false, exitCode: null, progress: 0, lines: [], attempts: options.attempts ?? [] }
   nextTaskId = nextTaskId >= Number.MAX_SAFE_INTEGER ? 1 : nextTaskId + 1
   tasks.set(task.id, task)
   if (tasks.size > MAX_TASKS) {
@@ -216,6 +223,12 @@ function spawnMutation(options: {
   const { action, profile, target, timeoutMs = 5 * 60 * 1000, env, task, displayTarget, uninstallLoader } = options
   const invocation = cliInvocation()
   const args = [...invocation.prefixArgs, 'plugin', '--profile', profile, action, target]
+  // 记录实际执行的命令（npm 通道显示包名，git 通道显示 github: 源）：失败提 Issue 时
+  // 「已尝试的安装方式」如实展示完整命令链，作者一眼看清我们跑过什么
+  const executed = `dsh plugin --profile ${profile} ${action} ${target}`
+  if (task && !task.attempts.includes(executed)) {
+    task.attempts.push(executed)
+  }
   return new Promise((resolvePromise) => {
     let stdout = ''
     let stderr = ''
@@ -393,12 +406,24 @@ export function verifyInstalledEntry(profile: string, target: string): { name: s
   }
 }
 
+/** 从 pnpm `Ignored build scripts:` 提示行解析被拦截的构建脚本 key（name@version，逗号分隔）。 */
+function ignoredBuildKeys(output: string): string[] {
+  const m = /Ignored build scripts:\s*(.+)/i.exec(output)
+  if (m === null) return []
+  return m[1]
+    .split(',')
+    .map((s) => s.trim())
+    .filter((s) => s !== '')
+}
+
 /**
- * Run a plugin mutation with one recovery path: when `add` fails because a
- * git-hosted package's `prepare` script is blocked by pnpm's allowBuilds
- * gate (`ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`), read the exact allowlist
- * key pnpm printed, write it into the profile's pnpm-workspace.yaml, and
- * retry once. Other failures fall through to the single-spawn result.
+ * Run a plugin mutation with one recovery path: when `add` fails because
+ * pnpm's allowBuilds gate blocks a build script — either the git-hosted
+ * package's own `prepare` (`ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED`, key from
+ * the printed key@url hint) or a dependency's native build
+ * (`ERR_PNPM_IGNORED_BUILDS`, key = the listed name@version) — write the
+ * exact keys into the profile's pnpm-workspace.yaml and retry once.
+ * Other failures fall through to the single-spawn result.
  */
 export async function runPluginMutation(options: {
   action: 'add' | 'remove'
@@ -415,6 +440,7 @@ export async function runPluginMutation(options: {
   const result = await spawnMutation(options)
   if (options.action === 'add' && result.exitCode !== 0 && !result.timedOut) {
     const output = `${result.stderr}\n${result.stdout}`
+    // git 源：pnpm 打印的 key@url 提示
     if (output.includes('ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED')) {
       const key = parseAllowBuildsKey(output)
       if (key !== null) {
@@ -429,6 +455,22 @@ export async function runPluginMutation(options: {
         return spawnMutation(options)
       }
     }
+    // 依赖原生模块/构建脚本被 pnpm v11 拦截（ERR_PNPM_IGNORED_BUILDS）：git 与 npm 源都会出现。
+    // allowBuilds 的 key 是输出里列出的 name@version（如 node-pty@1.1.0），逐个放行后重试一次；
+    // 输出解析不到时回退用目标名（插件自身构建脚本被拦的 npm 场景）。
+    if (output.includes('ERR_PNPM_IGNORED_BUILDS')) {
+      const keys = ignoredBuildKeys(output)
+      if (keys.length === 0 && !options.target.startsWith('github:')) keys.push(options.target)
+      if (keys.length > 0) {
+        if (options.task) {
+          options.task.status = 'running'
+          options.task.exitCode = null
+          pushLine(options.task, `[allow build] ${keys.join(', ')}`)
+        }
+        for (const key of keys) addAllowBuildsKey(options.profile, key)
+        return spawnMutation(options)
+      }
+    }
   }
   // pnpm 安装本身成功，但目标包入口文件缺失（git 分发缺构建产物）→ 判为失败：
   // 撤销刚登记的待重启，避免用户重启时宿主加载残缺包直接崩溃