koishi-plugin-best-cave 1.7.3 → 2.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-best-cave",
-  "description": "回声洞，可自由添加内容，可配置 MD5/pHash 查重，支持查阅投稿列表（可用但等待重构）",
-  "version": "1.7.3",
+  "description": "最强大的回声洞现已重构完成啦！注意数据格式需要使用脚本转换哦~",
+  "version": "2.0.0",
   "contributors": [
     "Yis_Rime <yis_rime@outlook.com>"
   ],
@@ -16,7 +16,7 @@
     "lib",
     "dist"
   ],
-  "license": "GPL-3.0",
+  "license": "AGPL-3.0-only",
   "keywords": [
     "chatbot",
     "koishi",
@@ -28,6 +28,6 @@
     "koishi": "^4.18.3"
   },
   "dependencies": {
-    "sharp": "^0.33.5"
+    "@aws-sdk/client-s3": "^3.300.0"
   }
 }

package/readme.md

@@ -2,101 +2,78 @@
 
 [![npm](https://img.shields.io/npm/v/koishi-plugin-best-cave?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-best-cave)
 
-回声洞，可自由添加内容（包括视频），具有可配置的 MD5/pHash 查重机制和可开关的审核系统，支持查阅投稿列表
+一款功能强大且灵活的回声洞插件，支持丰富的媒体类型、可插拔的功能模块和双重存储后端（本地或 S3）。
 
-## 功能亮点
+## ✨ 功能亮点
 
-- 支持文字、图片与视频内容
-- 审核与自动查重机制
-- 黑白名单管理
-- 完善的用户统计
+- **丰富的媒体支持**：不止于文本，轻松发布包含图片、视频、音频甚至文件的混合内容。插件会自动处理消息引用，解析并保存其内容。
+- **双重存储后端**：可根据需求选择将媒体文件存储在 **本地服务器** (`data/cave` 目录) 或 **AWS S3** 兼容的云端对象存储中，便于扩展和管理。
+- **可选的审核机制**：可开启审核模式 (`enableReview`)。开启后，所有新提交的内容都需要管理员审核通过才会进入公共池，确保内容质量。
+- **作用域隔离**：通过 `perChannel` 配置，可设定回声洞是在所有群聊中共享（全局模式），还是在每个群聊中独立（分群模式）。
+- **用户身份定制**：当 `enableProfile` 开启时，用户可以为自己在回声洞中的发言设置一个专属昵称。
+- **便捷的数据管理**：管理员可以通过指令轻松地将所有回声洞数据导出为 `JSON` 文件备份，或从文件中恢复数据，迁移无忧 (`enableDataIO`)。
+- **完善的权限控制**：通过 `adminUsers` 列表指定管理员，只有管理员才能执行审核、数据迁移和删除任意投稿等高级操作。
 
-## 核心功能
+## 📖 指令说明
 
-- **内容管理**
-  - 文字与图片混合保存，自动保持布局顺序
-  - 视频内容单独发送，支持多种格式
-  - 自动文本格式化与排版
-  - 引用消息自动解析和保存
+### 核心指令
 
-- **重复检测**
-  - 基于感知哈希的图片查重
-  - 基于MD5的精确查重
-  - 相似内容提示预览
+| 指令 | 别名/选项 | 说明 |
+| :--- | :--- | :--- |
+| `cave` | | 随机查看一条回声洞。 |
+| `cave.add <内容>` | `cave -a <内容>` | 添加一条新的回声洞。可以直接在指令后跟内容，也可以回复或引用一条消息来添加。 |
+| `cave.view <序号>` | `cave -g <序号>` | 查看指定序号的回声洞。 |
+| `cave.del <序号>` | `cave -r <序号>` | 删除指定序号的回声洞。仅投稿人或管理员可操作。 |
+| `cave.list` | `cave -l` | 查询并列出自己投稿过的所有回声洞序号。 |
 
-- **审核机制**
-  - 完整的黑白名单系统
-  - 白名单用户自动跳过审核
-  - 拒绝审核时自动清理媒体文件
+### 模块化指令
 
-- **媒体处理**
-  - 智能处理多种类型媒体链接
-  - 支持本地图片上传和URL引用
-  - 自动文件大小检查与限制
+这些指令只有在配置中启用了相应功能后才可用。
 
-## 指令说明
+| 指令 | 所需配置 | 说明 |
+| :--- | :--- | :--- |
+| `cave.profile [昵称]` | `enableProfile: true` | 设置你在回声洞中显示的昵称。若不提供昵称，则清除设置。 |
+| `cave.review` | `enableReview: true` | **(仅管理员)** 列出所有待审核的回声洞。 |
+| `cave.review <序号>` | `enableReview: true` | **(仅管理员)** 查看指定待审核内容的详情。 |
+| `cave.review <序号> <Y/N>` | `enableReview: true` | **(仅管理员)** 审核指定内容。`Y` (或 `yes`, `pass`) 表示通过，`N` (或 `no`, `reject`) 表示拒绝。 |
+| `cave.export` | `enableDataIO: true` | **(仅管理员)** 将所有回声洞数据导出到 `cave_export.json` 文件中。 |
+| `cave.import` | `enableDataIO: true` | **(仅管理员)** 从 `cave_import.json` 文件中导入数据。 |
 
-### 基础指令
+## ⚙️ 配置说明
 
-| 指令 | 示例 | 说明 |
-|------|------|------|
-| `cave` | `cave` | 随机抽取一条回声洞 |
-| `cave -a` | `cave -a 内容` | 添加新回声洞 |
-| `cave -g` | `cave -g 123` | 查看指定编号回声洞 |
-| `cave -r` | `cave -r 123` | 删除指定回声洞 |
-| `cave -l` | `cave -l 2` 或 `cave -l 114514` | 查看统计或指定用户投稿 |
-
-### 审核指令 (仅管理员)
-
-| 指令 | 示例 | 说明 |
-|------|------|------|
-| `cave.pass` | `cave.pass 123` 或 `cave.pass all` | 通过指定/所有待审核内容 |
-| `cave.reject` | `cave.reject 123` 或 `cave.reject all` | 拒绝指定/所有待审核内容 |
-
-## 配置说明
+插件配置分为三个部分：基础配置、审核配置和存储配置。
 
 ### 基础配置
 
 | 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| manager | string[] | [] | 管理员ID列表 |
-| number | number | 60 | 冷却时间(秒) |
-| enablePagination | boolean | false | 启用统计分页 |
-| itemsPerPage | number | 10 | 每页显示数目 |
-
-### 权限管理
-
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| enableAudit | boolean | false | 启用审核机制 |
-| blacklist | string[] | [] | 黑名单(用户) |
-| whitelist | string[] | [] | 白名单(用户/群组/频道) |
+| :--- | :--- | :--- | :--- |
+| `cooldown` | `number` | `10` | 指令冷却时间（秒）。管理员不受此限制。 |
+| `perChannel` | `boolean` | `false` | 是否启用分群模式。`true` 表示每个群的回声洞独立，`false` 表示所有群共享一个回声洞池。 |
+| `adminUsers` | `string[]` | `[]` | 管理员的用户 ID 列表。 |
+| `enableProfile` | `boolean` | `false` | 是否启用自定义昵称功能 (`cave.profile` 指令)。 |
+| `enableDataIO` | `boolean` | `false` | 是否启用数据导入/导出功能 (`cave.export` / `.import` 指令)。 |
 
-### 查重配置
+### 审核配置
 
 | 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| enableTextDuplicate | boolean | true | 启用文本查重 |
-| textDuplicateThreshold | number | 0.9 | 文本相似度阈值 |
-| enableImageDuplicate | boolean | true | 启用图片查重 |
-| imageDuplicateThreshold | number | 0.8 | 图片相似度阈值 |
+| :--- | :--- | :--- | :--- |
+| `enableReview` | `boolean` | `false` | 是否启用审核机制。启用后，新投稿将进入待审核状态，并由管理员使用 `cave.review` 指令处理。 |
 
-### 媒体配置
+### 存储配置
 
 | 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| imageMaxSize | number | 4 | 图片最大大小(MB) |
-| allowVideo | boolean | true | 允许视频上传 |
-| videoMaxSize | number | 16 | 视频最大大小(MB) |
-
-## 注意事项
-
-1. 图片和视频会自动保存到本地，请确保存储空间充足
-2. 管理员不受群组冷却时间限制且可查看所有用户统计
-3. 开启审核模式后，白名单内的用户可直接投稿
-4. 支持两种重复检测机制：
-   - 基于MD5的精确查重
-   - 基于感知哈希的相似度查重
-5. 临时消息（如错误提示）会在10秒后自动消失
-6. 视频内容会单独发送以保证正常显示
-7. 支持自动清理被拒绝或删除的媒体文件
+| :--- | :--- | :--- | :--- |
+| `enableS3` | `boolean` | `false` | 是否启用 S3 存储。若为 `false`，所有媒体文件将保存在本地 `data/cave` 目录下。 |
+| `endpoint` | `string` | | **(S3 必填)** S3 兼容存储的 Endpoint URL。 |
+| `bucket` | `string` | | **(S3 必填)** S3 存储桶 (Bucket) 名称。 |
+| `region` | `string` | `'auto'` | **(S3 可选)** S3 区域 (Region)。 |
+| `publicUrl` | `string` | | **(S3 可选)** S3 存储桶的公共访问 URL。如果提供，插件将直接用此 URL 拼接文件名来访问资源，否则将尝试使用 Base64 格式发送媒体。 |
+| `accessKeyId` | `string` | | **(S3 必填)** S3 访问密钥 ID。 |
+| `secretAccessKey` | `string` | | **(S3 必填)** S3 秘密访问密钥。 |
+
+## ⚠️ 注意事项
+
+1. **文件存储**：所有媒体文件（图片、视频等）会根据配置保存在本地 `data/cave` 目录或 S3 存储桶中。请确保 Koishi 拥有对本地目录的读写权限，或 S3 配置正确无误。
+2. **S3 公共访问**：如果启用了 S3 并配置了 `publicUrl`，请确保该 URL 指向的存储桶策略允许公共读取，否则媒体文件将无法正常显示。
+3. **删除机制**：删除操作（`cave.del` 或审核拒绝）并非立即从数据库和文件系统中移除。内容会被标记为 `delete` 状态，并在后台任务中被异步清理，以避免阻塞当前指令的响应。
+4. **数据导入/导出**：导入功能会读取插件工作目录下的 `cave_import.json` 文件。请在执行导入指令前，将数据文件放置在正确位置。导出会生成 `cave_export.json`。

package/lib/index.d.ts

@@ -1,86 +0,0 @@
-import { Context, Schema } from 'koishi';
-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\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";
-/**
- * 基础元素类型
- * @interface BaseElement
- * @property {('text'|'img'|'video')} type - 元素类型
- * @property {number} index - 排序索引
- */
-export interface BaseElement {
-    type: 'text' | 'img' | 'video';
-    index: number;
-}
-/**
- * 文本元素类型
- * @interface TextElement
- * @extends {BaseElement}
- * @property {'text'} type - 文本类型
- * @property {string} content - 文本内容
- */
-export interface TextElement extends BaseElement {
-    type: 'text';
-    content: string;
-}
-/**
- * 媒体元素类型
- * @interface MediaElement
- * @extends {BaseElement}
- * @property {('img'|'video')} type - 媒体类型
- * @property {string} [file] - 文件名
- * @property {string} [fileName] - 原始文件名
- * @property {string} [fileSize] - 文件大小
- * @property {string} [filePath] - 文件路径
- */
-export interface MediaElement extends BaseElement {
-    type: 'img' | 'video';
-    file?: string;
-    fileName?: string;
-    fileSize?: string;
-    filePath?: string;
-}
-export type Element = TextElement | MediaElement;
-/**
- * 回声洞对象
- * @interface CaveObject
- * @property {number} cave_id - 回声洞ID
- * @property {Element[]} elements - 元素列表
- * @property {string} contributor_number - 投稿者ID
- * @property {string} contributor_name - 投稿者名称
- */
-export interface CaveObject {
-    cave_id: number;
-    elements: Element[];
-    contributor_number: string;
-    contributor_name: string;
-}
-export interface PendingCave extends CaveObject {
-}
-export interface Config {
-    manager: string[];
-    number: number;
-    enableAudit: boolean;
-    allowVideo: boolean;
-    videoMaxSize: number;
-    imageMaxSize: number;
-    blacklist: string[];
-    whitelist: string[];
-    enablePagination: boolean;
-    itemsPerPage: number;
-    enableImageDuplicate: boolean;
-    imageDuplicateThreshold: number;
-    textDuplicateThreshold: number;
-    enableTextDuplicate: boolean;
-}
-/**
- * 插件配置项
- * @type {Schema}
- */
-export declare const Config: Schema<Config>;
-/**
- * 插件主入口
- * @param {Context} ctx - Koishi上下文
- * @param {Config} config - 插件配置
- */
-export declare function apply(ctx: Context, config: Config): Promise<void>;

package/lib/utils/AuditHandler.d.ts

@@ -1,89 +0,0 @@
-import { Context } from 'koishi';
-import { Config, PendingCave } from '..';
-import { IdManager } from './IdManager';
-/**
- * 管理洞审核相关操作的类
- */
-export declare class AuditManager {
-    private ctx;
-    private config;
-    private idManager;
-    private logger;
-    /**
-     * 创建审核管理器实例
-     * @param ctx - Koishi 上下文
-     * @param config - 配置对象
-     * @param idManager - ID 管理器实例
-     */
-    constructor(ctx: Context, config: Config, idManager: IdManager);
-    /**
-     * 处理审核操作
-     * @param pendingData - 待审核的洞数据数组
-     * @param isApprove - 是否通过审核
-     * @param caveFilePath - 洞数据文件路径
-     * @param resourceDir - 资源目录路径
-     * @param pendingFilePath - 待审核数据文件路径
-     * @param session - 会话对象
-     * @param targetId - 目标洞ID（可选）
-     * @returns 处理结果消息
-     */
-    processAudit(pendingData: PendingCave[], isApprove: boolean, caveFilePath: string, resourceDir: string, pendingFilePath: string, session: any, targetId?: number): Promise<string>;
-    /**
-     * 处理单条审核
-     * @param pendingData - 待审核的洞数据数组
-     * @param isApprove - 是否通过审核
-     * @param caveFilePath - 洞数据文件路径
-     * @param resourceDir - 资源目录路径
-     * @param pendingFilePath - 待审核数据文件路径
-     * @param targetId - 目标洞ID
-     * @param session - 会话对象
-     * @returns 处理结果消息
-     * @private
-     */
-    private handleSingleAudit;
-    /**
-     * 处理批量审核
-     * @param pendingData - 待审核的洞数据数组
-     * @param isApprove - 是否通过审核
-     * @param caveFilePath - 洞数据文件路径
-     * @param resourceDir - 资源目录路径
-     * @param pendingFilePath - 待审核数据文件路径
-     * @param session - 会话对象
-     * @returns 处理结果消息
-     * @private
-     */
-    private handleBatchAudit;
-    /**
-     * 发送审核消息给管理员
-     * @param cave - 待审核的洞数据
-     * @param content - 消息内容
-     * @param session - 会话对象
-     */
-    sendAuditMessage(cave: PendingCave, content: string, session: any): Promise<void>;
-    /**
-     * 删除媒体文件
-     * @param cave - 洞数据
-     * @param resourceDir - 资源目录路径
-     * @private
-     */
-    private deleteMediaFiles;
-    /**
-     * 清理元素数据用于保存
-     * @param elements - 元素数组
-     * @param keepIndex - 是否保留索引
-     * @returns 清理后的元素数组
-     * @private
-     */
-    private cleanElementsForSave;
-    /**
-     * 发送消息
-     * @param session - 会话对象
-     * @param key - 消息key
-     * @param params - 消息参数
-     * @param isTemp - 是否为临时消息
-     * @param timeout - 临时消息超时时间
-     * @returns 空字符串
-     * @private
-     */
-    private sendMessage;
-}

package/lib/utils/ContentHasher.d.ts

@@ -1,80 +0,0 @@
-import { Buffer } from 'buffer';
-/**
- * 图片哈希计算工具类
- * 使用 DCT(离散余弦变换)方法计算图片的感知哈希值，可用于图片相似度比较
- */
-export declare class ContentHasher {
-    /**
-     * 计算图片的感知哈希值
-     * @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 text - 输入文本
-     * @returns 文本的哈希值(36进制字符串)
-     */
-    static calculateTextHash(text: string): string;
-}

package/lib/utils/FileHandler.d.ts

@@ -1,63 +0,0 @@
-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/HashManager.d.ts

@@ -1,108 +0,0 @@
-/**
- * 哈希存储状态类型
- */
-interface HashStorageStatus {
-    lastUpdated: string;
-    entries: Array<{
-        caveId: number;
-        imageHashes: string[];
-        textHashes: string[];
-    }>;
-}
-/**
- * 图片哈希值存储管理类
- * 负责管理和维护回声洞图片的哈希值
- */
-export declare class HashManager {
-    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/lib/utils/IdManager.d.ts

@@ -1,69 +0,0 @@
-/**
- * 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;
-}