koishi-plugin-chat-analyse 1.6.13 → 1.7.1

package/lib/index.d.ts

@@ -21,7 +21,7 @@ export interface Config {
     enableWordCloud: boolean;
     maxWords: number;
     cacheRetentionDays: number;
-    enableSimilarActivity: boolean;
+    enableSimiActivity: boolean;
     enableAutoBackup: boolean;
     color: string;
     shape: string;

package/lib/index.js

@@ -1605,7 +1605,7 @@ var Renderer = class {
    */
   async *renderList(data, headers) {
     const { title, time, list } = data;
-    const CHUNK_SIZE = 500;
+    const CHUNK_SIZE = 200;
     const totalItems = list.length;
     const countHeaderIndex = headers?.findIndex((h7) => ["总计发言", "条数", "次数", "数量"].includes(h7)) ?? -1;
     const totalCount = data.total || (countHeaderIndex > -1 ? list.reduce((sum, row) => sum + (Number(row[countHeaderIndex]) || 0), 0) : totalItems);
@@ -1907,7 +1907,7 @@ var Stat = class {
       }
     }, "handleAction");
     if (this.config.enableCmdStat) {
-      cmd.subcommand("cmdstat", "命令统计").usage("查询命令统计，可指定查询范围，默认当前群组。").option("user", "-u <user:string> 指定用户").option("guild", "-g <guildId:string> 指定群组").option("separate", "-p 分离子命令").option("sortByTime", "-s 以时间排序").option("all", "-a 全局统计").action(({ session, options }) => handleAction(session, (async () => {
+      cmd.subcommand("cmdstat", "命令统计").usage("查询命令统计，可指定查询范围，默认当前群组。").option("user", "-u <user:string> 指定用户").option("guild", "-g <guildId:string> 指定群组").option("limit", "-l <count:number> 限制数量").option("separate", "-p 分离子命令").option("sortByTime", "-s 以时间排序").option("all", "-a 全局统计").action(({ session, options }) => handleAction(session, (async () => {
         const scope = await this.parseScope(session, options);
         if (scope.error) return scope.error;
         const query = scope.uids ? { uid: { $in: scope.uids } } : {};
@@ -1932,14 +1932,15 @@ var Stat = class {
         } else {
           processedStats.sort((a, b) => b.count - a.count);
         }
+        const limitedStats = options.limit > 0 ? processedStats.slice(0, options.limit) : processedStats;
         const total = processedStats.reduce((sum, r) => sum + r.count, 0);
-        const list = processedStats.map((item) => [item.command, item.count, item.lastUsed]);
+        const list = limitedStats.map((item) => [item.command, item.count, item.lastUsed]);
         const title = await generateTitle(this.ctx, scope.scopeDesc, { main: "命令" });
         return this.renderer.renderList({ title, time: /* @__PURE__ */ new Date(), total, list }, ["命令", "次数", "最后使用"]);
       })()));
     }
     if (this.config.enableMsgStat) {
-      cmd.subcommand("msgstat", "发言统计").usage("查询发言统计，可指定查询范围，默认当前群组。").option("user", "-u <user:string> 指定用户").option("guild", "-g <guildId:string> 指定群组").option("type", "-t <type:string> 指定类型").option("sortByTime", "-s 以时间排序").option("all", "-a 全局统计").action(({ session, options }) => handleAction(session, (async () => {
+      cmd.subcommand("msgstat", "发言统计").usage("查询发言统计，可指定查询范围，默认当前群组。").option("user", "-u <user:string> 指定用户").option("guild", "-g <guildId:string> 指定群组").option("type", "-t <type:string> 指定类型").option("limit", "-l <count:number> 限制数量").option("sortByTime", "-s 以时间排序").option("all", "-a 全局统计").action(({ session, options }) => handleAction(session, (async () => {
         const scope = await this.parseScope(session, options);
         if (scope.error) return scope.error;
         const query = scope.uids ? { uid: { $in: scope.uids } } : {};
@@ -1956,8 +1957,9 @@ var Stat = class {
           const stats2 = await this.ctx.database.select("analyse_msg").where(query).groupBy("type", { count: /* @__PURE__ */ __name((row) => import_koishi3.$.sum(row.count), "count"), lastUsed: /* @__PURE__ */ __name((row) => import_koishi3.$.max(row.timestamp), "lastUsed") }).execute();
           if (stats2.length === 0) return "暂无统计数据";
           applySort(stats2);
+          const limitedStats2 = options.limit > 0 ? stats2.slice(0, options.limit) : stats2;
           const total2 = stats2.reduce((sum, r) => sum + r.count, 0);
-          const list2 = stats2.map((item) => [item.type, item.count, item.lastUsed]);
+          const list2 = limitedStats2.map((item) => [item.type, item.count, item.lastUsed]);
           return this.renderer.renderList({ title, time: /* @__PURE__ */ new Date(), total: total2, list: list2 }, ["类型", "条数", "最后发言"]);
         }
         if (options.user) {
@@ -1966,14 +1968,16 @@ var Stat = class {
           const stats2 = await this.ctx.database.select("analyse_msg").where(query).groupBy("uid", { count: /* @__PURE__ */ __name((row) => import_koishi3.$.sum(row.count), "count"), lastUsed: /* @__PURE__ */ __name((row) => import_koishi3.$.max(row.timestamp), "lastUsed") }).execute();
           if (stats2.length === 0) return "暂无统计数据";
           applySort(stats2);
+          const limitedStats2 = options.limit > 0 ? stats2.slice(0, options.limit) : stats2;
           const total2 = stats2.reduce((sum, r) => sum + r.count, 0);
-          const list2 = stats2.map((item) => [uidToChannelMap.get(item.uid) || `未知群组`, item.count, item.lastUsed]);
+          const list2 = limitedStats2.map((item) => [uidToChannelMap.get(item.uid) || `未知群组`, item.count, item.lastUsed]);
           return this.renderer.renderList({ title, time: /* @__PURE__ */ new Date(), total: total2, list: list2 }, ["群组", "条数", "最后发言"]);
         }
         const stats = await this.ctx.database.select("analyse_msg").where(query).groupBy("uid", { count: /* @__PURE__ */ __name((row) => import_koishi3.$.sum(row.count), "count"), lastUsed: /* @__PURE__ */ __name((row) => import_koishi3.$.max(row.timestamp), "lastUsed") }).execute();
         if (stats.length === 0) return "暂无统计数据";
         applySort(stats);
-        const allUids = stats.map((s) => s.uid);
+        const limitedStats = options.limit > 0 ? stats.slice(0, options.limit) : stats;
+        const allUids = limitedStats.map((s) => s.uid);
         const userNameMap = /* @__PURE__ */ new Map();
         const BATCH_SIZE2 = 4096;
         for (let i = 0; i < allUids.length; i += BATCH_SIZE2) {
@@ -1984,12 +1988,12 @@ var Stat = class {
           }
         }
         const total = stats.reduce((sum, r) => sum + r.count, 0);
-        const list = stats.map((item) => [userNameMap.get(item.uid) || `UID ${item.uid}`, item.count, item.lastUsed]);
+        const list = limitedStats.map((item) => [userNameMap.get(item.uid) || `UID ${item.uid}`, item.count, item.lastUsed]);
         return this.renderer.renderList({ title, time: /* @__PURE__ */ new Date(), total, list }, ["用户", "条数", "最后发言"]);
       })()));
     }
     if (this.config.enableRankStat) {
-      cmd.subcommand("rankstat", "发言排行").usage("查询发言排行，可指定查询范围，默认当前群组。").option("user", "-u <user:string> 指定用户").option("guild", "-g <guildId:string> 指定群组").option("type", "-t <type:string> 指定类型").option("duration", "-n <hours:number> 指定时长", { fallback: 24 }).option("offset", "-o <hours:number> 指定偏移", { fallback: 0 }).option("all", "-a 全局统计").action(({ session, options }) => handleAction(session, (async () => {
+      cmd.subcommand("rankstat", "发言排行").usage("查询发言排行，可指定查询范围，默认当前群组。").option("user", "-u <user:string> 指定用户").option("guild", "-g <guildId:string> 指定群组").option("type", "-t <type:string> 指定类型").option("duration", "-n <hours:number> 指定时长", { fallback: 24 }).option("offset", "-o <hours:number> 指定偏移", { fallback: 0 }).option("limit", "-l <count:number> 限制数量").option("all", "-a 全局统计").action(({ session, options }) => handleAction(session, (async () => {
         const scope = await this.parseScope(session, options);
         if (scope.error) return scope.error;
         const until = new Date(Date.now() - options.offset * import_koishi3.Time.hour);
@@ -2001,8 +2005,9 @@ var Stat = class {
         if (options.user && options.guild) {
           const stats2 = await this.ctx.database.select("analyse_rank").where(query).groupBy("type", { count: /* @__PURE__ */ __name((row) => import_koishi3.$.sum(row.count), "count") }).orderBy("count", "desc").execute();
           if (stats2.length === 0) return "暂无统计数据";
+          const limitedStats2 = options.limit > 0 ? stats2.slice(0, options.limit) : stats2;
           const total2 = stats2.reduce((sum, r) => sum + r.count, 0);
-          const list2 = stats2.map((r) => [r.type, r.count, total2 > 0 ? `${(r.count / total2 * 100).toFixed(2)}%` : "0.00%"]);
+          const list2 = limitedStats2.map((r) => [r.type, r.count, total2 > 0 ? `${(r.count / total2 * 100).toFixed(2)}%` : "0.00%"]);
           return this.renderer.renderList({ title, time: /* @__PURE__ */ new Date(), total: total2, list: list2 }, ["类型", "条数", "占比"]);
         }
         if (options.user) {
@@ -2010,13 +2015,15 @@ var Stat = class {
           const uidToChannelMap = new Map(userRecords.map((u) => [u.uid, u.channelName || u.channelId]));
           const stats2 = await this.ctx.database.select("analyse_rank").where(query).groupBy("uid", { count: /* @__PURE__ */ __name((row) => import_koishi3.$.sum(row.count), "count") }).orderBy("count", "desc").execute();
           if (stats2.length === 0) return "暂无统计数据";
+          const limitedStats2 = options.limit > 0 ? stats2.slice(0, options.limit) : stats2;
           const total2 = stats2.reduce((sum, r) => sum + r.count, 0);
-          const list2 = stats2.map((r) => [uidToChannelMap.get(r.uid) || "未知群组", r.count, total2 > 0 ? `${(r.count / total2 * 100).toFixed(2)}%` : "0.00%"]);
+          const list2 = limitedStats2.map((r) => [uidToChannelMap.get(r.uid) || "未知群组", r.count, total2 > 0 ? `${(r.count / total2 * 100).toFixed(2)}%` : "0.00%"]);
           return this.renderer.renderList({ title, time: /* @__PURE__ */ new Date(), total: total2, list: list2 }, ["群组", "条数", "占比"]);
         }
         const stats = await this.ctx.database.select("analyse_rank").where(query).groupBy("uid", { count: /* @__PURE__ */ __name((row) => import_koishi3.$.sum(row.count), "count") }).orderBy("count", "desc").execute();
         if (stats.length === 0) return "暂无统计数据";
-        const allUids = stats.map((s) => s.uid);
+        const limitedStats = options.limit > 0 ? stats.slice(0, options.limit) : stats;
+        const allUids = limitedStats.map((s) => s.uid);
         const userNameMap = /* @__PURE__ */ new Map();
         const BATCH_SIZE2 = 4096;
         for (let i = 0; i < allUids.length; i += BATCH_SIZE2) {
@@ -2027,7 +2034,7 @@ var Stat = class {
           }
         }
         const total = stats.reduce((sum, r) => sum + r.count, 0);
-        const list = stats.map((r) => [userNameMap.get(r.uid) || `UID ${r.uid}`, r.count, total > 0 ? `${(r.count / total * 100).toFixed(2)}%` : "0.00%"]);
+        const list = limitedStats.map((r) => [userNameMap.get(r.uid) || `UID ${r.uid}`, r.count, total > 0 ? `${(r.count / total * 100).toFixed(2)}%` : "0.00%"]);
         return this.renderer.renderList({ title, time: /* @__PURE__ */ new Date(), total, list }, ["用户", "条数", "占比"]);
       })()));
     }
@@ -2152,7 +2159,7 @@ var Data = class {
       if (allUsers.length === 0) return;
       const uidToUserInfoMap = new Map(allUsers.map((u) => [u.uid, u]));
       const targetDate = /* @__PURE__ */ new Date();
-      targetDate.setMonth(targetDate.getMonth() - 1);
+      targetDate.setDate(targetDate.getDate() - 1);
       const year = targetDate.getFullYear();
       const monthIndex = targetDate.getMonth();
       const day = targetDate.getDate();
@@ -2317,6 +2324,40 @@ var Data = class {
       }
     });
     if (this.config.enableOriRecord) {
+      cmd.subcommand(".archive [date:date]", "手动归档", { authority: 4 }).usage("手动归档指定日期的原始消息记录。默认归档前一天的记录。").action(async ({}, date) => {
+        const targetDate = date || /* @__PURE__ */ new Date();
+        if (!date) targetDate.setDate(targetDate.getDate() - 1);
+        try {
+          await fs.mkdir(this.dataDir, { recursive: true });
+          const allUsers = await this.ctx.database.get("analyse_user", {});
+          if (allUsers.length === 0) return "暂无用户数据";
+          const uidToUserInfoMap = new Map(allUsers.map((u) => [u.uid, u]));
+          const year = targetDate.getFullYear();
+          const monthIndex = targetDate.getMonth();
+          const day = targetDate.getDate();
+          const monthString = (monthIndex + 1).toString().padStart(2, "0");
+          const dayString = day.toString().padStart(2, "0");
+          const filename = `analyse_cache_${year}-${monthString}-${dayString}.json`;
+          const filepath = path.join(this.dataDir, filename);
+          const startDate = new Date(year, monthIndex, day);
+          const endDate = new Date(year, monthIndex, day + 1);
+          const records = await this.ctx.database.get("analyse_cache", { timestamp: { $gte: startDate, $lt: endDate } });
+          if (records.length === 0) return `暂无统计数据`;
+          const dataToExport = records.map((record) => {
+            const userInfo = uidToUserInfoMap.get(record.uid);
+            if (!userInfo) return null;
+            const { id, uid, ...restOfRecord } = record;
+            return { userId: userInfo.userId, channelId: userInfo.channelId, ...restOfRecord };
+          }).filter(Boolean);
+          if (dataToExport.length > 0) {
+            await fs.writeFile(filepath, JSON.stringify(dataToExport, null, 2));
+            return `已归档${year}年${monthString}月${dayString}日的${dataToExport.length}条记录`;
+          }
+        } catch (error) {
+          this.ctx.logger.error("手动归档失败:", error);
+          return "手动归档失败";
+        }
+      });
       cmd.subcommand(".view [time:string]", "查询消息记录", { authority: 4 }).usage("查询指定时间点之前的消息记录，默认查询当前群组。").option("user", "-u <user:string> 指定用户").option("guild", "-g <guildId:string> 指定群组").option("count", "-n <count:number> 指定数量", { fallback: 100 }).action(async ({ session, options }, time) => {
         const until = time ? new Date(time) : /* @__PURE__ */ new Date();
         if (time && isNaN(until.getTime())) return "时间格式无效";
@@ -2453,7 +2494,7 @@ var Analyse = class {
         }
       });
     }
-    if (this.config.enableSimilarActivity) {
+    if (this.config.enableSimiActivity) {
       cmd.subcommand("simiactive", "相似活跃分析").usage("分析你和群友的活跃规律，找出谁和你的作息最相似。").option("hours", "-n <hours:number> 指定时长", { fallback: 24 }).option("separate", "-p 分时分析").action(async ({ session, options }) => {
         const effectiveChannelId = session.guildId || session.channelId;
         if (!effectiveChannelId) return "请在群组中使用此命令";
@@ -2553,17 +2594,17 @@ var Config3 = import_koishi7.Schema.intersect([
     enableCmdStat: import_koishi7.Schema.boolean().default(true).description("启用命令统计"),
     enableMsgStat: import_koishi7.Schema.boolean().default(true).description("启用消息统计"),
     enableActivity: import_koishi7.Schema.boolean().default(true).description("启用活跃统计"),
+    enableSimiActivity: import_koishi7.Schema.boolean().default(true).description("启用活跃比较"),
     enableRankStat: import_koishi7.Schema.boolean().default(true).description("启用发言排行"),
-    rankRetentionDays: import_koishi7.Schema.number().min(0).default(365).description("排行保留天数"),
     enableWhoAt: import_koishi7.Schema.boolean().default(true).description("启用提及记录"),
+    rankRetentionDays: import_koishi7.Schema.number().min(0).default(365).description("排行保留天数"),
     atRetentionDays: import_koishi7.Schema.number().min(0).default(3).description("提及保留天数")
   }).description("基础分析配置"),
   import_koishi7.Schema.object({
     enableOriRecord: import_koishi7.Schema.boolean().default(true).description("启用原始记录"),
-    cacheRetentionDays: import_koishi7.Schema.number().min(0).default(31).description("记录保留天数"),
-    enableAutoBackup: import_koishi7.Schema.boolean().default(false).description("启用自动备份"),
     enableWordCloud: import_koishi7.Schema.boolean().default(true).description("启用词云生成"),
-    enableSimilarActivity: import_koishi7.Schema.boolean().default(true).description("启用相似活跃分析")
+    enableAutoBackup: import_koishi7.Schema.boolean().default(true).description("启用自动归档"),
+    cacheRetentionDays: import_koishi7.Schema.number().min(0).default(7).description("记录保留天数")
   }).description("高级分析配置"),
   import_koishi7.Schema.object({
     maxWords: import_koishi7.Schema.number().min(0).default(1024).description("最大词量"),
@@ -2622,7 +2663,7 @@ function apply(ctx, config) {
   new Stat(ctx, config).registerCommands(analyse);
   if (config.enableWhoAt) new WhoAt(ctx, config).registerCommand(analyse);
   if (config.enableDataIO) new Data(ctx, config).registerCommands(analyse);
-  if (config.enableWordCloud || config.enableSimilarActivity) new Analyse(ctx, config).registerCommands(analyse);
+  if (config.enableWordCloud || config.enableSimiActivity) new Analyse(ctx, config).registerCommands(analyse);
 }
 __name(apply, "apply");
 // Annotate the CommonJS export names for ESM import in node:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-chat-analyse",
   "description": "强大而全面的聊天数据分析插件。支持多维度统计（命令、发言、消息类型、活跃度），可生成发言排行、词云图，并提供完善的数据管理。",
-  "version": "1.6.13",
+  "version": "1.7.1",
   "contributors": [
     "Yis_Rime <yis_rime@outlook.com>"
   ],

package/readme.md

@@ -8,18 +8,18 @@
 
 **高效数据收集**：采用异步、高并发和缓存机制，在不影响机器人性能的前提下，精确高效地收集聊天数据。
 **多维度统计分析**：
-  **命令统计** (`cmdstat`)：追踪指令使用频率，了解用户最常用的功能，支持按次数或时间排序。
-  **发言统计** (`msgstat`)：分析用户发言类型与数量，掌握核心用户群体，支持按条数或时间排序。
-  **发言排行** (`rankstat`)：生成指定时间范围内的用户发言排行榜，发掘群聊中的“龙王”。
-  **活跃度分析** (`activity`)：以小时或天为单位，生成直观的周期性活跃度图表，洞察社群活跃时段。
+    **命令统计** (`cmdstat`)：追踪指令使用频率，了解用户最常用的功能，支持按次数或时间排序。
+    **发言统计** (`msgstat`)：分析用户发言类型与数量，掌握核心用户群体，支持按条数或时间排序。
+    **发言排行** (`rankstat`)：生成指定时间范围内的用户发言排行榜，发掘群聊中的“龙王”。
+    **活跃度分析** (`activity`)：以小时或天为单位，生成直观的周期性活跃度图表，洞察社群活跃时段。
 **高级文本分析**：
-  **词云生成** (`wordcloud`)：基于聊天记录，利用 Jieba 分词生成热门话题词云图，快速了解近期热点。
-  **相似活跃分析** (`simiactive`): 分析指定时间内，找出与您作息模式最相似的群友，并通过对比图表直观展示。
-  **提及追踪** (`whoatme`)：轻松查询谁在什么时候因为什么内容提及了您，不再错过重要信息。
+    **词云生成** (`wordcloud`)：基于聊天记录，利用 Jieba 分词生成热门话题词云图，快速了解近期热点。
+    **相似活跃分析** (`simiactive`)：分析指定时间内，找出与您作息模式最相似的群友，并通过对比图表直观展示。
+    **提及追踪** (`whoatme`)：轻松查询谁在什么时候因为什么内容提及了您，不再错过重要信息。
 **强大的数据管理**：
-  **备份与恢复** (`.backup`/`.restore`)：一键备份所有统计数据至本地，并可随时恢复，保障数据安全。
-  **精确清理** (`.clear`)：提供多维度的筛选条件（如按时间、用户、群组、发言数），精确清理不再需要的数据。
-  **记录查看** (`.view`): 可回溯查看指定时间点后的原始消息记录。
+    **备份与恢复** (`.backup`/`.restore`)：一键备份所有统计数据至本地，并可随时恢复，保障数据安全。
+    **精确清理** (`.clear`)：提供多维度的筛选条件（如按时间、用户、群组、发言数），精确清理不再需要的数据。
+    **记录查看** (`.view`)：可回溯查看指定时间点之前的原始消息记录。
 **精美图表渲染**：借助 Puppeteer 服务，将复杂的统计数据渲染成美观、易读的图片，方便在聊天中分享。
 **高度可配置**：所有功能模块均可独立开关，并可自定义数据保留时长等核心参数，以适应不同场景的需求。
 
@@ -38,18 +38,19 @@
 ### 指令列表
 
 | 指令 | 别名 | 描述 | 选项 |
-| :--| :--| :--| :--|
-| `cmdstat` | 命令统计 | 查询命令使用情况，展示方式根据选项变化 | `-u`, `-g`, `-a`, `-p`, `-s` |
-| `msgstat` | 发言统计 | 查询用户发言统计，展示方式根据选项变化 | `-u`, `-g`, `-a`, `-t`, `-s` |
-| `rankstat` | 发言排行 | 查询指定时间内的发言排行 | `-u`, `-g`, `-a`, `-t`, `-n`, `-o` |
-| `activity` | 活跃统计 | 查询周期性活跃度图表 | `-u`, `-g`, `-a`, `-d`, `-n`, `-o` |
+| :--- | :--- | :--- | :--- |
+| `cmdstat` | 命令统计 | 查询命令使用情况，展示方式根据选项变化 | `-u`, `-g`, `-l`, `-p`, `-s`, `-a` |
+| `msgstat` | 发言统计 | 查询用户发言统计，展示方式根据选项变化 | `-u`, `-g`, `-t`, `-l`, `-s`, `-a` |
+| `rankstat` | 发言排行 | 查询指定时间内的发言排行 | `-u`, `-g`, `-t`, `-n`, `-o`, `-l`, `-a` |
+| `activity` | 活跃统计 | 查询周期性活跃度图表 | `-u`, `-g`, `-d`, `-n`, `-o`, `-a` |
 | `wordcloud` | 生成词云 | 基于聊天记录生成词云图 | `-u`, `-g`, `-t` |
 | `simiactive`| 相似活跃分析 | 分析并找出与您作息相似的群友 | `-n`, `-p` |
 | `whoatme` | 谁提及我 | 查看最近谁提及了您 | (无) |
-| `analyse.view <time>`| 查询记录 | (管理) 查询指定时间点后的消息记录 | `-u`, `-g` |
+| `analyse.view <time>`| 查询记录 | (管理) 查询指定时间点之前的消息记录 | `-u`, `-g`, `-n` |
 | `analyse.list` | 列出数据 | (管理) 列出已记录的频道和命令 | (无) |
-| `analyse.backup` | 备份数据 | (管理) 将所有数据备份为本地 JSON 文件 | (无) |
-| `analyse.restore` | 恢复数据 | (管理) 从本地 JSON 文件恢复数据 | (无) |
+| `analyse.backup` | 备份数据 | (管理) 将所有数据备份为本地 JSON 文件 | `-a` |
+| `analyse.restore` | 恢复数据 | (管理) 从本地 JSON 文件恢复数据 | `-a` |
+| `analyse.archive [date]`| 手动归档 | (管理) 手动归档指定日期的原始消息记录 | (无) |
 | `analyse.clear` | 清除数据 | (管理) 根据条件精确清理数据 | `-t`, `-g`, `-u`, `-d`, `-c`, `-l`, `-a` |
 
 **通用选项说明:**
@@ -57,6 +58,7 @@
 `-u, --user <user>`: 指定用户 (可使用 @ 或 userID)。
 `-g, --guild <guild>`: 指定群组 (需使用群组ID)。
 `-a, --all`: 查询全局数据。
+`-l, --limit <count>`: 限制返回的条目数量。
 
 ### 🔎 指令详解
 
@@ -77,7 +79,7 @@
 **`msgstat -g <群组ID>`**: 查询**指定群组**的发言统计 (按**用户**展示)。
 **`msgstat -u @用户 -g <群组ID>`**: 查询**指定用户**在**指定群组**的发言统计 (按**消息类型**展示)。
 **`msgstat -a`**: 查询**全局**发言统计 (按**用户**展示)。
-**选项 `-t, --type <类型>`**: 筛选指定消息类型 (`text`, `face`, `image` 等)，不改变上述展示逻辑。
+**选项 `-t, --type <类型>`**: 筛选指定消息类型 (`text`, `face`, `img` 等)，不改变上述展示逻辑。
 **选项 `-s, --sortByTime`**: 按最后发言时间降序排序（默认按发言条数）。
 
 #### `rankstat` (发言排行)
@@ -88,7 +90,7 @@
 **`rankstat -a`**: 查询**全局**发言排行 (按**用户**排名)。
 **选项 `-n, --duration <小时数>`**: 指定查询范围的时长，默认为 `24`。
 **选项 `-o, --offset <小时数>`**: 指定查询结束时间的偏移量（从现在往前推的小时数），默认为 `0`。
-**选项 `-t, --type <类型>`...**: 筛选指定消息类型。
+**选项 `-t, --type <类型>`**: 筛选指定消息类型。
 
 #### `activity` (活跃统计)
 
@@ -118,7 +120,7 @@
 该指令用于高级数据管理，请谨慎使用。
 
 | 选项 | 别名 | 描述 |
-| :--| :--| :--|
+| :--- | :--- | :--- |
 | `--table <表名>` | `-t` | 指定要清除的表名 (如 `analyse_cmd`)。若不指定，则默认清理除 `analyse_user` 外的所有表。 |
 | `--guild <群组ID>` | `-g` | 仅清除指定群组的数据。 |
 | `--user <用户>` | `-u` | 仅清除指定用户的数据。 |
@@ -141,35 +143,34 @@
 `enableCmdStat`: **启用命令统计**。 (默认: `true`)
 `enableMsgStat`: **启用消息统计**。 (默认: `true`)
 `enableActivity`: **启用活跃统计**。 (默认: `true`)
+`enableSimiActivity`: **启用活跃比较**。(默认: `true`)
 `enableRankStat`: **启用发言排行**。 (默认: `true`)
-`rankRetentionDays`: **排行保留天数**。发言排行数据的保留时长（天），`0` 为永久保留。 (默认: `365`)
 `enableWhoAt`: **启用提及记录**。 (默认: `true`)
+`rankRetentionDays`: **排行保留天数**。发言排行数据的保留时长（天），`0` 为永久保留。 (默认: `365`)
 `atRetentionDays`: **提及保留天数**。`whoatme` 数据的保留时长（天），`0` 为永久保留。 (默认: `3`)
 
 ### 高级分析配置
 
 `enableOriRecord`: **启用原始记录**。是否记录原始消息内容。这是 `.view` 和 `wordcloud` 功能的基础。 (默认: `true`)
-`cacheRetentionDays`: **原始记录保留天数**。原始消息记录的保留时长（天），`0` 为永久保留。 (默认: `31`)
-`enableAutoBackup`: **启用自动备份记录**。是否开启每月自动备份原始消息记录。 (默认: `false`)
 `enableWordCloud`: **启用词云生成**。
-  > **!** 此功能依赖 **`启用原始记录`**。 (默认: `true`)
-`enableSimilarActivity`: **启用相似活跃分析**。
-  > **!** 此功能依赖 **`启用发言排行`** 或 **`启用活跃统计`**。 (默认: `true`)
+    > **!** 此功能依赖 **`启用原始记录`**。 (默认: `true`)
+`enableAutoBackup`: **启用自动归档**。每日自动将前一天的原始消息记录备份为 JSON 文件。 (默认: `true`)
+`cacheRetentionDays`: **记录保留天数**。原始消息记录在数据库中的保留时长（天），`0` 为永久保留。 (默认: `7`)
 
 ### 词云生成配置
 
 | 配置项 | 描述 | 默认值 |
 | :--- | :--- | :--- |
-| `color` | **词云颜色**：可设为 `random-light`、`random-dark`、CSS颜色值(如`#ff0000`)或一个返回颜色的JS函数。 | `random-light` |
-| `shape` | **词云形状**：预设值包括 `circle`, `cardioid`, `diamond`, `square`, `triangle`, `pentagon`, `star`。 | `square` |
-| `maskImage` | **蒙版图片**：提供一个图片的URL作为词云的形状蒙版。**注意：这会覆盖“词云形状”选项。** | (空) |
-| `fontFamily` | **词云字体**：用于渲染词云的字体列表。 | `"Noto Sans CJK SC", "Arial", sans-serif` |
+| `maxWords`| **最大词量**：词云显示的最多词汇数量。 | `1024` |
 | `ellipticity` | **长宽比**：形状的扁平程度(0-1)，仅对非方形形状有效。 | `1` |
+| `rotationSteps`| **旋转步数**：旋转角度的选择方式。0表示随机，2表示只在最小/最大角度中二选一。 | `3` |
 | `minRotation` | **最小旋转角**：单词随机旋转的最小角度(弧度)。 | `-1.570796` (-π/2) |
 | `maxRotation` | **最大旋转角**：单词随机旋转的最大角度(弧度)。 | `1.570796` (π/2) |
-| `rotationSteps`| **旋转步数**：旋转角度的选择方式。0表示随机，2表示只在最小/最大角度中二选一。 | `3` |
-| `maxWords`| **最大词量**：词云显示的最多词汇数量。 | `256` |
-| `excludeWords`| **屏蔽词**：以下词汇不会显示在词云中。 | 例：`词汇1,词汇2` |
+| `shape` | **词云形状**：预设值包括 `circle`, `cardioid`, `diamond`, `square`, `triangle`, `pentagon`, `star`。 | `square` |
+| `color` | **词云颜色**：可设为 `random-light`、`random-dark`、CSS颜色值(如`#ff0000`)或一个返回颜色的JS函数。 | `random-light` |
+| `fontFamily` | **词云字体**：用于渲染词云的字体列表。 | `"Noto Sans CJK SC", Arial, sans-serif` |
+| `maskImage` | **蒙版图片**：提供一个图片的URL作为词云的形状蒙版。**注意：这会覆盖“词云形状”选项。** | (空) |
+| `excludeWords`| **屏蔽词**：以下词汇不会显示在词云中，使用英文逗号分隔。 | (空) |
 
 ## 📌 注意事项