dsh-plugin 1.1.1 → 1.2.0

package/src/server/services/loader.ts

@@ -1,7 +1,14 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * 运行中 loader 的读取与停用：卸载成功后对匹配条目做 live-disable，
  * 使卸载立即生效（刷新页面不再加载已卸载的 client bundle，也无需重启）。
  */
+import { readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { profileDirectory } from './profile/profile.ts'
 
 /**
  * 运行中 loader 的最小接口：卸载成功后即时移除条目用。
@@ -32,6 +39,19 @@ export function dumpLoaderEntries(loader: LoaderHandle | undefined): Array<{ id:
   return entries
 }
 
+/**
+ * 判断某 npm 包名是否已加载进运行中 loader（宽匹配：条目名存在别名变体）。
+ * 官方 `ctx.loader.entries()` 遍历整棵树（reference.md §1.3），条目名 == 插件作者声明的名字。
+ * 安装完成但未重启时条目不在 loader → 返回 false，UI 据此标「待重启/未加载」。
+ */
+export function isEntryLoaded(loader: LoaderHandle | undefined, name: string): boolean {
+  if (!loader) return false
+  for (const entry of Array.from(loader.entries())) {
+    if (nameMatches(entry.options?.name, name)) return true
+  }
+  return false
+}
+
 /**
  * 卸载目标（npm 包名，如 `@scope/widget`）与 loader 条目名的匹配。
  * loader 条目名由插件作者/工具写入，形式不可控，常见变体：
@@ -39,7 +59,8 @@ export function dumpLoaderEntries(loader: LoaderHandle | undefined): Array<{ id:
  *  - 去 `@` 前缀：`scope/widget`
  *  - 去 scope 的短名：`widget`
  *  - scope 分隔符变 `-`：`scope-widget`
- * 因此归一化后比较全串与短名两个维度。profile 内包名唯一，宽松匹配不会误伤其它包。
+ *  - 包内模块路径：`widget/extensions/dsh/index.js`（bundle patch 的 name 常写成模块路径）
+ * 因此归一化后比较全串、短名、路径前缀三个维度。profile 内包名唯一，宽松匹配不会误伤其它包。
  */
 function nameMatches(entryName: string | undefined, target: string): boolean {
   if (!entryName) return false
@@ -56,6 +77,12 @@ function nameMatches(entryName: string | undefined, target: string): boolean {
   // 3) 反向变体：目标短名可能就是条目的完整形式（条目 `scope-widget`，
   //    目标短名 `widget` 是它的尾段）——用「条目名以短名结尾」收口，避免误伤。
   if (tShort.length >= 2 && e.endsWith(`-${tShort}`)) return true
+  // 4) 条目名是目标包内的模块路径（`aegis/extensions/dsh/index.js` 属于包 `aegis`，
+  //    `@scope/pkg/dist/x.js` 属于 `@scope/pkg`）：归一化会吞掉路径分隔符，
+  //    必须在归一化前用原始形态做「target/」前缀判断（大小写不敏感）。
+  const rawE = entryName.trim().toLowerCase()
+  const rawT = target.trim().toLowerCase()
+  if (rawE === rawT || rawE.startsWith(`${rawT}/`)) return true
   return false
 }
 
@@ -115,3 +142,34 @@ export async function removeLoadedEntry(loader: LoaderHandle, name: string): Pro
   console.log(`[hub-uninstall] disable ${name} -> ${result ? 'ok/clean' : 'timed out or failed'}`)
   return result
 }
+
+/**
+ * 判断某已安装包是否是真正的 dsh 插件（宿主会加载 / 值得提示「待重启」）：
+ *  1) 包名已写进 profile 的 `dsh.profile.bundles`（宿主启动时按清单加载）；
+ *  2) 或包内 package.json 声明了 dsh 配置（`dsh.bundle` / `dsh.profile` 等）或 dsh 相关 keywords。
+ * 两者都满足不了（如 GitHub 官方示例仓库 octocat/Hello-World）说明它不是 dsh 插件，
+ * 装上也不会被宿主加载——UI 据此不再提示「待重启」，避免误导用户反复重启一个不会生效的东西。
+ */
+export function isDshPlugin(profile: string, name: string): boolean {
+  // 1) profile 级 bundles 清单：包名在清单里 → 宿主启动会加载它
+  try {
+    const profilePkg = JSON.parse(readFileSync(join(profileDirectory(profile), 'package.json'), 'utf8')) as {
+      dsh?: { profile?: { bundles?: unknown } }
+    }
+    if (Array.isArray(profilePkg.dsh?.profile?.bundles)) {
+      if ((profilePkg.dsh.profile.bundles as unknown[]).includes(name)) return true
+    }
+  } catch { /* profile 读取失败按无 bundles 处理 */ }
+  // 2) 包内声明：dsh 字段（bundle patch / profile 配置）或 dsh 关键字
+  try {
+    const pkg = JSON.parse(readFileSync(join(profileDirectory(profile), 'node_modules', name, 'package.json'), 'utf8')) as {
+      dsh?: unknown
+      keywords?: unknown
+    }
+    if (pkg.dsh) return true
+    if (Array.isArray(pkg.keywords)) {
+      if ((pkg.keywords as unknown[]).some((k) => typeof k === 'string' && /^(?:dsh|dsh-plugin)$/i.test(k))) return true
+    }
+  } catch { /* 包缺失 / 无 package.json → 不是 dsh 插件 */ }
+  return false
+}

package/src/server/services/log.ts

@@ -0,0 +1,167 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * 系统日志：把关键操作以 JSONL 追加到 `~/.dsh/profiles/<profile>/hub.log`。
+ *
+ * 每一条日志 = 级别（严重程度）× 类别（功能域）：
+ *   level    debug / info / success / warn / error —— 区分报错与正常
+ *   category install（安装）/ uninstall（卸载）/ update（更新，预留）/
+ *            diagnostics（诊断）/ settings（设置）/ system（系统）
+ * 查看器按级别与类别过滤，就能针对性排查「安装时哪步不兼容」还是
+ * 「卸载时哪步不兼容」。读取时超行数上限就地裁剪，防文件无限膨胀；
+ * 写入失败绝不影响主流程（日志是辅助设施）。
+ */
+import { appendFileSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { dirname, join, resolve } from 'node:path'
+import { homedir } from 'node:os'
+import { loadSettings } from './settings.ts'
+
+export type LogCategory = 'install' | 'uninstall' | 'update' | 'diagnostics' | 'settings' | 'system'
+export type LogLevel = 'debug' | 'info' | 'success' | 'warn' | 'error'
+
+export interface LogEntry {
+  /** 毫秒时间戳 */
+  at: number
+  level: LogLevel
+  category: LogCategory
+  /** 机器可读事件码，如 install.start / settings.update */
+  event: string
+  /** 人类可读描述 */
+  message: string
+}
+
+/** 日志保留上限：超过后在读取时裁剪为最近 MAX_LOG_LINES 条 */
+export const MAX_LOG_LINES = 2000
+
+const CATEGORIES: LogCategory[] = ['install', 'uninstall', 'update', 'diagnostics', 'settings', 'system']
+
+export interface ReadLogOptions {
+  /** 分页偏移（过滤后倒序） */
+  offset?: number
+  limit?: number
+  category?: LogCategory | 'all'
+  level?: LogLevel | 'all'
+  /** 关键词：大小写不敏感，匹配事件码或描述 */
+  query?: string
+}
+
+export interface ReadLogResult {
+  /** 倒序（最新在前） */
+  entries: LogEntry[]
+  /** 过滤后的总条数（分页前） */
+  total: number
+}
+
+function profileDirectory(profile: string): string {
+  return join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'profiles', profile)
+}
+
+/** `~` 开头路径展开为用户主目录（Node 不自动展开）。 */
+function expandHome(p: string): string {
+  if (p === '~') return homedir()
+  if (p.startsWith('~/') || p.startsWith('~\\')) return join(homedir(), p.slice(2))
+  return p
+}
+
+/**
+ * 把用户填写的日志位置覆盖解析成实际文件路径：
+ * 以 .log 结尾视为文件本身，否则视为目录并在其中写 hub.log；相对路径按当前目录归一化。
+ */
+export function customLogFile(override: string): string {
+  const trimmed = override.trim()
+  const expanded = expandHome(trimmed)
+  const file = /\.log$/i.test(expanded) ? expanded : join(expanded, 'hub.log')
+  return resolve(file)
+}
+
+/**
+ * 真正默认的日志文件路径：`~/.dsh/profiles/<profile>/hub.log`（不受设置覆盖影响）。
+ * 弹窗「恢复默认」、目录选择器起点等需要「未自定义时的位置」都从这里取 ——
+ * 不同机器/平台（用户主目录不同）这个值都不同，必须动态计算而非写死。
+ */
+export function defaultLogFilePath(profile: string): string {
+  return join(profileDirectory(profile), 'hub.log')
+}
+
+/**
+ * 当前生效的日志文件路径：设置里填了 logPath 用自定义位置（目录或文件），
+ * 否则默认 `~/.dsh/profiles/<profile>/hub.log`。默认位置永远合法可用，无需用户干预。
+ */
+export function logFilePath(profile: string): string {
+  const custom = loadSettings(profile).logPath?.trim() ?? ''
+  return custom === '' ? defaultLogFilePath(profile) : customLogFile(custom)
+}
+
+/** 追加一条系统日志（JSONL 一行一条）。 */
+export function appendLog(profile: string, entry: LogEntry): void {
+  try {
+    const file = logFilePath(profile)
+    mkdirSync(dirname(file), { recursive: true })
+    appendFileSync(file, `${JSON.stringify(entry)}\n`)
+  } catch {
+    // 日志失败不阻断主流程
+  }
+}
+
+/** 兼容旧格式：早期无 category（level 用 info/ok/fail/warn），归一化到新版。 */
+function normalize(raw: unknown): LogEntry | null {
+  if (typeof raw !== 'object' || raw === null) return null
+  const e = raw as { at?: unknown; level?: unknown; category?: unknown; event?: unknown; message?: unknown }
+  if (typeof e.at !== 'number') return null
+  let level: LogLevel = 'info'
+  if (e.level === 'ok' || e.level === 'success') level = 'success'
+  else if (e.level === 'fail' || e.level === 'error') level = 'error'
+  else if (e.level === 'warn') level = 'warn'
+  else if (e.level === 'debug') level = 'debug'
+  const category: LogCategory = CATEGORIES.includes(e.category as LogCategory) ? e.category as LogCategory : 'system'
+  return {
+    at: e.at,
+    level,
+    category,
+    event: typeof e.event === 'string' ? e.event : '',
+    message: typeof e.message === 'string' ? e.message : '',
+  }
+}
+
+/** 读取系统日志（按时间正序，最新在末尾），超上限就地裁剪；支持过滤与分页。 */
+export function readLog(profile: string, opts: ReadLogOptions = {}): ReadLogResult {
+  const { offset = 0, limit = 200 } = opts
+  try {
+    const file = logFilePath(profile)
+    const raw = readFileSync(file, 'utf8')
+    let lines = raw.split('\n').filter((l) => l.trim() !== '')
+    if (lines.length > MAX_LOG_LINES) {
+      lines = lines.slice(-MAX_LOG_LINES)
+      writeFileSync(file, `${lines.join('\n')}\n`)
+    }
+    // 正序解析后倒序（最新在前）再过滤分页
+    let entries: LogEntry[] = []
+    for (const line of lines) {
+      let parsed: unknown = null
+      try {
+        parsed = JSON.parse(line)
+      } catch {
+        continue
+      }
+      const entry = normalize(parsed)
+      if (entry !== null) entries.push(entry)
+    }
+    entries.reverse()
+    const needle = opts.query?.trim().toLowerCase() ?? ''
+    if (opts.category !== undefined && opts.category !== 'all') {
+      entries = entries.filter((e) => e.category === opts.category)
+    }
+    if (opts.level !== undefined && opts.level !== 'all') {
+      entries = entries.filter((e) => e.level === opts.level)
+    }
+    if (needle !== '') {
+      entries = entries.filter((e) => e.event.toLowerCase().includes(needle) || e.message.toLowerCase().includes(needle))
+    }
+    const total = entries.length
+    return { entries: entries.slice(offset, offset + limit), total }
+  } catch {
+    return { entries: [], total: 0 }
+  }
+}

package/src/server/services/probe.ts

@@ -0,0 +1,157 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * 连通性探测：对单个 HTTPS 目标发 GET，测速并返回 HTTP 状态码。
+ *
+ * 实现方式：spawn 系统 curl 子进程并注入代理环境变量（HTTP_PROXY/HTTPS_PROXY），
+ * 与安装通道（pnpm/git 子进程）使用同一套代理环境。
+ *
+ * 代理来源由调用方决定（routes.ts）：设置里的代理 → 系统代理 → 环境变量 → 直连。
+ * systemProxy() 读取操作系统级代理（macOS scutil / Windows 注册表），
+ * 使系统代理对 Node 进程可见。
+ */
+import { spawn, spawnSync } from 'node:child_process'
+
+export interface ProbeResult {
+  /** 是否可达（HTTP 状态码 100–399） */
+  ok: boolean
+  /** 毫秒耗时；失败为 null */
+  ms: number | null
+  /** HTTP 状态码；失败为 null */
+  status: number | null
+}
+
+const probeFail = (): ProbeResult => ({ ok: false, ms: null, status: null })
+
+/** macOS 系统代理：scutil --proxy 输出里的 HTTP(S) 代理；未开启返回 null。 */
+function macSystemProxy(): string | null {
+  try {
+    const out = spawnSync('scutil', ['--proxy'], { encoding: 'utf8', timeout: 1500 })
+    if (out.status !== 0) return null
+    const txt = out.stdout ?? ''
+    const val = (key: string): string | undefined => {
+      const m = new RegExp(`^\\s*${key}\\s*:\\s*(.+)$`, 'm').exec(txt)
+      const v = m?.[1]?.trim()
+      return v !== undefined && v !== '' ? v : undefined
+    }
+    const enabled = (val('HTTPSEnable') ?? val('HTTPEnable')) === '1'
+    const host = val('HTTPSProxy') ?? val('HTTPProxy')
+    if (!enabled || host === undefined) return null
+    const port = val('HTTPSPort') ?? val('HTTPPort') ?? '80'
+    if (!/^\d+$/.test(port)) return null
+    return `http://${host}:${port}`
+  } catch {
+    return null
+  }
+}
+
+/** Windows 系统代理：WinINET Internet 设置注册表；未开启返回 null。 */
+function winSystemProxy(): string | null {
+  try {
+    const key = 'HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings'
+    const enable = spawnSync('reg', ['query', key, '/v', 'ProxyEnable'], { encoding: 'utf8', timeout: 1500 })
+    const server = spawnSync('reg', ['query', key, '/v', 'ProxyServer'], { encoding: 'utf8', timeout: 1500 })
+    if (!/0x1/i.test(enable.stdout ?? '')) return null
+    const m = /([^:\s=]+):(\d+)/.exec(server.stdout ?? '')
+    if (m === null) return null
+    return `http://${m[1]}:${m[2]}`
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 操作系统级代理（macOS 系统网络设置 / Windows Internet 设置）。
+ * Node 内置 http(s) 不读系统代理，浏览器挂的代理 Node 看不见 —— 这里读出来
+ * 作为默认代理，保证「浏览器能开、安装/诊断就能通」。
+ * Linux 没有统一的系统代理入口，返回 null（交给环境变量 / 设置里的代理）。
+ */
+export function systemProxy(): string | null {
+  if (process.platform === 'darwin') return macSystemProxy()
+  if (process.platform === 'win32') return winSystemProxy()
+  return null
+}
+
+/**
+ * curl 子进程探测：spawn curl -s -w '%{http_code}' 并注入代理 env。
+ * curl 读 HTTP_PROXY/HTTPS_PROXY 是原生行为，与 pnpm/git 安装通道同一套代理口径；
+ * 失败（curl 不存在 / 连接失败 / 超时）都归为不可达，全程不抛错。
+ */
+function curlProbe(url: string, proxy: string, timeoutMs: number): Promise<ProbeResult> {
+  return new Promise((resolve) => {
+    const started = Date.now()
+    const env: NodeJS.ProcessEnv = { ...process.env }
+    if (proxy !== '') {
+      env.HTTP_PROXY = proxy
+      env.HTTPS_PROXY = proxy
+      env.http_proxy = proxy
+      env.https_proxy = proxy
+    }
+    const discard = process.platform === 'win32' ? 'NUL' : '/dev/null'
+    const child = spawn('curl', [
+      '-s', '-o', discard, '-w', '%{http_code}',
+      '--max-time', String(Math.max(1, Math.round(timeoutMs / 1000))),
+      url,
+    ], { env })
+    let code = ''
+    child.stdout.on('data', (c: Buffer) => { code += c.toString() })
+    let done = false
+    const finish = (r: ProbeResult) => {
+      if (done) return
+      done = true
+      clearTimeout(timer)
+      resolve(r)
+    }
+    child.on('error', () => finish(probeFail()))
+    child.on('close', () => {
+      const status = /^\d+$/.test(code.trim()) ? Number(code.trim()) : null
+      finish({ ok: status !== null && status >= 100 && status < 400, ms: Date.now() - started, status })
+    })
+    // 超时兜底：curl --max-time 到点自行退出，此处再设一个进程级超时防止悬挂
+    const timer = setTimeout(() => { child.kill(); finish(probeFail()) }, timeoutMs + 1000)
+  })
+}
+
+/**
+ * 探测一个 HTTPS 目标：proxy 非空注入给 curl 子进程走代理，否则直连。
+ * 供系统诊断 /diagnostics 使用；目标 URL 非法返回不可达。
+ */
+export function probeUrl(url: string, proxy: string, timeoutMs: number): Promise<ProbeResult> {
+  let target: URL
+  try { target = new URL(url) } catch { return Promise.resolve(probeFail()) }
+  return curlProbe(target.href, proxy, timeoutMs)
+}
+
+/**
+ * curl 子进程抓取响应体（与 probeUrl 同一套代理 env 注入）。
+ * 供服务端 /catalog 代理路由使用：目录/统计数据经此拉到服务端再转给浏览器，
+ * 使「目录数据请求走设置里的代理」与 npm / git 安装通道口径一致。
+ * 失败（curl 不存在 / 连接失败 / 超时 / 非零退出）时 ok=false，全程不抛错。
+ */
+export function fetchViaCurl(url: string, proxy: string, timeoutMs: number): Promise<{ ok: boolean; body: string }> {
+  return new Promise((resolve) => {
+    const env: NodeJS.ProcessEnv = { ...process.env }
+    if (proxy !== '') {
+      env.HTTP_PROXY = proxy
+      env.HTTPS_PROXY = proxy
+      env.http_proxy = proxy
+      env.https_proxy = proxy
+    }
+    const child = spawn('curl', ['-s', '--max-time', String(Math.max(1, Math.round(timeoutMs / 1000))), url], { env })
+    let body = ''
+    child.stdout.on('data', (c: Buffer) => { body += c.toString() })
+    let done = false
+    const finish = (ok: boolean) => {
+      if (done) return
+      done = true
+      clearTimeout(timer)
+      resolve({ ok, body })
+    }
+    child.on('error', () => finish(false))
+    child.on('close', (code) => finish(code === 0))
+    // 超时兜底：curl --max-time 到点自行退出，此处再设一个进程级超时防止悬挂
+    const timer = setTimeout(() => { child.kill(); finish(false) }, timeoutMs + 1000)
+  })
+}

package/src/server/services/{installed-versions.ts → profile/installed-versions.ts}

@@ -1,8 +1,12 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * Installed-plugin version tracking.
  *
  * The installed table (`readInstalled` in routes.ts) only knows the manifest
- * spec of each dependency (`github:<owner>/<repo>`), which carries no version.
+ * spec of each Git dependency, which carries no version.
  * To let the Plugin Hub tell "an update is available", we record the catalog
  * signal present at install time into a small per-profile JSON file, then
  * compare it against the catalog's current signal later.

package/src/server/services/{pending-restart.ts → profile/pending-restart.ts}

@@ -1,12 +1,18 @@
-/** 待重启列表的内存态管理（宿主进程一重启自然清空）。 */
-import type { PendingRestart } from './install-types.ts'
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * 待重启列表的内存态管理（宿主进程一重启自然清空）。
+ */
+import type { PendingRestart } from '../install/install-types.ts'
 
 const pendingRestarts: PendingRestart[] = []
 
 /**
  * 登记一条待重启记录（同一目标去重）。
  * - 卸载：目标刚装完未重启（已有待重启记录）→ 宿主从未加载过它，卸完磁盘已干净、
- *   loader 无残留，无需再提醒重启，直接移除该条；否则（此前已被宿主加载过）登记「卸载后待重启清理」。
+ *   loader 无残留，无需再提醒重启，直接移除该条；否则（已被宿主加载过）登记「卸载后待重启清理」。
  * - 安装：已有记录则刷新为安装语义（如卸载后未重启又重装），否则新登记。
  */
 export function addPendingRestart(target: string, kind: 'install' | 'uninstall'): void {

package/src/server/services/{profile.ts → profile/profile.ts}

@@ -1,11 +1,15 @@
 /**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
  * 宿主 profile 与目标校验工具：解析当前 profile、目录定位、安装目标语法校验，
  * 以及 pnpm allowBuilds 白名单的写入（失败恢复路径）。
  */
 import { readFileSync, writeFileSync } from 'node:fs'
 import { homedir } from 'node:os'
 import { join } from 'node:path'
-import { PACKAGE_RE, REPO_RE } from './install-types.ts'
+import { PACKAGE_RE, REPO_RE } from '../install/install-types.ts'
 
 /** Resolve the active profile from the booted CLI args, falling back to `web`. */
 export function readProfileArg(fallback = 'web'): string {
@@ -19,10 +23,60 @@ export function profileDirectory(profile: string): string {
   return join(process.env.DSH_HOME ?? join(homedir(), '.dsh'), 'profiles', profile)
 }
 
-/** Build a safe `github:<owner>/<repo>` target, or null when the repo is unsafe. */
+/** Build a safe explicit HTTPS Git target, or null when the repo is unsafe. */
 export function githubTarget(repo: string): string | null {
   if (typeof repo !== 'string' || !REPO_RE.test(repo)) return null
-  return `github:${repo}`
+  return `git+https://github.com/${repo}.git`
+}
+
+/**
+ * DSH 命令行前缀（`dsh plugin [--profile|-p <p>] add <target>`）—— 提取其中的安装目标；
+ * 非命令输入原样返回。兼容「直接粘贴完整命令」（防用户输错）：--profile 段可选，
+ * 支持 `-p` 简写与 `--profile=web` 等号形式，命令大小写不敏感。
+ */
+const DSH_PLUGIN_CMD_RE = /^dsh\s+plugin\s+(?:(?:--profile|-p)(?:=|\s+)\S+\s*)?add\s+(.+)$/i
+
+export function installTargetOf(value: string): string {
+  const input = typeof value === 'string' ? value.trim() : ''
+  const match = DSH_PLUGIN_CMD_RE.exec(input)
+  return match !== null ? match[1].trim() : input
+}
+
+/**
+ * npm 全局安装命令（官方 README 的 `npm install -g <pkgs>`，如 dsh-tui 的安装命令）——
+ * 提取 -g 之后的包列表。支持 `npm install|i` 与 `-g|--global`；任一包名非法（或格式
+ * 不匹配）返回 null，由调用方按「不支持的目标」处理。与客户端 CustomInstallView 同口径。
+ */
+const NPM_GLOBAL_CMD_RE = /^npm\s+(?:install|i)\s+(?:-g|--global)\s+(.+)$/i
+
+export function globalNpmPackagesOf(value: string): string[] | null {
+  const input = typeof value === 'string' ? value.trim() : ''
+  const match = NPM_GLOBAL_CMD_RE.exec(input)
+  if (match === null) return null
+  const packages = match[1].trim().split(/\s+/).filter((p) => p !== '')
+  // 包名逐个校验 + 拒绝以 - 开头的 token（npm 会把 --xxx 当参数而非包名，防注入任意 CLI 参数）
+  if (packages.length === 0 || packages.some((p) => !validPackageName(p) || p.startsWith('-'))) return null
+  return packages
+}
+
+/** Extract an owner/repo identity from a catalog value or an installed Git spec. */
+export function githubRepoOf(value: string): string | null {
+  if (typeof value !== 'string') return null
+  const input = value.trim()
+  if (REPO_RE.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) continue
+    const repo = `${match[1]}/${match[2]}`
+    if (REPO_RE.test(repo)) return repo
+  }
+  return null
 }
 
 /** Validate an npm package name (uninstall target grammar). */
@@ -32,7 +86,7 @@ export function validPackageName(name: string): boolean {
 
 /**
  * The exact `allowBuilds` key pnpm printed in its
- * `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED` hint. For `github:` installs pnpm
+ * `ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED` hint. For Git installs pnpm
  * matches against `name@<resolved fetch URL>` — the URL it actually fetches,
  * e.g. `https://codeload.github.com/<owner>/<repo>/tar.gz/<commit>` — not the
  * `git+ssh://`/branch spec. A bare name or a `git+` spec does not match, so

package/src/server/services/{progress.ts → profile/progress.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
+ *
  * Pure progress-estimation helpers shared by the install runner.
  *
  * The dsh CLI wraps pnpm, which refreshes its `Progress: …` line in place

package/src/server/services/settings.ts

@@ -0,0 +1,79 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Hub settings persistence: one `hub-settings.json` per active profile
+ * (next to pnpm-workspace.yaml). All fields optional; missing keys fall
+ * back to DEFAULT_SETTINGS so old files stay readable as new options land.
+ */
+import { readFileSync, writeFileSync, mkdirSync, rmSync } from 'node:fs'
+import { dirname, join } from 'node:path'
+import { profileDirectory } from './profile/profile.ts'
+
+export interface HubSettings {
+  /** 启动时检查目录插件更新，发现可更新时在通知中心提示（安装不自动进行） */
+  checkUpdatesOnStart: boolean
+  /** npm 镜像源 registry 地址（空串 = 官方 https://registry.npmjs.org） */
+  npmRegistry: string
+  /** HTTP(S) 代理地址，用于 npm / git / 目录请求（空串 = 直连） */
+  proxy: string
+  /** 启用命令行安装 NPM 包（默认开；关掉后输入 npm 包名安装被拦截） */
+  enableNpmInstall: boolean
+  /** 启用命令行安装 GitHub 源码（默认开；关掉后输入 GitHub 地址安装被拦截） */
+  enableGitInstall: boolean
+  /** 启用命令行粘贴 dsh plugin 命令安装（默认开；关掉后命令输入被禁用） */
+  enableDshInstall: boolean
+  /** 日志存放位置覆盖（空串 = 默认 ~/.dsh/profiles/<profile>/hub.log；可填目录或 .log 文件路径） */
+  logPath: string
+}
+
+export const DEFAULT_SETTINGS: HubSettings = {
+  checkUpdatesOnStart: true,
+  npmRegistry: '',
+  proxy: '',
+  enableNpmInstall: true,
+  enableGitInstall: true,
+  enableDshInstall: true,
+  logPath: '',
+}
+
+export function settingsFile(profile: string): string {
+  return join(profileDirectory(profile), 'hub-settings.json')
+}
+
+/** 读取当前 profile 的设置；文件缺失/损坏时回退默认值（只读路径绝不抛错）。 */
+export function loadSettings(profile: string): HubSettings {
+  try {
+    const raw = JSON.parse(readFileSync(settingsFile(profile), 'utf8')) as Partial<HubSettings>
+    return {
+      ...DEFAULT_SETTINGS,
+      ...(typeof raw === 'object' && raw !== null ? raw : {}),
+    }
+  } catch {
+    return { ...DEFAULT_SETTINGS }
+  }
+}
+
+/** 合并并持久化设置（部分更新），返回合并后的完整设置。 */
+export function saveSettings(profile: string, patch: Partial<HubSettings>): HubSettings {
+  const next = { ...loadSettings(profile), ...patch }
+  const file = settingsFile(profile)
+  try {
+    mkdirSync(dirname(file), { recursive: true })
+    writeFileSync(file, `${JSON.stringify(next, null, 2)}\n`)
+  } catch {
+    // 持久化失败不阻断本次会话：内存值仍生效，下次写入再试
+  }
+  return next
+}
+
+/** 重置为默认设置：删除设置文件，下次读取全部回退默认值（陈旧/白名单外键一并清除）。 */
+export function resetSettings(profile: string): HubSettings {
+  try {
+    rmSync(settingsFile(profile), { force: true })
+  } catch {
+    // 删除失败不阻断：loadSettings 仍回退默认值
+  }
+  return { ...DEFAULT_SETTINGS }
+}

package/lib/services/install.js

@@ -1,4 +0,0 @@
-export { addPendingRestart, clearPendingRestart, listPendingRestarts } from './pending-restart.js';
-export { dumpLoaderEntries, removeLoadedEntry } from './loader.js';
-export { addAllowBuildsKey, githubTarget, parseAllowBuildsKey, readProfileArg, validPackageName } from './profile.js';
-export { activeTask, cancelTask, getTask, hasQueuedTarget, hasRunningTask, runPluginMutation, startPluginMutation } from './task-queue.js';