koishi-plugin-anime-schedule 1.0.8 → 1.1.0

package/lib/config.d.ts

@@ -28,6 +28,8 @@ export interface Config {
         format: DigestFormat;
         layout: ImageLayout;
         coverLimit: number;
+        /** `anime.info` 按关键词查询时最多出几部，`0` 表示不限制 */
+        infoKeywordLimit: number;
         showCover: boolean;
         showScore: boolean;
         useForward: boolean;
@@ -46,8 +48,10 @@ export interface Config {
         fontFamily: string;
         coverConcurrency: number;
         coverCacheDays: number;
-        /** JPEG 编码质量（0-100）。图片以文字与线条为主，压缩伪影很明显，因此默认取高值 */
+        /** JPEG 编码质量（1-100） */
         jpegQuality: number;
+        /** 超采样倍数：画布按「逻辑尺寸 × 该值」建立后再等比缩放，小字笔画更锐利，体积与耗时随之上升 */
+        supersample: number;
     };
     subscription: {
         /** 单个群最多订阅的番剧数量，0 表示不限制 */
@@ -60,8 +64,5 @@ export interface Config {
     };
 }
 export declare const Config: Schema<Config>;
-/**
- * 把配置夹到安全区间。
- * 只保证「类型正确」与「不小于最小值」，不设人为上限。
- */
+/** 把配置夹到安全区间：只保证类型正确且不小于最小值，不设人为上限 */
 export declare function normalizeConfig(config: Config): Config;

package/lib/config.js

@@ -24,7 +24,7 @@ exports.Config = koishi_1.Schema.intersect([
             koishi_1.Schema.const('Asia/Taipei').description('Asia/Taipei (UTC+8)'),
             koishi_1.Schema.const('UTC').description('UTC'),
         ])
-            .description('时刻与日期按此时区换算')
+            .description('时刻与日期换算时区')
             .default('Asia/Shanghai'),
         locale: koishi_1.Schema.union([
             koishi_1.Schema.const('zh-CN').description('简体中文'),
@@ -39,10 +39,10 @@ exports.Config = koishi_1.Schema.intersect([
             dailyEnabled: koishi_1.Schema.boolean().description('每日更新表').default(true),
             dailyTime: koishi_1.Schema.string().pattern(TIME_PATTERN).description('推送时刻').default('08:00'),
             dailyOffsetDays: koishi_1.Schema.number()
-                .min(-1).max(1).step(1)
-                .description('日期偏移：0 当天，-1 前一天，1 后一天')
+                .min(constants_1.DAILY_OFFSET_MIN).max(constants_1.DAILY_OFFSET_MAX).step(1)
+                .description('日期偏移，0 当天、-1 前一天、1 后一天')
                 .default(0),
-            nightEnabled: koishi_1.Schema.boolean().description('深夜档（当晚 21:00 至次日 06:00）').default(true),
+            nightEnabled: koishi_1.Schema.boolean().description('深夜档，当晚 21:00 至次日 06:00').default(true),
             nightTime: koishi_1.Schema.string().pattern(TIME_PATTERN).description('推送时刻').default('21:00'),
             weeklyEnabled: koishi_1.Schema.boolean().description('本周更新表').default(true),
             weeklyWeekday: koishi_1.Schema.union(WEEKDAYS.map((item) => koishi_1.Schema.const(item.value).description(item.label)))
@@ -66,11 +66,11 @@ exports.Config = koishi_1.Schema.intersect([
         content: koishi_1.Schema.object({
             maxItems: koishi_1.Schema.number()
                 .min(0).step(10)
-                .description('单次推送最多显示多少部，0 为不限制')
+                .description('单次推送最多显示多少部，0 不限制')
                 .default(0),
             longRunningThreshold: koishi_1.Schema.number()
                 .min(0).step(1)
-                .description('剔除长期连载番的话数阈值，0 为不过滤')
+                .description('剔除长期连载番的话数阈值，0 不过滤')
                 .default(0),
         }),
     }).description('推送内容'),
@@ -80,7 +80,7 @@ exports.Config = koishi_1.Schema.intersect([
                 koishi_1.Schema.const('image').description('风格化图片'),
                 koishi_1.Schema.const('text').description('纯文本'),
             ])
-                .description('推送形态；图片渲染失败时自动改用文本')
+                .description('推送形态，图片渲染失败时自动改用文本')
                 .default('image'),
             layout: koishi_1.Schema.union([
                 koishi_1.Schema.const('table').description('时间表'),
@@ -90,12 +90,16 @@ exports.Config = koishi_1.Schema.intersect([
                 .default('table'),
             coverLimit: koishi_1.Schema.number()
                 .min(0)
-                .description('单张图片最多加载多少张封面，0 为不限制')
+                .description('单张图片最多加载多少张封面，0 不限制')
                 .default(0),
+            infoKeywordLimit: koishi_1.Schema.number()
+                .min(0)
+                .description('anime.info 按关键词查询番剧时显示数量上限，0 不限制')
+                .default(20),
             showCover: koishi_1.Schema.boolean().description('显示封面').default(true),
-            showScore: koishi_1.Schema.boolean().description('显示评分，评价不足 10 人时不显示').default(true),
+            showScore: koishi_1.Schema.boolean().description('显示评分，评价不足 10 条时隐藏').default(true),
             useForward: koishi_1.Schema.boolean()
-                .description('纯文本模式使用合并转发，避免刷屏')
+                .description('纯文本模式用合并转发，避免刷屏')
                 .default(true),
         }),
     }).description('输出设置'),
@@ -121,14 +125,14 @@ exports.Config = koishi_1.Schema.intersect([
                 .default(30),
             airingTtlHours: koishi_1.Schema.number()
                 .min(1).step(1)
-                .description('播出状态（是否已播完）的缓存小时数')
+                .description('是否已播完的缓存小时数')
                 .default(6),
         }),
     }).description('本地化'),
     koishi_1.Schema.object({
         render: koishi_1.Schema.object({
             fontFamily: koishi_1.Schema.string()
-                .description('绘制图片时使用的字体族；留空则自动寻找系统中文字体')
+                .description('字体族，留空则自动寻找系统中文字体')
                 .default(constants_1.DEFAULT_FONT_FAMILY),
             coverConcurrency: koishi_1.Schema.number()
                 .min(1)
@@ -136,19 +140,23 @@ exports.Config = koishi_1.Schema.intersect([
                 .default(constants_1.COVER_CONCURRENCY),
             coverCacheDays: koishi_1.Schema.number()
                 .min(0)
-                .description('封面缓存天数，0 为不写磁盘')
+                .description('封面缓存天数，0 不写磁盘')
                 .default(21),
             jpegQuality: koishi_1.Schema.number()
                 .min(1).max(100).step(1)
-                .description('图片编码质量')
+                .description('编码质量')
                 .default(constants_1.DEFAULT_JPEG_QUALITY),
+            supersample: koishi_1.Schema.number()
+                .min(1).max(constants_1.MAX_SUPERSAMPLE).step(1)
+                .description('超采样倍数')
+                .default(constants_1.DEFAULT_SUPERSAMPLE),
         }),
     }).description('图片'),
     koishi_1.Schema.object({
         subscription: koishi_1.Schema.object({
             maxPerChannel: koishi_1.Schema.number()
                 .min(0).step(1)
-                .description('单个群最多订阅多少部，0 为不限制')
+                .description('单个群最多订阅多少部，0 不限制')
                 .default(0),
         }),
     }).description('订阅'),
@@ -157,7 +165,7 @@ exports.Config = koishi_1.Schema.intersect([
             requestTimeout: koishi_1.Schema.number()
                 .min(1)
                 .description('单次请求超时（秒）')
-                .default(20),
+                .default(constants_1.LOCALIZE_TIMEOUT_SECONDS),
             retries: koishi_1.Schema.number()
                 .min(0)
                 .description('请求失败重试次数')
@@ -168,18 +176,22 @@ exports.Config = koishi_1.Schema.intersect([
         }),
     }).description('其他'),
 ]);
-/**
- * 把配置夹到安全区间。
- * 只保证「类型正确」与「不小于最小值」，不设人为上限。
- */
+/** 把配置夹到安全区间：只保证类型正确且不小于最小值，不设人为上限 */
 function normalizeConfig(config) {
+    /** 取整并夹到不小于 `min`（默认 0）。允许负值的字段不能走这个默认值 */
     const int = (value, fallback, min = 0) => {
         if (typeof value !== 'number' || !Number.isFinite(value))
             return fallback;
         return Math.max(min, Math.round(value));
     };
+    /** 取整并夹到 `[min, max]`；用于允许负值的字段，如 `dailyOffsetDays` */
+    const intBetween = (value, fallback, min, max) => {
+        if (typeof value !== 'number' || !Number.isFinite(value))
+            return fallback;
+        return Math.min(max, Math.max(min, Math.round(value)));
+    };
     const time = (value, fallback) => (typeof value === 'string' && TIME_PATTERN.test(value) ? value : fallback);
-    // 旧版本存在 `both` 形态，已移除，统一按图片处理
+    // 旧版本的 `both` 形态已移除：非 `text` 一律按图片处理
     const format = config.output?.format === 'text' ? 'text' : 'image';
     return {
         ...config,
@@ -187,7 +199,7 @@ function normalizeConfig(config) {
         push: {
             ...config.push,
             dailyTime: time(config.push?.dailyTime, '08:00'),
-            dailyOffsetDays: Math.max(-1, Math.min(1, int(config.push?.dailyOffsetDays, 0))),
+            dailyOffsetDays: intBetween(config.push?.dailyOffsetDays, 0, constants_1.DAILY_OFFSET_MIN, constants_1.DAILY_OFFSET_MAX),
             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'),
@@ -204,6 +216,7 @@ function normalizeConfig(config) {
             format,
             layout: config.output?.layout === 'list' ? 'list' : 'table',
             coverLimit: int(config.output?.coverLimit, 0),
+            infoKeywordLimit: int(config.output?.infoKeywordLimit, 20),
         },
         localize: {
             ...config.localize,
@@ -217,6 +230,7 @@ function normalizeConfig(config) {
             coverConcurrency: int(config.render?.coverConcurrency, constants_1.COVER_CONCURRENCY, 1),
             coverCacheDays: int(config.render?.coverCacheDays, 21),
             jpegQuality: Math.min(100, int(config.render?.jpegQuality, constants_1.DEFAULT_JPEG_QUALITY, 1)),
+            supersample: Math.min(constants_1.MAX_SUPERSAMPLE, int(config.render?.supersample, constants_1.DEFAULT_SUPERSAMPLE, 1)),
         },
         subscription: {
             ...config.subscription,
@@ -224,7 +238,7 @@ function normalizeConfig(config) {
         },
         advanced: {
             ...config.advanced,
-            requestTimeout: int(config.advanced?.requestTimeout, 20, 1),
+            requestTimeout: int(config.advanced?.requestTimeout, constants_1.LOCALIZE_TIMEOUT_SECONDS, 1),
             retries: int(config.advanced?.retries, 2),
         },
     };

package/lib/constants.d.ts

@@ -19,6 +19,12 @@ export declare const ANILIST_BATCH_SIZE = 50;
  * 相当于最多 50 次/分钟，既不会触发突发限流，也远低于上限。
  */
 export declare const ANILIST_MIN_INTERVAL_MS = 1200;
+/**
+ * 收到 429 / 403 后的冷却时长。
+ *
+ * 429 是超限封禁、403 是 API 被临时停用，两种情况都沿用已有数据一段时间再试。
+ */
+export declare const ANILIST_COOLDOWN_MS: number;
 /**
  * bangumi-data 索引。
  *
@@ -74,9 +80,8 @@ export declare const DEFAULT_SCORE_TTL_HOURS = 24;
 /**
  * 显示评分所需的最少评价人数。
  *
- * 低于这个数就不显示评分：新番刚开播时可能只有一两个人投票，那个数字会随着样本增加
- * 剧烈变化（实测至高之力 1 票时是 7.0，156 票时是 6.1）。宁可留空，也不要给读者一个
- * 会误导人的数字。
+ * 低于此数不显示评分：新番开播初期样本极少，评分会随样本增加剧烈变化
+ * （实测至高之力 1 票时 7.0，156 票时 6.1）。留空优于给出误导性的数字。
  */
 export declare const MIN_SCORE_VOTES = 10;
 export declare const LOCALIZE_CACHE_VERSION = 6;
@@ -86,10 +91,18 @@ export declare const LOCALIZE_CACHE_MAX_ENTRIES = 5000;
 export declare const EPISODE_QUERY_LIMIT = 100;
 /**
  * 并发检索 Bangumi 的条数上限。
- * Bangumi 没有公开的严格限流，但一次本季表可能有上百部作品，
- * 4 路并发已能把原本串行的等待时间压到 1/4，同时不至于触发风控。
+ *
+ * Bangumi 没有公开的严格限流，但一次本季表可能有上百部作品。取 6 路：实测 4 路时周表
+ * 取详情要 50 秒上下，6 路约省三分之一，仍远低于会让站点限流的密度。
+ */
+export declare const LOCALIZE_CONCURRENCY = 6;
+/**
+ * 单次元数据请求的超时（秒），`advanced.requestTimeout` 的默认值。
+ *
+ * Bangumi 的条目接口是小体积 JSON，正常几百毫秒返回。等满 20 秒基本等价于连接已死，
+ * 而一条超时会把整次构建拖住这么久，所以默认压到 10 秒；嫌紧可以自行调大。
  */
-export declare const LOCALIZE_CONCURRENCY = 4;
+export declare const LOCALIZE_TIMEOUT_SECONDS = 10;
 /** 并发拉取封面时的并发上限 */
 export declare const COVER_CONCURRENCY = 8;
 /** 封面下载超时与体积上限，避免个别大图拖垮整次渲染 */
@@ -106,11 +119,30 @@ export declare const BOLD_FONT_CANDIDATES: string[];
 /**
  * JPEG 编码质量。
  *
- * 时间表以文字与细线条为主，JPEG 的块状伪影在这种内容上比照片里明显得多。取 100
- * 是**无损**编码，文字边缘最锐利；体积比 92 大约多三成，但一张周表也就一兆出头，
- * 不值得为省这点流量牺牲清晰度。想压体积可以调低。
+ * 图片以文字与细线条为主，块状伪影比在照片上明显。取 100 为无损编码，文字边缘最锐利；
+ * 体积比 92 约多三成，可调低换取更小体积。
  */
 export declare const DEFAULT_JPEG_QUALITY = 100;
+/**
+ * 超采样倍数。
+ *
+ * 画布按「逻辑尺寸 × 该值」建立后在上下文上做等比 `scale`，缩回目标尺寸时由更多采样
+ * 得出边缘像素。清晰度主要取决于此：各版面最小字号仅 10~11px，1× 下一个字不足十几个
+ * 像素，JPEG 质量再高也无法还原。
+ *
+ * 3 在密集的封面与小字上收益仍可见；5 是收益递减的上限。
+ */
+export declare const DEFAULT_SUPERSAMPLE = 3;
+/** 超采样倍数的可选上限，与配置项的 `.max()` 保持一致 */
+export declare const MAX_SUPERSAMPLE = 5;
+/**
+ * 每日更新表的日期偏移范围（天）。
+ *
+ * 配置项的 `.min()/.max()` 与 `normalizeConfig` 的钳制共用这两个值——
+ * 两处分开写时极易只改一处，导致「配置页能填、实际被悄悄夹回去」。
+ */
+export declare const DAILY_OFFSET_MIN = -7;
+export declare const DAILY_OFFSET_MAX = 7;
 /** 注册到 canvas 的字体族名，与 config.render.fontFamily 的默认值保持一致 */
 export declare const DEFAULT_FONT_FAMILY = "Anime Schedule Sans";
 /**
@@ -131,14 +163,21 @@ export declare const IMAGE_LAYOUT: {
     footerHeight: number;
     /** 周历表：七天并排的画布宽度 */
     weekWidth: number;
-    /** 单日时间轴（每日 / 深夜档）的画布宽度 */
+    /**
+     * 单日时间轴（每日 / 深夜档）画布宽度。
+     *
+     * 等于「左边距 + 时刻栏 + 轨道 + 时刻↔卡片间距 + 卡片宽 + 右边距」，不留余量，
+     * 使「现在」虚线的终点与卡片右缘重合。
+     */
     timelineWidth: number;
     /** 卡片列表（list 排版）的画布宽度 */
     listWidth: number;
     /** 本季封面网格的画布宽度，要放得下 10 列 */
     seasonWidth: number;
-    /** 行卡片高度（每日 / 列表排版）。容纳「标题 + 时刻 + 集数 + ID + 评分」五行 */
+    /** 行卡片高度：容纳固定的两行标题 + 一行元信息 */
     rowHeight: number;
+    /** 行卡片宽度，窄于画布，避免文字仅占左半、右侧留空 */
+    rowCardWidth: number;
     /** 行卡片之间的间距 */
     rowGap: number;
     /** 行卡片圆角与内边距 */
@@ -148,12 +187,15 @@ export declare const IMAGE_LAYOUT: {
     mediaHeight: number;
     /** 封面与文字之间的间距 */
     mediaGap: number;
-    /** 卡片文字行间距。五行内容靠它撑开节奏，太小会挤成一团 */
+    /** 标题行高与固定行数：短标题也占两行，使元信息行在所有卡片上对齐 */
+    cardTitleLineHeight: number;
+    cardTitleLines: number;
+    /** 标题块与元信息行之间的间距 */
     cardLineGap: number;
     /** 封面圆角 */
     mediaRadius: number;
-    /** 时间轴轨道相对左边距的位置 */
-    timelineSpine: number;
+    /** 左侧时刻栏宽度（内容左缘到轨道）。需容纳 `现在 18:30` 这类最长时刻文本，否则被画布左缘裁掉 */
+    timelineLabelWidth: number;
     /** 轨道圆点半径 */
     timelineDot: number;
     /** 时刻文字与轨道之间的间距 */
@@ -176,8 +218,7 @@ export declare const IMAGE_LAYOUT: {
     weekTitleLineHeight: number;
     /** 周历表条目内的封面高度（与三行文字齐高，保持 1 : 1.4 比例不再被压扁） */
     weekMediaHeight: number;
-    /** 列表卡片高度（与行卡片一致，两种排版观感统一） */
-    cardHeight: number;
+    /** 列表卡片沿用行卡片高度，两种排版保持一致 */
     cardGap: number;
     /** 两栏之间的间距 */
     cardColumnGap: number;
@@ -205,17 +246,35 @@ export declare const IMAGE_THEME: {
     surface: string;
     cardBorder: string;
     divider: string;
-    /** 强调色：时刻、日期与「今天」高亮 */
+    /**
+     * 强调色：时刻、日期、「今天」高亮，以及详情卡的已播集数与峰值柱。
+     *
+     * 取珊瑚红 `#e26d6d`——比纯红柔和，整张表看下来不刺眼；详情卡的实心块共用它，
+     * 于是「已播集数」与列表里的「已订阅」气泡是同一套视觉语言。
+     */
     accent: string;
     /** 封面的底色（等比完整显示时留白的那一圈） */
     badge: string;
+    /** 强调色的浅色底：软胶囊用 */
+    accentSoft: string;
+    /** 未播集数 / 禁用态的浅灰底 */
+    inert: string;
+    /** 未播集数的文字色，比 muted 更浅，明确表示「还没到」 */
+    inertText: string;
+    /** 未播集数的描边：仅靠底色时与白色卡片难以区分，需勾出轮廓 */
+    inertBorder: string;
+    /** 评分柱的非峰值色 */
+    scoreBar: string;
     title: string;
     body: string;
     muted: string;
     onAccent: string;
+    /** 评分：橙金色，全插件统一 */
     score: string;
     /** 卡片投影：略深一点，白色卡片才从浅灰背景上立起来 */
     shadow: string;
+    /** 封面投影，比卡片投影更轻 */
+    coverShadow: string;
 };
 /**
  * 面向用户的文本。默认中文，`ja-JP` / `en-US` 覆盖展示层最常读到的句子，
@@ -254,12 +313,8 @@ export interface Messages {
     footer: string;
     /** 周历表表头的日期区间，例如 `9月21日 - 9月27日`；两端已由 formatDayLabel 本地化 */
     rangeLabel: (start: string, end: string) => string;
-    /** 今天的日期列角标 */
-    todayBadge: string;
     /** 已在订阅列表里的作品，条目上的气泡 */
     subscribedBadge: string;
-    /** 日期列超出上限时的提示 */
-    moreItems: (count: number) => string;
     /** 详情卡页脚的数据更新时间 */
     infoUpdated: (moment: string) => string;
     /** 连载状态 */
@@ -301,7 +356,7 @@ export declare const RESPONSES: {
     readonly databaseFailed: "数据库操作失败，请检查后台日志。";
     readonly renderFailed: "图片渲染失败，已改用文本发送。";
     readonly emptySearch: (keyword: string) => string;
-    readonly notFound: "未找到该作品，它可能不在 bangumi-data 索引里。";
+    readonly notFound: "未找到该作品，可能不在 bangumi-data 索引中。";
 };
 /** 日志里出现的固定短语 */
 export declare const LOG_MESSAGES: {

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.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_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_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.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.buildUserAgent = buildUserAgent;
 exports.getMessages = getMessages;
 /** 插件名，同时作为日志前缀与 User-Agent 主体 */
@@ -23,6 +23,12 @@ exports.ANILIST_BATCH_SIZE = 50;
  * 相当于最多 50 次/分钟，既不会触发突发限流，也远低于上限。
  */
 exports.ANILIST_MIN_INTERVAL_MS = 1200;
+/**
+ * 收到 429 / 403 后的冷却时长。
+ *
+ * 429 是超限封禁、403 是 API 被临时停用，两种情况都沿用已有数据一段时间再试。
+ */
+exports.ANILIST_COOLDOWN_MS = 5 * 60 * 1000;
 /**
  * bangumi-data 索引。
  *
@@ -90,9 +96,8 @@ exports.DEFAULT_SCORE_TTL_HOURS = 24;
 /**
  * 显示评分所需的最少评价人数。
  *
- * 低于这个数就不显示评分：新番刚开播时可能只有一两个人投票，那个数字会随着样本增加
- * 剧烈变化（实测至高之力 1 票时是 7.0，156 票时是 6.1）。宁可留空，也不要给读者一个
- * 会误导人的数字。
+ * 低于此数不显示评分：新番开播初期样本极少，评分会随样本增加剧烈变化
+ * （实测至高之力 1 票时 7.0，156 票时 6.1）。留空优于给出误导性的数字。
  */
 exports.MIN_SCORE_VOTES = 10;
 exports.LOCALIZE_CACHE_VERSION = 6;
@@ -102,10 +107,18 @@ exports.LOCALIZE_CACHE_MAX_ENTRIES = 5000;
 exports.EPISODE_QUERY_LIMIT = 100;
 /**
  * 并发检索 Bangumi 的条数上限。
- * Bangumi 没有公开的严格限流，但一次本季表可能有上百部作品，
- * 4 路并发已能把原本串行的等待时间压到 1/4，同时不至于触发风控。
+ *
+ * Bangumi 没有公开的严格限流，但一次本季表可能有上百部作品。取 6 路：实测 4 路时周表
+ * 取详情要 50 秒上下，6 路约省三分之一，仍远低于会让站点限流的密度。
+ */
+exports.LOCALIZE_CONCURRENCY = 6;
+/**
+ * 单次元数据请求的超时（秒），`advanced.requestTimeout` 的默认值。
+ *
+ * Bangumi 的条目接口是小体积 JSON，正常几百毫秒返回。等满 20 秒基本等价于连接已死，
+ * 而一条超时会把整次构建拖住这么久，所以默认压到 10 秒；嫌紧可以自行调大。
  */
-exports.LOCALIZE_CONCURRENCY = 4;
+exports.LOCALIZE_TIMEOUT_SECONDS = 10;
 /** 并发拉取封面时的并发上限 */
 exports.COVER_CONCURRENCY = 8;
 /** 封面下载超时与体积上限，避免个别大图拖垮整次渲染 */
@@ -143,11 +156,30 @@ exports.BOLD_FONT_CANDIDATES = [
 /**
  * JPEG 编码质量。
  *
- * 时间表以文字与细线条为主，JPEG 的块状伪影在这种内容上比照片里明显得多。取 100
- * 是**无损**编码，文字边缘最锐利；体积比 92 大约多三成，但一张周表也就一兆出头，
- * 不值得为省这点流量牺牲清晰度。想压体积可以调低。
+ * 图片以文字与细线条为主，块状伪影比在照片上明显。取 100 为无损编码，文字边缘最锐利；
+ * 体积比 92 约多三成，可调低换取更小体积。
  */
 exports.DEFAULT_JPEG_QUALITY = 100;
+/**
+ * 超采样倍数。
+ *
+ * 画布按「逻辑尺寸 × 该值」建立后在上下文上做等比 `scale`，缩回目标尺寸时由更多采样
+ * 得出边缘像素。清晰度主要取决于此：各版面最小字号仅 10~11px，1× 下一个字不足十几个
+ * 像素，JPEG 质量再高也无法还原。
+ *
+ * 3 在密集的封面与小字上收益仍可见；5 是收益递减的上限。
+ */
+exports.DEFAULT_SUPERSAMPLE = 3;
+/** 超采样倍数的可选上限，与配置项的 `.max()` 保持一致 */
+exports.MAX_SUPERSAMPLE = 5;
+/**
+ * 每日更新表的日期偏移范围（天）。
+ *
+ * 配置项的 `.min()/.max()` 与 `normalizeConfig` 的钳制共用这两个值——
+ * 两处分开写时极易只改一处，导致「配置页能填、实际被悄悄夹回去」。
+ */
+exports.DAILY_OFFSET_MIN = -7;
+exports.DAILY_OFFSET_MAX = 7;
 /** 注册到 canvas 的字体族名，与 config.render.fontFamily 的默认值保持一致 */
 exports.DEFAULT_FONT_FAMILY = 'Anime Schedule Sans';
 /**
@@ -162,37 +194,47 @@ exports.DEFAULT_FONT_FAMILY = 'Anime Schedule Sans';
  */
 exports.IMAGE_LAYOUT = {
     /** 统一外边距 */
-    padding: 24,
+    padding: 28,
     /** 页眉 / 页脚固定高度 */
     headerHeight: 120,
     footerHeight: 52,
     /** 周历表：七天并排的画布宽度 */
     weekWidth: 1680,
-    /** 单日时间轴（每日 / 深夜档）的画布宽度 */
-    timelineWidth: 900,
+    /**
+     * 单日时间轴（每日 / 深夜档）画布宽度。
+     *
+     * 等于「左边距 + 时刻栏 + 轨道 + 时刻↔卡片间距 + 卡片宽 + 右边距」，不留余量，
+     * 使「现在」虚线的终点与卡片右缘重合。
+     */
+    timelineWidth: 798,
     /** 卡片列表（list 排版）的画布宽度 */
     listWidth: 900,
     /** 本季封面网格的画布宽度，要放得下 10 列 */
     seasonWidth: 1680,
     // ---- 通用行卡片 ----
-    /** 行卡片高度（每日 / 列表排版）。容纳「标题 + 时刻 + 集数 + ID + 评分」五行 */
-    rowHeight: 112,
+    /** 行卡片高度：容纳固定的两行标题 + 一行元信息 */
+    rowHeight: 104,
+    /** 行卡片宽度，窄于画布，避免文字仅占左半、右侧留空 */
+    rowCardWidth: 640,
     /** 行卡片之间的间距 */
     rowGap: 8,
     /** 行卡片圆角与内边距 */
     rowRadius: 12,
-    rowPadding: 12,
+    rowPadding: 10,
     /** 行卡片封面高度，宽度按 1 : 1.4 推出 */
-    mediaHeight: 82,
+    mediaHeight: 92,
     /** 封面与文字之间的间距 */
     mediaGap: 14,
-    /** 卡片文字行间距。五行内容靠它撑开节奏，太小会挤成一团 */
+    /** 标题行高与固定行数：短标题也占两行，使元信息行在所有卡片上对齐 */
+    cardTitleLineHeight: 22,
+    cardTitleLines: 2,
+    /** 标题块与元信息行之间的间距 */
     cardLineGap: 6,
     /** 封面圆角 */
     mediaRadius: 6,
     // ---- 单日时间轴 ----
-    /** 时间轴轨道相对左边距的位置 */
-    timelineSpine: 50,
+    /** 左侧时刻栏宽度（内容左缘到轨道）。需容纳 `现在 18:30` 这类最长时刻文本，否则被画布左缘裁掉 */
+    timelineLabelWidth: 70,
     /** 轨道圆点半径 */
     timelineDot: 4,
     /** 时刻文字与轨道之间的间距 */
@@ -217,8 +259,7 @@ exports.IMAGE_LAYOUT = {
     /** 周历表条目内的封面高度（与三行文字齐高，保持 1 : 1.4 比例不再被压扁） */
     weekMediaHeight: 82,
     // ---- 卡片列表 ----
-    /** 列表卡片高度（与行卡片一致，两种排版观感统一） */
-    cardHeight: 112,
+    /** 列表卡片沿用行卡片高度，两种排版保持一致 */
     cardGap: 12,
     /** 两栏之间的间距 */
     cardColumnGap: 14,
@@ -247,17 +288,35 @@ exports.IMAGE_THEME = {
     surface: '#ffffff',
     cardBorder: '#e6e8ef',
     divider: '#eef0f5',
-    /** 强调色：时刻、日期与「今天」高亮 */
-    accent: '#f6665f',
+    /**
+     * 强调色：时刻、日期、「今天」高亮，以及详情卡的已播集数与峰值柱。
+     *
+     * 取珊瑚红 `#e26d6d`——比纯红柔和，整张表看下来不刺眼；详情卡的实心块共用它，
+     * 于是「已播集数」与列表里的「已订阅」气泡是同一套视觉语言。
+     */
+    accent: '#e26d6d',
     /** 封面的底色（等比完整显示时留白的那一圈） */
     badge: '#eef1f7',
+    /** 强调色的浅色底：软胶囊用 */
+    accentSoft: '#fdeceb',
+    /** 未播集数 / 禁用态的浅灰底 */
+    inert: '#f3f4f6',
+    /** 未播集数的文字色，比 muted 更浅，明确表示「还没到」 */
+    inertText: '#9ca3af',
+    /** 未播集数的描边：仅靠底色时与白色卡片难以区分，需勾出轮廓 */
+    inertBorder: '#e5e7eb',
+    /** 评分柱的非峰值色 */
+    scoreBar: '#fecaca',
     title: '#1f2330',
     body: '#5a6172',
     muted: '#9aa1b1',
     onAccent: '#ffffff',
-    score: '#f0913c',
+    /** 评分：橙金色，全插件统一 */
+    score: '#e69a3a',
     /** 卡片投影：略深一点，白色卡片才从浅灰背景上立起来 */
     shadow: 'rgba(31, 35, 48, 0.10)',
+    /** 封面投影，比卡片投影更轻 */
+    coverShadow: 'rgba(0, 0, 0, 0.06)',
 };
 const ZH_CN = {
     weekdayNames: ['周日', '周一', '周二', '周三', '周四', '周五', '周六'],
@@ -283,9 +342,7 @@ const ZH_CN = {
     truncated: (shown, total) => `仅显示前 ${shown} 部，其余 ${total - shown} 部请使用指令按需查询。`,
     footer: '数据来源: bangumi-data / Bangumi',
     rangeLabel: (start, end) => `${start} - ${end}`,
-    todayBadge: '今天',
     subscribedBadge: '已订阅',
-    moreItems: (count) => `还有 ${count} 部`,
     infoUpdated: (moment) => `数据更新于 ${moment}`,
     infoAiring: '连载中',
     infoFinished: '已完结',
@@ -328,9 +385,7 @@ const JA_JP = {
     truncated: (shown, total) => `先頭 ${shown} 作品のみ表示しています (残り ${total - shown} 作品)。`,
     footer: 'データ提供: bangumi-data / Bangumi',
     rangeLabel: (start, end) => `${start} 〜 ${end}`,
-    todayBadge: '今日',
     subscribedBadge: '登録済み',
-    moreItems: (count) => `他 ${count} 作品`,
     infoUpdated: (moment) => `データ更新 ${moment}`,
     infoAiring: '放送中',
     infoFinished: '完結',
@@ -373,9 +428,7 @@ const EN_US = {
     truncated: (shown, total) => `Showing first ${shown} of ${total} titles.`,
     footer: 'Data: bangumi-data / Bangumi',
     rangeLabel: (start, end) => `${start} - ${end}`,
-    todayBadge: 'Today',
     subscribedBadge: 'Subscribed',
-    moreItems: (count) => `+${count} more`,
     infoUpdated: (moment) => `Updated ${moment}`,
     infoAiring: 'Airing',
     infoFinished: 'Finished',
@@ -415,7 +468,7 @@ exports.RESPONSES = {
     databaseFailed: '数据库操作失败，请检查后台日志。',
     renderFailed: '图片渲染失败，已改用文本发送。',
     emptySearch: (keyword) => `未找到与 "${keyword}" 相关的作品，请尝试使用日文原名或更简短的关键词。`,
-    notFound: '未找到该作品，它可能不在 bangumi-data 索引里。',
+    notFound: '未找到该作品，可能不在 bangumi-data 索引中。',
 };
 /** 日志里出现的固定短语 */
 exports.LOG_MESSAGES = {