koishi-plugin-best-cave 1.3.4 → 1.4.0

package/lib/utils/HashStorage.d.ts

@@ -1,95 +1,87 @@
 /**
- * 哈希存储状态信息
- */
-interface HashStatus {
-    /** 最后更新时间戳 */
-    lastUpdated: string;
-    /** 所有回声洞的哈希值条目 */
-    entries: Array<{
-        caveId: number;
-        hashes: string[];
-    }>;
-}
-/**
- * 图片哈希值存储管理类
- * 负责管理和维护回声洞图片的哈希值
+ * 哈希存储管理类
+ * @class HashStorage
  */
 export declare class HashStorage {
     private readonly caveDir;
-    private static readonly HASH_FILE;
-    private static readonly CAVE_FILE;
-    private static readonly BATCH_SIZE;
-    private hashes;
+    private readonly filePath;
+    private readonly resourceDir;
+    private readonly caveFilePath;
+    private imageHashes;
+    private textHashes;
     private initialized;
     /**
-     * 初始化HashStorage实例
-     * @param caveDir 回声洞数据目录路径
+     * 创建哈希存储实例
+     * @param caveDir - 回声洞数据目录路径
      */
     constructor(caveDir: string);
-    private get filePath();
-    private get resourceDir();
-    private get caveFilePath();
     /**
      * 初始化哈希存储
-     * 读取现有哈希数据或重新构建哈希值
      * @throws 初始化失败时抛出错误
      */
     initialize(): Promise<void>;
     /**
-     * 获取当前哈希存储状态
-     * @returns 包含最后更新时间和所有条目的状态对象
-     */
-    getStatus(): Promise<HashStatus>;
-    /**
-     * 更新指定回声洞的图片哈希值
-     * @param caveId 回声洞ID
-     * @param imgBuffers 图片buffer数组
+     * 加载哈希数据
+     * @param data - 要加载的哈希数据
+     * @private
      */
-    updateCaveHash(caveId: number, imgBuffers?: Buffer[]): Promise<void>;
+    private loadHashData;
     /**
-     * 更新所有回声洞的哈希值
-     * @param isInitialBuild 是否为初始构建
+     * 更新指定回声洞的哈希值
+     * @param caveId - 回声洞ID
+     * @param type - 哈希类型（图像或文本）
+     * @param content - 要计算哈希的内容
      */
-    updateAllCaves(isInitialBuild?: boolean): Promise<void>;
+    updateHash(caveId: number, type: 'image' | 'text', content: Buffer | string): Promise<void>;
     /**
-     * 查找重复的图片
-     * @param imgBuffers 待查找的图片buffer数组
-     * @param threshold 相似度阈值
-     * @returns 匹配结果数组，包含索引、回声洞ID和相似度
+     * 查找重复项
+     * @param type - 查找类型（图像或文本）
+     * @param hashes - 要查找的哈希值数组
+     * @param threshold - 相似度阈值，默认为1
+     * @returns 匹配结果数组
      */
-    findDuplicates(imgBuffers: Buffer[], threshold: number): Promise<Array<{
+    findDuplicates(type: 'image' | 'text', hashes: string[], threshold?: number): Promise<Array<{
         index: number;
         caveId: number;
         similarity: number;
     } | null>>;
     /**
-     * 加载回声洞数据
-     * @returns 回声洞数据数组
+     * 清除指定回声洞的所有哈希值
+     * @param caveId - 回声洞ID
+     */
+    clearHashes(caveId: number): Promise<void>;
+    /**
+     * 构建初始哈希值
      * @private
      */
-    private loadCaveData;
+    private buildInitialHashes;
     /**
-     * 保存哈希数据到文件
+     * 更新缺失的哈希值
      * @private
      */
-    private saveHashes;
+    private updateMissingHashes;
     /**
-     * 构建初始哈希数据
+     * 处理单个回声洞的哈希值
+     * @param cave - 回声洞数据
      * @private
      */
-    private buildInitialHashes;
+    private processCaveHashes;
+    private processCaveTextHashes;
     /**
-     * 更新缺失的哈希值
+     * 保存哈希数据到文件
      * @private
      */
-    private updateMissingHashes;
+    private saveHashes;
     /**
-     * 批量处理数组项
-     * @param items 待处理项数组
-     * @param processor 处理函数
-     * @param batchSize 批处理大小
+     * 加载回声洞数据
+     * @returns 回声洞数据数组
      * @private
      */
-    private processBatch;
+    private loadCaveData;
+    /**
+     * 计算文本的哈希值
+     * @param text - 要计算哈希的文本
+     * @returns MD5哈希值
+     */
+    static hashText(text: string): string;
 }
-export {};

package/package.json

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