koishi-plugin-anime-schedule 1.0.1 → 1.0.3

package/lib/handlers.js

@@ -406,16 +406,18 @@ async function commandNext(deps, session, daysText) {
         const airings = await digest.upcomingAirings(rows.map((row) => row.tid), days);
         if (!airings.length)
             return `未来 ${days} 天内订阅的作品没有播出计划。`;
-        const weekdayNames = (0, constants_1.getMessages)(config.locale).weekdayNames;
+        const messages = (0, constants_1.getMessages)(config.locale);
         const lines = [];
         let currentDate = '';
         for (const item of airings) {
             if (item.date !== currentDate) {
                 currentDate = item.date;
-                const weekday = weekdayNames[(0, time_1.getLocalWeekday)((0, time_1.getDayStartMs)(item.date, digest.timeZone), digest.timeZone)] ?? '';
-                lines.push(`【${item.date} ${weekday}】`.trimEnd());
+                const weekday = messages.weekdayNames[(0, time_1.getLocalWeekday)((0, time_1.getDayStartMs)(item.date, digest.timeZone), digest.timeZone)] ?? '';
+                // 分组标题前留一个空行，与推送表的分组观感一致
+                lines.push(`${lines.length ? '\n' : ''}【${item.date} ${weekday}】`.trimEnd());
             }
-            lines.push(`· ${item.time} ${(0, utils_1.truncate)(item.name, 60)} (${item.episode})`);
+            const episode = item.recurring && item.episodeCount > 0 ? messages.episodeUnit(item.episodeCount) : '';
+            lines.push(`${episode ? `${item.time} ${episode}` : item.time}\n  ${(0, utils_1.truncate)(item.name, 60)}`);
         }
         return [`未来 ${days} 天内订阅作品的播出计划:`, ...lines].join('\n');
     }

package/lib/render/text.d.ts

@@ -1,3 +1,42 @@
+/**
+ * 纯文本形态的渲染。
+ *
+ * 与图片形态共用同一份 `Digest`，因此两者列出的作品、时刻、集数完全一致；
+ * 差别只在**信息的排布**上——图片能靠颜色与留白分区，文本只能靠符号与缩进。
+ *
+ * ## 版式约定
+ *
+ * ```
+ * 今日番剧更新 (10/1周四)
+ * 共 7 部作品，其中 3 部为深夜档
+ *
+ * 【今日播出】
+ * 00:00 第 53 话
+ *   考拉绘日记
+ *   ID:564980  评分 5.0
+ *
+ * 00:15 第 12 话
+ *   盗墓王
+ *   ID:621835  评分 4.5
+ * ```
+ *
+ * 四条规则：
+ *
+ * 1. **一行放一个语义块**。时刻与集数留在首行（信息最密、最需要对齐），标题单独占一行
+ *    并缩进两格——中文标题动辄二三十字，和时刻挤在一行必然折行，折行后时刻就淹没在
+ *    文字里了。ID 与评分再缩进一层，便于扫读时跳过。
+ * 2. **集数走 `episodeUnit`**（`第 53 话`），不再用 `#53`。整个界面的其它地方都是中文，
+ *    `#` 是英文记法，混在一起不好读。
+ * 3. **一次性放送不显示集数**：剧场版、特别篇没有「第几话」的概念，`episodeCount` 恒为 1，
+ *    写出来是噪声。这与图片卡片的处理保持一致。
+ * 4. **条目之间空一行**。三条一组的块状结构如果首尾相连，读者分不清哪一行属于哪一部；
+ *    空行是最省字符的分隔手段，一屏仍能放下四五部。
+ *
+ * 季表用同一套版式，只把首行的时刻换成**完整日期**（`7/7周二 23:00`）——它是一览，
+ * 读者最先想知道「什么时候开播」，而条目散在整个季度里，光有时刻没法定位。相应地季表
+ * **不套分组标题**：日期已经在首行，再套一层 `【10/11周日】` 是重复信息，还会出现
+ * 「首播在 9/27 的条目落在 `【10/2周五】` 组里」（因为它下次播出在那天）这种对不上的情况。
+ */
 import { h } from 'koishi';
 import type { Config } from '../config';
 import type { Digest } from '../types';
@@ -5,7 +44,7 @@ import type { Digest } from '../types';
  * 文本形态的推送渲染。
  *
  * 返回消息元素数组，调用方按平台能力选择直接发送或合并转发：
- * 第一项是列表头 + 统计行与数据来源，其余每一项是一个分组。
+ * 第一项是列表头 + 统计行，之后每一项是一个分组，最后是数据来源。
  * 相邻元素之间插入换行，否则平台会把它们首尾拼在同一行。
  */
 export declare function renderText(config: Config, digest: Digest): h[];

package/lib/render/text.js

@@ -2,25 +2,102 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderText = renderText;
 exports.buildForward = buildForward;
+/**
+ * 纯文本形态的渲染。
+ *
+ * 与图片形态共用同一份 `Digest`，因此两者列出的作品、时刻、集数完全一致；
+ * 差别只在**信息的排布**上——图片能靠颜色与留白分区，文本只能靠符号与缩进。
+ *
+ * ## 版式约定
+ *
+ * ```
+ * 今日番剧更新 (10/1周四)
+ * 共 7 部作品，其中 3 部为深夜档
+ *
+ * 【今日播出】
+ * 00:00 第 53 话
+ *   考拉绘日记
+ *   ID:564980  评分 5.0
+ *
+ * 00:15 第 12 话
+ *   盗墓王
+ *   ID:621835  评分 4.5
+ * ```
+ *
+ * 四条规则：
+ *
+ * 1. **一行放一个语义块**。时刻与集数留在首行（信息最密、最需要对齐），标题单独占一行
+ *    并缩进两格——中文标题动辄二三十字，和时刻挤在一行必然折行，折行后时刻就淹没在
+ *    文字里了。ID 与评分再缩进一层，便于扫读时跳过。
+ * 2. **集数走 `episodeUnit`**（`第 53 话`），不再用 `#53`。整个界面的其它地方都是中文，
+ *    `#` 是英文记法，混在一起不好读。
+ * 3. **一次性放送不显示集数**：剧场版、特别篇没有「第几话」的概念，`episodeCount` 恒为 1，
+ *    写出来是噪声。这与图片卡片的处理保持一致。
+ * 4. **条目之间空一行**。三条一组的块状结构如果首尾相连，读者分不清哪一行属于哪一部；
+ *    空行是最省字符的分隔手段，一屏仍能放下四五部。
+ *
+ * 季表用同一套版式，只把首行的时刻换成**完整日期**（`7/7周二 23:00`）——它是一览，
+ * 读者最先想知道「什么时候开播」，而条目散在整个季度里，光有时刻没法定位。相应地季表
+ * **不套分组标题**：日期已经在首行，再套一层 `【10/11周日】` 是重复信息，还会出现
+ * 「首播在 9/27 的条目落在 `【10/2周五】` 组里」（因为它下次播出在那天）这种对不上的情况。
+ */
 const koishi_1 = require("koishi");
 const constants_1 = require("../constants");
 const utils_1 = require("../utils");
+/** 标题最多显示多少个字，超出补省略号（与命令里 `anime.next` 的宽度保持一致） */
+const TITLE_MAX = 60;
+function formatItem(item, season, config) {
+    const messages = (0, constants_1.getMessages)(config.locale);
+    const episode = item.recurring && item.episodeCount > 0 ? messages.episodeUnit(item.episodeCount) : '';
+    // 季表是一览，读者最先想知道「什么时候开播」，因此首行给完整日期；其余三张表按天分组，
+    // 日期已经在分组标题上，首行只留时刻。
+    const lead = season ? (item.airLabel || item.time) : item.time;
+    const lines = [episode ? `${lead} ${episode}` : lead, `  ${(0, utils_1.truncate)(item.name, TITLE_MAX)}`];
+    const parts = [];
+    if (item.bgmId !== null)
+        parts.push(`ID:${item.bgmId}`);
+    if (item.score)
+        parts.push(`评分 ${item.score}`);
+    if (item.subscribed)
+        parts.push(messages.subscribedBadge);
+    if (parts.length)
+        lines.push(`  ${parts.join('  ')}`);
+    return lines.join('\n');
+}
+/**
+ * 分组。
+ *
+ * 季表**不再按天分组**：它的条目本来就散在整个季度里，而首行已经带了完整日期，
+ * 再套一层 `【10/11周日】` 是重复信息，还会让标签与条目日期对不上（如首播在 9/27 的
+ * 条目落在 `【10/2周五】` 组里，因为它「下次播出」在那天）。
+ */
+function formatGroup(group, config, season) {
+    const body = group.items.map((item) => formatItem(item, season, config)).join('\n\n');
+    if (season || !group.label)
+        return body;
+    return `【${group.label}】\n${body}`;
+}
 /**
  * 文本形态的推送渲染。
  *
  * 返回消息元素数组，调用方按平台能力选择直接发送或合并转发：
- * 第一项是列表头 + 统计行与数据来源，其余每一项是一个分组。
+ * 第一项是列表头 + 统计行，之后每一项是一个分组，最后是数据来源。
  * 相邻元素之间插入换行，否则平台会把它们首尾拼在同一行。
  */
 function renderText(config, digest) {
-    const footer = (0, constants_1.getMessages)(config.locale).footer;
-    const head = [digest.header, digest.summary, footer].filter(Boolean).join('\n');
-    if (!digest.groups.length)
-        return [koishi_1.h.text(head)];
-    const elements = [koishi_1.h.text(head)];
+    const messages = (0, constants_1.getMessages)(config.locale);
+    const season = digest.kind === 'season';
+    if (!digest.groups.length) {
+        return [koishi_1.h.text([digest.header, digest.summary, messages.footer].filter(Boolean).join('\n'))];
+    }
+    const elements = [
+        koishi_1.h.text([digest.header, digest.summary].filter(Boolean).join('\n')),
+    ];
     for (const group of digest.groups) {
-        elements.push(koishi_1.h.text(`\n${formatGroup(group, config)}`));
+        elements.push(koishi_1.h.text(`\n${formatGroup(group, config, season)}`));
     }
+    if (messages.footer)
+        elements.push(koishi_1.h.text(`\n${messages.footer}`));
     return elements;
 }
 /**
@@ -30,28 +107,15 @@ function renderText(config, digest) {
  * 平台或适配器不支持 `message.forward` 时由调用方退回普通文本。
  */
 function buildForward(config, digest) {
-    const messages = [
+    const messages = (0, constants_1.getMessages)(config.locale);
+    const season = digest.kind === 'season';
+    const nodes = [
         (0, koishi_1.h)('message', { nickname: constants_1.DIGEST_LABELS[digest.kind] }, koishi_1.h.text([digest.header, digest.summary].filter(Boolean).join('\n'))),
     ];
     for (const group of digest.groups) {
-        messages.push((0, koishi_1.h)('message', { nickname: group.label || digest.header }, koishi_1.h.text(formatGroup(group, config))));
+        nodes.push((0, koishi_1.h)('message', { nickname: group.label || digest.header }, koishi_1.h.text(formatGroup(group, config, season))));
     }
-    const footer = (0, constants_1.getMessages)(config.locale).footer;
-    if (footer)
-        messages.push((0, koishi_1.h)('message', { nickname: '数据来源' }, koishi_1.h.text(footer)));
-    return (0, koishi_1.h)('figure', messages);
-}
-function formatGroup(group, config) {
-    const lines = [];
-    if (group.label)
-        lines.push(`【${group.label}】`);
-    for (const item of group.items)
-        lines.push(formatItem(item, config));
-    return lines.join('\n');
-}
-function formatItem(item, config) {
-    void config;
-    const score = item.score ? ` [${item.score}]` : '';
-    const id = item.bgmId === null ? '' : ` ID:${item.bgmId}`;
-    return `· ${(0, utils_1.truncate)(`${item.time} ${item.name} (${item.episode})${score}${id}`, 140)}`;
+    if (messages.footer)
+        nodes.push((0, koishi_1.h)('message', { nickname: '数据来源' }, koishi_1.h.text(messages.footer)));
+    return (0, koishi_1.h)('figure', nodes);
 }

package/lib/services/digest.d.ts

@@ -65,25 +65,19 @@ export declare class DigestService {
      * 这类作品（海螺小姐、樱桃小丸子、宝可梦 地平线、巧虎、战斗陀螺 X…）确实每周都在播，
      * 收录它们并不算错，但很多人不把它们当作「本季新番」，任其出现会让表格变得嘈杂。
      *
-     * AniList **没有**「长期番」专用标记，只能靠「话数失控」这个间接特征。判定分两种：
+     * 判据只有一条：**展示话数 ≥ 阈值**。长期连载番的本集数自然会涨得很高，而一季 12～24
+     * 话的当季番永远达不到阈值，因此不需要再引入别的条件。
      *
-     * 判据是 **`episodes` 为空**：AniList 对**有确定话数**的作品都会填 `episodes`，只有
-     * 「不确定何时完结」的无限连载番才一直留空。再叠加「展示话数 ≥ 阈值」，
-     * 当季番因此永远不会命中。
+     * 早先这里还叠加了「AniList 未给出总话数（`episodes === null`）」作为前提，但那条实际
+     * 上没有生效：大部分条目在闸门 2 之前就被筛掉，取不到 AniList 状态，于是「有状态」
+     * 这个前提直接为假，该剔的长期番反而漏剔（实测 `キラキラADらっこちゃん` 第 239 话、
+     * `ギャビーのドールハウス` 第 131 话都因此留在表里）。去掉它之后判据不再依赖网络，
+     * 行为更可预测，也不会再被限流影响。
      *
      * **必须在条目构建之后调用**：`applyAiringSchedule` 内部会按作品去重，去重前后的
      * 「第几话」可能不同。判据要落在**最终展示的话数**上。
      *
      * 阈值由 `content.longRunningThreshold` 决定，**默认 0 表示不过滤**。
-     *
-     * ## 已知覆盖不到的几类（刻意保守，不做猜测）
-     *
-     * - **没有 `aniListId`**：拿不到状态，无法判定（如 `ギャビーのドールハウス`，第 131 话）。
-     * - **连 Bangumi 条目 ID 都没有**：连索引条目都取不到（如 `キラキラADらっこちゃん`，第 239 话）。
-     * - **AniList 的总话数滞后**：AniList 只跟踪到某个「季度」就停更，`episodes` 停在较小的
-     *   值而实际话数早已超过（实测 `コアラ絵日記`、`デジモンBEATBREAK` 都是 `episodes=49`
-     *   但已播到第 53 话）。曾试过「展示话数 > episodes」这条补强，但无法稳定生效
-     *   （状态表在限流时可能缺项），因此不做——宁可漏剔也不误杀。
      */
     private dropLongRunning;
     /**

package/lib/services/digest.js

@@ -282,45 +282,28 @@ class DigestService {
      * 这类作品（海螺小姐、樱桃小丸子、宝可梦 地平线、巧虎、战斗陀螺 X…）确实每周都在播，
      * 收录它们并不算错，但很多人不把它们当作「本季新番」，任其出现会让表格变得嘈杂。
      *
-     * AniList **没有**「长期番」专用标记，只能靠「话数失控」这个间接特征。判定分两种：
+     * 判据只有一条：**展示话数 ≥ 阈值**。长期连载番的本集数自然会涨得很高，而一季 12～24
+     * 话的当季番永远达不到阈值，因此不需要再引入别的条件。
      *
-     * 判据是 **`episodes` 为空**：AniList 对**有确定话数**的作品都会填 `episodes`，只有
-     * 「不确定何时完结」的无限连载番才一直留空。再叠加「展示话数 ≥ 阈值」，
-     * 当季番因此永远不会命中。
+     * 早先这里还叠加了「AniList 未给出总话数（`episodes === null`）」作为前提，但那条实际
+     * 上没有生效：大部分条目在闸门 2 之前就被筛掉，取不到 AniList 状态，于是「有状态」
+     * 这个前提直接为假，该剔的长期番反而漏剔（实测 `キラキラADらっこちゃん` 第 239 话、
+     * `ギャビーのドールハウス` 第 131 话都因此留在表里）。去掉它之后判据不再依赖网络，
+     * 行为更可预测，也不会再被限流影响。
      *
      * **必须在条目构建之后调用**：`applyAiringSchedule` 内部会按作品去重，去重前后的
      * 「第几话」可能不同。判据要落在**最终展示的话数**上。
      *
      * 阈值由 `content.longRunningThreshold` 决定，**默认 0 表示不过滤**。
-     *
-     * ## 已知覆盖不到的几类（刻意保守，不做猜测）
-     *
-     * - **没有 `aniListId`**：拿不到状态，无法判定（如 `ギャビーのドールハウス`，第 131 话）。
-     * - **连 Bangumi 条目 ID 都没有**：连索引条目都取不到（如 `キラキラADらっこちゃん`，第 239 话）。
-     * - **AniList 的总话数滞后**：AniList 只跟踪到某个「季度」就停更，`episodes` 停在较小的
-     *   值而实际话数早已超过（实测 `コアラ絵日記`、`デジモンBEATBREAK` 都是 `episodes=49`
-     *   但已播到第 53 话）。曾试过「展示话数 > episodes」这条补强，但无法稳定生效
-     *   （状态表在限流时可能缺项），因此不做——宁可漏剔也不误杀。
      */
-    dropLongRunning(items, candidates, states) {
+    dropLongRunning(items) {
         const threshold = this.config.content.longRunningThreshold;
         if (!threshold || threshold <= 0)
             return items;
-        // 条目只带 tid，这里按 tid 找回索引条目
-        const entryOfTid = new Map();
-        for (const candidate of candidates) {
-            const tid = defaultTidOf(candidate.entry) ?? candidate.entry.key;
-            if (!entryOfTid.has(tid))
-                entryOfTid.set(tid, candidate.entry);
-        }
         const kept = [];
         const dropped = [];
         for (const item of items) {
-            const entry = entryOfTid.get(item.tid);
-            const state = entry ? this.airingStateOf(entry, states) : undefined;
-            // 只有「AniList 明确不给总话数」才算无限连载
-            const openEnded = state !== undefined && state.episodes === null;
-            if (openEnded && item.episodeCount >= threshold) {
+            if (item.episodeCount >= threshold) {
                 if (dropped.length < 12)
                     dropped.push(`${item.name}(第${item.episodeCount}话)`);
                 continue;
@@ -328,7 +311,7 @@ class DigestService {
             kept.push(item);
         }
         if (dropped.length) {
-            (0, utils_1.debugLog)('[digest] 剔除超长期连载番 %d 部（话数失控且第 %d 话以上）: %s', items.length - kept.length, threshold, dropped.join('、'));
+            (0, utils_1.debugLog)('[digest] 剔除超长期连载番 %d 部（第 %d 话以上）: %s', items.length - kept.length, threshold, dropped.join('、'));
         }
         return kept;
     }
@@ -900,7 +883,7 @@ class DigestService {
         // 「第几话」可能不是同一个值（同一部作品在窗口内有多场时，保留的那一场未必是话数最大
         // 的那一场）。判据要落在**最终展示的话数**上，否则会出现「明明显示第 53 话却按第 49
         // 话判定」这种错位，导致该剔的没剔掉。
-        const items = this.dropLongRunning(built, concluded, airingStates);
+        const items = this.dropLongRunning(built);
         return this.finish(kind, this.headerOf(kind, window), '', groupOverride ? groupOverride(items) : this.groupOf(kind, window, items), kind === 'sub' ? this.messages.noAiringSub(subscribed.size) : this.emptyTextOf(kind));
     }
     /**

package/lib/services/scheduler.js

@@ -253,14 +253,19 @@ class Scheduler {
                 continue;
             }
             try {
+                // 与推送表同一套版式：首行时刻 + 集数，标题与提示各占一行
                 const lines = fresh.map((item) => {
                     const inMinutes = Math.max(0, Math.round((item.atMs - now) / 60000));
-                    return `· ${item.time} ${item.name} (${item.episode})\n    还有约 ${inMinutes} 分钟开播`;
+                    const episode = item.recurring && item.episodeCount > 0
+                        ? (0, constants_1.getMessages)(this.config.locale).episodeUnit(item.episodeCount)
+                        : '';
+                    const lead = episode ? `${item.time} ${episode}` : item.time;
+                    return `${lead}\n  ${item.name}\n  还有约 ${inMinutes} 分钟开播`;
                 });
                 const message = koishi_1.h.text([
                     `即将开播 (${(0, time_1.formatDate)(now, this.config.timeZone)})`,
                     ...lines,
-                ].join('\n'));
+                ].join('\n\n'));
                 const bot = this.ctx.bots.find((entry) => entry.selfId === channel.botId);
                 if (bot)
                     await bot.sendMessage(channel.channelId, message);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-anime-schedule",
   "description": "番剧更新表与订阅提醒：每日 / 深夜档 / 本周 / 本季四张表，支持单部订阅",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/readme.md

@@ -52,7 +52,7 @@ npm i koishi-plugin-anime-schedule
 | `push.dailyTime` 等 | 见配置页 | 四种推送各自的开关与时刻 |
 | `push.updateLookaheadMinutes` | `30` | 订阅作品提前多少分钟提醒 |
 | `content.maxItems` | `0` | 单次推送最多显示多少部，`0` 为不限制 |
-| `content.longRunningThreshold` | `0` | 剔除长期连载番的话数阈值，`0` 为不过滤。 |
+| `content.longRunningThreshold` | `0` | 剔除长期连载番的话数阈值，`0` 为不过滤 |
 | `output.format` | `image` | `image` / `text` |
 | `output.layout` | `table` | 图片排版：`table` / `list` |
 | `localize.titleStyle` | `localized` | `localized` 仅中文 / `both` 中文（日文原名）/ `original` 仅日文原名 |