dsh-plugin 1.6.12 → 2.0.1

package/src/client/components/views/CustomInstallView.tsx

@@ -3,18 +3,12 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Custom install view: a standalone top-level section for manually
- * installing npm packages or GitHub sources outside the catalog. Three
- * installer cards, one per channel — npm package (bare name or a full
- * npm/pnpm install command, including the official global `npm install -g`),
- * GitHub source and the official `dsh plugin ... add <target>` command —
- * each with a placeholder example above the input and its own format check.
- * The cards stay separate so a user never has to guess which format goes
- * where. Finished installs surface in the Installed view, marked as custom.
+ * 自定义安装视图：独立一级板块，用于手动安装目录之外的 npm 包。安装卡片接受裸包名或完整的
+ * npm/pnpm 安装命令（含官方全局 `npm install -g`），输入框上方带示例并自带格式校验。
+ * 装完的插件出现在「已安装」视图，标记为自定义安装。
  *
- * Pure presentational: owns only the three local input/error states; the
- * actual install (custom source, gated by the security toggles) bubbles up
- * via onInstallCustom.
+ * 纯展示组件：只持有本地输入/错误状态；真正的安装（custom 源，受安全开关控制）经
+ * onInstallCustom 上抛。
  */
 import { createElement as h, useState } from 'react'
 import type { FormEvent, MouseEvent } from 'react'
@@ -23,27 +17,14 @@ import modal from '../../styles/Modal.module.css'
 import type { InstallChannel, Translate } from '../../types.ts'
 import { CloseIcon, HelpIcon } from '../ui/icons.tsx'
 
-/* —— 自定义安装输入预检 ——
- * 提交前校验「输入是否符合该通道格式」，识别不了的输入不发请求，就地提示推荐格式。
- * 三个通道严格分开：npm 框认裸包名或完整 npm/pnpm 安装命令（含全局 `npm install -g`），
- * git 框只认 GitHub 地址，命令框只认官方 `dsh plugin --profile <name> <add|update> <target>`
- * （--profile 必填，无 -p 简写；update = 更新已安装目标到最新）。
+/* —— 自定义安装输入校验 ——
+ * 提交前校验「输入是否符合格式」，识别不了的输入不发请求，就地提示推荐格式。
+ * npm 框认裸包名或完整 npm/pnpm 安装命令（含全局 `npm install -g`）。
  * 这里只做格式校验，真正归一化/安装由服务端完成。 */
 
-/** GitHub 地址（带前缀形态）：github:、https://github.com/、git+https://github.com/、git@github.com: */
-const GITHUB_URL_RE = /^(?:github:|https?:\/\/github\.com\/|git\+https?:\/\/github\.com\/|git@github\.com:)([A-Za-z0-9._-]+)\/([A-Za-z0-9._-]+?)(?:\.git)?$/
-/** 裸 owner/repo（npm 包名只有 @scope/pkg 才带斜杠，无 @ 前缀的 a/b 一定是 GitHub 仓库） */
-const GITHUB_BARE_RE = /^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/
 /** npm 包名（含 @scope/pkg） */
 const NPM_PACKAGE_RE = /^(?:@[a-z0-9._-]+\/)?[a-z0-9._-]+$/
 
-/** DSH 命令行前缀（官方唯一形式 `dsh plugin --profile <name> <add|update> <target>`）—— 提取其中的动作与目标。
- * 官方 CLI（apps/cli/src/args.ts，commander）：--profile 为必填长选项（无 -p 简写，省略即报错），
- * 支持 `--profile=<name>` 等号形式；命令大小写不敏感。update = 已安装目标覆盖更新到最新；
- * remove 不走这里（卸载由「已安装」列表的卸载按钮执行，命令框不认卸载动词）。
- * 与 server 端 installTargetOf 口径一致。 */
-const DSH_PLUGIN_CMD_RE = /^dsh\s+plugin\s+--profile(?:\s+|=)\S+\s+(add|update)\s+(.+)$/i
-
 /** npm 全局安装命令（官方 README 格式，如 `npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui`）——
  * 提取 -g 之后的包列表；任一包名非法返回 null（交给格式错误提示）。与 server 端 globalNpmPackagesOf 口径一致。 */
 const NPM_GLOBAL_CMD_RE = /^npm\s+(?:install|i)\s+(?:-g|--global)\s+(.+)$/i
@@ -52,14 +33,6 @@ const NPM_GLOBAL_CMD_RE = /^npm\s+(?:install|i)\s+(?:-g|--global)\s+(.+)$/i
  * 提取命令后的包列表；包列表在 splitPackages 里逐个校验。 */
 const NPM_INSTALL_CMD_RE = /^(?:npm\s+(?:install|i)|pnpm\s+(?:add|i|install))\s+(.+)$/i
 
-/** 解析 DSH 命令：返回 { action, target }；非官方命令返回 null（交给格式错误提示）。 */
-function parseDshCommand(raw: string): { action: 'add' | 'update'; target: string } | null {
-  const input = raw.trim()
-  const match = DSH_PLUGIN_CMD_RE.exec(input)
-  if (match === null) return null
-  return { action: match[1].toLowerCase() as 'add' | 'update', target: match[2].trim() }
-}
-
 /** 空格分隔的包列表：逐个按 npm 包名语法校验 + 拒绝以 - 开头的 token（npm 会把 --xxx 当参数而非包名），
  * 任一非法返回 null（交给格式错误提示）。与 server 端 globalNpmPackagesOf 同口径。 */
 function splitPackages(raw: string): string[] | null {
@@ -96,46 +69,28 @@ function parseNpmInput(raw: string): NpmInputParse | null {
   return null
 }
 
-function isGitHubInput(raw: string): boolean {
-  const input = raw.trim()
-  return GITHUB_URL_RE.test(input) || GITHUB_BARE_RE.test(input)
-}
-
-/** 卡片标题旁的「帮助」弹窗：三块卡片各自的标题与格式清单语言包 key。 */
+/** 卡片标题旁的「帮助」弹窗：该卡片的标题与格式清单语言包 key。 */
 const HELP_CARDS = {
   npm: { titleKey: 'npmInstallLabel', contentKey: 'npmInstallHelp' },
-  git: { titleKey: 'gitInstallLabel', contentKey: 'gitInstallHelp' },
-  cmd: { titleKey: 'dshCmdLabel', contentKey: 'dshCmdHelp' },
 } as const
 
 type HelpTarget = keyof typeof HELP_CARDS
 
-export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, enableDsh, onOpenSettings, profile }: {
+export function CustomInstallView({ t, onInstallCustom, enableNpm, onOpenSettings }: {
   t: Translate
-  /** 命令行安装：输入 npm 包名 / npm、pnpm 安装命令 / GitHub 地址 / dsh plugin 命令即装
-   *  （custom 源，受安全设置开关控制）。installChannel 必填 = 入口渠道（三张卡片之一）：
-   *  服务端日志/报错提示据此溯源「从哪个入口发起」；opts.globalNpm 表示官方 npm 全局安装
-   *  命令（npm install -g），附带解析出的包列表（仍属 NPM 包入口）。 */
+  /** 命令行安装：输入 npm 包名 / npm、pnpm 安装命令即装（custom 源，受安全设置开关控制）。
+   *  installChannel 必填 = 入口渠道（NPM 包卡片）：服务端日志/报错提示据此溯源「从哪个入口发起」；
+   *  opts.globalNpm 表示官方 npm 全局安装命令（npm install -g），附带解析出的包列表。 */
   onInstallCustom: (raw: string, opts: { installChannel: InstallChannel; globalNpm?: string[] }) => void
-  /** 安全信任三通道开关：关掉后对应输入卡片禁用（不提交），并引导去设置打开 */
+  /** 安全信任开关：关掉后输入卡片禁用（不提交），并引导去设置打开 */
   enableNpm: boolean
-  enableGit: boolean
-  enableDsh: boolean
   /** 引导去「设置 → 安全信任」打开被关闭的通道开关 */
   onOpenSettings: () => void
-  /** 当前 dsh profile 名（宿主 /env 快照）：一键插入的更新命令用它拼 --profile */
-  profile: string
 }) {
   /** 自定义安装：NPM 包输入与格式错误（'' = 无错误） */
   const [npmQuery, setNpmQuery] = useState('')
   const [npmError, setNpmError] = useState('')
-  /** 自定义安装：GitHub 源码输入与格式错误（'' = 无错误） */
-  const [gitQuery, setGitQuery] = useState('')
-  const [gitError, setGitError] = useState('')
-  /** 自定义安装：DSH 命令输入与格式错误（'' = 无错误） */
-  const [cmdQuery, setCmdQuery] = useState('')
-  const [cmdError, setCmdError] = useState('')
-  /** 卡片标题旁「帮助」弹窗：null = 未打开；'npm' | 'git' | 'cmd' = 打开对应卡片的格式清单 */
+  /** 卡片标题旁「帮助」弹窗：null = 未打开；'npm' = 打开该卡片的格式清单 */
   const [helpFor, setHelpFor] = useState<HelpTarget | null>(null)
 
   /** 通道关闭提示行：开关关掉后替代示例与输入行，引导去设置打开 */
@@ -148,9 +103,8 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
     }, t('goToSettings')),
   )
 
-  // 三个通道分开校验 —— 识别不了的输入不发请求，就地提示推荐写法。
-  // NPM 框认裸包名或完整 npm/pnpm 命令（含全局 npm install -g，走 globalNpm 通道）；
-  // 命令框只认官方 dsh plugin 命令，提交时剥成裸目标发给服务端。
+  // 只做格式校验 —— 识别不了的输入不发请求，就地提示推荐写法。
+  // NPM 框认裸包名或完整 npm/pnpm 命令（含全局 npm install -g，走 globalNpm 通道）。
   const submitNpm = () => {
     const raw = npmQuery.trim()
     if (!raw) return
@@ -164,36 +118,12 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
     setNpmQuery('')
     setNpmError('')
   }
-  const submitGit = () => {
-    const target = gitQuery.trim()
-    if (!target) return
-    if (!isGitHubInput(target)) { setGitError(t('gitInstallInvalid')); return }
-    onInstallCustom(target, { installChannel: 'git' })
-    setGitQuery('')
-    setGitError('')
-  }
-  const submitCmd = () => {
-    const raw = cmdQuery.trim()
-    if (!raw) return
-    const parsed = parseDshCommand(raw)
-    if (parsed === null) { setCmdError(t('dshCmdInvalid', { profile })); return }
-    // add / update 统一走安装流程：目标已安装时弹窗自动转「更新」覆盖重装（服务端 mode=update 放行），
-    // 未安装时即为普通安装 —— 粘贴 `dsh plugin --profile web update dsh-plugin` 这类命令即可更新到最新
-    onInstallCustom(parsed.target, { installChannel: 'dsh' })
-    setCmdQuery('')
-    setCmdError('')
-  }
-  /** 一键插入 DSH Plugin Hub 自身的更新命令：按当前 profile 拼官方命令填进输入框，用户确认后提交 */
-  const insertHubUpdate = () => {
-    setCmdQuery(`dsh plugin --profile ${profile} update dsh-plugin`)
-    setCmdError('')
-  }
 
   return h('div', { className: styles.root },
     // 页面说明：独立一级导航，交代「装完去哪看」
     h('p', { className: styles.desc }, t('customViewDesc')),
-    // 三块卡片（一行一个）：label + 文本框上方示例 + 输入行 + 错误区；
-    // 安全信任开关关掉对应通道时，卡片禁用并显示「前往设置」提示行
+    // NPM 包卡片：label + 文本框上方示例 + 输入行 + 错误区；
+    // 安全信任开关关掉时，卡片禁用并显示「前往设置」提示行
     h('div', { className: styles.installCards },
       // NPM 包：输入包名或原生 npm/pnpm 安装命令即装（含官方全局 npm install -g）
       h('div', { className: enableNpm ? styles.installCard : `${styles.installCard} ${styles.installCardDisabled}` },
@@ -239,94 +169,6 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
             npmError ? h('div', { className: styles.installError }, npmError) : null,
           ],
       ),
-      // GitHub 源码：输入仓库地址即装
-      h('div', { className: enableGit ? styles.installCard : `${styles.installCard} ${styles.installCardDisabled}` },
-        h('div', { className: styles.installCardHead },
-          h('span', { className: styles.installLabel }, t('gitInstallLabel')),
-          h('button', {
-            type: 'button',
-            className: styles.installHelpBtn,
-            title: t('installHelp'),
-            'aria-label': t('installHelp'),
-            onClick: () => setHelpFor('git'),
-          }, h(HelpIcon)),
-        ),
-        !enableGit
-          ? channelOffRow
-          : [
-            h('div', { className: styles.installExample }, t('gitInstallExample')),
-            h('div', { className: styles.installRow },
-              h('input', {
-                className: gitError ? `${styles.installInput} ${styles.installInputError}` : styles.installInput,
-                type: 'text',
-                placeholder: t('gitInstallPlaceholder'),
-                value: gitQuery,
-                spellCheck: false,
-                onInput: (e: FormEvent<HTMLInputElement>) => {
-                  setGitQuery((e.target as HTMLInputElement).value)
-                  setGitError('')
-                },
-                onKeyDown: (e: KeyboardEvent) => { if (e.key === 'Enter') submitGit() },
-              }),
-              h('button', {
-                className: styles.installBtn,
-                type: 'button',
-                disabled: gitQuery.trim() === '',
-                onClick: submitGit,
-              }, t('installCliBtn')),
-            ),
-            gitError ? h('div', { className: styles.installError }, gitError) : null,
-          ],
-      ),
-      // 命令卡片：粘贴官方 dsh plugin 命令即装/即更新 —— 只认完整命令
-      // （--profile 必填，可含 = 等号，动词 add/update，剥成裸目标走安装流程）
-      h('div', { className: enableDsh ? styles.installCard : `${styles.installCard} ${styles.installCardDisabled}` },
-        h('div', { className: styles.installCardHead },
-          h('span', { className: styles.installLabel }, t('dshCmdLabel')),
-          h('button', {
-            type: 'button',
-            className: styles.installHelpBtn,
-            title: t('installHelp'),
-            'aria-label': t('installHelp'),
-            onClick: () => setHelpFor('cmd'),
-          }, h(HelpIcon)),
-          // 一键插入 Hub 自身的更新命令：按当前 profile 拼 `dsh plugin --profile <p> update dsh-plugin`
-          // 填入输入框（命令卡片被安全开关禁用时不显示，插入后也提交不了）
-          enableDsh
-            ? h('button', {
-              type: 'button',
-              className: styles.installInsertBtn,
-              onClick: insertHubUpdate,
-            }, t('dshCmdInsertHubUpdate'))
-            : null,
-        ),
-        !enableDsh
-          ? channelOffRow
-          : [
-            h('div', { className: styles.installExample }, t('dshCmdExample', { profile })),
-            h('div', { className: styles.installRow },
-              h('input', {
-                className: cmdError ? `${styles.installInput} ${styles.installInputError}` : styles.installInput,
-                type: 'text',
-                placeholder: t('dshCmdPlaceholder'),
-                value: cmdQuery,
-                spellCheck: false,
-                onInput: (e: FormEvent<HTMLInputElement>) => {
-                  setCmdQuery((e.target as HTMLInputElement).value)
-                  setCmdError('')
-                },
-                onKeyDown: (e: KeyboardEvent) => { if (e.key === 'Enter') submitCmd() },
-              }),
-              h('button', {
-                className: styles.installBtn,
-                type: 'button',
-                disabled: cmdQuery.trim() === '',
-                onClick: submitCmd,
-              }, t('installCliBtn')),
-            ),
-            cmdError ? h('div', { className: styles.installError }, cmdError) : null,
-          ],
-      ),
     ),
     // 帮助弹窗：点卡片标题旁的问号打开 —— 宽窗（720px）把该通道支持的命令格式整行展示，防止折行
     helpFor !== null
@@ -346,7 +188,7 @@ export function CustomInstallView({ t, onInstallCustom, enableNpm, enableGit, en
           h('div', { className: modal.modalBody },
             // 格式清单：一行一条；`命令\t说明` 的说明跟在命令后，纯说明行以 \t 开头
             h('div', { className: styles.helpBody },
-              t(HELP_CARDS[helpFor].contentKey, { profile }).split('\n').map((line, i) => {
+              t(HELP_CARDS[helpFor].contentKey).split('\n').map((line, i) => {
                 const [cmd, note] = line.split('\t')
                 return h('div', { key: i, className: styles.helpLine },
                   cmd !== '' ? h('span', { className: styles.helpCmd }, cmd) : null,

package/src/client/components/views/DiagnosticsView.tsx

@@ -3,12 +3,9 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * System diagnostics list: one row per connectivity channel (npm registry /
- * GitHub API / catalog site), each with a live status badge — 200 OK in
- * green, Unreachable in red, Checking… while probing. The list runs
- * automatically when the page opens; every row is a button that re-probes
- * just that channel, so a click always yields visible feedback
- * (row pulses → badge flips → latency refreshes).
+ * 系统诊断列表：每个连通性通道（npm registry / GitHub API / 目录站点）一行，各带实时
+ * 状态徽标 —— 200 OK 绿、不可达红、探测中显示「检测中…」。页面打开时自动跑一轮；
+ * 每行都是按钮，点击只重测该通道，因此点击总有可见反馈（行脉冲 → 徽标翻转 → 延迟刷新）。
  */
 import { createElement as h, useCallback, useEffect, useRef, useState } from 'react'
 import styles from '../../styles/DiagnosticsView.module.css'

package/src/client/components/views/InstalledView.tsx

@@ -3,18 +3,13 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Installed view: manages the plugins installed into the current profile.
- * Follows the mainstream extension-manager pattern (VSCode Installed tab) —
- * a searchable, sortable list of installed entries that mixes catalog
- * plugins (full metadata) and custom command installs (outside the catalog,
- * only runtime info, tagged with a custom badge). The toolbar carries a
- * search box plus two segmented radio-button groups: source filter
- * (all / catalog / custom) and sort (name / recently installed / stars / forks).
- * Each row carries restart (when pending), update and uninstall actions
- * and opens a detail modal with the full install metadata.
+ * 已安装视图：管理安装进当前 profile 的插件。沿用主流扩展管理器模式（VSCode 已安装 tab）——
+ * 可搜索、可排序的已安装清单，混排目录插件（完整元数据）与命令行自定义安装（目录之外，
+ * 只有运行时信息，打「自定义」徽标）。工具栏含搜索框与两组分段单选：来源筛选
+ * （全部/目录/自定义）与排序（名称/最近安装/Star/Fork）。每行带重启（待重启时）、更新与
+ * 卸载动作，并打开含完整安装元数据的详情弹窗。
  *
- * Pure presentational: owns only local search/sort state; the InstalledItem
- * model arrives from the catalog hook and actions bubble up via callbacks.
+ * 纯展示组件：只持有本地搜索/排序状态；InstalledItem 模型来自目录 hook，动作经回调上抛。
  */
 import { createElement as h, useMemo, useState } from 'react'
 import type { FormEvent, MouseEvent, ReactNode } from 'react'

package/src/client/components/views/MarketView.tsx

@@ -3,10 +3,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Market view: the browse experience for the catalog — category tabs,
- * search/sort/install-state controls and the plugin list. Owns nothing;
- * it wires catalog state (query/sort/filter/category) to the small
- * presentational components so PluginHubSection stays free of view internals.
+ * 市场视图：目录的浏览体验 —— 分类 Tab、搜索/排序/安装状态控件与插件列表。自身不持有状态，
+ * 只把目录状态（query/sort/filter/category）接到小型展示组件上，让 PluginHubSection 不掺视图细节。
  */
 import { createElement as h, Fragment } from 'react'
 import type { HubPlugin, LocaleId } from '../../types.ts'

package/src/client/components/views/SettingsView.tsx

@@ -3,17 +3,14 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Settings view: desktop-settings navigation — a fixed left sidebar lists
- * the sections (icon + label, click to switch), the right pane shows the
- * active section's rows. New settings only add rows, new areas only add a
- * sidebar entry.
+ * 设置视图：桌面设置式导航 —— 固定左侧栏列出各分组（图标 + 名称，点击切换），
+ * 右侧面板展示当前分组的设置行。新增设置只加行，新增区域只加一条侧栏项。
  *
- * Sections mirror what the local server actually enforces:
- *   Updates & Sources — startup update check / npm mirror / HTTP proxy
- *                        (all wired into the install command path)
- *   Security & Trust  — restricted custom installs (server 403 gate)
- *   Diagnostics       — live connectivity probe + environment snapshot
- *   Logs              — system log viewer + storage location
+ * 各分组对应本地服务端实际强制的行为：
+ *   更新与源 —— 启动检查更新 / npm 镜像 / HTTP 代理（都接进安装命令链路）
+ *   安全与信任 —— 受限的自定义安装（服务端 403 门禁）
+ *   诊断 —— 实时连通性探测 + 环境快照
+ *   日志 —— 系统日志查看器 + 存放位置
  */
 import { createElement as h, useEffect, useRef, useState } from 'react'
 import type { ChangeEvent, MouseEvent, ReactNode } from 'react'
@@ -207,10 +204,8 @@ export function SettingsView({ t, settings, update, reset, env, onCopy, openSect
   )
 
   const securityCard = h('div', { className: styles.card },
-    // 安全与信任：命令行安装的三个通道开关（NPM 包 / GitHub 源码 / DSH 命令）——
-    // 服务端按通道门禁 403 拦截（npm 目标吃 enableNpmInstall、git 目标吃 enableGitInstall），
-    // DSH 命令框为纯客户端通道：关掉后命令输入卡片禁用并引导去设置打开；
-    // 目录内收录的插件安装不受影响（默认全部开启）
+    // 安全与信任：命令行安装的开关（仅 NPM 包）—— 服务端按通道门禁 403 拦截
+    //（npm 目标吃 enableNpmInstall）；目录内收录的插件安装不受影响（默认开启）
     h(SettingRow, {
       title: t('settingsEnableNpm'),
       desc: t('settingsEnableNpmDesc'),
@@ -220,24 +215,6 @@ export function SettingsView({ t, settings, update, reset, env, onCopy, openSect
         title: t('settingsEnableNpm'),
       }),
     }),
-    h(SettingRow, {
-      title: t('settingsEnableGit'),
-      desc: t('settingsEnableGitDesc'),
-      children: h(Toggle, {
-        checked: settings.enableGitInstall,
-        onChange: (v) => update({ enableGitInstall: v }),
-        title: t('settingsEnableGit'),
-      }),
-    }),
-    h(SettingRow, {
-      title: t('settingsEnableDsh'),
-      desc: t('settingsEnableDshDesc'),
-      children: h(Toggle, {
-        checked: settings.enableDshInstall,
-        onChange: (v) => update({ enableDshInstall: v }),
-        title: t('settingsEnableDsh'),
-      }),
-    }),
   )
 
   const diagnosticsCard = h('div', { className: styles.card },

package/src/client/css-modules.d.ts

@@ -1,4 +1,4 @@
-/** Type declaration for CSS Modules consumed by the browser client. */
+/** 浏览器客户端使用的 CSS Modules 类型声明。 */
 declare module '*.module.css' {
   const classes: Record<string, string>
   export default classes

package/src/client/data/catalog.ts

@@ -3,9 +3,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Catalog repository: fetches the plugin directory and the collection stats
- * from the online API and normalizes them. Components never see URLs or
- * fetch — the repository is the only place that knows where data lives.
+ * 目录数据仓库：从在线 API 拉取插件目录与收录统计并做归一化。
+ * 组件不接触 URL 与 fetch —— 这里是唯一知道数据所在地的地方。
  */
 import type { HubPlugin, LocaleId } from '../types.ts'
 import { normalize } from '../logic/normalize.ts'

package/src/client/data/host.ts

@@ -3,9 +3,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Host repository: the local routes served by the DSH harness (installed
- * plugin table + environment snapshot). A host without the plugin's server
- * routes degrades to null / empty tables instead of throwing.
+ * 宿主数据仓库：DSH 宿主提供的本地路由（已装插件表 + 环境快照）。
+ * 宿主未挂载本插件服务端路由时降级为 null / 空表，而不是抛错。
  */
 import type { EnvInfo } from '../types.ts'
 import type { InstalledVersionSignal } from '../logic/installed.ts'
@@ -45,6 +44,30 @@ export async function fetchInstalled(): Promise<HostInstalled | null> {
   }
 }
 
+/** npm 包最新版本的版本号与真实发布时间（服务端经 registry 查询）。 */
+export interface NpmReleaseInfo {
+  version: string
+  publishedAt: string
+}
+
+/** 批量查询已安装插件 npm 包的最新版本发布时间（供应链门禁用）；失败返回 null（调用方按原逻辑照常提示）。 */
+export async function fetchNpmReleaseAge(packages: string[]): Promise<Record<string, NpmReleaseInfo | null> | null> {
+  if (packages.length === 0) return {}
+  try {
+    const res = await fetch('/dsh-plugin-hub/npm-release-age', {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ packages }),
+      cache: 'no-store',
+    })
+    if (!res.ok) return null
+    const data = await res.json() as { packages?: Record<string, NpmReleaseInfo | null> }
+    return data.packages ?? null
+  } catch {
+    return null
+  }
+}
+
 let envPromise: Promise<EnvInfo | null> | null = null
 
 /** 在系统文件管理器里定位并打开已安装插件的目录（服务端 spawn open，跨平台）；失败返回 false。 */

package/src/client/data/hub.ts

@@ -3,9 +3,8 @@
  * Website: https://dsh-plugin.org
  * GitHub: https://github.com/dshplugin/dsh-plugin-hub
  *
- * Hub meta repository: the Cloudflare Worker endpoints behind the self-update
- * check and the "About us" content. Failures degrade to null — the caller
- * decides how to fall back (no badge, placeholder copy), never throws.
+ * Hub 元数据仓库：自我更新检查与「关注我们」内容背后的 Cloudflare Worker 接口。
+ * 失败降级为 null —— 由调用方决定如何兜底（不显示徽标、占位文案），绝不抛错。
  */
 import type { HubAboutInfo, HubUpdateInfo } from '../types.ts'
 import { HUB_ABOUT_URL, HUB_UPDATE_URL } from '../logic/constants.ts'