dsh-plugin 1.1.1 → 1.2.0

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

@@ -0,0 +1,66 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * 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.
+ */
+import { createElement as h, Fragment } from 'react'
+import type { HubPlugin, LocaleId } from '../../types.ts'
+import type { useCatalog } from '../../hooks/useCatalog.ts'
+import { CategoryTabs } from '../layout/CategoryTabs.tsx'
+import { CatalogControls } from '../layout/CatalogControls.tsx'
+import { CatalogList } from '../catalog/CatalogList.tsx'
+
+type CatalogState = ReturnType<typeof useCatalog>
+
+export function MarketView({ catalog, t, langPath, langKey, copied, resultText, onInstall, onUninstall }: {
+  catalog: CatalogState
+  t: (key: string, params?: Record<string, string | number>) => string
+  langPath: string
+  langKey: LocaleId
+  copied: string | null
+  resultText: string | null
+  onInstall: (p: HubPlugin, opts?: { update?: boolean }) => void
+  onUninstall: (p: HubPlugin) => void
+}) {
+  return h(Fragment, null,
+    // 分类行保持原位原样：全部 + 各分类 chips
+    h(CategoryTabs, {
+      category: catalog.category,
+      setCategory: catalog.setCategory,
+      allLabel: t('all'),
+      totalCount: catalog.total,
+      langKey,
+    }),
+    h(CatalogControls, {
+      query: catalog.query,
+      setQuery: catalog.setQuery,
+      sort: catalog.sort,
+      sortDir: catalog.sortDir,
+      toggleSort: catalog.toggleSort,
+      t,
+      resultText,
+    }),
+    h(CatalogList, {
+      plugins: catalog.plugins,
+      failed: catalog.failed,
+      visible: catalog.visible,
+      total: catalog.total,
+      t,
+      langPath,
+      reload: catalog.reload,
+      category: catalog.category,
+      copied,
+      installedName: catalog.installedName,
+      installedVersion: catalog.installedVersion,
+      hasUpdate: catalog.hasUpdate,
+      langKey,
+      onInstall,
+      onUninstall,
+    }),
+  )
+}

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

@@ -0,0 +1,273 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * 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
+ */
+import { createElement as h, useState } from 'react'
+import type { ChangeEvent, MouseEvent, ReactNode } from 'react'
+import styles from '../../styles/SettingsView.module.css'
+import modalStyles from '../../styles/Modal.module.css'
+import { Dropdown } from '../ui/Dropdown.tsx'
+import { Toggle } from '../ui/Toggle.tsx'
+import { DiagnosticsView } from './DiagnosticsView.tsx'
+import { LogsView } from './LogsView.tsx'
+import {
+  CloseIcon, DiagnosticsIcon, LogsIcon, ResetIcon, SecurityIcon, UpdatesIcon,
+} from '../ui/icons.tsx'
+import type { EnvInfo, Translate } from '../../types.ts'
+import type { HubSettings } from '../../hooks/useSettings.ts'
+
+type SettingsSection = 'updates' | 'security' | 'diagnostics' | 'logs' | 'reset'
+
+/** 左侧导航：顺序即展示顺序；labelKey 是分组标题，icon 是行内小图标。 */
+const NAV: Array<{ key: SettingsSection; labelKey: string; icon: () => ReturnType<typeof h> }> = [
+  { key: 'updates', labelKey: 'settingsUpdate', icon: UpdatesIcon },
+  { key: 'security', labelKey: 'settingsSecurity', icon: SecurityIcon },
+  { key: 'diagnostics', labelKey: 'settingsDiagnostics', icon: DiagnosticsIcon },
+  { key: 'logs', labelKey: 'settingsLogs', icon: LogsIcon },
+  { key: 'reset', labelKey: 'settingsReset', icon: ResetIcon },
+]
+
+/** npm 镜像源预设：空串 = 官方源；值相等即视为选中对应预设，其余进入「自定义」输入。 */
+const MIRROR_PRESETS: Array<{ value: string; labelKey: string }> = [
+  { value: '', labelKey: 'mirrorOfficial' },
+  { value: 'https://registry.npmmirror.com', labelKey: 'mirrorNpmmirror' },
+  { value: 'https://mirrors.cloud.tencent.com/npm/', labelKey: 'mirrorTencent' },
+]
+
+/** 设置行：默认标签左控件右；stack=true 时控件独占一行（文本框整行显示），hairline 分隔。 */
+function SettingRow({ title, desc, children, stack = false }: {
+  title: string
+  desc?: string
+  children: ReactNode
+  stack?: boolean
+}) {
+  return h('div', { className: stack ? styles.settingRowStack : styles.settingRow },
+    h('div', { className: styles.settingLabel },
+      h('div', { className: styles.settingTitle }, title),
+      desc ? h('div', { className: styles.settingDesc }, desc) : null,
+    ),
+    h('div', { className: stack ? styles.settingControlStack : styles.settingControl }, children),
+  )
+}
+
+export function SettingsView({ t, settings, update, reset, env, onCopy }: {
+  t: Translate
+  settings: HubSettings
+  update: (patch: Partial<HubSettings>) => void
+  reset: () => void
+  env: EnvInfo | null
+  onCopy: (text: string) => void
+}) {
+  /** 当前激活的分组：左侧导航点击切换，右侧只渲染这一组 */
+  const [section, setSection] = useState<SettingsSection>('updates')
+  /** 恢复默认确认弹窗：点按钮先弹窗询问，确认后才真正 reset（不做两段式按钮） */
+  const [resetConfirm, setResetConfirm] = useState(false)
+
+  const mirrorCustom = !MIRROR_PRESETS.some((p) => p.value === settings.npmRegistry)
+  const onMirrorChange = (value: string) => {
+    if (value === 'custom') return // 进入自定义输入：保持当前值，下方出现输入框
+    update({ npmRegistry: value })
+  }
+  const onMirrorInput = (e: ChangeEvent<HTMLInputElement>) => update({ npmRegistry: e.target.value })
+  const onProxyChange = (e: ChangeEvent<HTMLInputElement>) => update({ proxy: e.target.value })
+
+  /** 每个分组的页面副标题（导航标题之上再补一句说明，保持桌面设置质感） */
+  const pageDesc: Record<SettingsSection, string> = {
+    updates: t('settingsUpdateDesc'),
+    security: t('settingsSecurityDesc'),
+    diagnostics: t('settingsDiagnosticsDesc'),
+    logs: t('settingsLogsDesc'),
+    reset: t('settingsResetDesc'),
+  }
+  const activeNav = NAV.find((n) => n.key === section) ?? NAV[0]
+
+  // —— 各分组的设置卡片（一页一个 card，内部一行一设置） ——
+
+  const updatesCard = h('div', { className: styles.card },
+    h(SettingRow, {
+      title: t('settingsCheckOnStart'),
+      desc: t('settingsCheckOnStartDesc'),
+      children: h(Toggle, {
+        checked: settings.checkUpdatesOnStart,
+        onChange: (v) => update({ checkUpdatesOnStart: v }),
+        title: t('settingsCheckOnStart'),
+      }),
+    }),
+    h(SettingRow, {
+      title: t('settingsMirror'),
+      desc: t('settingsMirrorDesc'),
+      children: h(Dropdown, {
+        value: mirrorCustom ? 'custom' : settings.npmRegistry,
+        options: [
+          ...MIRROR_PRESETS.map((p) => ({ value: p.value, label: t(p.labelKey) })),
+          { value: 'custom', label: t('mirrorCustom') },
+        ],
+        onChange: onMirrorChange,
+        title: t('settingsMirror'),
+        className: styles.controlDropdown,
+      }),
+    }),
+    // 自定义镜像源：下拉选中「自定义」或已存非预设值时，追加一行输入框（文本框独占一行）
+    mirrorCustom && h(SettingRow, {
+      title: t('mirrorCustom'),
+      stack: true,
+      children: h('input', {
+        className: styles.textInput,
+        type: 'url',
+        value: settings.npmRegistry,
+        placeholder: 'https://registry.npmjs.org',
+        spellCheck: false,
+        onChange: onMirrorInput,
+      }),
+    }),
+    // 代理地址：文本框独占一行，整行输入，便于粘贴长代理地址
+    h(SettingRow, {
+      title: t('settingsProxy'),
+      desc: t('settingsProxyDesc'),
+      stack: true,
+      children: h('input', {
+        className: styles.textInput,
+        type: 'text',
+        value: settings.proxy,
+        placeholder: 'http://127.0.0.1:7890',
+        spellCheck: false,
+        onChange: onProxyChange,
+      }),
+    }),
+  )
+
+  const securityCard = h('div', { className: styles.card },
+    // 安全与信任：命令行安装的三个通道开关（NPM 包 / GitHub 源码 / DSH 命令）——
+    // 服务端按通道门禁 403 拦截（npm 目标吃 enableNpmInstall、git 目标吃 enableGitInstall），
+    // DSH 命令框为纯客户端通道：关掉后命令输入卡片禁用并引导去设置打开；
+    // 目录内收录的插件安装不受影响（默认全部开启）
+    h(SettingRow, {
+      title: t('settingsEnableNpm'),
+      desc: t('settingsEnableNpmDesc'),
+      children: h(Toggle, {
+        checked: settings.enableNpmInstall,
+        onChange: (v) => update({ enableNpmInstall: v }),
+        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 },
+    // 系统版本（最顶部）+ 通道状态列表：进入页面自动探测一轮，整行可点击重测单项，实时反馈
+    h(DiagnosticsView, { t, env, onCopy }),
+  )
+
+  const logsCard = h('div', { className: styles.card },
+    // 系统日志列表：操作记录（安装/卸载/设置/诊断），可刷新/复制/导出，点击弹窗查看；
+    // 日志存放位置可设置（留空用默认），改动会写入设置并立即生效
+    h(LogsView, {
+      t,
+      logPath: settings.logPath,
+      onLogPathSaved: (v: string) => update({ logPath: v }),
+    }),
+  )
+
+  const resetCard = h('div', { className: styles.card },
+    h(SettingRow, {
+      title: t('settingsReset'),
+      desc: t('settingsResetDetail'),
+      children: h('button', {
+        type: 'button',
+        className: styles.resetBtn,
+        onClick: () => setResetConfirm(true),
+      }, t('settingsResetRun')),
+    }),
+  )
+
+  return h('div', { className: styles.root },
+    // 左侧导航：固定宽度菜单栏，图标 + 名称，点击切换右侧内容
+    h('nav', { className: styles.sidebar, 'aria-label': t('viewSettings') },
+      NAV.map((item) => h('button', {
+        key: item.key,
+        type: 'button',
+        className: section === item.key ? styles.navItemActive : styles.navItem,
+        onClick: () => setSection(item.key),
+        'aria-current': section === item.key ? 'page' : undefined,
+        title: t(item.labelKey),
+      },
+        h('span', { className: styles.navIcon }, h(item.icon)),
+        h('span', { className: styles.navLabel }, t(item.labelKey)),
+      )),
+    ),
+    // 右侧内容：只渲染当前分组，独立滚动
+    h('div', { className: styles.content },
+      h('div', { className: styles.pageHeader },
+        h('div', { className: styles.pageTitle }, t(activeNav.labelKey)),
+        h('div', { className: styles.pageDesc }, pageDesc[section]),
+      ),
+      section === 'updates' ? updatesCard
+        : section === 'security' ? securityCard
+          : section === 'diagnostics' ? diagnosticsCard
+            : section === 'logs' ? logsCard
+              : resetCard,
+    ),
+    // 恢复默认确认弹窗：点「恢复默认」先弹窗确认，确认后才真正 reset（替代两段式按钮）
+    resetConfirm && h('div', {
+      className: modalStyles.overlay,
+      onClick: (e: MouseEvent<HTMLDivElement>) => { if (e.target === e.currentTarget) setResetConfirm(false) },
+    },
+      h('div', { className: modalStyles.modal, role: 'dialog', 'aria-modal': 'true' },
+        h('div', { className: modalStyles.modalHead },
+          h('div', { className: modalStyles.modalTitle }, t('settingsReset')),
+          h('button', {
+            className: modalStyles.modalClose,
+            type: 'button',
+            'aria-label': t('errorClose'),
+            onClick: () => setResetConfirm(false),
+          }, h(CloseIcon)),
+        ),
+        h('div', { className: modalStyles.modalBody },
+          h('div', { className: modalStyles.failPrepareHint }, t('settingsResetConfirmDetail')),
+          h('div', { className: modalStyles.modalActions },
+            h('button', {
+              className: modalStyles.restartLater,
+              type: 'button',
+              onClick: () => setResetConfirm(false),
+            }, t('cancel')),
+            h('button', {
+              className: modalStyles.restartNowWarning,
+              type: 'button',
+              onClick: () => { setResetConfirm(false); reset() },
+            }, t('settingsResetConfirm')),
+          ),
+        ),
+      ),
+    ),
+  )
+}

package/src/client/data/catalog.ts

@@ -0,0 +1,38 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * 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.
+ */
+import type { HubPlugin, LocaleId } from '../types.ts'
+import { normalize } from '../logic/normalize.ts'
+
+// 目录/统计数据经服务端 /catalog 代理路由获取（curl 子进程注入设置里的代理），
+// 与 npm / git 安装通道同一代理口径 —— 浏览器不再直连 api.dsh-plugin.org。
+const PROXY_BASE = '/dsh-plugin-hub/catalog'
+const PLUGINS_URL = (lang: LocaleId) => `${PROXY_BASE}?lang=${lang}`
+const STATS_URL = `${PROXY_BASE}?stats=1`
+
+async function fetchJson(url: string): Promise<unknown> {
+  const res = await fetch(url, { cache: 'no-store' })
+  if (!res.ok) throw new Error(String(res.status))
+  return res.json()
+}
+
+/** 目录插件列表（在线 API 已只返回 verified；过滤与排序由上层负责）。 */
+export async function fetchCatalog(lang: LocaleId): Promise<HubPlugin[]> {
+  const data = await fetchJson(PLUGINS_URL(lang))
+  return (Array.isArray(data) ? data : []).map((item) => normalize(item as Record<string, unknown>))
+}
+
+/** 收录/精选统计（/api/stats.json）；字段不完整返回 null。 */
+export async function fetchStats(): Promise<{ total: number; verified: number } | null> {
+  const s = await fetchJson(STATS_URL) as { total?: number; verified?: number }
+  if (s && typeof s.total === 'number' && typeof s.verified === 'number') {
+    return { total: s.total, verified: s.verified }
+  }
+  return null
+}

package/src/client/data/host.ts

@@ -0,0 +1,107 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * 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.
+ */
+import type { EnvInfo } from '../types.ts'
+import type { InstalledVersionSignal } from '../logic/installed.ts'
+
+export interface HostInstalled {
+  installed: Record<string, string>
+  versions: Record<string, InstalledVersionSignal>
+  /** 每个依赖在系统上的安装目录（profile/node_modules/<包名>），宿主未提供为 null */
+  paths: Record<string, string> | null
+  /** 已加载进运行中 loader 的包名（官方 ctx.loader.entries() 对账）：装完未重启的新插件不在其中 */
+  loaded: string[] | null
+  /** 真正的 dsh 插件包名（包内声明 dsh 配置 / 在 profile bundles 清单）：非 dsh 插件（如官方示例仓库）装上也不会被宿主加载，不提示待重启 */
+  dshCapable: string[] | null
+}
+
+/** 当前 profile 已安装插件表（npm 包名 -> manifest spec）+ 安装时记录的目录信号 + 安装路径 + 运行状态。 */
+export async function fetchInstalled(): Promise<HostInstalled | null> {
+  try {
+    const res = await fetch('/dsh-plugin-hub/installed', { cache: 'no-store' })
+    if (!res.ok) return null
+    const data = await res.json() as {
+      installed?: Record<string, string>
+      versions?: Record<string, InstalledVersionSignal>
+      paths?: Record<string, string>
+      loaded?: string[]
+      dshCapable?: string[]
+    }
+    return {
+      installed: data.installed ?? {},
+      versions: data.versions ?? {},
+      paths: data.paths ?? null,
+      loaded: data.loaded ?? null,
+      dshCapable: data.dshCapable ?? null,
+    }
+  } catch {
+    return null
+  }
+}
+
+let envPromise: Promise<EnvInfo | null> | null = null
+
+/** 在系统文件管理器里定位并打开已安装插件的目录（服务端 spawn open，跨平台）；失败返回 false。 */
+export async function revealInstallFolder(name: string): Promise<boolean> {
+  try {
+    const res = await fetch('/dsh-plugin-hub/open-path', {
+      method: 'POST',
+      headers: { 'content-type': 'application/json' },
+      body: JSON.stringify({ name }),
+      cache: 'no-store',
+    })
+    return res.ok
+  } catch {
+    return false
+  }
+}
+
+/** 在系统文件管理器里定位日志文件（服务端 spawn open，跨平台）；失败返回 false。 */
+export async function openLogFile(): Promise<boolean> {
+  try {
+    const res = await fetch('/dsh-plugin-hub/open-log', {
+      method: 'POST',
+      cache: 'no-store',
+    })
+    return res.ok
+  } catch {
+    return false
+  }
+}
+
+/**
+ * 系统目录选择器：弹原生文件夹对话框让用户挑日志存放目录（服务端 spawn
+ * osascript / FolderBrowserDialog / zenity）；选中返回绝对路径，取消或
+ * 平台不支持（无 osascript / zenity）时返回 null。
+ */
+export async function chooseLogDir(): Promise<string | null> {
+  try {
+    const res = await fetch('/dsh-plugin-hub/choose-log-dir', {
+      method: 'POST',
+      cache: 'no-store',
+    })
+    if (!res.ok) return null
+    const data = await res.json() as { path?: string }
+    return typeof data.path === 'string' && data.path !== '' ? data.path : null
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 宿主机器环境快照（/dsh-plugin-hub/env）：提交 bug 时拼进 issue 正文。
+ * 懒加载 + 模块级缓存：环境在会话期间不会变化；拉取失败降级为 null
+ * （issue 链接照常生成，只是少环境段）。
+ */
+export function getEnv(): Promise<EnvInfo | null> {
+  envPromise ??= fetch('/dsh-plugin-hub/env', { cache: 'no-store' })
+    .then((res) => (res.ok ? (res.json() as Promise<EnvInfo>) : null))
+    .catch(() => null)
+  return envPromise
+}

package/src/client/data/hub.ts

@@ -0,0 +1,41 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * 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.
+ */
+import type { HubAboutInfo, HubUpdateInfo } from '../types.ts'
+import { HUB_ABOUT_URL, HUB_UPDATE_URL } from '../logic/constants.ts'
+
+/** Worker 版本控制中心：最新版本 + Markdown 变更记录；不可用返回 null。 */
+export async function fetchHubUpdate(): Promise<HubUpdateInfo | null> {
+  try {
+    const res = await fetch(HUB_UPDATE_URL, { cache: 'no-store' })
+    if (!res.ok) return null
+    const data = await res.json() as HubUpdateInfo | null
+    if (!data) return null
+    const version = typeof data.version === 'string' && data.version.length > 0 ? data.version : null
+    if (version === null) return null
+    return { version, publishedAt: data.publishedAt ?? null, notes: data.notes ?? null }
+  } catch {
+    return null
+  }
+}
+
+/** Worker「关注我们」内容（平台介绍 + 反馈群二维码，Markdown）；未推送返回 null。 */
+export async function fetchHubAbout(): Promise<HubAboutInfo | null> {
+  try {
+    const res = await fetch(HUB_ABOUT_URL, { cache: 'no-store' })
+    if (!res.ok) return null
+    const data = await res.json() as HubAboutInfo | null
+    if (!data || data.content === null || data.content === undefined) return null
+    const content = typeof data.content === 'string' || typeof data.content === 'object' ? data.content : null
+    if (content === null) return null
+    return { content, updatedAt: data.updatedAt ?? null }
+  } catch {
+    return null
+  }
+}