dsh-plugin 1.6.11 → 2.0.0

package/src/client/logic/failures.ts

@@ -3,13 +3,10 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Failure classification, issue-body summarization and persistent
- * install/remove notifications.
+ * 失败归类、Issue 正文摘要与持久化的安装/卸载通知。
  *
- * Every settled task is recorded two ways: the server-side system log
- * (hub.log) and a client-side localStorage record that feeds the
- * notification center — so a result is never lost even when the dialog
- * was dismissed or nobody was watching the progress strip.
+ * 每个结算后的任务都会双重留痕：服务端系统日志（hub.log）与馈送通知中心的客户端
+ * localStorage 记录 —— 即使弹窗被关闭、无人盯着进度条，结果也不会丢失。
  */
 export interface NotificationRecord {
   id: number
@@ -27,7 +24,7 @@ export interface NotificationRecord {
   version?: string
   /** 实际执行的安装/卸载命令（issue 预填时如实展示）；历史记录可能缺失 */
   command?: string
-  /** 尝试过的安装方式（npm registry 反查 + 实际执行命令，按先后顺序）：失败提 Issue 时贴给作者，便于反推正确的 npm 包名 */
+  /** 尝试过的安装方式（实际执行过的命令，按先后顺序）：失败提 Issue 时贴给作者，便于反推正确的 npm 包名 */
   attempts?: string[]
   /** 结束时间（epoch ms） */
   at: number
@@ -151,9 +148,28 @@ export function removeNotification(id: number): NotificationRecord[] {
   return next
 }
 
-export type FailureKind = 'npmTooOld' | 'dshMissing' | 'gitMissing' | 'pnpmMissing' | 'npmMissing' | 'pnpmStore' | 'pnpmWorkspace' | 'originRejected' | 'pnpmPolicy' | 'pnpmUnusedPatch' | 'pnpmMissingDep' | 'pluginMissingDep' | 'registryVersionStale' | 'pnpmLinkedDirMissing' | 'fileLocked' | 'accessDenied' | 'fsUnavailable' | 'pnpmIgnoredBuild' | 'pluginPrepare' | 'network' | 'hubState' | 'timeout' | 'profileLock' | 'hub'
+export type FailureKind = 'npmTooOld' | 'dshMissing' | 'gitMissing' | 'pnpmMissing' | 'npmMissing' | 'pnpmStore' | 'pnpmWorkspace' | 'originRejected' | 'pnpmPolicy' | 'pnpmUnusedPatch' | 'pnpmMissingDep' | 'pluginMissingDep' | 'registryVersionStale' | 'pnpmLinkedDirMissing' | 'fileLocked' | 'accessDenied' | 'fsUnavailable' | 'pnpmIgnoredBuild' | 'pluginPrepare' | 'network' | 'hostCliSpawn' | 'hubState' | 'timeout' | 'profileLock' | 'hub'
 
-/** Match the pnpm error code, not a generic mention of checksum or integrity. */
+/** 失败动作口径：标题、上报正文与提示文案按安装/更新/卸载取词，不写死「安装」。 */
+export type FailureAction = 'install' | 'update' | 'uninstall'
+
+/** 动作词（英文）：名词短语，标题与句子里都成立。 */
+export function actionWordEn(action: FailureAction): string {
+  return action === 'uninstall' ? 'removal' : action === 'update' ? 'update' : 'install'
+}
+
+/** 动作词（中文）：安装 / 更新 / 卸载。 */
+export function actionWordZh(action: FailureAction): string {
+  return action === 'uninstall' ? '卸载' : action === 'update' ? '更新' : '安装'
+}
+
+/** 记录的动作：老记录只有 kind，按 kind 兜底。 */
+export function actionOfRecord(rec: { kind: NotificationRecord['kind']; action?: FailureAction }): FailureAction {
+  if (rec.action !== undefined) return rec.action
+  return rec.kind === 'uninstall' ? 'uninstall' : rec.kind === 'update' ? 'update' : 'install'
+}
+
+/** 只匹配 pnpm 的错误码，不匹配泛泛出现的 checksum / integrity 字样。 */
 function missingTarballIntegrity(message: string): boolean {
   return /\bERR_PNPM_MISSING_TARBALL_INTEGRITY\b/.test(message)
 }
@@ -168,9 +184,9 @@ export function releaseAgeRetryAfter(message: string): string | null {
 }
 
 /**
- * The same policy subtype selects recovery copy in live and saved failures.
- * minimumReleaseAge 只有在能算出可重试时刻时才走专属文案（给出确切的「何时可再试」），
- * 算不出时退回通用文案，避免出现「预计可重试时间：」后接空值的残缺句子。
+ * 同一策略子类型也用于选择实时/已保存失败的提示文案：minimumReleaseAge 只有在能算出
+ * 可重试时刻时才走专属文案（给出确切的「何时可再试」），算不出时退回通用文案，
+ * 避免出现「预计可重试时间：」后接空值的残缺句子。
  */
 export function pnpmPolicyHintOf(message: string): 'failPnpmTarballIntegrityHint' | 'failPnpmReleaseAgeHint' | 'failPnpmPolicyHint' {
   if (missingTarballIntegrity(message)) return 'failPnpmTarballIntegrityHint'
@@ -226,14 +242,12 @@ export function classifyFailure(message: string): FailureKind {
   // 构建脚本被 allowBuilds 拦截。必须在 network 之前判：日志尾部混重试残留的连接失败特征
   if (/ERR_PNPM_IGNORED_BUILDS|Ignored build scripts:|ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED/i.test(message)) return 'pnpmIgnoredBuild'
   // 网络/代理/源配置问题。必须在 prepare 之前判：git fetch 失败常被外层包成 "Command failed"
-  if (/\[network\]|ERR_PNPM_GIT_FETCH_FAILED|ETIMEDOUT|ECONNREFUSED|ECONNRESET|ENOTFOUND|EAI_AGAIN|EPIPE|EHOSTUNREACH|ENETUNREACH|getaddrinfo|Could not connect|Could not resolve host|Network unreachable|Failed to connect|socket hang up|CERT_HAS_EXPIRED|SSL certificate problem|\bTLS\b|\bSSL\b|fetch failed|failed to fetch|\bGET https?:\/\/\S+\.tgz\s+error \(\d+\)/i.test(message)) return 'network'
-  // 装后校验发现入口文件缺失（[packaging]）= git 分发缺构建产物
+  // tarball 下载失败的括号里可能是数字码（pnpm 自己的）或符号码（undici 的 UND_ERR_*），两种都要认
+  if (/\[network\]|ERR_PNPM_GIT_FETCH_FAILED|ETIMEDOUT|ECONNREFUSED|ECONNRESET|ENOTFOUND|EAI_AGAIN|EPIPE|EHOSTUNREACH|ENETUNREACH|UND_ERR_[A-Z0-9_]+|getaddrinfo|Could not connect|Could not resolve host|Network unreachable|Failed to connect|socket hang up|CERT_HAS_EXPIRED|SSL certificate problem|\bTLS\b|\bSSL\b|fetch failed|failed to fetch|\bGET https?:\/\/\S+\.tgz\s+error \([A-Za-z0-9_]+\)/i.test(message)) return 'network'
+  // 装后校验发现入口文件缺失（[packaging]）= 分发物缺构建产物
   if (/\[packaging\]|entry file missing/i.test(message)) return 'pluginPrepare'
   // registry 上不存在的依赖（404），profile 任何安装都会卡在这条。必须在 pluginPrepare 之前判
-  // 官方源复核结论：缺的包在官方 registry 上也不存在，且不是本机 profile 声明的残留依赖 →
-  // 该包来自插件的依赖树，属**作者侧**问题（依赖没发布/已被删除）。标记由服务端联网复查后注入。
-  // 必须排在 pnpmMissingDep 之前 —— 日志里同样含 ERR_PNPM_FETCH_404，靠标记区分「作者的锅」
-  // 与「本机 profile 残留依赖（#73）/ 镜像源滞后」。
+  // [registry-missing]（服务端官方源复核后注入）= 作者侧缺依赖，须先于 pnpmMissingDep（同样含 404 文本）
   if (/\[registry-missing\]/i.test(message)) return 'pluginMissingDep'
   if (/ERR_PNPM_FETCH_404|404 Not Found|Not Found - 404/i.test(message)) return 'pnpmMissingDep'
   // 要装的版本在实际安装源里没有（镜像滞后或版本写错）。必须在 pluginPrepare 之前判
@@ -246,7 +260,7 @@ export function classifyFailure(message: string): FailureKind {
   // 安装器自身产生的状态类消息（未安装 / 不在此处卸载 / 已在队列中 / 已安装）：这几句由本服务的
   // 守卫发出，不是 CLI 输出、也不是插件问题，而是插件中心的已安装列表与实读快照不同步。
   // 单独归类，让前端给「刷新后重试」这类可行动提示，而不是当作未知失败引导去提 Issue。
-  // already installed 只认「整行就是它」的短形态（旧版本守卫留下的历史记录）；带「——」说明的
+  // already installed 只认「整行就是它」的短形态；带「——」说明的
   // 包名冲突另有处置，不能按状态不同步提示。
   if (/plugin is not installed|plugin cannot be uninstalled here|already queued:|^already installed: \S+$/im.test(message)) return 'hubState'
   // 安装器自己的超时标记（命令跑满上限被强杀）：既不是插件问题、也不是用户环境问题，而且很可能是
@@ -257,12 +271,11 @@ export function classifyFailure(message: string): FailureKind {
   // dsh 进程或安装任务在写，锁一直没释放。既不是插件问题、也不是用户环境坏了 —— 把并发收掉重试即可。
   // 摆放位置同样在一切错误码分支之后：日志里真有 pnpm 报错时仍以真实报错为准。
   if (/atomic-write: timed out waiting for the writer lock|timed out waiting for the writer lock/i.test(message)) return 'profileLock'
-  // 宿主 DSH 自己的 allowBuilds 摘要行（#210）：新版宿主把 pnpm 报错只写进 diagnostics 日志文件，
-  // 终端里只留这一句「git-hosted plugins build … add the exact key … then re-run」，日志里因此
-  // 一条原始 ERR_PNPM_* 码都没有 —— 只能靠这句话识别为「构建脚本被白名单拦截」。
-  // 摆放位置在一切错误码分支之后：日志里真有 ERR_PNPM_PREPARE_PACKAGE / ERR_PNPM_IGNORED_BUILDS
-  // 时（构建确实跑挂、或不带摘要的旧宿主），仍以原始报错为准，不会被这句摘要改写。
+  // 宿主自己的 allowBuilds 摘要行（pnpm 原文只写进 diagnostics 日志文件，终端只剩这一句）
   if (/git-hosted plugins build on install via their prepare script|add the exact key pnpm printed above under allowBuilds/i.test(message)) return 'pnpmIgnoredBuild'
+  // 宿主自身入口起不来（服务端 [host-spawn] 标记）：环境问题，给提示、不引导提 Issue。
+  // 不匹配 `spawn … ENOENT` 文本 —— 那个形态任何 spawn（curl/git/taskkill…）都会产出
+  if (/\[host-spawn\]/i.test(message)) return 'hostCliSpawn'
   // 其余未知失败：引导到插件中心仓库排查
   return 'hub'
 }
@@ -330,8 +343,8 @@ export function coreErrorCode(message: string): string | null {
 }
 
 /** 「包在 registry 不存在」失败的提示变体：服务端用官方源复核过（会注入 `[registry-mirror-lag]`）
- *  时，说明包在官方源上存在、是本机镜像源未同步 → 提示换源；否则沿用既有的「profile 残留依赖」
- *  提示（#73：指向从未发布包的残留条目，任何插件都装不进来）。 */
+ *  时，说明包在官方源上存在、是本机镜像源未同步 → 提示换源；否则按「profile 残留依赖」提示
+ *  （删掉 profile 里那条依赖即可）。 */
 export function registryMissingHintOf(message: string): 'failPnpmMissingDepHint' | 'failRegistryMirrorLagHint' {
   return /\[registry-mirror-lag\]/i.test(message) ? 'failRegistryMirrorLagHint' : 'failPnpmMissingDepHint'
 }
@@ -350,12 +363,12 @@ export function missingRegistryPackageOf(message: string): string | null {
 
 /**
  * 从网络类失败消息里提取「具体连不上的地址」，供弹窗精准提示（你的网络无法访问什么）。
- * 优先取服务端 [network] 预检消息括号里的探测地址（中文「（…）」/ 英文「(…)」），
+ * 优先取服务端 [network] 网络探测消息括号里的探测地址（中文「（…）」/ 英文「(…)」），
  * 否则取消息里出现的第一个 URL（git fetch 的仓库地址、registry 域名等）。
  * 提取不到返回 null —— 调用方据此跳过地址行。
  */
 export function unreachableTargetOf(message: string): string | null {
-  // [network] 预检消息：`无法连接到 GitHub（https://github.com/）` / `cannot reach the npm registry (https://registry.npmjs.org/)`
+  // [network] 网络探测消息：`无法连接到 GitHub（https://github.com/）` / `cannot reach the npm registry (https://registry.npmjs.org/)`
   const paren = message.match(/[（(](https?:\/\/[^\s'"`<>（)+]+)[)）]/)
   if (paren) return paren[1]
   // 其余网络失败（git fetch / npm 连接失败）：取第一个 URL，去掉行尾标点

package/src/client/logic/format.ts

@@ -3,7 +3,7 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Presentation formatters shared across the catalog list and the cards.
+ * 目录列表与卡片共用的展示格式化函数。
  */
 import type { Translate } from '../types.ts'
 

package/src/client/logic/install-command.ts

@@ -3,15 +3,13 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Install target/command helpers: decide the install channel (npm package
- * vs prebuilt GitHub release vs explicit-HTTPS GitHub), build the display
- * command and normalize a raw install spec back to its owner/repo identity.
+ * 安装目标/命令工具：为目录条目取 npm 包名、构造展示命令，并把原始安装 spec 归一化回 owner/repo 身份。
  */
 import type { HubPlugin } from '../types.ts'
 import { githubReleaseTarget } from '../../server/services/install/release-target.ts'
 
-/** Backend attempts are chronological; report the last executed command before a display fallback.
- * These prefixes are the task queue's recorded command shapes, never commands to execute here.
+/** 后端 attempts 按时间先后排列：取最后一次实际执行的命令，取不到再回退到展示用命令。
+ * 这里匹配的是任务队列记录的指令形态，不是要在此执行的命令。
  */
 export function executedCommandOf(command?: string, attempts?: string[]): string | undefined {
   if (attempts === undefined) return command
@@ -21,44 +19,25 @@ export function executedCommandOf(command?: string, attempts?: string[]): string
 }
 
 /**
- * 安装通道决策（用户无感知）：目录探测到 npm 包名 → 用 npm 包名安装
- * （走 npm registry tarball，更快、与 GitHub 网络无关）；其次用「同仓库」的权威
- * release 包直链（仓库 HEAD 往往是 monorepo 根、装不上，release .tgz 才是完整产物）；
- * 都没有 → git 直装。
- * 返回值 target 即传给后端 /install 的安装目标（npm 包名 / release URL / owner/repo）。
+ * 目录条目的安装目标（用户无感知）：目录条目必带 npm 包名，直接用该包名安装
+ * （走 npm registry tarball）。
+ * 返回值即传给后端 /install 的安装目标（npm 包名）。
  */
-export function installTargetOf(p: HubPlugin): { target: string; via: 'npm' | 'release' | 'github' } {
-  const pkg = (p.source?.npmPackage ?? '').trim()
-  const repo = (p.source?.repo ?? '').trim()
-  if (pkg && repo) return { target: pkg, via: 'npm' }
-  // 目录下发的权威命令若是「同仓库」的固定 release 直链，改走该预构建包；
-  // 跨仓 / 非法 release 目标不采信，退回 git 直装。
-  const release = githubReleaseTarget(p.install?.githubCommand ?? '')
-  if (release !== null && repo !== '' && release.repo.toLowerCase() === repo.toLowerCase()) {
-    return { target: release.target, via: 'release' }
-  }
-  return { target: repo, via: 'github' }
+export function installTargetOf(p: HubPlugin): string {
+  return (p.source?.npmPackage ?? '').trim()
 }
 
 /** 展示用安装命令（复制/弹窗）：目录下发的权威命令优先（CLI-only 插件如 dsh-tui
- *  需专属 profile（--profile dsh-tui），无法从 repo/npm 包名推断，必须用官方命令）；
- *  常规插件无目录命令时按通道回退生成：npm 显示包名，git 显示显式 HTTPS URL。 */
+ *  需专属 profile（--profile dsh-tui），无法从 npm 包名推断，必须用官方命令）；
+ *  常规插件无目录命令时用 npm 包名回退生成。 */
 export function installCommandOf(p: HubPlugin, withProfile = false): string {
-  const { target, via } = installTargetOf(p)
-  if (via === 'npm') {
-    const cmd = p.install?.command
-    if (cmd) return cmd
-  } else {
-    // release 与 git 通道共用目录下发的 githubCommand（git+ 显式 HTTPS 或 release 直链）
-    const cmd = p.install?.githubCommand
-    if (cmd) return cmd
-  }
+  const cmd = p.install?.command
+  if (cmd) return cmd
   const prefix = `dsh plugin${withProfile ? ' --profile web' : ''} add `
-  if (via === 'npm' || via === 'release') return `${prefix}${target}`
-  return `${prefix}git+https://github.com/${target}.git`
+  return `${prefix}${installTargetOf(p)}`
 }
 
-/** Normalize a task/install target to its owner/repo display identity. */
+/** 把任务/安装目标归一化为 owner/repo 展示身份。 */
 export function repoFromInstallTarget(value: string): string {
   const input = value.trim()
   // release 直链（预构建 .tgz）走同一条身份归一化：解析出所属仓库，已装态/更新信号才能

package/src/client/logic/installed.ts

@@ -3,13 +3,11 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Installed-plugin model (pure logic, zero React/UI dependencies).
+ * 已安装插件模型（纯逻辑，不依赖 React/UI）。
  *
- * Merges the local installed table (from the host's `/installed` route:
- * npm name → manifest spec) with the catalog projection into a single
- * `InstalledItem` view-model consumed by the Installed view. Also hosts the
- * install matching / update detection used by the market view, so both
- * views share one source of truth.
+ * 把宿主 `/installed` 路由下发的本地已装表（npm 包名 → manifest spec）与目录投影合并成
+ * 统一的 `InstalledItem` 视图模型，供「已安装」视图消费；同时承载市场视图用的安装匹配
+ * 与更新检测，让两个视图共享唯一数据源。
  */
 import type { HubPlugin } from '../types.ts'
 import { HUB_REPO } from './constants.ts'
@@ -56,7 +54,7 @@ function signalOf(repo: string | null, versions: Record<string, InstalledVersion
   return versions[repo.toLowerCase()] ?? null
 }
 
-/** 插件是否已安装：匹配 Git spec 中的 owner/repo，或 npm 通道安装的依赖包名；命中返回 npm 包名。 */
+/** 插件是否已安装：匹配 Git spec 中的 owner/repo，或 npm 安装的依赖包名；命中返回 npm 包名。 */
 export function installedNameOf(
   plugin: HubPlugin,
   installed: Record<string, string>,
@@ -68,8 +66,8 @@ export function installedNameOf(
   for (const [name, spec] of Object.entries(installed)) {
     if (repoFromInstallTarget(spec).toLowerCase() === needle) return name
   }
-  // npm 通道安装：profile 依赖 key 直接是 npm 包名。包名来源两处——目录数据（npmPackage），
-  // 或服务端 npm 优先反查持久化的映射（versions[repo].npmPackage，覆盖组织 scope 与 GitHub
+  // npm 安装：profile 依赖 key 直接是 npm 包名。包名来源两处——目录数据（npmPackage），
+  // 或服务端安装时持久化的映射（versions[repo].npmPackage，覆盖组织 scope 与 GitHub
   // 用户名不一致、目录未下发包名的场景）；命中任一并依赖 key 真实存在即视为已安装。
   // 只认 npm 安装的依赖（spec 无法解析出仓库身份）：git/本地安装的依赖身份由仓库匹配决定，
   // 包名同名不代表同仓库——否则「git 装 A 仓库」会被「npm 包名同名但仓库不同」的目录条目
@@ -91,6 +89,13 @@ export function installedVersionOf(plugin: HubPlugin, versions: Record<string, I
   return versions[repo.toLowerCase()]?.version ?? null
 }
 
+/** 该插件对应的 npm 包名（目录下发，或安装时持久化的映射）；无则 null。决定更新是否走 npm registry。 */
+export function npmPackageOf(plugin: HubPlugin, versions: Record<string, InstalledVersionSignal>): string | null {
+  const repo = plugin.source?.repo
+  const pkg = (plugin.source?.npmPackage || (repo ? versions[repo.toLowerCase()]?.npmPackage : undefined) || '').trim()
+  return pkg === '' ? null : pkg
+}
+
 /**
  * 是否有更新：仅对已安装插件有意义。
  * 双信号判定——有 release 版本的比版本；无版本（repo 不打 tag）的比仓库最近更新时间
@@ -174,7 +179,7 @@ function isHubSelf(name: string, spec: string): boolean {
   if (spec.startsWith('file:') || spec.startsWith('link:')) return true
   const repo = repoFromInstallTarget(spec)
   if (isRepoLike(repo) && repo.toLowerCase() === HUB_REPO.toLowerCase()) return true
-  // npm 通道覆盖重装 hub 自身后，file:/link: 本地链接会被替换成 registry 版本号/范围
+  // npm 覆盖重装 hub 自身后，file:/link: 本地链接会被替换成 registry 版本号/范围
   // （如 1.3.0、^1.3.0）——依赖 key `dsh-plugin` 在 npm 上唯一属于本插件（不存在第三方
   // 同名包），版本号形态与仓库身份同样视为 hub 自身：命令窗口「自己装自己」成功后，
   // 条目仍不进已安装列表（卸载接口对它的 400 拒绝是服务端最后一道防线）。

package/src/client/logic/normalize.ts

@@ -3,8 +3,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Normalizer: maps the online API's short-key payload (s/o/n/vr/c/t/f/d/r/v/u/a/sg/fk)
- * to HubPlugin so rendering only ever sees one shape.
+ * 归一化器：把在线 API 的短 key 载荷（s/o/n/vr/c/t/f/d/r/v/u/a/sg/fk）映射为
+ * HubPlugin，让渲染层只面对一种数据形态。
  */
 import type { HubPlugin } from '../types.ts'
 
@@ -30,7 +30,7 @@ export function normalize(raw: Record<string, unknown>): HubPlugin {
           : undefined,
       // 安装信息：wi 仅在 false 时下发（缺省视为 true 可一键安装）；
       // mi 仅在 true 时下发（人工干预：网页端替不了终端，只引导用户自己去终端装）；
-      // ic/igc = 目录下发的权威安装命令（npm/git 通道各一条，CLI-only 插件如 dsh-tui 必须用）
+      // ic/igc = 目录下发的权威安装命令（CLI-only 插件如 dsh-tui 必须用）
       install: raw.wi === false || raw.mi === true || typeof raw.ic === 'string' || typeof raw.igc === 'string'
         ? {
           webInstallable: raw.wi === false ? false : undefined,

package/src/client/logic/release-age.ts

@@ -0,0 +1,19 @@
+/**
+ * DSH Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * 供应链门禁的时间判定（纯函数）：pnpm 会静默回退发布未满门槛的版本，
+ * 故发布太新的版本不该提示更新。Hub 自身更新与插件更新共用同一门槛。
+ */
+
+/** pnpm 供应链门禁：dsh profile 默认 minimumReleaseAge=1440（分钟）；+30 分钟缓冲抵消网络/CDN 边缘时间偏差。 */
+export const MIN_RELEASE_AGE_MS = 24 * 60 * 60 * 1000 + 30 * 60 * 1000
+
+/** 发布时间是否仍在门禁窗口内（太新 → 暂缓提示）；无值/解析不出返回 false（不拦真实更新）。 */
+export function isReleaseTooFresh(publishedAt: string | null | undefined, now: number): boolean {
+  if (typeof publishedAt !== 'string' || publishedAt === '') return false
+  const ms = Date.parse(publishedAt)
+  if (Number.isNaN(ms)) return false
+  return now - ms < MIN_RELEASE_AGE_MS
+}

package/src/client/logic/urls.ts

@@ -3,15 +3,14 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * URL builders: catalog detail pages, plugin site links and the pre-filled
- * GitHub issue URL used by the failure modal. Pure functions — the issue
- * URL stays within GitHub's 8192-byte request limit.
+ * URL 构造：目录详情页、插件官网链接，以及失败弹窗用的预填 GitHub Issue 链接。
+ * 均为纯函数，保证 issue URL 不超过 GitHub 8192 字节的请求上限。
  */
 import type { EnvInfo, HubPlugin, LocaleId } from '../types.ts'
 import { GITHUB_URL, HUB_REPO, PLUGIN_VERSION, SITE_URL } from './constants.ts'
-import { MAX_CORE_CHARS, classifyFailure, coreErrorCode, pnpmPolicyHintOf, summarizeError } from './failures.ts'
+import { MAX_CORE_CHARS, actionWordEn, actionWordZh, classifyFailure, coreErrorCode, pnpmPolicyHintOf, summarizeError } from './failures.ts'
 import { executedCommandOf } from './install-command.ts'
-import type { FailureKind } from './failures.ts'
+import type { FailureAction, FailureKind } from './failures.ts'
 
 /** dsh-plugin.org 中文页挂在 /zh/ 前缀下，英文在根路径。 */
 export function langPathOf(lang: LocaleId): string {
@@ -41,18 +40,18 @@ export function pluginSiteUrl(repo: string): string {
   return siteUrl(`plugins/${repo}`)
 }
 
-/** 按失败类型给出简洁的错误原因标题（对外用英文）：
- *  标题直接点明问题出在哪一侧（构建白名单/分发物/本机 npm/网络/插件侧），
- *  让作者与用户扫一眼列表就能分流，而不是笼统的 Install/Remove 动作词。 */
-function reasonTitleOf(kind: FailureKind): string {
+/** 错误原因标题（对外英文）：点明问题出在哪一侧，便于 issue 列表分流；
+ *  动作级原因（未分类/超时…）带动作词，卸载失败不写成 install failed。 */
+function reasonTitleOf(kind: FailureKind, action: FailureAction): string {
+  const word = actionWordEn(action)
   switch (kind) {
-    case 'npmTooOld': return 'npm too old to install'
+    case 'npmTooOld': return `npm too old for this ${word}`
     case 'dshMissing': return 'dsh command not found on the user machine'
     case 'pnpmMissing': return 'pnpm command not found on the user machine'
     case 'pnpmStore': return 'pnpm store version mismatch on the user machine'
-    case 'pnpmWorkspace': return 'pnpm workspace-root check blocked the install on the user machine'
+    case 'pnpmWorkspace': return `pnpm workspace-root check blocked the ${word} on the user machine`
     case 'originRejected': return 'request origin rejected by the local service on the user machine'
-    case 'pnpmPolicy': return 'pnpm supply-chain policy blocked the install on the user machine'
+    case 'pnpmPolicy': return `pnpm supply-chain policy blocked the ${word} on the user machine`
     case 'pnpmUnusedPatch': return 'stale pnpm patch entry on the user machine'
     case 'pnpmMissingDep': return 'dependency not found on the npm registry on the user machine'
     case 'registryVersionStale': return 'requested version not available on the npm registry in use on the user machine'
@@ -63,12 +62,13 @@ function reasonTitleOf(kind: FailureKind): string {
     case 'pnpmIgnoredBuild': return 'build scripts blocked by pnpm allowlist'
     case 'pluginPrepare': return 'plugin distribution incomplete'
     case 'network': return 'network failure on the user side'
-    case 'hubState': return 'stale install state in the plugin hub'
-    case 'timeout': return 'install timed out'
+    case 'hostCliSpawn': return 'the DSH host could not be launched on the user machine'
+    case 'hubState': return `stale ${word} state in the plugin hub`
+    case 'timeout': return `${word} timed out`
     case 'profileLock': return 'DSH profile is locked by another process'
     case 'pluginMissingDep': return 'a dependency of the plugin is not published on npm'
-    case 'hub': return 'install failed (cause unclassified)'
-    default: return 'plugin install failed'
+    case 'hub': return `${word} failed (cause unclassified)`
+    default: return `plugin ${word} failed`
   }
 }
 
@@ -78,19 +78,21 @@ function reasonTitleOf(kind: FailureKind): string {
  * 错误核心摘要（完整日志太长，塞进 URL 会被 GitHub 以「request URL too long」拒绝，
  * 故只收集重点）。错误弹窗、失败记录共用此逻辑。
  * env 取不到时为 null，链接照常生成、只是少环境段。
- * attempts（尝试过的安装方式，npm 反查 + 实际执行命令）：作者看到我们查过/试过的命令，
+ * attempts（尝试过的安装方式，实际执行过的命令）：作者看到我们试过的命令，
  * 组织 scope 与 GitHub 用户名不一致时也能直接指认正确的 npm 包名。
  */
-export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | null, command?: string, attempts?: string[]): string {
+export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | null, command?: string, attempts?: string[], action: FailureAction = 'install'): string {
   // 原因判定：按失败类型归类，便于作者判断问题是否出在插件侧。
-  // [packaging]（预检/装后校验拦截）单独列：无论走 npm 还是 git 通道，都是分发物不完整
-  // （package.json 声明的文件在发布物里缺失），作者照此补齐即可。
+  // [packaging]（装后校验拦截）单独列：分发物不完整（package.json 声明的文件
+  // 在发布物里缺失），作者照此补齐即可。
   const kind = classifyFailure(message)
   const executed = executedCommandOf(command, attempts)
+  // 动作词：标题与正文的「安装/更新/卸载」统一取自这里
+  const zhWord = actionWordZh(action)
   // 标题 = 错误原因（非动作词），让 issue 列表一眼可分流
-  const title = `[dsh-plugin.org | dsh-plugin-hub] ${reasonTitleOf(kind)}: ${repo}`
+  const title = `[dsh-plugin.org | dsh-plugin-hub] ${reasonTitleOf(kind, action)}: ${repo}`
   const reason = /\[packaging\]/i.test(message)
-    ? 'plugin distribution is incomplete — a file the package needs (its entry from main / exports, an entry a bundled patch mounts, or the patch declared by dsh.bundle.patch) is missing from the published package (github tarball or npm package); please commit build output or publish a complete package'
+    ? 'plugin distribution is incomplete — a file the package needs (its entry from main / exports, an entry a bundled patch mounts, or the patch declared by dsh.bundle.patch) is missing from the published npm package; please publish a complete package'
       : /\[registry-missing\]/i.test(message)
         // 服务端用官方 registry 复核过：缺的包在官方源上也不存在，且不是用户 profile 的残留依赖
         ? 'a dependency declared by the plugin is not published on the public npm registry (missing, removed, or never released); please publish or correct that dependency, or ship it with the plugin'
@@ -123,23 +125,22 @@ export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | nu
       `- Cause: ${reason}`,
       ...(code ? [`- Key error: \`${code}\``] : []),
       '',
-      // 来源说明：标题（链官网）+ 一句来源（链仓库）+ 实际执行的安装命令（含 --profile）与执行结果，链接由常量动态拼接
-      `## [DSH Plugin 插件市场](${SITE_URL}) · 安装 Plugin 失败错误信息`,
-      `本错误信息由 [dsh-plugin-hub](${GITHUB_URL}) 插件市场的安装程序自动生成，随本次安装失败一并提交。`,
-      `- 实际执行的安装命令：${executed ? `\`${executed}\`` : 'unknown (no executed command recorded)'}`,
-      `- 执行结果：安装失败，未能安装该插件。`,
-      // 尝试过的安装方式（npm 反查 + 实际执行命令，按先后顺序）：作者据此反推正确的
-      // npm 包名 —— 组织 scope 与 GitHub 用户名不一致时仅凭仓库名猜不到，作者看到我们
-      // 查过/试过的命令就能直接指认
+      // 来源说明：标题（链官网）+ 一句来源（链仓库）+ 实际执行的命令（含 --profile）与执行结果，链接由常量动态拼接
+      `## [DSH Plugin 插件市场](${SITE_URL}) · ${zhWord} Plugin 失败错误信息`,
+      `本错误信息由 [dsh-plugin-hub](${GITHUB_URL}) 插件市场的安装程序自动生成，随本次${zhWord}失败一并提交。`,
+      `- 实际执行的${zhWord}命令：${executed ? `\`${executed}\`` : 'unknown (no executed command recorded)'}`,
+      `- 执行结果：${zhWord}失败，未能${zhWord}该插件。`,
+      // 尝试过的安装方式（实际执行过的命令，按先后顺序）：作者据此指认正确的 npm 包名。
+      // 不写「安装」：卸载失败也走这条正文。
       ...(attempts && attempts.length > 0
-        ? ['', '## Attempted install channels（已尝试的安装方式）', ...attempts.map((a) => `- ${a}`)]
+        ? ['', '## Attempted channels（已尝试的方式）', ...attempts.map((a) => `- ${a}`)]
         : []),
-      // [packaging] 场景：说明三种官方安装通道（npm 包 / git 直装 / 预构建 release .tgz），当前插件在对应通道下分发不完整
+      // [packaging] 场景：说明当前插件的 npm 分发物不完整
       ...(/\[packaging\]/i.test(message)
         ? [
           '',
           '## 安装方式说明',
-          'DSH 插件支持三种官方安装通道：`dsh plugin add <npm-package>`（npm 分发，需发布完整构建产物）、`dsh plugin add git+https://github.com/owner/repo.git`（Git 直装，仓库需提交构建产物），以及预构建 release 包 `dsh plugin add https://github.com/owner/repo/releases/download/<tag>/<asset>.tgz`（仓库不便提交构建产物时的推荐方式）。注意：pnpm ≥10 默认拦截依赖构建脚本，Git 直装不会执行包内 `prepare`，请勿依赖它生成产物。当前插件的分发物缺少它需要的文件（`main` / `exports` 声明的入口、补丁按本包名 mount 的入口，或 `dsh.bundle.patch` 声明的补丁），请提交构建产物、改用 release `.tgz` 直链，或发布完整的 npm 包。',
+          '当前插件的 npm 分发物缺少它需要的文件（`main` / `exports` 声明的入口、补丁按本包名 mount 的入口，或 `dsh.bundle.patch` 声明的补丁）。请发布包含完整构建产物的 npm 包后重试。',
         ]
         : []),
       '',
@@ -192,14 +193,14 @@ export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | nu
 }
 
 /**
- * 插件中心自身仓库的预填 Issue 链接：用于「非插件侧」失败（无法识别的未知原因、
- * 以及 pnpm allowBuilds 拦截这类不再归到插件作者的情形）。正文带上目标插件与完整
+ * 插件中心自身仓库的预填 Issue 链接：用于「非插件侧」失败（无法识别的未知原因，
+ * 以及判定由插件中心自己产出、可能误报时的次要反馈入口）。正文带上目标插件与完整
  * 错误摘要，供插件中心维护者分诊 —— 不再把环境问题/插件中心自身问题误投给插件作者。
  */
 export type HubIssueVariant =
-  /** 缺省：安装器主动把失败送到插件中心分诊（未分类兜底 / allowBuilds 门禁） */
+  /** 缺省：安装器主动把失败送到插件中心分诊（未分类兜底） */
   | 'triage'
-  /** 从「插件打包问题」分支的次要入口提交：该判定由插件中心自己产出，用户怀疑是误报 */
+  /** 从判定由插件中心自己产出的分支（插件打包问题 / allowBuilds 拦截）的次要入口提交：用户怀疑是误报 */
   | 'misjudge'
 
 export function hubIssueUrl(
@@ -210,38 +211,42 @@ export function hubIssueUrl(
   attempts?: string[],
   /** 见 HubIssueVariant；缺省 'triage'，既有正文保持不变 */
   variant: HubIssueVariant = 'triage',
+  /** 上报动作：标题与正文按它取词 */
+  action: FailureAction = 'install',
 ): string {
   const kind = classifyFailure(message)
   const executed = executedCommandOf(command, attempts)
+  const zhWord = actionWordZh(action)
   const repo = pluginRepo && pluginRepo.trim() !== '' ? pluginRepo.trim() : 'unknown'
   const title = variant === 'misjudge'
     // 标题就点明「可能是误判」，维护者一眼能区分它和未分类兜底
     ? `[dsh-plugin-hub] possible misjudgment: ${repo}`
-    : `[dsh-plugin-hub] ${reasonTitleOf(kind)}: ${repo}`
+    : `[dsh-plugin-hub] ${reasonTitleOf(kind, action)}: ${repo}`
   const code = coreErrorCode(message)
   const build = (coreChars: number): string => {
     const body = [
       '## Summary',
-      `- Auto-classified cause: ${reasonTitleOf(kind)}`,
+      `- Auto-classified cause: ${reasonTitleOf(kind, action)}`,
       `- Target plugin: \`${repo}\``,
       ...(code ? [`- Key error: \`${code}\``] : []),
-      // 为什么投递到这里而非插件仓库：只有确有证据是插件自身构建失败（pluginPrepare）才投插件仓库
+      // 为什么投递到这里而非插件仓库：只有确有证据是插件自身构建/分发失败（pluginPrepare、
+      // 或自动放行 allowBuilds 重试后仍失败的构建拦截）才投插件仓库
       ...(variant === 'misjudge'
-        // 这条入口的判据（[packaging] 预检/装后校验、prepare 摘要）是插件中心自己产出的，
-        // 不是 pnpm 原文 —— 一旦我们自己误报，用户就被送去作者仓库、我们永远收不到反馈。
+        // 这些分支的判据由插件中心自己产出、或掺了我们的动作（自动放行 allowBuilds）——
+        // 一旦我们自己误报，用户就被送去作者仓库、我们永远收不到反馈。
         // 正文写清它来自哪条分支、判据是谁给的，维护者才不会把它当成未分类兜底。
         ? [
-          '- Filed from: the plugin-prepare path (which normally routes to the plugin repo) — filed here because that verdict may be our own misjudgment.',
-          '- Source of that verdict: produced by dsh-plugin-hub\'s own pre/post-install check, not by pnpm output.',
+          '- Filed from: a branch that normally routes to the plugin repo — filed here because that verdict may be our own misjudgment.',
+          '- Source of that verdict: produced by dsh-plugin-hub\'s own check or its auto-allow retry, not by plain pnpm output.',
         ]
-        : ['- Why filed here: the installer only routes a failure to the plugin repo when there is positive evidence the plugin build itself failed (pluginPrepare). This failure does not match that, so it is routed here for triage.']),
+        : ['- Why filed here: the installer only routes a failure to the plugin repo when the cause is demonstrably the plugin\'s own build/distribution (pluginPrepare, or build scripts pnpm blocks that even an auto-allow retry cannot get past). This failure does not match that, so it is routed here for triage.']),
       '',
-      `## [DSH Plugin 插件市场](${SITE_URL}) · 安装 Plugin 失败错误信息`,
-      `本错误信息由 [dsh-plugin-hub](${GITHUB_URL}) 插件市场的安装程序自动生成，随本次安装失败一并提交。`,
-      `- 实际执行的安装命令：${executed ? `\`${executed}\`` : 'unknown (no executed command recorded)'}`,
-      `- 执行结果：安装失败，未能安装该插件。`,
+      `## [DSH Plugin 插件市场](${SITE_URL}) · ${zhWord} Plugin 失败错误信息`,
+      `本错误信息由 [dsh-plugin-hub](${GITHUB_URL}) 插件市场的安装程序自动生成，随本次${zhWord}失败一并提交。`,
+      `- 实际执行的${zhWord}命令：${executed ? `\`${executed}\`` : 'unknown (no executed command recorded)'}`,
+      `- 执行结果：${zhWord}失败，未能${zhWord}该插件。`,
       ...(attempts && attempts.length > 0
-        ? ['', '## Attempted install channels（已尝试的安装方式）', ...attempts.map((a) => `- ${a}`)]
+        ? ['', '## Attempted channels（已尝试的方式）', ...attempts.map((a) => `- ${a}`)]
         : []),
       '',
       '## Environment',

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

@@ -2,11 +2,9 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Custom install view: a standalone top-level section for manually
- * installing npm packages or GitHub sources outside the catalog. The two
- * installer cards (npm / GitHub) stack one per line; each card = channel
- * label + example hint above the input + input row (input + install button)
- * + optional format-error note. Colors resolve through the --hub-* tokens.
+ * 自定义安装视图：独立一级板块，用于手动安装目录之外的 npm 包。安装卡片逐行堆叠：
+ * 渠道标签 + 输入框上方的示例提示 + 输入行（输入框 + 安装按钮）+ 可选的格式错误提示。
+ * 颜色经 --hub-* 变量解析。
  */
 
 .root {
@@ -84,31 +82,6 @@
   border-color: var(--hub-brand-border-soft);
 }
 
-/* 命令卡片标题旁的「一键插入更新命令」：右对齐小号描边按钮，弱化但可点，hover 提亮品牌色 */
-.installInsertBtn {
-  flex-shrink: 0;
-  margin-left: auto;
-  font-family: inherit;
-  font-size: 11px;
-  line-height: 16px;
-  font-weight: 500;
-  color: var(--hub-text-secondary);
-  background: transparent;
-  border: 1px solid var(--hub-border-2);
-  border-radius: 6px;
-  padding: 2px 9px;
-  cursor: pointer;
-  white-space: nowrap;
-  user-select: none;
-  transition: color 120ms ease, border-color 120ms ease, background 120ms ease;
-}
-
-.installInsertBtn:hover {
-  color: var(--hub-brand);
-  border-color: var(--hub-brand-border-soft);
-  background: var(--hub-brand-tint);
-}
-
 /* 文本框上方的示例：灰字小字，告诉用户该通道的推荐写法 */
 .installExample {
   font-size: 11px;

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

@@ -2,11 +2,9 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * System diagnostics list: every connectivity probe is one row — name,
- * target address, latency and a live status badge (200 OK / Unreachable /
- * Checking…). The list runs automatically when the page opens; each row is
- * a button — click to re-probe just that channel with a visible
- * running→result feedback loop. Colors resolve through the --hub-* tokens. */
+ * 系统诊断列表：每个连通性探测一行 —— 名称、目标地址、延迟与实时状态徽标
+ * （200 OK / 不可达 / 检测中…）。页面打开时自动跑一轮；每行都是按钮 ——
+ * 点击只重测该通道，形成「运行→结果」的可见反馈闭环。颜色经 --hub-* 变量解析。 */
 
 .panel {
   display: flex;

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

@@ -2,10 +2,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Button-style dropdown: the trigger reads as a compact toolbar button
- * (hairline border + subtle fill + current value + chevron), the panel is
- * a floating menu with hover fills and a brand-highlighted active option.
- * Colors resolve through the --hub-* design tokens. */
+ * 按钮式下拉框：触发器呈现为紧凑工具栏按钮（细边框 + 淡填充 + 当前值 + 箭头），
+ * 面板是浮层菜单，选项有 hover 填充、激活项品牌高亮。颜色经 --hub-* 设计变量解析。 */
 
 .dropdown {
   position: relative;