koishi-plugin-best-cave 1.5.0 → 1.5.1

package/lib/index.js

@@ -33,14 +33,14 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/locales/zh-CN.yml
 var require_zh_CN = __commonJS({
   "src/locales/zh-CN.yml"(exports2, module2) {
-    module2.exports = { _config: { manager: "管理员", number: "冷却时间（秒）", enableAudit: "启用审核", enableTextDuplicate: "启用文本查重", textDuplicateThreshold: "文本相似度阈值（0-1）", enableImageDuplicate: "启用图片查重", imageDuplicateThreshold: "图片相似度阈值（0-1）", imageMaxSize: "图片最大大小（MB）", allowVideo: "允许视频上传", videoMaxSize: "视频最大大小（MB）", enablePagination: "启用统计分页", itemsPerPage: "每页显示数目", blacklist: "黑名单（用户）", whitelist: "审核白名单（用户/群组/频道）" }, commands: { cave: { description: "回声洞", usage: "支持添加、抽取、查看、管理回声洞", examples: "使用 cave 随机抽取回声洞\n使用 -a 直接添加或引用添加\n使用 -g 查看指定回声洞\n使用 -r 删除指定回声洞", options: { a: "添加回声洞", g: "查看回声洞", r: "删除回声洞", p: "通过审核（批量）", d: "拒绝审核（批量）", l: "查询投稿统计" }, add: { noContent: "请在一分钟内发送内容", operationTimeout: "操作超时，添加取消", videoDisabled: "不允许上传视频", submitPending: "提交成功，序号为（{0}）", addSuccess: "添加成功，序号为（{0}）", mediaSizeExceeded: "{0}文件大小超过限制", localFileNotAllowed: "检测到本地文件路径，无法保存" }, remove: { noPermission: "你无权删除他人添加的回声洞", deletePending: "删除（待审核）", deleted: "已删除" }, list: { pageInfo: "第 {0} / {1} 页", header: "当前共有 {0} 项回声洞：", totalItems: "用户 {0} 共计投稿 {1} 项：", idsLine: "{0}" }, audit: { noPending: "暂无待审核回声洞", pendingNotFound: "未找到待审核回声洞", pendingResult: "{0}，剩余 {1} 个待审核回声洞：[{2}]", auditPassed: "已通过", auditRejected: "已拒绝", batchAuditResult: "已{0} {1}/{2} 项回声洞", title: "待审核回声洞：", from: "投稿人：", sendFailed: "发送审核消息失败，无法联系管理员 {0}" }, error: { noContent: "回声洞内容为空", getCave: "获取回声洞失败", noCave: "没有回声洞", invalidId: "请输入有效的回声洞ID", notFound: "未找到该回声洞", exactDuplicateFound: "发现完全相同的", similarDuplicateFound: "发现相似度为 {0}% 的", addFailed: "添加失败，请稍后重试。" }, message: { blacklisted: "你已被列入黑名单", managerOnly: "此操作仅限管理员可用", cooldown: "群聊冷却中...请在 {0} 秒后重试", caveTitle: "回声洞 —— （{0}）", contributorSuffix: "—— {0}", mediaSizeExceeded: "{0}文件大小超过限制" } } } };
+    module2.exports = { _config: { manager: "管理员", number: "冷却时间（秒）", enableAudit: "启用审核", enableTextDuplicate: "启用文本查重", textDuplicateThreshold: "文本相似度阈值（0-1）", enableImageDuplicate: "启用图片查重", imageDuplicateThreshold: "图片相似度阈值（0-1）", imageMaxSize: "图片最大大小（MB）", allowVideo: "允许视频上传", videoMaxSize: "视频最大大小（MB）", enablePagination: "启用统计分页", itemsPerPage: "每页显示数目", blacklist: "黑名单（用户）", whitelist: "审核白名单（用户/群组/频道）" }, commands: { cave: { description: "回声洞", usage: "支持添加、抽取、查看、管理回声洞", examples: "使用 cave 随机抽取回声洞\n使用 -a 直接添加或引用添加\n使用 -g 查看指定回声洞\n使用 -r 删除指定回声洞", options: { a: "添加回声洞", g: "查看回声洞", r: "删除回声洞", l: "查询投稿统计" }, pass: { description: "通过回声洞审核", usage: "通过指定ID的回声洞审核\ncave.pass <ID> - 通过审核\ncave.pass all - 通过所有待审核内容\n" }, reject: { description: "拒绝回声洞审核", usage: "拒绝指定ID的回声洞审核\ncave.reject <ID> - 拒绝审核\ncave.reject all - 拒绝所有待审核内容\n" }, add: { noContent: "请在一分钟内发送内容", operationTimeout: "操作超时，添加取消", videoDisabled: "不允许上传视频", submitPending: "提交成功，序号为（{0}）", addSuccess: "添加成功，序号为（{0}）", mediaSizeExceeded: "{0}文件大小超过限制", localFileNotAllowed: "检测到本地文件路径，无法保存" }, remove: { noPermission: "你无权删除他人添加的回声洞", deletePending: "删除（待审核）", deleted: "已删除" }, list: { pageInfo: "第 {0} / {1} 页", header: "当前共有 {0} 项回声洞：", totalItems: "用户 {0} 共计投稿 {1} 项：", idsLine: "{0}" }, audit: { noPending: "暂无待审核回声洞", pendingNotFound: "未找到待审核回声洞", pendingResult: "{0}，剩余 {1} 个待审核回声洞：[{2}]", auditPassed: "已通过", auditRejected: "已拒绝", batchAuditResult: "已{0} {1}/{2} 项回声洞", title: "待审核回声洞：", from: "投稿人：", sendFailed: "发送审核消息失败，无法联系管理员 {0}" }, error: { noContent: "回声洞内容为空", getCave: "获取回声洞失败", noCave: "没有回声洞", invalidId: "请输入有效的回声洞ID", notFound: "未找到该回声洞", exactDuplicateFound: "发现完全相同的", similarDuplicateFound: "发现相似度为 {0}% 的", addFailed: "添加失败，请稍后重试。" }, message: { blacklisted: "你已被列入黑名单", managerOnly: "此操作仅限管理员可用", cooldown: "群聊冷却中...请在 {0} 秒后重试", caveTitle: "回声洞 —— （{0}）", contributorSuffix: "—— {0}", mediaSizeExceeded: "{0}文件大小超过限制" } } } };
   }
 });
 
 // src/locales/en-US.yml
 var require_en_US = __commonJS({
   "src/locales/en-US.yml"(exports2, module2) {
-    module2.exports = { _config: { manager: "Administrator", number: "Cooldown time (seconds)", enableAudit: "Enable moderation", enableTextDuplicate: "Enable text duplicate check", textDuplicateThreshold: "Text similarity threshold (0-1)", enableImageDuplicate: "Enable image duplicate check", imageDuplicateThreshold: "Image similarity threshold (0-1)", imageMaxSize: "Maximum image size (MB)", allowVideo: "Allow video upload", videoMaxSize: "Maximum video size (MB)", enablePagination: "Enable statistics pagination", itemsPerPage: "Items per page", blacklist: "Blacklist (users)", whitelist: "Moderation whitelist (users/groups/channels)" }, commands: { cave: { description: "Echo Cave", usage: "Support adding, drawing, viewing, and managing echo caves", examples: "Use cave to randomly draw an echo\nUse -a to add directly or add by reference\nUse -g to view specific echo\nUse -r to delete specific echo", options: { a: "Add echo", g: "View echo", r: "Delete echo", p: "Approve moderation (batch)", d: "Reject moderation (batch)", l: "Query submission statistics" }, add: { noContent: "Please send content within one minute", operationTimeout: "Operation timeout, addition cancelled", videoDisabled: "Video upload not allowed", submitPending: "Submission successful, ID is ({0})", addSuccess: "Added successfully, ID is ({0})", mediaSizeExceeded: "{0} file size exceeds limit", localFileNotAllowed: "Local file path detected, cannot save" }, remove: { noPermission: "You don't have permission to delete others' echos", deletePending: "Delete (pending review)", deleted: "Deleted" }, list: { pageInfo: "Page {0} / {1}", header: "Currently there are {0} echos:", totalItems: "User {0} has submitted {1} items:", idsLine: "{0}" }, audit: { noPending: "No pending echos for review", pendingNotFound: "Pending echo not found", pendingResult: "{0}, {1} pending echos remaining: [{2}]", auditPassed: "Approved", auditRejected: "Rejected", batchAuditResult: "{0} {1}/{2} echos", title: "Pending echos:", from: "Submitted by:", sendFailed: "Failed to send moderation message, cannot contact administrator {0}" }, error: { noContent: "Echo content is empty", getCave: "Failed to get echo", noCave: "No echos available", invalidId: "Please enter a valid echo ID", notFound: "Echo not found", exactDuplicateFound: "Found exactly identical", similarDuplicateFound: "Found {0}% similar", addFailed: "Add failed, please try again later." }, message: { blacklisted: "You have been blacklisted", managerOnly: "This operation is limited to administrators only", cooldown: "Group chat cooling down... Please try again in {0} seconds", caveTitle: "Echo Cave —— ({0})", contributorSuffix: "—— {0}", mediaSizeExceeded: "{0} file size exceeds limit" } } } };
+    module2.exports = { _config: { manager: "Administrator", number: "Cooldown time (seconds)", enableAudit: "Enable moderation", enableTextDuplicate: "Enable text duplicate check", textDuplicateThreshold: "Text similarity threshold (0-1)", enableImageDuplicate: "Enable image duplicate check", imageDuplicateThreshold: "Image similarity threshold (0-1)", imageMaxSize: "Maximum image size (MB)", allowVideo: "Allow video upload", videoMaxSize: "Maximum video size (MB)", enablePagination: "Enable statistics pagination", itemsPerPage: "Items per page", blacklist: "Blacklist (users)", whitelist: "Moderation whitelist (users/groups/channels)" }, commands: { cave: { description: "Echo Cave", usage: "Support adding, drawing, viewing, and managing echo caves", examples: "Use cave to randomly draw an echo\nUse -a to add directly or add by reference\nUse -g to view specific echo\nUse -r to delete specific echo", options: { a: "Add echo", g: "View echo", r: "Delete echo", l: "Query submission statistics" }, pass: { description: "Approve cave submission", usage: "Approve cave submission with specific ID\ncave.pass <ID> - Approve submission\ncave.pass all - Approve all pending submissions\n" }, reject: { description: "Reject cave submission", usage: "Reject cave submission with specific ID\ncave.reject <ID> - Reject submission\ncave.reject all - Reject all pending submissions\n" }, add: { noContent: "Please send content within one minute", operationTimeout: "Operation timeout, addition cancelled", videoDisabled: "Video upload not allowed", submitPending: "Submission successful, ID is ({0})", addSuccess: "Added successfully, ID is ({0})", mediaSizeExceeded: "{0} file size exceeds limit", localFileNotAllowed: "Local file path detected, cannot save" }, remove: { noPermission: "You don't have permission to delete others' echos", deletePending: "Delete (pending review)", deleted: "Deleted" }, list: { pageInfo: "Page {0} / {1}", header: "Currently there are {0} echos:", totalItems: "User {0} has submitted {1} items:", idsLine: "{0}" }, audit: { noPending: "No pending echos for review", pendingNotFound: "Pending echo not found", pendingResult: "{0}, {1} pending echos remaining: [{2}]", auditPassed: "Approved", auditRejected: "Rejected", batchAuditResult: "{0} {1}/{2} echos", title: "Pending echos:", from: "Submitted by:", sendFailed: "Failed to send moderation message, cannot contact administrator {0}" }, error: { noContent: "Echo content is empty", getCave: "Failed to get echo", noCave: "No echos available", invalidId: "Please enter a valid echo ID", notFound: "Echo not found", exactDuplicateFound: "Found exactly identical", similarDuplicateFound: "Found {0}% similar", addFailed: "Add failed, please try again later." }, message: { blacklisted: "You have been blacklisted", managerOnly: "This operation is limited to administrators only", cooldown: "Group chat cooling down... Please try again in {0} seconds", caveTitle: "Echo Cave —— ({0})", contributorSuffix: "—— {0}", mediaSizeExceeded: "{0} file size exceeds limit" } } } };
   }
 });
 
@@ -1343,7 +1343,7 @@ async function apply(ctx, config) {
     let caveId;
     try {
       const inputContent = content.length > 0 ? content.join("\n") : await (async () => {
-        await sendMessage(session, "commands.cave.add.noContent", [], true);
+        await sendMessage(session, "commands.cave.add.noContent", [], true, 6e4);
         const reply = await session.prompt({ timeout: 6e4 });
         if (!reply) throw new Error(session.text("commands.cave.add.operationTimeout"));
         return reply;
@@ -1481,20 +1481,17 @@ async function apply(ctx, config) {
     }
   }
   __name(processAdd, "processAdd");
-  ctx.command("cave [message]").option("a", "添加回声洞").option("g", "查看回声洞", { type: "string" }).option("r", "删除回声洞", { type: "string" }).option("p", "通过审核", { type: "string" }).option("d", "拒绝审核", { type: "string" }).option("l", "查询投稿统计", { type: "string" }).before(async ({ session, options }) => {
+  const caveCommand = ctx.command("cave [message]").option("a", "添加回声洞").option("g", "查看回声洞", { type: "string" }).option("r", "删除回声洞", { type: "string" }).option("l", "查询投稿统计", { type: "string" }).before(async ({ session, options }) => {
     if (config.blacklist.includes(session.userId)) {
       return sendMessage(session, "commands.cave.message.blacklisted", [], true);
     }
-    if ((options.p || options.d) && !config.manager.includes(session.userId)) {
-      return sendMessage(session, "commands.cave.message.managerOnly", [], true);
-    }
   }).action(async ({ session, options }, ...content) => {
     const dataDir2 = path5.join(ctx.baseDir, "data");
     const caveDir2 = path5.join(dataDir2, "cave");
     const caveFilePath = path5.join(caveDir2, "cave.json");
     const resourceDir = path5.join(caveDir2, "resources");
     const pendingFilePath = path5.join(caveDir2, "pending.json");
-    const needsCooldown = !options.l && !options.a && !options.p && !options.d;
+    const needsCooldown = !options.l && !options.a;
     if (needsCooldown) {
       const guildId = session.guildId;
       const now = Date.now();
@@ -1524,9 +1521,6 @@ async function apply(ctx, config) {
         return await processList(session, config, session.userId);
       }
     }
-    if (options.p || options.d) {
-      return await processAudit(pendingFilePath, caveFilePath, resourceDir, session, options, content);
-    }
     if (options.g) {
       return await processView(caveFilePath, resourceDir, session, options, content);
     }
@@ -1538,6 +1532,44 @@ async function apply(ctx, config) {
     }
     return await processRandom(caveFilePath, resourceDir, session);
   });
+  caveCommand.subcommand(".pass <id:text>", "通过回声洞审核").before(async ({ session }) => {
+    if (!config.manager.includes(session.userId)) {
+      return sendMessage(session, "commands.cave.message.managerOnly", [], true);
+    }
+  }).action(async ({ session }, id) => {
+    const dataDir2 = path5.join(ctx.baseDir, "data");
+    const caveDir2 = path5.join(dataDir2, "cave");
+    const caveFilePath = path5.join(caveDir2, "cave.json");
+    const resourceDir = path5.join(caveDir2, "resources");
+    const pendingFilePath = path5.join(caveDir2, "pending.json");
+    return await processAudit(
+      pendingFilePath,
+      caveFilePath,
+      resourceDir,
+      session,
+      { p: true },
+      [id]
+    );
+  });
+  caveCommand.subcommand(".reject <id:text>", "拒绝回声洞审核").before(async ({ session }) => {
+    if (!config.manager.includes(session.userId)) {
+      return sendMessage(session, "commands.cave.message.managerOnly", [], true);
+    }
+  }).action(async ({ session }, id) => {
+    const dataDir2 = path5.join(ctx.baseDir, "data");
+    const caveDir2 = path5.join(dataDir2, "cave");
+    const caveFilePath = path5.join(caveDir2, "cave.json");
+    const resourceDir = path5.join(caveDir2, "resources");
+    const pendingFilePath = path5.join(caveDir2, "pending.json");
+    return await processAudit(
+      pendingFilePath,
+      caveFilePath,
+      resourceDir,
+      session,
+      { d: true },
+      [id]
+    );
+  });
 }
 __name(apply, "apply");
 var logger4 = new import_koishi5.Logger("cave");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-best-cave",
   "description": "最好的 cave 插件，可开关的审核系统，可引用添加，支持图文混合内容，可查阅投稿列表，完美复刻你的 .cave 体验！",
-  "version": "1.5.0",
+  "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/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;
-}

package/lib/utils/ImageHasher.d.ts

@@ -1,81 +0,0 @@
-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

@@ -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/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;
-}