dsh-plugin 1.1.0 → 1.1.2

package/src/client/lib/renderMarkdown.ts

@@ -0,0 +1,120 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * 轻量 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

@@ -1,4 +1,10 @@
-/** zh/en dictionaries for the DSH-Plugin Hub settings section. */
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * zh/en dictionaries for the DSH-Plugin Hub settings section.
+ */
 export const zh = {
   nav: '插件中心',
   title: 'DSH-Plugin Hub',
@@ -21,6 +27,9 @@ export const zh = {
   failedDesc: '请稍后重试，或点击右上角按钮在浏览器中打开插件中心。',
   retry: '重试',
   install: '安装',
+  // AI 识别可能需要命令行辅助的插件（webInstallable=false）：仍可尝试一键安装，失败时复制命令去 dsh 终端
+  cliOnlyHint: '此插件可能需命令行辅助，失败时复制上方命令到 dsh 终端',
+  failedCopyHint: '安装失败。请复制上方安装命令到 dsh 终端手动执行（原生依赖构建脚本可能需要人工放行，如 pnpm approve-builds）',
   toastCopied: '安装命令已复制，去 dsh 终端粘贴即可安装',
   installed: '已安装',
   notInstalled: '未安装',
@@ -65,6 +74,7 @@ export const zh = {
   restartLater: '稍后重启',
   restarting: '正在重启…',
   restartHint: '部分插件（如插件市场、顶层 bundle）需重启后才会生效。',
+  done: '完成',
   // 待重启：装完没重启的插件常驻提醒，直到宿主真正重启
   restartPendingHint: '安装成功，重启后生效',
   restartPendingHintUninstall: '卸载成功，重启后移除',
@@ -120,6 +130,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 +172,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 +220,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 +274,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',
 }

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

@@ -1,4 +1,8 @@
-/* 自绘下拉（替换原生 <select>）。颜色跟随宿主主题：经 --hub-* 设计令牌解析，
+/* DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * 自绘下拉（替换原生 <select>）。颜色跟随宿主主题：经 --hub-* 设计令牌解析，
  * 与 Header 的控件（排序/分段）保持一致的无边框 + 圆角语言。 */
 .dropdown {
   position: relative;

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

@@ -1,4 +1,8 @@
-/* Plugin Hub section header: brand row, tagline, ad banner, search input,
+/* DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Plugin Hub section header: brand row, tagline, ad banner, search input,
  * filter toolbar (installed / not installed, failures entry) and category
  * tabs. Colors resolve through the --hub-* design tokens. */
 
@@ -20,12 +24,13 @@
   padding: 2px 2px 0;
 }
 
-/* 头部右上角控件组：语言切换 + GitHub 源码图标，右侧一列对齐 */
+/* 头部右上角控件组：语言切换 + GitHub 源码图标，右侧一列对齐，auto 把它顶到标题行最右 */
 .headerRight {
   flex-shrink: 0;
   display: inline-flex;
   align-items: center;
   gap: 2px;
+  margin-left: auto;
 }
 
 /* 语言切换按钮：与 GitHub 图标同风格（次级灰低调、悬浮品牌紫），文字显示目标语言 */
@@ -75,11 +80,36 @@
   display: block;
 }
 
-/* 头部第一行：logo + 标题（官网链接）与 GitHub 图标同行，space-between 把 GitHub 顶到标题行末尾 */
+/* 「关注我们」入口：GitHub 图标后，与语言切换按钮同风格 —— 普通文字、无边框，
+   悬浮才转品牌紫 + 浅紫底，提示可点（打开平台介绍 + 用户反馈群二维码弹窗） */
+.aboutBtn {
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  height: 24px;
+  padding: 0 8px;
+  font-size: 12px;
+  font-weight: 600;
+  line-height: 1;
+  color: var(--hub-text-tertiary);
+  background: transparent;
+  border: none;
+  border-radius: 6px;
+  cursor: pointer;
+  user-select: none;
+  transition: color 0.15s ease, background-color 0.15s ease;
+}
+
+.aboutBtn:hover {
+  color: var(--hub-purple-1);
+  background-color: var(--hub-purple-tint);
+}
+
+/* 头部第一行：logo + 标题（官网链接）紧接着版本号入口，右侧控件组靠 auto 顶到最右 */
 .headerTitleRow {
   display: flex;
   align-items: center;
-  justify-content: space-between;
   gap: 8px;
   min-width: 0;
 }
@@ -117,6 +147,60 @@
   color: var(--hub-text-secondary);
 }
 
+/* 版本号入口按钮：常驻可点（打开版本信息/更新记录弹窗），无边框、字号与标题协调，
+   hover 加品牌色下划线提示可点 —— 无论有无更新都可查看更新内容；
+   有更新时版本号后紧跟红色「可更新」徽标（同一按钮内的 span，不分开成两个元素） */
+.versionBtn {
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  gap: 5px;
+  height: 20px;
+  padding: 0 6px;
+  border: none;
+  border-radius: 5px;
+  font-size: 12px;
+  font-weight: 600;
+  line-height: 1;
+  color: var(--hub-text-secondary);
+  background: transparent;
+  cursor: pointer;
+  user-select: none;
+  transition: color 120ms ease;
+}
+
+/* 悬浮只提示整组可点，但版本号本身颜色保持不变；交互反馈交给「可更新」徽标单独变深红 */
+.versionBtn:hover {
+  color: var(--hub-text-secondary);
+}
+
+/* 版本号旁的「可更新」徽标：默认红底白字（醒目），悬浮轻微加深 + 投影提升一点反馈感，
+   紧跟版本号，提示可查看并直接升级。作为同一按钮内文字，点击由外层按钮统一处理，本身无需独立事件。 */
+.hubUpdateBadge {
+  flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  height: 18px;
+  padding: 0 7px;
+  border-radius: 999px;
+  font-size: 11px;
+  font-weight: 700;
+  line-height: 1;
+  letter-spacing: 0.02em;
+  color: #ffffff;
+  background: var(--hub-danger);
+  box-shadow: 0 1px 4px rgba(209, 36, 47, 0.4);
+  user-select: none;
+  transition: background 120ms ease, box-shadow 120ms ease, transform 120ms ease;
+}
+
+/* 悬浮：轻微变深红 + 一点投影提升，只动徽标本身，版本号不动 */
+.hubUpdateBadge:hover {
+  background: var(--hub-danger-hover);
+  box-shadow: 0 2px 8px rgba(209, 36, 47, 0.5);
+  transform: translateY(-1px);
+}
+
 /* 品牌 logo 图标：与标题文字垂直居中对齐 */
 .logoIcon {
   flex-shrink: 0;

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

@@ -1,4 +1,8 @@
-/* Plugin Hub catalog list: the scrollable body, plugin cards (name, badges,
+/* DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Plugin Hub catalog list: the scrollable body, plugin cards (name, badges,
  * description, topics, stats, actions), loading / empty states and the
  * browse-all footer. Colors resolve through the --hub-* design tokens. */
 

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

@@ -1,4 +1,8 @@
-/* Plugin Hub dialogs and overlays: install / uninstall modals, error dialog,
+/* DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Plugin Hub dialogs and overlays: install / uninstall modals, error dialog,
  * failure-record dialog, task-queue dialog, progress strip, inline progress
  * and the global toast. Colors resolve through the --hub-* design tokens. */
 
@@ -113,6 +117,28 @@
   padding: 6px 10px;
 }
 
+/* 可能需要命令行辅助的插件提示（webInstallable=false）：中性说明，仍允许尝试一键安装 */
+.cliOnlyHint {
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--hub-text-secondary);
+  background: var(--hub-bg-hover);
+  border-radius: 6px;
+  padding: 6px 10px;
+}
+
+/* 安装失败引导：红色醒目，提示复制命令到 dsh 终端手动执行（原生依赖构建脚本需人工放行） */
+.failedCopyHint {
+  font-size: 12px;
+  line-height: 18px;
+  font-weight: 500;
+  color: var(--hub-danger-text);
+  background: var(--hub-danger-tint);
+  border: 1px solid var(--hub-danger-border-soft);
+  border-radius: 6px;
+  padding: 6px 10px;
+}
+
 .modalRow {
   display: flex;
   align-items: baseline;
@@ -916,6 +942,17 @@
   background: var(--hub-danger-tint);
 }
 
+/* 成功通知卡片（时间戳已并入头部行）：删除按钮不再用 auto margin 顶到最右，
+   由时间戳的 margin-left:auto 把「时间 + 删除」整体推到行尾 —— 图标文字与
+   时间垂直居中，卡片只有一行内容，整体居中不顶头 */
+.noticeRowOk .noticeRemove {
+  margin-left: 0;
+}
+
+.noticeRowOk .noticeTime {
+  margin-left: auto;
+}
+
 /* 记录内的复制按钮：纯灰文字、无边框，低调隐蔽，点击即可复制该条完整错误日志 */
 .failCopy {
   flex-shrink: 0;
@@ -1004,3 +1041,244 @@
   border: 1px solid var(--hub-warning-border);
   border-radius: 6px;
 }
+
+/* —— 「关注我们」弹窗 —— */
+
+/* 关注弹窗：比普通弹窗略宽，给 Markdown 介绍 + 反馈群二维码留出阅读空间；
+   max-width 覆盖普通弹窗的 calc(100vw - 32px)，窄屏时仍不贴边 */
+.aboutModal {
+  width: 460px;
+  max-width: calc(100vw - 48px);
+}
+
+/* Markdown 内容区：固定最大高度内滚动，介绍文字 + 二维码不把弹窗撑爆；
+   样式沿用 hubUpdateNotes 的 12px 基线，仅二维码图片单独约束最大尺寸 */
+.aboutContent {
+  flex: 1 1 auto;
+  min-height: 0;
+  max-height: 340px;
+  overflow-y: auto;
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--hub-text-secondary);
+  background: var(--hub-bg-2);
+  border: 1px solid var(--hub-border-2);
+  border-radius: 8px;
+  padding: 10px 12px;
+}
+
+.aboutContent > *:first-child {
+  margin-top: 0;
+}
+
+.aboutContent > *:last-child {
+  margin-bottom: 0;
+}
+
+.aboutContent h2,
+.aboutContent h3,
+.aboutContent h4,
+.aboutContent h5 {
+  margin: 10px 0 4px;
+  font-size: 13px;
+  font-weight: 600;
+  line-height: 20px;
+  color: var(--hub-text-primary);
+}
+
+.aboutContent h2 {
+  font-size: 14px;
+}
+
+.aboutContent p {
+  margin: 4px 0;
+}
+
+.aboutContent ul,
+.aboutContent ol {
+  margin: 4px 0;
+  padding-left: 18px;
+}
+
+.aboutContent li {
+  margin: 2px 0;
+}
+
+.aboutContent code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: 11px;
+  background: var(--hub-bg-hover);
+  border-radius: 4px;
+  padding: 1px 4px;
+  color: var(--hub-text-primary);
+}
+
+.aboutContent pre {
+  margin: 6px 0;
+  background: var(--hub-bg-1);
+  border: 1px solid var(--hub-border-2);
+  border-radius: 6px;
+  padding: 8px 10px;
+  overflow-x: auto;
+}
+
+.aboutContent pre code {
+  background: none;
+  padding: 0;
+  border-radius: 0;
+}
+
+.aboutContent blockquote {
+  margin: 6px 0;
+  padding: 2px 10px;
+  border-left: 3px solid var(--hub-brand);
+  background: var(--hub-bg-hover);
+  border-radius: 0 6px 6px 0;
+  color: var(--hub-text-tertiary);
+}
+
+.aboutContent a {
+  color: var(--hub-brand);
+  text-decoration: none;
+}
+
+.aboutContent a:hover {
+  color: var(--hub-brand-hover);
+  text-decoration: underline;
+}
+
+/* 内容里的图片（反馈群二维码）：居中、最大高度受控，不撑破弹窗：
+   当图片自身更窄时收缩到实际宽度（不强行拉满铺平） */
+.aboutContent img {
+  display: block;
+  margin: 8px auto;
+  max-width: 100%;
+  max-height: 220px;
+  border-radius: 8px;
+  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);
+}
+
+/* 更新时间小字：弱化展示在内容区下方 */
+.aboutMeta {
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--hub-text-tertiary);
+}
+
+/* —— Hub 自我更新说明弹窗 —— */
+
+/* 更新说明弹窗：比普通弹窗略宽，给变更记录留出阅读空间 */
+.hubUpdateModal {
+  width: 520px;
+  max-width: calc(100vw - 48px);
+}
+
+/* 版本 / 发布时间元信息行：小号标签并排，弱化但可读 */
+.hubUpdateMeta {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 4px 14px;
+  font-size: 12px;
+  line-height: 18px;
+}
+
+.hubUpdateMetaItem {
+  color: var(--hub-text-tertiary);
+}
+
+/* Markdown 变更记录区：固定最大高度内滚动，长更新记录不把弹窗撑爆；
+   子元素（标题/列表/代码块/引用）继承 12px 基线，仅标题加大加粗 */
+.hubUpdateNotes {
+  flex: 1 1 auto;
+  min-height: 0;
+  max-height: 300px;
+  overflow-y: auto;
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--hub-text-secondary);
+  background: var(--hub-bg-2);
+  border: 1px solid var(--hub-border-2);
+  border-radius: 8px;
+  padding: 10px 12px;
+}
+
+.hubUpdateNotes > *:first-child {
+  margin-top: 0;
+}
+
+.hubUpdateNotes > *:last-child {
+  margin-bottom: 0;
+}
+
+.hubUpdateNotes h2,
+.hubUpdateNotes h3,
+.hubUpdateNotes h4,
+.hubUpdateNotes h5 {
+  margin: 10px 0 4px;
+  font-size: 13px;
+  font-weight: 600;
+  line-height: 20px;
+  color: var(--hub-text-primary);
+}
+
+.hubUpdateNotes h2 {
+  font-size: 14px;
+}
+
+.hubUpdateNotes p {
+  margin: 4px 0;
+}
+
+.hubUpdateNotes ul,
+.hubUpdateNotes ol {
+  margin: 4px 0;
+  padding-left: 18px;
+}
+
+.hubUpdateNotes li {
+  margin: 2px 0;
+}
+
+.hubUpdateNotes code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: 11px;
+  background: var(--hub-bg-hover);
+  border-radius: 4px;
+  padding: 1px 4px;
+  color: var(--hub-text-primary);
+}
+
+.hubUpdateNotes pre {
+  margin: 6px 0;
+  background: var(--hub-bg-1);
+  border: 1px solid var(--hub-border-2);
+  border-radius: 6px;
+  padding: 8px 10px;
+  overflow-x: auto;
+}
+
+.hubUpdateNotes pre code {
+  background: none;
+  padding: 0;
+  border-radius: 0;
+}
+
+.hubUpdateNotes blockquote {
+  margin: 6px 0;
+  padding: 2px 10px;
+  border-left: 3px solid var(--hub-brand);
+  background: var(--hub-bg-hover);
+  border-radius: 0 6px 6px 0;
+  color: var(--hub-text-tertiary);
+}
+
+.hubUpdateNotes a {
+  color: var(--hub-brand);
+  text-decoration: none;
+}
+
+.hubUpdateNotes a:hover {
+  color: var(--hub-brand-hover);
+  text-decoration: underline;
+}

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

@@ -1,4 +1,8 @@
-/* Plugin Hub design tokens.
+/* DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Plugin Hub design tokens.
  *
  * Semantic aliases over the host's --dsw-alias-* theme tokens, each with the
  * original light-mode literal as fallback for hosts that do not define the

package/src/client/types.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
+ *
  * Shared types for the dsh-plugin browser client. Kept dependency-free so
  * any client module can import them without pulling in components or styles.
  */
@@ -36,7 +40,7 @@ export interface SectionProps {
 
 /** Slim projection of the site's DirectoryPlugin entries. */
 export interface HubPlugin {
-  /** 作者小写 key，与 slug 共同构成唯一身份（两级路径 /plugins/{ownerSlug}/{slug}）；旧数据可能缺省 */
+  /** 作者小写 key，与 slug 共同构成唯一身份（两级路径 /plugins/{ownerSlug}/{slug}）；可能缺省 */
   ownerSlug?: string
   slug: string
   displayName?: string
@@ -47,6 +51,8 @@ export interface HubPlugin {
   features?: string[]
   description?: string
   source?: { repo?: string; npmPackage?: string }
+  /** 能否网页一键安装：false = 仅支持命令行/git/本地构建安装（缺省视为 true 可安装） */
+  install?: { webInstallable?: boolean }
   compatibility?: { status?: string }
   dates?: { repoUpdatedAt?: string; addedAt?: string }
   stats?: { stargazers_count?: number; forks_count?: number }