dsh-plugin 1.6.11 → 2.0.0

package/src/client/components/layout/SectionTabs.tsx

@@ -3,11 +3,9 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Primary navigation: a compact segmented control switching between the
- * four top-level sections — Market (browse), Installed (manage), Custom
- * (manual command installs) and Settings (network sources & preferences).
- * Kept visually distinct from the category chips so the hierarchy reads:
- * section → category → plugin.
+ * 一级导航：紧凑分段控件，在四个顶层板块间切换 —— 市场（浏览）、已安装（管理）、
+ * 自定义（手动命令安装）与设置（网络源与偏好）。与分类 chip 视觉上区分开，
+ * 让层级清晰：板块 → 分类 → 插件。
  */
 import { createElement as h } from 'react'
 import styles from '../../styles/SectionTabs.module.css'

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

@@ -3,13 +3,11 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Generic confirm dialog — the single entry point for every "are you sure?"
- * question in the app. Rule: any question must be a modal dialog, never an
- * in-button double-click.
+ * 通用确认弹窗 —— 应用里所有「确定吗？」问题的唯一入口。规则：任何询问都必须是
+ * 弹窗，绝不用按钮内双击。
  *
- * The icon in the middle tells the type at a glance: a blue question mark
- * for routine confirmations (install / update / restart / ignore), a red
- * action glyph for destructive ones (clear / delete / uninstall / reset).
+ * 中间的图标一眼说明类型：常规确认（安装/更新/重启/忽略）用蓝色问号，
+ * 危险操作（清空/删除/卸载/重置）用红色动作图形。
  */
 import { createElement as h } from 'react'
 import type { MouseEvent } from 'react'

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

@@ -3,12 +3,9 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Installed-plugin detail dialog: opens from the Installed view (row click
- * or the detail button) and shows everything we know about an installed
- * entry — the catalog metadata (category, catalog entry, stars/forks,
- * latest version) merged with the host runtime facts (install path, installed
- * version, install time, last update). Update / uninstall actions are
- * offered from here too, mirroring the row actions.
+ * 已安装插件详情弹窗：从「已安装」视图打开（行点击或详情按钮），展示我们对某个已安装项
+ * 掌握的全部信息 —— 目录元数据（分类、收录入口、Star/Fork、最新版本）与宿主运行时事实
+ * （安装路径、已装版本、安装时间、最后更新）合并呈现。此处的更新/卸载动作与行内动作一致。
  */
 import { createElement as h } from 'react'
 import type { MouseEvent } from 'react'

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

@@ -3,20 +3,15 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Built-in log viewer dialog: no external software needed — the app opens
- * its own window and loads the local system log (JSONL at
- * ~/.dsh/profiles/<profile>/hub.log) straight from the server, one page at
- * a time.
+ * 内置日志查看器弹窗：无需外部软件 —— 应用自己开窗，从服务端直接分页加载本地系统日志
+ * （JSONL，位于 ~/.dsh/profiles/<profile>/hub.log）。
  *
- * Every line is categorized twice: a function area (install / uninstall /
- * update / diagnostics / settings / system) and a severity level (debug /
- * info / success / warn / error). Filtering on both axes lets you target,
- * say, only install errors — so the exact incompatible step of an install
- * (or uninstall) is easy to spot. Search narrows by event code or message.
+ * 每行双重归类：功能域（安装/卸载/更新/诊断/设置/系统）与严重级别（debug/info/success/
+ * warn/error）。两轴筛选可只盯某类，比如只看安装错误 —— 便于定位安装（或卸载）中真正
+ * 卡住的那一步；搜索按事件码或消息缩小范围。
  *
- * Server pagination: GET /dsh-plugin-hub/logs?offset=&limit=&category=
- * &level=&query= → { entries, total, hasMore, path }. The footer shows the
- * real file location and reveals it in the system file manager.
+ * 服务端分页：GET /dsh-plugin-hub/logs?offset=&limit=&category=&level=&query=
+ * → { entries, total, hasMore, path }。底部展示日志真实路径并可在系统文件管理器中定位。
  */
 import { createElement as h, useCallback, useEffect, useRef, useState } from 'react'
 import type { MouseEvent } from 'react'

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

@@ -3,22 +3,18 @@
  * 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'
 import styles from '../../styles/Modal.module.css'
 import type { EnvInfo, Translate } from '../../types.ts'
 import type { NotificationRecord } from '../../logic/failures.ts'
-import { classifyFailure, missingRegistryPackageOf, npmTooLowVersion, pnpmPolicyHintOf, pnpmPolicyHintParams, registryMissingHintOf, unreachableTargetOf, registryHostOf } from '../../logic/failures.ts'
+import { actionOfRecord, classifyFailure, missingRegistryPackageOf, npmTooLowVersion, pnpmPolicyHintOf, pnpmPolicyHintParams, registryMissingHintOf, unreachableTargetOf, registryHostOf } from '../../logic/failures.ts'
 import type { PendingRestart, QueueTask } from '../../hooks/useTaskQueue.ts'
 import { pluginIssueUrl, pluginSiteUrl, hubIssueUrl } from '../../logic/urls.ts'
 import { CloseIcon } from '../ui/icons.tsx'
@@ -255,6 +251,9 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                   // 卡片不展示错误日志预览，完整日志靠「复制完整日志」按钮带走，避免每条卡片被日志撑高
                   !r.ok && (() => {
                     const kind = classifyFailure(r.message)
+                    // 动作词：该条提示与上报正文按真实动作取词
+                    const action = actionOfRecord(r)
+                    const actionWord = t(action === 'uninstall' ? 'actionUninstall' : action === 'update' ? 'actionUpdate' : 'actionInstall')
                     if (kind === 'npmTooOld') {
                       // npm 内部崩溃（edgesOut）＋ 本机 npm 版本过低：npm 自身已知缺陷，不是插件问题 ——
                       // 直接给升级指引，不引导提 Issue
@@ -324,7 +323,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         h('div', { className: styles.failPrepareHint }, t('failPluginMissingDepHint')),
                         r.repo && shownRepo ? h('a', {
                           className: styles.failBigIssue,
-                          href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts),
+                          href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts, action),
                           target: '_blank',
                           rel: 'noopener noreferrer',
                           title: t('failIssueHint'),
@@ -333,7 +332,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                     }
                     if (kind === 'registryVersionStale') {
                       // 要装的版本在「实际执行安装的那个源」里查不到（ERR_PNPM_NO_MATCHING_VERSION / ETARGET）：
-                      // 常见于镜像滞后 —— 反查包名走设置里的 npmRegistry，实际安装沿用本机 ~/.npmrc 的源；
+                      // 常见于镜像滞后 —— 实际安装沿用本机 ~/.npmrc 的源；
                       // 也可能只是版本号写错。与插件作者无关 —— 给对齐源 / 显式走官方源 / 离线包指引，不引导提 Issue
                       return h('div', { className: styles.failPrepareHint }, t('failRegistryVersionStaleHint'))
                     }
@@ -364,7 +363,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, [
@@ -373,7 +372,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         // registry 被指向内网/自定义源（tarball 从非官方源下载失败）：直接给出换源指引，
                         // 否则用户外网是通的会困惑「为什么连不上」
                         (() => { const host = registryHostOf(r.message); return host ? h('div', { className: styles.failPrepareHint }, t('failNetworkRegistryHint', { host })) : null })(),
-                        h('div', { className: styles.failPrepareHint }, t('failNetworkHint')),
+                        h('div', { className: styles.failPrepareHint }, t('failNetworkHint', { action: actionWord })),
                         onRunDiagnostics ? h('button', {
                           className: styles.failDiagBtn,
                           onClick: onRunDiagnostics,
@@ -381,24 +380,24 @@ 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')),
                         r.repo && shownRepo ? h('a', {
                           className: styles.failBigIssue,
-                          href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts),
+                          href: pluginIssueUrl(shownRepo, r.message, env, r.command, r.attempts, action),
                           target: '_blank',
                           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')),
                           h('a', {
                             className: styles.failMisjudgeLink,
-                            href: hubIssueUrl(shownRepo, r.message, env, r.command, r.attempts, 'misjudge'),
+                            href: hubIssueUrl(shownRepo, r.message, env, r.command, r.attempts, 'misjudge', action),
                             target: '_blank',
                             rel: 'noopener noreferrer',
                             title: t('failHubIssueHint'),
@@ -409,7 +408,7 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                     if (kind === 'hubState') {
                       // 插件中心的列表状态已过期（安装器自身守卫消息）：非插件问题、也不是 bug，只给可行动提示，不引导提 Issue
                       return h('div', null, [
-                        h('div', { className: styles.failPrepareHint }, t('failHubStateHint')),
+                        h('div', { className: styles.failPrepareHint }, t('failHubStateHint', { action: actionWord })),
                       ])
                     }
                     if (kind === 'timeout') {
@@ -421,17 +420,46 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                     if (kind === 'profileLock') {
                       // DSH 写 profile 的锁超时（同一 profile 被别的 dsh/安装任务占着）：只给可行动提示，不引导提 Issue
                       return h('div', null, [
-                        h('div', { className: styles.failPrepareHint }, t('failProfileLockHint')),
+                        h('div', { className: styles.failPrepareHint }, t('failProfileLockHint', { action: actionWord })),
                       ])
                     }
-                    // pnpm allowBuilds 拦截与未知失败：不归到插件作者，改为引导到插件中心仓库排查
+                    if (kind === 'hostCliSpawn') {
+                      // 宿主自身入口起不来：环境问题，给提示、不引导提 Issue
+                      return h('div', null, [
+                        h('div', { className: styles.failPrepareHint }, t('failHostCliSpawnHint')),
+                      ])
+                    }
+                    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')),
+                      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),
+                        href: hubIssueUrl(shownRepo || r.repo, r.message, env, r.command, r.attempts, 'triage', action),
                         target: '_blank',
                         rel: 'noopener noreferrer',
                         title: t('failHubIssueHint'),

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'
@@ -18,6 +16,7 @@ import { ProgressView } from './ProgressView.tsx'
 import { installCommandOf } from '../../logic/install-command.ts'
 import { pluginDetailUrl, pluginIssueUrl, pluginSiteUrl, hubIssueUrl } from '../../logic/urls.ts'
 import { classifyFailure, missingRegistryPackageOf, npmTooLowVersion, pnpmPolicyHintOf, pnpmPolicyHintParams, registryMissingHintOf, unreachableTargetOf, registryHostOf } from '../../logic/failures.ts'
+import type { FailureAction } from '../../logic/failures.ts'
 
 /** 完成结果视图：绿色对勾 + 标题/描述；
  *  终态只有两种：
@@ -336,14 +335,13 @@ export function UninstallModal(props: UninstallModalProps) {
   )
 }
 
-/** 预填插件仓库的 GitHub Issue 链接：标题带插件名，正文附完整错误信息，方便用户一键反馈。 */
-/** 安装/卸载失败弹窗：布局与失败记录一致（类型徽标 + 仓库超链接 + 隐蔽复制按钮），报错完整展示，底部一键提交 Issue。 */
-export function ErrorModal({ message, repo, kind, command, attempts, t, env, onCopy, onClose, onRunDiagnostics }: {
+/** 安装/更新/卸载失败弹窗：标题、徽标、提示文案与 issue 正文都按传入的动作取词。 */
+export function ErrorModal({ message, repo, action, command, attempts, t, env, onCopy, onClose, onRunDiagnostics }: {
   message: string
   repo: string | null
-  kind: 'install' | 'uninstall'
+  action: FailureAction
   command?: string
-  /** 尝试过的安装方式（npm 反查 + 实际执行命令）：issue 预填一并贴给作者，便于反推正确的 npm 包名 */
+  /** 实际执行/重试过的安装命令：issue 预填一并贴给作者 */
   attempts?: string[]
   t: Translate
   env: EnvInfo | null
@@ -352,8 +350,10 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
   /** 网络不通时的「去系统诊断」直达按钮：跳到设置 → 系统诊断跑连通性检测（由宿主提供） */
   onRunDiagnostics?: () => void
 }) {
-  // 失败归类：当前安装通道（npm/git）装不上 = 插件分发/依赖的问题，一律引导提 Issue
+  // 失败归类：装不上 = 插件分发/依赖的问题，一律引导提 Issue
   const failureKind = classifyFailure(message)
+  // 动作词：标题、徽标与提示里的 {action} 统一取这一个词
+  const actionWord = t(action === 'uninstall' ? 'actionUninstall' : action === 'update' ? 'actionUpdate' : 'actionInstall')
   // 服务端 [npm-too-low] 标记里带的本机 npm 版本（无标记为 null，提示文案降级为「怀疑」）
   const npmVersion = npmTooLowVersion(message)
   // 复制完整错误：实际执行/尝试过的安装命令（如有）+ 完整错误正文。
@@ -372,8 +372,9 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
   },
     h('div', { className: styles.errorModal, role: 'dialog', 'aria-modal': 'true' },
       h('div', { className: styles.modalHead },
-        // 标题按操作类型明确区分：安装失败 / 卸载失败
-        h('div', { className: styles.errorTitle }, kind === 'install' ? t('errorTitleInstall') : t('errorTitleUninstall')),
+        // 标题按动作明确区分：安装失败 / 更新失败 / 卸载失败
+        h('div', { className: styles.errorTitle },
+          t(action === 'uninstall' ? 'errorTitleUninstall' : action === 'update' ? 'errorTitleUpdate' : 'errorTitleInstall')),
         h('button', {
           className: styles.modalClose,
           'aria-label': t('errorClose'),
@@ -385,8 +386,8 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
         h('div', { className: styles.failRow },
           h('div', { className: styles.failHead },
             h('span', {
-              className: kind === 'install' ? styles.failKindInstall : styles.failKindUninstall,
-            }, kind === 'install' ? t('install') : t('uninstall')),
+              className: action === 'install' ? styles.failKindInstall : styles.failKindUninstall,
+            }, actionWord),
             // 仓库地址（用户名/仓库）统一显示为可点击超链接，跳转到官网详情页（含插件收录信息），而非直接跳 GitHub
             repo ? h('a', {
               className: styles.failRepo,
@@ -458,7 +459,7 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
                 h('div', { className: styles.failPrepareHint }, t('failPluginMissingDepHint')),
                 repo ? h('a', {
                   className: styles.failBigIssue,
-                  href: pluginIssueUrl(repo, message, env, command, attempts),
+                  href: pluginIssueUrl(repo, message, env, command, attempts, action),
                   target: '_blank',
                   rel: 'noopener noreferrer',
                   title: t('failIssueHint'),
@@ -466,7 +467,7 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
               ])
               : failureKind === 'registryVersionStale'
               // 要装的版本在「实际执行安装的那个源」里查不到（ERR_PNPM_NO_MATCHING_VERSION / ETARGET）：
-              // 常见于镜像滞后 —— 反查包名走设置里的 npmRegistry，实际安装沿用本机 ~/.npmrc 的源，
+              // 常见于镜像滞后 —— 实际安装沿用本机 ~/.npmrc 的源，
               // 官方源刚发布而镜像还没同步；也可能只是版本号写错。与插件作者无关 ——
               // 给「对齐源 / 那一次显式走官方源 / 用离线包」的指引，不引导提 Issue
               ? h('div', { className: styles.failPrepareHint }, t('failRegistryVersionStaleHint'))
@@ -489,7 +490,7 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
               // 安装流程，与插件无关 —— 引导从本机地址重新打开市场，不引导提 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, [
@@ -498,7 +499,7 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
                 // registry 被指向内网/自定义源（tarball 从非官方源下载失败）：直接给出换源指引，
                 // 否则用户外网是通的会困惑「为什么连不上」
                 (() => { const host = registryHostOf(message); return host ? h('div', { className: styles.failPrepareHint }, t('failNetworkRegistryHint', { host })) : null })(),
-                h('div', { className: styles.failPrepareHint }, t('failNetworkHint')),
+                h('div', { className: styles.failPrepareHint }, t('failNetworkHint', { action: actionWord })),
                 onRunDiagnostics ? h('button', {
                   className: styles.failDiagBtn,
                   onClick: onRunDiagnostics,
@@ -506,24 +507,24 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
               ])
               : 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', {
                   className: styles.failBigIssue,
-                  href: pluginIssueUrl(repo, message, env, command, attempts),
+                  href: pluginIssueUrl(repo, message, env, command, attempts, action),
                   target: '_blank',
                   rel: 'noopener noreferrer',
                   title: t('failIssueHint'),
                 }, t('failIssueBig')) : null,
-                // 次要入口：这条分支的判据（[packaging] 预检/装后校验、prepare 摘要）是插件中心
+                // 次要入口：这条分支的判据（[packaging] 装后校验、prepare 摘要）是插件中心
                 // 自己产出的，不是 pnpm 原文 —— 判错时用户会被送去作者仓库、我们永远收不到反馈，
                 // 故另给一条「可能是市场误判」的反馈通道（正文自我说明它来自哪条分支）
                 repo ? h('div', null, [
                   h('div', { className: styles.failPrepareHint }, t('failMisjudgeHint')),
                   h('a', {
                     className: styles.failMisjudgeLink,
-                    href: hubIssueUrl(repo, message, env, command, attempts, 'misjudge'),
+                    href: hubIssueUrl(repo, message, env, command, attempts, 'misjudge', action),
                     target: '_blank',
                     rel: 'noopener noreferrer',
                     title: t('failHubIssueHint'),
@@ -533,7 +534,7 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
               : failureKind === 'hubState'
               ? h('div', null, [
                 // 插件中心的列表状态已过期（安装器自身守卫消息）：不是插件问题、也不是 bug，只给可行动提示，不引导提 Issue
-                h('div', { className: styles.failPrepareHint }, t('failHubStateHint')),
+                h('div', { className: styles.failPrepareHint }, t('failHubStateHint', { action: actionWord })),
               ])
               : failureKind === 'timeout'
               ? h('div', null, [
@@ -543,16 +544,43 @@ export function ErrorModal({ message, repo, kind, command, attempts, t, env, onC
               : failureKind === 'profileLock'
               ? h('div', null, [
                 // DSH 写 profile 的锁超时（同一 profile 被别的 dsh/安装任务占着）：给可行动提示，不引导提 Issue
-                h('div', { className: styles.failPrepareHint }, t('failProfileLockHint')),
+                h('div', { className: styles.failPrepareHint }, t('failProfileLockHint', { action: actionWord })),
+              ])
+              : failureKind === 'hostCliSpawn'
+              ? h('div', null, [
+                // 宿主自身入口起不来：环境问题，给提示、不引导提 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')),
+                // 未分类（hub）：不归到插件作者，改为引导到插件中心仓库分诊
+                h('div', { className: styles.failPrepareHint }, t('failUnclassifiedHint', { action: actionWord })),
                 h('a', {
                   className: styles.failBigIssue,
-                  href: hubIssueUrl(repo, message, env, command, attempts),
+                  href: hubIssueUrl(repo, message, env, command, attempts, 'triage', action),
                   target: '_blank',
                   rel: 'noopener noreferrer',
                   title: t('failHubIssueHint'),

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'