dsh-plugin 1.6.12 → 2.0.1

package/src/client/components/modals/NotificationsModal.tsx

@@ -3,15 +3,11 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Notification-center dialog: a persistent log of every settled install /
- * remove task — successes and failures alike.
+ * 通知中心弹窗：每个已结算的安装/卸载任务（成功与失败）的持久化清单。
  *
- * Records are written to localStorage at settle time (see logic/failures.ts),
- * so a result is never lost even when the dialog was dismissed or the user
- * was away. Each entry carries a circular status badge (green check for
- * success, red cross for failure) with white glyph and message text;
- * failures keep their copy / fix / file-an-issue actions. Opened from the
- * header entry button (after the Settings tab).
+ * 记录在结算时写入 localStorage（见 logic/failures.ts），即使弹窗被关闭或用户离开，
+ * 结果也不会丢失。每条带圆形状态徽标（成功绿勾、失败红叉，白色图形）与消息文本；
+ * 失败项保留复制/修复/提 Issue 动作。由头部入口按钮（「设置」tab 之后）打开。
  */
 import { createElement as h, useState } from 'react'
 import type { MouseEvent } from 'react'
@@ -206,14 +202,19 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                       ? (isUpdate
                         ? h('span', { className: styles.failRepo, title: r.repo }, r.repo)
                         : shownRepo
-                          ? h('a', {
-                            className: styles.failRepo,
-                            // 跳转到官网详情页（含插件收录信息），不在通知弹窗直接跳 GitHub
-                            href: pluginSiteUrl(shownRepo),
-                            target: '_blank',
-                            rel: 'noopener noreferrer',
-                            title: shownRepo,
-                          }, shownRepo)
+                          ? (() => {
+                            const url = pluginSiteUrl(shownRepo)
+                            return h('a', {
+                              className: styles.failRepo,
+                              // 跳官网「插件详情」页；文字里直接给出目标地址（去掉协议）
+                              href: url,
+                              target: '_blank',
+                              rel: 'noopener noreferrer',
+                              title: url,
+                            },
+                              h('span', { className: styles.failRepoLabel }, `${t('detailTitle')} · `),
+                              h('span', { className: styles.failRepoUrl }, url.replace(/^https?:\/\//, '').split('?')[0]))
+                          })()
                           // 反查不到仓库身份（如命令行安装的裸 npm 包名）：回退显示记录里的原始值，
                           // 保证通知永不只剩一句「安装/更新成功」没有名字 —— 只是不给官网外链（查不到不敢乱跳）
                           : h('span', { className: styles.failRepo, title: r.repo }, r.repo))
@@ -251,6 +252,16 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                       onClick: (e: MouseEvent<HTMLButtonElement>) => { e.stopPropagation(); setConfirmRemoveId(r.id) },
                     }, h(CloseIcon)),
                   ),
+                  // 统一失败卡片头部：报错类型 + 一句话原因（具体指引在下面的分支里）
+                  !r.ok && (() => {
+                    const k = classifyFailure(r.message)
+                    return h('div', null, [
+                      h('div', { className: styles.failKindTitle }, t(`failKind_${k}`, k === 'hostIncompatible'
+                        ? { version: /incompatible with dsh\s+([^\s:;,]+)/i.exec(r.message ?? '')?.[1] ?? '' }
+                        : undefined)),
+                      k === 'hostIncompatible' ? null : h('div', { className: styles.failReason }, t(`failReason_${k}`)),
+                    ])
+                  })(),
                   // 每条失败记录是一个独立卡片：头部（状态/仓库/时间/复制完整日志）→ 修复或提 Issue 动作。
                   // 卡片不展示错误日志预览，完整日志靠「复制完整日志」按钮带走，避免每条卡片被日志撑高
                   !r.ok && (() => {
@@ -334,9 +345,25 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         }, t('failIssueBig')) : null,
                       ])
                     }
+                    if (kind === 'hostIncompatible') {
+                      // 宿主版本门禁：插件声明的兼容范围不含当前 dsh 版本，安装前就被拒绝。
+                      // 作者能修（把该版本加进兼容清单），故引导到作者仓库；同时说明本地可临时授权
+                      const version = /incompatible with dsh\s+([^\s:;,]+)/i.exec(r.message ?? '')?.[1] ?? ''
+                      return h('div', null, [
+                        h('div', { className: styles.failReason }, t('failHostIncompatibleReason', { version })),
+                        h('div', { className: styles.failPrepareHint }, t('failHostIncompatibleHint')),
+                        r.repo && shownRepo ? h('a', {
+                          className: styles.failBigIssue,
+                          href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts, action),
+                          target: '_blank',
+                          rel: 'noopener noreferrer',
+                          title: t('failIssueHint'),
+                        }, t('failIssueBig')) : null,
+                      ])
+                    }
                     if (kind === 'registryVersionStale') {
                       // 要装的版本在「实际执行安装的那个源」里查不到（ERR_PNPM_NO_MATCHING_VERSION / ETARGET）：
-                      // 常见于镜像滞后 —— 反查包名走设置里的 npmRegistry，实际安装沿用本机 ~/.npmrc 的源；
+                      // 常见于镜像滞后 —— 实际安装沿用本机 ~/.npmrc 的源；
                       // 也可能只是版本号写错。与插件作者无关 —— 给对齐源 / 显式走官方源 / 离线包指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failRegistryVersionStaleHint'))
                     }
@@ -367,7 +394,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                       return h('div', { className: styles.failPrepareHint }, t('failOriginRejectedHint', { profile: env?.profile ?? '<profile>' }))
                     }
                     if (kind === 'network') {
-                      // 安装前预检 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：
+                      // 安装前网络探测 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：
                       // 是本机网络不通或代理有问题，不是插件问题 —— 提示检查网络 + 直达「系统诊断」，
                       // 不引导提 Issue
                       return h('div', null, [
@@ -384,7 +411,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                       ])
                     }
                     if (kind === 'pluginPrepare') {
-                      // [packaging]（预检/装后校验拦截：git 分发缺产物）与
+                      // [packaging]（装后校验拦截：分发缺产物）与
                       // prepare 构建脚本实际执行失败：唯一确有证据的插件打包分发问题 —— 引导到插件仓库提 Issue
                       return h('div', null, [
                         h('div', { className: styles.failPrepareHint }, /\[packaging\]/i.test(r.message) ? t('failPackagingHint') : t('failPrepareHint')),
@@ -395,7 +422,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                           rel: 'noopener noreferrer',
                           title: t('failIssueHint'),
                         }, t('failIssueBig')) : null,
-                        // 次要入口：这条分支的判据（[packaging] 预检/装后校验、prepare 摘要）是插件中心
+                        // 次要入口：这条分支的判据（[packaging] 装后校验、prepare 摘要）是插件中心
                         // 自己产出的，不是 pnpm 原文 —— 判错时用户会被送去作者仓库、我们永远收不到反馈
                         r.repo && shownRepo ? h('div', null, [
                           h('div', { className: styles.failPrepareHint }, t('failMisjudgeHint')),
@@ -433,11 +460,34 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         h('div', { className: styles.failPrepareHint }, t('failHostCliSpawnHint')),
                       ])
                     }
-                    // pnpm allowBuilds 拦截与未知失败：不归到插件作者，改为引导到插件中心仓库排查
+                    if (kind === 'pnpmIgnoredBuild') {
+                      // 插件的依赖需要在用户机器上编译原生模块，pnpm 默认拦住；我们已自动放行
+                      // allowBuilds 并重试过一次，仍失败说明任何用户都装不上 —— 属作者侧（发预构建产物 / 走 release 包）
+                      return h('div', null, [
+                        h('div', { className: styles.failPrepareHint }, t('failIgnoredBuild')),
+                        r.repo && shownRepo ? h('a', {
+                          className: styles.failBigIssue,
+                          href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts, action),
+                          target: '_blank',
+                          rel: 'noopener noreferrer',
+                          title: t('failIssueHint'),
+                        }, t('failIssueBig')) : null,
+                        // 这条判定里也有我们的动作（自动放行过 allowBuilds），判错时得留一条回到插件中心的路
+                        r.repo && shownRepo ? h('div', null, [
+                          h('div', { className: styles.failPrepareHint }, t('failMisjudgeHint')),
+                          h('a', {
+                            className: styles.failMisjudgeLink,
+                            href: hubIssueUrl(shownRepo, r.message, env, r.command, r.attempts, 'misjudge', action),
+                            target: '_blank',
+                            rel: 'noopener noreferrer',
+                            title: t('failHubIssueHint'),
+                          }, t('failMisjudgeLink')),
+                        ]) : null,
+                      ])
+                    }
+                    // 未知失败：不归到插件作者，改为引导到插件中心仓库排查
                     return h('div', null, [
-                      kind === 'pnpmIgnoredBuild'
-                        ? h('div', { className: styles.failPrepareHint }, t('failIgnoredBuild'))
-                        : h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint', { action: actionWord })),
+                      h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint', { action: actionWord })),
                       h('a', {
                         className: styles.failBigIssue,
                         href: hubIssueUrl(shownRepo || r.repo, r.message, env, r.command, r.attempts, 'triage', action),

package/src/client/components/modals/ProgressView.tsx

@@ -3,10 +3,9 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Inline progress block shared by the install and uninstall dialogs:
- * a real percentage bar (server-estimated, client-polled). No live terminal
- * window — pnpm emits nothing during git clone/build, so a log pane would be
- * empty for most of the run; failures surface their full output in ErrorModal.
+ * 安装与卸载弹窗共用的内联进度块：真实百分比进度条（服务端估算、客户端轮询）。
+ * 不做实时终端窗口 —— pnpm 在 git clone/构建期间几乎无输出，日志面板大部分时间是空的；
+ * 失败时完整输出在 ErrorModal 里展示。
  */
 import { createElement as h } from 'react'
 import styles from '../../styles/Modal.module.css'

package/src/client/components/modals/modals.tsx

@@ -3,11 +3,9 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Dialog layer for the Plugin Hub: the install-confirm dialog, the uninstall
- * dialog and the global toast. Both dialogs lock themselves while a mutation
- * is running, then switch to a result view with a single action — "done" for
- * the common case (the page refreshes on close so the change applies), or a
- * single "restart now" for the rare changes a refresh cannot pick up.
+ * 插件中心的弹窗层：安装确认弹窗、卸载弹窗与全局 Toast。两个弹窗在变更执行期间
+ * 自我锁定，随后切到只有一个动作的结果视图 —— 常见情况给「完成」（关闭时刷新页面即生效），
+ * 刷新解决不了的少数情况才给单个「立即重启」。
  */
 import { createElement as h } from 'react'
 import type { MouseEvent } from 'react'
@@ -343,7 +341,7 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
   repo: string | null
   action: FailureAction
   command?: string
-  /** 尝试过的安装方式（npm 反查 + 实际执行命令）：issue 预填一并贴给作者，便于反推正确的 npm 包名 */
+  /** 实际执行/重试过的安装命令：issue 预填一并贴给作者 */
   attempts?: string[]
   t: Translate
   env: EnvInfo | null
@@ -352,7 +350,7 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
   /** 网络不通时的「去系统诊断」直达按钮：跳到设置 → 系统诊断跑连通性检测（由宿主提供） */
   onRunDiagnostics?: () => void
 }) {
-  // 失败归类：当前安装通道（npm/git）装不上 = 插件分发/依赖的问题，一律引导提 Issue
+  // 失败归类：装不上 = 插件分发/依赖的问题，一律引导提 Issue
   const failureKind = classifyFailure(message)
   // 动作词：标题、徽标与提示里的 {action} 统一取这一个词
   const actionWord = t(action === 'uninstall' ? 'actionUninstall' : action === 'update' ? 'actionUpdate' : 'actionInstall')
@@ -387,22 +385,32 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
         // 与失败记录一致的布局：类型徽标 + 仓库超链接 + 顶部隐蔽复制按钮
         h('div', { className: styles.failRow },
           h('div', { className: styles.failHead },
-            h('span', {
-              className: action === 'install' ? styles.failKindInstall : styles.failKindUninstall,
-            }, actionWord),
-            // 仓库地址（用户名/仓库）统一显示为可点击超链接，跳转到官网详情页（含插件收录信息），而非直接跳 GitHub
-            repo ? h('a', {
-              className: styles.failRepo,
-              href: pluginSiteUrl(repo),
-              target: '_blank',
-              rel: 'noopener noreferrer',
-              title: repo,
-            }, repo) : null,
+            // 跳官网「插件详情」页；文字里直接给出目标地址（去掉协议），点前就知道会去哪
+            repo ? (() => {
+              const url = pluginSiteUrl(repo)
+              return h('a', {
+                className: styles.failRepo,
+                href: url,
+                target: '_blank',
+                rel: 'noopener noreferrer',
+                title: url,
+              },
+                h('span', { className: styles.failRepoLabel }, `${t('detailTitle')} · `),
+                h('span', { className: styles.failRepoUrl }, url.replace(/^https?:\/\//, '').split('?')[0]),
+              )
+            })() : null,
             // 复制按钮放最上面、浅灰隐蔽；报错正文不允许鼠标选择复制，只能点这里
             h('button', { className: styles.errorCopySoft, onClick: () => onCopy(copyText) }, t('errorCopy')),
           ),
           // 报错信息完整展示（可滚动），比失败记录的预览看得更多
           h('pre', { className: styles.errorBox }, message),
+          // 统一失败卡片头部：报错类型 + 一句话原因（各类型的具体指引仍在下面的分支里）
+          h('div', { className: styles.failKindTitle }, t(`failKind_${failureKind}`, failureKind === 'hostIncompatible'
+            ? { version: /incompatible with dsh\s+([^\s:;,]+)/i.exec(message)?.[1] ?? '' }
+            : undefined)),
+          failureKind === 'hostIncompatible'
+            ? null
+            : h('div', { className: styles.failReason }, t(`failReason_${failureKind}`)),
           // npm 内部崩溃（edgesOut）＋ 本机 npm 版本过低：npm 自身已知缺陷，不是插件问题 ——
           // 直接给升级指引，不引导提 Issue（提了也是 npm 的问题，插件作者无法修复）
           failureKind === 'npmTooOld'
@@ -467,9 +475,28 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
                   title: t('failIssueHint'),
                 }, t('failIssueBig')) : null,
               ])
+              : failureKind === 'hostIncompatible'
+              // 宿主版本门禁：插件声明的兼容范围不含当前 dsh 版本，安装前就被宿主拒绝。
+              // 这是作者能修的（把该版本加进兼容清单），故直接引导到作者仓库；同时说明本地可临时授权
+              ? h('div', null, [
+                (() => {
+                  const version = /incompatible with dsh\s+([^\s:;,]+)/i.exec(message)?.[1] ?? ''
+                  return h('div', null, [
+                    h('div', { className: styles.failReason }, t('failHostIncompatibleReason', { version })),
+                    h('div', { className: styles.failPrepareHint }, t('failHostIncompatibleHint')),
+                  ])
+                })(),
+                repo ? h('a', {
+                  className: styles.failBigIssue,
+                  href: pluginIssueUrl(repo, message, env, command, attempts, action),
+                  target: '_blank',
+                  rel: 'noopener noreferrer',
+                  title: t('failIssueHint'),
+                }, t('failIssueBig')) : null,
+              ])
               : failureKind === 'registryVersionStale'
               // 要装的版本在「实际执行安装的那个源」里查不到（ERR_PNPM_NO_MATCHING_VERSION / ETARGET）：
-              // 常见于镜像滞后 —— 反查包名走设置里的 npmRegistry，实际安装沿用本机 ~/.npmrc 的源，
+              // 常见于镜像滞后 —— 实际安装沿用本机 ~/.npmrc 的源，
               // 官方源刚发布而镜像还没同步；也可能只是版本号写错。与插件作者无关 ——
               // 给「对齐源 / 那一次显式走官方源 / 用离线包」的指引，不引导提 Issue
               ? h('div', { className: styles.failPrepareHint }, t('failRegistryVersionStaleHint'))
@@ -492,7 +519,7 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
               // 安装流程，与插件无关 —— 引导从本机地址重新打开市场，不引导提 Issue
               ? h('div', { className: styles.failPrepareHint }, t('failOriginRejectedHint', { profile: env?.profile ?? '<profile>' }))
               : failureKind === 'network'
-              // 安装前预检 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：
+              // 安装前网络探测 / 安装日志里的连接失败（[network] / git fetch 超时 / DNS / TLS）：
               // 是本机网络不通或代理有问题，不是插件问题 —— 提示检查网络 + 直达「系统诊断」，
               // 不引导提 Issue
               ? h('div', null, [
@@ -509,7 +536,7 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
               ])
               : failureKind === 'pluginPrepare'
               ? h('div', null, [
-                // [packaging]（预检/装后校验拦截：git 分发缺产物）与
+                // [packaging]（装后校验拦截：分发缺产物）与
                 // prepare 构建脚本实际执行失败：唯一确有证据的插件打包分发问题 —— 引导到插件仓库提 Issue
                 h('div', { className: styles.failPrepareHint }, /\[packaging\]/i.test(message) ? t('failPackagingHint') : t('failPrepareHint')),
                 repo ? h('a', {
@@ -519,7 +546,7 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
                   rel: 'noopener noreferrer',
                   title: t('failIssueHint'),
                 }, t('failIssueBig')) : null,
-                // 次要入口：这条分支的判据（[packaging] 预检/装后校验、prepare 摘要）是插件中心
+                // 次要入口：这条分支的判据（[packaging] 装后校验、prepare 摘要）是插件中心
                 // 自己产出的，不是 pnpm 原文 —— 判错时用户会被送去作者仓库、我们永远收不到反馈，
                 // 故另给一条「可能是市场误判」的反馈通道（正文自我说明它来自哪条分支）
                 repo ? h('div', null, [
@@ -553,11 +580,33 @@ export function ErrorModal({ message, repo, action, command, attempts, t, env, o
                 // 宿主自身入口起不来：环境问题，给提示、不引导提 Issue
                 h('div', { className: styles.failPrepareHint }, t('failHostCliSpawnHint')),
               ])
+              : failureKind === 'pnpmIgnoredBuild'
+              // 该类型的插件依赖需要在用户机器上编译原生模块，pnpm 默认拦住；我们已自动放行
+              // allowBuilds 并重试过一次，仍失败说明任何用户都装不上 —— 属作者侧（发预构建产物 / 走 release 包）。
+              ? h('div', null, [
+                h('div', { className: styles.failPrepareHint }, t('failIgnoredBuild')),
+                repo ? h('a', {
+                  className: styles.failBigIssue,
+                  href: pluginIssueUrl(repo, message, env, command, attempts, action),
+                  target: '_blank',
+                  rel: 'noopener noreferrer',
+                  title: t('failIssueHint'),
+                }, t('failIssueBig')) : null,
+                // 这条判定里也有我们的动作（我们自动放行过 allowBuilds），判错时得留一条回到插件中心的路
+                repo ? h('div', null, [
+                  h('div', { className: styles.failPrepareHint }, t('failMisjudgeHint')),
+                  h('a', {
+                    className: styles.failMisjudgeLink,
+                    href: hubIssueUrl(repo, message, env, command, attempts, 'misjudge', action),
+                    target: '_blank',
+                    rel: 'noopener noreferrer',
+                    title: t('failHubIssueHint'),
+                  }, t('failMisjudgeLink')),
+                ]) : null,
+              ])
               : h('div', null, [
-                // pnpm allowBuilds 拦截与未知失败：不归到插件作者，改为引导到插件中心仓库排查
-                failureKind === 'pnpmIgnoredBuild'
-                  ? h('div', { className: styles.failPrepareHint }, t('failIgnoredBuild'))
-                  : h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint', { action: actionWord })),
+                // 未分类（hub）：不归到插件作者，改为引导到插件中心仓库分诊
+                h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint', { action: actionWord })),
                 h('a', {
                   className: styles.failBigIssue,
                   href: hubIssueUrl(repo, message, env, command, attempts, 'triage', action),

package/src/client/components/ui/Dropdown.tsx

@@ -3,13 +3,11 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Button-style dropdown (native <select> replacement).
+ * 按钮式下拉框（替代原生 <select>）。
  *
- * The trigger is a compact toolbar button — hairline border + subtle grey
- * fill + current value + chevron — so it sits naturally next to the other
- * toolbar buttons and takes a single slot of horizontal space. Clicking
- * outside or pressing Esc closes the panel; options get a hover fill and
- * the active one a brand highlight, all driven by the --hub-* tokens.
+ * 触发器是紧凑的工具栏按钮 —— 细边框 + 淡灰填充 + 当前值 + 箭头 —— 与其它工具栏按钮
+ * 并排自然，只占一格横向空间。点击外部或按 Esc 关闭面板；选项有 hover 填充、
+ * 激活项为品牌高亮，全部由 --hub-* 变量驱动。
  */
 import { createElement as h, useEffect, useRef, useState } from 'react'
 import type { JSX } from 'react'

package/src/client/components/ui/Toggle.tsx

@@ -3,9 +3,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Compact switch used by the settings rows. Native-button based so it is
- * keyboard focusable and announces state via aria-checked; styling driven
- * by the --hub-* tokens (on = brand fill, off = neutral track).
+ * 设置行用的紧凑开关。基于原生 button，可键盘聚焦并通过 aria-checked 播报状态；
+ * 样式由 --hub-* 变量驱动（开 = 品牌填充，关 = 中性轨道）。
  */
 import { createElement as h } from 'react'
 import styles from '../../styles/Toggle.module.css'

package/src/client/components/ui/icons.tsx

@@ -3,8 +3,7 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Inline SVG icons used across the client. Icons inherit currentColor so
- * they adapt to themes and disabled states automatically.
+ * 客户端各处使用的内联 SVG 图标。图标继承 currentColor，自动适配主题与禁用态。
  */
 import { createElement as h } from 'react'
 import headerStyles from '../../styles/Header.module.css'