koishi-plugin-anime-schedule 1.0.2 → 1.0.3

package/lib/config.js

@@ -70,9 +70,7 @@ exports.Config = koishi_1.Schema.intersect([
                 .default(0),
             longRunningThreshold: koishi_1.Schema.number()
                 .min(0).step(1)
-                .description('剔除长期连载番的话数阈值，0 为不过滤。'
-                + '展示话数达到该值的作品整条不显示——海螺小姐、宝可梦 地平线这类周更多年的作品'
-                + '话数会一直涨，而一季 12～24 话的当季番永远达不到，所以填 64 这类值即可')
+                .description('剔除长期连载番的话数阈值，0 为不过滤')
                 .default(0),
         }),
     }).description('推送内容'),

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/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.2",
+  "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` 为不过滤。展示话数达到该值的作品不显示；填 `64` 可滤掉海螺小姐、宝可梦 地平线这类周更多年的作品 |
+| `content.longRunningThreshold` | `0` | 剔除长期连载番的话数阈值，`0` 为不过滤 |
 | `output.format` | `image` | `image` / `text` |
 | `output.layout` | `table` | 图片排版：`table` / `list` |
 | `localize.titleStyle` | `localized` | `localized` 仅中文 / `both` 中文（日文原名）/ `original` 仅日文原名 |