karin-plugin-qgroup-file2openlist 0.0.22 → 0.0.24

package/README.md

@@ -5,6 +5,8 @@
 - [前言](#前言)
 - [群文件导出](#群文件导出)
 - [同步到 OpenList](#同步到-openlist)
+- [主人管理（图片面板）](#主人管理图片面板)
+- [OpenList → OpenList 转发](#openlist--openlist-转发)
 - [快速开始](#快速开始)
 - [详细开发流程](#详细开发流程)
 - [常见问题与建议](#常见问题与建议)
@@ -42,8 +44,8 @@ TypeScript 插件开发流程现在更加简单，无需手动克隆模板仓库
 - `openlistBaseUrl`：例如 `http://127.0.0.1:5244`
 - `openlistUsername` / `openlistPassword`：用于 WebDAV BasicAuth 登录
 - `openlistTargetDir`：目标目录（例：`/挂载目录/QQ群文件`）
-- `groupSyncDefaults`：群同步默认策略（增量/全量、并发、单文件超时、重试等）
-- `groupSyncTargets`：同步对象群配置（每群可单独覆盖策略/目录/并发/定时计划/同步时段）
+- `groupSyncDefaults`：群同步默认策略（并发、单文件超时、重试等）
+- `groupSyncTargets`：同步对象群配置（每群可单独覆盖目录/并发/同步时段等）
 
 私聊命令：
 
@@ -51,7 +53,8 @@ TypeScript 插件开发流程现在更加简单，无需手动克隆模板仓库
 - `#同步群文件 <群号> --to /目标目录`：覆盖配置里的目标目录
 - `#同步群文件 <群号> --flat`：不保留群文件夹结构，全部平铺上传
 - `#同步群文件 <群号> --max <n>` / `--folder <id>` / `--concurrency <n>`：同导出命令
-- `#同步群文件 <群号> --full/--inc`：强制全量/增量（覆盖群配置）
+
+固定策略：同步模式为增量（incremental），单文件超时 3000 秒（不再通过命令配置）。
 
 群聊命令（简化）：
 
@@ -62,8 +65,27 @@ TypeScript 插件开发流程现在更加简单，无需手动克隆模板仓库
 - `#群同步配置 列表`
 - `#群同步配置 <群号> 添加/删除/查看`
 - `#群同步配置 <群号> 启用/停用`
-- `#群同步配置 <群号> 模式 全量|增量`
-- `#群同步配置 <群号> 计划 <cron>`：设置定时同步（例：`0 0 3 * * *`）
 - `#群同步配置 <群号> 时段 00:00-06:00,23:00-23:59`：限制定时同步时间段（空=不限制）
 
+说明：夜间自动备份默认每天 02:00 触发（先群后 oplts），固定增量 + 单文件超时 3000s；不再支持通过 `#群同步配置` 配置 cron/mode/timeout。
+
+## 主人管理（图片面板）
+
+仅主人私聊可用：
+
+- `#群文件面板`：输出管理总览面板（群绑定/监听/OP转发规则摘要/快捷命令）
+- `#绑定备份群 <群号> [--to /目标目录] [--flat|--keep]`：写入群配置并默认开启群文件上传监听
+- `#解绑备份群 <群号>`：删除该群配置
+- `#开启群文件监听 <群号>` / `#关闭群文件监听 <群号>`：切换 uploadBackup 监听开关
+
+## OpenList → OpenList 转发
+
+用于“多源站 → 单目的端（固定为配置 openlistBaseUrl）”的转发规则（仅主人私聊可用）：
+
+- `#添加op转发 <源OpenListBaseUrl> [--src /] [--to /backup] [--name xxx] [--user u] [--pass p] [--full|--inc] [--auto|--api|--webdav]`
+- `#op转发 列表`
+- `#op转发 查看 <ruleId>`
+- `#op转发 执行 <ruleId>`（默认全量）
+- `#op转发 删除 <ruleId>`
+
 ## 🚀 快速开始

package/config/config.json

@@ -9,12 +9,23 @@
     "flat": false,
     "urlConcurrency": 3,
     "transferConcurrency": 3,
-    "fileTimeoutSec": 600,
+    "fileTimeoutSec": 3000,
     "retryTimes": 2,
     "retryDelayMs": 1500,
     "progressReportEvery": 10,
     "downloadLimitKbps": 0,
     "uploadLimitKbps": 0
   },
-  "groupSyncTargets": []
+  "groupSyncTargets": [],
+  "openlistForwardRules": [],
+  "scheduler": {
+    "enabled": true,
+    "tickCron": "0 0 2 * * *",
+    "groupSync": {
+      "enabled": true
+    },
+    "opltNightly": {
+      "enabled": true
+    }
+  }
 }

package/lib/apps/groupFiles.backup.js

@@ -0,0 +1,229 @@
+import {
+  buildActionCard,
+  replyImages
+} from "../chunk-K2XRORRU.js";
+import "../chunk-PBBZ5KAD.js";
+import "../chunk-QB3GSENE.js";
+import {
+  handleGroupFileUploadedAutoBackup
+} from "../chunk-BU2GD6GJ.js";
+import "../chunk-WJNM5RHT.js";
+import {
+  backupOpenListToOpenListCore,
+  formatErrorMessage
+} from "../chunk-N5HMQFRM.js";
+import {
+  config
+} from "../chunk-DA4U55JC.js";
+import "../chunk-IZS467MR.js";
+
+// src/apps/groupFiles.backup.ts
+import { karin, logger } from "node-karin";
+var FIXED_BACKUP_MODE = "incremental";
+var FIXED_TIMEOUT_SEC = 3e3;
+var parseBackupOpenListArgs = (text) => {
+  const raw = text.trim();
+  const tokens = raw ? raw.split(/\s+/).filter(Boolean) : [];
+  const help = /(^|\s)(--help|-h|help|\?)(\s|$)/i.test(raw);
+  const first = tokens[0];
+  const sourceBaseUrl = first && /^https?:\/\//i.test(first) ? first : void 0;
+  const restRaw = sourceBaseUrl ? raw.slice(first.length).trim() : raw;
+  const srcMatch = restRaw.match(/--src\s+(\S+)/i) ?? restRaw.match(/(^|\s)src=(\S+)/i);
+  const srcDir = srcMatch ? srcMatch[srcMatch.length - 1] : void 0;
+  const toMatch = restRaw.match(/--to\s+(\S+)/i) ?? restRaw.match(/(^|\s)to=(\S+)/i);
+  const toDir = toMatch ? toMatch[toMatch.length - 1] : void 0;
+  const maxMatch = restRaw.match(/--max\s+(\d+)/i) ?? restRaw.match(/(^|\s)max=(\d+)/i);
+  const maxFiles = maxMatch ? Number(maxMatch[maxMatch.length - 1]) : void 0;
+  const concurrencyMatch = restRaw.match(/--concurrency\s+(\d+)/i) ?? restRaw.match(/(^|\s)concurrency=(\d+)/i);
+  const concurrency = concurrencyMatch ? Number(concurrencyMatch[concurrencyMatch.length - 1]) : void 0;
+  const scanMatch = restRaw.match(/--scan(?:-concurrency)?\s+(\d+)/i) ?? restRaw.match(/(^|\s)scan=(\d+)/i) ?? restRaw.match(/(^|\s)scanConcurrency=(\d+)/i) ?? restRaw.match(/(^|\s)scan_concurrency=(\d+)/i);
+  const scanConcurrency = scanMatch ? Number(scanMatch[scanMatch.length - 1]) : void 0;
+  const perPageMatch = restRaw.match(/--per-page\s+(\d+)/i) ?? restRaw.match(/--perpage\s+(\d+)/i) ?? restRaw.match(/--page-size\s+(\d+)/i) ?? restRaw.match(/(^|\s)per[_-]?page=(\d+)/i) ?? restRaw.match(/(^|\s)pageSize=(\d+)/i) ?? restRaw.match(/(^|\s)per_page=(\d+)/i);
+  const perPage = perPageMatch ? Number(perPageMatch[perPageMatch.length - 1]) : void 0;
+  const transportApi = /(^|\s)(--api)(\s|$)/i.test(restRaw);
+  const transportWebDav = /(^|\s)(--webdav|--dav)(\s|$)/i.test(restRaw);
+  const transportAuto = /(^|\s)(--auto)(\s|$)/i.test(restRaw);
+  const transport = transportApi ? "api" : transportWebDav ? "webdav" : transportAuto ? "auto" : void 0;
+  return {
+    sourceBaseUrl,
+    srcDir,
+    toDir,
+    maxFiles,
+    concurrency,
+    scanConcurrency,
+    perPage,
+    transport,
+    help
+  };
+};
+var openListToOpenListHelpText = [
+  "OpenList -> OpenList \u5907\u4EFD\u7528\u6CD5\uFF1A",
+  "- \u79C1\u804A\uFF1A#\u5907\u4EFDoplist [\u6E90OpenList\u5730\u5740] [\u53C2\u6570]",
+  "- \u793A\u4F8B\uFF1A#\u5907\u4EFDoplist https://pan.example.com",
+  `- \u56FA\u5B9A\u7B56\u7565\uFF1Amode=${FIXED_BACKUP_MODE} \u5355\u6587\u4EF6\u8D85\u65F6=${FIXED_TIMEOUT_SEC}s\uFF08\u4E0D\u518D\u901A\u8FC7\u547D\u4EE4\u914D\u7F6E\uFF09`,
+  "- #\u5907\u4EFDoplist https://pan.example.com --api",
+  "- #\u5907\u4EFDoplist https://pan.example.com --webdav",
+  "- #\u5907\u4EFDoplist https://pan.example.com --concurrency 3",
+  "- #\u5907\u4EFDoplist https://pan.example.com --scan 30 --per-page 2000",
+  "\u63D0\u793A\uFF1A\u76EE\u6807\u7AEF\u4F7F\u7528 openlistBaseUrl/openlistUsername/openlistPassword\uFF08\u4E0E\u7FA4\u6587\u4EF6\u540C\u6B65\u5171\u7528\uFF09\u3002",
+  "\u63D0\u793A\uFF1A\u4F20\u8F93\u9ED8\u8BA4 auto\uFF08\u6E90\u7AEF\u4E0B\u8F7D\u504F\u5411 API\uFF0C\u76EE\u6807\u7AEF\u4E0A\u4F20\u504F\u5411 WebDAV\uFF1B\u5931\u8D25\u4F1A\u56DE\u9000\uFF09\u3002",
+  '\u8BF4\u660E\uFF1A\u4F1A\u5728\u76EE\u6807\u76EE\u5F55\u4E0B\u521B\u5EFA\u5B50\u76EE\u5F55\uFF08\u6E90 OpenList \u57DF\u540D\uFF0C"." \u66FF\u6362\u4E3A "_"\uFF09\u3002'
+].join("\n");
+var backupOpenListToOpenList = karin.command(/^#?备份oplist(.*)$/i, async (e) => {
+  if (!e.isPrivate) return false;
+  const argsText = e.msg.replace(/^#?备份oplist/i, "");
+  const {
+    sourceBaseUrl,
+    srcDir,
+    toDir,
+    maxFiles,
+    concurrency,
+    scanConcurrency,
+    perPage,
+    transport,
+    help
+  } = parseBackupOpenListArgs(argsText);
+  if (help || !sourceBaseUrl) {
+    try {
+      const img = await buildActionCard({
+        title: "\u5907\u4EFDoplist \u5E2E\u52A9",
+        status: "ok",
+        subtitle: "\u79C1\u804A \xB7 \u56FE\u7247\u8BF4\u660E",
+        sections: [
+          {
+            title: "\u8BF4\u660E",
+            lines: openListToOpenListHelpText.split("\n").map((text) => ({
+              text,
+              mono: /(^|\s)#/.test(text)
+            }))
+          }
+        ],
+        footerRight: "#\u5907\u4EFDoplist"
+      });
+      await replyImages(e, img);
+    } catch (error) {
+      logger.error(error);
+      await e.reply(openListToOpenListHelpText);
+    }
+    return true;
+  }
+  try {
+    const cfg = config();
+    const targetBaseUrl = String(cfg.openlistBaseUrl ?? "").trim() || "-";
+    const startedAt = Date.now();
+    try {
+      const startCard = await buildActionCard({
+        title: "\u5907\u4EFD\u4EFB\u52A1\u5DF2\u542F\u52A8",
+        status: "ok",
+        subtitle: "OpenList \u2192 OpenList\uFF08\u5355\u6B21\uFF09",
+        sections: [
+          {
+            title: "\u6267\u884C\u4FE1\u606F",
+            rows: [
+              { k: "\u6E90", v: String(sourceBaseUrl), mono: true },
+              { k: "\u6E90\u76EE\u5F55", v: String(srcDir ?? "/"), mono: true },
+              { k: "\u76EE\u6807", v: targetBaseUrl, mono: true },
+              { k: "\u76EE\u6807\u76EE\u5F55", v: String(toDir ?? "(\u9ED8\u8BA4 openlistTargetDir)"), mono: true },
+              { k: "mode", v: String(FIXED_BACKUP_MODE), mono: true },
+              { k: "timeout", v: `${FIXED_TIMEOUT_SEC}s`, mono: true },
+              { k: "transport", v: String(transport ?? "auto"), mono: true }
+            ]
+          },
+          {
+            title: "\u63D0\u793A",
+            lines: [
+              { text: "\u6267\u884C\u8FC7\u7A0B\u4E2D\u4E0D\u53D1\u9001\u6587\u672C\u8FDB\u5EA6\uFF1B\u5B8C\u6210\u540E\u53D1\u9001\u7ED3\u679C\u56FE\u3002" }
+            ]
+          }
+        ],
+        footerRight: "#\u5907\u4EFDoplist"
+      });
+      await replyImages(e, startCard);
+    } catch (error) {
+      logger.error(error);
+    }
+    const res = await backupOpenListToOpenListCore({
+      sourceBaseUrl,
+      srcDir,
+      toDir,
+      maxFiles,
+      concurrency,
+      timeoutSec: FIXED_TIMEOUT_SEC,
+      scanConcurrency,
+      perPage,
+      mode: FIXED_BACKUP_MODE,
+      transport
+    });
+    const elapsed = Math.max(0, Math.floor((Date.now() - startedAt) / 1e3));
+    try {
+      const doneCard = await buildActionCard({
+        title: "\u5907\u4EFD\u5B8C\u6210",
+        status: res.fail ? "warn" : "ok",
+        statusText: res.fail ? "\u90E8\u5206\u5931\u8D25" : "\u6210\u529F",
+        subtitle: "OpenList \u2192 OpenList\uFF08\u5355\u6B21\uFF09",
+        sections: [
+          {
+            title: "\u7ED3\u679C",
+            rows: [
+              { k: "ok", v: String(res.ok), mono: true },
+              { k: "skipped", v: String(res.skipped), mono: true },
+              { k: "fail", v: String(res.fail), mono: true },
+              { k: "\u8017\u65F6", v: `${elapsed}s`, mono: true }
+            ]
+          },
+          {
+            title: "\u4E0B\u4E00\u6B65",
+            lines: [
+              { text: "#\u6211\u7684\u5907\u4EFD", mono: true }
+            ]
+          }
+        ],
+        footerRight: "#\u5907\u4EFDoplist"
+      });
+      await replyImages(e, doneCard);
+    } catch (error) {
+      logger.error(error);
+      await e.reply(`\u5907\u4EFD\u5B8C\u6210\uFF1A\u6210\u529F ${res.ok}\uFF0C\u8DF3\u8FC7 ${res.skipped}\uFF0C\u5931\u8D25 ${res.fail}`);
+    }
+    return true;
+  } catch (error) {
+    logger.error(error);
+    const msg = formatErrorMessage(error);
+    try {
+      const errCard = await buildActionCard({
+        title: "\u5907\u4EFD\u5931\u8D25",
+        status: "bad",
+        statusText: "\u5F02\u5E38",
+        subtitle: "OpenList \u2192 OpenList\uFF08\u5355\u6B21\uFF09",
+        sections: [
+          {
+            title: "\u9519\u8BEF",
+            lines: [{ text: msg }]
+          }
+        ],
+        footerRight: "#\u5907\u4EFDoplist"
+      });
+      await replyImages(e, errCard);
+    } catch (renderError) {
+      logger.error(renderError);
+      await e.reply(msg);
+    }
+    return true;
+  }
+}, {
+  priority: 9999,
+  log: true,
+  name: "OpenList\u5907\u4EFD\u5230\u5BF9\u7AEFOpenList",
+  permission: "all"
+});
+var groupFileUploadedAutoBackup = karin.accept("notice.groupFileUploaded", (e, next) => {
+  try {
+    handleGroupFileUploadedAutoBackup(e);
+  } finally {
+    next();
+  }
+}, { log: false, name: "\u7FA4\u6587\u4EF6\u4E0A\u4F20\u81EA\u52A8\u5907\u4EFD" });
+export {
+  backupOpenListToOpenList,
+  groupFileUploadedAutoBackup
+};

package/lib/apps/groupFiles.js

@@ -1,16 +1,311 @@
 import {
-  backupOpenListToOpenList,
-  exportGroupFiles,
-  groupFileUploadedAutoBackup,
-  syncGroupFilesToOpenList,
+  exportGroupFilesToDisk,
   syncGroupFilesToOpenListCore
-} from "../chunk-AWSGUQPA.js";
-import "../chunk-5WVKHIPK.js";
+} from "../chunk-BU2GD6GJ.js";
+import "../chunk-WJNM5RHT.js";
+import {
+  formatErrorMessage,
+  normalizePosixPath
+} from "../chunk-N5HMQFRM.js";
+import {
+  config
+} from "../chunk-DA4U55JC.js";
 import "../chunk-IZS467MR.js";
+
+// src/apps/groupFiles.ts
+import path from "path";
+import { pathToFileURL } from "url";
+import { karin, logger } from "node-karin";
+var MAX_FILE_TIMEOUT_SEC = 3e3;
+var DEFAULT_PROGRESS_REPORT_EVERY = 10;
+var FIXED_SYNC_MODE = "incremental";
+var buildUploadFileCandidates = (filePath) => {
+  const normalized = filePath.replaceAll("\\", "/");
+  const candidates = [
+    filePath,
+    normalized
+  ];
+  try {
+    candidates.push(pathToFileURL(filePath).href);
+  } catch {
+  }
+  if (/^[a-zA-Z]:\//.test(normalized)) {
+    candidates.push(`file:///${normalized}`);
+  }
+  return [...new Set(candidates.filter(Boolean))];
+};
+var parseArgs = (text) => {
+  const raw = text.trim();
+  const tokens = raw ? raw.split(/\s+/).filter(Boolean) : [];
+  const format = /(^|\s)(--csv|csv)(\s|$)/i.test(raw) ? "csv" : "json";
+  const withUrl = !/(^|\s)(--no-url|--nourl|no-url|nourl)(\s|$)/i.test(raw);
+  const urlOnly = /(^|\s)(--url-only|--urlonly|url-only|urlonly)(\s|$)/i.test(raw);
+  const sendFile = /(^|\s)(--send-file|--sendfile|send-file|sendfile)(\s|$)/i.test(raw);
+  let groupId;
+  for (let i = 0; i < tokens.length; i++) {
+    const token = tokens[i];
+    const nextToken = tokens[i + 1];
+    if (/^--(group|gid|groupid)$/i.test(token) && nextToken && /^\d+$/.test(nextToken)) {
+      groupId = nextToken;
+      break;
+    }
+    const assignMatch = token.match(/^(group|gid|groupid)=(\d+)$/i);
+    if (assignMatch) {
+      groupId = assignMatch[2];
+      break;
+    }
+  }
+  if (!groupId) {
+    for (let i = 0; i < tokens.length; i++) {
+      const token = tokens[i];
+      const prevToken = tokens[i - 1];
+      if (!/^\d+$/.test(token)) continue;
+      if (prevToken && /^--(folder|max|concurrency|group|gid|groupid|to|timeout)$/i.test(prevToken)) continue;
+      groupId = token;
+      break;
+    }
+  }
+  const folderMatch = raw.match(/--folder\s+(\S+)/i) ?? raw.match(/(^|\s)folder=(\S+)/i);
+  const folderId = folderMatch ? folderMatch[folderMatch.length - 1] : void 0;
+  const maxMatch = raw.match(/--max\s+(\d+)/i) ?? raw.match(/(^|\s)max=(\d+)/i);
+  const maxFiles = maxMatch ? Number(maxMatch[maxMatch.length - 1]) : void 0;
+  const concurrencyMatch = raw.match(/--concurrency\s+(\d+)/i) ?? raw.match(/(^|\s)concurrency=(\d+)/i);
+  const concurrency = concurrencyMatch ? Number(concurrencyMatch[concurrencyMatch.length - 1]) : void 0;
+  const concurrencySpecified = Boolean(concurrencyMatch);
+  const help = /(^|\s)(--help|-h|help|\?)(\s|$)/i.test(raw);
+  return { groupId, format, withUrl, urlOnly, sendFile, folderId, maxFiles, concurrency, concurrencySpecified, help };
+};
+var parseSyncArgs = (text) => {
+  const raw = text.trim();
+  const base = parseArgs(text);
+  const toMatch = raw.match(/--to\s+(\S+)/i) ?? raw.match(/(^|\s)to=(\S+)/i);
+  const to = toMatch ? toMatch[toMatch.length - 1] : void 0;
+  const toSpecified = Boolean(toMatch);
+  const flatFlag = /(^|\s)(--flat|flat)(\s|$)/i.test(raw);
+  const keepFlag = /(^|\s)(--keep|keep)(\s|$)/i.test(raw);
+  const flatSpecified = flatFlag || keepFlag;
+  const flat = flatFlag ? true : keepFlag ? false : void 0;
+  return {
+    groupId: base.groupId,
+    folderId: base.folderId,
+    maxFiles: base.maxFiles,
+    concurrency: base.concurrency,
+    concurrencySpecified: base.concurrencySpecified,
+    flat,
+    flatSpecified,
+    to,
+    toSpecified,
+    help: base.help
+  };
+};
+var helpText = [
+  "\u7FA4\u6587\u4EF6\u5BFC\u51FA\u7528\u6CD5\uFF1A",
+  "- \u8BF7\u79C1\u804A\u53D1\u9001\uFF1A#\u5BFC\u51FA\u7FA4\u6587\u4EF6 <\u7FA4\u53F7> [\u53C2\u6570]",
+  "- \u793A\u4F8B\uFF1A#\u5BFC\u51FA\u7FA4\u6587\u4EF6 123456",
+  "- #\u5BFC\u51FA\u7FA4\u6587\u4EF6 123456 --no-url\uFF1A\u53EA\u5BFC\u51FA\u5217\u8868\uFF0C\u4E0D\u89E3\u6790 URL",
+  "- #\u5BFC\u51FA\u7FA4\u6587\u4EF6 123456 --url-only\uFF1A\u4EC5\u8F93\u51FA URL\uFF08\u66F4\u65B9\u4FBF\u590D\u5236\uFF09",
+  "- #\u5BFC\u51FA\u7FA4\u6587\u4EF6 123456 --csv\uFF1A\u5BFC\u51FA\u4E3A CSV\uFF08\u9ED8\u8BA4 JSON\uFF09",
+  "- #\u5BFC\u51FA\u7FA4\u6587\u4EF6 123456 --folder <id>\uFF1A\u4ECE\u6307\u5B9A\u6587\u4EF6\u5939\u5F00\u59CB\u5BFC\u51FA",
+  "- #\u5BFC\u51FA\u7FA4\u6587\u4EF6 123456 --max <n>\uFF1A\u6700\u591A\u5BFC\u51FA n \u6761\u6587\u4EF6\u8BB0\u5F55",
+  "- #\u5BFC\u51FA\u7FA4\u6587\u4EF6 123456 --concurrency <n>\uFF1A\u89E3\u6790 URL \u5E76\u53D1\u6570\uFF08\u9ED8\u8BA4 3\uFF09",
+  "- #\u5BFC\u51FA\u7FA4\u6587\u4EF6 123456 --send-file\uFF1A\u5C1D\u8BD5\u53D1\u9001\u5BFC\u51FA\u6587\u4EF6\uFF08\u4F9D\u8D56\u534F\u8BAE\u7AEF\u652F\u6301\uFF09",
+  "\u63D0\u793A\uFF1A\u4E0B\u8F7D URL \u901A\u5E38\u6709\u65F6\u6548\uFF0C\u8FC7\u671F\u540E\u9700\u91CD\u65B0\u5BFC\u51FA\u3002"
+].join("\n");
+var exportGroupFiles = karin.command(/^#?(导出群文件|群文件导出)(.*)$/i, async (e) => {
+  if (!e.isPrivate) return false;
+  const argsText = e.msg.replace(/^#?(导出群文件|群文件导出)/i, "");
+  const { groupId, format, withUrl, urlOnly, sendFile, folderId, maxFiles, concurrency, help } = parseArgs(argsText);
+  if (help) {
+    await e.reply(helpText);
+    return true;
+  }
+  if (!groupId) {
+    await e.reply(`\u7F3A\u5C11\u7FA4\u53F7\u53C2\u6570
+
+${helpText}`);
+    return true;
+  }
+  const groupContact = karin.contactGroup(groupId);
+  await e.reply(`\u5F00\u59CB\u5BFC\u51FA\u7FA4\u6587\u4EF6\u5217\u8868\uFF0C\u8BF7\u7A0D\u5019..
+- \u7FA4\u53F7\uFF1A${groupId}
+- \u683C\u5F0F\uFF1A${format}
+- \u5305\u542BURL\uFF1A${withUrl ? "\u662F" : "\u5426"}`);
+  let result;
+  try {
+    const urlConcurrency = typeof concurrency === "number" && Number.isFinite(concurrency) && concurrency > 0 ? concurrency : 3;
+    result = await exportGroupFilesToDisk({
+      bot: e.bot,
+      contact: groupContact,
+      groupId,
+      folderId,
+      maxFiles,
+      withUrl,
+      urlConcurrency,
+      format
+    });
+  } catch (error) {
+    logger.error(error);
+    await e.reply(`\u5BFC\u51FA\u5931\u8D25\uFF1A${formatErrorMessage(error)}`);
+    return true;
+  }
+  const { limitedList, exportPath, exportName, urlErrors } = result;
+  const errorsByFileId = /* @__PURE__ */ new Map();
+  for (const err of urlErrors) {
+    if (!err.fileId) continue;
+    if (!errorsByFileId.has(err.fileId)) errorsByFileId.set(err.fileId, err.message);
+  }
+  await e.reply([
+    "\u5BFC\u51FA\u5B8C\u6210\uFF1A",
+    `- \u603B\u6570\uFF1A${limitedList.length}`,
+    `- URL\u83B7\u53D6\u5931\u8D25\uFF1A${urlErrors.length}`,
+    `- \u6587\u4EF6\uFF1A${exportPath}`
+  ].join("\n"));
+  const compactError = (message) => message.replace(/\s+/g, " ").slice(0, 120);
+  const preview = limitedList.slice(0, 20);
+  const lines = preview.map((item, index) => {
+    if (urlOnly) return `${index + 1}. ${item.url ?? ""}`.trim();
+    const errMsg = errorsByFileId.get(item.fileId);
+    if (item.url) return `${index + 1}. ${item.path}
+${item.url}`;
+    return `${index + 1}. ${item.path}
+(\u83B7\u53D6URL\u5931\u8D25) fileId=${item.fileId}${errMsg ? `
+\u539F\u56E0\uFF1A${compactError(errMsg)}` : ""}`;
+  });
+  const chunks = [];
+  const maxChunkLen = 1500;
+  let buf = "";
+  for (const line of lines) {
+    const next = buf ? `${buf}
+
+${line}` : line;
+    if (next.length > maxChunkLen) {
+      if (buf) chunks.push(buf);
+      buf = line;
+    } else {
+      buf = next;
+    }
+  }
+  if (buf) chunks.push(buf);
+  const maxMessages = 10;
+  for (const chunk of chunks.slice(0, maxMessages)) {
+    await e.reply(chunk);
+  }
+  if (limitedList.length > preview.length) {
+    await e.reply(`\uFF08\u5DF2\u7701\u7565 ${limitedList.length - preview.length} \u6761\uFF0C\u53EF\u4F7F\u7528 --max \u8C03\u6574\uFF09`);
+  } else if (chunks.length > maxMessages) {
+    await e.reply("\uFF08\u6D88\u606F\u8FC7\u957F\uFF0C\u5DF2\u7701\u7565\u540E\u7EED\u5185\u5BB9\uFF1B\u53EF\u4F7F\u7528 --max \u51CF\u5C11\u6761\u6570\uFF09");
+  }
+  if (sendFile && typeof e.bot?.uploadFile === "function") {
+    const candidates = buildUploadFileCandidates(exportPath);
+    for (const fileParam of candidates) {
+      try {
+        await e.bot.uploadFile(e.contact, fileParam, exportName);
+        break;
+      } catch {
+      }
+    }
+  }
+  return true;
+}, {
+  priority: 9999,
+  log: true,
+  name: "\u5BFC\u51FA\u7FA4\u6587\u4EF6",
+  permission: "all"
+});
+var syncHelpText = [
+  "\u7FA4\u6587\u4EF6\u540C\u6B65\u5230 OpenList \u7528\u6CD5\uFF1A",
+  "- \u79C1\u804A\uFF1A#\u540C\u6B65\u7FA4\u6587\u4EF6 <\u7FA4\u53F7> [\u53C2\u6570]",
+  "- \u6CE8\u610F\uFF1A\u9ED8\u8BA4\u4EC5\u79C1\u804A\u54CD\u5E94\uFF08\u7FA4\u804A\u4E0D\u4F1A\u89E6\u53D1\u8BE5\u6307\u4EE4\uFF09",
+  "- \u793A\u4F8B\uFF1A#\u540C\u6B65\u7FA4\u6587\u4EF6 123456",
+  "- #\u540C\u6B65\u7FA4\u6587\u4EF6 123456 --to /\u76EE\u6807\u76EE\u5F55\uFF1A\u4E0A\u4F20\u5230\u6307\u5B9A\u76EE\u5F55\uFF08\u9ED8\u8BA4\u4F7F\u7528\u914D\u7F6E openlistTargetDir\uFF09",
+  "- #\u540C\u6B65\u7FA4\u6587\u4EF6 123456 --flat\uFF1A\u4E0D\u4FDD\u7559\u7FA4\u6587\u4EF6\u5939\u7ED3\u6784\uFF0C\u5168\u90E8\u5E73\u94FA\u5230\u76EE\u6807\u76EE\u5F55",
+  "- #\u540C\u6B65\u7FA4\u6587\u4EF6 123456 --keep\uFF1A\u5F3A\u5236\u4FDD\u7559\u76EE\u5F55\u7ED3\u6784\uFF08\u8986\u76D6\u7FA4\u914D\u7F6E flat\uFF09",
+  "- #\u540C\u6B65\u7FA4\u6587\u4EF6 123456 --folder <id>\uFF1A\u4ECE\u6307\u5B9A\u6587\u4EF6\u5939\u5F00\u59CB",
+  "- #\u540C\u6B65\u7FA4\u6587\u4EF6 123456 --max <n>\uFF1A\u6700\u591A\u5904\u7406 n \u4E2A\u6587\u4EF6",
+  "- #\u540C\u6B65\u7FA4\u6587\u4EF6 123456 --concurrency <n>\uFF1A\u5E76\u53D1\u6570\uFF08\u4F1A\u8986\u76D6\u7FA4\u914D\u7F6E\u7684\u5E76\u53D1\uFF09",
+  `- \u56FA\u5B9A\u7B56\u7565\uFF1Amode=${FIXED_SYNC_MODE} \u5355\u6587\u4EF6\u8D85\u65F6=${MAX_FILE_TIMEOUT_SEC}s\uFF08\u4E0D\u518D\u901A\u8FC7\u547D\u4EE4\u914D\u7F6E\uFF09`,
+  "\u524D\u7F6E\uFF1A\u8BF7\u5148\u5728\u914D\u7F6E\u6587\u4EF6\u586B\u5199 openlistBaseUrl/openlistUsername/openlistPassword\u3002"
+].join("\n");
+var getGroupSyncTarget = (cfg, groupId) => {
+  const list = cfg?.groupSyncTargets;
+  if (!Array.isArray(list)) return void 0;
+  return list.find((it) => String(it?.groupId) === String(groupId));
+};
+var syncGroupFilesToOpenList = karin.command(/^#?(同步群文件|群文件同步)(.*)$/i, async (e) => {
+  if (!e.isPrivate) return false;
+  const argsText = e.msg.replace(/^#?(同步群文件|群文件同步)/i, "");
+  const {
+    groupId: parsedGroupId,
+    folderId: parsedFolderId,
+    maxFiles: parsedMaxFiles,
+    concurrency,
+    concurrencySpecified,
+    flat,
+    flatSpecified,
+    to,
+    toSpecified,
+    help
+  } = parseSyncArgs(argsText);
+  if (help) {
+    await e.reply(syncHelpText);
+    return true;
+  }
+  const cfg = config();
+  const groupId = parsedGroupId ?? (e.isGroup ? e.groupId : void 0);
+  if (!groupId) {
+    await e.reply(`\u7F3A\u5C11\u7FA4\u53F7\u53C2\u6570
+
+${syncHelpText}`);
+    return true;
+  }
+  const defaults = cfg.groupSyncDefaults ?? {};
+  const targetCfg = getGroupSyncTarget(cfg, groupId);
+  const mode = FIXED_SYNC_MODE;
+  const urlC = concurrencySpecified ? typeof concurrency === "number" ? concurrency : 3 : typeof targetCfg?.urlConcurrency === "number" ? targetCfg.urlConcurrency : typeof defaults?.urlConcurrency === "number" ? defaults.urlConcurrency : 3;
+  const transferC = concurrencySpecified ? typeof concurrency === "number" ? concurrency : 3 : typeof targetCfg?.transferConcurrency === "number" ? targetCfg.transferConcurrency : typeof defaults?.transferConcurrency === "number" ? defaults.transferConcurrency : 3;
+  const retryTimes = typeof targetCfg?.retryTimes === "number" ? targetCfg.retryTimes : typeof defaults?.retryTimes === "number" ? defaults.retryTimes : 2;
+  const retryDelayMs = typeof targetCfg?.retryDelayMs === "number" ? targetCfg.retryDelayMs : typeof defaults?.retryDelayMs === "number" ? defaults.retryDelayMs : 1500;
+  const progressEvery = typeof targetCfg?.progressReportEvery === "number" ? targetCfg.progressReportEvery : typeof defaults?.progressReportEvery === "number" ? defaults.progressReportEvery : DEFAULT_PROGRESS_REPORT_EVERY;
+  const downloadLimitKbps = typeof targetCfg?.downloadLimitKbps === "number" ? targetCfg.downloadLimitKbps : typeof defaults?.downloadLimitKbps === "number" ? defaults.downloadLimitKbps : 0;
+  const uploadLimitKbps = typeof targetCfg?.uploadLimitKbps === "number" ? targetCfg.uploadLimitKbps : typeof defaults?.uploadLimitKbps === "number" ? defaults.uploadLimitKbps : 0;
+  const targetDir = normalizePosixPath(
+    toSpecified ? to ?? "" : String(targetCfg?.targetDir ?? "").trim() || path.posix.join(String(cfg.openlistTargetDir ?? "/"), String(groupId))
+  );
+  const finalFlat = flatSpecified ? Boolean(flat) : typeof targetCfg?.flat === "boolean" ? targetCfg.flat : Boolean(defaults?.flat ?? false);
+  const folderId = parsedFolderId ?? targetCfg?.sourceFolderId;
+  const maxFiles = typeof parsedMaxFiles === "number" ? parsedMaxFiles : targetCfg?.maxFiles;
+  try {
+    await syncGroupFilesToOpenListCore({
+      bot: e.bot,
+      groupId,
+      folderId,
+      maxFiles,
+      flat: Boolean(finalFlat),
+      targetDir,
+      mode,
+      urlConcurrency: Math.max(1, Math.floor(urlC) || 1),
+      transferConcurrency: Math.max(1, Math.floor(transferC) || 1),
+      fileTimeoutSec: MAX_FILE_TIMEOUT_SEC,
+      retryTimes: Math.max(0, Math.floor(retryTimes) || 0),
+      retryDelayMs: Math.max(0, Math.floor(retryDelayMs) || 0),
+      progressReportEvery: Math.max(0, Math.floor(progressEvery) || 0),
+      downloadLimitKbps: Math.max(0, Math.floor(downloadLimitKbps) || 0),
+      uploadLimitKbps: Math.max(0, Math.floor(uploadLimitKbps) || 0),
+      report: (msg) => e.reply(msg)
+    });
+  } catch (error) {
+    logger.error(error);
+    await e.reply(formatErrorMessage(error));
+    return true;
+  }
+  return true;
+}, {
+  priority: 9999,
+  log: true,
+  name: "\u540C\u6B65\u7FA4\u6587\u4EF6\u5230OpenList",
+  permission: "all"
+});
 export {
-  backupOpenListToOpenList,
   exportGroupFiles,
-  groupFileUploadedAutoBackup,
-  syncGroupFilesToOpenList,
-  syncGroupFilesToOpenListCore
+  syncGroupFilesToOpenList
 };