koishi-plugin-anime-schedule 1.0.6 → 1.0.8

package/lib/config.js

@@ -93,7 +93,7 @@ exports.Config = koishi_1.Schema.intersect([
                 .description('单张图片最多加载多少张封面，0 为不限制')
                 .default(0),
             showCover: koishi_1.Schema.boolean().description('显示封面').default(true),
-            showScore: koishi_1.Schema.boolean().description('显示评分').default(true),
+            showScore: koishi_1.Schema.boolean().description('显示评分，评价不足 10 人时不显示').default(true),
             useForward: koishi_1.Schema.boolean()
                 .description('纯文本模式使用合并转发，避免刷屏')
                 .default(true),
@@ -113,8 +113,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)

package/lib/constants.d.ts

@@ -260,6 +260,30 @@ export interface Messages {
     subscribedBadge: string;
     /** 日期列超出上限时的提示 */
     moreItems: (count: number) => string;
+    /** 详情卡页脚的数据更新时间 */
+    infoUpdated: (moment: string) => string;
+    /** 连载状态 */
+    infoAiring: string;
+    infoFinished: string;
+    infoUpcoming: string;
+    infoUnknown: string;
+    /** 区块标题 */
+    infoSummary: string;
+    infoProgress: string;
+    infoScoreBoard: string;
+    /** 单位与占位文案 */
+    infoVotes: string;
+    infoEpisodes: string;
+    infoAired: string;
+    /** 详情里「下一话」的标签 */
+    infoNext: string;
+    /** 拿不到评分或档期时的占位 */
+    infoNoScore: string;
+    infoNoSchedule: string;
+    /** 搜索结果的标题行 */
+    searchHeader: (count: number, keyword: string) => string;
+    /** 时间轴上「现在」的分界线标签 */
+    nowLabel: (clock: string) => string;
 }
 export declare const MESSAGES: Record<PluginLocale, Messages>;
 export declare function getMessages(locale: PluginLocale): Messages;

package/lib/constants.js

@@ -286,6 +286,22 @@ const ZH_CN = {
     todayBadge: '今天',
     subscribedBadge: '已订阅',
     moreItems: (count) => `还有 ${count} 部`,
+    infoUpdated: (moment) => `数据更新于 ${moment}`,
+    infoAiring: '连载中',
+    infoFinished: '已完结',
+    infoUpcoming: '未开播',
+    infoUnknown: '状态未知',
+    infoSummary: '简介',
+    infoProgress: '放送进度',
+    infoScoreBoard: '评分分布',
+    infoVotes: '人评分',
+    infoEpisodes: '话',
+    infoAired: '已播出',
+    infoNext: '下一话',
+    infoNoScore: '评分人数不足',
+    infoNoSchedule: '暂无逐集档期',
+    nowLabel: (clock) => `现在 ${clock}`,
+    searchHeader: (count, keyword) => `找到 ${count} 部与 "${keyword}" 相关的作品，用 \`anime.info <序号>\` 看详情、\`anime.sub <序号>\` 订阅:`,
 };
 const JA_JP = {
     ...ZH_CN,
@@ -315,6 +331,22 @@ const JA_JP = {
     todayBadge: '今日',
     subscribedBadge: '登録済み',
     moreItems: (count) => `他 ${count} 作品`,
+    infoUpdated: (moment) => `データ更新 ${moment}`,
+    infoAiring: '放送中',
+    infoFinished: '完結',
+    infoUpcoming: '放送前',
+    infoUnknown: '状態不明',
+    infoSummary: 'あらすじ',
+    infoProgress: '放送進捗',
+    infoScoreBoard: 'スコア分布',
+    infoVotes: '人評価',
+    infoEpisodes: '話',
+    infoAired: '放送済み',
+    infoNext: '次回',
+    infoNoScore: '評価者不足',
+    infoNoSchedule: '話数情報なし',
+    nowLabel: (clock) => `現在 ${clock}`,
+    searchHeader: (count, keyword) => `「${keyword}」に一致する作品が ${count} 件。\`anime.info <番号>\` で詳細、\`anime.sub <番号>\` で登録:`,
 };
 const EN_US = {
     ...ZH_CN,
@@ -344,6 +376,22 @@ const EN_US = {
     todayBadge: 'Today',
     subscribedBadge: 'Subscribed',
     moreItems: (count) => `+${count} more`,
+    infoUpdated: (moment) => `Updated ${moment}`,
+    infoAiring: 'Airing',
+    infoFinished: 'Finished',
+    infoUpcoming: 'Upcoming',
+    infoUnknown: 'Unknown',
+    infoSummary: 'Synopsis',
+    infoProgress: 'Progress',
+    infoScoreBoard: 'Score distribution',
+    infoVotes: 'ratings',
+    infoEpisodes: 'eps',
+    infoAired: 'Aired',
+    infoNext: 'Next',
+    infoNoScore: 'Too few ratings',
+    infoNoSchedule: 'No episode schedule',
+    nowLabel: (clock) => `Now ${clock}`,
+    searchHeader: (count, keyword) => `Found ${count} titles matching "${keyword}". Use \`anime.info <n>\` for details or \`anime.sub <n>\` to subscribe:`,
 };
 exports.MESSAGES = {
     'zh-CN': ZH_CN,

package/lib/handlers.d.ts

@@ -1,6 +1,7 @@
-import { Context, Logger, Session } from 'koishi';
+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';
 /** 指令层依赖集合 */
 export interface HandlerContext {
@@ -9,6 +10,8 @@ export interface HandlerContext {
     logger: Logger;
     digest: DigestService;
     renderer: Renderer;
+    /** 单部作品详情（`anime.info`），与推送路径无关，只服务交互查询 */
+    info: InfoService;
 }
 /** 手动查看当日更新表，`offset` 为相对今天的日期偏移 */
 export declare function commandToday(deps: HandlerContext, session: Session, offset?: number): Promise<void>;
@@ -32,6 +35,13 @@ export declare function commandPush(deps: HandlerContext, session: Session, kind
 export declare function commandSearch(deps: HandlerContext, session: Session, keyword: string, options?: {
     limit?: number;
 }): Promise<string | void>;
+/**
+ * 单部作品详情。
+ *
+ * 目标可以是 Bangumi 条目 ID，也可以是上一次搜索结果里的序号（与 `anime.sub` 同一套解析），
+ * 因此「搜索 → 看详情 → 订阅」是一条连贯的路径。
+ */
+export declare function commandInfo(deps: HandlerContext, session: Session, target: string): Promise<string | h | void>;
 /**
  * 查看本群订阅列表。
  *

package/lib/handlers.js

@@ -6,6 +6,7 @@ exports.commandWeekly = commandWeekly;
 exports.commandSeason = commandSeason;
 exports.commandPush = commandPush;
 exports.commandSearch = commandSearch;
+exports.commandInfo = commandInfo;
 exports.commandSubList = commandSubList;
 exports.commandSubAdd = commandSubAdd;
 exports.commandSubRemove = commandSubRemove;
@@ -17,6 +18,7 @@ exports.commandStatus = commandStatus;
 const koishi_1 = require("koishi");
 const constants_1 = require("./constants");
 const dispatch_1 = require("./services/dispatch");
+const text_1 = require("./render/text");
 const time_1 = require("./utils/time");
 const utils_1 = require("./utils");
 const KIND_ALIASES = {
@@ -69,6 +71,21 @@ function writeSearchCache(session, items) {
 function channelOf(session) {
     return session.channelId ?? '';
 }
+/**
+ * 把索引层给内部的来源说法翻成用户能读的短句。
+ *
+ * `BangumiDataIndex.source` 返回的是 `本地依赖包` / `磁盘缓存` / `CDN 镜像` 这类
+ * **面向日志**的词，直接摆到 `anime.status` 里用户看不懂，也判断不出该不该在意
+ * ——正常情况是"随插件内置"，出现另外两种才值得看一眼。
+ */
+function describeIndexSource(source) {
+    switch (source) {
+        case '本地依赖包': return '随插件内置 (bangumi-data)';
+        case '磁盘缓存': return '本地磁盘缓存 (bangumi-data)';
+        case 'CDN 镜像': return '已从远程更新 (bangumi-data)';
+        default: return source || '未知';
+    }
+}
 function platformOf(session) {
     return session.platform ?? '';
 }
@@ -84,6 +101,7 @@ async function replyDigest(deps, session, digest) {
         try {
             const buffer = await renderer.render({
                 kind: digest.kind,
+                now: digest.generatedAt,
                 header: digest.header,
                 summary: digest.summary,
                 groups: digest.groups,
@@ -237,24 +255,65 @@ async function commandSearch(deps, session, keyword, options = {}) {
         if (!items.length)
             return constants_1.RESPONSES.emptySearch(query);
         writeSearchCache(session, items);
-        const lines = items.map((item, index) => {
-            const when = item.firstYear
-                ? `${item.firstYear}-${String(item.firstMonth ?? 1).padStart(2, '0')}`
-                : '档期未知';
-            const meta = [when, item.type ? item.type.toUpperCase() : ''].filter(Boolean).join(' · ');
-            // 显示纯数字 ID，与 `anime.sub <ID>` 的写法一致，便于直接复制
-            return `${index + 1}. [ID:${item.bgmId ?? '-'}] ${(0, utils_1.truncate)(item.name, 60)}\n    ${meta}`;
-        });
-        return [
-            `找到 ${items.length} 部与 "${query}" 相关的作品，使用 \`anime.sub <ID>\` 或结果序号订阅:`,
-            ...lines,
-        ].join('\n');
+        // 只给文本列表（带评分与档期），不逐条渲染详情卡：
+        // 一次搜索常有十来个结果，十张卡片刷屏反而看不出哪个是哪个。
+        // 想看详情时用 `anime.info <序号>` 或直接点 ID。
+        return (0, text_1.renderSearchText)(items, query, deps.config);
     }
     catch (error) {
         deps.logger.warn('[command] 搜索失败:', error);
         return `搜索失败。${(0, utils_1.formatNetworkError)(error)}`;
     }
 }
+/**
+ * 单部作品详情。
+ *
+ * 目标可以是 Bangumi 条目 ID，也可以是上一次搜索结果里的序号（与 `anime.sub` 同一套解析），
+ * 因此「搜索 → 看详情 → 订阅」是一条连贯的路径。
+ */
+async function commandInfo(deps, session, target) {
+    const raw = (target ?? '').trim();
+    if (!raw)
+        return '用法: anime.info <Bangumi 条目 ID 或搜索结果序号>';
+    let bgmId = null;
+    if (BGM_ID.test(raw)) {
+        bgmId = Number(raw);
+    }
+    else {
+        // 不是纯数字就当作搜索关键词，省掉「先 search 再 info」这一步
+        const items = await deps.digest.search(raw, 1);
+        bgmId = items[0]?.bgmId ?? null;
+        if (bgmId === null)
+            return constants_1.RESPONSES.notFound;
+    }
+    await session.send((0, koishi_1.h)('quote', { id: session.messageId }) + `正在查询 ID:${bgmId}...`);
+    try {
+        const subscribed = await isSubscribed(deps, session, `bgm:${bgmId}`);
+        const detail = await deps.info.fetch(bgmId, subscribed);
+        if (!detail)
+            return constants_1.RESPONSES.notFound;
+        if (deps.config.output.format !== 'image')
+            return (0, text_1.renderInfoText)(detail, deps.config);
+        try {
+            const buffer = await deps.renderer.renderInfo(detail);
+            return koishi_1.h.image(buffer, 'image/jpeg');
+        }
+        catch (error) {
+            // 与推送表同样兜底：出图失败就退回文本，不让用户拿到一个错误
+            deps.logger.warn('[command] 详情出图失败，改用文本:', error);
+            return (0, text_1.renderInfoText)(detail, deps.config);
+        }
+    }
+    catch (error) {
+        deps.logger.warn('[command] 查询作品详情失败:', error);
+        return `查询失败。${(0, utils_1.formatNetworkError)(error)}`;
+    }
+}
+/** 该作品是否已被本群订阅 */
+async function isSubscribed(deps, session, tid) {
+    const rows = await deps.digest.listSubscriptions(platformOf(session), channelOf(session));
+    return rows.some((row) => row.tid === tid);
+}
 // #endregion
 // #region 订阅管理
 /**
@@ -493,7 +552,9 @@ async function commandStatus(deps, session) {
             `时区: ${config.timeZone} (当前 ${(0, time_1.formatDate)(Date.now(), config.timeZone)})`,
             `推送形态: ${formatText}`,
             `本地化: ${digest.localizer.enabled ? `已开启 (${config.localize.titleStyle})` : '已关闭'}`,
-            `数据来源: bangumi-data (${digest.index.size} 部) / Bangumi`,
+            // 用索引层的真实来源，不写死：`bangumi-data` 取不到时会退化为远程拉取，
+            // 而状态页正是用来诊断这种情况的，文案必须跟着变
+            `数据来源: ${describeIndexSource(digest.index.source)} (${digest.index.size} 部) / Bangumi`,
             `推送时刻: ${describeTimes(config)}`,
             `开关状态: 每日 ${channel?.dailyEnabled ? '开' : '关'} / 深夜档 ${channel?.nightEnabled ? '开' : '关'} / 本周 ${channel?.weeklyEnabled ? '开' : '关'} / 本季 ${channel?.seasonEnabled ? '开' : '关'}`,
             `订阅番剧: ${subscriptions.length} 部${config.subscription.maxPerChannel > 0 ? ` (上限 ${config.subscription.maxPerChannel})` : ''}`,

package/lib/index.js

@@ -14,6 +14,7 @@ const dispatch_1 = require("./services/dispatch");
 const scheduler_1 = require("./services/scheduler");
 const image_1 = require("./render/image");
 const handlers_1 = require("./handlers");
+const info_1 = require("./services/info");
 const utils_1 = require("./utils");
 const time_1 = require("./utils/time");
 /** 把时区偏移写成 `+8` / `-3` 这样的短文本，用于日志与图片页眉 */
@@ -23,32 +24,32 @@ function formatOffset(timeZone) {
 }
 exports.name = constants_1.PLUGIN_NAME;
 exports.inject = { required: ['database', 'http'] };
-exports.usage = `
-番剧更新表与订阅提醒。作品清单来自 [bangumi-data](https://github.com/bangumi-data/bangumi-data)，
-排期、封面查询 [AniList](https://anilist.co/)，中文标题、封面与评分取自 [Bangumi](https://bgm.tv/)。
-
-在群聊里执行一次 \`anime.on\` 后开始接收定时推送。
-
-| 指令 | 别名 | 说明 |
-| :--- | :--- | :--- |
-| \`anime.today\` | 今日新番 | 今日更新表，\`-o -1\` 看前一天 |
-| \`anime.night\` | 深夜新番 | 今晚 21:00 至次日 06:00 |
-| \`anime.week\` | 本周新番 | 今天起七天 |
-| \`anime.season [季度]\` | 本季新番 | 本季一览，也可查往季 |
-| \`anime.search <关键词>\` | 番剧搜索 | 中日英文标题都能搜 |
-| \`anime.sub <ID>\` | 番剧订阅 | 用 Bangumi 条目 ID 订阅 |
-| \`anime.remove <ID>\` | 取消订阅 | 也接受订阅列表里的序号 |
-| \`anime.list\` | 订阅列表 | 本群订阅的番剧 |
-| \`anime.clear\` | 清空订阅 | 清空本群订阅 |
-| \`anime.next [天数]\` | 追番计划 | 订阅作品未来排期 |
-| \`anime.on\` / \`anime.off\` | 开启推送 / 关闭推送 | 本群定时推送开关 |
-| \`anime.status\` | 推送状态 | 本群推送状态 |
-| \`anime.push <类型>\` | 立即推送 | 手动发一次推送 |
-
-每日、深夜档与本周只列还在播的作品，本季表收录该季首播的全部 TV / WEB 动画。
-卡片上的 \`ID:xxx\` 可直接用于订阅。
-
-若无法获取封面图和评分，请尝试配置 proxy-agent 代理设置。
+exports.usage = `
+番剧更新表与订阅提醒。作品清单来自 [bangumi-data](https://github.com/bangumi-data/bangumi-data)，
+排期、封面查询 [AniList](https://anilist.co/)，中文标题、封面与评分取自 [Bangumi](https://bgm.tv/)。
+
+在群聊里执行一次 \`anime.on\` 后开始接收定时推送。
+
+| 指令 | 别名 | 说明 |
+| :--- | :--- | :--- |
+| \`anime.today\` | 今日新番 | 今日更新表，\`-o -1\` 看前一天 |
+| \`anime.night\` | 深夜新番 | 今晚 21:00 至次日 06:00 |
+| \`anime.week\` | 本周新番 | 今天起七天 |
+| \`anime.season [季度]\` | 本季新番 | 本季一览，也可查往季 |
+| \`anime.search <关键词>\` | 番剧搜索 | 中日英文标题都能搜 |
+| \`anime.sub <ID>\` | 番剧订阅 | 用 Bangumi 条目 ID 订阅 |
+| \`anime.remove <ID>\` | 取消订阅 | 也接受订阅列表里的序号 |
+| \`anime.list\` | 订阅列表 | 本群订阅的番剧 |
+| \`anime.clear\` | 清空订阅 | 清空本群订阅 |
+| \`anime.next [天数]\` | 追番计划 | 订阅作品未来排期 |
+| \`anime.on\` / \`anime.off\` | 开启推送 / 关闭推送 | 本群定时推送开关 |
+| \`anime.status\` | 推送状态 | 本群推送状态 |
+| \`anime.push <类型>\` | 立即推送 | 手动发一次推送 |
+
+每日、深夜档与本周只列还在播的作品，本季表收录该季首播的全部 TV / WEB 动画。
+卡片上的 \`ID:xxx\` 可直接用于订阅。
+
+若无法获取封面图和评分，请尝试配置 proxy-agent 代理设置。
 `;
 const logger = new koishi_1.Logger(constants_1.PLUGIN_NAME);
 function apply(ctx, rawConfig) {
@@ -98,6 +99,8 @@ function apply(ctx, rawConfig) {
     const digest = new digest_1.DigestService(ctx, config, logger, index, airing);
     const renderer = new image_1.Renderer(ctx, config, logger, http);
     const guard = new dispatch_1.DispatchGuard(ctx, logger);
+    // 单部作品详情：只服务 `anime.info` 的交互查询，不参与推送
+    const infos = new info_1.InfoService(ctx, logger, http, digest.localizer, config.timeZone, (0, constants_1.getMessages)(config.locale));
     // 立刻开始载入：读的是本地依赖包，通常几十毫秒；
     // 与插件启动并行，指令和推送在构建前会 await 它，不会出现「索引还没好」的空窗。
     const indexReady = index.ensure();
@@ -107,6 +110,7 @@ function apply(ctx, rawConfig) {
     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,
@@ -121,7 +125,7 @@ function apply(ctx, rawConfig) {
             logger.debug('[lifecycle] 清理已完结订阅失败: %s', (0, utils_1.errorMessage)(error));
         });
     });
-    const deps = { ctx, config, logger, digest, renderer };
+    const deps = { ctx, config, logger, digest, renderer, info: infos };
     registerCommands(ctx, deps);
     ctx.on('ready', async () => {
         try {
@@ -221,6 +225,18 @@ function registerCommands(ctx, deps) {
             return;
         return (0, handlers_1.commandSearch)(deps, session, keyword ?? '', { limit: options?.limit });
     });
+    cmd.subcommand('.info <target:string>', '查看番剧详情')
+        .alias('番剧详情', '番剧信息', '详情')
+        .usage('参数是 Bangumi 条目 ID，或 `anime.search` 结果中的序号，也可以直接给标题关键词。'
+        + '以图片推送，渲染失败或设置为文本模式时改成文字。')
+        .example('anime.info 400602      # 葬送的芙莉莲')
+        .example('anime.info 3           # 搜索结果里的第 3 条')
+        .example('anime.info 芙莉莲       # 直接按标题查')
+        .action(async ({ session }, target) => {
+        if (!session)
+            return;
+        return (0, handlers_1.commandInfo)(deps, session, target ?? '');
+    });
     cmd.subcommand('.sub <target:string>', '订阅一部番剧')
         .alias('番剧订阅', '订阅番剧', '订阅添加', '添加订阅')
         .usage('参数是 Bangumi 条目 ID（季表卡片上的 `ID:253104`），也可以是 `anime.search` 结果中的序号。')

package/lib/render/covers.d.ts

@@ -1,6 +1,6 @@
 import { type Canvas } from '@napi-rs/canvas';
 import type { Context, Logger } from 'koishi';
-import type { DigestItem } from '../types';
+import type { CoverRequest } from '../types';
 import { HttpClient } from '../services/network';
 /**
  * 封面加载器。
@@ -29,7 +29,7 @@ export declare class CoverStore {
      *
      * `limit` 为 0 表示**不限制**，与「不加载」含义相反，因此早退判断只看 `items` 是否为空。
      */
-    load(items: DigestItem[], limit: number): Promise<Map<string, Canvas | null>>;
+    load(items: CoverRequest[], limit: number): Promise<Map<string, Canvas | null>>;
     /** 单个封面：内存缓存 → 磁盘缓存 → 网络 */
     private loadOne;
     private fetchAndDecode;

package/lib/render/image.d.ts

@@ -2,22 +2,7 @@ import { HttpClient } from '../services/network';
 import type { Context, Logger } from 'koishi';
 import type { Config } from '../config';
 import type { RenderPayload } from '../types';
-/**
- * 风格化图片渲染器。
- *
- * 四种版面共用同一套版式规则：页眉是标题 + 副标题 + 统计 + 时区，页脚是数据来源；
- * 卡片文字顺序与配色统一为「标题 → 时间 → `ID:xxx` → 评分」。
- *
- * | 版面 | 用于 |
- * | :--- | :--- |
- * | 单日时间轴 | 每日 / 深夜档 |
- * | 七日周历 | 本周 |
- * | 卡片列表 | `output.layout = list` |
- * | 封面网格 | 本季，固定每行 10 部 |
- *
- * 封面统一按 `1 : 1.4` 等比完整显示，文字块的竖直位置只由版式常量决定，
- * 因此同一版面的每一条都对齐在同一条基线上。
- */
+import type { SubjectInfo } from '../services/info';
 export declare class Renderer {
     private config;
     private logger;
@@ -30,6 +15,13 @@ export declare class Renderer {
     init(): void;
     private get messages();
     render(payload: RenderPayload): Promise<Buffer>;
+    /**
+     * 渲染单部作品的详情卡（`anime.info`）。
+     *
+     * 与推送表共用同一份封面缓存与字体，但排版完全独立——见 `render/info.ts`。
+     * 封面单独取一张，不复用推送表的批量加载。
+     */
+    renderInfo(info: SubjectInfo): Promise<Buffer>;
     private draw;
     /** 空白画布：统一底色 */
     private createSurface;
@@ -72,6 +64,16 @@ export declare class Renderer {
      * 跨过午夜时在轨道上插一个日期节点，读者不会把凌晨场次误认成当天上午。
      */
     private drawTimeline;
+    /**
+     * 时间轴上的「现在」分界线。
+     *
+     * 画成一条横贯的虚线 + 右端的时刻，读者一眼就能看出上下哪边已经播了。
+     * 参考 bangumi.online 的播出时间轴：没有这条线时，`00:00` 的场次和 `23:00` 的场次
+     * 长得一模一样，用户得自己对表才知道现在几点。
+     *
+     * @returns 画完之后的新光标位置（线自己占一段高度）
+     */
+    private drawNowMarker;
     /** 时间轴上的日期节点：圆点 + 日期 + 条目数 */
     private drawTimelineDayHeader;
     /** 时间轴主线，首条之上不画线 */

package/lib/render/image.js

@@ -6,6 +6,7 @@ const constants_1 = require("../constants");
 const fonts_1 = require("./fonts");
 const covers_1 = require("./covers");
 const time_1 = require("../utils/time");
+const info_1 = require("./info");
 const canvas_2 = require("./canvas");
 /**
  * 风格化图片渲染器。
@@ -23,6 +24,8 @@ const canvas_2 = require("./canvas");
  * 封面统一按 `1 : 1.4` 等比完整显示，文字块的竖直位置只由版式常量决定，
  * 因此同一版面的每一条都对齐在同一条基线上。
  */
+/** 「现在」分界线占用的高度，与 drawNowMarker 保持一致 */
+const NOW_MARKER_HEIGHT = 26;
 class Renderer {
     config;
     logger;
@@ -54,6 +57,29 @@ class Renderer {
         this.logger.debug('[render] %s 出图完成 (%dms)，尺寸 %dx%d，%d bytes (jpeg q=%d)', payload.kind, Date.now() - started, canvas.width, canvas.height, encoded.length, this.config.render.jpegQuality);
         return encoded;
     }
+    /**
+     * 渲染单部作品的详情卡（`anime.info`）。
+     *
+     * 与推送表共用同一份封面缓存与字体，但排版完全独立——见 `render/info.ts`。
+     * 封面单独取一张，不复用推送表的批量加载。
+     */
+    async renderInfo(info) {
+        this.init();
+        const started = Date.now();
+        const covers = await this.covers.load([info], 1);
+        const cover = covers.get(info.coverUrl) ?? null;
+        const card = (0, info_1.renderInfoCard)({
+            info,
+            messages: this.messages,
+            cover,
+            footer: this.messages.infoUpdated((0, time_1.formatMoment)(Date.now(), this.config.timeZone, this.messages.weekdayNames)),
+        });
+        const canvas = (0, canvas_1.createCanvas)(card.width, card.height);
+        card.draw(canvas.getContext('2d'));
+        const encoded = await canvas.encode('jpeg', this.config.render.jpegQuality);
+        this.logger.debug('[render] info 出图完成 (%dms)，尺寸 %dx%d，%d bytes', Date.now() - started, card.width, card.height, encoded.length);
+        return encoded;
+    }
     async draw(payload) {
         if (payload.kind === 'season' && this.config.output.layout !== 'list')
             return this.drawSeason(payload);
@@ -198,21 +224,32 @@ class Renderer {
         const width = L.timelineWidth;
         // 只有一组时不画日期节点，高度按实际结构计算
         const showDayHeader = groups.length > 1;
+        // 「现在」分界线自己占一段高度，只有单日/深夜档会画
+        const showNow = payload.kind !== 'weekly';
         const height = L.headerHeight
             + all.length * (L.rowHeight + L.rowGap)
             + (showDayHeader ? groups.length * L.timelineDayHeaderHeight : 0)
+            + (showNow ? NOW_MARKER_HEIGHT : 0)
             + L.footerHeight;
         const { canvas, ctx } = this.createSurface(width, height);
         this.drawHeader(ctx, payload, width);
         const spineX = L.padding + L.timelineSpine;
         let cursor = L.headerHeight + L.rowGap;
         let index = 0;
+        let nowDrawn = false;
         for (const group of groups) {
             if (showDayHeader) {
                 this.drawTimelineDayHeader(ctx, group, spineX, cursor, width - L.padding - spineX);
                 cursor += L.timelineDayHeaderHeight;
             }
             for (const item of group.items) {
+                // 画在第一条尚未播出的条目之前；全部已播时画在末尾。
+                // 插入前先把光标下移半个行距，让虚线落在「上一条卡片底」与「下一条卡片顶」的正中，
+                // 而不是紧贴上一条。标记自带的高度正好抵掉这半个行距，总高因此不必重算。
+                if (showNow && !nowDrawn && item.atMs > payload.now) {
+                    nowDrawn = true;
+                    cursor = this.drawNowMarker(ctx, payload.now, spineX, cursor + L.rowGap / 2, width);
+                }
                 const y = cursor;
                 this.drawTimelineSpine(ctx, spineX, y - L.rowGap, y + L.rowHeight, index === 0);
                 this.drawTimelineEntry(ctx, item, covers.get(item.coverUrl) ?? null, spineX, y, width, night);
@@ -220,9 +257,56 @@ class Renderer {
                 index++;
             }
         }
+        if (showNow && !nowDrawn) {
+            this.drawNowMarker(ctx, payload.now, spineX, cursor, width);
+        }
         this.drawFooter(ctx, payload, width, height);
         return canvas;
     }
+    /**
+     * 时间轴上的「现在」分界线。
+     *
+     * 画成一条横贯的虚线 + 右端的时刻，读者一眼就能看出上下哪边已经播了。
+     * 参考 bangumi.online 的播出时间轴：没有这条线时，`00:00` 的场次和 `23:00` 的场次
+     * 长得一模一样，用户得自己对表才知道现在几点。
+     *
+     * @returns 画完之后的新光标位置（线自己占一段高度）
+     */
+    drawNowMarker(ctx, now, spineX, y, width) {
+        const L = constants_1.IMAGE_LAYOUT;
+        const height = NOW_MARKER_HEIGHT;
+        const centreY = y + height / 2;
+        // 左端圆点：与时间轴的圆点同一尺寸，视觉上属于同一条轴
+        ctx.beginPath();
+        ctx.arc(spineX, centreY, 5, 0, Math.PI * 2);
+        ctx.fillStyle = canvas_2.THEME.accent;
+        ctx.fill();
+        ctx.lineWidth = 2.5;
+        ctx.strokeStyle = canvas_2.THEME.surface;
+        ctx.stroke();
+        const left = spineX + 14;
+        const right = width - L.padding;
+        ctx.save();
+        ctx.setLineDash([4, 4]);
+        ctx.lineWidth = 1.5;
+        ctx.strokeStyle = canvas_2.THEME.accent;
+        ctx.beginPath();
+        ctx.moveTo(left, centreY);
+        ctx.lineTo(right, centreY);
+        ctx.stroke();
+        ctx.restore();
+        // 时刻压在虚线上、靠右，底色垫一层让线条不穿过文字
+        const label = this.messages.nowLabel((0, time_1.formatClock)(now, this.config.timeZone));
+        ctx.font = (0, fonts_1.font)(fonts_1.FONT_SIZE.cardMeta, true);
+        const textWidth = ctx.measureText(label).width;
+        const boxX = right - textWidth - 10;
+        (0, canvas_2.fillRoundRect)(ctx, boxX, centreY - 9, textWidth + 10, 18, 9, canvas_2.THEME.surface);
+        ctx.fillStyle = canvas_2.THEME.accent;
+        ctx.textAlign = 'left';
+        ctx.textBaseline = 'middle';
+        ctx.fillText(label, boxX + 5, centreY + 0.5);
+        return y + height;
+    }
     /** 时间轴上的日期节点：圆点 + 日期 + 条目数 */
     drawTimelineDayHeader(ctx, group, spineX, y, width) {
         const L = constants_1.IMAGE_LAYOUT;

package/lib/render/info.d.ts

@@ -0,0 +1,49 @@
+import type { SKRSContext2D } from '@napi-rs/canvas';
+import type { SubjectInfo } from '../services/info';
+import type { Messages } from '../constants';
+/** 卡片需要的全部素材 */
+export interface InfoCard {
+    info: SubjectInfo;
+    messages: Messages;
+    cover: {
+        width: number;
+        height: number;
+    } | null;
+    /** 页脚的时间戳文案，如 `数据更新于 2026/10/12 20:00` */
+    footer: string;
+}
+/**
+ * 作品详情卡。
+ *
+ * ## 布局
+ *
+ * ```
+ * ┌────────┬──────────────────────────────────────┐
+ * │        │ 葬送的芙莉莲              [已订阅]    │
+ * │ 封面   │ 葬送のフリーレン                      │
+ * │        │ ★ 8.52   36553 人评分                │
+ * │        │ [TV] [2023/9/29周五] [已完结]         │
+ * ├────────┴──────────────────────────────────────┤
+ * │ 简介                                          │
+ * │ 魔法使芙莉莲和勇者辛美尔……                    │
+ * ├───────────────────┬───────────────────────────┤
+ * │ 放送进度  28/28   │ 评分分布                  │
+ * │ ①②③④⑤⑥…        │         ▂▅▇▆▃             │
+ * └───────────────────┴───────────────────────────┘
+ * ```
+ *
+ * 几个刻意的取舍：
+ *
+ * - **右栏有多少内容算多少**，不钉死高度——卡片整体高度由封面与右栏较高者决定。
+ *   参考图那版右栏下方留了一大片空白，是因为把右栏高度也写死了。
+ * - **逐集进度用带底色的方格**而不是大圆角按钮：一季 12 话只需一行，半年番 24 话两行，
+ *   纵向占用少很多。已播用强调色实心，未播用浅灰。
+ * - **评分分布与逐集进度并排**，共用 `bandHeight` 这条基线，省掉一个垂直区块。
+ * - 话数超过 `epGridMax`（长期连载番）时**不铺格子**，只给一行 `已播 N 话` 文案，
+ *   否则 2852 话会画出上百行。
+ */
+export declare function renderInfoCard(card: InfoCard): {
+    width: number;
+    height: number;
+    draw: (ctx: SKRSContext2D) => void;
+};