karin-plugin-qgroup-file2openlist 0.0.1

package/README.md

@@ -0,0 +1,171 @@
+# Karin TypeScript 插件开发模板
+
+## 📖 目录
+
+- [前言](#前言)
+- [群文件导出](#群文件导出)
+- [同步到 OpenList](#同步到-openlist)
+- [快速开始](#快速开始)
+- [详细开发流程](#详细开发流程)
+- [常见问题与建议](#常见问题与建议)
+- [贡献与反馈](#贡献与反馈)
+
+---
+
+## 前言
+
+TypeScript 插件开发流程现在更加简单，无需手动克隆模板仓库，只需一条命令即可快速开始！
+
+> TypeScript 编写 → 编译为 JS → 发布 NPM 包 → 用户安装
+
+---
+
+## 群文件导出
+
+在私聊中发送（默认所有人可用，可在 `src/apps/groupFiles.ts` 调整权限）：
+
+- `#导出群文件 <群号>`：递归导出群文件列表（JSON，包含下载 URL）
+- `#导出群文件 <群号> --csv`：导出 CSV
+- `#导出群文件 <群号> --no-url`：只导出列表，不解析 URL
+- `#导出群文件 <群号> --url-only`：仅输出 URL（更方便复制）
+- `#导出群文件 <群号> --folder <id>`：从指定文件夹开始导出
+- `#导出群文件 <群号> --max <n>`：最多导出 n 条文件记录
+- `#导出群文件 <群号> --concurrency <n>`：解析 URL 并发数（默认 3）
+- `#导出群文件 <群号> --send-file`：尝试发送导出文件（依赖协议端支持）
+
+提示：下载 URL 通常有时效，过期后需重新导出。
+
+## 同步到 OpenList
+
+前置配置：`config/config.json`（会自动复制到 `@karinjs/<插件名>/config/config.json`）
+
+- `openlistBaseUrl`：例如 `http://127.0.0.1:5244`
+- `openlistUsername` / `openlistPassword`：用于 WebDAV BasicAuth 登录
+- `openlistTargetDir`：目标目录（例：`/挂载目录/QQ群文件`）
+- `groupSyncDefaults`：群同步默认策略（增量/全量、并发、单文件超时、重试等）
+- `groupSyncTargets`：同步对象群配置（每群可单独覆盖策略/目录/并发/定时计划/同步时段）
+
+私聊命令：
+
+- `#同步群文件 <群号>`：下载群文件并通过 OpenList WebDAV 上传到目标目录
+- `#同步群文件 <群号> --to /目标目录`：覆盖配置里的目标目录
+- `#同步群文件 <群号> --flat`：不保留群文件夹结构，全部平铺上传
+- `#同步群文件 <群号> --max <n>` / `--folder <id>` / `--concurrency <n>`：同导出命令
+- `#同步群文件 <群号> --full/--inc`：强制全量/增量（覆盖群配置）
+
+群聊命令（简化）：
+
+- `#同步群文件`：默认同步本群（建议先在 WebUI 配置 `groupSyncTargets`）
+
+群同步配置命令（主人权限）：
+
+- `#群同步配置 列表`
+- `#群同步配置 <群号> 添加/删除/查看`
+- `#群同步配置 <群号> 启用/停用`
+- `#群同步配置 <群号> 模式 全量|增量`
+- `#群同步配置 <群号> 计划 <cron>`：设置定时同步（例：`0 0 3 * * *`）
+- `#群同步配置 <群号> 时段 00:00-06:00,23:00-23:59`：限制定时同步时间段（空=不限制）
+
+## 🚀 快速开始
+
+```bash
+pnpm create karin
+```
+
+- 按提示选择“ts插件开发模板”即可自动初始化项目。
+- 进入新建的项目目录，继续开发。
+
+---
+
+## 详细开发流程
+
+1. **一键创建项目**
+
+   ```bash
+   pnpm create karin
+   ```
+
+   - 选择“ts插件开发模板”
+   - 填写你的插件名称（会自动作为 package.json 的 name）
+   - 其余信息按提示填写
+
+2. **安装依赖**
+
+   ```bash
+   pnpm install
+   ```
+
+3. **开发与调试**
+
+   - 启动开发命令：
+     ```bash
+     pnpm dev
+     ```
+   - 编写你的插件代码于 `src/` 目录。
+   - 编译输出：
+     ```bash
+     pnpm build
+     ```
+   - 调试编译之后的代码：
+     ```bash
+     pnpm app
+     ```
+   - 本地调试建议：
+     - 可用 `pnpm link --global` 进行全局软链测试。
+     - 或在 karin 根目录用 `pnpm add ../your-plugin-repo -w` 进行本地依赖测试。
+
+4. **配置 NPM 秘钥**
+
+   > 用于自动化发布，建议开启 2FA。
+
+   1. 注册 [npmjs](https://www.npmjs.com/) 账号。
+   2. 进入 `Access Tokens`，新建 `Classic Token`，类型选 `Automation`。
+   3. 复制生成的 Token。
+   4. 打开你的 GitHub 仓库 → Settings → Secrets and variables → Actions。
+   5. 新建 `NPM_TOKEN`，粘贴 Token。
+   6. 允许 GitHub Actions 创建和批准 PR（Settings → Actions）。
+
+5. **设置包信息**
+
+   > 包名必须唯一，建议先在 [npm](https://www.npmjs.com/) 搜索确认。
+
+   - 初始化时填写的插件名会自动作为 package.json 的 name，无需手动修改。
+   - 其他如 `author`、`description`、`homepage`、`bugs.url`、`repository` 可在 package.json 中补充完善。
+   - **CI 配置无需再手动修改 package-name，已自动同步。**
+
+6. **自动化发布**
+
+   > 推送代码后，GitHub Actions 会自动编译并发布到 npm。
+
+   - 常规开发流程：
+     1. `git add . && git commit -m "feat: ..." && git push`
+     2. 等待 CI 自动发布
+     3. 发布成功后可在 npm 页面看到新版本
+
+7. **安装与验证**
+
+   - 在 karin 根目录下安装你的插件：
+     ```bash
+     pnpm add your-package-name -w
+     ```
+   - 验证插件是否生效，可查看 karin 启动日志或相关功能。
+
+---
+
+## 💡 常见问题与建议
+
+- **Q: 发布失败怎么办？**
+  - 检查 NPM_TOKEN 是否配置正确，权限是否足够。
+  - 包名是否唯一，未被占用。
+  - Actions 日志可定位具体报错。
+- **Q: 如何本地调试插件？**
+  - 推荐用 `pnpm link` 或本地依赖安装。
+- **Q: 如何贡献代码？**
+  - 欢迎 PR，建议先提 issue 讨论。
+
+---
+
+## 贡献与反馈
+
+- 有任何建议或问题，欢迎在 [Issues](https://github.com/KarinJS/karin-plugin-template-ts/issues) 提出。
+- 也可加入官方交流群交流经验。

package/config/config.json

@@ -0,0 +1,20 @@
+{
+  "yiyanApi": "https://api.yujn.cn/api/sjyy.php",
+  "openlistBaseUrl": "http://127.0.0.1:5244",
+  "openlistUsername": "",
+  "openlistPassword": "",
+  "openlistTargetDir": "/",
+  "groupSyncDefaults": {
+    "mode": "incremental",
+    "flat": false,
+    "urlConcurrency": 3,
+    "transferConcurrency": 3,
+    "fileTimeoutSec": 600,
+    "retryTimes": 2,
+    "retryDelayMs": 1500,
+    "progressReportEvery": 10,
+    "downloadLimitKbps": 0,
+    "uploadLimitKbps": 0
+  },
+  "groupSyncTargets": []
+}

package/lib/apps/example.js

@@ -0,0 +1,41 @@
+// src/apps/example.ts
+import { karin, segment } from "node-karin";
+var hello = karin.command("^(#)?\u4F60\u597D$", async (e) => {
+  await e.reply("\u4F60\u597D\u554A\uFF01\u6211\u662FKarin\uFF0C\u5F88\u9AD8\u5174\u8BA4\u8BC6\u4F60~ (\u3002\u30FB\u2200\u30FB)\u30CE", { at: false, recallMsg: 0, reply: true });
+  return true;
+});
+var test = karin.command("^(#)?\u6D4B\u8BD5$", "\u8BA9\u6211\u6765\u5C55\u793A\u4E00\u4E0B\u6211\u7684\u529F\u80FD\u5427\uFF01\u2728");
+var text = karin.command("^(#)?\u6253\u62DB\u547C$", segment.text("\u5927\u5BB6\u597D\u5440\uFF01\u4ECA\u5929\u4E5F\u8981\u5143\u6C14\u6EE1\u6EE1\u54E6\uFF01\u2570(*\xB0\u25BD\xB0*)\u256F"), { name: "\u6253\u62DB\u547C" });
+var test2 = karin.command("^(#)?\u83DC\u5355$", "\u6765\u770B\u770B\u6211\u90FD\u4F1A\u4E9B\u4EC0\u4E48\u5427~\n- #\u4F60\u597D\uFF1A\u6253\u4E2A\u62DB\u547C\n- #\u6D4B\u8BD5\uFF1A\u529F\u80FD\u5C55\u793A\n- #\u6253\u62DB\u547C\uFF1A\u5143\u6C14\u95EE\u5019\n(\uFF61\uFF65\u03C9\uFF65\uFF61)\uFF89\u2661", {
+  event: "message",
+  // 监听的事件
+  name: "\u83DC\u5355",
+  // 插件名称
+  perm: "all",
+  // 触发权限
+  at: false,
+  // 是否加上at 仅在群聊中有效
+  reply: false,
+  // 是否加上引用回复
+  recallMsg: 0,
+  // 发送是否撤回消息 单位秒
+  log: true,
+  // 是否启用日志
+  rank: 1e4,
+  // 优先级
+  adapter: [],
+  // 生效的适配器
+  dsbAdapter: [],
+  // 禁用的适配器
+  delay: 0,
+  // 延迟回复 单位毫秒 仅在第二个参数非函数时有效
+  stop: false,
+  // 是否停止执行后续插件 仅在第二个参数非函数时有效
+  authFailMsg: "\u54CE\u5440\uFF0C\u8FD9\u4E2A\u529F\u80FD\u53EA\u6709\u4E3B\u4EBA\u624D\u80FD\u7528\u54E6\uFF01\u8981\u4E0D\u4F60\u5148\u8BB8\u4E2A\u613F\uFF1F(\u0E51\u2022\u0300\u3142\u2022\u0301)\u0648\u2727"
+});
+export {
+  hello,
+  test,
+  test2,
+  text
+};

package/lib/apps/groupFiles.js

@@ -0,0 +1,12 @@
+import {
+  exportGroupFiles,
+  syncGroupFilesToOpenList,
+  syncGroupFilesToOpenListCore
+} from "../chunk-QVWWPGHK.js";
+import "../chunk-5WVKHIPK.js";
+import "../chunk-IZS467MR.js";
+export {
+  exportGroupFiles,
+  syncGroupFilesToOpenList,
+  syncGroupFilesToOpenListCore
+};

package/lib/apps/groupSyncConfig.js

@@ -0,0 +1,398 @@
+import {
+  config
+} from "../chunk-5WVKHIPK.js";
+import {
+  dir
+} from "../chunk-IZS467MR.js";
+
+// src/apps/groupSyncConfig.ts
+import fs from "fs";
+import path from "path";
+import { karin, logger } from "node-karin";
+var readJsonSafe = (filePath) => {
+  try {
+    if (!fs.existsSync(filePath)) return {};
+    const raw = fs.readFileSync(filePath, "utf8");
+    return raw ? JSON.parse(raw) : {};
+  } catch (error) {
+    logger.error(error);
+    return {};
+  }
+};
+var writeJsonSafe = (filePath, data) => {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+  fs.writeFileSync(filePath, JSON.stringify(data, null, 2), "utf8");
+};
+var getConfigFilePath = () => path.join(dir.ConfigDir, "config.json");
+var getDefaultConfigPath = () => path.join(dir.defConfigDir, "config.json");
+var normalizePosixPath = (inputPath, { ensureLeadingSlash = true, stripTrailingSlash = true } = {}) => {
+  let value = String(inputPath ?? "").trim().replaceAll("\\", "/");
+  value = value.replace(/\/+/g, "/");
+  if (!value) value = "/";
+  if (ensureLeadingSlash && !value.startsWith("/")) value = `/${value}`;
+  if (stripTrailingSlash && value.length > 1) value = value.replace(/\/+$/, "");
+  return value;
+};
+var parseBoolean = (value) => {
+  const v = String(value ?? "").trim().toLowerCase();
+  if (!v) return void 0;
+  if (["1", "true", "yes", "y", "on", "\u5F00\u542F", "\u5F00", "\u662F"].includes(v)) return true;
+  if (["0", "false", "no", "n", "off", "\u5173\u95ED", "\u5173", "\u5426"].includes(v)) return false;
+  return void 0;
+};
+var parseIntSafe = (value) => {
+  if (value == null) return void 0;
+  const n = Number(value);
+  if (!Number.isFinite(n)) return void 0;
+  return Math.floor(n);
+};
+var parseMode = (value) => {
+  const v = String(value ?? "").trim().toLowerCase();
+  if (!v) return void 0;
+  if (v === "full" || v === "\u5168\u91CF") return "full";
+  if (v === "incremental" || v === "\u589E\u91CF") return "incremental";
+  return void 0;
+};
+var formatTargetLine = (t) => {
+  const mode = t.mode ?? "-";
+  const enabled = t.enabled ?? true ? "\u542F\u7528" : "\u505C\u7528";
+  const cron = t.schedule?.enabled ? t.schedule?.cron || "(\u672A\u586Bcron)" : "\u5173\u95ED";
+  const targetDir = t.targetDir ? t.targetDir : "(\u9ED8\u8BA4)";
+  return `- ${t.groupId} | ${enabled} | ${mode} | \u8BA1\u5212:${cron} | \u76EE\u5F55:${targetDir}`;
+};
+var upsertTarget = (cfg, groupId, patch) => {
+  const list = getTargets(cfg);
+  const next = [...list];
+  const index = next.findIndex((it) => String(it.groupId) === String(groupId));
+  const base = index >= 0 ? next[index] : ensureTargetWithDefaults(groupId, cfg);
+  const merged = {
+    ...base,
+    ...patch,
+    groupId: String(groupId)
+  };
+  if (index >= 0) next[index] = merged;
+  else next.push(merged);
+  return next;
+};
+var ensureTargetWithDefaults = (groupId, cfg) => {
+  const defaults = cfg.groupSyncDefaults ?? {};
+  const baseTargetDir = normalizePosixPath(String(cfg.openlistTargetDir ?? "/"));
+  return {
+    groupId,
+    enabled: true,
+    mode: defaults.mode === "full" ? "full" : "incremental",
+    flat: Boolean(defaults.flat ?? false),
+    urlConcurrency: parseIntSafe(String(defaults.urlConcurrency ?? "")) ?? 3,
+    transferConcurrency: parseIntSafe(String(defaults.transferConcurrency ?? "")) ?? 3,
+    fileTimeoutSec: parseIntSafe(String(defaults.fileTimeoutSec ?? "")) ?? 600,
+    retryTimes: parseIntSafe(String(defaults.retryTimes ?? "")) ?? 2,
+    retryDelayMs: parseIntSafe(String(defaults.retryDelayMs ?? "")) ?? 1500,
+    targetDir: normalizePosixPath(path.posix.join(baseTargetDir, String(groupId))),
+    schedule: { enabled: false, cron: "" }
+  };
+};
+var updateConfigFile = (updater) => {
+  const configPath = getConfigFilePath();
+  const current = readJsonSafe(configPath);
+  const def = readJsonSafe(getDefaultConfigPath());
+  const merged = { ...def, ...current };
+  const next = updater({ ...merged });
+  writeJsonSafe(configPath, next);
+  return next;
+};
+var getTargets = (cfg) => {
+  const list = cfg?.groupSyncTargets;
+  return Array.isArray(list) ? list : [];
+};
+var cfgHelp = [
+  "\u7FA4\u540C\u6B65\u914D\u7F6E\u7528\u6CD5\uFF08\u5EFA\u8BAE\u5728 WebUI \u914D\u7F6E\u66F4\u5B8C\u6574\uFF09\uFF1A",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E \u5217\u8868",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u67E5\u770B",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u6DFB\u52A0",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u5220\u9664",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u542F\u7528 / \u505C\u7528",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u6A21\u5F0F \u5168\u91CF|\u589E\u91CF",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u76EE\u5F55 /\u6302\u8F7D/QQ\u7FA4\u6587\u4EF6/123456",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u5E73\u94FA \u5F00|\u5173",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u5E76\u53D1 <n>\uFF08\u4E0B\u8F7D/\u4E0A\u4F20\u5E76\u53D1\uFF09",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> url\u5E76\u53D1 <n>\uFF08\u89E3\u6790URL\u5E76\u53D1\uFF09",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u8D85\u65F6 <sec>\uFF08\u5355\u6587\u4EF6\u8D85\u65F6\uFF09",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u91CD\u8BD5 <n>",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u65F6\u6BB5 00:00-06:00,23:00-23:59\uFF08\u7A7A=\u4E0D\u9650\u5236\uFF09",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u8BA1\u5212 <cron>\uFF08\u4F8B\uFF1A0 0 3 * * *\uFF09",
+  "- #\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u8BA1\u5212 \u5F00\u542F|\u5173\u95ED"
+].join("\n");
+var groupSyncConfig = karin.command(/^#?(群同步配置|同步群配置|群文件同步配置)(.*)$/i, async (e) => {
+  const raw = e.msg.replace(/^#?(群同步配置|同步群配置|群文件同步配置)/i, "").trim();
+  if (!raw || /^(help|帮助|\?)$/i.test(raw)) {
+    await e.reply(cfgHelp);
+    return true;
+  }
+  const tokens = raw.split(/\s+/).filter(Boolean);
+  const first = tokens[0]?.toLowerCase();
+  const isList = ["\u5217\u8868", "list", "ls"].includes(first);
+  if (isList) {
+    const cfg = config();
+    const targets = getTargets(cfg);
+    if (!targets.length) {
+      await e.reply("\u5F53\u524D\u6CA1\u6709\u914D\u7F6E\u4EFB\u4F55\u540C\u6B65\u76EE\u6807\u7FA4\u3002\u53EF\u5728 WebUI \u6216\u7528\uFF1A#\u7FA4\u540C\u6B65\u914D\u7F6E <\u7FA4\u53F7> \u6DFB\u52A0");
+      return true;
+    }
+    const lines = targets.map(formatTargetLine);
+    await e.reply(["\u540C\u6B65\u76EE\u6807\u7FA4\u5217\u8868\uFF1A", ...lines].join("\n"));
+    return true;
+  }
+  const actionWords = /* @__PURE__ */ new Map([
+    ["\u67E5\u770B", "show"],
+    ["\u8BE6\u60C5", "show"],
+    ["show", "show"],
+    ["get", "show"],
+    ["\u6DFB\u52A0", "add"],
+    ["\u65B0\u589E", "add"],
+    ["add", "add"],
+    ["create", "add"],
+    ["\u5220\u9664", "remove"],
+    ["\u79FB\u9664", "remove"],
+    ["remove", "remove"],
+    ["del", "remove"],
+    ["delete", "remove"],
+    ["\u542F\u7528", "enable"],
+    ["\u5F00\u542F", "enable"],
+    ["enable", "enable"],
+    ["on", "enable"],
+    ["\u505C\u7528", "disable"],
+    ["\u5173\u95ED", "disable"],
+    ["disable", "disable"],
+    ["off", "disable"],
+    ["\u6A21\u5F0F", "mode"],
+    ["\u7B56\u7565", "mode"],
+    ["mode", "mode"],
+    ["\u76EE\u5F55", "dir"],
+    ["\u76EE\u6807\u76EE\u5F55", "dir"],
+    ["dir", "dir"],
+    ["to", "dir"],
+    ["\u5E73\u94FA", "flat"],
+    ["flat", "flat"],
+    ["\u5E76\u53D1", "concurrency"],
+    ["\u7EBF\u7A0B", "concurrency"],
+    ["concurrency", "concurrency"],
+    ["threads", "concurrency"],
+    ["url\u5E76\u53D1", "urlConcurrency"],
+    ["url\u7EBF\u7A0B", "urlConcurrency"],
+    ["urlconcurrency", "urlConcurrency"],
+    ["\u8D85\u65F6", "timeout"],
+    ["timeout", "timeout"],
+    ["\u91CD\u8BD5", "retry"],
+    ["retry", "retry"],
+    ["\u65F6\u6BB5", "timeWindows"],
+    ["\u65F6\u95F4\u7A97", "timeWindows"],
+    ["time", "timeWindows"],
+    ["window", "timeWindows"],
+    ["\u8BA1\u5212", "schedule"],
+    ["\u5B9A\u65F6", "schedule"],
+    ["cron", "schedule"],
+    ["schedule", "schedule"]
+  ]);
+  let actionToken;
+  let groupId;
+  let rest = [];
+  if (/^\d+$/.test(tokens[0] ?? "")) {
+    groupId = tokens[0];
+    actionToken = tokens[1];
+    rest = tokens.slice(2);
+  } else if (actionWords.has(tokens[0] ?? "") && /^\d+$/.test(tokens[1] ?? "")) {
+    actionToken = tokens[0];
+    groupId = tokens[1];
+    rest = tokens.slice(2);
+  } else if (e.isGroup && actionWords.has(tokens[0] ?? "")) {
+    groupId = e.groupId;
+    actionToken = tokens[0];
+    rest = tokens.slice(1);
+  } else if (e.isGroup && /^\d+$/.test(tokens[0] ?? "") === false) {
+    groupId = e.groupId;
+    actionToken = tokens[0];
+    rest = tokens.slice(1);
+  }
+  if (!groupId || !/^\d+$/.test(groupId)) {
+    await e.reply(`\u7F3A\u5C11\u7FA4\u53F7\u53C2\u6570\u3002
+
+${cfgHelp}`);
+    return true;
+  }
+  const action = actionWords.get(actionToken ?? "") ?? "";
+  if (!action) {
+    await e.reply(`\u672A\u77E5\u64CD\u4F5C\uFF1A${actionToken ?? ""}
+
+${cfgHelp}`);
+    return true;
+  }
+  if (action === "show") {
+    const cfg = config();
+    const t = getTargets(cfg).find((it) => String(it.groupId) === String(groupId));
+    if (!t) {
+      await e.reply(`\u672A\u627E\u5230\u7FA4 ${groupId} \u7684\u914D\u7F6E\uFF0C\u53EF\u5148\u6DFB\u52A0\uFF1A#\u7FA4\u540C\u6B65\u914D\u7F6E ${groupId} \u6DFB\u52A0`);
+      return true;
+    }
+    await e.reply(["\u7FA4\u540C\u6B65\u914D\u7F6E\uFF1A", formatTargetLine(t), `
+\u5B8C\u6574\u914D\u7F6E\u6587\u4EF6\uFF1A${getConfigFilePath()}`].join("\n"));
+    return true;
+  }
+  if (action === "add") {
+    const cfg = config();
+    const defaultsTarget = ensureTargetWithDefaults(groupId, cfg);
+    updateConfigFile((next) => {
+      const list = getTargets(next);
+      if (list.some((it) => String(it.groupId) === String(groupId))) return next;
+      next.groupSyncTargets = [...list, defaultsTarget];
+      return next;
+    });
+    await e.reply(`\u5DF2\u6DFB\u52A0\u7FA4 ${groupId} \u7684\u540C\u6B65\u914D\u7F6E\uFF08\u9ED8\u8BA4\u542F\u7528\uFF09\u3002`);
+    return true;
+  }
+  if (action === "remove") {
+    const before = config();
+    const beforeList = getTargets(before);
+    if (!beforeList.some((it) => String(it.groupId) === String(groupId))) {
+      await e.reply(`\u7FA4 ${groupId} \u672A\u914D\u7F6E\uFF0C\u65E0\u9700\u5220\u9664\u3002`);
+      return true;
+    }
+    updateConfigFile((next) => {
+      next.groupSyncTargets = getTargets(next).filter((it) => String(it.groupId) !== String(groupId));
+      return next;
+    });
+    await e.reply(`\u5DF2\u5220\u9664\u7FA4 ${groupId} \u7684\u540C\u6B65\u914D\u7F6E\u3002`);
+    return true;
+  }
+  if (action === "enable" || action === "disable") {
+    const enabled = action === "enable";
+    updateConfigFile((next) => {
+      next.groupSyncTargets = upsertTarget(next, groupId, { enabled });
+      return next;
+    });
+    await e.reply(`\u7FA4 ${groupId} \u5DF2${enabled ? "\u542F\u7528" : "\u505C\u7528"}\u81EA\u52A8\u540C\u6B65\u3002`);
+    return true;
+  }
+  if (action === "mode") {
+    const mode = parseMode(rest[0]);
+    if (!mode) {
+      await e.reply("\u6A21\u5F0F\u53C2\u6570\u9519\u8BEF\uFF0C\u8BF7\u4F7F\u7528\uFF1A\u5168\u91CF/\u589E\u91CF \u6216 full/incremental");
+      return true;
+    }
+    updateConfigFile((next) => {
+      next.groupSyncTargets = upsertTarget(next, groupId, { mode });
+      return next;
+    });
+    await e.reply(`\u7FA4 ${groupId} \u540C\u6B65\u6A21\u5F0F\u5DF2\u8BBE\u7F6E\u4E3A\uFF1A${mode === "full" ? "\u5168\u91CF" : "\u589E\u91CF"}`);
+    return true;
+  }
+  if (action === "dir") {
+    const dirValue = normalizePosixPath(rest.join(" ").trim() || "");
+    if (!dirValue || dirValue === "/") {
+      await e.reply("\u76EE\u5F55\u53C2\u6570\u4E3A\u7A7A\u6216\u975E\u6CD5\u3002");
+      return true;
+    }
+    updateConfigFile((next) => {
+      next.groupSyncTargets = upsertTarget(next, groupId, { targetDir: dirValue });
+      return next;
+    });
+    await e.reply(`\u7FA4 ${groupId} \u76EE\u6807\u76EE\u5F55\u5DF2\u8BBE\u7F6E\u4E3A\uFF1A${dirValue}`);
+    return true;
+  }
+  if (action === "flat") {
+    const bool = parseBoolean(rest[0]);
+    if (typeof bool === "undefined") {
+      await e.reply("\u5E73\u94FA\u53C2\u6570\u9519\u8BEF\uFF0C\u8BF7\u4F7F\u7528\uFF1A\u5F00/\u5173 \u6216 true/false");
+      return true;
+    }
+    updateConfigFile((next) => {
+      next.groupSyncTargets = upsertTarget(next, groupId, { flat: bool });
+      return next;
+    });
+    await e.reply(`\u7FA4 ${groupId} \u5E73\u94FA\u4E0A\u4F20\u5DF2\u8BBE\u7F6E\u4E3A\uFF1A${bool ? "\u5F00" : "\u5173"}`);
+    return true;
+  }
+  if (action === "concurrency" || action === "urlConcurrency") {
+    const value = parseIntSafe(rest[0]);
+    if (!value || value <= 0) {
+      await e.reply("\u5E76\u53D1\u53C2\u6570\u9519\u8BEF\uFF0C\u8BF7\u8F93\u5165\u5927\u4E8E0\u7684\u6574\u6570\u3002");
+      return true;
+    }
+    const patch = action === "concurrency" ? { transferConcurrency: value } : { urlConcurrency: value };
+    updateConfigFile((next) => {
+      next.groupSyncTargets = upsertTarget(next, groupId, patch);
+      return next;
+    });
+    await e.reply(`\u7FA4 ${groupId} \u5DF2\u8BBE\u7F6E${action === "concurrency" ? "\u4E0B\u8F7D/\u4E0A\u4F20" : "\u89E3\u6790URL"}\u5E76\u53D1\uFF1A${value}`);
+    return true;
+  }
+  if (action === "timeout") {
+    const sec = parseIntSafe(rest[0]);
+    if (!sec || sec <= 0) {
+      await e.reply("\u8D85\u65F6\u53C2\u6570\u9519\u8BEF\uFF0C\u8BF7\u8F93\u5165\u5927\u4E8E0\u7684\u6574\u6570\uFF08\u79D2\uFF09\u3002");
+      return true;
+    }
+    const capped = Math.min(3e3, sec);
+    updateConfigFile((next) => {
+      next.groupSyncTargets = upsertTarget(next, groupId, { fileTimeoutSec: capped });
+      return next;
+    });
+    await e.reply(`\u7FA4 ${groupId} \u5355\u6587\u4EF6\u8D85\u65F6\u5DF2\u8BBE\u7F6E\u4E3A\uFF1A${capped}s${sec !== capped ? "\uFF08\u5DF2\u6309\u4E0A\u96503000s\u622A\u65AD\uFF09" : ""}`);
+    return true;
+  }
+  if (action === "retry") {
+    const n = parseIntSafe(rest[0]);
+    if (typeof n === "undefined" || n < 0) {
+      await e.reply("\u91CD\u8BD5\u6B21\u6570\u53C2\u6570\u9519\u8BEF\uFF0C\u8BF7\u8F93\u5165 >=0 \u7684\u6574\u6570\u3002");
+      return true;
+    }
+    updateConfigFile((next) => {
+      next.groupSyncTargets = upsertTarget(next, groupId, { retryTimes: n });
+      return next;
+    });
+    await e.reply(`\u7FA4 ${groupId} \u91CD\u8BD5\u6B21\u6570\u5DF2\u8BBE\u7F6E\u4E3A\uFF1A${n}`);
+    return true;
+  }
+  if (action === "timeWindows") {
+    const win = rest.join(" ").trim();
+    updateConfigFile((next) => {
+      next.groupSyncTargets = upsertTarget(next, groupId, { timeWindows: win });
+      return next;
+    });
+    await e.reply(`\u7FA4 ${groupId} \u540C\u6B65\u65F6\u6BB5\u5DF2\u8BBE\u7F6E\u4E3A\uFF1A${win || "(\u4E0D\u9650\u5236)"}`);
+    return true;
+  }
+  if (action === "schedule") {
+    const value = rest.join(" ").trim();
+    const bool = parseBoolean(rest[0]);
+    const cron = bool == null ? value : "";
+    if (!value) {
+      await e.reply("\u8BA1\u5212\u53C2\u6570\u4E0D\u80FD\u4E3A\u7A7A\u3002");
+      return true;
+    }
+    updateConfigFile((next) => {
+      const existing = getTargets(next).find((it) => String(it.groupId) === String(groupId));
+      const base = existing ?? ensureTargetWithDefaults(groupId, next);
+      const schedule = { ...base.schedule ?? {} };
+      if (typeof bool === "boolean") {
+        schedule.enabled = bool;
+      } else {
+        schedule.cron = cron;
+        schedule.enabled = true;
+      }
+      next.groupSyncTargets = upsertTarget(next, groupId, { schedule });
+      return next;
+    });
+    await e.reply(`\u7FA4 ${groupId} \u5B9A\u65F6\u8BA1\u5212\u5DF2\u66F4\u65B0\uFF1A${value}`);
+    return true;
+  }
+  await e.reply(cfgHelp);
+  return true;
+}, {
+  name: "\u7FA4\u540C\u6B65\u914D\u7F6E",
+  log: true,
+  priority: 9999,
+  permission: "master"
+});
+export {
+  groupSyncConfig
+};