koishi-plugin-anime-schedule 1.1.0 → 1.1.2

package/lib/config.js

@@ -65,7 +65,7 @@ exports.Config = koishi_1.Schema.intersect([
     koishi_1.Schema.object({
         content: koishi_1.Schema.object({
             maxItems: koishi_1.Schema.number()
-                .min(0).step(10)
+                .min(0).step(1)
                 .description('单次推送最多显示多少部，0 不限制')
                 .default(0),
             longRunningThreshold: koishi_1.Schema.number()
@@ -117,7 +117,7 @@ exports.Config = koishi_1.Schema.intersect([
                 .default('localized'),
             scoreTtlHours: koishi_1.Schema.number()
                 .min(1).step(1)
-                .description('评分缓存小时数')
+                .description('评分多久后台补取一次（小时），到期不阻塞构建')
                 .default(constants_1.DEFAULT_SCORE_TTL_HOURS),
             cacheTtlDays: koishi_1.Schema.number()
                 .min(1).step(1)
@@ -171,7 +171,7 @@ exports.Config = koishi_1.Schema.intersect([
                 .description('请求失败重试次数')
                 .default(2),
             debug: koishi_1.Schema.boolean()
-                .description('输出调试日志')
+                .description('输出调试日志（逐部作品与每次请求的细节，构建结果与推送结果始终输出）')
                 .default(false),
         }),
     }).description('其他'),
@@ -193,6 +193,10 @@ function normalizeConfig(config) {
     const time = (value, fallback) => (typeof value === 'string' && TIME_PATTERN.test(value) ? value : fallback);
     // 旧版本的 `both` 形态已移除：非 `text` 一律按图片处理
     const format = config.output?.format === 'text' ? 'text' : 'image';
+    // 轮询间隔不能大于提前量：调度器每 poll 分钟检查一次 [now, now+lookahead] 窗口，
+    // 间隔更大时两次检查之间会留下覆盖不到的空档，场次静默漏发
+    const lookahead = int(config.push?.updateLookaheadMinutes, 30, 1);
+    const poll = int(config.push?.updatePollMinutes, 10, 1);
     return {
         ...config,
         timeZone: (0, time_1.resolveTimeZone)(config.timeZone, 'Asia/Shanghai'),
@@ -204,8 +208,8 @@ function normalizeConfig(config) {
             nightTime: time(config.push?.nightTime, '21:00'),
             weeklyTime: time(config.push?.weeklyTime, '08:00'),
             seasonTime: time(config.push?.seasonTime, '08:00'),
-            updateLookaheadMinutes: int(config.push?.updateLookaheadMinutes, 30, 1),
-            updatePollMinutes: int(config.push?.updatePollMinutes, 10, 1),
+            updateLookaheadMinutes: lookahead,
+            updatePollMinutes: Math.min(poll, lookahead),
         },
         content: {
             maxItems: int(config.content?.maxItems, 0),

package/lib/constants.d.ts

@@ -36,8 +36,13 @@ export declare const BANGUMI_DATA_FALLBACK_URLS: string[];
 export declare const BANGUMI_DATA_FILE = "bangumi-data.json";
 /** bangumi-data 回退缓存的目录（相对于 ctx.baseDir），与本地化缓存放在一起 */
 export declare const DATA_DIR: string[];
-/** 插件版本与主页，请求 Bangumi 时用于自报身份 */
-export declare const PLUGIN_VERSION = "1.0.0";
+/**
+ * 插件版本与主页，请求 Bangumi 时用于自报身份。
+ *
+ * 版本号从 `package.json` 读：单独维护一份字面量必然会在发版时漏更新（它曾停在 1.0.0），
+ * 而 `package.json` 一定随包发布，读它不会失效。
+ */
+export declare const PLUGIN_VERSION: string;
 export declare const PLUGIN_HOMEPAGE = "https://github.com/YuzuharaYuka/koishi-plugin-anime-schedule";
 /**
  * 请求 Bangumi 时使用的 User-Agent。
@@ -75,6 +80,9 @@ export declare const LOCALIZE_CACHE_FILE = "localize-cache.json";
  *
  * 比标题封面的 cacheTtlDays 短得多：新番开播头几周评分天天在变，样本量从个位数
  * 涨到几百，用 30 天缓存会一直显示「只有十几个人投票」时的噪声值。
+ *
+ * 到期只触发后台补取（`Localizer.kickScoreRefresh()`），不阻塞构建：评分是一张表的
+ * 附属信息，为它把整张表推迟十几秒不划算。
  */
 export declare const DEFAULT_SCORE_TTL_HOURS = 24;
 /**
@@ -112,6 +120,14 @@ export declare const COVER_MAX_BYTES: number;
 export declare const COVER_CACHE_DIR: string[];
 export declare const COVER_CACHE_TTL_MS: number;
 export declare const COVER_CACHE_MAX_FILES = 1200;
+/**
+ * 内存里保留的解码后封面总量上限（按 RGBA 字节算）。
+ *
+ * 单张 800px 的封面约 1.8MB，96MB 约合 50 张。插件是常驻进程，封面缓存若无上限会随
+ * 渲染过的作品数一路增长；这里只保证「短时间内重复出图不必重新解码」，
+ * 超出部分照常回落到磁盘缓存。
+ */
+export declare const COVER_MEMORY_MAX_BYTES: number;
 /** 图片渲染用的字体候选，按平台常见路径排列，找不到时回退到运行环境默认字体 */
 export declare const FONT_CANDIDATES: string[];
 /** 加粗字体候选，找不到时由绘制层用描边模拟粗体 */
@@ -143,6 +159,16 @@ export declare const MAX_SUPERSAMPLE = 5;
  */
 export declare const DAILY_OFFSET_MIN = -7;
 export declare const DAILY_OFFSET_MAX = 7;
+/**
+ * 构建结果的复用窗口（毫秒）。
+ *
+ * 推送遍历频道时每个群都调一次构建，指令层也常被连着问同一张表。这些调用的差别只有
+ * 「已订阅」标记，其余部分（场次推算、AniList 状态、Bangumi 详情、封面地址）完全相同，
+ * 因此一份结果在窗口内可以重复用，订阅标记事后再按频道注入。
+ */
+export declare const BUILD_CACHE_TTL_MS: number;
+/** 构建结果同时留存几份（日/深夜/周/季 × 少量偏移），超出丢最早的一份 */
+export declare const BUILD_CACHE_MAX_ENTRIES = 16;
 /** 注册到 canvas 的字体族名，与 config.render.fontFamily 的默认值保持一致 */
 export declare const DEFAULT_FONT_FAMILY = "Anime Schedule Sans";
 /**

package/lib/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LOG_MESSAGES = exports.RESPONSES = exports.MESSAGES = exports.IMAGE_THEME = exports.IMAGE_LAYOUT = exports.DEFAULT_FONT_FAMILY = exports.DAILY_OFFSET_MAX = exports.DAILY_OFFSET_MIN = exports.MAX_SUPERSAMPLE = exports.DEFAULT_SUPERSAMPLE = exports.DEFAULT_JPEG_QUALITY = exports.BOLD_FONT_CANDIDATES = exports.FONT_CANDIDATES = exports.COVER_CACHE_MAX_FILES = exports.COVER_CACHE_TTL_MS = exports.COVER_CACHE_DIR = exports.COVER_MAX_BYTES = exports.COVER_TIMEOUT_MS = exports.COVER_CONCURRENCY = exports.LOCALIZE_TIMEOUT_SECONDS = exports.LOCALIZE_CONCURRENCY = exports.EPISODE_QUERY_LIMIT = exports.LOCALIZE_CACHE_MAX_ENTRIES = exports.LOCALIZE_CACHE_VERSION = exports.MIN_SCORE_VOTES = exports.DEFAULT_SCORE_TTL_HOURS = exports.LOCALIZE_CACHE_FILE = exports.LATE_NIGHT_END_HOUR = exports.IMAGE_LIST_TWO_COLUMN_AT = exports.IMAGE_MAX_CARDS = exports.DIGEST_LABELS = exports.PLUGIN_HOMEPAGE = exports.PLUGIN_VERSION = exports.DATA_DIR = exports.BANGUMI_DATA_FILE = exports.BANGUMI_DATA_FALLBACK_URLS = exports.ANILIST_COOLDOWN_MS = exports.ANILIST_MIN_INTERVAL_MS = exports.ANILIST_BATCH_SIZE = exports.ANILIST_API_URL = exports.BANGUMI_API_HOST = exports.PLUGIN_NAME = void 0;
+exports.LOG_MESSAGES = exports.RESPONSES = exports.MESSAGES = exports.IMAGE_THEME = exports.IMAGE_LAYOUT = exports.DEFAULT_FONT_FAMILY = exports.BUILD_CACHE_MAX_ENTRIES = exports.BUILD_CACHE_TTL_MS = exports.DAILY_OFFSET_MAX = exports.DAILY_OFFSET_MIN = exports.MAX_SUPERSAMPLE = exports.DEFAULT_SUPERSAMPLE = exports.DEFAULT_JPEG_QUALITY = exports.BOLD_FONT_CANDIDATES = exports.FONT_CANDIDATES = exports.COVER_MEMORY_MAX_BYTES = exports.COVER_CACHE_MAX_FILES = exports.COVER_CACHE_TTL_MS = exports.COVER_CACHE_DIR = exports.COVER_MAX_BYTES = exports.COVER_TIMEOUT_MS = exports.COVER_CONCURRENCY = exports.LOCALIZE_TIMEOUT_SECONDS = exports.LOCALIZE_CONCURRENCY = exports.EPISODE_QUERY_LIMIT = exports.LOCALIZE_CACHE_MAX_ENTRIES = exports.LOCALIZE_CACHE_VERSION = exports.MIN_SCORE_VOTES = exports.DEFAULT_SCORE_TTL_HOURS = exports.LOCALIZE_CACHE_FILE = exports.LATE_NIGHT_END_HOUR = exports.IMAGE_LIST_TWO_COLUMN_AT = exports.IMAGE_MAX_CARDS = exports.DIGEST_LABELS = exports.PLUGIN_HOMEPAGE = exports.PLUGIN_VERSION = exports.DATA_DIR = exports.BANGUMI_DATA_FILE = exports.BANGUMI_DATA_FALLBACK_URLS = exports.ANILIST_COOLDOWN_MS = exports.ANILIST_MIN_INTERVAL_MS = exports.ANILIST_BATCH_SIZE = exports.ANILIST_API_URL = exports.BANGUMI_API_HOST = exports.PLUGIN_NAME = void 0;
 exports.buildUserAgent = buildUserAgent;
 exports.getMessages = getMessages;
 /** 插件名，同时作为日志前缀与 User-Agent 主体 */
@@ -44,8 +44,21 @@ exports.BANGUMI_DATA_FALLBACK_URLS = [
 exports.BANGUMI_DATA_FILE = 'bangumi-data.json';
 /** bangumi-data 回退缓存的目录（相对于 ctx.baseDir），与本地化缓存放在一起 */
 exports.DATA_DIR = ['data', 'anime-schedule'];
-/** 插件版本与主页，请求 Bangumi 时用于自报身份 */
-exports.PLUGIN_VERSION = '1.0.0';
+/**
+ * 插件版本与主页，请求 Bangumi 时用于自报身份。
+ *
+ * 版本号从 `package.json` 读：单独维护一份字面量必然会在发版时漏更新（它曾停在 1.0.0），
+ * 而 `package.json` 一定随包发布，读它不会失效。
+ */
+exports.PLUGIN_VERSION = (() => {
+    try {
+        const pkg = require('../package.json');
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+})();
 exports.PLUGIN_HOMEPAGE = 'https://github.com/YuzuharaYuka/koishi-plugin-anime-schedule';
 /**
  * 请求 Bangumi 时使用的 User-Agent。
@@ -91,6 +104,9 @@ exports.LOCALIZE_CACHE_FILE = 'localize-cache.json';
  *
  * 比标题封面的 cacheTtlDays 短得多：新番开播头几周评分天天在变，样本量从个位数
  * 涨到几百，用 30 天缓存会一直显示「只有十几个人投票」时的噪声值。
+ *
+ * 到期只触发后台补取（`Localizer.kickScoreRefresh()`），不阻塞构建：评分是一张表的
+ * 附属信息，为它把整张表推迟十几秒不划算。
  */
 exports.DEFAULT_SCORE_TTL_HOURS = 24;
 /**
@@ -128,6 +144,14 @@ exports.COVER_MAX_BYTES = 4 * 1024 * 1024;
 exports.COVER_CACHE_DIR = ['data', 'anime-schedule', 'covers'];
 exports.COVER_CACHE_TTL_MS = 21 * 24 * 60 * 60 * 1000;
 exports.COVER_CACHE_MAX_FILES = 1200;
+/**
+ * 内存里保留的解码后封面总量上限（按 RGBA 字节算）。
+ *
+ * 单张 800px 的封面约 1.8MB，96MB 约合 50 张。插件是常驻进程，封面缓存若无上限会随
+ * 渲染过的作品数一路增长；这里只保证「短时间内重复出图不必重新解码」，
+ * 超出部分照常回落到磁盘缓存。
+ */
+exports.COVER_MEMORY_MAX_BYTES = 96 * 1024 * 1024;
 /** 图片渲染用的字体候选，按平台常见路径排列，找不到时回退到运行环境默认字体 */
 exports.FONT_CANDIDATES = [
     'C:/Windows/Fonts/msyh.ttc',
@@ -180,6 +204,16 @@ exports.MAX_SUPERSAMPLE = 5;
  */
 exports.DAILY_OFFSET_MIN = -7;
 exports.DAILY_OFFSET_MAX = 7;
+/**
+ * 构建结果的复用窗口（毫秒）。
+ *
+ * 推送遍历频道时每个群都调一次构建，指令层也常被连着问同一张表。这些调用的差别只有
+ * 「已订阅」标记，其余部分（场次推算、AniList 状态、Bangumi 详情、封面地址）完全相同，
+ * 因此一份结果在窗口内可以重复用，订阅标记事后再按频道注入。
+ */
+exports.BUILD_CACHE_TTL_MS = 5 * 60 * 1000;
+/** 构建结果同时留存几份（日/深夜/周/季 × 少量偏移），超出丢最早的一份 */
+exports.BUILD_CACHE_MAX_ENTRIES = 16;
 /** 注册到 canvas 的字体族名，与 config.render.fontFamily 的默认值保持一致 */
 exports.DEFAULT_FONT_FAMILY = 'Anime Schedule Sans';
 /**

package/lib/data/bangumi-data.d.ts

@@ -61,6 +61,8 @@ export declare class BangumiDataIndex {
     private sourceLabel;
     private loaded;
     private loadPromise;
+    /** 检索用的折叠名缓存，见 `searchables()` */
+    private searchable;
     private readonly loader;
     /** 补充映射命中的条数，用于日志 */
     private mappedCount;
@@ -100,18 +102,24 @@ export declare class BangumiDataIndex {
     /** 按 Bangumi 条目 ID 取索引条目 */
     bySubjectId(id: number): IndexEntry | null;
     /**
-     * 按关键词检索索引层。打分规则（高到低）：完整标题完全相等（折叠后）→ 标题以关键词开头 →
-     * 标题包含关键词 → 关键词的每个字符都按顺序出现在标题里（子序列，用于容忍译名与原文的
-     * 字序差异）。除完全相等外，越短的标题得分越高。
-     */
-    /**
-     * 按标题检索，按相关度降序返回。
+     * 按关键词检索索引层。
+     *
+     * 打分规则（高到低）：完整标题完全相等（折叠后）→ 标题以关键词开头 → 标题包含关键词 →
+     * 关键词的每个字符都按顺序出现在标题里（子序列，用于容忍译名与原文的字序差异）。
+     * 除完全相等外，越短的标题得分越高。
      *
      * @param limit 返回条数上限，`<= 0` 表示不限制
      */
     search(keyword: string, limit?: number): IndexEntry[];
     /** 一条作品的全部可检索名称 */
     private namesOf;
+    /**
+     * 检索用的「折叠名」列表，首次检索时构建一次。
+     *
+     * `foldTitle` 要做字符映射、NFKC、大小写与两条 Unicode 正则，八个字的名字约 10µs；
+     * 全库两万多个名字每个字都重算一遍是 130ms 级——而索引在进程内不变，折叠结果也不变。
+     */
+    private searchables;
     /** 把原始清单展开成索引条目 */
     private apply;
 }

package/lib/data/bangumi-data.js

@@ -24,6 +24,8 @@ class BangumiDataIndex {
     sourceLabel = '';
     loaded = false;
     loadPromise = null;
+    /** 检索用的折叠名缓存，见 `searchables()` */
+    searchable = null;
     loader;
     /** 补充映射命中的条数，用于日志 */
     mappedCount = 0;
@@ -75,7 +77,7 @@ class BangumiDataIndex {
             const withBroadcast = this.entries.filter((entry) => entry.broadcastMs !== null).length;
             const withId = this.entries.filter((entry) => entry.bangumiId !== null).length;
             const translated = this.entries.filter((entry) => entry.zhHans).length;
-            this.logger.info('[index] bangumi-data 已载入 %d 部作品 (来源: %s)', this.entries.length, this.sourceLabel);
+            this.logger.info('[index] bangumi-data 已载入 %d 部作品（来源: %s）', this.entries.length, this.sourceLabel);
             (0, utils_1.debugLog)('[index] 载入耗时 %dms | 带周期时刻 %d | 带 Bangumi 条目 ID %d | 带简中译名 %d', Date.now() - started, withBroadcast, withId, translated);
         })();
         // 载入失败时清掉缓存，下一次调用可以重试，而不是一直拿到同一个被拒绝的 Promise
@@ -91,11 +93,10 @@ class BangumiDataIndex {
      * 9 月 26 日首播的 10 月番因此留在 10 月季。
      */
     seasonWindow(year, month) {
-        // 起点在上一个月的 20 日之后：1 月季从去年 12/21 开始
-        const startMs = month === 1 ? Date.UTC(year - 1, 11, 21) : Date.UTC(year, month - 2, 21);
-        // 终点在本季末月的 20 日之后。注意 `Date.UTC` 的月份下标比自然月小 1：
-        // 起始月 M 的末月是 M+2，对应下标 M+1（10 月季用 11 表示 12 月）
-        const endMs = month === 10 ? Date.UTC(year, 11, 21) : Date.UTC(year, month + 1, 21);
+        // `Date.UTC` 的月份允许越界并自动换算：1 月季的 `month - 2 = -1` 就是上一年的 12 月，
+        // 10 月季的 `month + 1 = 11` 就是 12 月。因此首尾两端都不需要单独判断月份
+        const startMs = Date.UTC(year, month - 2, 21);
+        const endMs = Date.UTC(year, month + 1, 21);
         return { startMs, endMs };
     }
     /** 取某个季度的清单；`month` 为该季起始月（1 / 4 / 7 / 10），窗口见 `seasonWindow` */
@@ -111,7 +112,7 @@ class BangumiDataIndex {
                 return false;
             return entry.beginMs >= startMs && entry.beginMs < endMs;
         });
-        (0, utils_1.debugLog)('[index] 季度 %d-%d: %d 部 (仅 TV / WEB，首播 %s ~ %s)', year, month, list.length, new Date(startMs).toISOString().slice(0, 10), new Date(endMs - 86400000).toISOString().slice(0, 10));
+        (0, utils_1.debugLog)('[index] 季度 %d-%d: %d 部（仅 TV / WEB，首播 %s ~ %s）', year, month, list.length, new Date(startMs).toISOString().slice(0, 10), new Date(endMs - 86400000).toISOString().slice(0, 10));
         return list;
     }
     /**
@@ -156,12 +157,11 @@ class BangumiDataIndex {
         return this.entryBySubject.get(id) ?? null;
     }
     /**
-     * 按关键词检索索引层。打分规则（高到低）：完整标题完全相等（折叠后）→ 标题以关键词开头 →
-     * 标题包含关键词 → 关键词的每个字符都按顺序出现在标题里（子序列，用于容忍译名与原文的
-     * 字序差异）。除完全相等外，越短的标题得分越高。
-     */
-    /**
-     * 按标题检索，按相关度降序返回。
+     * 按关键词检索索引层。
+     *
+     * 打分规则（高到低）：完整标题完全相等（折叠后）→ 标题以关键词开头 → 标题包含关键词 →
+     * 关键词的每个字符都按顺序出现在标题里（子序列，用于容忍译名与原文的字序差异）。
+     * 除完全相等外，越短的标题得分越高。
      *
      * @param limit 返回条数上限，`<= 0` 表示不限制
      */
@@ -171,12 +171,9 @@ class BangumiDataIndex {
             return [];
         const chars = [...folded];
         const scored = [];
-        for (const entry of this.entries) {
+        for (const { entry, names } of this.searchables()) {
             let best = 0;
-            for (const name of this.namesOf(entry)) {
-                const value = (0, fold_1.foldTitle)(name);
-                if (!value)
-                    continue;
+            for (const value of names) {
                 let score = 0;
                 if (value === folded)
                     score = 1000;
@@ -203,9 +200,26 @@ class BangumiDataIndex {
     namesOf(entry) {
         return [entry.title, entry.zhHans, entry.zhHant, entry.en].filter(Boolean);
     }
+    /**
+     * 检索用的「折叠名」列表，首次检索时构建一次。
+     *
+     * `foldTitle` 要做字符映射、NFKC、大小写与两条 Unicode 正则，八个字的名字约 10µs；
+     * 全库两万多个名字每个字都重算一遍是 130ms 级——而索引在进程内不变，折叠结果也不变。
+     */
+    searchables() {
+        if (!this.searchable) {
+            this.searchable = this.entries.map((entry) => ({
+                entry,
+                names: this.namesOf(entry).map(fold_1.foldTitle).filter(Boolean),
+            }));
+        }
+        return this.searchable;
+    }
     /** 把原始清单展开成索引条目 */
     apply(items, source) {
         this.sourceLabel = source;
+        // 条目换了，折叠名缓存必须作废
+        this.searchable = null;
         const entries = [];
         const sourceCount = { top: 0, site: 0, none: 0 };
         let recurringCount = 0;

package/lib/handlers.d.ts

@@ -2,7 +2,7 @@ import { Context, h, Logger, Session } from 'koishi';
 import type { Config } from './config';
 import type { DigestService } from './services/digest';
 import { type InfoService } from './services/info';
-import type { Renderer } from './render/image';
+import { type Renderer } from './render/image';
 /** 指令层依赖集合 */
 export interface HandlerContext {
     ctx: Context;

package/lib/handlers.js

@@ -19,6 +19,7 @@ const koishi_1 = require("koishi");
 const constants_1 = require("./constants");
 const info_1 = require("./services/info");
 const dispatch_1 = require("./services/dispatch");
+const image_1 = require("./render/image");
 const text_1 = require("./render/text");
 const time_1 = require("./utils/time");
 const utils_1 = require("./utils");
@@ -91,27 +92,20 @@ function platformOf(session) {
 /** 构建一次推送内容并回复当前会话 */
 async function replyDigest(deps, session, digest) {
     const { config, renderer, logger } = deps;
+    // 内容已经拿到手，评分过期的条目趁出图这段时间在后台补，不占用这次指令的等待
+    deps.digest.localizer.kickScoreRefresh();
     if (!digest.groups.length) {
         await session.send([digest.header, digest.summary].filter(Boolean).join('\n'));
         return;
     }
     if (config.output.format === 'image') {
         try {
-            const buffer = await renderer.render({
-                kind: digest.kind,
-                now: digest.generatedAt,
-                header: digest.header,
-                summary: digest.summary,
-                groups: digest.groups,
-                seasonLabel: digest.seasonLabel,
-                rangeLabel: digest.rangeLabel ?? '',
-                footer: (0, constants_1.getMessages)(config.locale).footer,
-            });
+            const buffer = await renderer.render((0, image_1.toRenderPayload)(digest, (0, constants_1.getMessages)(config.locale)));
             await session.send(koishi_1.h.image(buffer, 'image/jpeg'));
             return;
         }
         catch (error) {
-            logger.warn('[command] %s', constants_1.RESPONSES.renderFailed, error);
+            logger.warn('[command] 出图失败，改用文本发送:', error);
         }
     }
     const content = await (0, dispatch_1.sendTextDigest)(session.bot, session.guildId ?? '', config, digest);
@@ -152,7 +146,8 @@ async function commandSeason(deps, session, target, offsetOption) {
     const parsed = parseSeasonTarget(target, digest.timeZone);
     if (parsed.error)
         return parsed.error;
-    const offset = offsetOption ?? parsed.offset;
+    // `-o` 走 Koishi 的 number 域，`1.5` 也能进来；季度偏移必须是整数，否则会算出「2.5 月新番」
+    const offset = offsetOption === undefined ? parsed.offset : Math.trunc(offsetOption);
     if (offset !== undefined && (offset > SEASON_FUTURE_LIMIT || offset < -40)) {
         return offset > 0
             ? `最多往后查 ${SEASON_FUTURE_LIMIT} 季——更远的季度还没公布。`
@@ -558,7 +553,8 @@ async function togglePush(deps, session, kindText, enabled) {
     if (raw && !kind)
         return constants_1.RESPONSES.invalidKind(kindText ?? '');
     try {
-        // 只在首次为本群建记录时写入默认开关，避免 upsert 把已有的开关重置回默认值
+        // 首次为本群建记录时，四种推送一律先关：`anime.on weekly` 只该开本周表，
+        // 若默认给 `true`，新群里执行一次 `anime.off weekly` 反而会静默打开另外三种
         const existing = await digest.getChannel(platformOf(session), channelOf(session));
         if (!existing) {
             await digest.ensureChannel({
@@ -566,10 +562,10 @@ async function togglePush(deps, session, kindText, enabled) {
                 channelId: channelOf(session),
                 guildId: session.guildId,
                 botId: session.selfId,
-                dailyEnabled: true,
-                nightEnabled: true,
-                weeklyEnabled: true,
-                seasonEnabled: true,
+                dailyEnabled: false,
+                nightEnabled: false,
+                weeklyEnabled: false,
+                seasonEnabled: false,
                 enabled: true,
             });
         }
@@ -600,7 +596,7 @@ async function commandStatus(deps, session) {
             platform: platformOf(session),
             channelId: channelOf(session),
         });
-        const date = (0, time_1.today)(digest.timeZone);
+        const dayStart = (0, time_1.getDayStartMs)((0, time_1.today)(digest.timeZone), digest.timeZone);
         const formatText = config.output.format === 'image'
             ? `图片 (${config.output.layout === 'list' ? '卡片列表' : '时间表'})`
             : `纯文本${config.output.useForward ? ' (合并转发)' : ''}`;
@@ -614,7 +610,8 @@ async function commandStatus(deps, session) {
             `开关状态: 每日 ${channel?.dailyEnabled ? '开' : '关'} / 深夜档 ${channel?.nightEnabled ? '开' : '关'} / 本周 ${channel?.weeklyEnabled ? '开' : '关'} / 本季 ${channel?.seasonEnabled ? '开' : '关'}`,
             `订阅番剧: ${subscriptions.length} 部${config.subscription.maxPerChannel > 0 ? ` (上限 ${config.subscription.maxPerChannel})` : ''}`,
             `开播提醒: ${config.push.updateReminderEnabled ? `开，提前 ${config.push.updateLookaheadMinutes} 分钟` : '关'}`,
-            `今日推送记录: ${dispatches.filter((row) => row.digestKind !== 'sub' ? row.dedupeKey.endsWith(date) : true).length} 条`,
+            // 按记录时间统计：`sub`（开播提醒）的去重键里带的是时刻而不是日期，不能靠键判断
+            `今日推送记录: ${dispatches.filter((row) => row.dispatchedAt >= dayStart && row.dispatchedAt < dayStart + 86400000).length} 条`,
         ].join('\n');
     }
     catch (error) {

package/lib/index.js

@@ -91,9 +91,8 @@ function apply(ctx, rawConfig) {
     }, { autoInc: true });
     // 调试日志开关：打开后输出 API 请求、索引命中与条目匹配细节
     (0, utils_1.setupDebug)(config.advanced.debug, logger);
-    if (config.advanced.debug) {
-        logger.info('[debug] 调试日志已开启，将输出请求 URL、索引命中与条目匹配细节');
-    }
+    if (config.advanced.debug)
+        logger.info('[lifecycle] 调试日志已开启，logger 级别已提到 debug');
     // 出网客户端：Bangumi 接口与图床在国内无法直连，代理在这里统一生效
     const http = new network_1.HttpClient(ctx, logger, config.advanced.retries);
     // bangumi-data 索引层：作品清单、中文译名、Bangumi 条目 ID 与周期时刻都来自这里
@@ -111,16 +110,7 @@ function apply(ctx, rawConfig) {
     const airingReady = airing.ensure();
     // 免去「未处理的 Promise 拒绝」告警，真实错误在 ready 与构建路径里各自上报
     Promise.all([indexReady, localizeReady, airingReady]).catch(() => undefined);
-    const dispatcher = new dispatch_1.Dispatcher(ctx, config, logger, (payload) => renderer.render({
-        kind: payload.kind,
-        now: payload.generatedAt,
-        header: payload.header,
-        summary: payload.summary,
-        groups: payload.groups,
-        seasonLabel: payload.seasonLabel,
-        rangeLabel: payload.rangeLabel ?? '',
-        footer: (0, constants_1.getMessages)(config.locale).footer,
-    }));
+    const dispatcher = new dispatch_1.Dispatcher(ctx, config, logger, (payload) => renderer.render((0, image_1.toRenderPayload)(payload, (0, constants_1.getMessages)(config.locale))));
     const scheduler = new scheduler_1.Scheduler(ctx, config, logger, digest, dispatcher, guard, async () => {
         await digest.localizer.save();
         // 顺手把已完结的订阅清掉；`pruneFinishedSubscriptions` 自己按天去重
@@ -144,11 +134,10 @@ function apply(ctx, rawConfig) {
             else
                 logger.info('[lifecycle] 所有定时推送均已关闭，调度未启动');
             logger.info('[lifecycle] %s 已启用 (时区: %s，推送形态: %s，本地化: %s，索引: %s)', exports.name, config.timeZone, config.output.format, config.localize.enabled ? '开' : '关', index.ready ? `${index.size} 部 (${index.source})` : '不可用');
-            logger.info('[lifecycle] 时间表内的时刻均按 %s 显示 (UTC%s)', config.timeZone, formatOffset(config.timeZone));
+            logger.info('[lifecycle] 时刻按 %s 显示（UTC%s）', config.timeZone, formatOffset(config.timeZone));
         }
         catch (error) {
-            logger.error('[lifecycle] 插件初始化失败，定时推送将不可用:', error);
-            logger.error('[lifecycle] 请检查日志并报告问题到: https://github.com/YuzuharaYuka/koishi-plugin-anime-schedule/issues');
+            logger.error('[lifecycle] 插件初始化失败，定时推送将不可用（问题反馈见 readme）。原因:', error);
         }
     });
     ctx.on('dispose', async () => {
@@ -215,7 +204,9 @@ function registerCommands(ctx, deps) {
         .action(async ({ session, options }, target) => {
         if (!session)
             return;
-        await (0, handlers_1.commandSeason)(deps, session, target, options?.offset);
+        // 必须 return：参数非法时 `commandSeason` 只返回错误文案而自己不发送，
+        // 吞掉返回值就会表现成「机器人没反应」
+        return (0, handlers_1.commandSeason)(deps, session, target, options?.offset);
     });
     cmd.subcommand('.search <keyword:text>', '搜索番剧作品')
         .alias('番剧搜索', '搜索新番', '番剧查找')

package/lib/render/covers.d.ts

@@ -9,7 +9,13 @@ export declare class CoverStore {
     private cacheDays;
     /** 出网客户端（含代理） */
     private http;
+    /**
+     * 内存缓存。值只能是解码成功的画布——下载或解码失败的结果**不入缓存**，
+     * 否则一次瞬时超时会让这张封面在进程重启前一直显示占位块。
+     */
     private readonly memory;
+    /** `memory` 中画布占用的字节数，用于淘汰 */
+    private memoryBytes;
     private readonly inflight;
     private readonly cacheRoot;
     private cacheReady;
@@ -25,6 +31,13 @@ export declare class CoverStore {
     load(items: CoverRequest[], limit: number): Promise<Map<string, Canvas | null>>;
     /** 单个封面：内存缓存 → 磁盘缓存 → 网络 */
     private loadOne;
+    /**
+     * 记入内存缓存，超出总量上限时淘汰最久未使用的。
+     *
+     * 按字节而不是按张数：封面尺寸差距很大（150px 的缩略图与 800px 的原图差 20 倍），
+     * 按张数算会让上限形同虚设。
+     */
+    private remember;
     private fetchAndDecode;
     private download;
     private filePath;