dsh-plugin-pack 1.0.8 → 1.0.10

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);

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;
   }
@@ -292,8 +417,9 @@ export async function fetchBundleFrom({ source, home, onProgress = () => {} }) {
   report(`下载完成：${(data.length / 1048576).toFixed(1)} MiB`);
 
   // 落到 inbox（保留扩展名，后续按 .zip/.tgz 分流）
+  // origin='network'：安装成功后可以自动删掉这份副本，不占用户磁盘
   pruneSafe(home);
-  const saved = saveIncomingZip({ home, filename: name, data });
+  const saved = saveIncomingZip({ home, filename: name, data, origin: 'network' });
   report(`已保存到 ${saved.file}`);
 
   /* 校验阶段分两种：

package/lib/inbox.js

@@ -20,6 +20,32 @@ import { ensureDir, removeTree } from './util.js';
 /** 单次落盘上限（默认 1 GiB，够大包也够防呆）。 */
 const MAX_BYTES = 1024 * 1024 * 1024;
 
+/** 记录这份 inbox 副本来源的标记文件名。 */
+const ORIGIN_MARK = '.origin';
+
+/**
+ * 在 root 下建一个唯一的子目录：`<时间戳>-<4位随机>`。
+ *
+ * stamp() 只到秒，同一秒内多次落盘会撞名；加随机后缀既保持可读
+ * （按时间排序仍然有效），又能避免互相覆盖。
+ *
+ * @param {string} root
+ * @returns {string} 已创建的目录绝对路径
+ */
+function uniqueDir(root) {
+  for (let attempt = 0; attempt < 20; attempt += 1) {
+    const suffix = Math.random().toString(16).slice(2, 6).padEnd(4, '0');
+    const dir = path.join(root, `${stamp()}-${suffix}`);
+    if (fs.existsSync(dir)) continue;
+    ensureDir(dir);
+    return dir;
+  }
+  // 极端情况下兜底：用纳秒精度的时间戳
+  const dir = path.join(root, `${stamp()}-${Date.now() % 100000}`);
+  ensureDir(dir);
+  return dir;
+}
+
 /**
  * 从 multipart/form-data 里解析出文件条目。
  *
@@ -27,8 +53,7 @@ const MAX_BYTES = 1024 * 1024 * 1024;
  * 不引第三方库。
  *
  * @param {Buffer} body 整个请求体
- * @param {string} boundary boundary 字符串（不含前置 --）
- * @returns {Array<{ name: string, filename: string|null, data: Buffer }>}
+ * @param {string} boundary boundary 字符串（不含前置 --） * @returns {Array<{ name: string, filename: string|null, data: Buffer }>}
  */
 export function parseMultipart(body, boundary) {
   const delimiter = Buffer.from(`--${boundary}`);
@@ -87,9 +112,12 @@ export function boundaryOf(contentType) {
  * @param {string} options.home $DSH_HOME
  * @param {string} options.filename 原始文件名
  * @param {Buffer} options.data 内容
+ * @param {'upload'|'network'} [options.origin]
+ *   来源。`network` = 从 GitHub/npm 下载来的，装完可以自动删；
+ *   `upload` = 用户从本地拖/选的，装完要留着（用户自己的文件）。
  * @returns {{ file: string, bytes: number }}
  */
-export function saveIncomingZip({ home, filename, data }) {
+export function saveIncomingZip({ home, filename, data, origin = 'upload' }) {
   if (!data?.length) {
     const error = new Error('上传内容为空');
     error.code = 'BAD_UPLOAD';
@@ -101,8 +129,16 @@ export function saveIncomingZip({ home, filename, data }) {
     throw error;
   }
   const base = safeName(String(filename ?? '').trim() || `bundle-${stamp()}.zip`);
-  const dir = path.join(home, 'plugin-pack', 'inbox', stamp());
-  ensureDir(dir);
+  /* 目录名要唯一：stamp() 只到秒，同一秒内连拖两个包会落到同一个目录，
+   * 后一个会覆盖前一个的 .origin 标记（甚至同名时覆盖文件本身）。
+   * 加个短随机后缀避开。 */
+  const dir = uniqueDir(path.join(home, 'plugin-pack', 'inbox'));
+  // 记下来源：安装成功后据此决定要不要删掉这份落盘副本
+  try {
+    fs.writeFileSync(path.join(dir, ORIGIN_MARK), origin === 'network' ? 'network' : 'upload');
+  } catch {
+    /* 标记写不进去不影响导入 */
+  }
   // 保留原始扩展名：.zip = 整合包，.tgz/.tar.gz = 单个插件的 npm tarball
   const lower = base.toLowerCase();
   const hasKnownExt = lower.endsWith('.zip') || lower.endsWith('.tgz') || lower.endsWith('.tar.gz');
@@ -192,3 +228,47 @@ export function pruneInbox(home, days = 7) {
   }
   return removed;
 }
+
+/**
+ * 读这份 inbox 副本的来源。
+ *
+ * @param {string} file inbox 里的文件绝对路径
+ * @returns {'upload'|'network'|null} 读不到标记时返回 null（老版本落盘的文件）
+ */
+export function inboxOrigin(file) {
+  try {
+    const mark = path.join(path.dirname(String(file)), ORIGIN_MARK);
+    const text = fs.readFileSync(mark, 'utf8').trim();
+    return text === 'network' ? 'network' : 'upload';
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * 删掉 inbox 里的一份落盘副本（连它所在的时间戳目录一起删）。
+ *
+ * 只删 inbox 内部的目录：传进来的路径必须在 `<home>/plugin-pack/inbox` 之下，
+ * 否则直接拒绝 —— 免得哪天参数传错把用户自己的文件删了。
+ *
+ * @param {string} home $DSH_HOME
+ * @param {string} file inbox 里的文件路径
+ * @returns {boolean} 是否真的删了
+ */
+export function removeInboxEntry(home, file) {
+  try {
+    const root = path.resolve(home, 'plugin-pack', 'inbox');
+    const target = path.resolve(String(file));
+    // 必须严格在 inbox 之下，且不能就是 inbox 本身
+    if (target === root || !target.startsWith(root + path.sep)) return false;
+    const dir = path.dirname(target);
+    // 目录必须是 inbox 的直接子目录（时间戳目录），不能是更外层
+    if (path.dirname(dir) !== root) return false;
+    // 目录本身要存在，否则不算"删掉了"
+    if (!fs.existsSync(dir)) return false;
+    removeTree(dir);
+    return true;
+  } catch {
+    return false;
+  }
+}

package/lib/server.js

@@ -28,7 +28,15 @@ import { importBundle, inspectBundle, rollbackImport, listBackups } from './impo
 import { reloadClientPackage, clientStatus, localVerdict } from '../hotload.js';
 import { importLocalPlugin } from './import-plugin.js';
 import { importTarball, isTarball } from './import-tgz.js';
-import { parseMultipart, boundaryOf, saveIncomingZip, saveIncomingDir, pruneInbox } from './inbox.js';
+import {
+  parseMultipart,
+  boundaryOf,
+  saveIncomingZip,
+  saveIncomingDir,
+  pruneInbox,
+  inboxOrigin,
+  removeInboxEntry,
+} from './inbox.js';
 import { runJob, listJobs, getJob, runningJobs, clearFinished, openWaiting, getWaiting, listWaiting, cancelWaiting } from './jobs.js';
 import { fetchBundleFrom, parseSource } from './fetch-bundle.js';
 import { dshHome as resolveDshHome, profileDir as resolveProfileDir, profileName as resolveProfileName, humanBytes } from './home.js';
@@ -80,6 +88,28 @@ function sendJson(response, status, value) {
 }
 
 /** 把异常翻译成 HTTP 状态；其余仍是 500。 */
+/**
+ * 安装成功后清理 inbox 里的落盘副本。
+ *
+ * 只删「从网络下载」的那份；用户自己拖/选的本地文件永远保留 ——
+ * 那是他自己的文件，工具不该动它。
+ *
+ * @param {object} config
+ * @param {string} file 本次导入用的文件路径
+ * @returns {boolean} 是否真的删掉了
+ */
+function autoCleanInbox(config, file) {
+  try {
+    if (!file) return false;
+    const home = contextOf(config).home;
+    // 只有网络下载的来源才删
+    if (inboxOrigin(file) !== 'network') return false;
+    return removeInboxEntry(home, file);
+  } catch {
+    return false;
+  }
+}
+
 function statusOf(error) {
   const explicit = Number(error?.status ?? error?.statusCode);
   if (Number.isFinite(explicit) && explicit >= 400 && explicit < 600) return explicit;
@@ -423,7 +453,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) } : {}),
+                });
               }
             },
           },
@@ -584,7 +620,9 @@ export function mountRoutes(ctx, config = {}) {
                 meta: { file: body.file },
                 task: (report) => doImport(report),
               });
-              sendJson(response, 200, { ...result, jobId: id });
+              // 网络下载来的 tgz，装完同样清掉副本
+              const cleanedTgz = autoCleanInbox(config, body.file);
+              sendJson(response, 200, { ...result, jobId: id, ...(cleanedTgz ? { inboxCleaned: true } : {}) });
               return;
             }
             const dryRun = Boolean(body.dryRun);
@@ -635,7 +673,11 @@ export function mountRoutes(ctx, config = {}) {
               jobId: body.jobId ? String(body.jobId) : undefined,
               task: (report) => doImportBundle(report),
             });
-            sendJson(response, 200, { ...result, jobId: id });
+            /* 装完清掉网络下载的副本：
+             * 从 GitHub/npm 下下来的包，装好后原件就没用了，留着白占磁盘。
+             * 但用户自己拖/选的本地文件（origin='upload'）一律保留 —— 那是他的东西。 */
+            const cleaned = autoCleanInbox(config, body.file);
+            sendJson(response, 200, { ...result, jobId: id, ...(cleaned ? { inboxCleaned: true } : {}) });
           },
         },
         'plugin-pack: import',

package/package.json

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