dsh-plugin 1.1.1 → 1.2.0

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

@@ -0,0 +1,301 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * 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.
+ *
+ * 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.
+ *
+ * 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.
+ */
+import { createElement as h, useCallback, useEffect, useRef, useState } from 'react'
+import type { MouseEvent } from 'react'
+import styles from '../../styles/Modal.module.css'
+import view from '../../styles/LogsView.module.css'
+import type { Translate } from '../../types.ts'
+import { openLogFile } from '../../data/host.ts'
+import { CloseIcon } from '../ui/icons.tsx'
+
+/** 与服务端 /logs 返回的 LogEntry 对齐的客户端投影。 */
+export interface LogEntryView {
+  /** 毫秒时间戳 */
+  at: number
+  level: 'debug' | 'info' | 'success' | 'warn' | 'error'
+  category: 'install' | 'uninstall' | 'update' | 'diagnostics' | 'settings' | 'system'
+  /** 机器可读事件码，如 install.start */
+  event: string
+  message: string
+}
+
+export type LogCategoryFilter = 'all' | LogEntryView['category']
+export type LogLevelFilter = 'all' | LogEntryView['level']
+
+const PAGE = 100
+
+/** 类别筛选标签：值 → 语言包 key（弹窗内 chip 与行内类别徽章共用）。 */
+const CAT_LABEL: Record<LogEntryView['category'], string> = {
+  install: 'logCatInstall',
+  uninstall: 'logCatUninstall',
+  update: 'logCatUpdate',
+  diagnostics: 'logCatDiagnostics',
+  settings: 'logCatSettings',
+  system: 'logCatSystem',
+}
+
+const CAT_FILTERS: Array<{ value: LogCategoryFilter; key: string }> = [
+  { value: 'all', key: 'logCatAll' },
+  { value: 'install', key: 'logCatInstall' },
+  { value: 'uninstall', key: 'logCatUninstall' },
+  { value: 'update', key: 'logCatUpdate' },
+  { value: 'diagnostics', key: 'logCatDiagnostics' },
+  { value: 'settings', key: 'logCatSettings' },
+  { value: 'system', key: 'logCatSystem' },
+]
+
+const LEVEL_FILTERS: Array<{ value: LogLevelFilter; key: string }> = [
+  { value: 'all', key: 'logLvAll' },
+  { value: 'error', key: 'logLvError' },
+  { value: 'warn', key: 'logLvWarn' },
+  { value: 'success', key: 'logLvSuccess' },
+  { value: 'info', key: 'logLvInfo' },
+  { value: 'debug', key: 'logLvDebug' },
+]
+
+/** 级别徽章文案：弹窗 chip 与行内级别徽章共用同一语言包 key。 */
+const LEVEL_LABEL: Record<LogEntryView['level'], string> = {
+  debug: 'logLvDebug',
+  info: 'logLvInfo',
+  success: 'logLvSuccess',
+  warn: 'logLvWarn',
+  error: 'logLvError',
+}
+
+/** 时间：YYYY-MM-DD HH:mm:ss（每条都精确到秒）。 */
+export function fmtLogTime(at: number): string {
+  const d = new Date(at)
+  const pad = (n: number) => String(n).padStart(2, '0')
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`
+}
+
+/** 导出文件名时间戳：2026-08-24_21-35-00。 */
+function fmtFileStamp(at: number): string {
+  const d = new Date(at)
+  const pad = (n: number) => String(n).padStart(2, '0')
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}_${pad(d.getHours())}-${pad(d.getMinutes())}-${pad(d.getSeconds())}`
+}
+
+/** 单条日志行：时间 + 级别徽章 + 类别徽章 + 事件码 + 描述。查看器弹窗与设置页预览共用。 */
+export function LogEntryRow({ e, t }: { e: LogEntryView; t: Translate }) {
+  return h('div', { className: view.entry, title: e.message },
+    h('span', { className: view.time }, fmtLogTime(e.at)),
+    h('span', { className: `${view.badge} ${view[`badge${e.level}`]}` }, t(LEVEL_LABEL[e.level])),
+    h('span', { className: `${view.catBadge} ${view[`cat${e.category}`]}` }, t(CAT_LABEL[e.category])),
+    h('span', { className: view.event }, e.event),
+    h('span', { className: view.message }, e.message),
+  )
+}
+
+export function LogsModal({ t, onClose }: {
+  t: Translate
+  onClose: () => void
+}) {
+  const [category, setCategory] = useState<LogCategoryFilter>('all')
+  const [level, setLevel] = useState<LogLevelFilter>('all')
+  const [query, setQuery] = useState('')
+  const [entries, setEntries] = useState<LogEntryView[]>([])
+  const [total, setTotal] = useState(0)
+  const [hasMore, setHasMore] = useState(false)
+  const [path, setPath] = useState('')
+  const [loading, setLoading] = useState(false)
+  const [error, setError] = useState(false)
+  const [opening, setOpening] = useState(false)
+  const [openFailed, setOpenFailed] = useState(false)
+  const offsetRef = useRef(0)
+
+  /** 拉一页：过滤参数取当前 state，偏移量由调用方给出。 */
+  const fetchPage = useCallback(async (offset: number): Promise<{ entries: LogEntryView[]; total: number; hasMore: boolean; path: string } | null> => {
+    try {
+      const qs = new URLSearchParams({ offset: String(offset), limit: String(PAGE) })
+      if (category !== 'all') qs.set('category', category)
+      if (level !== 'all') qs.set('level', level)
+      const q = query.trim()
+      if (q !== '') qs.set('query', q)
+      const res = await fetch(`/dsh-plugin-hub/logs?${qs.toString()}`, { cache: 'no-store' })
+      if (!res.ok) return null
+      return await res.json() as { entries: LogEntryView[]; total: number; hasMore: boolean; path: string }
+    } catch {
+      return null
+    }
+  }, [category, level, query])
+
+  /** 从第一页重新加载（换筛选/搜索时）。 */
+  const reload = useCallback(async () => {
+    setLoading(true)
+    const data = await fetchPage(0)
+    if (data === null) {
+      setError(true)
+      setLoading(false)
+      return
+    }
+    offsetRef.current = data.entries.length
+    setEntries(data.entries)
+    setTotal(data.total)
+    setHasMore(data.hasMore)
+    if (data.path !== '') setPath(data.path)
+    setError(false)
+    setLoading(false)
+  }, [fetchPage])
+
+  /** 追加下一页（「加载更多」）。 */
+  const loadMore = useCallback(async () => {
+    if (loading) return
+    setLoading(true)
+    const data = await fetchPage(offsetRef.current)
+    if (data === null) {
+      setError(true)
+      setLoading(false)
+      return
+    }
+    offsetRef.current += data.entries.length
+    setEntries((prev) => [...prev, ...data.entries])
+    setTotal(data.total)
+    setHasMore(data.hasMore)
+    setLoading(false)
+  }, [fetchPage, loading])
+
+  // 首次进入 + 类别/级别/搜索变化（搜索 280ms 防抖）都重查第一页
+  const first = useRef(true)
+  useEffect(() => {
+    if (first.current) {
+      first.current = false
+      void reload()
+      return
+    }
+    const id = window.setTimeout(() => { void reload() }, 280)
+    return () => window.clearTimeout(id)
+  }, [reload])
+
+  /** 在系统文件管理器中定位日志文件（服务端 spawn open）。 */
+  const openFile = async () => {
+    if (opening) return
+    setOpening(true)
+    setOpenFailed(false)
+    const ok = await openLogFile()
+    setOpening(false)
+    if (!ok) setOpenFailed(true)
+  }
+
+  /** 导出：拼纯文本 → Blob → 触发浏览器下载 .log 文件 */
+  const exportFile = () => {
+    const text = entries.map((e) => `[${fmtLogTime(e.at)}] [${e.level}] [${e.category}] [${e.event}] ${e.message}`).join('\n')
+    if (text === '') return
+    const blob = new Blob([text], { type: 'text/plain;charset=utf-8' })
+    const url = URL.createObjectURL(blob)
+    const a = document.createElement('a')
+    a.href = url
+    a.download = `dsh-plugin-hub-log-${fmtFileStamp(Date.now())}.log`
+    document.body.appendChild(a)
+    a.click()
+    a.remove()
+    URL.revokeObjectURL(url)
+  }
+
+  return h('div', {
+    className: styles.overlay,
+    onClick: (e: MouseEvent<HTMLDivElement>) => {
+      if (e.target === e.currentTarget) onClose()
+    },
+  },
+    h('div', { className: `${styles.errorModal} ${styles.logModal}`, role: 'dialog', 'aria-modal': 'true' },
+      h('div', { className: styles.modalHead },
+        h('div', { className: styles.modalTitle }, t('logModalTitle')),
+        h('button', {
+          className: styles.modalClose,
+          'aria-label': t('errorClose'),
+          onClick: onClose,
+        }, h(CloseIcon)),
+      ),
+      h('div', { className: styles.modalBody },
+        // 类别筛选行：安装/卸载/更新… 功能域区分
+        h('div', { className: view.filterBar },
+          CAT_FILTERS.map((f) => h('button', {
+            key: f.value,
+            type: 'button',
+            className: category === f.value ? `${view.filterChip} ${view.filterChipActive}` : view.filterChip,
+            onClick: () => setCategory(f.value),
+          }, t(f.key))),
+        ),
+        // 级别筛选行 + 搜索框：按级别区分报错与正常，便于针对性排查
+        h('div', { className: view.filterBar },
+          LEVEL_FILTERS.map((f) => h('button', {
+            key: f.value,
+            type: 'button',
+            className: level === f.value ? `${view.filterChip} ${view.filterChipActive}` : view.filterChip,
+            onClick: () => setLevel(f.value),
+          }, t(f.key))),
+          h('div', { className: view.search },
+            h('input', {
+              className: view.searchInput,
+              type: 'search',
+              value: query,
+              placeholder: t('logSearchPlaceholder'),
+              'aria-label': t('logSearchPlaceholder'),
+              onChange: (e) => setQuery((e.target as HTMLInputElement).value),
+            }),
+          ),
+        ),
+        h('div', { className: view.logList },
+          error
+            ? h('div', { className: view.empty }, t('logsLoadFail'))
+            : loading && entries.length === 0
+              ? h('div', { className: view.empty }, t('logsLoading'))
+              : entries.length === 0
+                ? h('div', { className: view.empty }, t('logEmptyFilter'))
+                : entries.map((e, i) => h(LogEntryRow, { key: `${e.at}-${i}`, e, t })),
+          // 分页：还有就「加载更多」，拉完了给个总数收尾
+          entries.length > 0 && (hasMore
+            ? h('button', {
+              type: 'button',
+              className: view.more,
+              disabled: loading,
+              onClick: () => void loadMore(),
+            }, loading ? t('logsLoading') : t('logLoadMore'))
+            : h('div', { className: view.moreEnd }, t('logNoMore', { n: total }))),
+        ),
+      ),
+      // 底部：日志真实路径 + 打开文件 / 导出日志
+      h('div', { className: view.foot },
+        h('span', { className: view.footPath, title: path },
+          `${t('logPathLabel')}: ${path === '' ? '…' : path}`),
+        openFailed
+          ? h('span', { className: view.footFail }, t('logOpenFileFail'))
+          : h('span', { className: view.footCount }, t('logCount', { n: total })),
+        h('div', { className: view.footActions },
+          h('button', {
+            type: 'button',
+            className: view.btn,
+            disabled: opening || path === '',
+            title: t('logOpenFileTip'),
+            onClick: () => void openFile(),
+          }, t('logOpenFile')),
+          h('button', {
+            type: 'button',
+            className: `${view.btn} ${view.btnPrimary}`,
+            disabled: entries.length === 0,
+            onClick: exportFile,
+          }, t('logsExport')),
+        ),
+      ),
+    ),
+  )
+}

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

@@ -0,0 +1,161 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * 日志存放位置弹窗：设置页不内联长表单（挡视线），点「修改」弹窗编辑。
+ * 两种输入方式并存 —— 手输目录 / .log 文件路径，或点「选择目录」调系统
+ * 原生文件夹对话框（服务端 spawn osascript / FolderBrowserDialog / zenity）。
+ * 文本框预填当前生效位置，目录选择器也从该位置打开 —— 默认地址是动态的
+ * （随用户主目录/平台变化，如 ~/.dsh/profiles/<profile>/hub.log），必须实时展示。
+ * 留空或点「恢复默认」= 回到默认；保存前服务端预验证可写。
+ */
+import { createElement as h, useEffect, useState } from 'react'
+import styles from '../../styles/Modal.module.css'
+import view from '../../styles/LogsView.module.css'
+import type { Translate } from '../../types.ts'
+import { chooseLogDir } from '../../data/host.ts'
+import { CloseIcon } from '../ui/icons.tsx'
+
+export function LogsPathModal({ t, defaultPath, currentPath, onSaved, onClose }: {
+  t: Translate
+  /** 真正默认位置（服务端动态算出的 ~/.dsh/profiles/<profile>/hub.log），跨机器/平台不同 */
+  defaultPath: string
+  /** 当前生效的真实路径（可能已被自定义覆盖） */
+  currentPath: string
+  /** 保存成功回调（写入设置；父级据此刷新生效路径与日志列表） */
+  onSaved: (value: string) => void
+  onClose: () => void
+}) {
+  // 打开即显示当前生效位置 —— 用户一眼看到日志现在存在哪，也方便在此基础上微调
+  const [draft, setDraft] = useState(currentPath)
+  const [saving, setSaving] = useState(false)
+  const [fail, setFail] = useState(false)
+  const [browsing, setBrowsing] = useState(false)
+  const [browseFail, setBrowseFail] = useState(false)
+
+  // Esc 关闭：与其它弹窗交互一致
+  useEffect(() => {
+    const onKey = (e: KeyboardEvent) => { if (e.key === 'Escape') onClose() }
+    window.addEventListener('keydown', onKey)
+    return () => window.removeEventListener('keydown', onKey)
+  }, [onClose])
+
+  /** 保存：空串 = 回默认；填回默认位置同样按「未自定义」处理（设置里保持干净）。
+   * 服务端预建目录验证可写，失败给出反馈。 */
+  const save = async () => {
+    if (saving) return
+    setSaving(true)
+    setFail(false)
+    try {
+      const value = draft.trim()
+      const normalized = value === '' || value === defaultPath ? '' : value
+      const res = await fetch('/dsh-plugin-hub/settings', {
+        method: 'POST',
+        headers: { 'content-type': 'application/json' },
+        body: JSON.stringify({ logPath: normalized }),
+        cache: 'no-store',
+      })
+      if (!res.ok) {
+        setFail(true)
+        return
+      }
+      // 保存成功即关：主界面路径行随即刷新为新位置，本身就是反馈
+      onSaved(normalized)
+      onClose()
+    } catch {
+      setFail(true)
+    } finally {
+      setSaving(false)
+    }
+  }
+
+  /** 选择目录：系统对话框从默认位置打开，选中路径回填输入框（仍可手改）。 */
+  const browse = async () => {
+    if (browsing) return
+    setBrowsing(true)
+    setBrowseFail(false)
+    const picked = await chooseLogDir()
+    setBrowsing(false)
+    if (picked !== null) {
+      setDraft(picked)
+      setFail(false)
+    } else {
+      setBrowseFail(true)
+    }
+  }
+
+  return h('div', {
+    className: styles.overlay,
+    onClick: (e: { target: unknown; currentTarget: unknown }) => {
+      if (e.target === e.currentTarget) onClose()
+    },
+  },
+    h('div', { className: `${styles.modal} ${styles.modalWide}`, role: 'dialog', 'aria-modal': 'true' },
+      h('div', { className: styles.modalHead },
+        h('div', { className: styles.modalTitle }, t('logPathSettingTitle')),
+        h('button', {
+          className: styles.modalClose,
+          'aria-label': t('errorClose'),
+          onClick: onClose,
+        }, h(CloseIcon)),
+      ),
+      h('div', { className: styles.modalBody },
+        h('div', { className: view.pathDialog },
+          h('div', { className: view.pathDialogDesc }, t('logPathSettingDesc')),
+          // 手输路径 + 系统目录选择器两条路并行
+          h('div', { className: view.pathDialogRow },
+            h('input', {
+              type: 'text',
+              className: view.pathDraft,
+              value: draft,
+              placeholder: t('logPathPlaceholder'),
+              spellCheck: false,
+              onChange: (e: { currentTarget: HTMLInputElement }) => {
+                setDraft(e.currentTarget.value)
+                setFail(false)
+                setBrowseFail(false)
+              },
+            }),
+            h('button', {
+              type: 'button',
+              className: view.btn,
+              disabled: browsing,
+              title: t('logPathBrowse'),
+              onClick: () => void browse(),
+            }, browsing ? t('logPathSaving') : t('logPathBrowse')),
+          ),
+          // 提示 + 「恢复默认」：提示左、动作右，一行内不挤
+          h('div', { className: view.pathDialogReset },
+            h('span', { className: view.pathDialogHint }, t('logPathResetHint')),
+            h('button', {
+              type: 'button',
+              className: view.linkBtn,
+              onClick: () => {
+                setDraft(defaultPath)
+                setFail(false)
+                setBrowseFail(false)
+              },
+            }, t('logPathReset')),
+          ),
+          browseFail && h('div', { className: view.footFail }, t('logPathBrowseFail')),
+          fail && h('div', { className: view.footFail }, t('logPathSaveFail')),
+          h('div', { className: view.pathDialogFoot },
+            h('button', {
+              type: 'button',
+              className: view.btn,
+              disabled: saving,
+              onClick: onClose,
+            }, t('confirmCancel')),
+            h('button', {
+              type: 'button',
+              className: `${view.btn} ${view.btnPrimary}`,
+              disabled: saving,
+              onClick: () => void save(),
+            }, saving ? t('logPathSaving') : t('logPathSave')),
+          ),
+        ),
+      ),
+    ),
+  )
+}

package/src/client/components/{NotificationsModal.tsx → modals/NotificationsModal.tsx}

@@ -1,23 +1,27 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * 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 lib/failures.ts),
+ * 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.
+ * header entry button (after the Settings tab).
  */
 import { createElement as h } 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 '../lib/failures.ts'
-import { classifyFailure } from '../lib/failures.ts'
-import type { PendingRestart, QueueTask } from '../hooks/useTaskQueue.ts'
-import { pluginIssueUrl, pluginSiteUrl } from '../lib/catalog.ts'
-import { CloseIcon } from './icons.tsx'
+import styles from '../../styles/Modal.module.css'
+import type { EnvInfo, Translate } from '../../types.ts'
+import type { NotificationRecord } from '../../logic/failures.ts'
+import { classifyFailure, npmTooLowVersion } from '../../logic/failures.ts'
+import type { PendingRestart, QueueTask } from '../../hooks/useTaskQueue.ts'
+import { pluginIssueUrl, pluginSiteUrl } from '../../logic/urls.ts'
+import { CloseIcon } from '../ui/icons.tsx'
 
 /** 记录时间完整展示：YYYY-MM-DD HH:mm:ss（每条通知都带精确到秒的时间戳）。 */
 function fmtTime(at: number): string {
@@ -51,7 +55,7 @@ function BadgeGlyph({ ok }: { ok: boolean }) {
     }))
 }
 
-export function NotificationsModal({ records, tasks, pendingRestarts, t, env, onClose, onCopy, onClear, onRemove, cancelTask, restarting, onRestart }: {
+export function NotificationsModal({ records, tasks, pendingRestarts, t, env, onClose, onCopy, onClear, onRemove, onUpdate, cancelTask, restarting, onRestart }: {
   records: NotificationRecord[]
   /** 进行中的安装/卸载任务（实时进度，与队列弹窗同一数据源） */
   tasks: QueueTask[]
@@ -64,6 +68,8 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
   onClear: () => void
   /** 删除单条通知记录 */
   onRemove: (id: number) => void
+  /** 更新提醒通知点击：跳去该插件的更新确认弹窗 */
+  onUpdate: (repo: string) => void
   cancelTask: (id: number) => void
   restarting: boolean
   onRestart: () => void
@@ -156,9 +162,14 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
           ? h('div', { className: styles.failEmpty }, t('notificationsEmpty'))
           : h('div', { className: styles.noticeList },
             records.map((r) => {
+              const isUpdate = r.kind === 'update'
               return h('div', {
                 key: r.id,
-                className: r.ok ? `${styles.noticeRow} ${styles.noticeRowOk}` : styles.noticeRow,
+                // 更新提醒：整行可点击直达更新确认弹窗；install/uninstall 记录维持原交互
+                className: r.ok
+                  ? `${styles.noticeRow} ${styles.noticeRowOk}${isUpdate ? ` ${styles.noticeRowUpdate}` : ''}`
+                  : styles.noticeRow,
+                ...(isUpdate ? { onClick: () => onUpdate(r.repo), title: t('updateNoticeGo') } : {}),
               },
               h('div', { className: styles.noticeRowMain },
                 h('div', {
@@ -169,17 +180,23 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                     h('span', {
                       className: r.ok ? styles.noticeTextOk : styles.noticeTextFail,
                     }, r.ok
-                      ? (r.kind === 'install' ? t('installDone') : t('uninstallDone'))
+                      ? (isUpdate ? t('updateNoticeTitle') : (r.kind === 'install' ? t('installDone') : t('uninstallDone')))
                       : (r.kind === 'install' ? t('errorTitleInstall') : t('errorTitleUninstall'))),
+                    // 更新提醒：新版本号紧随标题展示；repo 为纯文本（整行点击即去更新，不跳官网外链）
+                    isUpdate && r.version
+                      ? h('span', { className: styles.noticeVersion, title: r.version }, `v${r.version}`)
+                      : null,
                     r.repo
-                      ? h('a', {
-                        className: styles.failRepo,
-                        // 跳转到官网详情页（含插件收录信息），不在通知弹窗直接跳 GitHub
-                        href: pluginSiteUrl(r.repo),
-                        target: '_blank',
-                        rel: 'noopener noreferrer',
-                        title: r.repo,
-                      }, r.repo)
+                      ? (isUpdate
+                        ? h('span', { className: styles.failRepo, title: r.repo }, r.repo)
+                        : h('a', {
+                          className: styles.failRepo,
+                          // 跳转到官网详情页（含插件收录信息），不在通知弹窗直接跳 GitHub
+                          href: pluginSiteUrl(r.repo),
+                          target: '_blank',
+                          rel: 'noopener noreferrer',
+                          title: r.repo,
+                        }, r.repo))
                       : null,
                     !r.ok && h('button', {
                       className: styles.failCopy,
@@ -193,6 +210,13 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                         title: new Date(r.at).toLocaleString(),
                       }, fmtTime(r.at))
                       : null,
+                    // 更新提醒：行尾「去更新」按钮直达更新确认弹窗（整行也可点击）
+                    isUpdate
+                      ? h('button', {
+                        className: styles.noticeUpdateGo,
+                        onClick: (e: MouseEvent<HTMLButtonElement>) => { e.stopPropagation(); onUpdate(r.repo) },
+                      }, t('updateNoticeGo'))
+                      : null,
                     // 每条通知右侧的删除按钮：单独移除这一条
                     h('button', {
                       className: styles.noticeRemove,
@@ -205,6 +229,13 @@ export function NotificationsModal({ records, tasks, pendingRestarts, t, env, on
                   // 卡片不展示错误日志预览，完整日志靠「复制完整日志」按钮带走，避免每条卡片被日志撑高
                   !r.ok && (() => {
                     const kind = classifyFailure(r.message)
+                    if (kind === 'npmTooOld') {
+                      // npm 内部崩溃（edgesOut）＋ 本机 npm 版本过低：npm 自身已知缺陷，不是插件问题 ——
+                      // 直接给升级指引，不引导提 Issue
+                      const v = npmTooLowVersion(r.message)
+                      return h('div', { className: styles.failPrepareHint },
+                        t(v ? 'failNpmTooLowV' : 'failNpmTooLow', v ? { v } : undefined))
+                    }
                     if (kind === 'pluginPrepare' || kind === 'pnpmIgnoredBuild') {
                       // [packaging]（预检/装后校验拦截：git 分发缺产物）与
                       // prepare 构建脚本实际执行失败 / 原生依赖构建被 pnpm 拦截：都是插件打包分发问题 —— 先说明原因，按钮在下方提交

package/src/client/components/{ProgressView.tsx → modals/ProgressView.tsx}

@@ -1,12 +1,16 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * 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.
  */
 import { createElement as h } from 'react'
-import styles from '../styles/Modal.module.css'
-import type { TaskState } from '../types.ts'
+import styles from '../../styles/Modal.module.css'
+import type { TaskState } from '../../types.ts'
 
 export function ProgressView({ task }: { task: TaskState }) {
   return h('div', { className: styles.progress },