koishi-plugin-best-cave 1.4.1 → 1.5.1

package/lib/utils/AuditManage.d.ts

@@ -0,0 +1,43 @@
+import { Context } from 'koishi';
+import { Config } from '../index';
+import { IdManager } from './IdManage';
+export interface CaveObject {
+    cave_id: number;
+    elements: Element[];
+    contributor_number: string;
+    contributor_name: string;
+}
+interface BaseElement {
+    type: 'text' | 'img' | 'video';
+    index: number;
+}
+interface TextElement extends BaseElement {
+    type: 'text';
+    content: string;
+}
+interface MediaElement extends BaseElement {
+    type: 'img' | 'video';
+    file?: string;
+    fileName?: string;
+    fileSize?: string;
+    filePath?: string;
+}
+type Element = TextElement | MediaElement;
+export interface PendingCave extends CaveObject {
+}
+export declare class AuditManager {
+    private ctx;
+    private config;
+    private caveDir;
+    private idManager;
+    private logger;
+    constructor(ctx: Context, config: Config, caveDir: string, idManager: IdManager);
+    processAudit(pendingData: PendingCave[], isApprove: boolean, caveFilePath: string, resourceDir: string, pendingFilePath: string, session: any, targetId?: number): Promise<string>;
+    private handleSingleAudit;
+    private handleBatchAudit;
+    sendAuditMessage(cave: PendingCave, content: string, session: any): Promise<void>;
+    private deleteMediaFiles;
+    private cleanElementsForSave;
+    private sendMessage;
+}
+export {};

package/lib/utils/{ImageHasher.d.ts → ContentHash.d.ts}

@@ -3,7 +3,7 @@ import { Buffer } from 'buffer';
  * 图片哈希计算工具类
  * 使用 DCT(离散余弦变换)方法计算图片的感知哈希值，可用于图片相似度比较
  */
-export declare class ImageHasher {
+export declare class ContentHasher {
     /**
      * 计算图片的感知哈希值
      * @param imageBuffer - 图片的二进制数据
@@ -71,6 +71,12 @@ export declare class ImageHasher {
      * @returns 返回0-1之间的相似度值，1表示完全相同，0表示完全不同
      */
     static calculateSimilarity(hash1: string, hash2: string): number;
+    /**
+     * 计算文本的哈希值
+     * @param text - 输入文本
+     * @returns 文本的哈希值(36进制字符串)
+     */
+    static calculateTextHash(text: string): string;
     /**
      * 批量比较一个新哈希值与多个已存在哈希值的相似度
      * @param newHash - 新的哈希值

package/lib/utils/HashManage.d.ts

@@ -0,0 +1,108 @@
+/**
+ * 哈希存储状态类型
+ */
+interface HashStorageStatus {
+    lastUpdated: string;
+    entries: Array<{
+        caveId: number;
+        imageHashes: string[];
+        textHashes: string[];
+    }>;
+}
+/**
+ * 图片哈希值存储管理类
+ * 负责管理和维护回声洞图片的哈希值
+ */
+export declare class ContentHashManager {
+    private readonly caveDir;
+    private static readonly HASH_FILE;
+    private static readonly CAVE_FILE;
+    private static readonly BATCH_SIZE;
+    private imageHashes;
+    private textHashes;
+    private initialized;
+    /**
+     * 初始化HashManager实例
+     * @param caveDir 回声洞数据目录路径
+     */
+    constructor(caveDir: string);
+    private get filePath();
+    private get resourceDir();
+    private get caveFilePath();
+    /**
+     * 初始化哈希存储
+     * 读取现有哈希数据或重新构建哈希值
+     * @throws 初始化失败时抛出错误
+     */
+    initialize(): Promise<void>;
+    /**
+     * 获取当前哈希存储状态
+     * @returns 包含最后更新时间和所有条目的状态对象
+     */
+    getStatus(): Promise<HashStorageStatus>;
+    /**
+     * 更新指定回声洞的图片哈希值
+     * @param caveId 回声洞ID
+     * @param content 图片buffer数组
+     */
+    updateCaveContent(caveId: number, content: {
+        images?: Buffer[];
+        texts?: string[];
+    }): Promise<void>;
+    /**
+     * 更新所有回声洞的哈希值
+     * @param isInitialBuild 是否为初始构建
+     */
+    updateAllCaves(isInitialBuild?: boolean): Promise<void>;
+    /**
+     * 查找重复的图片
+     * @param content 待查找的图片buffer数组
+     * @param thresholds 相似度阈值
+     * @returns 匹配结果数组，包含索引、回声洞ID和相似度
+     */
+    findDuplicates(content: {
+        images?: Buffer[];
+        texts?: string[];
+    }, thresholds: {
+        image: number;
+        text: number;
+    }): Promise<Array<{
+        type: 'image' | 'text';
+        index: number;
+        caveId: number;
+        similarity: number;
+    } | null>>;
+    private findTextDuplicates;
+    private calculateTextSimilarity;
+    private findImageDuplicates;
+    /**
+     * 加载回声洞数据
+     * @returns 回声洞数据数组
+     * @private
+     */
+    private loadCaveData;
+    /**
+     * 保存哈希数据到文件
+     * @private
+     */
+    private saveContentHashes;
+    /**
+     * 构建初始哈希数据
+     * @private
+     */
+    private buildInitialHashes;
+    /**
+     * 更新缺失的哈希值
+     * @private
+     */
+    private updateMissingHashes;
+    /**
+     * 批量处理数组项
+     * @param items 待处理项数组
+     * @param processor 处理函数
+     * @param batchSize 批处理大小
+     * @private
+     */
+    private processBatch;
+}
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-best-cave",
   "description": "最好的 cave 插件，可开关的审核系统，可引用添加，支持图文混合内容，可查阅投稿列表，完美复刻你的 .cave 体验！",
-  "version": "1.4.1",
+  "version": "1.5.1",
   "contributors": [
     "Yis_Rime <yis_rime@outlook.com>"
   ],
@@ -26,11 +26,11 @@
   "devDependencies": {},
   "peerDependencies": {
     "koishi": "^4.18.3",
-    "sharp": "^0.32.6",
+    "sharp": "^0.33.5",
     "koishi-plugin-adapter-onebot": "^6.1.3"
   },
   "dependencies": {
-    "sharp": "^0.32.6",
+    "sharp": "^0.33.5",
     "koishi-plugin-adapter-onebot": "^6.1.3"
   }
 }

package/readme.md

@@ -15,6 +15,15 @@
   - 引用消息自动解析和保存
   - 支持引用已有内容的布局
 
+- **重复检测**
+  - 独立的文本与图片查重开关
+  - 可配置的文本相似度阈值
+  - 可配置的图片相似度阈值
+  - 基于感知哈希的图片查重
+  - 基于MD5的精确查重
+  - 精确重复自动拒绝
+  - 相似内容提示预览
+
 - **审核机制**
   - 可配置的审核开关与多级权限
   - 完整的黑白名单系统（支持用户/群组/频道）
@@ -27,9 +36,9 @@
   - 智能处理多种类型媒体链接
   - 支持本地图片上传和URL引用
   - 自动文件大小检查与限制
-  - 基于感知哈希的图片查重
-  - 可配置的相似度阈值检测
-  - MD5文件名重复检查
+  - 视频内容自动单独发送
+  - MD5文件名防重复
+  - 自动清理无效媒体
 
 - **使用体验**
   - 基于群组的调用冷却机制
@@ -64,7 +73,10 @@
 | number | number | 60 | 冷却时间(秒) |
 | enableAudit | boolean | false | 是否启用审核 |
 | imageMaxSize | number | 4 | 图片大小限制(MB) |
-| duplicateThreshold | number | 0.8 | 图片查重阈值(0-1) |
+| enableImageDuplicate | boolean | true | 是否启用图片查重 |
+| imageDuplicateThreshold | number | 0.8 | 图片查重阈值(0-1) |
+| enableTextDuplicate | boolean | true | 是否启用文本查重 |
+| textDuplicateThreshold | number | 0.9 | 文本查重阈值(0-1) |
 | allowVideo | boolean | true | 是否允许视频 |
 | videoMaxSize | number | 16 | 视频大小限制(MB) |
 | enablePagination | boolean | false | 是否启用分页 |

package/lib/utils/HashStorage.d.ts

@@ -1,92 +0,0 @@
-/**
- * 哈希存储管理类
- * @class HashStorage
- */
-export declare class HashStorage {
-    private readonly caveDir;
-    private readonly filePath;
-    private readonly resourceDir;
-    private readonly caveFilePath;
-    private imageHashes;
-    private textHashes;
-    private initialized;
-    /**
-     * 创建哈希存储实例
-     * @param caveDir - 回声洞数据目录路径
-     */
-    constructor(caveDir: string);
-    /**
-     * 初始化哈希存储
-     * @throws 初始化失败时抛出错误
-     */
-    initialize(): Promise<void>;
-    /**
-     * 加载哈希数据
-     * @param data - 要加载的哈希数据
-     * @private
-     */
-    private loadHashData;
-    /**
-     * 更新指定回声洞的哈希值
-     * @param caveId - 回声洞ID
-     * @param type - 哈希类型（图像或文本）
-     * @param content - 要计算哈希的内容
-     */
-    updateHash(caveId: number, type: 'image' | 'text', content: Buffer | string): Promise<void>;
-    /**
-     * 查找重复项
-     * @param type - 查找类型（图像或文本）
-     * @param hashes - 要查找的哈希值数组
-     * @param threshold - 相似度阈值，默认为1
-     * @returns 匹配结果数组
-     */
-    findDuplicates(type: 'image' | 'text', hashes: string[], threshold?: number): Promise<Array<{
-        index: number;
-        caveId: number;
-        similarity: number;
-    } | null>>;
-    /**
-     * 清除指定回声洞的所有哈希值
-     * @param caveId - 回声洞ID
-     */
-    clearHashes(caveId: number): Promise<void>;
-    /**
-     * 构建初始哈希值
-     * @private
-     */
-    private buildInitialHashes;
-    /**
-     * 更新缺失的哈希值
-     * @private
-     */
-    private updateMissingHashes;
-    /**
-     * 处理单个回声洞的哈希值
-     * @param cave - 回声洞数据
-     * @private
-     */
-    private processCaveHashes;
-    private processCaveTextHashes;
-    /**
-     * 保存哈希数据到文件
-     * @private
-     */
-    private saveHashes;
-    /**
-     * 加载回声洞数据
-     * @returns 回声洞数据数组
-     * @private
-     */
-    private loadCaveData;
-    /**
-     * 计算文本的哈希值
-     * @param text - 要计算哈希的文本
-     * @returns MD5哈希值
-     */
-    static hashText(text: string): string;
-    /**
-     * 获取存储统计数据
-     * @private
-     */
-    private getStorageStats;
-}