baiduwangpan-cli 1.1.3 → 1.6.0

package/lib/config.js

@@ -7,6 +7,9 @@ const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
 
 const PCS_BINARY_NAMES = ["BaiduPCS-Go.exe", "BaiduPCS-Go"];
 
+// 认证相关字段：profile 只覆盖这些字段，pcsPath/ua/maxBytes 保持全局
+const AUTH_KEYS = ["bduss", "stoken", "cookie", "webTransport", "browserProfile", "browserPort"];
+
 function load() {
   try {
     const raw = fs.readFileSync(CONFIG_FILE, "utf-8");
@@ -66,17 +69,25 @@ function findPCS() {
 
 function get() {
   const fileCfg = load();
+  const profile = profileOf(fileCfg);
+  const src = { ...fileCfg };
+  if (profile) {
+    // profile 只覆盖认证相关字段；pcsPath/ua/maxBytes 保持全局
+    for (const key of AUTH_KEYS) {
+      if (key in profile) src[key] = profile[key];
+    }
+  }
   return {
-    bduss: fileCfg.bduss || process.env.BDP_BDUSS || "",
-    stoken: fileCfg.stoken || process.env.BDP_STOKEN || "",
-    cookie: fileCfg.cookie || process.env.BDP_COOKIE || "",
-    webTransport: fileCfg.webTransport || "curl",
-    browserProfile: fileCfg.browserProfile || "",
-    browserPort: parseInt(fileCfg.browserPort || "0", 10) || 0,
-    pcsPath: resolvePcsPath(fileCfg),
-    ua: fileCfg.ua || process.env.NETDISK_UA ||
+    bduss: src.bduss || process.env.BDP_BDUSS || "",
+    stoken: src.stoken || process.env.BDP_STOKEN || "",
+    cookie: src.cookie || process.env.BDP_COOKIE || "",
+    webTransport: src.webTransport || "curl",
+    browserProfile: src.browserProfile || "",
+    browserPort: parseInt(src.browserPort || "0", 10) || 0,
+    pcsPath: resolvePcsPath(src),
+    ua: src.ua || process.env.NETDISK_UA ||
       "netdisk;P2SP;3.0.0.8;netdisk;11.12.3;ANG-AN00;android-android;10.0;JSbridge4.4.0;jointBridge;1.1.0;",
-    maxBytes: parseInt(fileCfg.maxBytes || process.env.BDP_MAX_CAT_BYTES || "1048576", 10),
+    maxBytes: parseInt(src.maxBytes || process.env.BDP_MAX_CAT_BYTES || "1048576", 10),
   };
 }
 
@@ -108,7 +119,18 @@ function update(values) {
 
 function setAuth(values) {
   const cfg = load();
-  for (const key of ["bduss", "stoken", "cookie", "webTransport", "browserProfile", "browserPort"]) {
+  const name = activeProfileName(cfg);
+  const prof = profileOf(cfg);
+  if (name && prof) {
+    // 激活 profile：只重写该 profile 的认证字段，全局字段与其他 profile 不受影响
+    const merged = { ...prof };
+    for (const key of AUTH_KEYS) delete merged[key];
+    cfg.profiles[name] = { ...merged, ...values };
+    save(cfg);
+    return;
+  }
+  // 无激活 profile：保持原语义，认证字段写在全局
+  for (const key of AUTH_KEYS) {
     delete cfg[key];
   }
   // setAuth 只替换认证相关字段，保留 pcsPath/ua/maxBytes 等自定义配置（升级不丢 pcsPath）
@@ -120,4 +142,72 @@ function isLoggedIn() {
   return !!(cfg.bduss && cfg.stoken);
 }
 
-module.exports = { get, set, update, setAuth, load, save, isLoggedIn, findPCS, findPCSInDir, resolvePcsPath, CONFIG_DIR, CONFIG_FILE };
+// ---------- profile（多账号）----------
+// 存储：config.json 内 "profiles": { "<name>": { 认证字段覆盖 } } + "activeProfile": "<name>"。
+// 无 activeProfile 时一切行为与单账号完全一致（向后兼容）。
+
+function activeProfileName(fileCfg = null) {
+  const cfg = fileCfg || load();
+  const name = cfg.activeProfile;
+  return typeof name === "string" && name !== "" ? name : null;
+}
+
+// 返回激活 profile 的对象；activeProfile 未设置或对应条目缺失/畸形时返回 null
+function profileOf(fileCfg) {
+  const name = activeProfileName(fileCfg);
+  if (!name) return null;
+  const profiles = fileCfg.profiles;
+  if (!profiles || typeof profiles !== "object" || Array.isArray(profiles)) return null;
+  const p = profiles[name];
+  if (!p || typeof p !== "object" || Array.isArray(p)) return null;
+  return p;
+}
+
+// 切换当前 profile 并持久化；name 为空串/null/undefined 表示切回全局（等价 unsetProfile()）
+function useProfile(name) {
+  if (name === undefined || name === null) return unsetProfile();
+  const n = String(name).trim();
+  if (n === "") return unsetProfile();
+  const cfg = load();
+  if (!cfg.profiles || typeof cfg.profiles !== "object" || Array.isArray(cfg.profiles)) {
+    cfg.profiles = {};
+  }
+  const existing = cfg.profiles[n];
+  if (!existing || typeof existing !== "object" || Array.isArray(existing)) {
+    cfg.profiles[n] = {}; // name 不存在时建空 profile
+  }
+  cfg.activeProfile = n;
+  save(cfg);
+  return n;
+}
+
+// 切回全局：删除 activeProfile；未激活时不做任何写操作
+function unsetProfile() {
+  const cfg = load();
+  if (!("activeProfile" in cfg)) return null;
+  delete cfg.activeProfile;
+  save(cfg);
+  return null;
+}
+
+// 当前 profile 名（无 → null）
+function getProfile() {
+  return activeProfileName();
+}
+
+// [{ name, bduss? }]，按配置文件中的存储顺序
+function listProfiles() {
+  const cfg = load();
+  const profiles = cfg.profiles;
+  if (!profiles || typeof profiles !== "object" || Array.isArray(profiles)) return [];
+  const out = [];
+  for (const [name, p] of Object.entries(profiles)) {
+    if (!p || typeof p !== "object" || Array.isArray(p)) continue;
+    const entry = { name };
+    if (p.bduss) entry.bduss = p.bduss;
+    out.push(entry);
+  }
+  return out;
+}
+
+module.exports = { get, set, update, setAuth, load, save, isLoggedIn, useProfile, unsetProfile, getProfile, listProfiles, findPCS, findPCSInDir, resolvePcsPath, CONFIG_DIR, CONFIG_FILE };

package/lib/console.js

@@ -0,0 +1,99 @@
+"use strict";
+
+/**
+ * 控制台编码工具
+ *
+ * 背景: 在中文 Windows (zh-CN) 上, 控制台默认代码页为 cp936 (GBK),
+ * 而 Node 的 stdout 始终输出 UTF-8 字节, 导致 `bdp` 的中文输出在
+ * PowerShell / cmd 中显示乱码 (如 "测试中文输出" 显示为 "娴嬭瘯涓枃杈撳嚭")。
+ *
+ * 修复思路: 检测当前代码页, 若不是 65001 (UTF-8) 且标准输出是终端,
+ * 则通过 `cmd /c chcp 65001` 切换代码页, 使控制台按 UTF-8 解释输出。
+ */
+
+const { spawnSync, execSync } = require("node:child_process");
+
+/**
+ * 解析 `cmd /c chcp` 的输出, 提取代码页数字。
+ *
+ * 注意: chcp 输出的语言随当前代码页变化 ——
+ *   代码页为 936 时: "活动代码页: 936" (GBK 编码, 中文标签)
+ *   代码页为 65001 时: "Active code page: 65001" (英文标签)
+ * 因此同时兼容中英文两种格式。
+ *
+ * @param {string} output `cmd /c chcp` 的原始输出
+ * @returns {number|null} 代码页数字; 空串或无法解析时返回 null
+ */
+function parseChcp(output) {
+  if (typeof output !== "string" || output.trim() === "") return null;
+  // 兼容 "Active code page: 936" 与 "活动代码页: 936" 两种格式
+  const m = output.match(/(?:code\s*page|代码页)\s*[:：]?\s*(\d+)/i);
+  if (!m) return null;
+  const n = Number(m[1]);
+  return Number.isInteger(n) && n > 0 ? n : null;
+}
+
+/**
+ * 从 `cmd /c chcp` 的原始输出 Buffer 中解析代码页数字。
+ * 无论输出是 UTF-8 还是 GBK 编码, 数字本身都是 ASCII, 因此兼容两种场景:
+ *   1) 按 UTF-8 解码解析;
+ *   2) 失败则按 GBK 解码 (TextDecoder, 依赖 ICU; 无 ICU 时静默跳过);
+ *   3) 兜底: 直接从原始字节中提取数字 (任何编码下数字均为 ASCII)。
+ *
+ * @param {Buffer} buf chcp 输出的原始字节
+ * @returns {number|null} 代码页数字; 解析失败返回 null
+ */
+function resolveChcpNumber(buf) {
+  let cp = parseChcp(buf.toString("utf8"));
+  if (cp !== null) return cp;
+  try {
+    cp = parseChcp(new TextDecoder("gbk").decode(buf));
+  } catch {
+    /* 构建无 GBK 解码器时跳过 */
+  }
+  if (cp !== null) return cp;
+  const m = buf.toString("latin1").match(/(\d{3,5})/);
+  return m ? Number(m[1]) : null;
+}
+
+/**
+ * 确保 Windows 控制台使用 UTF-8 代码页, 避免中文乱码。
+ *
+ * 仅在同时满足以下条件时才尝试切换:
+ *   - process.platform === "win32" (其他平台无此问题)
+ *   - process.stdout.isTTY (标准输出是终端; 重定向/管道场景不处理)
+ *   - 当前代码页不是 65001 (已是 UTF-8 则跳过)
+ *
+ * 切换失败时静默忽略, 不抛异常; 幂等, 可安全重复调用。
+ */
+function ensureUtf8Console() {
+  if (process.platform !== "win32" || !process.stdout.isTTY) return;
+
+  // 1. 查询当前代码页 (spawnSync 返回原始 Buffer, 不经过控制台解码)
+  let current = null;
+  try {
+    const r = spawnSync("cmd", ["/c", "chcp"], {
+      encoding: "buffer",
+      windowsHide: true,
+    });
+    if (r.status !== 0 || !r.stdout || r.stdout.length === 0) return;
+    current = resolveChcpNumber(r.stdout);
+  } catch {
+    return;
+  }
+
+  // 2. 已是最新代码页或无法解析, 无需处理
+  if (current === null || current === 65001) return;
+
+  // 3. 切换代码页。
+  //    注意: 不能用 windowsHide —— 隐藏窗口的子进程会被分配独立的隐藏控制台,
+  //    其中的 chcp 只改那个隐藏控制台的代码页, 对用户所在控制台无效 (已实测)。
+  //    失败静默 (例如控制台被其它程序独占)。
+  try {
+    execSync("cmd /c chcp 65001 >nul", { stdio: "ignore" });
+  } catch {
+    /* 静默失败 */
+  }
+}
+
+module.exports = { parseChcp, ensureUtf8Console };

package/lib/group.js

@@ -4,6 +4,7 @@ const fs = require("fs");
 const path = require("path");
 const os = require("os");
 const crypto = require("crypto");
+const { matchesName: matchName } = require("./name-match");
 
 // ── 常量（逆向实测结论）────────────────────────────────
 const MAX_PAGE_SIZE = 100;         // shareinfo 服务端每页硬上限（num>100 不返回更多）
@@ -88,7 +89,7 @@ class ShareApiError extends Error {
 // errno=2131 的详细说明（bdp error 2131 与 gls 报错共用）
 function describeErrno2131(gidS, msgIdS) {
   return (
-    `shareinfo rejected: msg_id ${msgIdS} 不属于群 ${gidS} 的任何分享 (errno=2131)。` +
+    `shareinfo 请求被拒: msg_id ${msgIdS} 不属于群 ${gidS} 的任何分享（errno=2131）。` +
     `群分享参数必须同源：gid 与 --from-uk/--msg-id/--parent-fs-id 应来自同一次 gshares/gsearch 结果。` +
     `处理：运行 bdp gshares ${gidS} 查看本群分享（或 bdp gsearch ${gidS} <关键词>），` +
     `取其中一行的 fsId/fromUk/msgId 重试；fsId 为子目录时保持同一行的 fromUk/msgId。`
@@ -107,13 +108,13 @@ function isSelfEcho(data, fsIdS) {
 
 async function listGroups() {
   const bdstoken = await getBdstoken();
-  if (!bdstoken) throw new Error("Cannot get bdstoken — check BDUSS/STOKEN config");
+  if (!bdstoken) throw new Error("无法获取 bdstoken — 请检查 BDUSS/STOKEN 配置（或重新执行 bdp login）");
 
   const data = await http.webJson(
     `${http.PAN_BASE}/mbox/group/list?clienttype=0&app_id=${http.APP_ID}&web=1&bdstoken=${bdstoken}`
   );
 
-  if (data.errno !== 0) throw new Error(`API error: errno=${data.errno}`);
+  if (data.errno !== 0) throw new Error(`API 返回错误: errno=${data.errno}（可运行 bdp error ${data.errno} 查看含义）`);
 
   return (data.records || []).map((g) => ({
     gid: toStr(g.gid),
@@ -151,7 +152,7 @@ async function listShares(gid, options = {}) {
       `&limit=50&desc=1${cursor ? `&last_msg_time=${cursor}` : ""}&bdstoken=${bdstoken}`;
     const data = await http.webJson(url, { method: "POST", body: "" });
 
-    if (data.errno !== 0) throw new Error(`API error: errno=${data.errno}`);
+    if (data.errno !== 0) throw new Error(`API 返回错误: errno=${data.errno}（可运行 bdp error ${data.errno} 查看含义）`);
 
     let added = 0;
     for (const msg of data.records?.msg_list || []) {
@@ -211,10 +212,10 @@ async function shareInfoRaw(gidS, fsIdS, fromUkS, msgIdS, page, pageSize) {
   const data = await http.webJson(url, { method: "POST", body: "" });
 
   if (data.errno !== 0) {
-    throw new ShareApiError(data.errno, `API error: errno=${data.errno}`);
+    throw new ShareApiError(data.errno, `API 返回错误: errno=${data.errno}（可运行 bdp error ${data.errno} 查看含义）`);
   }
   if (isSelfEcho(data, fsIdS)) {
-    const e = new ShareApiError(-3, `shareinfo throttled (self-echo) for fs_id ${fsIdS}`);
+    const e = new ShareApiError(-3, `shareinfo 被限流（self-echo）: fs_id ${fsIdS}`);
     e.throttled = true;
     throw e;
   }
@@ -228,7 +229,7 @@ async function shareInfoRaw(gidS, fsIdS, fromUkS, msgIdS, page, pageSize) {
 // budget 为整条命令的请求预算，耗尽后拒绝新请求（防深扫失控）。
 async function shareInfoRawWithRetry(gidS, fsIdS, fromUkS, msgIdS, page, pageSize, budget, throttleState) {
   if (budget) {
-    if (budget.remaining <= 0) throw new ShareApiError(-3, "shareinfo request budget exhausted");
+    if (budget.remaining <= 0) throw new ShareApiError(-3, "shareinfo 请求预算已耗尽，请增大 --max-requests 或稍后重跑");
     budget.remaining--;
   }
   let attempts = 0;
@@ -317,8 +318,8 @@ async function listFiles(gid, fsId, options = {}) {
     const match = shares.find((s) => s.fsId === fsIdS);
     if (!match) {
       throw new Error(
-        `Cannot determine fromUk/msgId for fsId ${fsIdS} (not a top-level share). ` +
-        `Pass --from-uk and --msg-id explicitly.`
+        `无法确定 fsId ${fsIdS}（不是顶层分享）。` +
+        `请显式传入 --from-uk 与 --msg-id。`
       );
     }
     fromUkS = match.fromUk;
@@ -394,8 +395,8 @@ async function listFiles(gid, fsId, options = {}) {
     } catch (e) {
       throw new ShareApiError(
         -3,
-        `shareinfo rejected for fsId ${fsIdS} (errno=-3), and parent fallback also failed. ` +
-        `The share may be expired or the directory may be too large for the API.`
+        `shareinfo 请求被拒: fsId ${fsIdS}（errno=-3），且回退父目录也失败。` +
+        `分享可能已过期，或目录过大超出接口限制。`
       );
     }
   }
@@ -437,12 +438,192 @@ async function listFiles(gid, fsId, options = {}) {
 
   throw new ShareApiError(
     -3,
-    `shareinfo rejected for fsId ${fsIdS} (errno=-3). ` +
+    `shareinfo 请求被拒: fsId ${fsIdS}（errno=-3）。` +
     `群分享 API 拒绝请求：已观察到大目录、错误的 msgId/fromUk、过期分享、请求过于频繁都可能触发。` +
     `请减小 --page-size，稍后重试，或携带 gsearch 返回的 fromUk/msgId/parentFsId 信息重试。`
   );
 }
 
+// ── 群文件下载 (gdownload) ─────────────────────────────
+//
+// 逆向结论（2026-08-12）：
+//   - /mbox/msg/transfer 转存已被百度拒绝（非空目录一律 errno=-10，UI 已移除保存按钮）
+//   - 新版 IM 前端的下载链路是 POST /api/sharedownload?sign=&timestamp=
+//     （sign/timestamp 留空即可），product=mbox 参数族，登录态直接返回可下载的 dlink
+//   - dlink 有 8 小时有效期；只支持单文件（目录 fs_id 返回的 dlink 为空）
+
+// 解析 fs_id 的来源（fromUk/msgId）：显式优先；顶层分享自动解析；否则报错提示
+// 复用逻辑与 listFiles 一致，保证 gdownload 与 gls/gsearch 参数同源
+async function resolveShareSource(gidS, fsIdS, options = {}, { cache }) {
+  let fromUkS = toStr(options.fromUk || "");
+  let msgIdS = toStr(options.msgId || "");
+  if (!fromUkS || !msgIdS) {
+    const shares = await listShares(gidS, { cache });
+    const match = shares.find((s) => s.fsId === fsIdS);
+    if (!match) {
+      throw new Error(
+        `无法确定 fsId ${fsIdS}（不是顶层分享）。` +
+        `请显式传入 --from-uk 与 --msg-id（可用 bdp gsearch <gid> <关键词> --json 获取）。`
+      );
+    }
+    fromUkS = match.fromUk;
+    msgIdS = match.msgId;
+  }
+  return { fromUk: fromUkS, msgId: msgIdS };
+}
+
+// 获取群文件直链。返回 { dlink, name, size, isDir, md5, path, fsId, fromUk, msgId }
+async function getShareDlink(gid, fsId, options = {}) {
+  const gidS = toStr(gid);
+  const fsIdS = toStr(fsId);
+  const cache = options.cache === true;
+
+  const { fromUk, msgId } = await resolveShareSource(gidS, fsIdS, options, { cache });
+  const bdstoken = await getBdstoken();
+  const url = `${http.PAN_BASE}/api/sharedownload?sign=&timestamp=&clienttype=0&app_id=${http.APP_ID}&web=1&bdstoken=${bdstoken}`;
+  const body = new URLSearchParams({
+    uk: fromUk,
+    product: "mbox",
+    encrypt: "0",
+    primaryid: msgId,
+    fid_list: JSON.stringify([fsIdS]),
+    extra: JSON.stringify({ type: "group", gid: gidS }),
+  }).toString();
+
+  const data = await http.webJson(url, { method: "POST", body });
+  if (data.errno !== 0) {
+    throw new Error(`API 返回错误: errno=${data.errno}（msg_id ${msgId} 不属于群 ${gidS}，或分享已失效）`);
+  }
+  const item = (data.list || [])[0];
+  if (!item) throw new Error(`未能获取 fsId ${fsIdS} 的文件信息`);
+
+  const result = {
+    dlink: item.dlink || "",
+    name: item.server_filename || "",
+    size: parseInt(item.size || "0", 10),
+    isDir: item.isdir === 1 || item.isdir === "1",
+    md5: item.md5 || "",
+    path: safeDecode(item.path || ""),
+    fsId: toStr(item.fs_id),
+    fromUk,
+    msgId,
+  };
+  // 目录的 dlink 为无效串（实测 "&clienttype=0"），先于 dlink 判空检查
+  if (result.isDir) {
+    throw new Error(
+      `fsId ${fsIdS} 是目录（${result.name}）。sharedownload 只支持单文件下载。` +
+      `请用 bdp gls <gid> <fs_id> 或 bdp gsearch <gid> <关键词> 找到具体文件后下载。`
+    );
+  }
+  if (!result.dlink) {
+    throw new Error(`未能获取 fsId ${fsIdS} 的下载链接（分享可能已失效，或分享者禁止下载）`);
+  }
+  return result;
+}
+
+// 下载群文件到本地。options: { outDir, filename, fromUk, msgId, ua }
+// 返回 { path, name, size, dlink, fromUk, msgId }
+async function downloadFile(gid, fsId, options = {}) {
+  const info = await getShareDlink(gid, fsId, options);
+  const { spawnSync } = require("child_process");
+  const fs = require("fs");
+  const path = require("path");
+
+  const outDir = options.outDir || process.cwd();
+  const filename = options.filename || info.name || `fs_${info.fsId}`;
+  const outPath = path.join(outDir, filename);
+
+  fs.mkdirSync(outDir, { recursive: true });
+  // dlink 校验 UA：netdisk 客户端 UA 会返回 118 字节错误页，浏览器 UA 正常（实测）
+  const args = [
+    "-s", "-L",
+    "-H", `User-Agent: ${options.ua || "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"}`,
+    "-o", outPath,
+    "--max-time", String(options.timeoutSec || 3600),
+    info.dlink,
+  ];
+  const result = spawnSync("curl", args, { encoding: "utf-8", maxBuffer: 10 * 1024 * 1024, timeout: (options.timeoutSec || 3600) * 1000 });
+  if (result.error) throw new Error(`下载失败: ${result.error.message}`);
+
+  let size = 0;
+  try { size = fs.statSync(outPath).size; } catch {}
+  if (info.size && size !== info.size) {
+    throw new Error(
+      `下载大小不匹配: 实际 ${size} 字节，预期 ${info.size} 字节。` +
+      `dlink 可能已过期（有效期 8 小时），请重试。`
+    );
+  }
+  return { path: outPath, name: filename, size, dlink: info.dlink, fromUk: info.fromUk, msgId: info.msgId };
+}
+
+// ── 群文件批量打包下载 (gdownload 多 fs_id → zip) ───────
+//
+// 逆向结论（2026-08-12 实测）：
+//   - sharedownload 单文件 >~20MB 时返回加密 list（无法解密，key 未破解）
+//   - type=batch 时返回明文 zip 打包链接（method=batchdownload&zipcontent=...），
+//     小文件打包实测可用（10MB zip 完整下载）；超大文件报 error_code=31090 "package is too large"
+//   - zip 打包按 msg_id 归组：所有 fs_id 必须属于同一条分享消息
+
+// 获取多文件 zip 打包直链。options: { fromUk, msgId, cache }
+async function getShareZipDlink(gid, fsIds, options = {}) {
+  const gidS = toStr(gid);
+  const fsIdList = fsIds.map(toStr);
+  if (fsIdList.length < 2) throw new Error(`zip 打包下载需要至少 2 个 fs_id（当前传入 ${fsIdList.length} 个）`);
+
+  // 来源以第一个 fs_id 为准（其余视为同一分享消息内的文件）
+  const { fromUk, msgId } = await resolveShareSource(gidS, fsIdList[0], options, { cache: options.cache === true });
+  const bdstoken = await getBdstoken();
+  const url = `${http.PAN_BASE}/api/sharedownload?sign=&timestamp=&clienttype=0&app_id=${http.APP_ID}&web=1&bdstoken=${bdstoken}`;
+  const body = new URLSearchParams({
+    uk: fromUk,
+    product: "mbox",
+    encrypt: "0",
+    type: "batch",
+    primaryid: msgId,
+    fid_list: JSON.stringify(fsIdList),
+    extra: JSON.stringify({ type: "group", gid: gidS }),
+  }).toString();
+
+  const data = await http.webJson(url, { method: "POST", body });
+  if (data.errno !== 0) {
+    throw new Error(`API 返回错误: errno=${data.errno}（zip 批量打包）`);
+  }
+  if (!data.dlink) {
+    throw new Error(`未能为 ${fsIdList.length} 个文件获取 zip 打包链接（分享可能已失效）`);
+  }
+  return { dlink: data.dlink, fromUk, msgId, count: fsIdList.length };
+}
+
+// 批量打包下载。options: { outDir, filename, fromUk, msgId, ua }
+async function downloadFiles(gid, fsIds, options = {}) {
+  const { dlink, fromUk, msgId, count } = await getShareZipDlink(gid, fsIds, options);
+  const { spawnSync } = require("child_process");
+  const fs = require("fs");
+  const path = require("path");
+
+  const outDir = options.outDir || process.cwd();
+  const filename = options.filename || `bdp-group-${count}files.zip`;
+  const outPath = path.join(outDir, filename);
+
+  fs.mkdirSync(outDir, { recursive: true });
+  const args = [
+    "-s", "-L",
+    "-H", `User-Agent: ${options.ua || "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"}`,
+    "-o", outPath,
+    "--max-time", String(options.timeoutSec || 7200),
+    dlink,
+  ];
+  const result = spawnSync("curl", args, { encoding: "utf-8", maxBuffer: 10 * 1024 * 1024, timeout: (options.timeoutSec || 7200) * 1000 });
+  if (result.error) throw new Error(`下载失败: ${result.error.message}`);
+
+  let size = 0;
+  try { size = fs.statSync(outPath).size; } catch {}
+  if (size === 0) {
+    throw new Error(`zip 下载失败（0 字节）。dlink 可能已过期，或打包总大小超过上限（error_code 31090，可用 bdp error 31090 查询）`);
+  }
+  return { path: outPath, name: filename, size, dlink, fromUk, msgId, count };
+}
+
 // ── 目录树 (gtree) ────────────────────────────────────
 
 async function treeFiles(gid, options = {}) {
@@ -515,24 +696,12 @@ async function treeFiles(gid, options = {}) {
 async function searchFiles(gid, keyword, options = {}) {
   const gidS = toStr(gid);
 
-  // 关键词解析：空格分隔多关键词。
+  // 关键词解析：空格分隔多关键词（委托 lib/name-match.js 实现，语义与旧内联逻辑一致）：
   //  - 默认（all）：每个词都要出现（AND，可换序）→ "玄空 飞星" 只命中同时含两者的名字（精确收窄）
   //  - --any-word：任一词出现即可（OR，更宽）→ "玄空 飞星" 命中含"玄空"或"飞星"的名字
   //  - --exact：整名精确相等（最严格）；单关键词默认仍是子串包含（兼容旧行为）
-  const rawKw = String(keyword).toLowerCase();
-  const words = rawKw.split(/\s+/).filter(Boolean);
   const matchMode = options.exact ? "exact" : (options.anyWord ? "any" : "all");
-  const matchesName = (name) => {
-    const n = String(name || "").toLowerCase();
-    if (matchMode === "exact") {
-      // 精确匹配按文件名（去掉路径前缀），顶层分享 name 形如 "/xxx"，子目录文件 name 无前缀
-      const base = n.includes("/") ? n.slice(n.lastIndexOf("/") + 1) : n;
-      return base === rawKw;
-    }
-    if (words.length <= 1) return n.includes(rawKw);
-    if (matchMode === "any") return words.some((w) => n.includes(w));
-    return words.every((w) => n.includes(w));
-  };
+  const matchesName = (name) => matchName(keyword, name, { mode: matchMode });
 
   const limit = options.limit || 50;
   const page = options.page || 1;
@@ -751,5 +920,6 @@ async function searchFiles(gid, keyword, options = {}) {
 
 module.exports = {
   listGroups, listShares, listFiles, treeFiles, searchFiles,
+  getShareDlink, downloadFile, getShareZipDlink, downloadFiles,
   ShareApiError, describeErrno2131, clearGroupCache,
 };

package/lib/http.js

@@ -98,7 +98,14 @@ async function webJson(url, options = {}) {
   );
 }
 
-async function getBdstoken() {
+// bdstoken 短缓存：getFileMetaWeb 每次下载/peek 都要取一次 bdstoken（1 个 HTTP 往返），
+// 而 token 实际有效期很长，缓存 10 分钟显著减少重复请求
+let bdstokenCache = { token: null, expiresAt: 0 };
+
+async function getBdstoken({ forceRefresh = false } = {}) {
+  if (!forceRefresh && bdstokenCache.token && Date.now() < bdstokenCache.expiresAt) {
+    return bdstokenCache.token;
+  }
   const fields = encodeURIComponent('["bdstoken","token","uk","isdocuser","servertime"]');
   const data = await webJson(
     `https://pan.baidu.com/api/gettemplatevariable?clienttype=0&app_id=250528&web=1&fields=${fields}`
@@ -107,12 +114,13 @@ async function getBdstoken() {
   if (!token) {
     const cfg = require("./config").get();
     throw new Error(
-      `Cannot get bdstoken. The web session is not authenticated.\n` +
+      `无法获取 bdstoken: Web 会话未认证。\n` +
       `  BDUSS: ${cfg.bduss ? "set" : "MISSING"}  STOKEN: ${cfg.stoken ? "set" : "MISSING"}\n` +
       `  Web API transport: ${cfg.webTransport}\n` +
       `  Run: bdp login, or bdp login --bduss <value> --stoken <value>`
     );
   }
+  bdstokenCache = { token, expiresAt: Date.now() + 10 * 60 * 1000 };
   return token;
 }
 

package/lib/index.js

@@ -1,5 +1,7 @@
 const pan = require("./pan");
 const group = require("./group");
 const config = require("./config");
+const pcsExtra = require("./pcs-extra");
+const nameMatch = require("./name-match");
 
-module.exports = { pan, group, config };
+module.exports = { pan, group, config, pcsExtra, nameMatch };

package/lib/name-match.js

@@ -0,0 +1,67 @@
+// ── 文件名匹配（纯函数，无 IO）──────────────────────────
+//
+// 供群文件搜索（lib/group.js 的 gsearch）与网盘搜索（bdp search 集成建议）共用。
+// 所有函数都是同步纯函数：同样的输入永远得到同样的输出，不做任何网络/文件操作。
+//
+// 匹配模式（options.mode）：
+//   - "all"   （默认）空格分词，每个词都必须出现（AND，顺序无关）
+//   - "any"   空格分词，任一词出现即可（OR）
+//   - "exact" 整名精确相等（大小写不敏感，按 basename 比较，忽略目录前缀）
+//   - "regex" pattern 直接作为正则表达式
+//   - "glob"  pattern 按 shell glob（* 任意串、? 单字符）匹配
+// 单关键词时 all/any 都退化为子串包含（与 group.js 旧行为兼容）。
+
+// 正则元字符转义：普通字符串 → 可安全嵌入正则的等价字面量
+function escapeRegExp(s) {
+  return String(s).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+// shell glob 转正则：* → .*（任意串，含空）、? → .（任意单字符）、
+// 其余字符全部按字面量转义（如 "1.5版" 的 "." 在 glob 中就是普通句点）。
+// 结果整体锚定（^...$），即 glob 必须匹配整个文件名（shell 语义）。
+function globToRegExp(pattern) {
+  const escaped = String(pattern).replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const src = escaped.replace(/\\\*/g, ".*").replace(/\\\?/g, ".");
+  return new RegExp(`^(?:${src})$`);
+}
+
+// 核心匹配函数。
+//   pattern: 用户输入的关键词/模式
+//   name:    待匹配的文件名（可为完整路径，exact 模式会自动取 basename）
+//   options: { mode, ignoreCase }，ignoreCase 默认 true（与 group.js 旧行为一致）
+// 返回布尔值。
+function matchesName(pattern, name, options = {}) {
+  const mode = options.mode || "all";
+  const ignoreCase = options.ignoreCase !== false;
+  const raw = String(pattern);
+  const k = ignoreCase ? raw.toLowerCase() : raw;
+  const n = String(name || "");
+  const nn = ignoreCase ? n.toLowerCase() : n;
+
+  // regex：pattern 直接编译为正则（非法正则向上抛 SyntaxError，由调用方决定处理）
+  if (mode === "regex") {
+    return new RegExp(raw, ignoreCase ? "i" : "").test(n);
+  }
+
+  // glob：经 globToRegExp 转换后整体匹配
+  if (mode === "glob") {
+    return globToRegExp(raw).test(n);
+  }
+
+  // exact：整名精确相等。按 basename 比较（忽略 "/dir/" 前缀），
+  // 顶层分享 name 形如 "/xxx"，子目录文件 name 无前缀，两者统一处理。
+  if (mode === "exact") {
+    const base = nn.includes("/") ? nn.slice(nn.lastIndexOf("/") + 1) : nn;
+    return base === k;
+  }
+
+  // all / any：空格分词。空关键词（含纯空白）不过滤（匹配一切，兼容旧行为）；
+  // 单关键词退化为子串包含（兼容旧行为）。
+  const words = k.trim().split(/\s+/).filter(Boolean);
+  if (words.length === 0) return true;
+  if (words.length === 1) return nn.includes(words[0]);
+  if (mode === "any") return words.some((w) => nn.includes(w));
+  return words.every((w) => nn.includes(w)); // 默认 all：每词都需出现（AND）
+}
+
+module.exports = { globToRegExp, matchesName, escapeRegExp };