koishi-plugin-best-cave 2.1.3 → 2.2.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-best-cave",
-  "description": "最强大的回声洞现已重构完成啦！注意数据格式需要使用脚本转换哦~",
-  "version": "2.1.3",
+  "description": "功能强大、高度可定制的回声洞。支持丰富的媒体类型、内容查重、人工审核、用户昵称、数据迁移以及本地/S3 双重文件存储后端。",
+  "version": "2.2.0",
   "contributors": [
     "Yis_Rime <yis_rime@outlook.com>"
   ],

package/readme.md

@@ -2,29 +2,31 @@
 
 [![npm](https://img.shields.io/npm/v/koishi-plugin-best-cave?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-best-cave)
 
-一款功能强大且灵活的回声洞插件，支持丰富的媒体类型、可插拔的功能模块和双重存储后端（本地或 S3）。
+功能强大、高度可定制的回声洞。支持丰富的媒体类型、内容查重、人工审核、用户昵称、数据迁移以及本地/S3 双重文件存储后端。
 
 ## ✨ 功能亮点
 
-- **丰富的媒体支持**：不止于文本，轻松发布包含图片、视频、音频甚至文件的混合内容。插件会自动处理消息引用，解析并保存其内容。
-- **双重存储后端**：可根据需求选择将媒体文件存储在 **本地服务器** (`data/cave` 目录) 或 **AWS S3** 兼容的云端对象存储中，便于扩展和管理。
-- **可选的审核机制**：可开启审核模式 (`enableReview`)。开启后，所有新提交的内容都需要管理员审核通过才会进入公共池，确保内容质量。
-- **作用域隔离**：通过 `perChannel` 配置，可设定回声洞是在所有群聊中共享（全局模式），还是在每个群聊中独立（分群模式）。
-- **用户身份定制**：当 `enableProfile` 开启时，用户可以为自己在回声洞中的发言设置一个专属昵称。
-- **便捷的数据管理**：管理员可以通过指令轻松地将所有回声洞数据导出为 `JSON` 文件备份，或从文件中恢复数据，迁移无忧 (`enableDataIO`)。
-- **完善的权限控制**：通过 `adminUsers` 列表指定管理员，只有管理员才能执行审核、数据迁移和删除任意投稿等高级操作。
+- **丰富的内容形式**：不止于文本，轻松发布包含图片、视频、音频甚至文件的混合内容。插件能自动解析回复或引用的消息，并将其完整存入回声洞。
+- **灵活的存储后端**：媒体文件可存储在 **本地服务器** (`data/cave` 目录)，或配置使用 **AWS S3** 兼容的云端对象存储。支持通过公共URL、本地文件路径或Base64三种方式发送媒体。
+- **内容相似度检查**：(可选) 启用后，插件会在添加时自动计算文本（Simhash）和图片（pHash）的哈希值，拒绝与现有内容相似度过高的投稿，有效防止重复。
+- **完善的审核机制**：(可选) 启用后，所有新投稿都将进入待审核状态，并通知管理群组。只有管理员审核通过后，内容才会对用户可见，确保内容质量。
+- **精细的作用域**：通过 `perChannel` 配置，可设定回声洞是在所有群聊中共享（全局模式），还是在每个群聊中独立（分群模式）。
+- **专属用户昵称**：(可选) 用户可以为自己在回声洞中的发言设置一个专属昵称，增加趣味性。
+- **便捷的数据管理**：(可选) 管理员可通过指令轻松地将所有回声洞数据导出为 `JSON` 文件备份，或从文件中恢复数据，迁移无忧。
+- **强大的维护工具**：管理员可以通过 `cave.hash` 指令为历史数据批量生成哈希值，并获取一份所有内容的相似度报告。
+- **权限分离**：普通用户可删除自己的投稿。审核、数据管理等高级操作则仅限在指定的 **管理群组** 内由管理员执行。
 
 ## 📖 指令说明
 
-### 核心指令
+### 用户指令
 
 | 指令 | 别名/选项 | 说明 |
 | :--- | :--- | :--- |
 | `cave` | | 随机查看一条回声洞。 |
-| `cave.add <内容>` | `cave -a <内容>` | 添加一条新的回声洞。可以直接在指令后跟内容，也可以回复或引用一条消息来添加。 |
+| `cave.add [内容]` | `cave -a [内容]` | 添加一条新的回声洞。可直接跟内容，也可回复/引用消息，或等待机器人提示后发送。 |
 | `cave.view <序号>` | `cave -g <序号>` | 查看指定序号的回声洞。 |
-| `cave.del <序号>` | `cave -r <序号>` | 删除指定序号的回声洞。仅投稿人或管理员可操作。 |
-| `cave.list` | `cave -l` | 查询并列出自己投稿过的所有回声洞序号。 |
+| `cave.del <序号>` | `cave -r <序号>` | 删除指定序号的回声洞。仅投稿人或在管理群组内的管理员可操作。 |
+| `cave.list` | `cave -l` | 查询并列出自己投稿过的所有回声洞序号及总数。 |
 
 ### 模块化指令
 
@@ -32,48 +34,56 @@
 
 | 指令 | 所需配置 | 说明 |
 | :--- | :--- | :--- |
-| `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.profile [昵称]` | `enableProfile: true` | 设置你在回声洞中显示的昵称。若不提供昵称，则清除现有设置。 |
+| `cave.review` | `enableReview: true` | **(仅限管理群组)** 列出所有待审核的回声洞ID。 |
+| `cave.review <序号>` | `enableReview: true` | **(仅限管理群组)** 查看指定待审核内容的详情。 |
+| `cave.review.Y [序号]` | `enableReview: true` | **(仅限管理群组)** 通过审核。若不提供序号，则通过所有待审核内容。 |
+| `cave.review.N [序号]` | `enableReview: true` | **(仅限管理群组)** 拒绝审核。若不提供序号，则拒绝所有待审核内容。 |
+| `cave.export` | `enableIO: true` | **(仅限管理群组)** 将所有`active`状态的回声洞导出到 `cave_export.json`。 |
+| `cave.import` | `enableIO: true` | **(仅限管理群组)** 从 `cave_import.json` 文件中导入数据。 |
+| `cave.hash` | `enableSimilarity: true` | **(仅限管理群组)** 校验所有历史数据，补全哈希并检查内容相似度。 |
 
 ## ⚙️ 配置说明
 
-插件配置分为三个部分：基础配置、审核配置和存储配置。
-
 ### 基础配置
 
 | 配置项 | 类型 | 默认值 | 说明 |
 | :--- | :--- | :--- | :--- |
-| `cooldown` | `number` | `10` | 指令冷却时间（秒）。管理员不受此限制。 |
-| `perChannel` | `boolean` | `false` | 是否启用分群模式。`true` 表示每个群的回声洞独立，`false` 表示所有群共享一个回声洞池。 |
-| `adminUsers` | `string[]` | `[]` | 管理员的用户 ID 列表。 |
+| `coolDown` | `number` | `10` | `cave` 和 `cave.view` 指令的冷却时间（秒）。 |
+| `perChannel` | `boolean` | `false` | 是否启用分群模式。`true` 表示各群的回声洞独立。 |
 | `enableProfile` | `boolean` | `false` | 是否启用自定义昵称功能 (`cave.profile` 指令)。 |
-| `enableDataIO` | `boolean` | `false` | 是否启用数据导入/导出功能 (`cave.export` / `.import` 指令)。 |
+| `enableIO` | `boolean` | `false` | 是否启用数据导入/导出功能 (`cave.export` / `.import` 指令)。 |
+| `adminChannel` | `string` | `'onebot:'` | **管理群组ID**。格式为 `平台名:群号`，如 `onebot:12345678`。审核、数据等管理指令仅在此群组生效。 |
+| `caveFormat` | `string` | `'回声洞 ——（{id}）\|—— {name}'` | 回声洞消息的显示格式。`{id}`是序号，`{name}`是昵称，`\|`为换行符。 |
 
-### 审核配置
+### 复核配置 (审核与查重)
 
 | 配置项 | 类型 | 默认值 | 说明 |
 | :--- | :--- | :--- | :--- |
-| `enableReview` | `boolean` | `false` | 是否启用审核机制。启用后，新投稿将进入待审核状态，并由管理员使用 `cave.review` 指令处理。 |
+| `enableReview` | `boolean` | `false` | 是否启用审核机制。 |
+| `enableSimilarity` | `boolean` | `false` | 是否启用内容相似度检查（查重）。 |
+| `textThreshold` | `number` | `0.9` | 文本相似度阈值 (0-1)。超过此值将被拒绝。 |
+| `imageThreshold` | `number` | `0.9` | 图片相似度阈值 (0-1)。超过此值将被拒绝。 |
 
 ### 存储配置
 
 | 配置项 | 类型 | 默认值 | 说明 |
 | :--- | :--- | :--- | :--- |
+| `localPath` | `string` | | 为本地文件提供一个可访问的绝对路径。配置后，将以 `file:///` 协议发送本地媒体。 |
 | `enableS3` | `boolean` | `false` | 是否启用 S3 存储。若为 `false`，所有媒体文件将保存在本地 `data/cave` 目录下。 |
+| `publicUrl` | `string` | | **(S3 可选)** S3 存储桶的公共访问 URL。如果提供，插件将直接用此 URL 发送媒体链接。 |
 | `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`。
+1. **媒体发送方式**：插件会按以下优先级决定如何发送图片、视频等媒体文件：
+    1. **S3 公共URL**：如果 `enableS3` 和 `publicUrl` 已配置。
+    2. **本地文件路径**：如果 `localPath` 已配置。
+    3. **Base64 编码**：如果以上两项均未配置，将文件转为 Base64 发送（可能受平台大小限制）。
+2. **文件存储权限**：若使用本地存储，请确保 Koishi 拥有对 `data/cave` 目录的读写权限。若使用 S3，请确保 Access Key 权限和存储桶策略配置正确。
+3. **异步删除**：删除操作（`cave.del` 或审核拒绝）会将内容状态标记为 `delete`，然后由后台任务异步清理关联的文件和数据库条目，以避免阻塞当前指令。
+4. **数据迁移**：导入功能会读取插件数据目录下的 `cave_import.json`。导出功能则会生成 `cave_export.json`。请在操作前放置或备份好相应文件。

package/lib/DataManager.d.ts

@@ -1,38 +0,0 @@
-import { Context, Logger } from 'koishi';
-import { FileManager } from './FileManager';
-import { Config } from './index';
-/**
- * @class DataManager
- * @description 负责处理回声洞数据的导入和导出功能。
- */
-export declare class DataManager {
-    private ctx;
-    private config;
-    private fileManager;
-    private logger;
-    private reusableIds;
-    /**
-     * @constructor
-     * @param ctx Koishi 上下文，用于数据库操作。
-     * @param config 插件配置。
-     * @param fileManager 文件管理器实例。
-     * @param logger 日志记录器实例。
-     * @param reusableIds 可复用 ID 的内存缓存。
-     */
-    constructor(ctx: Context, config: Config, fileManager: FileManager, logger: Logger, reusableIds: Set<number>);
-    /**
-     * @description 注册 `.export` 和 `.import` 子命令。
-     * @param cave - 主 `cave` 命令实例。
-     */
-    registerCommands(cave: any): void;
-    /**
-     * @description 导出所有 'active' 状态的回声洞数据到 `cave_export.json`。
-     * @returns 描述导出结果的消息字符串。
-     */
-    exportData(): Promise<string>;
-    /**
-     * @description 从 `cave_import.json` 文件导入回声洞数据。
-     * @returns 描述导入结果的消息字符串。
-     */
-    importData(): Promise<string>;
-}

package/lib/FileManager.d.ts

@@ -1,48 +0,0 @@
-import { Logger } from 'koishi';
-import { Config } from './index';
-/**
- * @class FileManager
- * @description 封装了对文件的存储、读取和删除操作。
- * 能根据配置自动选择使用本地文件系统或 AWS S3 作为存储后端。
- * 内置 Promise 文件锁，防止本地文件的并发写入冲突。
- */
-export declare class FileManager {
-    private logger;
-    private resourceDir;
-    private locks;
-    private s3Client?;
-    private s3Bucket?;
-    /**
-     * @constructor
-     * @param baseDir Koishi 应用的基础数据目录 (ctx.baseDir)。
-     * @param config 插件的配置对象。
-     * @param logger 日志记录器实例。
-     */
-    constructor(baseDir: string, config: Config, logger: Logger);
-    /**
-     * @description 使用文件锁安全地执行异步文件操作，防止并发读写冲突。
-     * @template T 异步操作的返回类型。
-     * @param fullPath 需要加锁的文件的完整路径。
-     * @param operation 要执行的异步函数。
-     * @returns 返回异步操作的结果。
-     */
-    private withLock;
-    /**
-     * @description 保存文件，自动选择 S3 或本地存储。
-     * @param fileName 用作 S3 Key 或本地文件名。
-     * @param data 要写入的 Buffer 数据。
-     * @returns 返回保存时使用的文件名/标识符。
-     */
-    saveFile(fileName: string, data: Buffer): Promise<string>;
-    /**
-     * @description 读取文件，自动从 S3 或本地存储读取。
-     * @param fileName 要读取的文件名/标识符。
-     * @returns 文件的 Buffer 数据。
-     */
-    readFile(fileName: string): Promise<Buffer>;
-    /**
-     * @description 删除文件，自动从 S3 或本地删除。
-     * @param fileIdentifier 要删除的文件名/标识符。
-     */
-    deleteFile(fileIdentifier: string): Promise<void>;
-}

package/lib/ProfileManager.d.ts

@@ -1,50 +0,0 @@
-import { Context } from 'koishi';
-/**
- * @description 数据库 `cave_user` 表的结构定义。
- * @property userId 用户唯一ID，作为主键。
- * @property nickname 用户自定义的昵称。
- */
-export interface UserProfile {
-    userId: string;
-    nickname: string;
-}
-declare module 'koishi' {
-    interface Tables {
-        cave_user: UserProfile;
-    }
-}
-/**
- * @class ProfileManager
- * @description 负责管理用户在回声洞中的自定义昵称。
- * 当插件配置 `enableProfile` 为 true 时实例化。
- */
-export declare class ProfileManager {
-    private ctx;
-    /**
-     * @constructor
-     * @param ctx - Koishi 上下文，用于初始化数据库模型。
-     */
-    constructor(ctx: Context);
-    /**
-     * @description 注册 `.profile` 子命令，用于管理用户昵称。
-     * @param cave - 主 `cave` 命令实例。
-     */
-    registerCommands(cave: any): void;
-    /**
-     * @description 设置或更新指定用户的昵称。
-     * @param userId - 目标用户的 ID。
-     * @param nickname - 要设置的新昵称。
-     */
-    setNickname(userId: string, nickname: string): Promise<void>;
-    /**
-     * @description 获取指定用户的昵称。
-     * @param userId - 目标用户的 ID。
-     * @returns 返回用户的昵称字符串，如果未设置则返回 null。
-     */
-    getNickname(userId: string): Promise<string | null>;
-    /**
-     * @description 清除指定用户的昵称设置。
-     * @param userId - 目标用户的 ID。
-     */
-    clearNickname(userId: string): Promise<void>;
-}

package/lib/ReviewManager.d.ts

@@ -1,40 +0,0 @@
-import { Context, Logger } from 'koishi';
-import { CaveObject, Config } from './index';
-import { FileManager } from './FileManager';
-/**
- * @class ReviewManager
- * @description 负责处理回声洞的审核流程，处理新洞的提交、审核通知和审核操作。
- */
-export declare class ReviewManager {
-    private ctx;
-    private config;
-    private fileManager;
-    private logger;
-    private reusableIds;
-    /**
-     * @constructor
-     * @param ctx Koishi 上下文。
-     * @param config 插件配置。
-     * @param fileManager 文件管理器实例。
-     * @param logger 日志记录器实例。
-     * @param reusableIds 可复用 ID 的内存缓存。
-     */
-    constructor(ctx: Context, config: Config, fileManager: FileManager, logger: Logger, reusableIds: Set<number>);
-    /**
-     * @description 注册与审核相关的子命令。
-     * @param cave - 主 `cave` 命令实例。
-     */
-    registerCommands(cave: any): void;
-    /**
-     * @description 将新回声洞提交到管理群组以供审核。
-     * @param cave 新创建的、状态为 'pending' 的回声洞对象。
-     */
-    sendForReview(cave: CaveObject): Promise<void>;
-    /**
-     * @description 处理管理员的审核决定（通过或拒绝）。
-     * @param action 'approve' (通过) 或 'reject' (拒绝)。
-     * @param caveId 被审核的回声洞 ID。
-     * @returns 返回给操作者的确认消息。
-     */
-    processReview(action: 'approve' | 'reject', caveId: number): Promise<string>;
-}

package/lib/Utils.d.ts

@@ -1,86 +0,0 @@
-import { Context, h, Logger, Session } from 'koishi';
-import { CaveObject, Config, StoredElement, CaveHashObject } from './index';
-import { FileManager } from './FileManager';
-import { HashManager } from './HashManager';
-/**
- * @description 将数据库存储的 StoredElement[] 转换为 Koishi 的 h() 元素数组。
- * @param elements 从数据库读取的元素数组。
- * @returns 转换后的 h() 元素数组。
- */
-export declare function storedFormatToHElements(elements: StoredElement[]): h[];
-/**
- * @description 构建一条用于发送的完整回声洞消息。
- * 此函数会处理 S3 URL、文件映射路径或本地文件到 Base64 的转换。
- * @param cave 要展示的回声洞对象。
- * @param config 插件配置。
- * @param fileManager FileManager 实例。
- * @param logger Logger 实例。
- * @returns 包含 h() 元素和字符串的消息数组。
- */
-export declare function buildCaveMessage(cave: CaveObject, config: Config, fileManager: FileManager, logger: Logger): Promise<(string | h)[]>;
-/**
- * @description 清理数据库中所有被标记为 'delete' 状态的回声洞及其关联文件。
- * @param ctx Koishi 上下文。
- * @param fileManager FileManager 实例。
- * @param logger Logger 实例。
- * @param reusableIds 可复用 ID 的内存缓存。
- */
-export declare function cleanupPendingDeletions(ctx: Context, fileManager: FileManager, logger: Logger, reusableIds: Set<number>): Promise<void>;
-/**
- * @description 根据配置（是否分群）和当前会话，生成数据库查询的范围条件。
- * @param session 当前会话对象。
- * @param config 插件配置。
- * @returns 用于数据库查询的条件对象。
- */
-export declare function getScopeQuery(session: Session, config: Config): object;
-/**
- * @description 获取下一个可用的回声洞 ID。
- * 实现了三阶段逻辑：优先使用回收ID -> 扫描空闲ID -> 获取最大ID+1。
- * @param ctx Koishi 上下文。
- * @param query 查询范围条件，用于分群模式。
- * @param reusableIds 可复用 ID 的内存缓存。
- * @returns 可用的新 ID。
- */
-export declare function getNextCaveId(ctx: Context, query: object, reusableIds: Set<number>): Promise<number>;
-/**
- * @description 检查用户是否处于指令冷却中。
- * @returns 若在冷却中则返回提示字符串，否则返回 null。
- */
-export declare function checkCooldown(session: Session, config: Config, lastUsed: Map<string, number>): string | null;
-/**
- * @description 更新指定频道的指令使用时间戳。
- */
-export declare function updateCooldownTimestamp(session: Session, config: Config, lastUsed: Map<string, number>): void;
-/**
- * @description 解析消息元素，分离出文本和待下载的媒体文件。
- * @param sourceElements - 原始的 Koishi 消息元素数组。
- * @param newId - 这条回声洞的新 ID。
- * @param channelId - 频道 ID。
- * @param userId - 用户 ID。
- * @returns 一个包含数据库元素和待保存媒体列表的对象。
- */
-export declare function processMessageElements(sourceElements: h[], newId: number, channelId: string, userId: string): Promise<{
-    finalElementsForDb: StoredElement[];
-    mediaToSave: {
-        sourceUrl: string;
-        fileName: string;
-    }[];
-}>;
-/**
- * @description 异步处理文件上传、查重和状态更新的后台任务。
- * @param ctx - Koishi 上下文。
- * @param config - 插件配置。
- * @param fileManager - FileManager 实例，用于保存文件。
- * @param logger - 日志记录器实例。
- * @param reviewManager - ReviewManager 实例，用于提交审核。
- * @param cave - 刚刚在数据库中创建的 `preload` 状态的回声洞对象。
- * @param mediaToSave - 需要下载和处理的媒体文件列表。
- * @param reusableIds - 可复用 ID 的内存缓存。
- * @param session - 触发此操作的用户会话，用于发送反馈。
- * @param hashManager - HashManager 实例，如果启用则用于哈希计算和比较。
- * @param textHashesToStore - 已预先计算好的、待存入数据库的文本哈希对象数组。
- */
-export declare function handleFileUploads(ctx: Context, config: Config, fileManager: FileManager, logger: Logger, reviewManager: any, cave: CaveObject, mediaToSave: {
-    sourceUrl: string;
-    fileName: string;
-}[], reusableIds: Set<number>, session: Session, hashManager: HashManager | null, textHashesToStore: Omit<CaveHashObject, 'cave'>[]): Promise<void>;

package/lib/index.d.ts

@@ -1,61 +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<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";
-/**
- * @description 存储在数据库中的单个消息元素。
- */
-export interface StoredElement {
-    type: 'text' | 'image' | 'video' | 'audio' | 'file';
-    content?: string;
-    file?: string;
-}
-/**
- * @description 数据库 `cave` 表的完整对象模型。
- */
-export interface CaveObject {
-    id: number;
-    elements: StoredElement[];
-    channelId: string;
-    userId: string;
-    userName: string;
-    status: 'active' | 'delete' | 'pending' | 'preload';
-    time: Date;
-}
-/**
- * @description 数据库 `cave_hash` 表的完整对象模型。
- */
-export interface CaveHashObject {
-    cave: number;
-    hash: string;
-    type: 'text' | 'image';
-    subType: 'shingle' | 'pHash' | 'subImage';
-}
-declare module 'koishi' {
-    interface Tables {
-        cave: CaveObject;
-        cave_hash: CaveHashObject;
-    }
-}
-export interface Config {
-    coolDown: number;
-    perChannel: boolean;
-    adminChannel: string;
-    enableProfile: boolean;
-    enableIO: boolean;
-    enableReview: boolean;
-    caveFormat: string;
-    enableSimilarity: boolean;
-    textThreshold: number;
-    imageThreshold: number;
-    localPath?: string;
-    enableS3: boolean;
-    endpoint?: string;
-    region?: string;
-    accessKeyId?: string;
-    secretAccessKey?: string;
-    bucket?: string;
-    publicUrl?: string;
-}
-export declare const Config: Schema<Config>;
-export declare function apply(ctx: Context, config: Config): void;