koishi-plugin-echo-cave 1.17.0 → 1.18.0

package/README.md

@@ -55,25 +55,9 @@ npm install koishi-plugin-echo-cave
 5. **查看自己的投稿**：发送命令 `cave.listen` 查看自己曾经存入的所有回声洞消息
 6. **查看自己的发言**：发送命令 `cave.trace` 查看自己曾经被他人存入的回声洞消息
 
-## 📁 文件结构
-
-```
-src/
-├── index.ts              # 插件主入口，命令注册和核心功能
-├── cave-helper.ts        # 回声洞消息发送辅助函数
-├── forward-helper.ts     # 转发消息处理辅助函数
-├── media-helper.ts       # 媒体文件保存辅助函数
-├── msg-helper.ts         # 消息发送辅助函数
-├── cqcode-helper.ts      # CQ 码处理辅助函数
-├── onebot-helper.ts      # OneBot 适配器辅助函数
-└── locales/
-    └── zh-CN.json        # 中文语言包
-```
-
 ## 🔧 技术说明
 
 - 插件使用 Koishi 数据库系统存储消息记录
-- 图片会保存在 `data/cave/images` 目录下
 - 支持嵌套转发消息的处理
 - 自动检测重复消息，避免存储重复内容
 - 支持媒体文件大小限制
@@ -82,15 +66,15 @@ src/
 
 ## 🛠️ 配置选项
 
-| 配置项 | 类型 | 默认值 | 说明 |
-|-------|------|-------|------|
+| 配置项                      | 类型      | 默认值     | 说明                            |
+|--------------------------|---------|---------|-------------------------------|
 | `adminMessageProtection` | boolean | `false` | 开启管理员消息保护，使管理员发布的消息只能由其他管理员删除 |
-| `allowContributorDelete` | boolean | `true` | 允许消息投稿者删除自己投稿的消息 |
-| `allowSenderDelete` | boolean | `true` | 允许原始消息发送者删除自己被投稿的消息 |
-| `enableSizeLimit` | boolean | `false` | 启用媒体文件大小限制 |
-| `maxImageSize` | number | `2048` | 最大图片大小（KB） |
-| `maxVideoSize` | number | `512` | 最大视频大小（MB） |
-| `maxFileSize` | number | `512` | 最大文件大小（MB） |
+| `allowContributorDelete` | boolean | `true`  | 允许消息投稿者删除自己投稿的消息              |
+| `allowSenderDelete`      | boolean | `true`  | 允许原始消息发送者删除自己被投稿的消息           |
+| `enableSizeLimit`        | boolean | `false` | 启用媒体文件大小限制                    |
+| `maxImageSize`           | number  | `2048`  | 最大图片大小（KB）                    |
+| `maxVideoSize`           | number  | `512`   | 最大视频大小（MB）                    |
+| `maxFileSize`            | number  | `512`   | 最大文件大小（MB）                    |
 
 ## 📝 注意事项
 

package/lib/{onebot-helper.d.ts → adapters/onebot/user.d.ts}

@@ -1,4 +1,5 @@
 import { Context, Session } from 'koishi';
+export declare function getUserIdFromNickname(session: Session, nickname: string, userId: number): Promise<number>;
 export declare function getUserName(ctx: Context, session: Session, userId: string): Promise<string>;
 /**
  * 检查用户是否属于指定群组

package/lib/config/config.d.ts

@@ -0,0 +1,14 @@
+import { Schema } from 'koishi';
+export interface Config {
+    adminMessageProtection?: boolean;
+    allowContributorDelete?: boolean;
+    allowSenderDelete?: boolean;
+    deleteMediaWhenDeletingMsg?: boolean;
+    enableSizeLimit?: boolean;
+    maxImageSize?: number;
+    maxVideoSize?: number;
+    maxFileSize?: number;
+    maxRecordSize?: number;
+    useBase64ForMedia?: boolean;
+}
+export declare const Config: Schema<Config>;

package/lib/core/command/add-cave.d.ts

@@ -0,0 +1,3 @@
+import { Config } from '../../config/config';
+import { Context, Session } from 'koishi';
+export declare function addCave(ctx: Context, session: Session, cfg: Config, userIds?: string[]): Promise<string>;

package/lib/core/command/delete-cave.d.ts

@@ -0,0 +1,4 @@
+import { Config } from '../../config/config';
+import { Context, Session } from 'koishi';
+export declare function deleteCave(ctx: Context, session: Session, cfg: Config, id: number): Promise<string>;
+export declare function deleteCaves(ctx: Context, session: Session, cfg: Config, ids: number[]): Promise<string>;

package/lib/core/command/get-cave.d.ts

@@ -0,0 +1,5 @@
+import { Config } from '../../config/config';
+import { Context, Session } from 'koishi';
+export declare function getCaveListByUser(ctx: Context, session: Session): Promise<string>;
+export declare function getCaveListByOriginUser(ctx: Context, session: Session): Promise<string>;
+export declare function getCave(ctx: Context, session: Session, cfg: Config, id: number): Promise<string>;

package/lib/core/command/misc/bind-user.d.ts

@@ -0,0 +1,2 @@
+import { Context, Session } from 'koishi';
+export declare function bindUsersToCave(ctx: Context, session: Session, id: number, userIds: string[]): Promise<string>;

package/lib/core/command/search-cave.d.ts

@@ -0,0 +1,2 @@
+import { Context, Session } from 'koishi';
+export declare function searchCave(ctx: Context, session: Session, userIds: number): Promise<string>;

package/lib/{cave-helper.d.ts → core/formatter/msg-formatter.d.ts}

@@ -1,4 +1,5 @@
-import { Config, EchoCave } from './index';
+import { Config } from '../../config/config';
+import { EchoCave } from '../../index';
 import { Context, Session } from 'koishi';
 export declare function sendCaveMsg(ctx: Context, session: Session, caveMsg: EchoCave, cfg: Config): Promise<void>;
 export declare function formatDate(date: Date): string;

package/lib/{forward-helper.d.ts → core/parser/forward-parser.d.ts}

@@ -1,4 +1,4 @@
-import { Config } from './index';
+import { Config } from '../../config/config';
 import { CQCode } from '@pynickle/koishi-plugin-adapter-onebot';
 import { Message } from '@pynickle/koishi-plugin-adapter-onebot/lib/types';
 import { Context, Session } from 'koishi';

package/lib/{msg-helper.d.ts → core/parser/msg-parser.d.ts}

@@ -1,4 +1,4 @@
-import { Config } from './index';
+import { Config } from '../../config/config';
 import { CQCode } from '@pynickle/koishi-plugin-adapter-onebot';
 import { Context } from 'koishi';
 export declare function processMessageContent(ctx: Context, msg: CQCode[], cfg: Config): Promise<CQCode[]>;

package/lib/index.cjs

@@ -51,6 +51,10 @@ var require_zh_CN = __commonJS({
           noMsgWithId: "\u{1F50D} \u672A\u627E\u5230\u8BE5 ID \u7684\u56DE\u58F0\u6D1E\u6D88\u606F",
           noTemplatesConfigured: "\u274C \u672A\u914D\u7F6E\u56DE\u58F0\u6D1E\u6A21\u677F\uFF0C\u8BF7\u5148\u914D\u7F6E\u6A21\u677F\uFF01"
         },
+        user: {
+          invalidAllMention: "\u274C \u4E0D\u652F\u6301 @\u5168\u4F53\u6210\u5458\uFF0C\u8BF7\u76F4\u63A5\u6307\u5B9A\u5177\u4F53\u7528\u6237\uFF01",
+          userNotInGroup: "\u274C \u63D0\u4F9B\u7684\u7528\u6237 ID \u4E0D\u5168\u5C5E\u4E8E\u8BE5\u7FA4\u7EC4\uFF01"
+        },
         templates: {
           forward: [
             "\u{1F300} \u56DE\u58F0\u6D1E #{id}\n\n\u4E00\u5219\u56DE\u58F0\u4ECE\u65F6\u5149\u4E2D\u98D8\u6765\u2014\u2014\n\u{1F4C5} {date} \xB7 \u6765\u81EA @{originName}  \n\u{1F4EE} \u7531 @{userName} \u6295\u9012",
@@ -96,9 +100,7 @@ var require_zh_CN = __commonJS({
             noMsgQuoted: "\u{1F4A1} \u8BF7\u5F15\u7528\u4E00\u6761\u6D88\u606F\u540E\u518D\u4F7F\u7528\u6B64\u547D\u4EE4\uFF01",
             existingMsg: "\u267B\uFE0F \u8BE5\u6D88\u606F\u5DF2\u5B58\u5728\u4E8E\u56DE\u58F0\u6D1E\u7A74\u4E2D\uFF01",
             msgSaved: "\u2705 \u56DE\u58F0\u6D1E\u6D88\u606F\u5DF2\u6210\u529F\u5B58\u5165\uFF0C\u6D88\u606F ID\uFF1A{0}",
-            msgFailedToSave: "\u274C \u56DE\u58F0\u6D1E\u4FDD\u5B58\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\uFF01",
-            userNotInGroup: "\u274C \u63D0\u4F9B\u7684\u7528\u6237 ID \u4E0D\u5168\u5C5E\u4E8E\u8BE5\u7FA4\u7EC4\uFF01",
-            invalidAllMention: "\u274C \u4E0D\u652F\u6301 @\u5168\u4F53\u6210\u5458\uFF0C\u8BF7\u76F4\u63A5\u6307\u5B9A\u5177\u4F53\u7528\u6237\uFF01"
+            msgFailedToSave: "\u274C \u56DE\u58F0\u6D1E\u4FDD\u5B58\u5931\u8D25\uFF0C\u8BF7\u7A0D\u540E\u91CD\u8BD5\uFF01"
           }
         },
         "cave.drop": {
@@ -125,8 +127,6 @@ var require_zh_CN = __commonJS({
           description: "\u641C\u7D22\u4E0E\u6307\u5B9A\u7528\u6237\u76F8\u5173\u7684\u56DE\u58F0\u6D1E",
           messages: {
             noUserIdProvided: "\u274C \u8BF7\u63D0\u4F9B\u8981\u641C\u7D22\u7684\u7528\u6237 ID\uFF01",
-            invalidAllMention: "\u274C \u4E0D\u652F\u6301 @\u5168\u4F53\u6210\u5458\uFF0C\u8BF7\u76F4\u63A5\u6307\u5B9A\u5177\u4F53\u7528\u6237\uFF01",
-            userNotInGroup: "\u274C \u63D0\u4F9B\u7684\u7528\u6237 ID \u4E0D\u5168\u5C5E\u4E8E\u8BE5\u7FA4\u7EC4\uFF01",
             noValidUserIdProvided: "\u274C \u672A\u63D0\u4F9B\u6709\u6548\u7684\u7528\u6237 ID\uFF01",
             noMatchingCaves: "\u{1F50D} \u672A\u627E\u5230\u4E0E\u7528\u6237 {0} \u76F8\u5173\u7684\u56DE\u58F0\u6D1E\u6D88\u606F",
             searchResult: "\u{1F50D} \u5171\u627E\u5230 {0} \u6761\u4E0E\u8BE5\u7528\u6237\u76F8\u5173\u7684\u56DE\u58F0\u6D1E\u6D88\u606F\uFF1A\nID \u5217\u8868\uFF1A{1}"
@@ -154,9 +154,7 @@ var require_zh_CN = __commonJS({
             noIdProvided: "\u274C \u8BF7\u63D0\u4F9B\u8981\u7ED1\u5B9A\u7528\u6237\u7684\u56DE\u58F0\u6D1E\u6D88\u606F ID\uFF01",
             noUserIdProvided: "\u274C \u8BF7\u63D0\u4F9B\u8981\u7ED1\u5B9A\u7684\u7528\u6237 ID\uFF01",
             msgNotFound: "\u{1F50D} \u672A\u627E\u5230\u8BE5 ID \u7684\u56DE\u58F0\u6D1E\u6D88\u606F",
-            userBoundSuccess: "\u2705 \u5DF2\u6210\u529F\u5C06\u7528\u6237\u7ED1\u5B9A\u5230\u56DE\u58F0\u6D1E #{0}\uFF01",
-            userNotInGroup: "\u274C \u63D0\u4F9B\u7684\u7528\u6237 ID \u4E0D\u5168\u5C5E\u4E8E\u8BE5\u7FA4\u7EC4\uFF01",
-            invalidAllMention: "\u274C \u4E0D\u652F\u6301 @\u5168\u4F53\u6210\u5458\uFF0C\u8BF7\u76F4\u63A5\u6307\u5B9A\u5177\u4F53\u7528\u6237\uFF01"
+            userBoundSuccess: "\u2705 \u5DF2\u6210\u529F\u5C06\u7528\u6237\u7ED1\u5B9A\u5230\u56DE\u58F0\u6D1E #{0}\uFF01"
           }
         }
       }
@@ -167,24 +165,44 @@ var require_zh_CN = __commonJS({
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
-  Config: () => Config,
   apply: () => apply,
   inject: () => inject,
   name: () => name
 });
 module.exports = __toCommonJS(index_exports);
-var import_koishi_plugin_adapter_onebot = require("@pynickle/koishi-plugin-adapter-onebot");
+var import_koishi_plugin_adapter_onebot2 = require("@pynickle/koishi-plugin-adapter-onebot");
 
-// src/cqcode-helper.ts
-var import_koishi = require("koishi");
-function createTextMsg(content) {
-  return {
-    type: "text",
-    data: {
-      text: content
-    }
-  };
+// src/adapters/onebot/user.ts
+async function getUserIdFromNickname(session, nickname, userId) {
+  const memberInfos = await session.onebot.getGroupMemberList(session.channelId);
+  const matches = memberInfos.filter((m) => m.nickname === nickname);
+  if (matches.length === 1) {
+    return matches[0].user_id;
+  }
+  return userId;
+}
+async function getUserName(ctx, session, userId) {
+  try {
+    const memberInfo = await session.onebot.getGroupMemberInfo(session.channelId, userId);
+    return memberInfo.card || memberInfo.nickname || userId;
+  } catch (error) {
+    ctx.logger.warn(`Failed to get group member info (userId: ${userId}):`, error);
+    return userId;
+  }
+}
+async function checkUsersInGroup(ctx, session, userIds) {
+  try {
+    const groupMembers = await session.onebot.getGroupMemberList(session.channelId);
+    const memberIds = groupMembers.map((member) => member.user_id.toString());
+    return userIds.every((userId) => memberIds.includes(userId));
+  } catch (error) {
+    ctx.logger.warn(`Failed to get group member list:`, error);
+    return false;
+  }
 }
+
+// src/utils/msg/element-helper.ts
+var import_koishi = require("koishi");
 function parseUserIds(userIds) {
   const parsedUserIds = [];
   for (const userId of userIds) {
@@ -210,7 +228,7 @@ function parseUserIds(userIds) {
   };
 }
 
-// src/media-helper.ts
+// src/utils/media/media-helper.ts
 var import_axios = __toESM(require("axios"), 1);
 var import_node_fs = require("node:fs");
 var import_node_path = __toESM(require("node:path"), 1);
@@ -408,100 +426,7 @@ async function deleteMediaFilesFromMessage(ctx, content) {
   }
 }
 
-// src/onebot-helper.ts
-async function getUserName(ctx, session, userId) {
-  try {
-    const memberInfo = await session.onebot.getGroupMemberInfo(session.channelId, userId);
-    return memberInfo.card || memberInfo.nickname || userId;
-  } catch (error) {
-    ctx.logger.warn(`Failed to get group member info (userId: ${userId}):`, error);
-    return userId;
-  }
-}
-async function checkUsersInGroup(ctx, session, userIds) {
-  try {
-    const groupMembers = await session.onebot.getGroupMemberList(session.channelId);
-    const memberIds = groupMembers.map((member) => member.user_id.toString());
-    return userIds.every((userId) => memberIds.includes(userId));
-  } catch (error) {
-    ctx.logger.warn(`Failed to get group member list:`, error);
-    return false;
-  }
-}
-
-// src/cave-helper.ts
-async function sendCaveMsg(ctx, session, caveMsg, cfg) {
-  const { channelId } = session;
-  let content = JSON.parse(caveMsg.content);
-  if (cfg.useBase64ForMedia) {
-    content = await Promise.all(
-      content.map(async (element) => await convertFileUriToBase64(ctx, element))
-    );
-  }
-  const date = formatDate(caveMsg.createTime);
-  const originName = await getUserName(ctx, session, caveMsg.originUserId);
-  const userName = await getUserName(ctx, session, caveMsg.userId);
-  let relatedUsersFormatted = originName;
-  if (caveMsg.relatedUsers && caveMsg.relatedUsers.length > 0) {
-    const relatedUserNames = await Promise.all(
-      caveMsg.relatedUsers.map(async (userId) => await getUserName(ctx, session, userId))
-    );
-    relatedUsersFormatted = relatedUserNames.join(", ");
-  }
-  const templateData = {
-    id: caveMsg.id.toString(),
-    date,
-    originName,
-    userName,
-    relatedUsers: relatedUsersFormatted,
-    nl: "\n"
-  };
-  const TEMPLATE_COUNT = 5;
-  if (caveMsg.type === "forward") {
-    const availableTemplates2 = [];
-    for (let i = 0; i < TEMPLATE_COUNT; i++) {
-      const template = session.text(`echo-cave.templates.forward.${i}`, templateData);
-      if (template.trim() !== "") {
-        availableTemplates2.push(template);
-      }
-    }
-    if (availableTemplates2.length === 0) {
-      await session.send(session.text("echo-cave.general.noTemplatesConfigured"));
-      return;
-    }
-    const chosenTemplate2 = availableTemplates2[Math.floor(Math.random() * availableTemplates2.length)];
-    await session.onebot.sendGroupMsg(channelId, [createTextMsg(chosenTemplate2)]);
-    await session.onebot.sendGroupForwardMsg(channelId, content);
-    return;
-  }
-  const availableTemplates = [];
-  for (let i = 0; i < TEMPLATE_COUNT; i++) {
-    const prefix = session.text(`echo-cave.templates.msg.${i}.prefix`, templateData);
-    const suffix = session.text(`echo-cave.templates.msg.${i}.suffix`, templateData);
-    if (prefix.trim() !== "" && suffix.trim() !== "") {
-      availableTemplates.push({ prefix, suffix });
-    }
-  }
-  if (availableTemplates.length === 0) {
-    await session.send(session.text("echo-cave.general.noTemplatesConfigured"));
-    return;
-  }
-  const chosenTemplate = availableTemplates[Math.floor(Math.random() * availableTemplates.length)];
-  const last = content.at(-1);
-  const needsNewline = last?.type === "text";
-  content.unshift(createTextMsg(chosenTemplate.prefix));
-  content.push(createTextMsg(`${needsNewline ? "\n\n" : ""}${chosenTemplate.suffix}`));
-  await session.onebot.sendGroupMsg(channelId, content);
-}
-function formatDate(date) {
-  return date.toLocaleDateString("zh-CN", {
-    year: "numeric",
-    month: "2-digit",
-    day: "2-digit"
-  });
-}
-
-// src/forward-helper.ts
+// src/core/parser/forward-parser.ts
 async function reconstructForwardMsg(ctx, session, message, cfg) {
   return Promise.all(
     message.map(async (msg) => {
@@ -520,14 +445,6 @@ async function reconstructForwardMsg(ctx, session, message, cfg) {
     })
   );
 }
-async function getUserIdFromNickname(session, nickname, userId) {
-  const memberInfos = await session.onebot.getGroupMemberList(session.channelId);
-  const matches = memberInfos.filter((m) => m.nickname === nickname);
-  if (matches.length === 1) {
-    return matches[0].user_id;
-  }
-  return userId;
-}
 async function processForwardMessageContent(ctx, session, msg, cfg) {
   if (typeof msg.message === "string") {
     return msg.message;
@@ -543,7 +460,7 @@ async function processForwardMessageContent(ctx, session, msg, cfg) {
   );
 }
 
-// src/msg-helper.ts
+// src/core/parser/msg-parser.ts
 async function processMessageContent(ctx, msg, cfg) {
   return Promise.all(
     msg.map(async (element) => {
@@ -555,131 +472,79 @@ async function processMessageContent(ctx, msg, cfg) {
   );
 }
 
-// src/index.ts
-var import_koishi_plugin_adapter_onebot2 = require("@pynickle/koishi-plugin-adapter-onebot");
-var import_koishi2 = require("koishi");
-var name = "echo-cave";
-var inject = ["database"];
-var Config = import_koishi2.Schema.object({
-  adminMessageProtection: import_koishi2.Schema.boolean().default(false),
-  allowContributorDelete: import_koishi2.Schema.boolean().default(true),
-  allowSenderDelete: import_koishi2.Schema.boolean().default(true),
-  deleteMediaWhenDeletingMsg: import_koishi2.Schema.boolean().default(true),
-  enableSizeLimit: import_koishi2.Schema.boolean().default(false),
-  maxImageSize: import_koishi2.Schema.number().default(2048),
-  maxVideoSize: import_koishi2.Schema.number().default(512),
-  maxFileSize: import_koishi2.Schema.number().default(512),
-  maxRecordSize: import_koishi2.Schema.number().default(512),
-  useBase64ForMedia: import_koishi2.Schema.boolean().default(false)
-}).i18n({
-  "zh-CN": require_zh_CN()._config
-});
-function apply(ctx, cfg) {
-  ctx.i18n.define("zh-CN", require_zh_CN());
-  ctx.model.extend(
-    "echo_cave",
-    {
-      id: "unsigned",
-      channelId: "string",
-      createTime: "timestamp",
-      userId: "string",
-      originUserId: "string",
-      type: "string",
-      content: "text",
-      relatedUsers: "list"
-    },
-    {
-      primary: "id",
-      autoInc: true
-    }
-  );
-  ctx.command("cave [id:number]").action(
-    async ({ session }, id) => await getCave(ctx, session, cfg, id)
-  );
-  ctx.command("cave.echo [...userIds]").action(
-    async ({ session }, ...userIds) => await addCave(ctx, session, cfg, userIds)
-  );
-  ctx.command("cave.drop <id:number>").action(
-    async ({ session }, id) => await deleteCave(ctx, session, cfg, id)
-  );
-  ctx.command("cave.purge <...ids:number>").action(
-    async ({ session }, ...ids) => await deleteCaves(ctx, session, cfg, ids)
-  );
-  ctx.command("cave.search <...userIds>").action(
-    async ({ session }, ...userIds) => await searchCave(ctx, session, userIds)
-  );
-  ctx.command("cave.listen").action(async ({ session }) => await getCaveListByUser(ctx, session));
-  ctx.command("cave.trace").action(
-    async ({ session }) => await getCaveListByOriginUser(ctx, session)
-  );
-  ctx.command("cave.bind <id:number> <...userIds>", { authority: 4 }).action(
-    async ({ session }, id, ...userIds) => await bindUsersToCave(ctx, session, id, userIds)
-  );
-}
-async function getCaveListByUser(ctx, session) {
-  if (!session.guildId) {
-    return session.text("echo-cave.general.privateChatReminder");
-  }
-  const { userId, channelId } = session;
-  const caves = await ctx.database.get("echo_cave", {
-    userId,
-    channelId
-  });
-  if (caves.length === 0) {
-    return session.text(".noMsgContributed");
-  }
-  let response = session.text(".msgListHeader");
-  for (const cave of caves) {
-    response += session.text(".msgListItem", [cave.id, formatDate(cave.createTime)]);
-  }
-  return response;
-}
-async function getCaveListByOriginUser(ctx, session) {
+// src/core/command/add-cave.ts
+var import_koishi_plugin_adapter_onebot = require("@pynickle/koishi-plugin-adapter-onebot");
+async function addCave(ctx, session, cfg, userIds) {
   if (!session.guildId) {
     return session.text("echo-cave.general.privateChatReminder");
   }
-  const { userId, channelId } = session;
-  const caves = await ctx.database.get("echo_cave", {
-    originUserId: userId,
-    channelId
-  });
-  if (caves.length === 0) {
-    return session.text(".noMsgTraced");
-  }
-  let response = session.text(".msgListHeader");
-  for (const cave of caves) {
-    response += session.text(".msgListItem", [cave.id, formatDate(cave.createTime)]);
-  }
-  return response;
-}
-async function getCave(ctx, session, cfg, id) {
-  if (!session.guildId) {
-    return session.text("echo-cave.general.privateChatReminder");
+  if (!session.quote) {
+    return session.text(".noMsgQuoted");
   }
-  let caveMsg;
-  const { channelId } = session;
-  if (!id) {
-    const caves = await ctx.database.get("echo_cave", {
-      channelId
-    });
-    if (caves.length === 0) {
-      return session.text(".noMsgInCave");
+  const { userId, channelId, quote } = session;
+  const messageId = quote.id;
+  let parsedUserIds = [];
+  if (userIds && userIds.length > 0) {
+    ctx.logger.info(`Original userIds in addCave: ${JSON.stringify(userIds)}`);
+    const result = parseUserIds(userIds);
+    if (result.error === "invalid_all_mention") {
+      return session.text("echo-cave.user.invalidAllMention");
     }
-    caveMsg = caves[Math.floor(Math.random() * caves.length)];
-  } else {
-    const caves = await ctx.database.get("echo_cave", {
-      id,
-      channelId
-    });
-    if (caves.length === 0) {
-      return session.text("echo-cave.general.noMsgWithId");
+    parsedUserIds = result.parsedUserIds;
+    const isAllUsersInGroup = await checkUsersInGroup(ctx, session, parsedUserIds);
+    if (!isAllUsersInGroup) {
+      return session.text(".userNotInGroup");
     }
-    caveMsg = caves[0];
   }
-  await sendCaveMsg(ctx, session, caveMsg, cfg);
-}
-async function deleteCave(ctx, session, cfg, id) {
-  if (!session.guildId) {
+  let content;
+  let type;
+  if (quote.elements[0].type === "forward") {
+    type = "forward";
+    const message = await reconstructForwardMsg(
+      ctx,
+      session,
+      await session.onebot.getForwardMsg(messageId),
+      cfg
+    );
+    content = JSON.stringify(message);
+  } else {
+    type = "msg";
+    const message = (await session.onebot.getMsg(messageId)).message;
+    let msgJson;
+    if (typeof message === "string") {
+      msgJson = import_koishi_plugin_adapter_onebot.CQCode.parse(message);
+    } else {
+      if (message[0].type === "video" || message[0].type === "file") {
+        type = "forward";
+      }
+      msgJson = message;
+    }
+    content = JSON.stringify(await processMessageContent(ctx, msgJson, cfg));
+  }
+  await ctx.database.get("echo_cave", { content }).then((existing) => {
+    if (existing) {
+      return session.text(".existingMsg");
+    }
+  });
+  try {
+    const result = await ctx.database.create("echo_cave", {
+      channelId,
+      createTime: /* @__PURE__ */ new Date(),
+      userId,
+      originUserId: quote.user.id,
+      type,
+      content,
+      relatedUsers: parsedUserIds || []
+    });
+    return session.text(".msgSaved", [result.id]);
+  } catch (error) {
+    return session.text(".msgFailedToSave");
+  }
+}
+
+// src/core/command/delete-cave.ts
+async function deleteCave(ctx, session, cfg, id) {
+  if (!session.guildId) {
     return session.text("echo-cave.general.privateChatReminder");
   }
   if (!id) {
@@ -771,73 +636,154 @@ async function deleteCaves(ctx, session, cfg, ids) {
     return session.text(".msgDeletePartial", [failedIds.join(", ")]);
   }
 }
-async function addCave(ctx, session, cfg, userIds) {
-  if (!session.guildId) {
-    return session.text("echo-cave.general.privateChatReminder");
-  }
-  if (!session.quote) {
-    return session.text(".noMsgQuoted");
-  }
-  const { userId, channelId, quote } = session;
-  const messageId = quote.id;
-  let parsedUserIds = [];
-  if (userIds && userIds.length > 0) {
-    ctx.logger.info(`Original userIds in addCave: ${JSON.stringify(userIds)}`);
-    const result = parseUserIds(userIds);
-    if (result.error === "invalid_all_mention") {
-      return session.text(".invalidAllMention");
-    }
-    parsedUserIds = result.parsedUserIds;
-    const isAllUsersInGroup = await checkUsersInGroup(ctx, session, parsedUserIds);
-    if (!isAllUsersInGroup) {
-      return session.text(".userNotInGroup");
+
+// src/utils/msg/cqcode-helper.ts
+function createTextMsg(content) {
+  return {
+    type: "text",
+    data: {
+      text: content
     }
+  };
+}
+
+// src/core/formatter/msg-formatter.ts
+async function sendCaveMsg(ctx, session, caveMsg, cfg) {
+  const { channelId } = session;
+  let content = JSON.parse(caveMsg.content);
+  if (cfg.useBase64ForMedia) {
+    content = await Promise.all(
+      content.map(async (element) => await convertFileUriToBase64(ctx, element))
+    );
   }
-  let content;
-  let type;
-  if (quote.elements[0].type === "forward") {
-    type = "forward";
-    const message = await reconstructForwardMsg(
-      ctx,
-      session,
-      await session.onebot.getForwardMsg(messageId),
-      cfg
+  const date = formatDate(caveMsg.createTime);
+  const originName = await getUserName(ctx, session, caveMsg.originUserId);
+  const userName = await getUserName(ctx, session, caveMsg.userId);
+  let relatedUsersFormatted = originName;
+  if (caveMsg.relatedUsers && caveMsg.relatedUsers.length > 0) {
+    const relatedUserNames = await Promise.all(
+      caveMsg.relatedUsers.map(async (userId) => await getUserName(ctx, session, userId))
     );
-    content = JSON.stringify(message);
-  } else {
-    type = "msg";
-    const message = (await session.onebot.getMsg(messageId)).message;
-    let msgJson;
-    if (typeof message === "string") {
-      msgJson = import_koishi_plugin_adapter_onebot2.CQCode.parse(message);
-    } else {
-      if (message[0].type === "video" || message[0].type === "file") {
-        type = "forward";
+    relatedUsersFormatted = relatedUserNames.join(", ");
+  }
+  const templateData = {
+    id: caveMsg.id.toString(),
+    date,
+    originName,
+    userName,
+    relatedUsers: relatedUsersFormatted,
+    nl: "\n"
+  };
+  const TEMPLATE_COUNT = 5;
+  if (caveMsg.type === "forward") {
+    const availableTemplates2 = [];
+    for (let i = 0; i < TEMPLATE_COUNT; i++) {
+      const template = session.text(`echo-cave.templates.forward.${i}`, templateData);
+      if (template.trim() !== "") {
+        availableTemplates2.push(template);
       }
-      msgJson = message;
     }
-    content = JSON.stringify(await processMessageContent(ctx, msgJson, cfg));
+    if (availableTemplates2.length === 0) {
+      await session.send(session.text("echo-cave.general.noTemplatesConfigured"));
+      return;
+    }
+    const chosenTemplate2 = availableTemplates2[Math.floor(Math.random() * availableTemplates2.length)];
+    await session.onebot.sendGroupMsg(channelId, [createTextMsg(chosenTemplate2)]);
+    await session.onebot.sendGroupForwardMsg(channelId, content);
+    return;
   }
-  await ctx.database.get("echo_cave", { content }).then((existing) => {
-    if (existing) {
-      return session.text(".existingMsg");
+  const availableTemplates = [];
+  for (let i = 0; i < TEMPLATE_COUNT; i++) {
+    const prefix = session.text(`echo-cave.templates.msg.${i}.prefix`, templateData);
+    const suffix = session.text(`echo-cave.templates.msg.${i}.suffix`, templateData);
+    if (prefix.trim() !== "" && suffix.trim() !== "") {
+      availableTemplates.push({ prefix, suffix });
     }
+  }
+  if (availableTemplates.length === 0) {
+    await session.send(session.text("echo-cave.general.noTemplatesConfigured"));
+    return;
+  }
+  const chosenTemplate = availableTemplates[Math.floor(Math.random() * availableTemplates.length)];
+  const last = content.at(-1);
+  const needsNewline = last?.type === "text";
+  content.unshift(createTextMsg(chosenTemplate.prefix));
+  content.push(createTextMsg(`${needsNewline ? "\n\n" : ""}${chosenTemplate.suffix}`));
+  await session.onebot.sendGroupMsg(channelId, content);
+}
+function formatDate(date) {
+  return date.toLocaleDateString("zh-CN", {
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit"
   });
-  try {
-    const result = await ctx.database.create("echo_cave", {
-      channelId,
-      createTime: /* @__PURE__ */ new Date(),
-      userId,
-      originUserId: quote.user.id,
-      type,
-      content,
-      relatedUsers: parsedUserIds || []
+}
+
+// src/core/command/get-cave.ts
+async function getCaveListByUser(ctx, session) {
+  if (!session.guildId) {
+    return session.text("echo-cave.general.privateChatReminder");
+  }
+  const { userId, channelId } = session;
+  const caves = await ctx.database.get("echo_cave", {
+    userId,
+    channelId
+  });
+  if (caves.length === 0) {
+    return session.text(".noMsgContributed");
+  }
+  let response = session.text(".msgListHeader");
+  for (const cave of caves) {
+    response += session.text(".msgListItem", [cave.id, formatDate(cave.createTime)]);
+  }
+  return response;
+}
+async function getCaveListByOriginUser(ctx, session) {
+  if (!session.guildId) {
+    return session.text("echo-cave.general.privateChatReminder");
+  }
+  const { userId, channelId } = session;
+  const caves = await ctx.database.get("echo_cave", {
+    originUserId: userId,
+    channelId
+  });
+  if (caves.length === 0) {
+    return session.text(".noMsgTraced");
+  }
+  let response = session.text(".msgListHeader");
+  for (const cave of caves) {
+    response += session.text(".msgListItem", [cave.id, formatDate(cave.createTime)]);
+  }
+  return response;
+}
+async function getCave(ctx, session, cfg, id) {
+  if (!session.guildId) {
+    return session.text("echo-cave.general.privateChatReminder");
+  }
+  let caveMsg;
+  const { channelId } = session;
+  if (!id) {
+    const caves = await ctx.database.get("echo_cave", {
+      channelId
     });
-    return session.text(".msgSaved", [result.id]);
-  } catch (error) {
-    return session.text(".msgFailedToSave");
+    if (caves.length === 0) {
+      return session.text(".noMsgInCave");
+    }
+    caveMsg = caves[Math.floor(Math.random() * caves.length)];
+  } else {
+    const caves = await ctx.database.get("echo_cave", {
+      id,
+      channelId
+    });
+    if (caves.length === 0) {
+      return session.text("echo-cave.general.noMsgWithId");
+    }
+    caveMsg = caves[0];
   }
+  await sendCaveMsg(ctx, session, caveMsg, cfg);
 }
+
+// src/core/command/misc/bind-user.ts
 async function bindUsersToCave(ctx, session, id, userIds) {
   if (!session.guildId) {
     return session.text("echo-cave.general.privateChatReminder");
@@ -845,38 +791,43 @@ async function bindUsersToCave(ctx, session, id, userIds) {
   if (!id) {
     return session.text(".noIdProvided");
   }
-  if (!userIds || userIds.length === 0) {
+  if (!userIds) {
     return session.text(".noUserIdProvided");
   }
-  let parsedUserIds = [];
   const result = parseUserIds(userIds);
   if (result.error === "invalid_all_mention") {
-    return session.text(".invalidAllMention");
+    return session.text("echo-cave.user.invalidAllMention");
+  }
+  const parsedUserIds = result.parsedUserIds;
+  if (parsedUserIds.length === 0) {
+    return session.text(".noValidUserIdProvided");
   }
-  parsedUserIds = result.parsedUserIds;
   const caves = await ctx.database.get("echo_cave", id);
   if (caves.length === 0) {
     return session.text("echo-cave.general.noMsgWithId");
   }
   const isAllUsersInGroup = await checkUsersInGroup(ctx, session, parsedUserIds);
   if (!isAllUsersInGroup) {
-    return session.text(".userNotInGroup");
+    return session.text("echo-cave.user.userNotInGroup");
   }
   await ctx.database.set("echo_cave", id, {
     relatedUsers: parsedUserIds
   });
   return session.text(".userBoundSuccess", [id]);
 }
+
+// src/core/command/search-cave.ts
+var import_koishi2 = require("koishi");
 async function searchCave(ctx, session, userIds) {
   if (!session.guildId) {
     return session.text("echo-cave.general.privateChatReminder");
   }
-  if (!userIds || userIds.length === 0) {
+  if (!userIds) {
     return session.text(".noUserIdProvided");
   }
-  const result = parseUserIds(userIds);
+  const result = parseUserIds(userIds.toString());
   if (result.error === "invalid_all_mention") {
-    return session.text(".invalidAllMention");
+    return session.text("echo-cave.user.invalidAllMention");
   }
   const parsedUserIds = result.parsedUserIds;
   if (parsedUserIds.length === 0) {
@@ -884,15 +835,16 @@ async function searchCave(ctx, session, userIds) {
   }
   const isUserInGroup = await checkUsersInGroup(ctx, session, parsedUserIds);
   if (!isUserInGroup) {
-    return session.text(".userNotInGroup");
+    return session.text("echo-cave.user.userNotInGroup");
   }
   const targetUserId = parsedUserIds[0];
   const { channelId } = session;
-  const caves = await ctx.database.get("echo_cave", {
-    channelId
-  });
-  const matchingCaves = caves.filter(
-    (cave) => cave.originUserId === targetUserId || cave.relatedUsers.includes(targetUserId)
+  const matchingCaves = await ctx.database.get(
+    "echo_cave",
+    (row) => import_koishi2.$.and(
+      import_koishi2.$.eq(row.channelId, channelId),
+      import_koishi2.$.or(import_koishi2.$.eq(row.originUserId, targetUserId), import_koishi2.$.in(targetUserId, row.relatedUsers))
+    )
   );
   if (matchingCaves.length === 0) {
     return session.text(".noMatchingCaves", [targetUserId]);
@@ -901,9 +853,54 @@ async function searchCave(ctx, session, userIds) {
   const count = matchingCaves.length;
   return session.text(".searchResult", [count, caveIds]);
 }
+
+// src/index.ts
+var name = "echo-cave";
+var inject = ["database"];
+function apply(ctx, cfg) {
+  ctx.i18n.define("zh-CN", require_zh_CN());
+  ctx.model.extend(
+    "echo_cave",
+    {
+      id: "unsigned",
+      channelId: "string",
+      createTime: "timestamp",
+      userId: "string",
+      originUserId: "string",
+      type: "string",
+      content: "text",
+      relatedUsers: "list"
+    },
+    {
+      primary: "id",
+      autoInc: true
+    }
+  );
+  ctx.command("cave [id:number]").action(
+    async ({ session }, id) => await getCave(ctx, session, cfg, id)
+  );
+  ctx.command("cave.listen").action(async ({ session }) => await getCaveListByUser(ctx, session));
+  ctx.command("cave.trace").action(
+    async ({ session }) => await getCaveListByOriginUser(ctx, session)
+  );
+  ctx.command("cave.echo [...userIds]").action(
+    async ({ session }, ...userIds) => await addCave(ctx, session, cfg, userIds)
+  );
+  ctx.command("cave.drop <id:number>").action(
+    async ({ session }, id) => await deleteCave(ctx, session, cfg, id)
+  );
+  ctx.command("cave.purge <...ids:number>").action(
+    async ({ session }, ...ids) => await deleteCaves(ctx, session, cfg, ids)
+  );
+  ctx.command("cave.search <id:number>").action(
+    async ({ session }, id) => await searchCave(ctx, session, id)
+  );
+  ctx.command("cave.bind <id:number> <...userIds>", { authority: 4 }).action(
+    async ({ session }, id, ...userIds) => await bindUsersToCave(ctx, session, id, userIds)
+  );
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  Config,
   apply,
   inject,
   name

package/lib/index.d.ts

@@ -1,20 +1,8 @@
 import '@pynickle/koishi-plugin-adapter-onebot';
-import { Context, Schema } from 'koishi';
+import { Config } from './config/config';
+import { Context } from 'koishi';
 export declare const name = "echo-cave";
 export declare const inject: string[];
-export interface Config {
-    adminMessageProtection?: boolean;
-    allowContributorDelete?: boolean;
-    allowSenderDelete?: boolean;
-    deleteMediaWhenDeletingMsg?: boolean;
-    enableSizeLimit?: boolean;
-    maxImageSize?: number;
-    maxVideoSize?: number;
-    maxFileSize?: number;
-    maxRecordSize?: number;
-    useBase64ForMedia?: boolean;
-}
-export declare const Config: Schema<Config>;
 export interface EchoCave {
     id: number;
     channelId: string;

package/lib/{media-helper.d.ts → utils/media/media-helper.d.ts}

@@ -1,4 +1,4 @@
-import { Config } from './index';
+import { Config } from '../../config/config';
 import { Context } from 'koishi';
 export declare function saveMedia(ctx: Context, mediaElement: Record<string, any>, type: 'image' | 'video' | 'file' | 'record', cfg: Config): Promise<string>;
 export declare function processMediaElement(ctx: Context, element: any, cfg: Config): Promise<any>;

package/lib/utils/msg/cqcode-helper.d.ts

@@ -0,0 +1,6 @@
+export declare function createTextMsg(content: string): {
+    type: string;
+    data: {
+        text: string;
+    };
+};

package/lib/utils/msg/element-helper.d.ts

@@ -0,0 +1,5 @@
+export interface ParseResult {
+    parsedUserIds: string[];
+    error?: string;
+}
+export declare function parseUserIds(userIds: string[] | string): ParseResult;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-echo-cave",
   "description": "Group echo cave",
-  "version": "1.17.0",
+  "version": "1.18.0",
   "main": "lib/index.cjs",
   "typings": "lib/index.d.ts",
   "type": "module",

package/lib/cqcode-helper.d.ts

@@ -1,11 +0,0 @@
-export interface ParseResult {
-    parsedUserIds: string[];
-    error?: string;
-}
-export declare function createTextMsg(content: string): {
-    type: string;
-    data: {
-        text: string;
-    };
-};
-export declare function parseUserIds(userIds: any[]): ParseResult;