dsh-plugin 1.1.0 → 1.1.2

package/src/client/hooks/useCatalog.ts

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Catalog data + view state for the Plugin Hub section.
  *
  * Owns the online-data pipeline (live fetch from dsh-plugin.org), the local
@@ -7,11 +11,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, repoFromInstallTarget } 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 +37,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 +53,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 保持与列表一致。
+        // 主站数据已同步排除自身，此处为 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,13 +97,49 @@ export function useCatalog(lang: LocaleId) {
   // 首次进入拉取已安装表（依赖宿主 webServer 服务）
   useEffect(() => { refreshInstalled() }, [])
 
-  /** 插件是否已安装：匹配 installed spec 中的 `github:<owner>/<repo>`，或 npm 通道安装的依赖包名；命中返回 npm 包名。 */
+  // 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])
+
+  /** 插件是否已安装：匹配 Git spec 中的 owner/repo，或 npm 通道安装的依赖包名；命中返回 npm 包名。 */
   const installedName = (p: HubPlugin): string | null => {
     const repo = p.source?.repo
     if (!repo) return null
-    const needle = `github:${repo.toLowerCase()}`
+    const needle = repo.toLowerCase()
     for (const [name, spec] of Object.entries(installed)) {
-      if (spec.toLowerCase().includes(needle)) return name
+      if (repoFromInstallTarget(spec).toLowerCase() === needle) return name
     }
     // npm 通道安装：profile 依赖 key 直接是 npm 包名。包名来源两处——目录数据（npmPackage），
     // 或服务端 npm 优先反查持久化的映射（versions[repo].npmPackage，覆盖组织 scope 与 GitHub
@@ -119,6 +176,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 +253,9 @@ export function useCatalog(lang: LocaleId) {
     installedName,
     installedVersion,
     hasUpdate,
+    hubHasUpdate,
+    hubUpdateInfo,
+    hubAboutInfo,
     refreshInstalled,
     category,
     setCategory,

package/src/client/hooks/useTaskQueue.ts

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Background install/remove task queue for the Plugin Hub.
  *
  * Mirrors the server-side FIFO active queue by polling /active, settles
@@ -7,7 +11,7 @@
  */
 import { useEffect, useRef, useState } from 'react'
 import type { HubPlugin, Translate } from '../types.ts'
-import { installCommandOf, installTargetOf } from '../lib/catalog.ts'
+import { installCommandOf, installTargetOf, repoFromInstallTarget } from '../lib/catalog.ts'
 
 /** 客户端任务队列项：镜像服务端 active 任务（running 在前、pending 在后）。 */
 export interface QueueTask {
@@ -33,11 +37,15 @@ export interface QueueTask {
   command?: string
   /** 尝试过的安装方式（npm registry 反查 + 实际执行命令，按先后顺序）：失败时 issue 预填一并贴给作者 */
   attempts?: string[]
+  /** 完成结果是否需要重启才生效（服务端任务终态带出；默认 true 保持老行为：弹窗给重启选项）。
+   *  卸载时 loader 已即时移除 → false，结果视图只显示「完成」；true 时弹窗给「稍后重启/立即重启」，
+   *  通知中心待重启条目（服务端登记）同步常驻，直到用户点「立即重启」。 */
+  needsRestart: boolean
 }
 
 /** 客户端待重启项：镜像服务端内存列表 + 本地补齐的展示信息（简介/版本）。 */
 export interface PendingRestart {
-  /** owner/repo（展示用，已去 github: 前缀） */
+  /** owner/repo（展示用，已从安装目标归一化） */
   target: string
   /** 待重启语义：install 装完等挂载 / uninstall 卸完等清理 */
   kind: 'install' | 'uninstall'
@@ -49,9 +57,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
   /** 当前打开的安装/卸载弹窗插件：用于在弹窗内匹配进行中的任务。 */
@@ -115,7 +124,7 @@ export function useTaskQueue(opts: TaskQueueOptions) {
     setQueue(next)
   }
 
-  /** 解析服务端待重启列表（`github:` 前缀已去掉，与安装任务的 target 对齐）。 */
+  /** 解析服务端待重启列表（安装目标归一化为 owner/repo，与安装任务对齐）。 */
   const parsePendingRestarts = (value: unknown): PendingRestart[] => {
     if (!Array.isArray(value)) return []
     const out: PendingRestart[] = []
@@ -125,7 +134,7 @@ export function useTaskQueue(opts: TaskQueueOptions) {
       if (typeof target !== 'string' || target === '') continue
       const at = (x as { at?: unknown }).at
       out.push({
-        target: target.replace(/^github:/, ''),
+        target: repoFromInstallTarget(target),
         kind: (x as { kind?: unknown }).kind === 'uninstall' ? 'uninstall' : 'install',
         at: typeof at === 'number' ? at : 0,
       })
@@ -168,13 +177,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 +229,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 +265,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')
@@ -269,9 +284,9 @@ export function useTaskQueue(opts: TaskQueueOptions) {
               next.push({
                 id,
                 kind: isRemove ? 'uninstall' : 'install',
-                target: typeof a.target === 'string' ? a.target.replace(/^github:/, '') : (prevTask?.target ?? ''),
+                target: typeof a.target === 'string' ? repoFromInstallTarget(a.target) : (prevTask?.target ?? ''),
                 desc: prevTask?.desc,
-                repo: prevTask?.repo ?? (isRemove ? null : (typeof a.target === 'string' ? a.target.replace(/^github:/, '') : null)),
+                repo: prevTask?.repo ?? (isRemove ? null : (typeof a.target === 'string' ? repoFromInstallTarget(a.target) : null)),
                 // 安装时快照的目录信号：轮询合并时保留，任务成功后记录到本地
                 version: prevTask?.version,
                 updatedAt: prevTask?.updatedAt,
@@ -279,6 +294,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 +335,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
@@ -329,11 +345,11 @@ export function useTaskQueue(opts: TaskQueueOptions) {
           .filter((a) => typeof a.id === 'number')
           .map((a) => {
             const isRemove = a.action === 'remove'
-            // 服务端任务的 target：github:repo（git 安装）/ npm 包名（npm 安装/卸载）。
+            // 服务端任务的 target：显式 HTTPS Git URL（安装）/ npm 包名（npm 安装/卸载）。
             // 恢复展示统一用 displayTarget（owner/repo，服务端固定传）：npm 安装时 target 是包名，
             // 直接展示会让用户看到「安装方式」的内部细节，违背无感知原则；卸载保持包名（匹配已装表）。
-            const display = typeof (a as { displayTarget?: unknown }).displayTarget === 'string' ? (a as { displayTarget: string }).displayTarget.replace(/^github:/, '') : ''
-            const fallback = typeof a.target === 'string' ? a.target.replace(/^github:/, '') : ''
+            const display = typeof (a as { displayTarget?: unknown }).displayTarget === 'string' ? repoFromInstallTarget((a as { displayTarget: string }).displayTarget) : ''
+            const fallback = typeof a.target === 'string' ? repoFromInstallTarget(a.target) : ''
             return {
               id: a.id as number,
               kind: (isRemove ? 'uninstall' : 'install') as 'install' | 'uninstall',
@@ -343,6 +359,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 +399,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 +459,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/index.tsx

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * dsh-plugin client entry: wires the Plugin Hub into the host settings via
  * the module-loader bundle (see tsdown.config.ts). All UI logic lives in
  * PluginHubSection; this file only performs the cordis apply wiring.

package/src/client/lib/catalog.ts

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Catalog constants and normalizers: site URLs, category metadata, sort keys
  * and the mapping from the online API's short-key payloads to HubPlugin.
  */
@@ -11,6 +15,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
 
@@ -29,7 +63,7 @@ export function langPathOf(lang: LocaleId): string {
 
 /**
  * 官网详情页两级路径：/plugins/{ownerSlug}/{slug}；
- * 旧数据缺 ownerSlug 时从 repo 推导（卡片详情按钮与弹窗来源行共用）。
+ * 缺 ownerSlug 时从 repo 推导（卡片详情按钮与弹窗来源行共用）。
  */
 export function pluginDetailUrl(plugin: HubPlugin, langPath: string): string {
   const repo = plugin.source?.repo ?? ''
@@ -77,7 +111,7 @@ export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | nu
       // 来源说明：标题（链官网）+ 一句来源（链仓库）+ 实际执行的安装命令（含 --profile）与执行结果，链接由常量动态拼接
       `## [DSH-Plugin 插件中心](${SITE_URL}) · 安装 Plugin 失败错误信息`,
       `本错误信息由 [dsh-plugin-hub](${GITHUB_URL}) 插件中心的安装程序自动生成，随本次安装失败一并提交。`,
-      `- 实际执行的安装命令：\`${command ?? `dsh plugin${env?.profile ? ` --profile ${env.profile}` : ''} add github:${repo}`}\``,
+      `- 实际执行的安装命令：\`${command ?? `dsh plugin${env?.profile ? ` --profile ${env.profile}` : ''} add git+https://github.com/${repo}.git`}\``,
       `- 执行结果：安装失败，未能安装该插件。`,
       // 尝试过的安装方式（npm 反查 + 实际执行命令，按先后顺序）：作者据此反推正确的
       // npm 包名 —— 组织 scope 与 GitHub 用户名不一致时仅凭仓库名猜不到，作者看到我们
@@ -90,7 +124,7 @@ export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | nu
         ? [
           '',
           '## 安装方式说明',
-          'DSH 插件支持两种官方安装通道：`dsh plugin add <npm-package>`（npm 分发，需发布完整构建产物）与 `dsh plugin add github:owner/repo`（git 直装，仓库需提交构建产物或在 package.json 提供 `prepare` 脚本）。当前插件的分发物缺少 package.json 声明的入口文件，请按所用通道补齐后重新发布。',
+          'DSH 插件支持两种官方安装通道：`dsh plugin add <npm-package>`（npm 分发，需发布完整构建产物）与 `dsh plugin add git+https://github.com/owner/repo.git`（Git 直装，仓库需提交构建产物或在 package.json 提供 `prepare` 脚本）。当前插件的分发物缺少 package.json 声明的入口文件，请按所用通道补齐后重新发布。',
         ]
         : []),
       '',
@@ -164,7 +198,7 @@ export function normalize(raw: Record<string, unknown>): HubPlugin {
       topics: Array.isArray(raw.t) ? (raw.t as string[]) : undefined,
       features: Array.isArray(raw.f) ? (raw.f as string[]) : undefined,
       description: typeof raw.d === 'string' ? raw.d : undefined,
-      // 投影输出两种形态：老数据 source 是 repo 字符串；新数据是 { repo, npmPackage }
+      // source 双形态：字符串 repo，或 { repo, npmPackage } 对象
       source: typeof raw.r === 'string'
         ? { repo: raw.r }
         : raw.r !== null && typeof raw.r === 'object'
@@ -173,6 +207,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,
@@ -199,12 +235,29 @@ export function installTargetOf(p: HubPlugin): { target: string; via: 'npm' | 'g
   return { target: repo, via: 'github' }
 }
 
-/** 展示用安装命令（复制/弹窗）：npm 通道显示包名，git 通道显示 github: 源。 */
+/** 展示用安装命令（复制/弹窗）：npm 通道显示包名，git 通道显示显式 HTTPS URL。 */
 export function installCommandOf(p: HubPlugin, withProfile = false): string {
   const { target, via } = installTargetOf(p)
   return via === 'npm'
     ? `dsh plugin${withProfile ? ' --profile web' : ''} add ${target}`
-    : `dsh plugin${withProfile ? ' --profile web' : ''} add github:${target}`
+    : `dsh plugin${withProfile ? ' --profile web' : ''} add git+https://github.com/${target}.git`
+}
+
+/** Normalize a task/install target to its owner/repo display identity. */
+export function repoFromInstallTarget(value: string): string {
+  const input = value.trim()
+  if (/^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/.test(input)) return input
+  const patterns = [
+    /^github:([^/]+)\/([^/]+)$/i,
+    /^(?:git\+)?https:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:[?#].*)?$/i,
+    /^(?:git\+)?ssh:\/\/(?:git@)?github\.com\/([^/]+)\/([^/]+?)(?:\.git)?(?:[?#].*)?$/i,
+    /^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?(?:[?#].*)?$/i,
+  ]
+  for (const pattern of patterns) {
+    const match = pattern.exec(input)
+    if (match !== null) return `${match[1]}/${match[2]}`
+  }
+  return value
 }
 
 export const CATEGORY_LABELS: Record<string, { zh: string; en: string }> = {

package/src/client/lib/env.ts

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * One-shot host environment snapshot for bug reports. Fetched lazily and
  * cached at module level: issue URLs embed this info, and the environment
  * does not change during a session. A failed fetch degrades to null so the

package/src/client/lib/failures.ts

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Persistent install/remove notifications.
  *
  * Every settled task — success or failure — is appended to localStorage the
@@ -114,7 +118,7 @@ export function loadNotifications(): NotificationRecord[] {
     return list
       .filter((r): r is NotificationRecord =>
         !!r && typeof r === 'object' && typeof (r as { message?: unknown }).message === 'string')
-      // 历史失败记录没有 ok 字段：缺省按失败渲染，保证旧数据照常可查
+      // ok 字段缺省时按失败渲染
       .map((r) => ({ ...r, ok: r.ok === true }))
   } catch {
     return []

package/src/client/lib/format.ts

@@ -1,4 +1,8 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * 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'