dsh-plugin 1.1.0 → 1.1.1

package/src/client/components/modals.tsx

@@ -13,14 +13,18 @@ import { ProgressView } from './ProgressView.tsx'
 import { installCommandOf, pluginDetailUrl, pluginIssueUrl, pluginSiteUrl } from '../lib/catalog.ts'
 import { classifyFailure } from '../lib/failures.ts'
 
-/** 完成结果视图：绿色对勾 + 标题/描述 + 「稍后重启 / 立即重启」按钮对（部分插件需重启后才会挂载） */
+/** 完成结果视图：绿色对勾 + 标题/描述；
+ *  needsRestart=true（插件需重启才生效）→ 「稍后重启 / 立即重启」按钮对，点稍后重启后
+ *  通知中心待重启条目常驻（服务端登记，内存态），直到用户点「立即重启」真正重启后才消失；
+ *  needsRestart=false（卸载已即时生效）→ 仅「完成」关闭。 */
 function ResultView({
-  title, desc, t, restarting, onRestart, onClose,
+  title, desc, t, restarting, needsRestart, onRestart, onClose,
 }: {
   title: string
   desc: string
   t: Translate
   restarting: boolean
+  needsRestart: boolean
   onRestart: () => void
   onClose: () => void
 }) {
@@ -43,12 +47,17 @@ function ResultView({
     ),
     h('div', { className: styles.resultTitle }, title),
     desc ? h('div', { className: styles.resultDesc }, desc) : null,
-    h('div', { className: styles.resultRestarting }, restarting ? t('restarting') : t('restartHint')),
-    h('div', { className: styles.modalActions },
-      h('button', { className: styles.restartLater, onClick: onClose, disabled: restarting }, t('restartLater')),
-      h('button', { className: styles.restartNow, onClick: onRestart, disabled: restarting },
-        restarting ? t('restarting') : t('restartNow')),
-    ),
+    needsRestart
+      ? h('div', null, [
+        h('div', { className: styles.resultRestarting }, restarting ? t('restarting') : t('restartHint')),
+        h('div', { className: styles.modalActions },
+          h('button', { className: styles.restartLater, onClick: onClose, disabled: restarting }, t('restartLater')),
+          h('button', { className: styles.restartNow, onClick: onRestart, disabled: restarting },
+            restarting ? t('restarting') : t('restartNow')),
+        ),
+      ])
+      : h('div', { className: styles.modalActions },
+        h('button', { className: styles.restartNow, onClick: onClose }, t('done'))),
   )
 }
 
@@ -61,8 +70,12 @@ export interface InstallModalProps {
   restarting: boolean
   /** 已安装插件的覆盖更新（走同一条 add 命令原位重装，文案区分安装/更新） */
   update: boolean
+  /** 仅命令行插件（webInstallable=false）：不提供一键安装，只展示命令供复制到 dsh 终端 */
+  cliOnly: boolean
   /** 安装请求在途（fetch 等待响应）：此时任务尚未入队，需禁用确认按钮防止二次点击 */
   submitting: boolean
+  /** 完成结果是否需重启才生效：true → 「稍后重启 / 立即重启」；false → 仅「完成」 */
+  needsRestart: boolean
   onClose: () => void
   onCopy: () => void
   onInstall: () => void
@@ -74,7 +87,7 @@ export interface InstallModalProps {
  * 只在本任务执行中展示实时进度；完成后切换为结果视图，与卸载一致。
  */
 export function InstallModal(props: InstallModalProps) {
-  const { plugin, done, task, t, langPath, restarting, submitting, update, onClose, onCopy, onInstall, onRestart } = props
+  const { plugin, done, task, t, langPath, restarting, submitting, update, cliOnly, needsRestart, onClose, onCopy, onInstall, onRestart } = props
   const busy = submitting || (task !== null && (task.status === 'pending' || task.status === 'running'))
   // 进行中标题带上插件名（中文「XX 插件安装中」；英文状态词在前更自然），并用状态色区分
   const name = plugin.displayName ?? plugin.slug
@@ -112,6 +125,7 @@ export function InstallModal(props: InstallModalProps) {
           desc: update ? t('updateResultDesc') : t('installResultDesc'),
           t,
           restarting,
+          needsRestart,
           onRestart,
           onClose,
         })
@@ -145,8 +159,12 @@ export function InstallModal(props: InstallModalProps) {
             h('span', { className: styles.modalCmdText }, installCommandOf(plugin)),
             h('span', { className: styles.modalCmdCopy }, h(CopyIcon), t('copyCmdLabel')),
           ),
+          // AI 识别可能需要命令行辅助的插件（webInstallable=false）：提示但不拦截，仍允许尝试一键安装
+          cliOnly ? h('div', { className: styles.cliOnlyHint }, t('cliOnlyHint')) : null,
           task && task.status === 'pending' ? h('div', { className: styles.queuedHint }, t('queuedHint')) : null,
           task ? h(ProgressView, { task }) : null,
+          // 安装失败：引导用户复制上方命令到 dsh 终端手动安装（如 node-pty 等原生依赖构建脚本需人工放行）
+          task && task.status === 'failed' ? h('div', { className: styles.failedCopyHint }, t('failedCopyHint')) : null,
           h('div', { className: styles.modalActions },
             h('button', {
               className: styles.modalCopy,
@@ -177,6 +195,8 @@ export interface UninstallModalProps {
   restarting: boolean
   /** 卸载请求在途（fetch 等待响应）：此时任务尚未入队，需禁用确认按钮防止二次点击 */
   submitting: boolean
+  /** 完成结果是否需重启才生效：true → 「稍后重启 / 立即重启」；false（loader 已即时移除）→ 仅「完成」 */
+  needsRestart: boolean
   onClose: () => void
   onCancel: () => void
   onCopyCommand: () => void
@@ -186,7 +206,7 @@ export interface UninstallModalProps {
 
 /** 卸载确认弹窗：确认/进行中（后台队列，可关闭）；完成后切换为结果视图（成功即生效，仅「完成」关闭）。 */
 export function UninstallModal(props: UninstallModalProps) {
-  const { plugin, done, task, t, langPath, restarting, submitting, onClose, onCancel, onCopyCommand, onConfirm, onRestart } = props
+  const { plugin, done, task, t, langPath, restarting, submitting, needsRestart, onClose, onCancel, onCopyCommand, onConfirm, onRestart } = props
   const busy = submitting || (task !== null && (task.status === 'pending' || task.status === 'running'))
   // 进行中标题带上插件名，与安装弹窗一致，并用状态色区分
   const name = plugin.displayName ?? plugin.slug
@@ -221,6 +241,7 @@ export function UninstallModal(props: UninstallModalProps) {
           desc: t('uninstallResultDesc'),
           t,
           restarting,
+          needsRestart,
           onRestart,
           onClose,
         })

package/src/client/hooks/useCatalog.ts

@@ -7,11 +7,14 @@
  */
 import { useEffect, useMemo, useState } from 'react'
 import type { HubPlugin, LocaleId } from '../types.ts'
-import { normalize } from '../lib/catalog.ts'
+import { HUB_ABOUT_URL, HUB_REPO, HUB_UPDATE_URL, normalize, PLUGIN_VERSION } from '../lib/catalog.ts'
+import type { HubAboutInfo, HubUpdateInfo } from '../lib/catalog.ts'
 import type { SortKey } from '../lib/catalog.ts'
 
 const PLUGINS_URL = (lang: LocaleId) => `https://dsh-plugin.org/api/plugins.${lang}.json`
 const STATS_URL = 'https://dsh-plugin.org/api/stats.json'
+/** 插件市场自身仓库：DSH-Plugin Hub 不显示在目录里（自己不进自己的插件列表） */
+const SELF_REPO = 'dshplugin/dsh-plugin-hub'
 
 export function useCatalog(lang: LocaleId) {
   /** 目录插件（仅保留人工验证通过的条目） */
@@ -30,6 +33,10 @@ export function useCatalog(lang: LocaleId) {
   /** 安装时记录的目录信号：repo(小写) -> { version, updatedAt }（来自宿主本地路由）；
    *  npmPackage 为 npm 优先通道反查命中的包名映射（目录数据未下发时客户端靠它把依赖 key 匹配回仓库） */
   const [versions, setVersions] = useState<Record<string, { version: string; updatedAt: string; npmPackage?: string }>>({})
+  /** Hub 自我更新信息：来自 CF Worker 版本控制中心（hub.dsh-plugin.org），与目录数据解耦 */
+  const [hubUpdateInfo, setHubUpdateInfo] = useState<HubUpdateInfo | null>(null)
+  /** 头部「关注我们」弹窗内容（平台介绍 + 反馈群二维码）：来自同款 Worker /about，Markdown 推送非写死 */
+  const [hubAboutInfo, setHubAboutInfo] = useState<HubAboutInfo | null>(null)
 
   // 拉取目录 + 统计。在线 API 已只返回 verified；再过滤一次，保证只展示人工验证通过的插件。
   useEffect(() => {
@@ -42,19 +49,29 @@ export function useCatalog(lang: LocaleId) {
         if (!res.ok) throw new Error(String(res.status))
         return res.json()
       })
-    fetchData(PLUGINS_URL(lang)).then((data) => {
-      if (cancelled) return
-      const list = (Array.isArray(data) ? data : []).map((item) => normalize(item as Record<string, unknown>))
-      setPlugins(list.filter((p) => p.compatibility?.status === 'verified'))
-    }).catch(() => {
-      if (!cancelled) setFailed(true)
-    })
-    fetchData(STATS_URL).then((s) => {
-      const stats = s as { total?: number; verified?: number }
-      if (!cancelled && stats && typeof stats.total === 'number' && typeof stats.verified === 'number') {
-        setStats({ total: stats.total, verified: stats.verified })
-      }
-    }).catch(() => {})
+    // 目录数据直拉：hub 自身版本由独立 Worker 版本控制中心管理，不再依赖主站版本号接口；
+    // 数据接口 CDN 缓存 1 小时，发布新数据后最长 1 小时全网生效。
+    const load = () =>
+      Promise.all([fetchData(PLUGINS_URL(lang)), fetchData(STATS_URL)])
+    load()
+      .then(([data, s]) => {
+        if (cancelled) return
+        const list = (Array.isArray(data) ? data : []).map((item) => normalize(item as Record<string, unknown>))
+        // 插件市场不显示自己：DSH-Plugin Hub 从目录里排除自身条目，
+        // 防止「自己出现在自己的插件列表里、还能自己安装自己」；统计计数同步减 1 保持与列表一致。
+        // 主站数据构建侧已同步防止（registry/API 不再含自身），此处为已发布旧数据/CDN 缓存期的兜底。
+        const hadSelf = list.some((p) => p.source?.repo === SELF_REPO)
+        setPlugins(list.filter((p) => p.compatibility?.status === 'verified' && p.source?.repo !== SELF_REPO))
+        const stats = s as { total?: number; verified?: number }
+        if (stats && typeof stats.total === 'number' && typeof stats.verified === 'number') {
+          setStats(hadSelf
+            ? { total: stats.total - 1, verified: stats.verified - 1 }
+            : { total: stats.total, verified: stats.verified })
+        }
+      })
+      .catch(() => {
+        if (!cancelled) setFailed(true)
+      })
     return () => { cancelled = true }
     // lang 必须进依赖：切换界面语言要重新拉对应语言的数据文件，
     // 否则英文模式仍停留在 plugins.zh.json，描述/名称全是中文
@@ -76,6 +93,42 @@ export function useCatalog(lang: LocaleId) {
   // 首次进入拉取已安装表（依赖宿主 webServer 服务）
   useEffect(() => { refreshInstalled() }, [])
 
+  // Hub 自身版本检查走独立 Worker（版本控制中心）：发新版后写一次 Worker KV，
+  // 所有已装用户立即看到「可更新」+ Markdown 变更记录，不再依赖主站目录数据管道。
+  // 失败静默降级为 null（徽标不出现，不影响目录本身加载）。
+  useEffect(() => {
+    let cancelled = false
+    fetch(HUB_UPDATE_URL, { cache: 'no-store' })
+      .then((res): Promise<HubUpdateInfo | null> => (res.ok ? res.json() : Promise.resolve(null)))
+      .then((data) => {
+        if (cancelled || !data) { if (!cancelled) setHubUpdateInfo(null); return }
+        const version = typeof data.version === 'string' && data.version.length > 0 ? data.version : null
+        setHubUpdateInfo(version === null
+          ? null
+          : { version, publishedAt: data.publishedAt ?? null, notes: data.notes ?? null })
+      })
+      .catch(() => { if (!cancelled) setHubUpdateInfo(null) })
+    return () => { cancelled = true }
+  }, [reloadKey])
+
+  // 「关注我们」内容走同一套 Worker：作者写好 Markdown（平台介绍 + 反馈群二维码）推送 /admin/about，
+  // 客户端下次进入拉 /about 即可看到最新，非写死。失败静默为 null（弹窗展示兜底文案，不阻塞）。
+  useEffect(() => {
+    let cancelled = false
+    fetch(HUB_ABOUT_URL, { cache: 'no-store' })
+      .then((res): Promise<HubAboutInfo | null> => (res.ok ? res.json() : Promise.resolve(null)))
+      .then((data) => {
+        if (cancelled) return
+        if (!data || data.content === null || data.content === undefined) { setHubAboutInfo(null); return }
+        const content = typeof data.content === 'string' || typeof data.content === 'object' ? data.content : null
+        setHubAboutInfo(content === null
+          ? null
+          : { content, updatedAt: data.updatedAt ?? null })
+      })
+      .catch(() => { if (!cancelled) setHubAboutInfo(null) })
+    return () => { cancelled = true }
+  }, [reloadKey])
+
   /** 插件是否已安装：匹配 installed spec 中的 `github:<owner>/<repo>`，或 npm 通道安装的依赖包名；命中返回 npm 包名。 */
   const installedName = (p: HubPlugin): string | null => {
     const repo = p.source?.repo
@@ -119,6 +172,18 @@ export function useCatalog(lang: LocaleId) {
     return Boolean(current && rec.updatedAt && current > rec.updatedAt)
   }
 
+  /**
+   * Hub 自身是否有可用更新：Hub 就是当前运行的应用（始终已安装，无需 installedName 命中）。
+   * 以 Worker 版本控制中心返回的「最新版本」为准，与当前运行的版本号比对——
+   * 构建时注入的 PLUGIN_VERSION 是运行 bundle 的真实版本；测试/异常场景缺失时
+   * 回退到安装时记录的版本。版本号不等即新版（版本号只在发版时变更，绝无降级场景）。
+   */
+  const hubHasUpdate = (() => {
+    if (!hubUpdateInfo) return false
+    const current = PLUGIN_VERSION || versions[HUB_REPO]?.version || null
+    return current !== null && hubUpdateInfo.version !== current
+  })()
+
   /** 当前分类下的插件（「全部」时为整个目录）。 */
   const categoryPlugins = useMemo(() => {
     if (!plugins) return []
@@ -184,6 +249,9 @@ export function useCatalog(lang: LocaleId) {
     installedName,
     installedVersion,
     hasUpdate,
+    hubHasUpdate,
+    hubUpdateInfo,
+    hubAboutInfo,
     refreshInstalled,
     category,
     setCategory,

package/src/client/hooks/useTaskQueue.ts

@@ -33,6 +33,10 @@ export interface QueueTask {
   command?: string
   /** 尝试过的安装方式（npm registry 反查 + 实际执行命令，按先后顺序）：失败时 issue 预填一并贴给作者 */
   attempts?: string[]
+  /** 完成结果是否需要重启才生效（服务端任务终态带出；默认 true 保持老行为：弹窗给重启选项）。
+   *  卸载时 loader 已即时移除 → false，结果视图只显示「完成」；true 时弹窗给「稍后重启/立即重启」，
+   *  通知中心待重启条目（服务端登记）同步常驻，直到用户点「立即重启」。 */
+  needsRestart: boolean
 }
 
 /** 客户端待重启项：镜像服务端内存列表 + 本地补齐的展示信息（简介/版本）。 */
@@ -49,9 +53,10 @@ export interface PendingRestart {
 export interface TaskQueueOptions {
   t: Translate
   refreshInstalled: () => void
-  /** 任务成功完成：viaModal 表示任务对应当前打开弹窗（弹窗切结果视图），否则走 Toast；repo 供成功通知记录。 */
-  onInstallDone: (viaModal: boolean, repo: string | null) => void
-  onUninstallDone: (viaModal: boolean, repo: string | null) => void
+  /** 任务成功完成：viaModal 表示任务对应当前打开弹窗（弹窗切结果视图），否则走 Toast；repo 供成功通知记录；
+   *  needsRestart 表示该任务完成后是否仍需宿主重启（结果视图据此给「重启 / 仅完成」）。 */
+  onInstallDone: (viaModal: boolean, repo: string | null, needsRestart: boolean) => void
+  onUninstallDone: (viaModal: boolean, repo: string | null, needsRestart: boolean) => void
   /** 任务失败：完整输出或兜底文案 + 所属插件仓库 + 操作类型（安装/卸载）+ 实际执行的安装命令（issue 预填用，可缺省）+ 尝试过的安装方式（npm 反查/执行命令，可缺省）。 */
   onError: (message: string, repo: string | null, kind: 'install' | 'uninstall', command?: string, attempts?: string[]) => void
   /** 当前打开的安装/卸载弹窗插件：用于在弹窗内匹配进行中的任务。 */
@@ -168,13 +173,13 @@ export function useTaskQueue(opts: TaskQueueOptions) {
       if (q.kind === 'uninstall') {
         // 卸载成功：清掉本地版本记录
         void syncInstalledVersion(q.repo, undefined, undefined)
-        onUninstallDone(modalTaskRef.current === q.id, q.repo)
+        onUninstallDone(modalTaskRef.current === q.id, q.repo, q.needsRestart)
       } else {
         // 安装成功：记录安装时的目录信号（版本 + 仓库更新时间），供「有更新」比对；
         // 同时缓存展示信息，待重启列表（服务端已登记）合并时直接补齐简介/版本
         void syncInstalledVersion(q.repo, q.version, q.updatedAt)
         pendingInfoRef.current.set(q.target, { desc: q.desc, version: q.version })
-        onInstallDone(modalTaskRef.current === q.id, q.repo)
+        onInstallDone(modalTaskRef.current === q.id, q.repo, q.needsRestart)
       }
     } else {
       // 失败：完整展示全部输出行（最新在前，逆序为日志阅读顺序），不裁剪
@@ -220,25 +225,31 @@ export function useTaskQueue(opts: TaskQueueOptions) {
     try {
       const res = await fetch(`/dsh-plugin-hub/status?task=${q.id}`, { cache: 'no-store' })
       if (res.ok) {
-        const data = await res.json() as { task?: { status?: string; lines?: string[]; attempts?: string[] } }
-        status = data.task?.status ?? 'failed'
-        lines = data.task?.lines ?? []
-        attempts = Array.isArray(data.task?.attempts) ? data.task.attempts : undefined
+        const data = await res.json() as { task?: { status?: string; lines?: string[]; attempts?: string[]; needsRestart?: unknown } }
+        const task = data.task
+        if (task !== undefined) {
+          status = task.status ?? 'failed'
+          lines = task.lines ?? []
+          attempts = Array.isArray(task.attempts) ? task.attempts : undefined
+          // 终态带出的「是否需要重启」覆盖本地（服务端 done 时按 loader 即时移除情况设置）
+          const needsRestart = typeof task.needsRestart === 'boolean' ? task.needsRestart : q.needsRestart
+          if (status === 'done') {
+            const settled = { ...q, needsRestart }
+            // 卸载成功走进度过渡动画；安装成功直接收尾
+            if (q.kind === 'uninstall') settleDone(settled, lines)
+            else finishQueueTask(true, settled, lines)
+            return
+          }
+          if (status === 'failed') {
+            // 服务端终态带出的尝试记录覆盖本地：以实际执行为准
+            finishQueueTask(false, { ...q, attempts }, lines)
+            return
+          }
+        }
       }
     } catch { /* 服务端不可达：按失败处理 */ }
-    if (status === 'done') {
-      // 卸载成功走进度过渡动画；安装成功直接收尾
-      if (q.kind === 'uninstall') settleDone(q, lines)
-      else finishQueueTask(true, q, lines)
-    }
-    else if (status === 'failed') {
-      // 服务端终态带出的尝试记录覆盖本地：以实际执行为准
-      finishQueueTask(false, { ...q, attempts }, lines)
-    }
-    else {
-      applyQueue((prev) => prev.filter((x) => x.id !== q.id)) // cancelled / 未知
-      maybeStopPoll()
-    }
+    applyQueue((prev) => prev.filter((x) => x.id !== q.id)) // cancelled / 未知
+    maybeStopPoll()
   }
 
   /** 轮询整个队列：合并服务端 /active（running 在前、pending 在后），
@@ -250,7 +261,7 @@ export function useTaskQueue(opts: TaskQueueOptions) {
         const res = await fetch('/dsh-plugin-hub/active', { cache: 'no-store' })
         if (!res.ok) throw new Error(`active ${res.status}`)
         const data = await res.json() as {
-          tasks?: { id?: unknown; action?: unknown; target?: unknown; status?: unknown; progress?: unknown; lines?: unknown; attempts?: unknown }[]
+          tasks?: { id?: unknown; action?: unknown; target?: unknown; status?: unknown; progress?: unknown; lines?: unknown; attempts?: unknown; needsRestart?: unknown }[]
           pendingRestarts?: unknown
         }
         const active = (data.tasks ?? []).filter((a) => typeof a.id === 'number')
@@ -279,6 +290,7 @@ export function useTaskQueue(opts: TaskQueueOptions) {
                 progress: typeof a.progress === 'number' ? a.progress : prevTask?.progress ?? 0,
                 lines: Array.isArray(a.lines) ? (a.lines as string[]) : (prevTask?.lines ?? []),
                 attempts: Array.isArray(a.attempts) ? (a.attempts as string[]) : (prevTask?.attempts ?? []),
+                needsRestart: typeof a.needsRestart === 'boolean' ? a.needsRestart : (prevTask?.needsRestart ?? true),
               })
             }
             // 保留乐观条目：服务端尚未登记（preflight 中），无真实 id，不能因 active 缺它就被合并吞掉
@@ -319,7 +331,7 @@ export function useTaskQueue(opts: TaskQueueOptions) {
         const res = await fetch('/dsh-plugin-hub/active', { cache: 'no-store' })
         if (!res.ok) return
         const data = await res.json() as {
-          tasks?: { id?: unknown; action?: unknown; target?: unknown; status?: unknown; progress?: unknown; lines?: unknown; attempts?: unknown }[]
+          tasks?: { id?: unknown; action?: unknown; target?: unknown; status?: unknown; progress?: unknown; lines?: unknown; attempts?: unknown; needsRestart?: unknown }[]
           pendingRestarts?: unknown
         }
         if (cancelled) return
@@ -343,6 +355,7 @@ export function useTaskQueue(opts: TaskQueueOptions) {
               progress: typeof a.progress === 'number' ? a.progress : 0,
               lines: Array.isArray(a.lines) ? (a.lines as string[]) : [],
               attempts: Array.isArray((a as { attempts?: unknown }).attempts) ? ((a as { attempts: string[] }).attempts) : [],
+              needsRestart: typeof (a as { needsRestart?: unknown }).needsRestart === 'boolean' ? (a as { needsRestart: boolean }).needsRestart : true,
             }
           })
         if (items.length > 0 || pendingRef.current.length > 0) {
@@ -382,7 +395,7 @@ export function useTaskQueue(opts: TaskQueueOptions) {
       status: 'running', progress: 0, lines: [], optimistic: true,
       command: installCommandOf(p, true),
       // 服务端登记后 /active 会带回真实尝试记录（npm 反查 + 执行命令），先占位空列表
-      attempts: [],
+      attempts: [], needsRestart: true,
     }])
     setSubmitting(true)
     try {
@@ -442,7 +455,7 @@ export function useTaskQueue(opts: TaskQueueOptions) {
       }
       const taskId = data.task
       modalTaskRef.current = taskId
-      applyQueue((prev) => [...prev, { id: taskId, kind: 'uninstall', target: name, desc: p.description, repo, status: 'pending', progress: 0, lines: [] }])
+      applyQueue((prev) => [...prev, { id: taskId, kind: 'uninstall', target: name, desc: p.description, repo, status: 'pending', progress: 0, lines: [], needsRestart: true }])
       // 摘要条常驻顶部（含实时进度），明细面板保持折叠，想看时再点开
       pollQueue()
     } catch {

package/src/client/lib/catalog.ts

@@ -11,6 +11,36 @@ export const SITE_URL = 'https://dsh-plugin.org/'
 /** 插件中心源码仓库：头部右上角 GitHub 图标的跳转地址 */
 export const GITHUB_URL = 'https://github.com/dshplugin/dsh-plugin-hub'
 
+/** Hub 自身在目录数据里的仓库标识：头部版本号旁的「可更新」徽标按它定位自己。 */
+export const HUB_REPO = 'dshplugin/dsh-plugin-hub'
+
+/**
+ * Hub 自我更新版本控制中心（Cloudflare Worker：dsh-update）。
+ * 发新版后向 Worker 管理接口写入最新版本 + Markdown 变更记录（见
+ * dsh-update-worker 的 POST /admin/hub），所有已装用户的「可更新」徽标即时出现，
+ * 不再依赖主站目录数据管道（每日刷新 + 重建站点）。
+ * 响应：{ version: string | null, publishedAt: string | null, notes: string | {zh,en} | null }
+ */
+export const HUB_UPDATE_URL = 'https://hub.dsh-plugin.org/hub'
+
+/** Worker 版本控制中心返回的 Hub 自我更新信息（notes 为 Markdown 变更记录）。 */
+export interface HubUpdateInfo {
+  version: string
+  publishedAt?: string | null
+  /** Markdown 变更记录；可传字符串，或 { zh, en } 双语言对象按界面语言取 */
+  notes?: string | Record<string, string> | null
+}
+
+/** Worker「关注我们」内容接口（同款 Worker，key = hub:about，Markdown 推送非写死）。 */
+export const HUB_ABOUT_URL = 'https://hub.dsh-plugin.org/about'
+
+/** Worker 返回的「关注我们」内容（content 为 Markdown，可字符串或 {zh,en} 双语言对象）。 */
+export interface HubAboutInfo {
+  /** Markdown 平台介绍 + 反馈群二维码；可传字符串，或 { zh, en } 双语言对象按界面语言取 */
+  content?: string | Record<string, string> | null
+  updatedAt?: string | null
+}
+
 /** 构建时由 tsdown 从 package.json 注入的插件版本号（见 tsdown.config.ts define）。 */
 declare const __PLUGIN_VERSION__: string
 
@@ -173,6 +203,8 @@ export function normalize(raw: Record<string, unknown>): HubPlugin {
             npmPackage: typeof (raw.r as { npmPackage?: unknown }).npmPackage === 'string' ? (raw.r as { npmPackage: string }).npmPackage : undefined,
           }
           : undefined,
+      // 能否网页一键安装：API 仅在 false 时下发 wi（缺省视为 true），据此禁用一键安装、只提示命令行
+      install: raw.wi === false ? { webInstallable: false } : undefined,
       compatibility: typeof raw.v === 'string' ? { status: raw.v } : undefined,
       dates: {
         repoUpdatedAt: typeof raw.u === 'string' ? raw.u : undefined,

package/src/client/lib/renderMarkdown.ts

@@ -0,0 +1,116 @@
+/**
+ * 轻量 Markdown 渲染器：仅用于 Hub 自我更新的变更记录（Worker 下发的 notes）。
+ *
+ * 内容由插件作者自己编写、属可信内容，但渲染端仍先整体 HTML 转义，再按
+ * Markdown 语法输出结构，杜绝任何未转义的原始 HTML 注入；链接仅放行 http(s)。
+ *
+ * 支持：标题(#~####)、有序/无序列表、代码块(```)、行内代码、加粗、斜体、
+ * 链接、图片(![alt](url)，如反馈群二维码)、引用(>)、段落；其余语法一律按
+ * 纯文本处理，不引入外部依赖。图片仅放行 http(s)，限定最大宽度不撑破弹窗。
+ */
+
+/** HTML 转义：所有文本先进这里，再进入结构变换，保证输出里没有未转义的用户输入。 */
+function escapeHtml(s: string): string {
+  return s
+    .replace(/&/g, '&')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;')
+}
+
+/** 行内变换：链接 / 加粗 / 斜体 / 行内代码（代码先占位保护，最后还原）。 */
+function inline(s: string): string {
+  let out = escapeHtml(s)
+  // 行内代码先占位：避免其中的 * [ ] 被后续链接/加粗/斜体规则破坏
+  const codeSpans: string[] = []
+  out = out.replace(/`([^`]+)`/g, (_m, code) => {
+    codeSpans.push(String(code))
+    return `\u0000${codeSpans.length - 1}\u0000`
+  })
+  // 图片 ![alt](url)：仅放行 http(s)，用于展示反馈群二维码等；limited by CSS
+  out = out.replace(/!\[([^\]]*)\]\(([^)\s]+)\)/g, (m, alt, url) =>
+    /^https?:\/\//i.test(String(url)) && !/[\u0000]/.test(String(url))
+      ? `<img src="${String(url)}" alt="${String(alt)}" loading="lazy">`
+      : m,
+  )
+  // 链接 [text](url)：仅放行 http(s)，新窗口打开
+  out = out.replace(/\[([^\]]+)\]\(([^)\s]+)\)/g, (m, text, url) =>
+    /^https?:\/\//i.test(String(url)) && !/[\u0000]/.test(String(url))
+      ? `<a href="${String(url)}" target="_blank" rel="noopener noreferrer">${String(text)}</a>`
+      : m,
+  )
+  out = out.replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>')
+  out = out.replace(/(^|[^*])\*([^*]+)\*/g, '$1<em>$2</em>')
+  return out.replace(/\u0000(\d+)\u0000/g, (_m, idx) => `<code>${codeSpans[Number(idx)]}</code>`)
+}
+
+/** 把变更记录 Markdown 渲染为安全的 HTML 字符串（由弹窗用 dangerouslySetInnerHTML 注入）。 */
+export function renderMarkdown(md: string): string {
+  const lines = md.replace(/\r\n?/g, '\n').split('\n')
+  const blocks: string[] = []
+  let i = 0
+  while (i < lines.length) {
+    const line = lines[i]
+    // 围栏代码块
+    if (/^\s*```/.test(line)) {
+      const buf: string[] = []
+      i++
+      while (i < lines.length && !/^\s*```/.test(lines[i])) {
+        buf.push(lines[i])
+        i++
+      }
+      i++ // 跳过闭合围栏
+      blocks.push(`<pre><code>${escapeHtml(buf.join('\n'))}</code></pre>`)
+      continue
+    }
+    // 空行：段落分隔符
+    if (line.trim() === '') {
+      i++
+      continue
+    }
+    // 标题：# 到 #### 映射为 h2~h5（弹窗标题用 modalTitle，不与其冲突）
+    const heading = line.match(/^(#{1,4})\s+(.*)/)
+    if (heading) {
+      const level = heading[1].length + 1
+      blocks.push(`<h${level}>${inline(heading[2])}</h${level}>`)
+      i++
+      continue
+    }
+    // 有序 / 无序列表（连续收集为一个列表块）
+    if (/^\s*[-*+]\s+/.test(line) || /^\s*\d+[.)]\s+/.test(line)) {
+      const ordered = /^\s*\d+[.)]\s+/.test(line)
+      const items: string[] = []
+      while (i < lines.length && (/^\s*[-*+]\s+/.test(lines[i]) || /^\s*\d+[.)]\s+/.test(lines[i]))) {
+        items.push(`<li>${inline(lines[i].replace(/^\s*[-*+]|\s*\d+[.)]\s*/, '').trim())}</li>`)
+        i++
+      }
+      blocks.push(`<${ordered ? 'ol' : 'ul'}>${items.join('')}</${ordered ? 'ol' : 'ul'}>`)
+      continue
+    }
+    // 引用
+    if (/^\s*>\s?/.test(line)) {
+      const buf: string[] = []
+      while (i < lines.length && /^\s*>\s?/.test(lines[i])) {
+        buf.push(inline(lines[i].replace(/^\s*>\s?/, '')))
+        i++
+      }
+      blocks.push(`<blockquote>${buf.join('<br>')}</blockquote>`)
+      continue
+    }
+    // 普通段落：收集连续非空、非特殊开头的行
+    const buf: string[] = []
+    while (
+      i < lines.length
+      && lines[i].trim() !== ''
+      && !/^\s*```/.test(lines[i])
+      && !/^#{1,4}\s+/.test(lines[i])
+      && !/^\s*([-*+]|\d+[.)])\s+/.test(lines[i])
+    ) {
+      buf.push(inline(lines[i]))
+      i++
+    }
+    blocks.push(`<p>${buf.join('<br>')}</p>`)
+  }
+  return blocks.join('')
+}

package/src/client/locales.ts

@@ -21,6 +21,9 @@ export const zh = {
   failedDesc: '请稍后重试，或点击右上角按钮在浏览器中打开插件中心。',
   retry: '重试',
   install: '安装',
+  // AI 识别可能需要命令行辅助的插件（webInstallable=false）：仍可尝试一键安装，失败时复制命令去 dsh 终端
+  cliOnlyHint: '此插件可能需命令行辅助，失败时复制上方命令到 dsh 终端',
+  failedCopyHint: '安装失败。请复制上方安装命令到 dsh 终端手动执行（原生依赖构建脚本可能需要人工放行，如 pnpm approve-builds）',
   toastCopied: '安装命令已复制，去 dsh 终端粘贴即可安装',
   installed: '已安装',
   notInstalled: '未安装',
@@ -65,6 +68,7 @@ export const zh = {
   restartLater: '稍后重启',
   restarting: '正在重启…',
   restartHint: '部分插件（如插件市场、顶层 bundle）需重启后才会生效。',
+  done: '完成',
   // 待重启：装完没重启的插件常驻提醒，直到宿主真正重启
   restartPendingHint: '安装成功，重启后生效',
   restartPendingHintUninstall: '卸载成功，重启后移除',
@@ -120,6 +124,22 @@ export const zh = {
   update: '可更新',
   updateAvailable: '有更新',
   updateAvailableHint: '检测到更新：有版本号的仓库比对版本号，无版本号的仓库比对仓库最近更新时间',
+  hubUpdateHint: '检测到 DSH-Plugin Hub 新版本，点击查看更新内容并更新',
+  hubUpdateTitle: 'DSH-Plugin Hub 有新版本',
+  hubUpdateDesc: 'v{version} 已发布，点击下方按钮即可更新，完成后需重启宿主生效。',
+  hubUpdatePublished: '发布于',
+  hubUpdateNotes: '更新记录',
+  hubUpdateLater: '稍后再说',
+  versionHint: '查看版本信息与更新记录',
+  hubCurrentTitle: '当前版本',
+  hubCurrentDesc: '你正在使用 v{version}，已是最新版本。',
+  hubUpToDate: '已是最新版本',
+  // 头部「关注我们」弹窗：平台介绍 + 用户反馈群二维码（内容由 Worker /about Markdown 推送，非写死）
+  followUs: '关注我们',
+  aboutTitle: '关注我们',
+  aboutDesc: '了解 DSH-Plugin Hub 是做什么的，加入用户反馈群随时交流。',
+  aboutEmpty: '内容暂未发布，敬请期待。',
+  aboutUpdated: '更新于',
   empty: '该分类暂无插件',
   dataFrom: '数据源 dsh-plugin.org · 每日人工更新',
 }
@@ -146,6 +166,10 @@ export const en = {
   failedDesc: 'Please retry, or open the hub in your browser with the button above.',
   retry: 'Retry',
   install: 'Install',
+  // AI-flagged plugins that may need command-line help (webInstallable=false): one-click install still allowed,
+  // on failure the user is guided to copy the command into the dsh terminal
+  cliOnlyHint: 'This plugin may need command-line help; if it fails, copy the command above and run it in your dsh terminal',
+  failedCopyHint: 'Install failed. Copy the command above and run it manually in your dsh terminal (native build scripts may need manual approval, e.g. pnpm approve-builds)',
   toastCopied: 'Install command copied — paste it in your dsh terminal',
   installed: 'Installed',
   notInstalled: 'Not installed',
@@ -190,6 +214,7 @@ export const en = {
   restartLater: 'Later',
   restarting: 'Restarting…',
   restartHint: 'Some plugins (such as plugin markets / top-level bundles) only take effect after a restart.',
+  done: 'Done',
   restartPendingHint: 'Installed — takes effect after restart',
   restartPendingHintUninstall: 'Removed — cleaned up after restart',
   sectionPendingRestart: 'Pending restart',
@@ -243,6 +268,22 @@ export const en = {
   update: 'Update',
   updateAvailable: 'Update available',
   updateAvailableHint: 'An update was detected: repos with a release are compared by tag, repos without one by last push time',
+  hubUpdateHint: 'A new DSH-Plugin Hub version is available — click to view the changelog and update',
+  hubUpdateTitle: 'A new DSH-Plugin Hub version is available',
+  hubUpdateDesc: 'v{version} has been released — click below to update, then restart the host to apply it.',
+  hubUpdatePublished: 'Published',
+  hubUpdateNotes: "What's new",
+  hubUpdateLater: 'Later',
+  versionHint: 'View version info and changelog',
+  hubCurrentTitle: 'Current version',
+  hubCurrentDesc: 'You are on v{version} — this is the latest version.',
+  hubUpToDate: 'Up to date',
+  // Header "Follow us" modal: platform intro + user feedback group QR (content pushed via Worker /about Markdown)
+  followUs: 'Follow us',
+  aboutTitle: 'Follow us',
+  aboutDesc: 'Learn what DSH-Plugin Hub does and join our user feedback group.',
+  aboutEmpty: 'Content not published yet — stay tuned.',
+  aboutUpdated: 'Updated',
   empty: 'No plugins in this category yet',
   dataFrom: 'Data from dsh-plugin.org · curated daily',
 }