koishi-plugin-anime-schedule 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 YuzuharaYuka
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/lib/config.d.ts

@@ -0,0 +1,64 @@
+import { Schema } from 'koishi';
+import type { DigestFormat, ImageLayout, PluginLocale, TimeZone, TitleStyle } from './types';
+export interface Config {
+    timeZone: TimeZone;
+    locale: PluginLocale;
+    push: {
+        dailyEnabled: boolean;
+        dailyTime: string;
+        dailyOffsetDays: number;
+        nightEnabled: boolean;
+        nightTime: string;
+        weeklyEnabled: boolean;
+        weeklyWeekday: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+        weeklyTime: string;
+        seasonEnabled: boolean;
+        seasonTime: string;
+        updateReminderEnabled: boolean;
+        updateLookaheadMinutes: number;
+        updatePollMinutes: number;
+    };
+    content: {
+        /** 单次推送最多展示的作品数，0 表示不限制 */
+        maxItems: number;
+        /** 超长期连载番的话数阈值，0 表示不过滤 */
+        longRunningThreshold: number;
+    };
+    output: {
+        format: DigestFormat;
+        layout: ImageLayout;
+        coverLimit: number;
+        showCover: boolean;
+        showScore: boolean;
+        useForward: boolean;
+    };
+    localize: {
+        enabled: boolean;
+        titleStyle: TitleStyle;
+        cacheTtlDays: number;
+        /** 播出状态（是否已完结）的缓存有效期，单位小时 */
+        airingTtlHours: number;
+    };
+    render: {
+        fontFamily: string;
+        coverConcurrency: number;
+        coverCacheDays: number;
+        /** JPEG 编码质量（0-100）。图片以文字与线条为主，压缩伪影很明显，因此默认取高值 */
+        jpegQuality: number;
+    };
+    subscription: {
+        /** 单个群最多订阅的番剧数量，0 表示不限制 */
+        maxPerChannel: number;
+    };
+    advanced: {
+        requestTimeout: number;
+        retries: number;
+        debug: boolean;
+    };
+}
+export declare const Config: Schema<Config>;
+/**
+ * 把配置夹到安全区间。
+ * 只保证「类型正确」与「不小于最小值」，不设人为上限。
+ */
+export declare function normalizeConfig(config: Config): Config;

package/lib/config.js

@@ -0,0 +1,222 @@
+import { Schema } from 'koishi';
+import { COVER_CONCURRENCY, DEFAULT_FONT_FAMILY, DEFAULT_JPEG_QUALITY } from './constants';
+import { resolveTimeZone } from './utils/time';
+const TIME_PATTERN = /^([01]\d|2[0-3]):[0-5]\d$/;
+const WEEKDAYS = [
+    { value: 0, label: '周日' },
+    { value: 1, label: '周一' },
+    { value: 2, label: '周二' },
+    { value: 3, label: '周三' },
+    { value: 4, label: '周四' },
+    { value: 5, label: '周五' },
+    { value: 6, label: '周六' },
+];
+export const Config = Schema.intersect([
+    Schema.object({
+        timeZone: Schema.union([
+            Schema.const('Asia/Shanghai').description('Asia/Shanghai (UTC+8)'),
+            Schema.const('Asia/Tokyo').description('Asia/Tokyo (UTC+9)'),
+            Schema.const('Asia/Hong_Kong').description('Asia/Hong_Kong (UTC+8)'),
+            Schema.const('Asia/Taipei').description('Asia/Taipei (UTC+8)'),
+            Schema.const('UTC').description('UTC'),
+        ])
+            .description('时刻与日期按此时区换算')
+            .default('Asia/Shanghai'),
+        locale: Schema.union([
+            Schema.const('zh-CN').description('简体中文'),
+            Schema.const('ja-JP').description('日本語'),
+            Schema.const('en-US').description('English'),
+        ])
+            .description('界面语言')
+            .default('zh-CN'),
+    }),
+    Schema.object({
+        push: Schema.object({
+            dailyEnabled: Schema.boolean().description('每日更新表').default(true),
+            dailyTime: Schema.string().pattern(TIME_PATTERN).description('推送时刻').default('08:00'),
+            dailyOffsetDays: Schema.number()
+                .min(-1).max(1).step(1)
+                .description('日期偏移：0 当天，-1 前一天，1 后一天')
+                .default(0),
+            nightEnabled: Schema.boolean().description('深夜档（当晚 21:00 至次日 06:00）').default(true),
+            nightTime: Schema.string().pattern(TIME_PATTERN).description('推送时刻').default('21:00'),
+            weeklyEnabled: Schema.boolean().description('本周更新表').default(true),
+            weeklyWeekday: Schema.union(WEEKDAYS.map((item) => Schema.const(item.value).description(item.label)))
+                .description('周表的推送星期')
+                .default(1),
+            weeklyTime: Schema.string().pattern(TIME_PATTERN).description('推送时刻').default('08:00'),
+            seasonEnabled: Schema.boolean().description('本季新番表').default(true),
+            seasonTime: Schema.string().pattern(TIME_PATTERN).description('季度首日的推送时刻').default('08:00'),
+            updateReminderEnabled: Schema.boolean().description('订阅作品的开播提醒').default(true),
+            updateLookaheadMinutes: Schema.number()
+                .min(1).step(1)
+                .description('提前多少分钟提醒')
+                .default(30),
+            updatePollMinutes: Schema.number()
+                .min(1).step(1)
+                .description('检查间隔（分钟）')
+                .default(10),
+        }),
+    }).description('推送设置'),
+    Schema.object({
+        content: Schema.object({
+            maxItems: Schema.number()
+                .min(0).step(10)
+                .description('单次推送最多显示多少部，0 为不限制')
+                .default(0),
+            longRunningThreshold: Schema.number()
+                .min(0).step(1)
+                .description('剔除长期连载番的话数阈值，0 为不过滤')
+                .default(0),
+        }),
+    }).description('推送内容'),
+    Schema.object({
+        output: Schema.object({
+            format: Schema.union([
+                Schema.const('image').description('风格化图片'),
+                Schema.const('text').description('纯文本'),
+            ])
+                .description('推送形态；图片渲染失败时自动改用文本')
+                .default('image'),
+            layout: Schema.union([
+                Schema.const('table').description('时间表'),
+                Schema.const('list').description('卡片列表'),
+            ])
+                .description('图片排版')
+                .default('table'),
+            coverLimit: Schema.number()
+                .min(0)
+                .description('单张图片最多加载多少张封面，0 为不限制')
+                .default(0),
+            showCover: Schema.boolean().description('显示封面').default(true),
+            showScore: Schema.boolean().description('显示评分').default(true),
+            useForward: Schema.boolean()
+                .description('纯文本模式使用合并转发，避免刷屏')
+                .default(true),
+        }),
+    }).description('输出设置'),
+    Schema.object({
+        localize: Schema.object({
+            enabled: Schema.boolean()
+                .description('使用中文标题与评分')
+                .default(true),
+            titleStyle: Schema.union([
+                Schema.const('localized').description('仅中文'),
+                Schema.const('both').description('中文（日文原名）'),
+                Schema.const('original').description('仅日文原名'),
+            ])
+                .description('标题展示方式')
+                .default('localized'),
+            cacheTtlDays: Schema.number()
+                .min(1).step(1)
+                .description('标题、封面与评分的缓存天数')
+                .default(30),
+            airingTtlHours: Schema.number()
+                .min(1).step(1)
+                .description('播出状态（是否已播完）的缓存小时数')
+                .default(6),
+        }),
+    }).description('本地化'),
+    Schema.object({
+        render: Schema.object({
+            fontFamily: Schema.string()
+                .description('绘制图片时使用的字体族；留空则自动寻找系统中文字体')
+                .default(DEFAULT_FONT_FAMILY),
+            coverConcurrency: Schema.number()
+                .min(1)
+                .description('封面下载并发数')
+                .default(COVER_CONCURRENCY),
+            coverCacheDays: Schema.number()
+                .min(0)
+                .description('封面缓存天数，0 为不写磁盘')
+                .default(21),
+            jpegQuality: Schema.number()
+                .min(1).max(100).step(1)
+                .description('图片编码质量')
+                .default(DEFAULT_JPEG_QUALITY),
+        }),
+    }).description('图片'),
+    Schema.object({
+        subscription: Schema.object({
+            maxPerChannel: Schema.number()
+                .min(0).step(1)
+                .description('单个群最多订阅多少部，0 为不限制')
+                .default(0),
+        }),
+    }).description('订阅'),
+    Schema.object({
+        advanced: Schema.object({
+            requestTimeout: Schema.number()
+                .min(1)
+                .description('单次请求超时（秒）')
+                .default(20),
+            retries: Schema.number()
+                .min(0)
+                .description('请求失败重试次数')
+                .default(2),
+            debug: Schema.boolean()
+                .description('输出调试日志')
+                .default(false),
+        }),
+    }).description('其他'),
+]);
+/**
+ * 把配置夹到安全区间。
+ * 只保证「类型正确」与「不小于最小值」，不设人为上限。
+ */
+export function normalizeConfig(config) {
+    const int = (value, fallback, min = 0) => {
+        if (typeof value !== 'number' || !Number.isFinite(value))
+            return fallback;
+        return Math.max(min, Math.round(value));
+    };
+    const time = (value, fallback) => (typeof value === 'string' && TIME_PATTERN.test(value) ? value : fallback);
+    // 旧版本存在 `both` 形态，已移除，统一按图片处理
+    const format = config.output?.format === 'text' ? 'text' : 'image';
+    return {
+        ...config,
+        timeZone: resolveTimeZone(config.timeZone, 'Asia/Shanghai'),
+        push: {
+            ...config.push,
+            dailyTime: time(config.push?.dailyTime, '08:00'),
+            dailyOffsetDays: Math.max(-1, Math.min(1, int(config.push?.dailyOffsetDays, 0))),
+            weeklyWeekday: Math.max(0, Math.min(6, int(config.push?.weeklyWeekday, 1))),
+            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),
+        },
+        content: {
+            maxItems: int(config.content?.maxItems, 0),
+            longRunningThreshold: int(config.content?.longRunningThreshold, 0),
+        },
+        output: {
+            ...config.output,
+            format,
+            layout: config.output?.layout === 'list' ? 'list' : 'table',
+            coverLimit: int(config.output?.coverLimit, 0),
+        },
+        localize: {
+            ...config.localize,
+            cacheTtlDays: int(config.localize?.cacheTtlDays, 30, 1),
+            airingTtlHours: int(config.localize?.airingTtlHours, 6, 1),
+        },
+        render: {
+            ...config.render,
+            fontFamily: config.render?.fontFamily?.trim() || DEFAULT_FONT_FAMILY,
+            coverConcurrency: int(config.render?.coverConcurrency, COVER_CONCURRENCY, 1),
+            coverCacheDays: int(config.render?.coverCacheDays, 21),
+            jpegQuality: Math.min(100, int(config.render?.jpegQuality, DEFAULT_JPEG_QUALITY, 1)),
+        },
+        subscription: {
+            ...config.subscription,
+            maxPerChannel: int(config.subscription?.maxPerChannel, 0),
+        },
+        advanced: {
+            ...config.advanced,
+            requestTimeout: int(config.advanced?.requestTimeout, 20, 1),
+            retries: int(config.advanced?.retries, 2),
+        },
+    };
+}

package/lib/constants.d.ts

@@ -0,0 +1,270 @@
+import type { DigestKind, PluginLocale } from './types';
+/** 插件名，同时作为日志前缀与 User-Agent 主体 */
+export declare const PLUGIN_NAME = "anime-schedule";
+/** Bangumi API 主机 */
+export declare const BANGUMI_API_HOST = "https://api.bgm.tv";
+/**
+ * AniList GraphQL 接口。
+ *
+ * 用于查询「这部番是否还在播」：它直接给出 `status`（FINISHED / RELEASING）与 `endDate`，
+ * 而 bangumi-data 自带 `aniList` 的条目 ID，可以按 ID 精确查询、避开标题匹配歧义。
+ */
+export declare const ANILIST_API_URL = "https://graphql.anilist.co";
+/** 单次 GraphQL 请求最多查多少个条目 */
+export declare const ANILIST_BATCH_SIZE = 50;
+/**
+ * 两次 AniList 请求之间的最小间隔（毫秒）。
+ *
+ * 官方限制 90 次/分钟（实测响应头为 30），另有突发限流。留出 1.2 秒间隔后
+ * 相当于最多 50 次/分钟，既不会触发突发限流，也远低于上限。
+ */
+export declare const ANILIST_MIN_INTERVAL_MS = 1200;
+/**
+ * bangumi-data 索引。
+ *
+ * 数据默认来自 npm 依赖包 `bangumi-data`（`main` 指向 `dist/data.json`），
+ * 随插件一起安装、无需联网；下面这些地址只在依赖包缺失时才作为回退。
+ * 仓库: https://github.com/bangumi-data/bangumi-data
+ */
+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";
+export declare const PLUGIN_HOMEPAGE = "https://github.com/YuzuharaYuka/koishi-plugin-anime-schedule";
+/**
+ * 请求 Bangumi 时使用的 User-Agent。
+ * Bangumi 要求客户端自报身份，形如 `AppName/version (+主页)`。
+ */
+export declare function buildUserAgent(): string;
+/** 各类推送的展示名，用于日志、合并转发标题与开关回复 */
+export declare const DIGEST_LABELS: Record<DigestKind, string>;
+/** 卡片列表排版绘制的卡片数上限，避免条目异常多时图片长度失控 */
+export declare const IMAGE_MAX_CARDS = 200;
+/** 列表排版超过这个数量就折成两栏，避免长图过长 */
+export declare const IMAGE_LIST_TWO_COLUMN_AT = 26;
+/**
+ * 「深夜番」的判定：本地时间 0 点到 6 点算作前一日的深夜档。
+ *
+ * 与 `DigestService` 的深夜档窗口终点（次日 06:00）保持一致——两处都表示「凌晨这一段的结束时刻」，
+ * 改一处时另一处也要跟着改。这里的用途是统计与文案（`finish()` 里的「其中 N 部为深夜档」、
+ * 时间轴的 24 小时制续写），不是窗口本身。
+ */
+export declare const LATE_NIGHT_END_HOUR = 6;
+/** 本地化缓存的落盘文件名 */
+export declare const LOCALIZE_CACHE_FILE = "localize-cache.json";
+/**
+ * 本地化缓存的结构版本。
+ *
+ * 条目字段变化时必须递增：版本不匹配会整份重建，避免旧条目缺少新字段
+ * （例如判断完结所需的 `lastAirDate`）导致逻辑静默失效。
+ *
+ * v2：新增 `totalEpisodes` 与 `airDate`；旧缓存缺这两个字段，不丢弃会一直重复请求。
+ * v6：新增 `hasEpisodeTimes`。逐集档期不再是每条必取，需要靠它区分
+ *     「没取过逐集档期」与「取过但没有集数日期」。
+ */
+export declare const LOCALIZE_CACHE_VERSION = 6;
+/** 本地化缓存最大条目数，超出后按写入时间淘汰最旧的一半 */
+export declare const LOCALIZE_CACHE_MAX_ENTRIES = 5000;
+/** 取逐集档期时的单页集数上限；超过这个数的长期番不靠集数判断完结 */
+export declare const EPISODE_QUERY_LIMIT = 100;
+/**
+ * 并发检索 Bangumi 的条数上限。
+ * Bangumi 没有公开的严格限流，但一次本季表可能有上百部作品，
+ * 4 路并发已能把原本串行的等待时间压到 1/4，同时不至于触发风控。
+ */
+export declare const LOCALIZE_CONCURRENCY = 4;
+/** 并发拉取封面时的并发上限 */
+export declare const COVER_CONCURRENCY = 8;
+/** 封面下载超时与体积上限，避免个别大图拖垮整次渲染 */
+export declare const COVER_TIMEOUT_MS = 8000;
+export declare const COVER_MAX_BYTES: number;
+/** 封面磁盘缓存目录（相对于 ctx.baseDir）与有效期 */
+export declare const COVER_CACHE_DIR: string[];
+export declare const COVER_CACHE_TTL_MS: number;
+export declare const COVER_CACHE_MAX_FILES = 1200;
+/** 图片渲染用的字体候选，按平台常见路径排列，找不到时回退到运行环境默认字体 */
+export declare const FONT_CANDIDATES: string[];
+/** 加粗字体候选，找不到时由绘制层用描边模拟粗体 */
+export declare const BOLD_FONT_CANDIDATES: string[];
+/**
+ * JPEG 编码质量。
+ *
+ * 时间表以文字与细线条为主，JPEG 的块状伪影在这种内容上比照片里明显得多。取 100
+ * 是**无损**编码，文字边缘最锐利；体积比 92 大约多三成，但一张周表也就一兆出头，
+ * 不值得为省这点流量牺牲清晰度。想压体积可以调低。
+ */
+export declare const DEFAULT_JPEG_QUALITY = 100;
+/** 注册到 canvas 的字体族名，与 config.render.fontFamily 的默认值保持一致 */
+export declare const DEFAULT_FONT_FAMILY = "Anime Schedule Sans";
+/**
+ * 图片版式常量。
+ *
+ * 版式遵循同一套规则，所有版面共享它，避免各处各写一套数字：
+ * - **页眉**：左侧强调条 + 标题，其下是副标题，右上角是统计与时区，固定高度 120。
+ * - **页脚**：清一色 bottom 对齐，只写数据来源。
+ * - **卡片**：内容一律**居左**排列；封面、标题、次要信息的竖直位置固定，
+ *   与文字长短无关，因此整张图的每一行都对齐在同样的基线上。
+ * - **封面**：统一 `媒体高 × 1.4` 的竖版比例，等比完整显示，不裁切。
+ */
+export declare const IMAGE_LAYOUT: {
+    /** 统一外边距 */
+    padding: number;
+    /** 页眉 / 页脚固定高度 */
+    headerHeight: number;
+    footerHeight: number;
+    /** 周历表：七天并排的画布宽度 */
+    weekWidth: number;
+    /** 单日时间轴（每日 / 深夜档）的画布宽度 */
+    timelineWidth: number;
+    /** 卡片列表（list 排版）的画布宽度 */
+    listWidth: number;
+    /** 本季封面网格的画布宽度，要放得下 10 列 */
+    seasonWidth: number;
+    /** 行卡片高度（每日 / 列表排版）。容纳「标题 + 时刻 + 集数 + ID + 评分」五行 */
+    rowHeight: number;
+    /** 行卡片之间的间距 */
+    rowGap: number;
+    /** 行卡片圆角与内边距 */
+    rowRadius: number;
+    rowPadding: number;
+    /** 行卡片封面高度，宽度按 1 : 1.4 推出 */
+    mediaHeight: number;
+    /** 封面与文字之间的间距 */
+    mediaGap: number;
+    /** 卡片文字行间距。五行内容靠它撑开节奏，太小会挤成一团 */
+    cardLineGap: number;
+    /** 封面圆角 */
+    mediaRadius: number;
+    /** 时间轴轨道相对左边距的位置 */
+    timelineSpine: number;
+    /** 轨道圆点半径 */
+    timelineDot: number;
+    /** 时刻文字与轨道之间的间距 */
+    timelineTimeGap: number;
+    /** 时刻文字与封面之间的间距 */
+    timelineCardGap: number;
+    /** 日期节点高度（深夜档的「今晚 / 次日凌晨」） */
+    timelineDayHeaderHeight: number;
+    /** 时间轴主线颜色 */
+    timelineLine: string;
+    /** 七日列之间的间距与整张卡的内边距 */
+    weekColumnGap: number;
+    weekCardPadding: number;
+    /** 周历表列头高度 */
+    weekHeaderHeight: number;
+    /** 周历表条目高度、行距与标题行数 */
+    weekRowHeight: number;
+    weekRowGap: number;
+    weekTitleLines: number;
+    weekTitleLineHeight: number;
+    /** 周历表条目内的封面高度（与三行文字齐高，保持 1 : 1.4 比例不再被压扁） */
+    weekMediaHeight: number;
+    /** 列表卡片高度（与行卡片一致，两种排版观感统一） */
+    cardHeight: number;
+    cardGap: number;
+    /** 两栏之间的间距 */
+    cardColumnGap: number;
+    /** 分组标题占用的高度 */
+    sectionHeaderHeight: number;
+    /** 每行的番剧数量 */
+    seasonColumns: number;
+    /** 网格列间距与行间距 */
+    seasonColumnGap: number;
+    seasonRowGap: number;
+    /** 网格卡片内边距与卡片高度。封面盒高即卡片高减去上下内边距与元信息高度 */
+    seasonPadding: number;
+    seasonCardHeight: number;
+    /** 标题行数与行高（固定两行，保证首播时间、ID 与评分在同一基线） */
+    seasonTitleLines: number;
+    seasonTitleLineHeight: number;
+    /** 首播时间 / 条目 ID / 评分三行共用的行高 */
+    gridMetaLineHeight: number;
+    /** 封面宽高比（1 : 1.4 的竖版，与 Bangumi 原图一致） */
+    seasonCoverRatio: number;
+};
+/** 时间表配色，全插件共用一套色板 */
+export declare const IMAGE_THEME: {
+    background: string;
+    surface: string;
+    cardBorder: string;
+    divider: string;
+    /** 强调色：时刻、日期与「今天」高亮 */
+    accent: string;
+    /** 封面的底色（等比完整显示时留白的那一圈） */
+    badge: string;
+    title: string;
+    body: string;
+    muted: string;
+    onAccent: string;
+    score: string;
+    /** 卡片投影：略深一点，白色卡片才从浅灰背景上立起来 */
+    shadow: string;
+};
+/**
+ * 面向用户的文本。默认中文，`ja-JP` / `en-US` 覆盖展示层最常读到的句子，
+ * 未覆盖的键回退到中文，保证任何语言下都不会出现空文案。
+ *
+ * 日期文案由 `formatDayLabel` 按语言格式化，不再硬编码在表格里。
+ */
+export interface Messages {
+    weekdayNames: string[];
+    dailyHeader: (date: string) => string;
+    nightHeader: (date: string) => string;
+    weeklyHeader: (start: string, end: string) => string;
+    seasonHeader: (label: string) => string;
+    subHeader: (count: number) => string;
+    emptyDaily: string;
+    emptyNight: string;
+    emptyWeekly: string;
+    emptySeason: string;
+    emptySub: string;
+    /** 有订阅、但今天都没有播出时的提示 */
+    noAiringSub: (count: number) => string;
+    /** 每日表与订阅表里「当天」那一段的标题 */
+    daytimeGroup: string;
+    /** 深夜档推送里「今晚 21:00 起」那一段的标题 */
+    tonightGroup: (date: string) => string;
+    /** 订阅表里「次日凌晨」那一段的标题 */
+    tomorrowDawnGroup: (date: string) => string;
+    seasonLabel: (year: number, month: number) => string;
+    countUnit: string;
+    /** 完整集数文案，例如 `第 5 话` */
+    episodeUnit: (count: number) => string;
+    /** 时间表排版里的短集数文本，例如 `#5` */
+    episodeShort: (count: number) => string;
+    summaryOf: (total: number, lateNight: number) => string;
+    truncated: (shown: number, total: number) => string;
+    footer: string;
+    /** 周历表表头的日期区间，例如 `9月21日 - 9月27日`；两端已由 formatDayLabel 本地化 */
+    rangeLabel: (start: string, end: string) => string;
+    /** 今天的日期列角标 */
+    todayBadge: string;
+    /** 已在订阅列表里的作品，条目上的气泡 */
+    subscribedBadge: string;
+    /** 日期列超出上限时的提示 */
+    moreItems: (count: number) => string;
+}
+export declare const MESSAGES: Record<PluginLocale, Messages>;
+export declare function getMessages(locale: PluginLocale): Messages;
+/** 交互回复：完整句，结尾带句号 */
+export declare const RESPONSES: {
+    readonly needGuild: "请在群聊中使用此指令。";
+    readonly invalidKind: (value: string) => string;
+    readonly invalidDigest: (value: string) => string;
+    readonly invalidTid: (value: string) => string;
+    readonly invalidIndex: (value: string) => string;
+    readonly noSubscription: "本群还没有订阅任何番剧，先使用 `anime.search <关键词>` 找到作品，再用 `anime.sub <ID>` 订阅。";
+    readonly subscribeLimit: (limit: number) => string;
+    readonly alreadySubscribed: (title: string) => string;
+    readonly subscribeFailed: "订阅失败，请稍后重试或检查后台日志。";
+    readonly databaseFailed: "数据库操作失败，请检查后台日志。";
+    readonly renderFailed: "图片渲染失败，已改用文本发送。";
+    readonly emptySearch: (keyword: string) => string;
+    readonly notFound: "未找到该作品，它可能不在 bangumi-data 索引里。";
+};
+/** 日志里出现的固定短语 */
+export declare const LOG_MESSAGES: {
+    readonly cleanupFailed: "清理过期推送记录失败:";
+};