koishi-plugin-anime-schedule 1.0.8 → 1.0.9

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('订阅'),
@@ -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,

package/lib/constants.d.ts

@@ -74,9 +74,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;
@@ -102,15 +101,43 @@ export declare const COVER_CACHE_MAX_FILES = 1200;
 /** 图片渲染用的字体候选，按平台常见路径排列，找不到时回退到运行环境默认字体 */
 export declare const FONT_CANDIDATES: string[];
 /** 加粗字体候选，找不到时由绘制层用描边模拟粗体 */
+/**
+ * 兜底字体族候选。
+ *
+ * 与 `FONT_CANDIDATES` 的区别：那些是**主字体**（选一个用），这些是**补充**
+ * （全部注册，缺字形时按顺序回退）。`@napi-rs/canvas` 只在"字体族不存在"时回退，
+ * 族存在但缺字形就直接画豆腐块，所以补充族必须真的注册进来才有效。
+ * 名字要与 `render/fonts.ts` 的 `FALLBACK_FAMILIES` 一致。
+ */
+export declare const FALLBACK_FONT_CANDIDATES: string[];
 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 +158,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 +182,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 +213,7 @@ export declare const IMAGE_LAYOUT: {
     weekTitleLineHeight: number;
     /** 周历表条目内的封面高度（与三行文字齐高，保持 1 : 1.4 比例不再被压扁） */
     weekMediaHeight: number;
-    /** 列表卡片高度（与行卡片一致，两种排版观感统一） */
-    cardHeight: number;
+    /** 列表卡片沿用行卡片高度，两种排版保持一致 */
     cardGap: number;
     /** 两栏之间的间距 */
     cardColumnGap: number;
@@ -205,17 +241,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` 覆盖展示层最常读到的句子，
@@ -301,7 +355,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.FALLBACK_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.buildUserAgent = buildUserAgent;
 exports.getMessages = getMessages;
 /** 插件名，同时作为日志前缀与 User-Agent 主体 */
@@ -90,9 +90,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;
@@ -132,6 +131,20 @@ exports.FONT_CANDIDATES = [
     '/usr/share/fonts/truetype/arphic/uming.ttc',
 ];
 /** 加粗字体候选，找不到时由绘制层用描边模拟粗体 */
+/**
+ * 兜底字体族候选。
+ *
+ * 与 `FONT_CANDIDATES` 的区别：那些是**主字体**（选一个用），这些是**补充**
+ * （全部注册，缺字形时按顺序回退）。`@napi-rs/canvas` 只在"字体族不存在"时回退，
+ * 族存在但缺字形就直接画豆腐块，所以补充族必须真的注册进来才有效。
+ * 名字要与 `render/fonts.ts` 的 `FALLBACK_FAMILIES` 一致。
+ */
+exports.FALLBACK_FONT_CANDIDATES = [
+    'C:/Windows/Fonts/YuGothR.ttc',
+    'C:/Windows/Fonts/msgothic.ttc',
+    'C:/Windows/Fonts/simsun.ttc',
+    'C:/Windows/Fonts/NotoSansSC-VF.ttf',
+];
 exports.BOLD_FONT_CANDIDATES = [
     'C:/Windows/Fonts/msyhbd.ttc',
     'C:/Windows/Fonts/Dengb.ttf',
@@ -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: ['周日', '周一', '周二', '周三', '周四', '周五', '周六'],
@@ -415,7 +474,7 @@ exports.RESPONSES = {
     databaseFailed: '数据库操作失败，请检查后台日志。',
     renderFailed: '图片渲染失败，已改用文本发送。',
     emptySearch: (keyword) => `未找到与 "${keyword}" 相关的作品，请尝试使用日文原名或更简短的关键词。`,
-    notFound: '未找到该作品，它可能不在 bangumi-data 索引里。',
+    notFound: '未找到该作品，可能不在 bangumi-data 索引中。',
 };
 /** 日志里出现的固定短语 */
 exports.LOG_MESSAGES = {

package/lib/data/anilist-match.d.ts

@@ -1,16 +1,10 @@
 /**
- * 按标题把条目匹配到 AniList。
+ * 按标题把条目匹配到 AniList。用于运行时给「没带 `aniList` ID」的条目补 ID
+ * （`services/airing.ts`），以及维护脚本 `scripts/match-anilist.ts` 生成离线映射表。
  *
- * 用于两处：
- * - 运行时给「bangumi-data 没带 `aniList` ID」的条目补 ID（`services/airing.ts`）；
- * - 维护脚本 `scripts/match-anilist.ts` 生成离线映射表。
- *
- * 判定标准分两级：
- * - **硬条件**：标题归一化后相等（含 AniList 的 `synonyms`）+ 首播日期相差不超过
- *   `MAX_DAY_GAP` 天。前者排除无关条目，后者排除同名的不同季。
- * - **软条件**：播出时刻相差不超过 `MAX_HOUR_GAP` 小时。AniList 记的是「某一时刻可以看」，
- *   与日本电视档期本来就可能差几小时（配信早于电视），因此只用来提示「档期需订正」，
- *   不作为匹配是否成立的条件。
+ * **硬条件**（决定匹配是否成立）：标题归一化后相等（含 `synonyms`）且首播日期相差不超过
+ * `MAX_DAY_GAP` 天。**软条件**：播出时刻相差不超过 `MAX_HOUR_GAP` 小时——AniList 记的是
+ * 「某一时刻可以看」，与电视档期可能差几小时，只用于提示「档期需订正」。
  */
 /** 首播日期允许的偏差（天） */
 export declare const MAX_DAY_GAP = 30;
@@ -18,9 +12,7 @@ export declare const MAX_DAY_GAP = 30;
 export declare const MAX_HOUR_GAP = 6;
 /**
  * 归一化标题：去空白与标点、全角转半角、罗马数字统一、去季度后缀。
- *
- * 目的是让「転生貴族、鑑定スキルで成り上がる(第3期)」与
- * 「転生貴族、鑑定スキルで成り上がる 第3期」这类写法差异不影响匹配。
+ * 目的是让「転生貴族、鑑定スキルで成り上がる(第3期)」与「… 第3期」这类写法差异不影响匹配。
  */
 export declare function normalizeTitle(value: unknown): string;
 /** 一条待匹配的作品信息 */
@@ -64,8 +56,7 @@ export interface TitleMatch {
 }
 /**
  * 在候选里挑出与目标最匹配的一个。
- *
  * 返回 null 表示没有候选满足硬条件——此时应当**放弃匹配**，退回周期规则的推算，
- * 而不是猜一个「看起来像」的。
+ * 而不是猜一个近似的候选。
  */
 export declare function matchByTitle(target: MatchTarget, candidates: MatchCandidate[]): TitleMatch | null;

package/lib/data/anilist-match.js

@@ -1,17 +1,11 @@
 "use strict";
 /**
- * 按标题把条目匹配到 AniList。
+ * 按标题把条目匹配到 AniList。用于运行时给「没带 `aniList` ID」的条目补 ID
+ * （`services/airing.ts`），以及维护脚本 `scripts/match-anilist.ts` 生成离线映射表。
  *
- * 用于两处：
- * - 运行时给「bangumi-data 没带 `aniList` ID」的条目补 ID（`services/airing.ts`）；
- * - 维护脚本 `scripts/match-anilist.ts` 生成离线映射表。
- *
- * 判定标准分两级：
- * - **硬条件**：标题归一化后相等（含 AniList 的 `synonyms`）+ 首播日期相差不超过
- *   `MAX_DAY_GAP` 天。前者排除无关条目，后者排除同名的不同季。
- * - **软条件**：播出时刻相差不超过 `MAX_HOUR_GAP` 小时。AniList 记的是「某一时刻可以看」，
- *   与日本电视档期本来就可能差几小时（配信早于电视），因此只用来提示「档期需订正」，
- *   不作为匹配是否成立的条件。
+ * **硬条件**（决定匹配是否成立）：标题归一化后相等（含 `synonyms`）且首播日期相差不超过
+ * `MAX_DAY_GAP` 天。**软条件**：播出时刻相差不超过 `MAX_HOUR_GAP` 小时——AniList 记的是
+ * 「某一时刻可以看」，与电视档期可能差几小时，只用于提示「档期需订正」。
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MAX_HOUR_GAP = exports.MAX_DAY_GAP = void 0;
@@ -25,9 +19,7 @@ const HOUR = 3600000;
 const DAY = 86400000;
 /**
  * 归一化标题：去空白与标点、全角转半角、罗马数字统一、去季度后缀。
- *
- * 目的是让「転生貴族、鑑定スキルで成り上がる(第3期)」与
- * 「転生貴族、鑑定スキルで成り上がる 第3期」这类写法差异不影响匹配。
+ * 目的是让「転生貴族、鑑定スキルで成り上がる(第3期)」与「… 第3期」这类写法差异不影响匹配。
  */
 function normalizeTitle(value) {
     return String(value ?? '')
@@ -46,9 +38,8 @@ function startMsOf(candidate) {
 }
 /**
  * 在候选里挑出与目标最匹配的一个。
- *
  * 返回 null 表示没有候选满足硬条件——此时应当**放弃匹配**，退回周期规则的推算，
- * 而不是猜一个「看起来像」的。
+ * 而不是猜一个近似的候选。
  */
 function matchByTitle(target, candidates) {
     const wanted = normalizeTitle(target.title);

package/lib/data/bangumi-data-loader.js

@@ -2,11 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BangumiDataLoader = void 0;
 /**
- * bangumi-data 的取数层。
- *
- * 数据来自 npm 包 `bangumi-data`（`main` 指向 `dist/data.json`），随插件一起安装、
- * 无需联网；只有包缺失时才依次回退到磁盘缓存与 CDN 镜像。
- *
+ * bangumi-data 的取数层。数据来自 npm 包 `bangumi-data`（随插件一起安装、无需联网），
+ * 只有包缺失时才依次回退到磁盘缓存与 CDN 镜像。
  * 这一层只负责「把 item 列表拿回来」，不解析、不建索引。
  */
 const fs_1 = require("fs");