koishi-plugin-best-cave 1.5.8 → 1.5.10

package/lib/index.d.ts

@@ -1,14 +1,37 @@
 import { Context, Schema } from 'koishi';
 export declare const name = "best-cave";
 export declare const inject: string[];
+/**
+ * 基础元素类型
+ * @interface BaseElement
+ * @property {('text'|'img'|'video')} type - 元素类型
+ * @property {number} index - 排序索引
+ */
 export interface BaseElement {
     type: 'text' | 'img' | 'video';
     index: number;
 }
+/**
+ * 文本元素类型
+ * @interface TextElement
+ * @extends {BaseElement}
+ * @property {'text'} type - 文本类型
+ * @property {string} content - 文本内容
+ */
 export interface TextElement extends BaseElement {
     type: 'text';
     content: string;
 }
+/**
+ * 媒体元素类型
+ * @interface MediaElement
+ * @extends {BaseElement}
+ * @property {('img'|'video')} type - 媒体类型
+ * @property {string} [file] - 文件名
+ * @property {string} [fileName] - 原始文件名
+ * @property {string} [fileSize] - 文件大小
+ * @property {string} [filePath] - 文件路径
+ */
 export interface MediaElement extends BaseElement {
     type: 'img' | 'video';
     file?: string;
@@ -17,6 +40,14 @@ export interface MediaElement extends BaseElement {
     filePath?: string;
 }
 export type Element = TextElement | MediaElement;
+/**
+ * 回声洞对象
+ * @interface CaveObject
+ * @property {number} cave_id - 回声洞ID
+ * @property {Element[]} elements - 元素列表
+ * @property {string} contributor_number - 投稿者ID
+ * @property {string} contributor_name - 投稿者名称
+ */
 export interface CaveObject {
     cave_id: number;
     elements: Element[];
@@ -25,17 +56,6 @@ export interface CaveObject {
 }
 export interface PendingCave extends CaveObject {
 }
-/**
- * 插件配置项
- * @type {Schema}
- */
-export declare const Config: Schema<Config>;
-/**
- * 插件主入口
- * @param {Context} ctx - Koishi上下文
- * @param {Config} config - 插件配置
- */
-export declare function apply(ctx: Context, config: Config): Promise<void>;
 export interface Config {
     manager: string[];
     number: number;
@@ -52,3 +72,14 @@ export interface Config {
     textDuplicateThreshold: number;
     enableTextDuplicate: boolean;
 }
+/**
+ * 插件配置项
+ * @type {Schema}
+ */
+export declare const Config: Schema<Config>;
+/**
+ * 插件主入口
+ * @param {Context} ctx - Koishi上下文
+ * @param {Config} config - 插件配置
+ */
+export declare function apply(ctx: Context, config: Config): Promise<void>;

package/lib/index.js

@@ -33,7 +33,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/locales/zh-CN.yml
 var require_zh_CN = __commonJS({
   "src/locales/zh-CN.yml"(exports2, module2) {
-    module2.exports = { _config: { manager: "管理员", number: "冷却时间（秒）", enableAudit: "启用审核", enableTextDuplicate: "启用文本查重", textDuplicateThreshold: "文本相似度阈值（0-1）", enableImageDuplicate: "启用图片查重", imageDuplicateThreshold: "图片相似度阈值（0-1）", imageMaxSize: "图片最大大小（MB）", allowVideo: "允许视频上传", videoMaxSize: "视频最大大小（MB）", enablePagination: "启用统计分页", itemsPerPage: "每页显示数目", blacklist: "黑名单（用户）", whitelist: "审核白名单（用户/群组/频道）" }, commands: { cave: { description: "回声洞", usage: "支持添加、抽取、查看、管理回声洞", examples: "使用 cave 随机抽取回声洞\n使用 -a 直接添加或引用添加\n使用 -g 查看指定回声洞\n使用 -r 删除指定回声洞", options: { a: "添加回声洞", g: "查看回声洞", r: "删除回声洞", l: "查询投稿统计" }, pass: { description: "通过回声洞审核", usage: "通过指定ID的回声洞审核\ncave.pass <ID> - 通过审核\ncave.pass all - 通过所有待审核内容\n" }, reject: { description: "拒绝回声洞审核", usage: "拒绝指定ID的回声洞审核\ncave.reject <ID> - 拒绝审核\ncave.reject all - 拒绝所有待审核内容\n" }, add: { noContent: "请在一分钟内发送内容", operationTimeout: "操作超时，添加取消", videoDisabled: "不允许上传视频", submitPending: "提交成功，序号为（{0}）", addSuccess: "添加成功，序号为（{0}）", mediaSizeExceeded: "{0}文件大小超过限制", localFileNotAllowed: "检测到本地文件路径，无法保存" }, remove: { noPermission: "你无权删除他人添加的回声洞", deletePending: "删除（待审核）", deleted: "已删除" }, list: { pageInfo: "第 {0} / {1} 页", header: "当前共有 {0} 项回声洞：", totalItems: "用户 {0} 共计投稿 {1} 项：", idsLine: "{0}" }, audit: { noPending: "暂无待审核回声洞", pendingNotFound: "未找到待审核回声洞", pendingResult: "{0}，剩余 {1} 个待审核回声洞：[{2}]", auditPassed: "已通过", auditRejected: "已拒绝", batchAuditResult: "已{0} {1}/{2} 项回声洞", title: "待审核回声洞：", from: "投稿人：", sendFailed: "发送审核消息失败，无法联系管理员 {0}" }, error: { noContent: "回声洞内容为空", getCave: "获取回声洞失败", noCave: "没有回声洞", invalidId: "请输入有效的回声洞ID", notFound: "未找到该回声洞", exactDuplicateFound: "发现完全相同的", similarDuplicateFound: "发现相似度为 {0}% 的", addFailed: "添加失败，请稍后重试。" }, message: { blacklisted: "你已被列入黑名单", managerOnly: "此操作仅限管理员可用", cooldown: "群聊冷却中...请在 {0} 秒后重试", caveTitle: "回声洞 —— （{0}）", contributorSuffix: "—— {0}", mediaSizeExceeded: "{0}文件大小超过限制" } } } };
+    module2.exports = { _config: { manager: "管理员", number: "冷却时间（秒）", enableAudit: "启用审核", enableTextDuplicate: "启用文本查重", textDuplicateThreshold: "文本相似度阈值（0-1）", enableImageDuplicate: "启用图片查重", imageDuplicateThreshold: "图片相似度阈值（0-1）", imageMaxSize: "图片最大大小（MB）", allowVideo: "允许视频上传", videoMaxSize: "视频最大大小（MB）", enablePagination: "启用统计分页", itemsPerPage: "每页显示数目", blacklist: "黑名单（用户）", whitelist: "审核白名单（用户/群组/频道）" }, commands: { cave: { description: "回声洞", usage: "支持添加、抽取、查看、管理回声洞", examples: "使用 cave 随机抽取回声洞\n使用 -a 直接添加或引用添加\n使用 -g 查看指定回声洞\n使用 -r 删除指定回声洞", options: { a: "添加回声洞", g: "查看回声洞", r: "删除回声洞", l: "查询投稿统计" }, pass: { description: "通过回声洞审核", usage: "通过指定ID的回声洞审核\ncave.pass <ID> - 通过审核\ncave.pass all - 通过所有待审核内容\n" }, reject: { description: "拒绝回声洞审核", usage: "拒绝指定ID的回声洞审核\ncave.reject <ID> - 拒绝审核\ncave.reject all - 拒绝所有待审核内容\n" }, add: { noContent: "请在一分钟内发送内容", operationTimeout: "操作超时，添加取消", videoDisabled: "不允许上传视频", submitPending: "提交成功，序号为（{0}）", addSuccess: "添加成功，序号为（{0}）", mediaSizeExceeded: "{0}文件大小超过限制", localFileNotAllowed: "检测到本地文件路径，无法保存" }, remove: { noPermission: "你无权删除他人添加的回声洞", deletePending: "删除（待审核）", deleted: "已删除" }, list: { pageInfo: "第 {0} / {1} 页", header: "当前共有 {0} 项回声洞：", totalItems: "用户 {0} 共计投稿 {1} 项：", idsLine: "{0}" }, audit: { noPending: "暂无待审核回声洞", pendingNotFound: "未找到待审核回声洞", pendingResult: "{0}，剩余 {1} 个待审核回声洞：[{2}]", auditPassed: "已通过", auditRejected: "已拒绝", batchAuditResult: "已{0} {1}/{2} 项回声洞", title: "待审核回声洞：", from: "投稿人：", sendFailed: "发送审核消息失败，无法联系管理员 {0}" }, error: { noContent: "回声洞内容为空", getCave: "获取回声洞失败", noCave: "当前无回声洞", invalidId: "请输入有效的回声洞ID", notFound: "未找到该回声洞", exactDuplicateFound: "发现完全相同的", similarDuplicateFound: "发现相似度为 {0}% 的", addFailed: "添加失败，请稍后重试。" }, message: { blacklisted: "你已被列入黑名单", managerOnly: "此操作仅限管理员可用", cooldown: "群聊冷却中...请在 {0} 秒后重试", caveTitle: "回声洞 —— （{0}）", contributorSuffix: "—— {0}", mediaSizeExceeded: "{0}文件大小超过限制" } } } };
   }
 });
 
@@ -622,16 +622,11 @@ var HashManager = class _HashManager {
   static {
     __name(this, "HashManager");
   }
-  // 哈希数据文件名
   static HASH_FILE = "hash.json";
-  // 回声洞数据文件名
   static CAVE_FILE = "cave.json";
-  // 批处理大小
   static BATCH_SIZE = 50;
-  // 存储回声洞ID到图片哈希值的映射
   imageHashes = /* @__PURE__ */ new Map();
   textHashes = /* @__PURE__ */ new Map();
-  // 初始化状态标志
   initialized = false;
   get filePath() {
     return path3.join(this.caveDir, _HashManager.HASH_FILE);
@@ -824,7 +819,6 @@ var HashManager = class _HashManager {
     }
     return matches / length;
   }
-  // 重命名原有的图片哈希相关方法
   async findImageDuplicates(images, threshold) {
     if (!this.initialized) await this.initialize();
     const inputHashes = await Promise.all(
@@ -985,6 +979,12 @@ var import_koishi4 = require("koishi");
 var fs4 = __toESM(require("fs"));
 var path4 = __toESM(require("path"));
 var AuditManager = class {
+  /**
+   * 创建审核管理器实例
+   * @param ctx - Koishi 上下文
+   * @param config - 配置对象
+   * @param idManager - ID 管理器实例
+   */
   constructor(ctx, config, idManager) {
     this.ctx = ctx;
     this.config = config;
@@ -994,6 +994,17 @@ var AuditManager = class {
     __name(this, "AuditManager");
   }
   logger = new import_koishi4.Logger("AuditManager");
+  /**
+   * 处理审核操作
+   * @param pendingData - 待审核的洞数据数组
+   * @param isApprove - 是否通过审核
+   * @param caveFilePath - 洞数据文件路径
+   * @param resourceDir - 资源目录路径
+   * @param pendingFilePath - 待审核数据文件路径
+   * @param session - 会话对象
+   * @param targetId - 目标洞ID（可选）
+   * @returns 处理结果消息
+   */
   async processAudit(pendingData, isApprove, caveFilePath, resourceDir, pendingFilePath, session, targetId) {
     if (pendingData.length === 0) {
       return this.sendMessage(session, "commands.cave.audit.noPending", [], true);
@@ -1018,6 +1029,18 @@ var AuditManager = class {
       session
     );
   }
+  /**
+   * 处理单条审核
+   * @param pendingData - 待审核的洞数据数组
+   * @param isApprove - 是否通过审核
+   * @param caveFilePath - 洞数据文件路径
+   * @param resourceDir - 资源目录路径
+   * @param pendingFilePath - 待审核数据文件路径
+   * @param targetId - 目标洞ID
+   * @param session - 会话对象
+   * @returns 处理结果消息
+   * @private
+   */
   async handleSingleAudit(pendingData, isApprove, caveFilePath, resourceDir, pendingFilePath, targetId, session) {
     const targetCave = pendingData.find((item) => item.cave_id === targetId);
     if (!targetCave) {
@@ -1066,6 +1089,17 @@ var AuditManager = class {
       false
     );
   }
+  /**
+   * 处理批量审核
+   * @param pendingData - 待审核的洞数据数组
+   * @param isApprove - 是否通过审核
+   * @param caveFilePath - 洞数据文件路径
+   * @param resourceDir - 资源目录路径
+   * @param pendingFilePath - 待审核数据文件路径
+   * @param session - 会话对象
+   * @returns 处理结果消息
+   * @private
+   */
   async handleBatchAudit(pendingData, isApprove, caveFilePath, resourceDir, pendingFilePath, session) {
     const data = isApprove ? await FileHandler.readJsonData(caveFilePath) : null;
     let processedCount = 0;
@@ -1109,6 +1143,12 @@ var AuditManager = class {
       pendingData.length
     ], false);
   }
+  /**
+   * 发送审核消息给管理员
+   * @param cave - 待审核的洞数据
+   * @param content - 消息内容
+   * @param session - 会话对象
+   */
   async sendAuditMessage(cave, content, session) {
     const auditMessage = `${session.text("commands.cave.audit.title")}
 ${content}
@@ -1124,6 +1164,12 @@ ${session.text("commands.cave.audit.from")}${cave.contributor_number}`;
       }
     }
   }
+  /**
+   * 删除媒体文件
+   * @param cave - 洞数据
+   * @param resourceDir - 资源目录路径
+   * @private
+   */
   async deleteMediaFiles(cave, resourceDir) {
     if (cave.elements) {
       for (const element of cave.elements) {
@@ -1136,6 +1182,13 @@ ${session.text("commands.cave.audit.from")}${cave.contributor_number}`;
       }
     }
   }
+  /**
+   * 清理元素数据用于保存
+   * @param elements - 元素数组
+   * @param keepIndex - 是否保留索引
+   * @returns 清理后的元素数组
+   * @private
+   */
   cleanElementsForSave(elements, keepIndex = false) {
     if (!elements?.length) return [];
     const cleanedElements = elements.map((element) => {
@@ -1159,6 +1212,16 @@ ${session.text("commands.cave.audit.from")}${cave.contributor_number}`;
     });
     return keepIndex ? cleanedElements.sort((a, b) => (a.index || 0) - (b.index || 0)) : cleanedElements;
   }
+  /**
+   * 发送消息
+   * @param session - 会话对象
+   * @param key - 消息key
+   * @param params - 消息参数
+   * @param isTemp - 是否为临时消息
+   * @param timeout - 临时消息超时时间
+   * @returns 空字符串
+   * @private
+   */
   async sendMessage(session, key, params = [], isTemp = true, timeout = 1e4) {
     try {
       const msg = await session.send(session.text(key, params));
@@ -1208,10 +1271,7 @@ async function buildMessage(cave, resourceDir, session) {
       lines.push(element.content);
     } else if (element.type === "img" && element.file) {
       const filePath = path5.join(resourceDir, element.file);
-      const base64Data = await processMediaFile(filePath, "image");
-      if (base64Data) {
-        lines.push((0, import_koishi5.h)("image", { src: base64Data }));
-      }
+      lines.push(import_koishi5.h.image(filePath));
     }
   }
   lines.push(session.text("commands.cave.message.contributorSuffix", [cave.contributor_name]));
@@ -1237,9 +1297,17 @@ async function sendMessage(session, key, params = [], isTemp = true, timeout = 1
 }
 __name(sendMessage, "sendMessage");
 async function processMediaFile(filePath, type) {
-  const data = await fs5.promises.readFile(filePath).catch(() => null);
-  if (!data) return null;
-  return `data:${type}/${type === "image" ? "png" : "mp4"};base64,${data.toString("base64")}`;
+  try {
+    await fs5.promises.access(filePath);
+    if (type === "image") {
+      return filePath;
+    } else {
+      const data = await fs5.promises.readFile(filePath);
+      return `data:${type}/mp4;base64,${data.toString("base64")}`;
+    }
+  } catch {
+    return null;
+  }
 }
 __name(processMediaFile, "processMediaFile");
 async function extractMediaContent(originalContent, config, session) {
@@ -1463,6 +1531,7 @@ __name(processDelete, "processDelete");
 // src/index.ts
 var name = "best-cave";
 var inject = ["database"];
+var logger5 = new import_koishi6.Logger("cave");
 var Config = import_koishi6.Schema.object({
   manager: import_koishi6.Schema.array(import_koishi6.Schema.string()).required(),
   // 管理员用户ID
@@ -1553,7 +1622,6 @@ async function apply(ctx, config) {
           ctx2,
           session,
           imageBuffers
-          // 添加参数用于收集buffer
         ) : [],
         videoUrls.length > 0 ? saveMedia(
           videoUrls,
@@ -1568,20 +1636,16 @@ async function apply(ctx, config) {
       ]);
       const newCave = {
         cave_id: caveId,
-        // 确保使用有效的数字ID
         elements: [
           ...textParts,
           ...imageElements.map((el, idx) => ({
             ...el,
             file: savedImages[idx],
-            // 保持原始文本和图片的相对位置
             index: el.index
           }))
         ].sort((a, b) => a.index - b.index),
         contributor_number: session.userId || "100000",
-        // 添加默认值
         contributor_name: session.username || "User"
-        // 添加默认值
       };
       if (videoUrls.length > 0 && savedVideos.length > 0) {
         newCave.elements.push({
@@ -1658,7 +1722,7 @@ async function apply(ctx, config) {
     }
   }
   __name(processAdd, "processAdd");
-  const caveCommand = ctx.command("cave [message]").option("a", "添加回声洞").option("g", "查看回声洞", { type: "string" }).option("r", "删除回声洞", { type: "string" }).option("l", "查询投稿统计", { type: "string" }).before(async ({ session, options }) => {
+  const caveCommand = ctx.command("cave [message]").option("a", "添加回声洞").option("g", "查看回声洞", { type: "string" }).option("r", "删除回声洞", { type: "string" }).option("l", "查询投稿统计", { type: "string" }).before(async ({ session }) => {
     if (config.blacklist.includes(session.userId)) {
       return sendMessage(session, "commands.cave.message.blacklisted", [], true);
     }
@@ -1737,7 +1801,6 @@ async function apply(ctx, config) {
   });
 }
 __name(apply, "apply");
-var logger5 = new import_koishi6.Logger("cave");
 function cleanElementsForSave(elements, keepIndex = false) {
   if (!elements?.length) return [];
   const cleanedElements = elements.map((element) => {

package/lib/utils/AuditHandler.d.ts

@@ -1,17 +1,89 @@
 import { Context } from 'koishi';
 import { Config, PendingCave } from '..';
 import { IdManager } from './IdManager';
+/**
+ * 管理洞审核相关操作的类
+ */
 export declare class AuditManager {
     private ctx;
     private config;
     private idManager;
     private logger;
+    /**
+     * 创建审核管理器实例
+     * @param ctx - Koishi 上下文
+     * @param config - 配置对象
+     * @param idManager - ID 管理器实例
+     */
     constructor(ctx: Context, config: Config, idManager: IdManager);
+    /**
+     * 处理审核操作
+     * @param pendingData - 待审核的洞数据数组
+     * @param isApprove - 是否通过审核
+     * @param caveFilePath - 洞数据文件路径
+     * @param resourceDir - 资源目录路径
+     * @param pendingFilePath - 待审核数据文件路径
+     * @param session - 会话对象
+     * @param targetId - 目标洞ID（可选）
+     * @returns 处理结果消息
+     */
     processAudit(pendingData: PendingCave[], isApprove: boolean, caveFilePath: string, resourceDir: string, pendingFilePath: string, session: any, targetId?: number): Promise<string>;
+    /**
+     * 处理单条审核
+     * @param pendingData - 待审核的洞数据数组
+     * @param isApprove - 是否通过审核
+     * @param caveFilePath - 洞数据文件路径
+     * @param resourceDir - 资源目录路径
+     * @param pendingFilePath - 待审核数据文件路径
+     * @param targetId - 目标洞ID
+     * @param session - 会话对象
+     * @returns 处理结果消息
+     * @private
+     */
     private handleSingleAudit;
+    /**
+     * 处理批量审核
+     * @param pendingData - 待审核的洞数据数组
+     * @param isApprove - 是否通过审核
+     * @param caveFilePath - 洞数据文件路径
+     * @param resourceDir - 资源目录路径
+     * @param pendingFilePath - 待审核数据文件路径
+     * @param session - 会话对象
+     * @returns 处理结果消息
+     * @private
+     */
     private handleBatchAudit;
+    /**
+     * 发送审核消息给管理员
+     * @param cave - 待审核的洞数据
+     * @param content - 消息内容
+     * @param session - 会话对象
+     */
     sendAuditMessage(cave: PendingCave, content: string, session: any): Promise<void>;
+    /**
+     * 删除媒体文件
+     * @param cave - 洞数据
+     * @param resourceDir - 资源目录路径
+     * @private
+     */
     private deleteMediaFiles;
+    /**
+     * 清理元素数据用于保存
+     * @param elements - 元素数组
+     * @param keepIndex - 是否保留索引
+     * @returns 清理后的元素数组
+     * @private
+     */
     private cleanElementsForSave;
+    /**
+     * 发送消息
+     * @param session - 会话对象
+     * @param key - 消息key
+     * @param params - 消息参数
+     * @param isTemp - 是否为临时消息
+     * @param timeout - 临时消息超时时间
+     * @returns 空字符串
+     * @private
+     */
     private sendMessage;
 }

package/lib/utils/MediaHandler.d.ts

@@ -1,8 +1,37 @@
 import { Context } from 'koishi';
 import { Element, CaveObject } from '..';
+/**
+ * 构建并返回洞窟消息内容
+ * @param cave - 洞窟对象
+ * @param resourceDir - 资源目录路径
+ * @param session - 会话对象
+ * @returns 格式化后的消息字符串
+ */
 export declare function buildMessage(cave: CaveObject, resourceDir: string, session?: any): Promise<string>;
+/**
+ * 发送临时或永久消息
+ * @param session - 会话对象
+ * @param key - 消息key
+ * @param params - 消息参数数组
+ * @param isTemp - 是否为临时消息
+ * @param timeout - 临时消息超时时间(ms)
+ * @returns 空字符串
+ */
 export declare function sendMessage(session: any, key: string, params?: any[], isTemp?: boolean, timeout?: number): Promise<string>;
+/**
+ * 处理媒体文件，返回文件路径或base64编码
+ * @param filePath - 文件路径
+ * @param type - 媒体类型('image' | 'video')
+ * @returns 图片路径或视频base64编码
+ */
 export declare function processMediaFile(filePath: string, type: 'image' | 'video'): Promise<string | null>;
+/**
+ * 从内容中提取媒体元素
+ * @param originalContent - 原始内容字符串
+ * @param config - 配置对象，包含图片和视频大小限制
+ * @param session - 会话对象
+ * @returns 包含图片、视频URL和元素的对象
+ */
 export declare function extractMediaContent(originalContent: string, config: {
     imageMaxSize: number;
     videoMaxSize: number;
@@ -23,6 +52,19 @@ export declare function extractMediaContent(originalContent: string, config: {
     }>;
     textParts: Element[];
 }>;
+/**
+ * 保存媒体文件
+ * @param urls - 媒体URL数组
+ * @param fileNames - 文件名数组
+ * @param resourceDir - 资源目录路径
+ * @param caveId - 洞窟ID
+ * @param mediaType - 媒体类型('img' | 'video')
+ * @param config - 配置对象，包含重复检查相关设置
+ * @param ctx - Koishi上下文
+ * @param session - 会话对象
+ * @param buffers - 可选的buffer数组，用于收集图片buffer
+ * @returns 保存后的文件名数组
+ */
 export declare function saveMedia(urls: string[], fileNames: (string | undefined)[], resourceDir: string, caveId: number, mediaType: 'img' | 'video', config: {
     enableImageDuplicate: boolean;
     imageDuplicateThreshold: number;

package/lib/utils/ProcessHandle.d.ts

@@ -1,7 +1,45 @@
 import { Config } from '..';
 import { IdManager } from './IdManager';
 import { HashManager } from './HashManager';
+/**
+ * 处理回声洞列表查询
+ * @param session - 会话对象
+ * @param config - 配置对象
+ * @param idManager - ID管理器实例
+ * @param userId - 可选的用户ID，用于筛选特定用户的回声洞
+ * @param pageNum - 页码，默认为1
+ * @returns 格式化后的回声洞列表字符串
+ */
 export declare function processList(session: any, config: Config, idManager: IdManager, userId?: string, pageNum?: number): Promise<string>;
+/**
+ * 查看指定ID的回声洞内容
+ * @param caveFilePath - 回声洞数据文件路径
+ * @param resourceDir - 资源文件目录路径
+ * @param session - 会话对象
+ * @param options - 命令选项
+ * @param content - 命令内容数组
+ * @returns 回声洞内容的格式化字符串
+ */
 export declare function processView(caveFilePath: string, resourceDir: string, session: any, options: any, content: string[]): Promise<string>;
+/**
+ * 随机获取一个回声洞
+ * @param caveFilePath - 回声洞数据文件路径
+ * @param resourceDir - 资源文件目录路径
+ * @param session - 会话对象
+ * @returns 随机回声洞的格式化字符串，如果没有可用的回声洞则返回错误消息
+ */
 export declare function processRandom(caveFilePath: string, resourceDir: string, session: any): Promise<string | void>;
+/**
+ * 删除指定ID的回声洞
+ * @param caveFilePath - 回声洞数据文件路径
+ * @param resourceDir - 资源文件目录路径
+ * @param pendingFilePath - 待审核回声洞数据文件路径
+ * @param session - 会话对象
+ * @param config - 配置对象
+ * @param options - 命令选项
+ * @param content - 命令内容数组
+ * @param idManager - ID管理器实例
+ * @param HashManager - 哈希管理器实例
+ * @returns 删除操作的结果消息
+ */
 export declare function processDelete(caveFilePath: string, resourceDir: string, pendingFilePath: string, session: any, config: Config, options: any, content: string[], idManager: IdManager, HashManager: HashManager): Promise<string>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-best-cave",
   "description": "最好的 cave 插件，可开关的审核系统，可引用添加，支持图文混合内容，可查阅投稿列表，完美复刻你的 .cave 体验！",
-  "version": "1.5.8",
+  "version": "1.5.10",
   "contributors": [
     "Yis_Rime <yis_rime@outlook.com>"
   ],