koishi-plugin-best-cave 2.0.9 → 2.1.0

package/lib/Utils.d.ts

@@ -39,11 +39,6 @@ export declare function getScopeQuery(session: Session, config: Config): object;
  * @performance 在大数据集下，此函数可能存在性能瓶颈，因为它需要获取所有现有ID。
  */
 export declare function getNextCaveId(ctx: Context, query?: object): Promise<number>;
-/**
- * @description 下载网络媒体资源并保存到文件存储中。
- * @returns 保存后的文件名/标识符。
- */
-export declare function downloadMedia(ctx: Context, fileManager: FileManager, url: string, originalName: string, type: string, caveId: number, index: number, channelId: string, userId: string): Promise<string>;
 /**
  * @description 检查用户是否处于指令冷却中。
  * @returns 若在冷却中则返回提示字符串，否则返回 null。

package/lib/index.js

@@ -102,7 +102,6 @@ var FileManager = class {
         Key: fileName,
         Body: data,
         ACL: "public-read"
-        // 默认为公开可读
       });
       await this.s3Client.send(command);
     } else {
@@ -135,22 +134,18 @@ var FileManager = class {
    * @param fileIdentifier 要删除的文件名/标识符。
    */
   async deleteFile(fileIdentifier) {
-    if (this.s3Client) {
-      const command = new import_client_s3.DeleteObjectCommand({ Bucket: this.s3Bucket, Key: fileIdentifier });
-      await this.s3Client.send(command).catch((err) => {
-        this.logger.warn(`删除 S3 文件 ${fileIdentifier} 失败:`, err);
-      });
-    } else {
-      const filePath = path.join(this.resourceDir, fileIdentifier);
-      await this.withLock(filePath, async () => {
-        try {
-          await fs.unlink(filePath);
-        } catch (error) {
-          if (error.code !== "ENOENT") {
-            this.logger.warn(`删除本地文件 ${filePath} 失败:`, error);
-          }
-        }
-      });
+    try {
+      if (this.s3Client) {
+        const command = new import_client_s3.DeleteObjectCommand({ Bucket: this.s3Bucket, Key: fileIdentifier });
+        await this.s3Client.send(command);
+      } else {
+        const filePath = path.join(this.resourceDir, fileIdentifier);
+        await this.withLock(filePath, () => fs.unlink(filePath));
+      }
+    } catch (error) {
+      if (error.code !== "ENOENT" && error.name !== "NoSuchKey") {
+        this.logger.warn(`删除文件 ${fileIdentifier} 失败:`, error);
+      }
     }
   }
 };
@@ -186,10 +181,9 @@ var ProfileManager = class {
       if (trimmedNickname) {
         await this.setNickname(session.userId, trimmedNickname);
         return `昵称已更新为：${trimmedNickname}`;
-      } else {
-        await this.clearNickname(session.userId);
-        return "昵称已清除";
       }
+      await this.clearNickname(session.userId);
+      return "昵称已清除";
     });
   }
   /**
@@ -206,8 +200,8 @@ var ProfileManager = class {
    * @returns 返回用户的昵称字符串，如果未设置则返回 null。
    */
   async getNickname(userId) {
-    const profile = await this.ctx.database.get("cave_user", { userId });
-    return profile[0]?.nickname ?? null;
+    const [profile] = await this.ctx.database.get("cave_user", { userId }, { fields: ["nickname"] });
+    return profile?.nickname ?? null;
   }
   /**
    * @description 清除指定用户的昵称设置。
@@ -237,35 +231,28 @@ async function buildCaveMessage(cave, config, fileManager, logger2) {
     const fileName = element.attrs.src;
     if (!isMedia || !fileName) return element;
     if (config.enableS3 && config.publicUrl) {
-      const fullUrl = config.publicUrl.endsWith("/") ? `${config.publicUrl}${fileName}` : `${config.publicUrl}/${fileName}`;
+      const fullUrl = new URL(fileName, config.publicUrl).href;
       return (0, import_koishi.h)(element.type, { ...element.attrs, src: fullUrl });
     }
     if (config.localPath) {
-      const fileUri = `file://${path2.join(config.localPath, fileName)}`;
-      return (0, import_koishi.h)(element.type, { ...element.attrs, src: fileUri });
+      return (0, import_koishi.h)(element.type, { ...element.attrs, src: `file://${path2.join(config.localPath, fileName)}` });
     }
     try {
       const data = await fileManager.readFile(fileName);
-      const ext = path2.extname(fileName).toLowerCase();
-      const mimeType = mimeTypeMap[ext] || "application/octet-stream";
+      const mimeType = mimeTypeMap[path2.extname(fileName).toLowerCase()] || "application/octet-stream";
       return (0, import_koishi.h)(element.type, { ...element.attrs, src: `data:${mimeType};base64,${data.toString("base64")}` });
     } catch (error) {
       logger2.warn(`转换文件 ${fileName} 为 Base64 失败:`, error);
       return (0, import_koishi.h)("p", {}, `[${element.type}]`);
     }
   }));
-  const finalMessage = [];
-  const [headerFormat, footerFormat = ""] = config.caveFormat.split("|");
   const replacements = { id: cave.id.toString(), name: cave.userName };
-  const headerText = headerFormat.replace(/\{id\}|\{name\}/g, (match) => replacements[match.slice(1, -1)]);
-  if (headerText.trim()) {
-    finalMessage.push(headerText.trim() + "\n");
-  }
+  const formatPart = /* @__PURE__ */ __name((part) => part.replace(/\{id\}|\{name\}/g, (match) => replacements[match.slice(1, -1)]).trim(), "formatPart");
+  const [header, footer] = config.caveFormat.split("|", 2).map(formatPart);
+  const finalMessage = [];
+  if (header) finalMessage.push(header + "\n");
   finalMessage.push(...processedElements);
-  const footerText = footerFormat.replace(/\{id\}|\{name\}/g, (match) => replacements[match.slice(1, -1)]);
-  if (footerText.trim()) {
-    finalMessage.push("\n" + footerText.trim());
-  }
+  if (footer) finalMessage.push("\n" + footer);
   return finalMessage;
 }
 __name(buildCaveMessage, "buildCaveMessage");
@@ -300,11 +287,10 @@ async function getNextCaveId(ctx, query = {}) {
 __name(getNextCaveId, "getNextCaveId");
 function checkCooldown(session, config, lastUsed) {
   if (config.coolDown <= 0 || !session.channelId) return null;
-  const now = Date.now();
   const lastTime = lastUsed.get(session.channelId) || 0;
-  if (now - lastTime < config.coolDown * 1e3) {
-    const waitTime = Math.ceil((config.coolDown * 1e3 - (now - lastTime)) / 1e3);
-    return `指令冷却中，请在 ${waitTime} 秒后重试`;
+  const remainingTime = lastTime + config.coolDown * 1e3 - Date.now();
+  if (remainingTime > 0) {
+    return `指令冷却中，请在 ${Math.ceil(remainingTime / 1e3)} 秒后重试`;
   }
   return null;
 }
@@ -327,31 +313,25 @@ async function processMessageElements(sourceElements, newId, channelId, userId)
     "file": "file",
     "text": "text"
   };
+  const defaultExtMap = { "image": ".jpg", "video": ".mp4", "audio": ".mp3", "file": ".dat" };
   async function traverse(elements) {
     for (const el of elements) {
       const normalizedType = typeMap[el.type];
-      if (!normalizedType) {
-        if (el.children) await traverse(el.children);
-        continue;
-      }
-      if (["image", "video", "audio", "file"].includes(normalizedType) && el.attrs.src) {
-        let fileIdentifier = el.attrs.src;
-        if (fileIdentifier.startsWith("http")) {
-          mediaIndex++;
-          const defaultExtMap = { "image": ".jpg", "video": ".mp4", "audio": ".mp3", "file": ".dat" };
-          const ext = el.attrs.file && path2.extname(el.attrs.file) ? path2.extname(el.attrs.file) : defaultExtMap[normalizedType] || ".dat";
-          const channelIdentifier = channelId || "private";
-          const fileName = `${newId}_${mediaIndex}_${channelIdentifier}_${userId}${ext}`;
-          mediaToSave.push({ sourceUrl: fileIdentifier, fileName });
-          fileIdentifier = fileName;
+      if (normalizedType) {
+        if (["image", "video", "audio", "file"].includes(normalizedType) && el.attrs.src) {
+          let fileIdentifier = el.attrs.src;
+          if (fileIdentifier.startsWith("http")) {
+            const ext = path2.extname(el.attrs.file || "") || defaultExtMap[normalizedType];
+            const fileName = `${newId}_${++mediaIndex}_${channelId || "private"}_${userId}${ext}`;
+            mediaToSave.push({ sourceUrl: fileIdentifier, fileName });
+            fileIdentifier = fileName;
+          }
+          finalElementsForDb.push({ type: normalizedType, file: fileIdentifier });
+        } else if (normalizedType === "text" && el.attrs.content?.trim()) {
+          finalElementsForDb.push({ type: "text", content: el.attrs.content.trim() });
         }
-        finalElementsForDb.push({ type: normalizedType, file: fileIdentifier });
-      } else if (normalizedType === "text" && el.attrs.content?.trim()) {
-        finalElementsForDb.push({ type: "text", content: el.attrs.content.trim() });
-      }
-      if (el.children) {
-        await traverse(el.children);
       }
+      if (el.children) await traverse(el.children);
     }
   }
   __name(traverse, "traverse");
@@ -361,10 +341,11 @@ async function processMessageElements(sourceElements, newId, channelId, userId)
 __name(processMessageElements, "processMessageElements");
 async function handleFileUploads(ctx, config, fileManager, logger2, reviewManager, cave, mediaToSave) {
   try {
-    await Promise.all(mediaToSave.map(async (media) => {
+    const uploadPromises = mediaToSave.map(async (media) => {
       const response = await ctx.http.get(media.sourceUrl, { responseType: "arraybuffer", timeout: 3e4 });
       await fileManager.saveFile(media.fileName, Buffer.from(response));
-    }));
+    });
+    await Promise.all(uploadPromises);
     const finalStatus = config.enableReview ? "pending" : "active";
     await ctx.database.upsert("cave", [{ id: cave.id, status: finalStatus }]);
     if (finalStatus === "pending" && reviewManager) {
@@ -374,7 +355,7 @@ async function handleFileUploads(ctx, config, fileManager, logger2, reviewManage
   } catch (fileSaveError) {
     logger2.error(`回声洞（${cave.id}）文件保存失败:`, fileSaveError);
     await ctx.database.upsert("cave", [{ id: cave.id, status: "delete" }]);
-    await cleanupPendingDeletions(ctx, fileManager, logger2);
+    cleanupPendingDeletions(ctx, fileManager, logger2);
   }
 }
 __name(handleFileUploads, "handleFileUploads");
@@ -402,28 +383,19 @@ var DataManager = class {
    * @param cave - 主 `cave` 命令实例。
    */
   registerCommands(cave) {
-    cave.subcommand(".export", "导出回声洞数据").usage("将所有回声洞数据导出到 cave_export.json。").action(async ({ session }) => {
-      const adminChannelId = this.config.adminChannel ? this.config.adminChannel.split(":")[1] : null;
-      if (session.channelId !== adminChannelId) return "此指令仅限在管理群组中使用";
-      try {
-        await session.send("正在导出数据，请稍候...");
-        return await this.exportData();
-      } catch (error) {
-        this.logger.error("导出数据时发生错误:", error);
-        return `导出失败: ${error.message}`;
-      }
-    });
-    cave.subcommand(".import", "导入回声洞数据").usage("从 cave_import.json 中导入回声洞数据。").action(async ({ session }) => {
-      const adminChannelId = this.config.adminChannel ? this.config.adminChannel.split(":")[1] : null;
+    const requireAdmin = /* @__PURE__ */ __name((action) => async ({ session }) => {
+      const adminChannelId = this.config.adminChannel?.split(":")[1];
       if (session.channelId !== adminChannelId) return "此指令仅限在管理群组中使用";
       try {
-        await session.send("正在导入数据，请稍候...");
-        return await this.importData();
+        await session.send("正在处理，请稍候...");
+        return await action();
       } catch (error) {
-        this.logger.error("导入数据时发生错误:", error);
-        return `导入失败: ${error.message}`;
+        this.logger.error("数据操作时发生错误:", error);
+        return `操作失败: ${error.message || "未知错误"}`;
       }
-    });
+    }, "requireAdmin");
+    cave.subcommand(".export", "导出回声洞数据").usage("将所有回声洞数据导出到 cave_export.json。").action(requireAdmin(() => this.exportData()));
+    cave.subcommand(".import", "导入回声洞数据").usage("从 cave_import.json 中导入回声洞数据。").action(requireAdmin(() => this.importData()));
   }
   /**
    * @description 导出所有 'active' 状态的回声洞数据到 `cave_export.json`。
@@ -450,17 +422,12 @@ var DataManager = class {
       if (!Array.isArray(importedCaves)) throw new Error("导入文件格式无效");
     } catch (error) {
       this.logger.error(`读取导入文件失败:`, error);
-      return `读取导入文件失败: ${error.message || "未知错误"}`;
+      throw new Error(`读取导入文件失败: ${error.message || "未知错误"}`);
     }
     let successCount = 0;
     for (const cave of importedCaves) {
       const newId = await getNextCaveId(this.ctx, {});
-      const newCave = {
-        ...cave,
-        id: newId,
-        channelId: cave.channelId,
-        status: "active"
-      };
+      const newCave = { ...cave, id: newId, status: "active" };
       await this.ctx.database.create("cave", newCave);
       successCount++;
     }
@@ -493,27 +460,29 @@ var ReviewManager = class {
    */
   registerCommands(cave) {
     cave.subcommand(".review [id:posint] [action:string]", "审核回声洞").usage("查看或审核回声洞，使用 <Y/N> 进行审核。").action(async ({ session }, id, action) => {
-      const adminChannelId = this.config.adminChannel ? this.config.adminChannel.split(":")[1] : null;
+      const adminChannelId = this.config.adminChannel?.split(":")[1];
       if (session.channelId !== adminChannelId) return "此指令仅限在管理群组中使用";
       if (!id) {
-        const pendingCaves = await this.ctx.database.get("cave", { status: "pending" });
-        if (pendingCaves.length === 0) return "当前没有需要审核的回声洞";
+        const pendingCaves = await this.ctx.database.get("cave", { status: "pending" }, { fields: ["id"] });
+        if (!pendingCaves.length) return "当前没有需要审核的回声洞";
         return `当前共有 ${pendingCaves.length} 条待审核回声洞，序号为：
 ${pendingCaves.map((c) => c.id).join(", ")}`;
       }
       const [targetCave] = await this.ctx.database.get("cave", { id });
       if (!targetCave) return `回声洞（${id}）不存在`;
       if (targetCave.status !== "pending") return `回声洞（${id}）无需审核`;
-      if (id && !action) {
+      if (!action) {
         return [`待审核：`, ...await buildCaveMessage(targetCave, this.config, this.fileManager, this.logger)];
       }
       const normalizedAction = action.toLowerCase();
-      let reviewAction;
-      if (["y", "yes", "ok", "pass", "approve"].includes(normalizedAction)) reviewAction = "approve";
-      else if (["n", "no", "deny", "reject"].includes(normalizedAction)) reviewAction = "reject";
-      else return `无效操作: "${action}"
+      if (["y", "yes", "pass", "approve"].includes(normalizedAction)) {
+        return this.processReview("approve", id);
+      }
+      if (["n", "no", "deny", "reject"].includes(normalizedAction)) {
+        return this.processReview("reject", id);
+      }
+      return `无效操作: "${action}"
 请使用 "Y" (通过) 或 "N" (拒绝)`;
-      return this.processReview(reviewAction, id);
     });
   }
   /**
@@ -521,14 +490,13 @@ ${pendingCaves.map((c) => c.id).join(", ")}`;
    * @param cave 新创建的、状态为 'pending' 的回声洞对象。
    */
   async sendForReview(cave) {
-    const channelParts = this.config.adminChannel?.split(":");
-    if (!channelParts || channelParts.length < 2 || !channelParts[1]) {
+    if (!this.config.adminChannel?.includes(":")) {
       this.logger.warn(`管理群组配置无效，已自动通过回声洞（${cave.id}）`);
       await this.ctx.database.upsert("cave", [{ id: cave.id, status: "active" }]);
       return;
     }
-    const reviewMessage = [`待审核：`, ...await buildCaveMessage(cave, this.config, this.fileManager, this.logger)];
     try {
+      const reviewMessage = [`待审核：`, ...await buildCaveMessage(cave, this.config, this.fileManager, this.logger)];
       await this.ctx.broadcast([this.config.adminChannel], import_koishi2.h.normalize(reviewMessage));
     } catch (error) {
       this.logger.error(`发送回声洞（${cave.id}）审核消息失败:`, error);
@@ -543,16 +511,14 @@ ${pendingCaves.map((c) => c.id).join(", ")}`;
   async processReview(action, caveId) {
     const [cave] = await this.ctx.database.get("cave", { id: caveId, status: "pending" });
     if (!cave) return `回声洞（${caveId}）无需审核`;
-    let resultMessage;
     if (action === "approve") {
       await this.ctx.database.upsert("cave", [{ id: caveId, status: "active" }]);
-      resultMessage = `回声洞（${caveId}）已通过`;
+      return `回声洞（${caveId}）已通过`;
     } else {
       await this.ctx.database.upsert("cave", [{ id: caveId, status: "delete" }]);
-      resultMessage = `回声洞（${caveId}）已拒绝`;
       cleanupPendingDeletions(this.ctx, this.fileManager, this.logger);
+      return `回声洞（${caveId}）已拒绝`;
     }
-    return resultMessage;
   }
 };
 
@@ -607,10 +573,10 @@ function apply(ctx, config) {
   }, { primary: "id" });
   const fileManager = new FileManager(ctx.baseDir, config, logger);
   const lastUsed = /* @__PURE__ */ new Map();
-  let profileManager;
-  let dataManager;
-  let reviewManager;
-  const cave = ctx.command("cave", "回声洞").option("add", "-a <content:text> 添加回声洞").option("view", "-g <id:posint> 查看指定回声洞").option("delete", "-r <id:posint> 删除指定回声洞").option("list", "-l 查询投稿统计").usage("随机抽取一条已添加的回声洞。").action(async ({ session, options }) => {
+  const profileManager = config.enableProfile ? new ProfileManager(ctx) : null;
+  const dataManager = config.enableIO ? new DataManager(ctx, config, fileManager, logger) : null;
+  const reviewManager = config.enableReview ? new ReviewManager(ctx, config, fileManager, logger) : null;
+  const cave = ctx.command("cave", "回声洞").option("add", "-a <content:text>").option("view", "-g <id:posint>").option("delete", "-r <id:posint>").option("list", "-l").usage("随机抽取一条已添加的回声洞。").action(async ({ session, options }) => {
     if (options.add) return session.execute(`cave.add ${options.add}`);
     if (options.view) return session.execute(`cave.view ${options.view}`);
     if (options.delete) return session.execute(`cave.del ${options.delete}`);
@@ -620,7 +586,7 @@ function apply(ctx, config) {
     try {
       const query = getScopeQuery(session, config);
       const candidates = await ctx.database.get("cave", query, { fields: ["id"] });
-      if (candidates.length === 0) {
+      if (!candidates.length) {
         return `当前${config.perChannel && session.channelId ? "本群" : ""}还没有任何回声洞`;
       }
       const randomId = candidates[Math.floor(Math.random() * candidates.length)].id;
@@ -634,21 +600,17 @@ function apply(ctx, config) {
   });
   cave.subcommand(".add [content:text]", "添加回声洞").usage("添加一条回声洞。可以直接发送内容，也可以回复或引用一条消息。").action(async ({ session }, content) => {
     try {
-      let sourceElements;
-      if (session.quote?.elements) {
-        sourceElements = session.quote.elements;
-      } else if (content?.trim()) {
+      let sourceElements = session.quote?.elements;
+      if (!sourceElements && content?.trim()) {
         sourceElements = import_koishi3.h.parse(content);
-      } else {
+      }
+      if (!sourceElements) {
         await session.send("请在一分钟内发送你要添加的内容");
         const reply = await session.prompt(6e4);
         if (!reply) return "操作超时，已取消添加";
         sourceElements = import_koishi3.h.parse(reply);
       }
-      const idScopeQuery = {};
-      if (config.perChannel && session.channelId) {
-        idScopeQuery["channelId"] = session.channelId;
-      }
+      const idScopeQuery = config.perChannel && session.channelId ? { channelId: session.channelId } : {};
       const newId = await getNextCaveId(ctx, idScopeQuery);
       const { finalElementsForDb, mediaToSave } = await processMessageElements(
         sourceElements,
@@ -657,39 +619,25 @@ function apply(ctx, config) {
         session.userId
       );
       if (finalElementsForDb.length === 0) return "内容为空，已取消添加";
-      const customNickname = config.enableProfile ? await profileManager.getNickname(session.userId) : null;
-      const userName = customNickname || session.username;
-      if (mediaToSave.length > 0) {
-        const newCave = {
-          id: newId,
-          elements: finalElementsForDb,
-          channelId: session.channelId,
-          userId: session.userId,
-          userName,
-          status: "preload",
-          time: /* @__PURE__ */ new Date()
-        };
-        await ctx.database.create("cave", newCave);
+      const userName = (config.enableProfile ? await profileManager.getNickname(session.userId) : null) || session.username;
+      const hasMedia = mediaToSave.length > 0;
+      const initialStatus = hasMedia ? "preload" : config.enableReview ? "pending" : "active";
+      const newCave = {
+        id: newId,
+        elements: finalElementsForDb,
+        channelId: session.channelId,
+        userId: session.userId,
+        userName,
+        status: initialStatus,
+        time: /* @__PURE__ */ new Date()
+      };
+      await ctx.database.create("cave", newCave);
+      if (hasMedia) {
         handleFileUploads(ctx, config, fileManager, logger, reviewManager, newCave, mediaToSave);
-        return config.enableReview ? `提交成功，序号为（${newId}）` : `添加成功，序号为（${newId}）`;
-      } else {
-        const finalStatus = config.enableReview ? "pending" : "active";
-        const newCave = {
-          id: newId,
-          elements: finalElementsForDb,
-          channelId: session.channelId,
-          userId: session.userId,
-          userName,
-          status: finalStatus,
-          time: /* @__PURE__ */ new Date()
-        };
-        await ctx.database.create("cave", newCave);
-        if (finalStatus === "pending") {
-          reviewManager.sendForReview(newCave);
-          return `提交成功，序号为（${newId}）`;
-        }
-        return `添加成功，序号为（${newId}）`;
+      } else if (initialStatus === "pending") {
+        reviewManager.sendForReview(newCave);
       }
+      return initialStatus === "pending" || initialStatus === "preload" && config.enableReview ? `提交成功，序号为（${newId}）` : `添加成功，序号为（${newId}）`;
     } catch (error) {
       logger.error("添加回声洞失败:", error);
       return "添加失败，请稍后再试";
@@ -715,8 +663,10 @@ function apply(ctx, config) {
     try {
       const [targetCave] = await ctx.database.get("cave", { id, status: "active" });
       if (!targetCave) return `回声洞（${id}）不存在`;
-      const adminChannelId = config.adminChannel ? config.adminChannel.split(":")[1] : null;
-      if (targetCave.userId !== session.userId && session.channelId !== adminChannelId) {
+      const adminChannelId = config.adminChannel?.split(":")[1];
+      const isAuthor = targetCave.userId === session.userId;
+      const isAdmin = session.channelId === adminChannelId;
+      if (!isAuthor && !isAdmin) {
         return "你没有权限删除这条回声洞";
       }
       await ctx.database.upsert("cave", [{ id, status: "delete" }]);
@@ -731,8 +681,8 @@ function apply(ctx, config) {
   cave.subcommand(".list", "查询我的投稿").usage("查询并列出你所有投稿的回声洞序号。").action(async ({ session }) => {
     try {
       const query = { ...getScopeQuery(session, config), userId: session.userId };
-      const userCaves = await ctx.database.get("cave", query);
-      if (userCaves.length === 0) return "你还没有投稿过回声洞";
+      const userCaves = await ctx.database.get("cave", query, { fields: ["id"] });
+      if (!userCaves.length) return "你还没有投稿过回声洞";
       const caveIds = userCaves.map((c) => c.id).sort((a, b) => a - b).join(", ");
       return `你已投稿 ${userCaves.length} 条回声洞，序号为：
 ${caveIds}`;
@@ -741,18 +691,9 @@ ${caveIds}`;
       return "查询失败，请稍后再试";
     }
   });
-  if (config.enableProfile) {
-    profileManager = new ProfileManager(ctx);
-    profileManager.registerCommands(cave);
-  }
-  if (config.enableIO) {
-    dataManager = new DataManager(ctx, config, fileManager, logger);
-    dataManager.registerCommands(cave);
-  }
-  if (config.enableReview) {
-    reviewManager = new ReviewManager(ctx, config, fileManager, logger);
-    reviewManager.registerCommands(cave);
-  }
+  if (profileManager) profileManager.registerCommands(cave);
+  if (dataManager) dataManager.registerCommands(cave);
+  if (reviewManager) reviewManager.registerCommands(cave);
 }
 __name(apply, "apply");
 // Annotate the CommonJS export names for ESM import in node:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-best-cave",
   "description": "最强大的回声洞现已重构完成啦！注意数据格式需要使用脚本转换哦~",
-  "version": "2.0.9",
+  "version": "2.1.0",
   "contributors": [
     "Yis_Rime <yis_rime@outlook.com>"
   ],

package/lib/DataManager.d.ts

@@ -1,36 +0,0 @@
-import { Context, Logger } from 'koishi';
-import { FileManager } from './FileManager';
-import { Config } from './index';
-/**
- * @class DataManager
- * @description 负责处理回声洞数据的导入和导出功能。
- */
-export declare class DataManager {
-    private ctx;
-    private config;
-    private fileManager;
-    private logger;
-    /**
-     * @constructor
-     * @param ctx Koishi 上下文，用于数据库操作。
-     * @param config 插件配置。
-     * @param fileManager 文件管理器实例。
-     * @param logger 日志记录器实例。
-     */
-    constructor(ctx: Context, config: Config, fileManager: FileManager, logger: Logger);
-    /**
-     * @description 注册 `.export` 和 `.import` 子命令。
-     * @param cave - 主 `cave` 命令实例。
-     */
-    registerCommands(cave: any): void;
-    /**
-     * @description 导出所有 'active' 状态的回声洞数据到 `cave_export.json`。
-     * @returns 描述导出结果的消息字符串。
-     */
-    exportData(): Promise<string>;
-    /**
-     * @description 从 `cave_import.json` 文件导入回声洞数据。
-     * @returns 描述导入结果的消息字符串。
-     */
-    importData(): Promise<string>;
-}

package/lib/FileManager.d.ts

@@ -1,48 +0,0 @@
-import { Logger } from 'koishi';
-import { Config } from './index';
-/**
- * @class FileManager
- * @description 封装了对文件的存储、读取和删除操作。
- * 能根据配置自动选择使用本地文件系统或 AWS S3 作为存储后端。
- * 内置 Promise 文件锁，防止本地文件的并发写入冲突。
- */
-export declare class FileManager {
-    private logger;
-    private resourceDir;
-    private locks;
-    private s3Client?;
-    private s3Bucket?;
-    /**
-     * @constructor
-     * @param baseDir Koishi 应用的基础数据目录 (ctx.baseDir)。
-     * @param config 插件的配置对象。
-     * @param logger 日志记录器实例。
-     */
-    constructor(baseDir: string, config: Config, logger: Logger);
-    /**
-     * @description 使用文件锁安全地执行异步文件操作，防止并发读写冲突。
-     * @template T 异步操作的返回类型。
-     * @param fullPath 需要加锁的文件的完整路径。
-     * @param operation 要执行的异步函数。
-     * @returns 返回异步操作的结果。
-     */
-    private withLock;
-    /**
-     * @description 保存文件，自动选择 S3 或本地存储。
-     * @param fileName 用作 S3 Key 或本地文件名。
-     * @param data 要写入的 Buffer 数据。
-     * @returns 返回保存时使用的文件名/标识符。
-     */
-    saveFile(fileName: string, data: Buffer): Promise<string>;
-    /**
-     * @description 读取文件，自动从 S3 或本地存储读取。
-     * @param fileName 要读取的文件名/标识符。
-     * @returns 文件的 Buffer 数据。
-     */
-    readFile(fileName: string): Promise<Buffer>;
-    /**
-     * @description 删除文件，自动从 S3 或本地删除。
-     * @param fileIdentifier 要删除的文件名/标识符。
-     */
-    deleteFile(fileIdentifier: string): Promise<void>;
-}

package/lib/ProfileManager.d.ts

@@ -1,50 +0,0 @@
-import { Context } from 'koishi';
-/**
- * @description 数据库 `cave_user` 表的结构定义。
- * @property userId 用户唯一ID，作为主键。
- * @property nickname 用户自定义的昵称。
- */
-export interface UserProfile {
-    userId: string;
-    nickname: string;
-}
-declare module 'koishi' {
-    interface Tables {
-        cave_user: UserProfile;
-    }
-}
-/**
- * @class ProfileManager
- * @description 负责管理用户在回声洞中的自定义昵称。
- * 当插件配置 `enableProfile` 为 true 时实例化。
- */
-export declare class ProfileManager {
-    private ctx;
-    /**
-     * @constructor
-     * @param ctx - Koishi 上下文，用于初始化数据库模型。
-     */
-    constructor(ctx: Context);
-    /**
-     * @description 注册 `.profile` 子命令，用于管理用户昵称。
-     * @param cave - 主 `cave` 命令实例。
-     */
-    registerCommands(cave: any): void;
-    /**
-     * @description 设置或更新指定用户的昵称。
-     * @param userId - 目标用户的 ID。
-     * @param nickname - 要设置的新昵称。
-     */
-    setNickname(userId: string, nickname: string): Promise<void>;
-    /**
-     * @description 获取指定用户的昵称。
-     * @param userId - 目标用户的 ID。
-     * @returns 返回用户的昵称字符串，如果未设置则返回 null。
-     */
-    getNickname(userId: string): Promise<string | null>;
-    /**
-     * @description 清除指定用户的昵称设置。
-     * @param userId - 目标用户的 ID。
-     */
-    clearNickname(userId: string): Promise<void>;
-}

package/lib/ReviewManager.d.ts

@@ -1,38 +0,0 @@
-import { Context, Logger } from 'koishi';
-import { CaveObject, Config } from './index';
-import { FileManager } from './FileManager';
-/**
- * @class ReviewManager
- * @description 负责处理回声洞的审核流程，处理新洞的提交、审核通知和审核操作。
- */
-export declare class ReviewManager {
-    private ctx;
-    private config;
-    private fileManager;
-    private logger;
-    /**
-     * @constructor
-     * @param ctx Koishi 上下文。
-     * @param config 插件配置。
-     * @param fileManager 文件管理器实例。
-     * @param logger 日志记录器实例。
-     */
-    constructor(ctx: Context, config: Config, fileManager: FileManager, logger: Logger);
-    /**
-     * @description 注册与审核相关的 `.review` 子命令。
-     * @param cave - 主 `cave` 命令实例。
-     */
-    registerCommands(cave: any): void;
-    /**
-     * @description 将新回声洞提交到管理群组以供审核。
-     * @param cave 新创建的、状态为 'pending' 的回声洞对象。
-     */
-    sendForReview(cave: CaveObject): Promise<void>;
-    /**
-     * @description 处理管理员的审核决定（通过或拒绝）。
-     * @param action 'approve' (通过) 或 'reject' (拒绝)。
-     * @param caveId 被审核的回声洞 ID。
-     * @returns 返回给操作者的确认消息。
-     */
-    processReview(action: 'approve' | 'reject', caveId: number): Promise<string>;
-}

package/lib/index.d.ts

@@ -1,48 +0,0 @@
-import { Context, Schema } from 'koishi';
-export declare const name = "best-cave";
-export declare const inject: string[];
-export declare const usage = "\n<div style=\"border-radius: 10px; border: 1px solid #ddd; padding: 16px; margin-bottom: 20px; box-shadow: 0 2px 5px rgba(0,0,0,0.1);\">\n  <h2 style=\"margin-top: 0; color: #4a6ee0;\">\uD83D\uDCCC \u63D2\u4EF6\u8BF4\u660E</h2>\n  <p>\uD83D\uDCD6 <strong>\u4F7F\u7528\u6587\u6863</strong>\uFF1A\u8BF7\u70B9\u51FB\u5DE6\u4E0A\u89D2\u7684 <strong>\u63D2\u4EF6\u4E3B\u9875</strong> \u67E5\u770B\u63D2\u4EF6\u4F7F\u7528\u6587\u6863</p>\n  <p>\uD83D\uDD0D <strong>\u66F4\u591A\u63D2\u4EF6</strong>\uFF1A\u53EF\u8BBF\u95EE <a href=\"https://github.com/YisRime\" style=\"color:#4a6ee0;text-decoration:none;\">\u82E1\u6DDE\u7684 GitHub</a> \u67E5\u770B\u672C\u4EBA\u7684\u6240\u6709\u63D2\u4EF6</p>\n</div>\n<div style=\"border-radius: 10px; border: 1px solid #ddd; padding: 16px; margin-bottom: 20px; box-shadow: 0 2px 5px rgba(0,0,0,0.1);\">\n  <h2 style=\"margin-top: 0; color: #e0574a;\">\u2764\uFE0F \u652F\u6301\u4E0E\u53CD\u9988</h2>\n  <p>\uD83C\uDF1F \u559C\u6B22\u8FD9\u4E2A\u63D2\u4EF6\uFF1F\u8BF7\u5728 <a href=\"https://github.com/YisRime\" style=\"color:#e0574a;text-decoration:none;\">GitHub</a> \u4E0A\u7ED9\u6211\u4E00\u4E2A Star\uFF01</p>\n  <p>\uD83D\uDC1B \u9047\u5230\u95EE\u9898\uFF1F\u8BF7\u901A\u8FC7 <strong>Issues</strong> \u63D0\u4EA4\u53CD\u9988\uFF0C\u6216\u52A0\u5165 QQ \u7FA4 <a href=\"https://qm.qq.com/q/PdLMx9Jowq\" style=\"color:#e0574a;text-decoration:none;\"><strong>855571375</strong></a> \u8FDB\u884C\u4EA4\u6D41</p>\n</div>\n";
-/**
- * @description 存储在数据库中的单个消息元素。
- */
-export interface StoredElement {
-    type: 'text' | 'image' | 'video' | 'audio' | 'file';
-    content?: string;
-    file?: string;
-}
-/**
- * @description 数据库 `cave` 表的完整对象模型。
- */
-export interface CaveObject {
-    id: number;
-    elements: StoredElement[];
-    channelId: string;
-    userId: string;
-    userName: string;
-    status: 'active' | 'delete' | 'pending' | 'preload';
-    time: Date;
-}
-declare module 'koishi' {
-    interface Tables {
-        cave: CaveObject;
-    }
-}
-export interface Config {
-    coolDown: number;
-    perChannel: boolean;
-    adminChannel: string;
-    enableProfile: boolean;
-    enableIO: boolean;
-    enableReview: boolean;
-    caveFormat: string;
-    localPath?: string;
-    enableS3: boolean;
-    endpoint?: string;
-    region?: string;
-    accessKeyId?: string;
-    secretAccessKey?: string;
-    bucket?: string;
-    publicUrl?: string;
-}
-export declare const Config: Schema<Config>;
-export declare function apply(ctx: Context, config: Config): void;