dsh-plugin 1.1.1 → 1.2.0

package/src/client/logic/urls.ts

@@ -0,0 +1,125 @@
+/**
+ * DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * URL builders: catalog detail pages, plugin site links and the pre-filled
+ * GitHub issue URL used by the failure modal. Pure functions — the issue
+ * URL stays within GitHub's 8192-byte request limit.
+ */
+import type { EnvInfo, HubPlugin, LocaleId } from '../types.ts'
+import { GITHUB_URL, PLUGIN_VERSION, SITE_URL } from './constants.ts'
+import { MAX_CORE_CHARS, classifyFailure, coreErrorCode, summarizeError } from './failures.ts'
+
+/** dsh-plugin.org 中文页挂在 /zh/ 前缀下，英文在根路径。 */
+export function langPathOf(lang: LocaleId): string {
+  return lang === 'zh' ? 'zh/' : ''
+}
+
+/**
+ * 官网详情页两级路径：/plugins/{ownerSlug}/{slug}；
+ * 缺 ownerSlug 时从 repo 推导（卡片详情按钮与弹窗来源行共用）。
+ */
+export function pluginDetailUrl(plugin: HubPlugin, langPath: string): string {
+  const repo = plugin.source?.repo ?? ''
+  return `${SITE_URL}${langPath}plugins/${plugin.ownerSlug ?? repo.split('/')[0]?.toLowerCase() ?? ''}/${plugin.slug}`
+}
+
+/**
+ * 失败弹窗里仓库地址的跳转目标：官网详情页（含插件收录信息），
+ * 与 issue 正文的 Catalog 链接同一形式（单级 /plugins/{repo}）。
+ */
+export function pluginSiteUrl(repo: string): string {
+  return `${SITE_URL}plugins/${repo}`
+}
+
+/**
+ * 一键反馈 GitHub Issue 的预填链接：标题带「来自 dsh-plugin.org」标识，正文只带
+ * 核心信息 —— 原因判定 + 关键错误代码 + 尝试过的安装方式 + 宿主机器环境快照 +
+ * 错误核心摘要（完整日志太长，塞进 URL 会被 GitHub 以「request URL too long」拒绝，
+ * 故只收集重点）。错误弹窗、失败记录共用此逻辑。
+ * env 取不到时为 null，链接照常生成、只是少环境段。
+ * attempts（尝试过的安装方式，npm 反查 + 实际执行命令）：作者看到我们查过/试过的命令，
+ * 组织 scope 与 GitHub 用户名不一致时也能直接指认正确的 npm 包名。
+ */
+export function pluginIssueUrl(repo: string, message: string, env?: EnvInfo | null, command?: string, attempts?: string[]): string {
+  const title = `[dsh-plugin.org | dsh-plugin-hub] Install/Remove failed: ${repo}`
+  // 原因判定：按失败类型归类，便于作者判断问题是否出在插件侧。
+  // [packaging]（预检/装后校验拦截）单独列：无论走 npm 还是 git 通道，都是分发物不完整
+  // （package.json 声明的入口文件在发布物里缺失），作者照此补齐即可。
+  const kind = classifyFailure(message)
+  const reason = /\[packaging\]/i.test(message)
+    ? 'plugin distribution is incomplete — the entry file declared in package.json is missing from the published package (github tarball or npm package); please commit build output or publish a complete package'
+      : kind === 'pluginPrepare'
+        ? 'plugin prepare/build script failed during install (packaging/distribution issue)'
+        : kind === 'pnpmIgnoredBuild'
+          ? 'plugin depends on a native module whose build script pnpm blocks by default (use a prebuilt variant)'
+          : 'plugin-side install failure'
+  const code = coreErrorCode(message)
+  // 按给定核心摘要预算构建完整预填 URL（含 URL 编码）；预算可调，供超长时逐档缩小
+  const build = (coreChars: number): string => {
+    const body = [
+      '## Summary',
+      `- Cause: ${reason}`,
+      ...(code ? [`- Key error: \`${code}\``] : []),
+      '',
+      // 来源说明：标题（链官网）+ 一句来源（链仓库）+ 实际执行的安装命令（含 --profile）与执行结果，链接由常量动态拼接
+      `## [DSH-Plugin 插件中心](${SITE_URL}) · 安装 Plugin 失败错误信息`,
+      `本错误信息由 [dsh-plugin-hub](${GITHUB_URL}) 插件中心的安装程序自动生成，随本次安装失败一并提交。`,
+      `- 实际执行的安装命令：\`${command ?? `dsh plugin${env?.profile ? ` --profile ${env.profile}` : ''} add git+https://github.com/${repo}.git`}\``,
+      `- 执行结果：安装失败，未能安装该插件。`,
+      // 尝试过的安装方式（npm 反查 + 实际执行命令，按先后顺序）：作者据此反推正确的
+      // npm 包名 —— 组织 scope 与 GitHub 用户名不一致时仅凭仓库名猜不到，作者看到我们
+      // 查过/试过的命令就能直接指认
+      ...(attempts && attempts.length > 0
+        ? ['', '## Attempted install channels（已尝试的安装方式）', ...attempts.map((a) => `- ${a}`)]
+        : []),
+      // [packaging] 场景：说明两种官方安装通道（npm 包 / git 直装），当前插件在对应通道下分发不完整
+      ...(/\[packaging\]/i.test(message)
+        ? [
+          '',
+          '## 安装方式说明',
+          'DSH 插件支持两种官方安装通道：`dsh plugin add <npm-package>`（npm 分发，需发布完整构建产物）与 `dsh plugin add git+https://github.com/owner/repo.git`（Git 直装，仓库需提交构建产物或在 package.json 提供 `prepare` 脚本）。当前插件的分发物缺少 package.json 声明的入口文件，请按所用通道补齐后重新发布。',
+        ]
+        : []),
+      '',
+      '## Environment',
+      `- Plugin: \`${repo}\``,
+      // 宿主机器环境快照：便于作者本地复现；某字段缺失时如实写 unknown，不编造
+      ...(env
+        ? [
+          `- DSH: ${env.dshVersion ? `v${env.dshVersion}` : 'unknown'}`,
+          `- Plugin Hub: v${PLUGIN_VERSION}`,
+          `- Node: ${env.nodeVersion}`,
+          `- OS: ${env.platform} ${env.arch} (${env.release})`,
+          `- Profile: \`${env.profile}\``,
+          `- DSH Home: \`${env.dshHome}\``,
+        ]
+        : []),
+      // 该插件在插件中心的收录位置（详情页链接）
+      `- Catalog: [${pluginSiteUrl(repo)}](${pluginSiteUrl(repo)})`,
+      '',
+      '## Error (core)',
+      '',
+      '```',
+      // 核心错误收集器：只挑关键行（错误代码/构建失败/退出信息），去重截断，URL 才不至于超长
+      summarizeError(message, coreChars),
+      '```',
+      '',
+      '---',
+      // 底部署名：报错来自内置在 DeepSeek Harness 里的 dsh-plugin-hub 安装程序
+      `This error was produced by the [dsh-plugin-hub](${GITHUB_URL}) installer bundled with DeepSeek Harness.`,
+    ].join('\n')
+    return `https://github.com/${repo}/issues/new?title=${encodeURIComponent(title)}&body=${encodeURIComponent(body)}`
+  }
+  // GitHub 请求行上限 8192 字节：先用宽松预算（最多 ~5K 核心错误）构建，超长再逐档缩小，保证最终 URL 不超限
+  const MAX_URL_CHARS = 7600
+  let url = build(MAX_CORE_CHARS)
+  if (url.length > MAX_URL_CHARS) {
+    for (const budget of [4000, 2500, 1400, 800, 400]) {
+      url = build(budget)
+      if (url.length <= MAX_URL_CHARS) break
+    }
+  }
+  return url
+}

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

@@ -0,0 +1,191 @@
+/* DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * 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. The two
+ * installer cards (npm / GitHub) stack one per line; each card = channel
+ * label + example hint above the input + input row (input + install button)
+ * + optional format-error note. Colors resolve through the --hub-* tokens.
+ */
+
+.root {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  min-width: 0;
+  /* 输入面板集中在左侧可读宽度，避免在宽窗口里把输入框拉得过长 */
+  max-width: 560px;
+}
+
+/* 页面说明：一行灰字，交代这是做什么的、装完去哪看 */
+.desc {
+  margin: 0;
+  font-size: 12px;
+  line-height: 18px;
+  color: var(--hub-text-tertiary);
+}
+
+/* —— 输入卡片：NPM / GitHub 两块，一行一个 —— */
+.installCards {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+  flex-shrink: 0;
+  min-width: 0;
+}
+
+.installCard {
+  display: flex;
+  flex-direction: column;
+  gap: 8px;
+  min-width: 0;
+  padding: 10px 12px;
+  background: var(--hub-bg-1);
+  border: 1px solid var(--hub-border-1);
+  border-radius: 8px;
+}
+
+.installCardHead {
+  display: flex;
+  align-items: center;
+  min-width: 0;
+}
+
+.installLabel {
+  font-size: 12px;
+  line-height: 18px;
+  font-weight: 600;
+  color: var(--hub-text-primary);
+}
+
+/* 文本框上方的示例：灰字小字，告诉用户该通道的推荐写法 */
+.installExample {
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--hub-text-tertiary);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  min-width: 0;
+}
+
+.installRow {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+}
+
+.installInput {
+  flex: 1 1 auto;
+  min-width: 0;
+  height: 28px;
+  padding: 0 9px;
+  font-size: 12px;
+  line-height: 26px;
+  color: var(--hub-text-primary);
+  background: transparent;
+  border: 1px solid var(--hub-border-2);
+  border-radius: 6px;
+  outline: none;
+  transition: border-color 120ms ease;
+}
+
+.installInput::placeholder {
+  color: var(--hub-text-tertiary);
+}
+
+.installInput:focus {
+  border-color: var(--hub-brand);
+}
+
+.installInputError,
+.installInputError:focus {
+  border-color: var(--hub-danger-text);
+}
+
+.installBtn {
+  flex-shrink: 0;
+  font-family: inherit;
+  font-size: 12px;
+  line-height: 18px;
+  font-weight: 500;
+  color: #fff;
+  background: var(--hub-brand);
+  border: none;
+  border-radius: 6px;
+  padding: 5px 14px;
+  cursor: pointer;
+  user-select: none;
+  transition: background 120ms ease, opacity 120ms ease;
+}
+
+.installBtn:hover {
+  background: var(--hub-brand-hover);
+}
+
+.installBtn:disabled {
+  opacity: 0.45;
+  cursor: default;
+}
+
+/* 通道关闭（安全信任开关关掉）：卡片整体压暗，输入行换成提示行 */
+.installCardDisabled {
+  opacity: 0.8;
+}
+
+/* 通道关闭提示行：琥珀色提示 + 「前往设置」按钮，替代示例与输入行 */
+.channelOff {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px;
+  min-width: 0;
+  padding: 6px 9px;
+  font-size: 12px;
+  line-height: 16px;
+  color: var(--hub-warn);
+  background: var(--hub-warn-tint);
+  border: 1px solid var(--hub-warn-border);
+  border-radius: 6px;
+}
+
+.channelOffText {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.channelOffBtn {
+  flex-shrink: 0;
+  font-family: inherit;
+  font-size: 12px;
+  line-height: 18px;
+  font-weight: 500;
+  color: var(--hub-warn-strong);
+  background: transparent;
+  border: 1px solid var(--hub-warn-border);
+  border-radius: 6px;
+  padding: 3px 10px;
+  cursor: pointer;
+  white-space: nowrap;
+  transition: background 120ms ease, color 120ms ease;
+}
+
+.channelOffBtn:hover {
+  background: var(--hub-warn-tint);
+  color: var(--hub-warn);
+}
+
+/* 格式错误：输入框红边框 + 卡片下方红字提示（给出该通道的推荐写法） */
+.installError {
+  font-size: 12px;
+  line-height: 16px;
+  color: var(--hub-danger-text);
+  background: var(--hub-danger-tint);
+  border: 1px solid var(--hub-danger-border);
+  border-radius: 6px;
+  padding: 5px 8px;
+}

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

@@ -0,0 +1,231 @@
+/* DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * System diagnostics list: every connectivity probe is one row — name,
+ * target address, latency and a live status badge (200 OK / Unreachable /
+ * Checking…). The list runs automatically when the page opens; each row is
+ * a button — click to re-probe just that channel with a visible
+ * running→result feedback loop. Colors resolve through the --hub-* tokens. */
+
+.panel {
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+}
+
+/* —— 系统版本（最顶部）—— */
+
+/* 版本行：左侧标题+说明，右侧「复制」按钮；与设置行同构，置顶展示 */
+.envRow {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 8px 12px;
+  border-bottom: 1px solid var(--hub-border-1);
+}
+
+.envLabel {
+  flex: 1;
+  min-width: 0;
+}
+
+.envTitle {
+  font-size: 12.5px;
+  line-height: 18px;
+  font-weight: 500;
+  color: var(--hub-text-primary);
+}
+
+.envDesc {
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--hub-text-tertiary);
+}
+
+.envCopyBtn {
+  flex: none;
+  height: 24px;
+  padding: 0 12px;
+  font-size: 11.5px;
+  font-weight: 500;
+  color: var(--hub-text-secondary);
+  background: var(--hub-bg-hover);
+  border: 1px solid var(--hub-border-2);
+  border-radius: 6px;
+  cursor: pointer;
+  user-select: none;
+  transition: color 0.12s ease, background-color 0.12s ease, border-color 0.12s ease;
+}
+
+.envCopyBtn:hover:not(:disabled) {
+  color: var(--hub-text-primary);
+  background: var(--hub-bg-2);
+}
+
+.envCopyBtn:disabled {
+  opacity: 0.55;
+  cursor: default;
+}
+
+/* 头部行：左侧说明文字，右侧「立即诊断」品牌色按钮 */
+.head {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  padding: 8px 12px;
+  border-bottom: 1px solid var(--hub-border-1);
+}
+
+.headHint {
+  flex: 1;
+  min-width: 0;
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--hub-text-tertiary);
+}
+
+.runBtn {
+  flex: none;
+  height: 24px;
+  padding: 0 12px;
+  font-size: 11.5px;
+  font-weight: 500;
+  color: var(--hub-brand);
+  background: var(--hub-brand-tint);
+  border: 1px solid transparent;
+  border-radius: 6px;
+  cursor: pointer;
+  user-select: none;
+  transition: color 0.12s ease, background-color 0.12s ease, border-color 0.12s ease;
+}
+
+.runBtn:hover:not(:disabled) {
+  color: #ffffff;
+  background: var(--hub-brand);
+  border-color: var(--hub-brand);
+}
+
+.runBtn:disabled {
+  opacity: 0.55;
+  cursor: default;
+}
+
+/* 一行一个通道：整行可点击重测，悬浮高亮，检测中置灰不可点 */
+.row {
+  display: flex;
+  align-items: center;
+  gap: 10px;
+  width: 100%;
+  min-width: 0;
+  box-sizing: border-box;
+  padding: 9px 12px;
+  border: none;
+  border-bottom: 1px solid var(--hub-border-1);
+  background: transparent;
+  font: inherit;
+  text-align: left;
+  cursor: pointer;
+  user-select: none;
+  transition: background-color 0.12s ease;
+}
+
+.row:last-of-type {
+  border-bottom: none;
+}
+
+.row:hover:not(:disabled) {
+  background: var(--hub-bg-hover);
+}
+
+.row:disabled {
+  cursor: default;
+}
+
+.name {
+  flex: none;
+  font-size: 12.5px;
+  line-height: 18px;
+  font-weight: 500;
+  color: var(--hub-text-primary);
+  white-space: nowrap;
+}
+
+/* 目标地址（registry 地址 / github.com / dsh-plugin.org）：次级灰，过长省略 */
+.display {
+  flex: 1;
+  min-width: 0;
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--hub-text-tertiary);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+/* 耗时：成功时显示，如 42ms，等宽数字 */
+.meta {
+  flex: none;
+  font-size: 11px;
+  line-height: 16px;
+  color: var(--hub-text-tertiary);
+  font-variant-numeric: tabular-nums;
+}
+
+/* 状态徽章：成功绿 / 失败红 / 检测中灰底闪烁 / 待检空 */
+.badge {
+  flex: none;
+  padding: 0 8px;
+  height: 17px;
+  border-radius: 999px;
+  font-size: 10.5px;
+  line-height: 17px;
+  text-align: center;
+  white-space: nowrap;
+  font-variant-numeric: tabular-nums;
+}
+
+.badgeOk {
+  color: var(--hub-success);
+  background: var(--hub-success-tint);
+}
+
+.badgeFail {
+  color: var(--hub-danger-text);
+  background: var(--hub-danger-tint);
+}
+
+.badgeRunning {
+  color: var(--hub-text-secondary);
+  background: var(--hub-bg-hover);
+  animation: diagPulse 1s ease-in-out infinite;
+}
+
+.badgeIdle {
+  color: var(--hub-text-disabled);
+  background: var(--hub-bg-hover);
+}
+
+@keyframes diagPulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.4; }
+}
+
+/* 底部总览：全部通过 / 存在异常 / 检测中，与列表行左对齐 */
+.summary {
+  padding: 8px 12px 10px;
+  font-size: 11px;
+  line-height: 16px;
+}
+
+.summaryOk {
+  color: var(--hub-success);
+}
+
+.summaryFail {
+  color: var(--hub-danger-text);
+}
+
+.summaryRunning {
+  color: var(--hub-text-tertiary);
+}

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

@@ -1,66 +1,72 @@
-/* 自绘下拉（替换原生 <select>）。颜色跟随宿主主题：经 --hub-* 设计令牌解析，
- * 与 Header 的控件（排序/分段）保持一致的无边框 + 圆角语言。 */
+/* DSH-Plugin Hub — the community plugin marketplace for DeepSeek Harness.
+ * Website: https://dsh-plugin.org
+ * GitHub: https://github.com/dshplugin/dsh-plugin-hub
+ *
+ * Button-style dropdown: the trigger reads as a compact toolbar button
+ * (hairline border + subtle fill + current value + chevron), the panel is
+ * a floating menu with hover fills and a brand-highlighted active option.
+ * Colors resolve through the --hub-* design tokens. */
+
 .dropdown {
   position: relative;
-  display: inline-flex;
   flex-shrink: 0;
 }
 
+/* 触发器：工具栏按钮风格 —— 细边框 + 次级灰底，与通知入口按钮同一视觉语言，
+   只占一个按钮位，给工具栏后续新增按钮留空间 */
 .dropdownBtn {
   display: inline-flex;
   align-items: center;
   gap: 6px;
-  height: 24px;
-  padding: 0 8px;
+  box-sizing: border-box;
+  height: 28px;
+  padding: 0 10px;
+  border: 1px solid var(--hub-border-2);
+  border-radius: 6px;
   font-size: 12px;
-  line-height: 22px;
+  line-height: 26px;
   color: var(--hub-text-primary);
-  background: transparent;
-  border: none;
-  border-radius: 6px;
+  background: var(--hub-bg-hover);
   cursor: pointer;
   user-select: none;
-  white-space: nowrap;
-  transition: background 120ms ease;
+  transition: color 120ms ease, background 120ms ease, border-color 120ms ease;
 }
 
 .dropdownBtn:hover {
-  background: var(--hub-bg-hover);
+  background: rgba(128, 128, 128, 0.28);
 }
 
 .dropdownLabel {
-  min-width: 0;
-  overflow: hidden;
-  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 
+/* 箭头：弱化灰，展开时 180° 翻转并加深，提示可收起 */
 .dropdownArrow,
 .dropdownArrowOpen {
   display: inline-flex;
-  align-items: center;
-  justify-content: center;
   color: var(--hub-text-tertiary);
-  transition: transform 120ms ease;
+  transition: transform 120ms ease, color 120ms ease;
 }
 
 .dropdownArrowOpen {
+  color: var(--hub-text-secondary);
   transform: rotate(180deg);
 }
 
+/* 浮层：跟随按钮左对齐（left:0），浅底 + 细边框，不加模糊背景投影，克制不抢内容 */
 .dropdownPanel {
   position: absolute;
   top: calc(100% + 4px);
   left: 0;
-  z-index: 50;
   min-width: 100%;
-  display: flex;
-  flex-direction: column;
-  gap: 2px;
+  z-index: 20;
   padding: 4px;
-  background: var(--hub-bg-1);
   border: 1px solid var(--hub-border-2);
   border-radius: 8px;
-  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.14);
+  background: var(--hub-bg-1);
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
 }
 
 .dropdownItem,
@@ -68,38 +74,37 @@
   display: flex;
   align-items: center;
   justify-content: space-between;
-  gap: 10px;
-  font-size: 12px;
-  line-height: 18px;
+  gap: 12px;
+  width: 100%;
+  padding: 5px 8px;
   border: none;
   border-radius: 6px;
-  padding: 4px 9px;
+  font-size: 12px;
+  line-height: 16px;
+  text-align: left;
   cursor: pointer;
   user-select: none;
-  white-space: nowrap;
-  text-align: left;
-  transition: background 120ms ease, color 120ms ease;
+  transition: color 120ms ease, background 120ms ease;
 }
 
 .dropdownItem {
-  color: var(--hub-text-primary);
+  color: var(--hub-text-secondary);
   background: transparent;
 }
 
-/* 悬浮选项：明显加重底色，保证「看得见、点得准」。 */
 .dropdownItem:hover {
+  color: var(--hub-text-primary);
   background: var(--hub-bg-hover);
 }
 
 .dropdownItemActive {
-  color: var(--hub-text-on-fill);
-  background: var(--hub-btn-fill);
+  color: var(--hub-brand);
+  background: var(--hub-brand-tint);
+  font-weight: 600;
 }
 
 .dropdownItemLabel {
-  min-width: 0;
-  overflow: hidden;
-  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 
 .dropdownCount,
@@ -107,7 +112,7 @@
   font-size: 10px;
   line-height: 14px;
   border-radius: 999px;
-  padding: 0 6px;
+  padding: 0 5px;
   min-width: 16px;
   text-align: center;
 }
@@ -117,7 +122,7 @@
   background: var(--hub-bg-btn);
 }
 
-.dropdownItemActive .dropdownCountActive {
+.dropdownCountActive {
   color: var(--hub-text-on-fill);
-  background: var(--hub-bg-on-fill);
+  background: var(--hub-btn-fill);
 }