koishi-plugin-best-cave 2.3.0 → 2.3.1

package/lib/HashManager.d.ts

@@ -0,0 +1,102 @@
+import { Context, Logger } from 'koishi';
+import { Config, CaveObject } from './index';
+import { FileManager } from './FileManager';
+/**
+ * @description 数据库 `cave_hash` 表的完整对象模型。
+ */
+export interface CaveHashObject {
+    cave: number;
+    hash: string;
+    type: 'simhash' | 'phash_g' | 'phash_q1' | 'phash_q2' | 'phash_q3' | 'phash_q4';
+}
+/**
+ * @class HashManager
+ * @description 负责生成、存储和比较文本与图片的哈希值。
+ * 实现了基于 Simhash 的文本查重和基于 DCT 感知哈希 (pHash) 的图片查重方案。
+ */
+export declare class HashManager {
+    private ctx;
+    private config;
+    private logger;
+    private fileManager;
+    /**
+     * @constructor
+     * @param ctx - Koishi 上下文，用于数据库操作。
+     * @param config - 插件配置，用于获取相似度阈值等。
+     * @param logger - 日志记录器实例。
+     * @param fileManager - 文件管理器实例，用于读取图片文件。
+     */
+    constructor(ctx: Context, config: Config, logger: Logger, fileManager: FileManager);
+    /**
+     * @description 注册与哈希功能相关的 `.hash` 和 `.check` 子命令。
+     * @param cave - 主 `cave` 命令实例。
+     */
+    registerCommands(cave: any): void;
+    /**
+     * @description 检查数据库中所有回声洞，为没有哈希记录的历史数据生成哈希。
+     * @returns 一个包含操作结果的报告字符串。
+     */
+    generateHashesForHistoricalCaves(): Promise<string>;
+    /**
+     * @description 为单个回声洞对象生成所有类型的哈希（文本+图片）。
+     * @param cave - 回声洞对象。
+     * @returns 生成的哈希对象数组。
+     */
+    generateAllHashesForCave(cave: Pick<CaveObject, 'id' | 'elements'>): Promise<CaveHashObject[]>;
+    /**
+     * @description 对数据库中所有哈希进行两两比较，找出相似度过高的内容。
+     * @param options 包含临时阈值的可选对象。
+     * @returns 一个包含检查结果的报告字符串。
+     */
+    checkForSimilarCaves(options?: {
+        textThreshold?: number;
+        imageThreshold?: number;
+    }): Promise<string>;
+    /**
+     * @description 为单个图片Buffer生成全局pHash和四个象限的局部pHash。
+     * @param imageBuffer - 图片的Buffer数据。
+     * @returns 包含全局哈希和四象限哈希的对象。
+     */
+    generateAllImageHashes(imageBuffer: Buffer): Promise<{
+        globalHash: string;
+        quadrantHashes: {
+            q1: string;
+            q2: string;
+            q3: string;
+            q4: string;
+        };
+    }>;
+    /**
+     * @description 执行二维离散余弦变换 (DCT-II)。
+     * @param matrix - 输入的 N x N 像素亮度矩阵。
+     * @returns DCT变换后的 N x N 系数矩阵。
+     */
+    private _dct2D;
+    /**
+     * @description pHash 算法核心实现。
+     * @param imageBuffer - 图片的Buffer。
+     * @param size - 期望的哈希位数 (必须是完全平方数, 如 64 或 256)。
+     * @returns 十六进制pHash字符串。
+     */
+    private _generatePHash;
+    /**
+     * @description 计算两个十六进制哈希字符串之间的汉明距离 (不同位的数量)。
+     * @param hex1 - 第一个哈希。
+     * @param hex2 - 第二个哈希。
+     * @returns 汉明距离。
+     */
+    calculateHammingDistance(hex1: string, hex2: string): number;
+    /**
+     * @description 根据汉明距离计算相似度百分比。
+     * @param hex1 - 第一个哈希。
+     * @param hex2 - 第二个哈希。
+     * @returns 相似度 (0-100)。
+     */
+    calculateSimilarity(hex1: string, hex2: string): number;
+    /**
+     * @description 为文本生成 64 位 Simhash 字符串。
+     * @param text - 需要处理的文本。
+     * @returns 16位十六进制 Simhash 字符串。
+     */
+    generateTextSimhash(text: string): string;
+}

package/lib/NameManager.d.ts

@@ -0,0 +1,45 @@
+import { Context } from 'koishi';
+/** 数据库 `cave_user` 表的结构。 */
+export interface UserName {
+    userId: string;
+    nickname: string;
+}
+declare module 'koishi' {
+    interface Tables {
+        cave_user: UserName;
+    }
+}
+/**
+ * @class NameManager
+ * @description 负责管理用户在回声洞中的自定义昵称。
+ */
+export declare class NameManager {
+    private ctx;
+    /**
+     * @constructor
+     * @param ctx - Koishi 上下文，用于初始化数据库模型。
+     */
+    constructor(ctx: Context);
+    /**
+     * @description 注册 `.name` 子命令，用于管理用户昵称。
+     * @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/PendManager.d.ts

@@ -0,0 +1,32 @@
+import { Context, Logger } from 'koishi';
+import { CaveObject, Config } from './index';
+import { FileManager } from './FileManager';
+/**
+ * @class PendManager
+ * @description 负责处理回声洞的审核流程，处理新洞的提交、审核通知和审核操作。
+ */
+export declare class PendManager {
+    private ctx;
+    private config;
+    private fileManager;
+    private logger;
+    private reusableIds;
+    /**
+     * @param ctx Koishi 上下文。
+     * @param config 插件配置。
+     * @param fileManager 文件管理器实例。
+     * @param logger 日志记录器实例。
+     * @param reusableIds 可复用 ID 的内存缓存。
+     */
+    constructor(ctx: Context, config: Config, fileManager: FileManager, logger: Logger, reusableIds: Set<number>);
+    /**
+     * @description 注册与审核相关的子命令。
+     * @param cave - 主 `cave` 命令实例。
+     */
+    registerCommands(cave: any): void;
+    /**
+     * @description 将新回声洞提交到管理群组以供审核。
+     * @param cave 新创建的、状态为 'pending' 的回声洞对象。
+     */
+    sendForPend(cave: CaveObject): Promise<void>;
+}

package/lib/Utils.d.ts

@@ -0,0 +1,71 @@
+import { Context, h, Logger, Session } from 'koishi';
+import { CaveObject, Config, StoredElement } from './index';
+import { FileManager } from './FileManager';
+import { HashManager, CaveHashObject } from './HashManager';
+import { PendManager } from './PendManager';
+/**
+ * @description 将数据库存储的 StoredElement[] 转换为 Koishi 的 h() 元素数组。
+ * @param elements 从数据库读取的元素数组。
+ * @returns 转换后的 h() 元素数组。
+ */
+export declare function storedFormatToHElements(elements: StoredElement[]): h[];
+/**
+ * @description 构建一条用于发送的完整回声洞消息，处理不同存储后端的资源链接。
+ * @param cave 回声洞对象。
+ * @param config 插件配置。
+ * @param fileManager 文件管理器实例。
+ * @param logger 日志记录器实例。
+ * @returns 包含 h() 元素和字符串的消息数组。
+ */
+export declare function buildCaveMessage(cave: CaveObject, config: Config, fileManager: FileManager, logger: Logger): Promise<(string | h)[]>;
+/**
+ * @description 清理数据库中标记为 'delete' 状态的回声洞及其关联文件和哈希。
+ * @param ctx Koishi 上下文。
+ * @param fileManager 文件管理器实例。
+ * @param logger 日志记录器实例。
+ * @param reusableIds 可复用 ID 的内存缓存。
+ */
+export declare function cleanupPendingDeletions(ctx: Context, fileManager: FileManager, logger: Logger, reusableIds: Set<number>): Promise<void>;
+/**
+ * @description 根据配置和会话，生成数据库查询的范围条件。
+ * @param session 当前会话。
+ * @param config 插件配置。
+ * @param includeStatus 是否包含 status: 'active' 条件，默认为 true。
+ * @returns 数据库查询条件对象。
+ */
+export declare function getScopeQuery(session: Session, config: Config, includeStatus?: boolean): object;
+/**
+ * @description 获取下一个可用的回声洞 ID，采用“回收ID > 扫描空缺 > 最大ID+1”策略。
+ * @param ctx Koishi 上下文。
+ * @param query 查询范围条件。
+ * @param reusableIds 可复用 ID 的内存缓存。
+ * @returns 可用的新 ID。
+ */
+export declare function getNextCaveId(ctx: Context, query: object, reusableIds: Set<number>): Promise<number>;
+/**
+ * @description 检查用户是否处于指令冷却中。
+ * @returns 若在冷却中则提示字符串，否则 null。
+ */
+export declare function checkCooldown(session: Session, config: Config, lastUsed: Map<string, number>): string | null;
+/**
+ * @description 更新指定频道的指令使用时间戳。
+ */
+export declare function updateCooldownTimestamp(session: Session, config: Config, lastUsed: Map<string, number>): void;
+/**
+ * @description 解析消息元素，分离出文本和待下载的媒体文件。
+ * @param sourceElements 原始的 Koishi 消息元素数组。
+ * @param newId 这条回声洞的新 ID。
+ * @param session 触发操作的会话。
+ * @returns 包含数据库元素和待保存媒体列表的对象。
+ */
+export declare function processMessageElements(sourceElements: h[], newId: number, session: Session): Promise<{
+    finalElementsForDb: StoredElement[];
+    mediaToSave: {
+        sourceUrl: string;
+        fileName: string;
+    }[];
+}>;
+export declare function handleFileUploads(ctx: Context, config: Config, fileManager: FileManager, logger: Logger, reviewManager: PendManager, cave: CaveObject, mediaToToSave: {
+    sourceUrl: string;
+    fileName: string;
+}[], reusableIds: Set<number>, session: Session, hashManager: HashManager, textHashesToStore: Omit<CaveHashObject, 'cave'>[]): Promise<void>;

package/lib/index.d.ts

@@ -0,0 +1,53 @@
+import { Context, Schema } from 'koishi';
+import { CaveHashObject } from './HashManager';
+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;
+        cave_hash: CaveHashObject;
+    }
+}
+export interface Config {
+    coolDown: number;
+    perChannel: boolean;
+    adminChannel: string;
+    enableName: boolean;
+    enableIO: boolean;
+    enablePend: boolean;
+    caveFormat: string;
+    enableSimilarity: boolean;
+    textThreshold: number;
+    imageThreshold: number;
+    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;

package/lib/index.js

@@ -149,8 +149,8 @@ var FileManager = class {
   }
 };
 
-// src/ProfileManager.ts
-var ProfileManager = class {
+// src/NameManager.ts
+var NameManager = class {
   /**
    * @constructor
    * @param ctx - Koishi 上下文，用于初始化数据库模型。
@@ -165,14 +165,14 @@ var ProfileManager = class {
     });
   }
   static {
-    __name(this, "ProfileManager");
+    __name(this, "NameManager");
   }
   /**
-   * @description 注册 `.profile` 子命令，用于管理用户昵称。
+   * @description 注册 `.name` 子命令，用于管理用户昵称。
    * @param cave - 主 `cave` 命令实例。
    */
   registerCommands(cave) {
-    cave.subcommand(".profile [nickname:text]", "设置显示昵称").usage("设置在回声洞中显示的昵称。若不提供昵称，则清除现有昵称。").action(async ({ session }, nickname) => {
+    cave.subcommand(".name [nickname:text]", "设置显示昵称").usage("设置在回声洞中显示的昵称。若不提供昵称，则清除现有昵称。").action(async ({ session }, nickname) => {
       const trimmedNickname = nickname?.trim();
       if (trimmedNickname) {
         await this.setNickname(session.userId, trimmedNickname);
@@ -196,8 +196,8 @@ var ProfileManager = class {
    * @returns 用户的昵称字符串或 null。
    */
   async getNickname(userId) {
-    const [profile] = await this.ctx.database.get("cave_user", { userId });
-    return profile?.nickname ?? null;
+    const [name2] = await this.ctx.database.get("cave_user", { userId });
+    return name2?.nickname ?? null;
   }
   /**
    * @description 清除指定用户的昵称设置。
@@ -287,7 +287,7 @@ var DataManager = class {
   }
 };
 
-// src/ReviewManager.ts
+// src/PendManager.ts
 var import_koishi2 = require("koishi");
 
 // src/Utils.ts
@@ -379,6 +379,10 @@ async function getNextCaveId(ctx, query = {}, reusableIds) {
 }
 __name(getNextCaveId, "getNextCaveId");
 function checkCooldown(session, config, lastUsed) {
+  const adminChannelId = config.adminChannel?.split(":")[1];
+  if (adminChannelId && session.channelId === adminChannelId) {
+    return null;
+  }
   if (config.coolDown <= 0 || !session.channelId) return null;
   const lastTime = lastUsed.get(session.channelId) || 0;
   const remainingTime = lastTime + config.coolDown * 1e3 - Date.now();
@@ -441,7 +445,7 @@ async function handleFileUploads(ctx, config, fileManager, logger2, reviewManage
         const { globalHash, quadrantHashes } = await hashManager.generateAllImageHashes(buffer);
         for (const existing of existingGlobalHashes) {
           const similarity = hashManager.calculateSimilarity(globalHash, existing.hash);
-          if (similarity >= config.imageWholeThreshold) {
+          if (similarity >= config.imageThreshold) {
             await session.send(`图片与回声洞（${existing.cave}）的相似度（${similarity.toFixed(2)}%）超过阈值`);
             await ctx.database.upsert("cave", [{ id: cave.id, status: "delete" }]);
             cleanupPendingDeletions(ctx, fileManager, logger2, reusableIds);
@@ -466,7 +470,7 @@ async function handleFileUploads(ctx, config, fileManager, logger2, reviewManage
       }
     }
     await Promise.all(downloadedMedia.map((item) => fileManager.saveFile(item.fileName, item.buffer)));
-    const finalStatus = config.enableReview ? "pending" : "active";
+    const finalStatus = config.enablePend ? "pending" : "active";
     await ctx.database.upsert("cave", [{ id: cave.id, status: finalStatus }]);
     if (hashManager) {
       const allHashesToInsert = [...textHashesToStore, ...imageHashesToStore].map((h4) => ({ ...h4, cave: cave.id }));
@@ -476,7 +480,7 @@ async function handleFileUploads(ctx, config, fileManager, logger2, reviewManage
     }
     if (finalStatus === "pending" && reviewManager) {
       const [finalCave] = await ctx.database.get("cave", { id: cave.id });
-      if (finalCave) reviewManager.sendForReview(finalCave);
+      if (finalCave) reviewManager.sendForPend(finalCave);
     }
   } catch (fileProcessingError) {
     logger2.error(`回声洞（${cave.id}）文件处理失败:`, fileProcessingError);
@@ -486,8 +490,8 @@ async function handleFileUploads(ctx, config, fileManager, logger2, reviewManage
 }
 __name(handleFileUploads, "handleFileUploads");
 
-// src/ReviewManager.ts
-var ReviewManager = class {
+// src/PendManager.ts
+var PendManager = class {
   /**
    * @param ctx Koishi 上下文。
    * @param config 插件配置。
@@ -503,7 +507,7 @@ var ReviewManager = class {
     this.reusableIds = reusableIds;
   }
   static {
-    __name(this, "ReviewManager");
+    __name(this, "PendManager");
   }
   /**
    * @description 注册与审核相关的子命令。
@@ -516,7 +520,7 @@ var ReviewManager = class {
       }
       return null;
     }, "requireAdmin");
-    const review = cave.subcommand(".review [id:posint]", "审核回声洞").action(async ({ session }, id) => {
+    const pend = cave.subcommand(".pend [id:posint]", "审核回声洞").action(async ({ session }, id) => {
       const adminError = requireAdmin(session);
       if (adminError) return adminError;
       if (id) {
@@ -530,7 +534,7 @@ var ReviewManager = class {
       return `当前共有 ${pendingCaves.length} 条待审核回声洞，序号为：
 ${pendingCaves.map((c) => c.id).join("|")}`;
     });
-    const createReviewAction = /* @__PURE__ */ __name((actionType) => async ({ session }, id) => {
+    const createPendAction = /* @__PURE__ */ __name((actionType) => async ({ session }, id) => {
       const adminError = requireAdmin(session);
       if (adminError) return adminError;
       try {
@@ -552,23 +556,23 @@ ${pendingCaves.map((c) => c.id).join("|")}`;
         this.logger.error(`审核操作失败:`, error);
         return `操作失败: ${error.message}`;
       }
-    }, "createReviewAction");
-    review.subcommand(".Y [id:posint]", "通过审核").action(createReviewAction("approve"));
-    review.subcommand(".N [id:posint]", "拒绝审核").action(createReviewAction("reject"));
+    }, "createPendAction");
+    pend.subcommand(".Y [id:posint]", "通过审核").action(createPendAction("approve"));
+    pend.subcommand(".N [id:posint]", "拒绝审核").action(createPendAction("reject"));
   }
   /**
    * @description 将新回声洞提交到管理群组以供审核。
    * @param cave 新创建的、状态为 'pending' 的回声洞对象。
    */
-  async sendForReview(cave) {
+  async sendForPend(cave) {
     if (!this.config.adminChannel?.includes(":")) {
       this.logger.warn(`管理群组配置无效，已自动通过回声洞（${cave.id}）`);
       await this.ctx.database.upsert("cave", [{ id: cave.id, status: "active" }]);
       return;
     }
     try {
-      const reviewMessage = [`待审核`, ...await buildCaveMessage(cave, this.config, this.fileManager, this.logger)];
-      await this.ctx.broadcast([this.config.adminChannel], import_koishi2.h.normalize(reviewMessage));
+      const pendMessage = [`待审核`, ...await buildCaveMessage(cave, this.config, this.fileManager, this.logger)];
+      await this.ctx.broadcast([this.config.adminChannel], import_koishi2.h.normalize(pendMessage));
     } catch (error) {
       this.logger.error(`发送回声洞（${cave.id}）审核消息失败:`, error);
     }
@@ -624,12 +628,12 @@ var HashManager = class {
         return `操作失败: ${error.message}`;
       }
     });
-    cave.subcommand(".check", "检查相似度").usage("检查所有回声洞，找出相似度过高的内容。").action(async (argv) => {
+    cave.subcommand(".check", "检查相似度").usage("检查所有回声洞，找出相似度过高的内容。").option("textThreshold", "-t <threshold:number> 文本相似度阈值 (%)").option("imageThreshold", "-i <threshold:number> 图片相似度阈值 (%)").action(async (argv) => {
       const checkResult = adminCheck(argv);
       if (checkResult) return checkResult;
       await argv.session.send("正在检查，请稍候...");
       try {
-        return await this.checkForSimilarCaves();
+        return await this.checkForSimilarCaves(argv.options);
       } catch (error) {
         this.logger.error("检查相似度失败:", error);
         return `检查失败: ${error.message}`;
@@ -716,28 +720,33 @@ var HashManager = class {
   }
   /**
    * @description 对数据库中所有哈希进行两两比较，找出相似度过高的内容。
+   * @param options 包含临时阈值的可选对象。
    * @returns 一个包含检查结果的报告字符串。
    */
-  async checkForSimilarCaves() {
+  async checkForSimilarCaves(options = {}) {
+    const textThreshold = options.textThreshold ?? this.config.textThreshold;
+    const imageThreshold = options.imageThreshold ?? this.config.imageThreshold;
     const allHashes = await this.ctx.database.get("cave_hash", {});
     const allCaveIds = [...new Set(allHashes.map((h4) => h4.cave))];
     const textHashes = /* @__PURE__ */ new Map();
     const globalHashes = /* @__PURE__ */ new Map();
-    const quadrantHashes = /* @__PURE__ */ new Map();
+    const quadrantHashesByCave = /* @__PURE__ */ new Map();
+    const partialHashToCaves = /* @__PURE__ */ new Map();
     for (const hash of allHashes) {
       if (hash.type === "simhash") {
         textHashes.set(hash.cave, hash.hash);
       } else if (hash.type === "phash_g") {
         globalHashes.set(hash.cave, hash.hash);
       } else if (hash.type.startsWith("phash_q")) {
-        if (!quadrantHashes.has(hash.cave)) quadrantHashes.set(hash.cave, /* @__PURE__ */ new Set());
-        quadrantHashes.get(hash.cave).add(hash.hash);
+        if (!quadrantHashesByCave.has(hash.cave)) quadrantHashesByCave.set(hash.cave, /* @__PURE__ */ new Set());
+        quadrantHashesByCave.get(hash.cave).add(hash.hash);
+        if (!partialHashToCaves.has(hash.hash)) partialHashToCaves.set(hash.hash, /* @__PURE__ */ new Set());
+        partialHashToCaves.get(hash.hash).add(hash.cave);
       }
     }
     const similarPairs = {
       text: /* @__PURE__ */ new Set(),
-      global: /* @__PURE__ */ new Set(),
-      partial: /* @__PURE__ */ new Set()
+      global: /* @__PURE__ */ new Set()
     };
     for (let i = 0; i < allCaveIds.length; i++) {
       for (let j = i + 1; j < allCaveIds.length; j++) {
@@ -748,7 +757,7 @@ var HashManager = class {
         const text2 = textHashes.get(id2);
         if (text1 && text2) {
           const similarity = this.calculateSimilarity(text1, text2);
-          if (similarity >= this.config.textThreshold) {
+          if (similarity >= textThreshold) {
             similarPairs.text.add(`${pair} = ${similarity.toFixed(2)}%`);
           }
         }
@@ -756,32 +765,46 @@ var HashManager = class {
         const global2 = globalHashes.get(id2);
         if (global1 && global2) {
           const similarity = this.calculateSimilarity(global1, global2);
-          if (similarity >= this.config.imageWholeThreshold) {
+          if (similarity >= imageThreshold) {
             similarPairs.global.add(`${pair} = ${similarity.toFixed(2)}%`);
           }
         }
-        const quads1 = quadrantHashes.get(id1);
-        const quads2 = quadrantHashes.get(id2);
-        if (quads1 && quads2 && quads1.size > 0 && quads2.size > 0) {
-          let matchFound = false;
-          for (const h1 of quads1) {
-            if (quads2.has(h1)) {
-              matchFound = true;
-              break;
-            }
-          }
-          if (matchFound) {
-            similarPairs.partial.add(pair);
-          }
-        }
       }
     }
-    const totalFindings = similarPairs.text.size + similarPairs.global.size + similarPairs.partial.size;
+    const allPartialCaveIds = Array.from(quadrantHashesByCave.keys());
+    const parent = /* @__PURE__ */ new Map();
+    const find = /* @__PURE__ */ __name((i) => {
+      if (parent.get(i) === i) return i;
+      parent.set(i, find(parent.get(i)));
+      return parent.get(i);
+    }, "find");
+    const union = /* @__PURE__ */ __name((i, j) => {
+      const rootI = find(i);
+      const rootJ = find(j);
+      if (rootI !== rootJ) parent.set(rootI, rootJ);
+    }, "union");
+    allPartialCaveIds.forEach((id) => parent.set(id, id));
+    for (const caveIds of partialHashToCaves.values()) {
+      if (caveIds.size <= 1) continue;
+      const ids = Array.from(caveIds);
+      for (let i = 1; i < ids.length; i++) union(ids[0], ids[i]);
+    }
+    const components = /* @__PURE__ */ new Map();
+    for (const id of allPartialCaveIds) {
+      const root = find(id);
+      if (!components.has(root)) components.set(root, /* @__PURE__ */ new Set());
+      components.get(root).add(id);
+    }
+    const partialGroups = [];
+    for (const component of components.values()) {
+      if (component.size > 1) partialGroups.push(Array.from(component).sort((a, b) => a - b).join(" & "));
+    }
+    const totalFindings = similarPairs.text.size + similarPairs.global.size + partialGroups.length;
     if (totalFindings === 0) return "未发现高相似度的内容";
     let report = `已发现 ${totalFindings} 组高相似度的内容:`;
     if (similarPairs.text.size > 0) report += "\n文本内容相似:\n" + [...similarPairs.text].join("\n");
     if (similarPairs.global.size > 0) report += "\n图片整体相似:\n" + [...similarPairs.global].join("\n");
-    if (similarPairs.partial.size > 0) report += "\n图片局部相同:\n" + [...similarPairs.partial].join("\n");
+    if (partialGroups.length > 0) report += "\n图片局部相同:\n" + partialGroups.join("\n");
     return report.trim();
   }
   /**
@@ -949,16 +972,16 @@ var Config = import_koishi3.Schema.intersect([
   import_koishi3.Schema.object({
     coolDown: import_koishi3.Schema.number().default(10).description("冷却时间（秒）"),
     perChannel: import_koishi3.Schema.boolean().default(false).description("启用分群模式"),
-    enableProfile: import_koishi3.Schema.boolean().default(false).description("启用自定义昵称"),
+    enableName: import_koishi3.Schema.boolean().default(false).description("启用自定义昵称"),
     enableIO: import_koishi3.Schema.boolean().default(false).description("启用导入导出"),
     adminChannel: import_koishi3.Schema.string().default("onebot:").description("管理群组 ID"),
     caveFormat: import_koishi3.Schema.string().default("回声洞 ——（{id}）|—— {name}").description("自定义文本")
   }).description("基础配置"),
   import_koishi3.Schema.object({
-    enableReview: import_koishi3.Schema.boolean().default(false).description("启用审核"),
+    enablePend: import_koishi3.Schema.boolean().default(false).description("启用审核"),
     enableSimilarity: import_koishi3.Schema.boolean().default(false).description("启用查重"),
     textThreshold: import_koishi3.Schema.number().min(0).max(100).step(0.01).default(95).description("文本相似度阈值 (%)"),
-    imageWholeThreshold: import_koishi3.Schema.number().min(0).max(100).step(0.01).default(95).description("图片相似度阈值 (%)")
+    imageThreshold: import_koishi3.Schema.number().min(0).max(100).step(0.01).default(95).description("图片相似度阈值 (%)")
   }).description("复核配置"),
   import_koishi3.Schema.object({
     localPath: import_koishi3.Schema.string().description("文件映射路径"),
@@ -984,8 +1007,8 @@ function apply(ctx, config) {
   const fileManager = new FileManager(ctx.baseDir, config, logger);
   const lastUsed = /* @__PURE__ */ new Map();
   const reusableIds = /* @__PURE__ */ new Set();
-  const profileManager = config.enableProfile ? new ProfileManager(ctx) : null;
-  const reviewManager = config.enableReview ? new ReviewManager(ctx, config, fileManager, logger, reusableIds) : null;
+  const profileManager = config.enableName ? new NameManager(ctx) : null;
+  const reviewManager = config.enablePend ? new PendManager(ctx, config, fileManager, logger, reusableIds) : null;
   const hashManager = config.enableSimilarity ? new HashManager(ctx, config, logger, fileManager) : null;
   const dataManager = config.enableIO ? new DataManager(ctx, config, fileManager, logger, hashManager) : 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 }) => {
@@ -1042,9 +1065,9 @@ function apply(ctx, config) {
           }
         }
       }
-      const userName = (config.enableProfile ? await profileManager.getNickname(session.userId) : null) || session.username;
+      const userName = (config.enableName ? await profileManager.getNickname(session.userId) : null) || session.username;
       const hasMedia = mediaToSave.length > 0;
-      const initialStatus = hasMedia ? "preload" : config.enableReview ? "pending" : "active";
+      const initialStatus = hasMedia ? "preload" : config.enablePend ? "pending" : "active";
       const newCave = await ctx.database.create("cave", {
         id: newId,
         elements: finalElementsForDb,
@@ -1061,10 +1084,10 @@ function apply(ctx, config) {
           await ctx.database.upsert("cave_hash", textHashesToStore.map((h4) => ({ ...h4, cave: newCave.id })));
         }
         if (initialStatus === "pending") {
-          reviewManager.sendForReview(newCave);
+          reviewManager.sendForPend(newCave);
         }
       }
-      return initialStatus === "pending" || initialStatus === "preload" && config.enableReview ? `提交成功，序号为（${newCave.id}）` : `添加成功，序号为（${newCave.id}）`;
+      return initialStatus === "pending" || initialStatus === "preload" && config.enablePend ? `提交成功，序号为（${newCave.id}）` : `添加成功，序号为（${newCave.id}）`;
     } catch (error) {
       logger.error("添加回声洞失败:", error);
       return "添加失败，请稍后再试";
@@ -1101,17 +1124,47 @@ function apply(ctx, config) {
       return "删除失败，请稍后再试";
     }
   });
-  cave.subcommand(".list", "查询我的投稿").action(async ({ session }) => {
-    try {
-      const userCaves = await ctx.database.get("cave", { ...getScopeQuery(session, config), userId: session.userId });
-      if (!userCaves.length) return "你还没有投稿过回声洞";
-      const caveIds = userCaves.map((c) => c.id).sort((a, b) => a - b).join("|");
-      return `你已投稿 ${userCaves.length} 条回声洞，序号为：
-${caveIds}`;
-    } catch (error) {
-      logger.error("查询投稿列表失败:", error);
-      return "查询失败，请稍后再试";
+  cave.subcommand(".list", "查询投稿统计").option("user", "-u <user:user> 指定用户").option("all", "-a 查看排行").action(async ({ session, options }) => {
+    if (options.all) {
+      const adminChannelId = config.adminChannel?.split(":")[1];
+      if (session.channelId !== adminChannelId) {
+        return "此指令仅限在管理群组中使用";
+      }
+      try {
+        const allCaves = await ctx.database.get("cave", { status: "active" });
+        if (!allCaves.length) return "目前没有任何回声洞投稿。";
+        const userStats = /* @__PURE__ */ new Map();
+        for (const cave2 of allCaves) {
+          const { userId, userName: userName2 } = cave2;
+          const stat = userStats.get(userId);
+          if (stat) {
+            stat.count++;
+            stat.userName = userName2;
+          } else {
+            userStats.set(userId, { userName: userName2, count: 1 });
+          }
+        }
+        const sortedStats = Array.from(userStats.values()).sort((a, b) => b.count - a.count);
+        let report = "回声洞投稿数量排行：\n";
+        sortedStats.forEach((stat, index) => {
+          report += `${index + 1}. ${stat.userName}: ${stat.count} 条
+`;
+        });
+        return report.trim();
+      } catch (error) {
+        logger.error("查询排行失败:", error);
+        return "查询失败，请稍后再试";
+      }
     }
+    const targetUserId = options.user || session.userId;
+    const isQueryingSelf = !options.user;
+    const query = { ...getScopeQuery(session, config), userId: targetUserId };
+    const userCaves = await ctx.database.get("cave", query);
+    if (!userCaves.length) return isQueryingSelf ? "你还没有投稿过回声洞" : `用户 ${targetUserId} 还没有投稿过回声洞`;
+    const caveIds = userCaves.map((c) => c.id).sort((a, b) => a - b).join("|");
+    const userName = userCaves.sort((a, b) => b.time.getTime() - a.time.getTime())[0].userName;
+    return `${isQueryingSelf ? "你" : userName}已投稿 ${userCaves.length} 条回声洞，序号为：
+${caveIds}`;
   });
   if (profileManager) profileManager.registerCommands(cave);
   if (dataManager) dataManager.registerCommands(cave);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-best-cave",
   "description": "功能强大、高度可定制的回声洞。支持丰富的媒体类型、内容查重、人工审核、用户昵称、数据迁移以及本地/S3 双重文件存储后端。",
-  "version": "2.3.0",
+  "version": "2.3.1",
   "contributors": [
     "Yis_Rime <yis_rime@outlook.com>"
   ],