koishi-plugin-best-cave 1.2.0 → 1.3.1

package/lib/utils/HashStorage.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 哈希存储状态信息
+ */
+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;
+    /**
+     * 初始化HashStorage实例
+     * @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数组
+     */
+    updateCaveHash(caveId: number, imgBuffers?: Buffer[]): Promise<void>;
+    /**
+     * 更新所有回声洞的哈希值
+     * @param isInitialBuild 是否为初始构建
+     */
+    updateAllCaves(isInitialBuild?: boolean): Promise<void>;
+    /**
+     * 查找重复的图片
+     * @param imgBuffers 待查找的图片buffer数组
+     * @param threshold 相似度阈值
+     * @returns 匹配结果数组，包含索引、回声洞ID和相似度
+     */
+    findDuplicates(imgBuffers: Buffer[], threshold: number): Promise<Array<{
+        index: number;
+        caveId: number;
+        similarity: number;
+    } | null>>;
+    /**
+     * 加载回声洞数据
+     * @returns 回声洞数据数组
+     * @private
+     */
+    private loadCaveData;
+    /**
+     * 保存哈希数据到文件
+     * @private
+     */
+    private saveHashes;
+    /**
+     * 构建初始哈希数据
+     * @private
+     */
+    private buildInitialHashes;
+    /**
+     * 更新缺失的哈希值
+     * @private
+     */
+    private updateMissingHashes;
+    /**
+     * 批量处理数组项
+     * @param items 待处理项数组
+     * @param processor 处理函数
+     * @param batchSize 批处理大小
+     * @private
+     */
+    private processBatch;
+}
+export {};

package/lib/utils/ImageHasher.d.ts

@@ -0,0 +1,81 @@
+import { Buffer } from 'buffer';
+/**
+ * 图片哈希计算工具类
+ * 使用 DCT(离散余弦变换)方法计算图片的感知哈希值，可用于图片相似度比较
+ */
+export declare class ImageHasher {
+    /**
+     * 计算图片的感知哈希值
+     * @param imageBuffer - 图片的二进制数据
+     * @returns 返回64位的十六进制哈希字符串
+     * @throws 当图片处理失败时可能抛出错误
+     */
+    static calculateHash(imageBuffer: Buffer): Promise<string>;
+    /**
+     * 将二进制字符串转换为十六进制
+     * @param binary - 二进制字符串
+     * @returns 十六进制字符串
+     * @private
+     */
+    private static binaryToHex;
+    /**
+     * 将十六进制字符串转换为二进制
+     * @param hex - 十六进制字符串
+     * @returns 二进制字符串
+     * @private
+     */
+    private static hexToBinary;
+    /**
+     * 计算图像的DCT(离散余弦变换)
+     * @param data - 图像数据
+     * @param size - 图像尺寸
+     * @returns DCT变换后的矩阵
+     * @private
+     */
+    private static computeDCT;
+    /**
+     * 获取DCT系数
+     * @param index - 索引值
+     * @param size - 矩阵大小
+     * @returns DCT系数
+     * @private
+     */
+    private static getDCTCoefficient;
+    /**
+     * 计算数组的中位数
+     * @param arr - 输入数组
+     * @returns 中位数
+     * @private
+     */
+    private static calculateMedian;
+    /**
+     * 从DCT矩阵中提取特征值
+     * @param matrix - DCT矩阵
+     * @param size - 矩阵大小
+     * @returns 特征值数组
+     * @private
+     */
+    private static extractFeatures;
+    /**
+     * 计算两个哈希值之间的汉明距离
+     * @param hash1 - 第一个哈希值
+     * @param hash2 - 第二个哈希值
+     * @returns 汉明距离
+     * @throws 当两个哈希值长度不等时抛出错误
+     */
+    static calculateDistance(hash1: string, hash2: string): number;
+    /**
+     * 计算两个图片哈希值的相似度
+     * @param hash1 - 第一个哈希值
+     * @param hash2 - 第二个哈希值
+     * @returns 返回0-1之间的相似度值，1表示完全相同，0表示完全不同
+     */
+    static calculateSimilarity(hash1: string, hash2: string): number;
+    /**
+     * 批量比较一个新哈希值与多个已存在哈希值的相似度
+     * @param newHash - 新的哈希值
+     * @param existingHashes - 已存在的哈希值数组
+     * @returns 相似度数组，每个元素对应一个已存在哈希值的相似度
+     */
+    static batchCompareSimilarity(newHash: string, existingHashes: string[]): number[];
+}

package/lib/utils/fileHandler.d.ts

@@ -0,0 +1,63 @@
+export declare class FileHandler {
+    private static locks;
+    private static readonly RETRY_COUNT;
+    private static readonly RETRY_DELAY;
+    private static readonly CONCURRENCY_LIMIT;
+    /**
+     * 并发控制
+     * @param operation 要执行的操作
+     * @param limit 并发限制
+     * @returns 操作结果
+     */
+    private static withConcurrencyLimit;
+    /**
+     * 文件操作包装器
+     * @param filePath 文件路径
+     * @param operation 要执行的操作
+     * @returns 操作结果
+     */
+    private static withFileOp;
+    /**
+     * 事务处理
+     * @param operations 要执行的操作数组
+     * @returns 操作结果数组
+     */
+    static withTransaction<T>(operations: Array<{
+        filePath: string;
+        operation: () => Promise<T>;
+        rollback?: () => Promise<void>;
+    }>): Promise<T[]>;
+    /**
+     * 读取 JSON 数据
+     * @param filePath 文件路径
+     * @returns JSON 数据
+     */
+    static readJsonData<T>(filePath: string): Promise<T[]>;
+    /**
+     * 写入 JSON 数据
+     * @param filePath 文件路径
+     * @param data 要写入的数据
+     */
+    static writeJsonData<T>(filePath: string, data: T[]): Promise<void>;
+    /**
+     * 确保目录存在
+     * @param dir 目录路径
+     */
+    static ensureDirectory(dir: string): Promise<void>;
+    /**
+     * 确保 JSON 文件存在
+     * @param filePath 文件路径
+     */
+    static ensureJsonFile(filePath: string): Promise<void>;
+    /**
+     * 保存媒体文件
+     * @param filePath 文件路径
+     * @param data 文件数据
+     */
+    static saveMediaFile(filePath: string, data: Buffer | string): Promise<void>;
+    /**
+     * 删除媒体文件
+     * @param filePath 文件路径
+     */
+    static deleteMediaFile(filePath: string): Promise<void>;
+}

package/lib/utils/idManager.d.ts

@@ -0,0 +1,69 @@
+/**
+ * ID管理器类
+ * 负责管理回声洞ID的分配、删除和统计信息
+ */
+export declare class IdManager {
+    private deletedIds;
+    private maxId;
+    private initialized;
+    private readonly statusFilePath;
+    private stats;
+    private usedIds;
+    /**
+     * 初始化ID管理器
+     * @param baseDir - 基础目录路径
+     */
+    constructor(baseDir: string);
+    /**
+     * 初始化ID管理系统
+     * @param caveFilePath - 正式回声洞数据文件路径
+     * @param pendingFilePath - 待处理回声洞数据文件路径
+     * @throws 当初始化失败时抛出错误
+     */
+    initialize(caveFilePath: string, pendingFilePath: string): Promise<void>;
+    /**
+     * 处理ID冲突
+     * @param conflicts - ID冲突映射表
+     * @param caveFilePath - 正式回声洞数据文件路径
+     * @param pendingFilePath - 待处理回声洞数据文件路径
+     * @param caveData - 正式回声洞数据
+     * @param pendingData - 待处理回声洞数据
+     * @private
+     */
+    private handleConflicts;
+    /**
+     * 获取下一个可用的ID
+     * @returns 下一个可用的ID
+     * @throws 当ID管理器未初始化时抛出错误
+     */
+    getNextId(): number;
+    /**
+     * 标记ID为已删除状态
+     * @param id - 要标记为删除的ID
+     * @throws 当ID管理器未初始化时抛出错误
+     */
+    markDeleted(id: number): Promise<void>;
+    /**
+     * 添加贡献统计
+     * @param contributorNumber - 贡献者编号
+     * @param caveId - 回声洞ID
+     */
+    addStat(contributorNumber: string, caveId: number): Promise<void>;
+    /**
+     * 移除贡献统计
+     * @param contributorNumber - 贡献者编号
+     * @param caveId - 回声洞ID
+     */
+    removeStat(contributorNumber: string, caveId: number): Promise<void>;
+    /**
+     * 获取所有贡献统计信息
+     * @returns 贡献者编号到回声洞ID列表的映射
+     */
+    getStats(): Record<string, number[]>;
+    /**
+     * 保存当前状态到文件
+     * @private
+     * @throws 当保存失败时抛出错误
+     */
+    private saveStatus;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-best-cave",
   "description": "最好的 cave 插件，可开关的审核系统，可引用添加，支持图文混合内容，可查阅投稿列表，完美复刻你的 .cave 体验！",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "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. 支持按页码查看投稿统计，提升大量数据的浏览体验