dsh-plugin-pack 1.0.7 → 1.0.9

package/client.js

@@ -130,6 +130,7 @@ window.__ModuleLoader__.load({ id: 'dsh-plugin-pack', factory: (require) => {
     'net.warnTitle': '安装前请确认来源可信',
     'net.warnBody': '整合包会覆盖已装插件的文件与配置，来源不明的包可能损坏 DeepSeek Harness。安装前会先列出重名插件，由你逐个决定覆盖还是跳过。',
     'net.done': '下载完成，已导入',
+    'net.hintTitle': '可以这样处理：',
     'import.pageTitle': '导入插件整合包',
     'drop.title': '把 zip / tgz 或插件文件夹拖到这里',
     'drop.release': '松手就导入',
@@ -312,6 +313,7 @@ window.__ModuleLoader__.load({ id: 'dsh-plugin-pack', factory: (require) => {
     'net.warnTitle': 'Verify the source before installing',
     'net.warnBody': 'A bundle overwrites installed plugins and their config. Untrusted sources can damage DeepSeek Harness. You will be asked per-plugin whether to overwrite or skip.',
     'net.done': 'Downloaded and imported',
+    'net.hintTitle': 'What you can do: ',
     'import.pageTitle': 'Import plugin bundle',
     'drop.title': 'Drop a zip / tgz or plugin folder here',
     'drop.release': 'Release to import',
@@ -504,6 +506,8 @@ window.__ModuleLoader__.load({ id: 'dsh-plugin-pack', factory: (require) => {
         const error = new Error((data && (data.error || data.message)) || `${response.status} ${response.statusText}`);
         // 把服务端的错误码带出来 —— 界面据此区分"拖错文件"和"真出故障"
         if (data?.code) error.code = String(data.code);
+        // 网络类错误带处置建议（挂代理 / 换网络 / 稍后重试）
+        if (data?.hint) error.hint = String(data.hint);
         throw error;
       }
       return data;
@@ -1459,7 +1463,7 @@ window.__ModuleLoader__.load({ id: 'dsh-plugin-pack', factory: (require) => {
           h('div', null, t('net.warnBody')),
         ),
 
-        // 结果区：成功 / 不是整合包 / 其它错误
+        // 结果区：成功 / 不是整合包 / 网络失败（带处置建议）/ 其它错误
         result
           ? h(
               'div',
@@ -1472,7 +1476,29 @@ window.__ModuleLoader__.load({ id: 'dsh-plugin-pack', factory: (require) => {
                       h('div', { className: 'pp-not-bundle-title' }, t('net.notBundle')),
                       h('div', { className: 'pp-not-bundle-detail' }, String(result.error)),
                     )
-                  : h(Alert, { kind: 'err' }, String(result.error))
+                  : h(
+                      'div',
+                      null,
+                      h(Alert, { kind: 'err' }, String(result.error)),
+                      // 网络类错误：把"该怎么做"单独列出来，别让用户卡在报错上
+                      result.hint
+                        ? h(
+                            'div',
+                            {
+                              className: 'pp-hint',
+                              style: {
+                                marginTop: 6,
+                                padding: '8px 10px',
+                                borderRadius: 8,
+                                background: 'color-mix(in srgb,var(--dsw-alias-label-secondary,#6b7280) 8%,transparent)',
+                                lineHeight: 1.7,
+                              },
+                            },
+                            h('b', null, t('net.hintTitle')),
+                            String(result.hint),
+                          )
+                        : null,
+                    )
                 : h(
                     'div',
                     { className: 'pp-hint' },
@@ -2196,7 +2222,7 @@ window.__ModuleLoader__.load({ id: 'dsh-plugin-pack', factory: (require) => {
         await refreshJobs();
       } catch (err) {
         const code = err?.code ? String(err.code) : null;
-        setNetResult({ error: String(err?.message ?? err), code });
+        setNetResult({ error: String(err?.message ?? err), code, hint: err?.hint ?? null });
       } finally {
         setPhase('');
         setBusy(false);
@@ -2325,6 +2351,25 @@ window.__ModuleLoader__.load({ id: 'dsh-plugin-pack', factory: (require) => {
           hotBusy ? h(Spinner, { label: t('hotload.running') }) : t('hotload'),
         ),
         h('button', { className: 'pp-btn sm', disabled: busy, onClick: load }, busy ? h(Spinner, { label: t('loading') }) : t('refresh')),
+        /* 「添加整合包」放在这一行最右，对齐 DSH 自带的「添加插件」位置
+         * （页面标题行右上角），而不是沉到「导入插件整合包」小标题旁边。
+         * 只在导入页出现，其它子页不占位。 */
+        onlyTab === 'import' || tab === 'import'
+          ? h(
+              'button',
+              {
+                className: 'pp-btn sm',
+                style: { display: 'inline-flex', alignItems: 'center', gap: 5 },
+                disabled: busy,
+                onClick: () => {
+                  setNetResult(null);
+                  setNetOpen(true);
+                },
+              },
+              h('span', { style: { fontSize: 14, lineHeight: 1 } }, '＋'),
+              t('net.button'),
+            )
+          : null,
       ),
       error ? h(Alert, { kind: 'err' }, `${t('failed')}: ${error}`) : null,
       hotResult
@@ -2550,35 +2595,6 @@ window.__ModuleLoader__.load({ id: 'dsh-plugin-pack', factory: (require) => {
     const importPage = h(
       'div',
       null,
-      /* 右上角「添加整合包」按钮 —— 和 DSH 自带的「添加插件」同位置同风格。
-       * 点开是一个弹窗，在里面填地址、点安装。 */
-      h(
-        'div',
-        {
-          style: {
-            display: 'flex',
-            alignItems: 'center',
-            justifyContent: 'space-between',
-            gap: 12,
-            marginBottom: 12,
-          },
-        },
-        h('div', { style: { fontSize: 14, fontWeight: 600 } }, t('import.pageTitle')),
-        h(
-          'button',
-          {
-            className: 'pp-btn',
-            style: { display: 'inline-flex', alignItems: 'center', gap: 6, flex: 'none' },
-            onClick: () => {
-              setNetResult(null);
-              setNetOpen(true);
-            },
-          },
-          h('span', { style: { fontSize: 15, lineHeight: 1 } }, '＋'),
-          t('net.button'),
-        ),
-      ),
-
       h(DropZone, { onFile: runDrop, busy, dropRef: lastDrop, phase }),
 
       // 后台任务：切走画面回来能看到刚才那次导入的结果

package/lib/fetch-bundle.js

@@ -128,10 +128,15 @@ async function resolveReleaseAsset({ owner, repo, tag }) {
       ? `${apiBase}/repos/${owner}/${repo}/releases/latest`
       : `${apiBase}/repos/${owner}/${repo}/releases/tags/${encodeURIComponent(tag)}`;
 
-  const response = await fetchWithTimeout(endpoint, {
-    headers: { Accept: 'application/vnd.github+json', 'User-Agent': 'dsh-plugin-pack' },
-    timeoutMs: 30000,
-  });
+  let response;
+  try {
+    response = await fetchWithTimeout(endpoint, {
+      headers: { Accept: 'application/vnd.github+json', 'User-Agent': 'dsh-plugin-pack' },
+      timeoutMs: 30000,
+    });
+  } catch (error) {
+    throw explainNetworkError(error, endpoint, '查 GitHub Release');
+  }
   if (!response.ok) {
     const error = new Error(
       `查 GitHub Release 失败（${response.status}）。这个仓库可能没有 Release，或者 tag「${tag}」不存在。`,
@@ -185,10 +190,15 @@ async function resolveNpmTarball(spec) {
   const wantedVersion = hasVersion ? spec.slice(at + 1) : null;
 
   const endpoint = `https://registry.npmjs.org/${pkgName.replace(/\//g, '%2F')}`;
-  const response = await fetchWithTimeout(endpoint, {
-    headers: { Accept: 'application/json', 'User-Agent': 'dsh-plugin-pack' },
-    timeoutMs: 30000,
-  });
+  let response;
+  try {
+    response = await fetchWithTimeout(endpoint, {
+      headers: { Accept: 'application/json', 'User-Agent': 'dsh-plugin-pack' },
+      timeoutMs: 30000,
+    });
+  } catch (error) {
+    throw explainNetworkError(error, endpoint, '查 npm 包');
+  }
   if (!response.ok) {
     const error = new Error(`查 npm 包失败（${response.status}）：${pkgName}`);
     error.code = 'BAD_SOURCE';
@@ -211,32 +221,147 @@ async function resolveNpmTarball(spec) {
   return { url, name: `${data.name}-${version}.tgz`, from: 'npm' };
 }
 
+/**
+ * 把底层网络错误翻译成看得懂、能动手的中文。
+ *
+ * 为什么需要：Node 的 fetch 在网络不通时只抛 `TypeError: fetch failed`，
+ * 真正的原因藏在 error.cause 里（ENOTFOUND / ECONNRESET / 证书错误…）。
+ * 直接抛出去用户只看到"fetch failed"，不知道是网断了、域名错了，
+ * 还是被墙了、要挂代理。
+ *
+ * @param {unknown} error 原始错误
+ * @param {string} url 正在访问的地址
+ * @param {string} [stage] 阶段描述（下载 / 查 registry / 查 Release）
+ * @returns {Error & { code: string, hint?: string }}
+ */
+export function explainNetworkError(error, url, stage = '下载') {
+  let host = '';
+  try {
+    host = new URL(url).host;
+  } catch {
+    host = url;
+  }
+
+  // 把 cause 链上的信息拼起来判断（message + code + errno）
+  const cause = error?.cause ?? error;
+  const raw = [cause?.code, cause?.errno, cause?.message, error?.message]
+    .filter(Boolean)
+    .join(' ')
+    .toLowerCase();
+
+  const make = (message, hint) => {
+    const wrapped = new Error(message);
+    wrapped.code = 'NETWORK';
+    if (hint) wrapped.hint = hint;
+    return wrapped;
+  };
+
+  // 超时（我们自己 abort 的）
+  if (error?.name === 'AbortError' || /aborted|timeout|timed out|etimedout|und_err_connect_timeout/.test(raw)) {
+    return make(
+      `${stage}超时：${host} 在限定时间内没有响应。`,
+      '网络慢或被劫持时常见。可以稍后重试；如果一直超时，试试换网络或配代理。',
+    );
+  }
+
+  // DNS：域名解析不出来
+  if (/enotfound|eai_again|getaddrinfo|dns/.test(raw)) {
+    return make(
+      `${stage}失败：解析不了域名 ${host}。`,
+      '检查地址有没有拼错；如果域名是对的，通常是 DNS 问题或该域名被污染。',
+    );
+  }
+
+  // 连接被重置 / 主动断开：国内访问 GitHub 最常见
+  if (/econnreset|socket hang up|epipe|ecanceled/.test(raw)) {
+    return make(
+      `${stage}失败：与 ${host} 的连接被重置。`,
+      host.includes('github')
+        ? 'GitHub 在国内经常被这样重置。挂代理后重试，或者把包下载到本地，用拖拽导入。'
+        : '连接中途断开。检查网络稳定性后重试。',
+    );
+  }
+
+  // 连不上（端口不通 / 代理没起）
+  if (/econnrefused|ehostunreach|enetunreach|connect failed/.test(raw)) {
+    return make(
+      `${stage}失败：连不上 ${host}。`,
+      '目标拒绝连接，或者你的代理设置指向了一个没在运行的端口。',
+    );
+  }
+
+  // 证书问题
+  if (/cert|self.signed|unable to verify|ssl|tls/.test(raw)) {
+    return make(
+      `${stage}失败：${host} 的 HTTPS 证书校验不通过。`,
+      '可能是公司网络中间人代理或系统时间不对。确认来源可信后再决定是否继续。',
+    );
+  }
+
+  // 代理相关
+  if (/proxy/.test(raw)) {
+    return make(
+      `${stage}失败：代理连接出错（访问 ${host}）。`,
+      '检查 HTTP_PROXY / HTTPS_PROXY 环境变量或系统代理设置。',
+    );
+  }
+
+  // 兜底：把真实原因也带上，别吞掉
+  const detail = String(cause?.message ?? error?.message ?? error).slice(0, 160);
+  return make(
+    `${stage}失败：访问 ${host} 时网络出错。`,
+    `原始信息：${detail}`,
+  );
+}
+
 /** 从 URL 流式下载到 Buffer（带体积上限）。 */
 async function download(url) {
-  const response = await fetchWithTimeout(url, {
-    headers: { 'User-Agent': 'dsh-plugin-pack', Accept: '*/*' },
-  });
+  let response;
+  try {
+    response = await fetchWithTimeout(url, {
+      headers: { 'User-Agent': 'dsh-plugin-pack', Accept: '*/*' },
+    });
+  } catch (error) {
+    // 连都没连上 —— 翻译成人话再抛
+    throw explainNetworkError(error, url, '下载');
+  }
+
   if (!response.ok) {
-    const error = new Error(
-      `下载失败（HTTP ${response.status}）。地址可能失效、需要登录，或者是私有仓库。`,
-    );
+    // 按状态码给不同的处置建议，而不是一句"下载失败"
+    const hints = {
+      401: '需要登录才能下载（私有仓库）。',
+      403: '服务器拒绝访问。可能是私有仓库、触发限流，或者需要认证。',
+      404: '地址不存在。检查链接是否失效、仓库是否改名、Release 是否被删。',
+      429: '请求太频繁被限流，等几分钟再试。',
+    };
+    const base = `下载失败（HTTP ${response.status}）。`;
+    const error = new Error(base + (hints[response.status] ?? '服务器返回了错误状态。'));
     error.code = 'DOWNLOAD_FAILED';
     throw error;
   }
 
   const chunks = [];
   let size = 0;
-  for await (const chunk of response.body) {
-    size += chunk.length;
-    if (size > MAX_BYTES) {
-      const error = new Error(`文件超过 ${MAX_BYTES / 1048576} MiB，已中止`);
-      error.code = 'TOO_LARGE';
-      throw error;
+  try {
+    for await (const chunk of response.body) {
+      size += chunk.length;
+      if (size > MAX_BYTES) {
+        const error = new Error(`文件超过 ${MAX_BYTES / 1048576} MiB，已中止`);
+        error.code = 'TOO_LARGE';
+        throw error;
+      }
+      chunks.push(Buffer.from(chunk));
     }
-    chunks.push(Buffer.from(chunk));
+  } catch (error) {
+    // 下到一半断了（大文件走代理时很常见）
+    if (error?.code === 'TOO_LARGE') throw error;
+    const wrapped = explainNetworkError(error, url, '下载');
+    wrapped.message = `${wrapped.message}（已收到 ${(size / 1048576).toFixed(1)} MiB，可能没下完）`;
+    throw wrapped;
   }
+
   if (!size) {
-    const error = new Error('下载到的是空文件');
+    const error = new Error('下载到的是空文件（地址可能指向了一个空响应）。');
     error.code = 'DOWNLOAD_FAILED';
     throw error;
   }

package/lib/server.js

@@ -423,7 +423,13 @@ export function mountRoutes(ctx, config = {}) {
               try {
                 return await spec.handler(request, response);
               } catch (error) {
-                sendJson(response, statusOf(error), { ok: false, error: String(error?.message ?? error), code: error?.code });
+                sendJson(response, statusOf(error), {
+                  ok: false,
+                  error: String(error?.message ?? error),
+                  code: error?.code,
+                  // 网络类错误带处置建议，界面会显示在错误下面
+                  ...(error?.hint ? { hint: String(error.hint) } : {}),
+                });
               }
             },
           },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-pack",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "description": "DeepSeek Harness 插件整合包：一键把当前 profile 的第三方插件连依赖和配置导出成 zip（内部每个插件是标准 npm tgz），换机/换 profile 拖进去就能还原。",
   "type": "module",
   "main": "lib/index.js",