koishi-plugin-best-cave 1.2.0 → 1.3.0

package/lib/utils/HashStorage.d.ts

@@ -0,0 +1,34 @@
+interface HashStatus {
+    lastUpdated: string;
+    entries: Array<{
+        caveId: number;
+        hashes: string[];
+    }>;
+}
+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 initialized;
+    constructor(caveDir: string);
+    private get filePath();
+    private get resourceDir();
+    private get caveFilePath();
+    initialize(): Promise<void>;
+    getStatus(): Promise<HashStatus>;
+    updateCaveHash(caveId: number, imgBuffers?: Buffer[]): Promise<void>;
+    updateAllCaves(isInitialBuild?: boolean): Promise<void>;
+    findDuplicates(imgBuffers: Buffer[], threshold: number): Promise<Array<{
+        index: number;
+        caveId: number;
+        similarity: number;
+    } | null>>;
+    private loadCaveData;
+    private saveHashes;
+    private buildInitialHashes;
+    private updateMissingHashes;
+    private processBatch;
+}
+export {};

package/lib/utils/ImageHasher.d.ts

@@ -0,0 +1,27 @@
+import { Buffer } from 'buffer';
+/**
+ * 图片哈希计算
+ */
+export declare class ImageHasher {
+    /**
+     * 计算图片哈希值
+     */
+    static calculateHash(imageBuffer: Buffer): Promise<string>;
+    private static binaryToHex;
+    private static hexToBinary;
+    private static haarWaveletTransform;
+    private static haarTransform1D;
+    private static extractFeatures;
+    /**
+     * 计算两个hash值的汉明距离
+     */
+    static calculateDistance(hash1: string, hash2: string): number;
+    /**
+     * 计算图片相似度(0-1)
+     */
+    static calculateSimilarity(hash1: string, hash2: string): number;
+    /**
+     * 批量比较图片相似度
+     */
+    static batchCompareSimilarity(newHash: string, existingHashes: string[]): number[];
+}

package/lib/utils/fileHandler.d.ts

@@ -0,0 +1,19 @@
+export declare class FileHandler {
+    private static locks;
+    private static readonly RETRY_COUNT;
+    private static readonly RETRY_DELAY;
+    private static readonly CONCURRENCY_LIMIT;
+    private static withConcurrencyLimit;
+    private static withFileOp;
+    static withTransaction<T>(operations: Array<{
+        filePath: string;
+        operation: () => Promise<T>;
+        rollback?: () => Promise<void>;
+    }>): Promise<T[]>;
+    static readJsonData<T>(filePath: string): Promise<T[]>;
+    static writeJsonData<T>(filePath: string, data: T[]): Promise<void>;
+    static ensureDirectory(dir: string): Promise<void>;
+    static ensureJsonFile(filePath: string): Promise<void>;
+    static saveMediaFile(filePath: string, data: Buffer | string): Promise<void>;
+    static deleteMediaFile(filePath: string): Promise<void>;
+}

package/lib/utils/idManager.d.ts

@@ -0,0 +1,17 @@
+export declare class IdManager {
+    private deletedIds;
+    private maxId;
+    private initialized;
+    private readonly statusFilePath;
+    private stats;
+    private usedIds;
+    constructor(baseDir: string);
+    initialize(caveFilePath: string, pendingFilePath: string): Promise<void>;
+    private handleConflicts;
+    getNextId(): number;
+    markDeleted(id: number): Promise<void>;
+    addStat(contributorNumber: string, caveId: number): Promise<void>;
+    removeStat(contributorNumber: string, caveId: number): Promise<void>;
+    getStats(): Record<string, number[]>;
+    private saveStatus;
+}

package/package.json

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

package/readme.md

@@ -9,11 +9,14 @@
 ### 核心功能
 
 - 支持文字与图片混合保存
-- 智能处理各类图片链接
-- 可选的视频内容支持
+- 智能处理各类图片与视频链接
+- 内容智能排序，保持原始布局
 - 完整的权限管理系统
 - 可选的内容审核流程
 - 群组调用冷却机制
+- 重复内容智能检测
+- 黑白名单系统
+- 分页显示支持
 
 ### 指令
 
@@ -23,19 +26,37 @@
 | `cave -a <内容>` | 添加新回声洞（支持文字、图片与视频） | 所有人 |
 | `cave -g <编号>` | 查看指定回声洞 | 所有人 |
 | `cave -r <编号>` | 删除指定回声洞 | 内容贡献者/管理员 |
+| `cave -l [页码/用户ID]` | 查看投稿统计 | 所有人(仅自己)/管理员(全部) |
 
 #### 管理指令
 
 | 指令 | 说明 | 权限 |
 |------|------|------|
-| `cave -l [用户ID]` | 查看投稿统计 | 管理员 |
 | `cave -p <编号/all>` | 通过待审核内容 | 管理员 |
 | `cave -d <编号/all>` | 拒绝待审核内容 | 管理员 |
 
+### 配置项
+
+| 配置项 | 类型 | 默认值 | 说明 |
+|--------|------|--------|------|
+| manager | string[] | [] | 管理员用户ID列表 |
+| number | number | 60 | 冷却时间(秒) |
+| enableAudit | boolean | false | 是否启用审核 |
+| imageMaxSize | number | 4 | 图片大小限制(MB) |
+| duplicateThreshold | number | 0.8 | 图片查重阈值(0-1) |
+| allowVideo | boolean | true | 是否允许视频 |
+| videoMaxSize | number | 16 | 视频大小限制(MB) |
+| enablePagination | boolean | false | 是否启用分页 |
+| itemsPerPage | number | 10 | 每页显示条数 |
+| blacklist | string[] | [] | 黑名单用户/群组ID |
+| whitelist | string[] | [] | 白名单用户/群组ID |
+
 ### 注意事项
 
-1. 图片以及视频会自动保存到本地，请确保存储空间充足。
-2. 管理员不受群组冷却时间限制。
-3. 开启审核模式后，新内容需要审核才能生效。
-4. 引用消息添加支持保留原消息格式。
-5. 配置文件中可分别调整是否允许添加视频，以及各自的文件大小限制。
+1. 图片和视频会自动保存到本地，请确保存储空间充足
+2. 管理员不受群组冷却时间限制
+3. 开启审核模式后，白名单内的用户可直接投稿
+4. 引用消息添加时会保留原消息的格式与布局
+5. 支持自动检测重复图片内容，可通过阈值调整严格程度
+6. 黑名单中的用户无法使用任何功能
+7. 支持按页码查看投稿统计，提升大量数据的浏览体验