@zhin.js/plugin-rss 1.1.9 → 1.1.11

package/README.md

@@ -162,3 +162,11 @@ MIT
 ### 事务化任务存储
 
 提醒与管理员 RSS 的任务、认领、操作回执和文章明细使用独立数据表，在一个事务中提交；原 CAS JSON 只用于首次迁移。支持 SQLite、MySQL、PostgreSQL，升级须完整重启，不能与旧版本进程混写。`unknown` 投递仍不会自动重试。迁移和字段说明见[结构化存储](../../../docs/operations/structured-storage.md)。
+
+## Language / 语言
+
+命令和工具的提示使用当前操作语言，源站文章标题和正文保持原样。聊天订阅保存创建者当时的语言；管理员订阅保存项目语言。轮询按每个订阅保存的语言生成通知或静默摘要，更改个人／项目语言不会重写既有订阅；暂停、恢复和进程重启仍保持原语言。旧数据没有语言字段时保持中文。
+
+Console 的界面语言仅影响任务列表、字段说明和操作错误；不参与 requestId 指纹，不改变任务版本或通知语言。新状态使用独立文案 key 展示，旧的文字 detail 原样保留。
+
+Notifications use the language captured at subscription creation. Feed content remains in its original language. Changing Console language changes presentation only, including idempotent responses; it does not change delivery settings or repeat an operation.

package/commands/rss-add/[url]/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { rssMessages as t } from "../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { channelSourceError, extractChannelInfo, subscriptionScope } from "../../../lib/channel.js";
 import { getRssSubs } from "../../../lib/db-store.js";
@@ -6,33 +7,33 @@ import { fetchFeed, resolveRssConfig } from "../../../lib/feed.js";
 import { markItemsSeen } from "../../../lib/poll.js";
 import { rssRuntimeToken } from "../../../lib/runtime.js";
 export default defineCommand({
-    description: '订阅一个 RSS/Atom 源',
+    description: '订阅一个 RSS/Atom 源', descriptionI18n: { en: "Subscribe to an RSS/Atom feed" },
     params: { url: { type: 'string' } },
-    async execute({ params, config, input, use }) {
+    async execute({ params, config, input, use, locale }) {
         const runtime = use(rssRuntimeToken);
         const Subs = getRssSubs(runtime.db);
         if (!Subs)
-            return 'RSS 数据库尚未就绪，请稍后重试';
+            return t(locale, 'databaseRetry');
         const url = String(params.url ?? '').trim();
         if (!url)
-            return '请提供 RSS 源地址，格式：rss-add <URL>';
+            return t(locale, 'urlRequired');
         if (!/^https?:\/\//i.test(url))
-            return '请提供有效的 HTTP/HTTPS 地址';
+            return t(locale, 'httpRequired');
         const channel = extractChannelInfo(input);
         if (!channel)
-            return channelSourceError(input);
+            return channelSourceError(input, locale);
         const cfg = resolveRssConfig(config);
         const existing = await Subs.select().where({
             url,
             ...subscriptionScope(channel),
         });
         if (existing.length > 0)
-            return '当前会话已订阅该源，无需重复添加';
+            return t(locale, 'existing');
         const currentSubs = await Subs.select().where({
             ...subscriptionScope(channel),
         });
         if (currentSubs.length >= cfg.maxPerGroup) {
-            return `当前会话订阅数已达上限 (${cfg.maxPerGroup})，请先取消一些`;
+            return t(locale, 'limit', { max: cfg.maxPerGroup });
         }
         let feedTitle = '';
         try {
@@ -41,7 +42,7 @@ export default defineCommand({
             await markItemsSeen(runtime, url, items);
         }
         catch (e) {
-            return `无法解析该地址: ${e.message}\n请确认是有效的 RSS/Atom 源`;
+            return t(locale, 'loadFailed', { error: e.message });
         }
         await Subs.insert({
             url,
@@ -53,7 +54,8 @@ export default defineCommand({
             creator_id: channel.senderId,
             creator_name: channel.senderName,
             created_at: new Date().toISOString(),
+            locale,
         });
-        return `订阅成功！\n源: ${feedTitle || url}\n新内容将在轮询时推送到本会话（需 OutboundHost）`;
+        return t(locale, 'added', { feed: feedTitle || url });
     },
 });

package/commands/rss-add/[url]/index.ts

@@ -1,3 +1,4 @@
+import { rssMessages as t } from '../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { channelSourceError, extractChannelInfo, subscriptionScope } from '../../../src/channel.js';
 import { getRssSubs } from '../../../src/db-store.js';
@@ -6,32 +7,32 @@ import { markItemsSeen } from '../../../src/poll.js';
 import { rssRuntimeToken } from '../../../src/runtime.js';
 
 export default defineCommand<RssConfig>({
-  description: '订阅一个 RSS/Atom 源',
+  description: '订阅一个 RSS/Atom 源', descriptionI18n: { en: "Subscribe to an RSS/Atom feed" },
   params: { url: { type: 'string' } },
-  async execute({ params, config, input, use }) {
+  async execute({ params, config, input, use, locale }) {
     const runtime = use(rssRuntimeToken);
     const Subs = getRssSubs(runtime.db);
-    if (!Subs) return 'RSS 数据库尚未就绪，请稍后重试';
+    if (!Subs) return t(locale, 'databaseRetry');
 
     const url = String(params.url ?? '').trim();
-    if (!url) return '请提供 RSS 源地址，格式：rss-add <URL>';
-    if (!/^https?:\/\//i.test(url)) return '请提供有效的 HTTP/HTTPS 地址';
+    if (!url) return t(locale, 'urlRequired');
+    if (!/^https?:\/\//i.test(url)) return t(locale, 'httpRequired');
 
     const channel = extractChannelInfo(input);
-    if (!channel) return channelSourceError(input);
+    if (!channel) return channelSourceError(input, locale);
     const cfg = resolveRssConfig(config);
 
     const existing = await Subs.select().where({
       url,
       ...subscriptionScope(channel),
     });
-    if (existing.length > 0) return '当前会话已订阅该源，无需重复添加';
+    if (existing.length > 0) return t(locale, 'existing');
 
     const currentSubs = await Subs.select().where({
       ...subscriptionScope(channel),
     });
     if (currentSubs.length >= cfg.maxPerGroup) {
-      return `当前会话订阅数已达上限 (${cfg.maxPerGroup})，请先取消一些`;
+      return t(locale, 'limit', { max: cfg.maxPerGroup });
     }
 
     let feedTitle = '';
@@ -40,7 +41,7 @@ export default defineCommand<RssConfig>({
       feedTitle = title;
       await markItemsSeen(runtime, url, items);
     } catch (e) {
-      return `无法解析该地址: ${(e as Error).message}\n请确认是有效的 RSS/Atom 源`;
+      return t(locale, 'loadFailed', { error: (e as Error).message });
     }
 
     await Subs.insert({
@@ -53,8 +54,9 @@ export default defineCommand<RssConfig>({
       creator_id: channel.senderId,
       creator_name: channel.senderName,
       created_at: new Date().toISOString(),
+      locale,
     });
 
-    return `订阅成功！\n源: ${feedTitle || url}\n新内容将在轮询时推送到本会话（需 OutboundHost）`;
+    return t(locale, 'added', { feed: feedTitle || url });
   },
 });

package/commands/rss-check/[[url]]/index.js

@@ -1,4 +1,5 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { rssMessages as t } from "../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { channelSourceError, extractChannelInfo, subscriptionScope } from "../../../lib/channel.js";
 import { getRssSubs } from "../../../lib/db-store.js";
@@ -6,16 +7,16 @@ import { resolveRssConfig } from "../../../lib/feed.js";
 import { checkSubscriptions } from "../../../lib/poll.js";
 import { rssRuntimeToken } from "../../../lib/runtime.js";
 export default defineCommand({
-    description: '手动触发检查 RSS 更新',
+    description: '手动触发检查 RSS 更新', descriptionI18n: { en: "Check RSS feeds for updates now" },
     params: { url: { type: 'string', default: '' } },
-    async execute({ params, input, use }) {
+    async execute({ params, input, use, locale }) {
         const runtime = use(rssRuntimeToken);
         const Subs = getRssSubs(runtime.db);
         if (!Subs)
-            return 'RSS 数据库尚未就绪';
+            return t(locale, 'databaseUnavailable');
         const channel = extractChannelInfo(input);
         if (!channel)
-            return channelSourceError(input);
+            return channelSourceError(input, locale);
         const targetUrl = String(params.url ?? '').trim();
         let urls;
         if (targetUrl) {
@@ -24,7 +25,7 @@ export default defineCommand({
                 ...subscriptionScope(channel),
             });
             if (rows.length === 0)
-                return '当前会话未订阅该源';
+                return t(locale, 'notSubscribed');
             urls = [targetUrl];
         }
         else {
@@ -32,10 +33,10 @@ export default defineCommand({
                 ...subscriptionScope(channel),
             });
             if (rows.length === 0)
-                return '当前会话没有任何订阅';
+                return t(locale, 'noSubscriptions');
             urls = [...new Set(rows.map((r) => String(r.url ?? '')).filter(Boolean))];
         }
-        const result = await checkSubscriptions(runtime, { urls });
+        const result = await checkSubscriptions(runtime, { urls, locale });
         return result.text;
     },
 });

package/commands/rss-check/[[url]]/index.ts

@@ -1,3 +1,4 @@
+import { rssMessages as t } from '../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { channelSourceError, extractChannelInfo, subscriptionScope } from '../../../src/channel.js';
 import { getRssSubs } from '../../../src/db-store.js';
@@ -6,15 +7,15 @@ import { checkSubscriptions } from '../../../src/poll.js';
 import { rssRuntimeToken } from '../../../src/runtime.js';
 
 export default defineCommand<RssConfig>({
-  description: '手动触发检查 RSS 更新',
+  description: '手动触发检查 RSS 更新', descriptionI18n: { en: "Check RSS feeds for updates now" },
   params: { url: { type: 'string', default: '' } },
-  async execute({ params, input, use }) {
+  async execute({ params, input, use, locale }) {
     const runtime = use(rssRuntimeToken);
     const Subs = getRssSubs(runtime.db);
-    if (!Subs) return 'RSS 数据库尚未就绪';
+    if (!Subs) return t(locale, 'databaseUnavailable');
 
     const channel = extractChannelInfo(input);
-    if (!channel) return channelSourceError(input);
+    if (!channel) return channelSourceError(input, locale);
     const targetUrl = String(params.url ?? '').trim();
 
     let urls: string[];
@@ -23,17 +24,17 @@ export default defineCommand<RssConfig>({
         url: targetUrl,
         ...subscriptionScope(channel),
       });
-      if (rows.length === 0) return '当前会话未订阅该源';
+      if (rows.length === 0) return t(locale, 'notSubscribed');
       urls = [targetUrl];
     } else {
       const rows = await Subs.select().where({
         ...subscriptionScope(channel),
       });
-      if (rows.length === 0) return '当前会话没有任何订阅';
+      if (rows.length === 0) return t(locale, 'noSubscriptions');
       urls = [...new Set(rows.map((r) => String(r.url ?? '')).filter(Boolean))];
     }
 
-    const result = await checkSubscriptions(runtime, { urls });
+    const result = await checkSubscriptions(runtime, { urls, locale });
     return result.text;
   },
 });

package/commands/rss-list/index.js

@@ -1,29 +1,31 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { rssMessages as t } from "../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { channelSourceError, extractChannelInfo, subscriptionScope } from "../../lib/channel.js";
 import { getRssSubs } from "../../lib/db-store.js";
 import { resolveRssConfig } from "../../lib/feed.js";
 import { rssRuntimeToken } from "../../lib/runtime.js";
 export default defineCommand({
-    description: '查看当前会话的所有 RSS 订阅',
-    async execute({ config, input, use }) {
+    description: '查看当前会话的所有 RSS 订阅', descriptionI18n: { en: "List this conversation's RSS subscriptions" },
+    async execute({ config, input, use, locale, formatCommand }) {
         const Subs = getRssSubs(use(rssRuntimeToken).db);
         if (!Subs)
-            return 'RSS 数据库尚未就绪';
+            return t(locale, 'databaseUnavailable');
         const channel = extractChannelInfo(input);
         if (!channel)
-            return channelSourceError(input);
+            return channelSourceError(input, locale);
         const cfg = resolveRssConfig(config);
         const rows = await Subs.select().where({
             ...subscriptionScope(channel),
         });
         if (rows.length === 0) {
-            return '当前会话没有订阅任何 RSS 源\n使用 rss-add <URL> 添加订阅';
+            const command = formatCommand('rss-add');
+            return [t(locale, 'empty'), command ? t(locale, 'addHint', { command }) : undefined].filter(Boolean).join('\n');
         }
         const lines = rows.map((r, i) => {
-            const title = String(r.feed_title || '(未知标题)');
+            const title = String(r.feed_title || t(locale, 'unknownTitle'));
             return `${i + 1}. ${title}\n   ${String(r.url ?? '')}`;
         });
-        return `当前订阅 (${rows.length}/${cfg.maxPerGroup})：\n${lines.join('\n')}`;
+        return t(locale, 'list', { count: rows.length, max: cfg.maxPerGroup, items: lines.join('\n') });
     },
 });

package/commands/rss-list/index.ts

@@ -1,3 +1,4 @@
+import { rssMessages as t } from '../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { channelSourceError, extractChannelInfo, subscriptionScope } from '../../src/channel.js';
 import { getRssSubs } from '../../src/db-store.js';
@@ -5,27 +6,28 @@ import { resolveRssConfig, type RssConfig } from '../../src/feed.js';
 import { rssRuntimeToken } from '../../src/runtime.js';
 
 export default defineCommand<RssConfig>({
-  description: '查看当前会话的所有 RSS 订阅',
-  async execute({ config, input, use }) {
+  description: '查看当前会话的所有 RSS 订阅', descriptionI18n: { en: "List this conversation's RSS subscriptions" },
+  async execute({ config, input, use, locale, formatCommand }) {
     const Subs = getRssSubs(use(rssRuntimeToken).db);
-    if (!Subs) return 'RSS 数据库尚未就绪';
+    if (!Subs) return t(locale, 'databaseUnavailable');
 
     const channel = extractChannelInfo(input);
-    if (!channel) return channelSourceError(input);
+    if (!channel) return channelSourceError(input, locale);
     const cfg = resolveRssConfig(config);
     const rows = await Subs.select().where({
       ...subscriptionScope(channel),
     });
 
     if (rows.length === 0) {
-      return '当前会话没有订阅任何 RSS 源\n使用 rss-add <URL> 添加订阅';
+      const command = formatCommand('rss-add');
+      return [t(locale, 'empty'), command ? t(locale, 'addHint', { command }) : undefined].filter(Boolean).join('\n');
     }
 
     const lines = rows.map((r, i) => {
-      const title = String(r.feed_title || '(未知标题)');
+      const title = String(r.feed_title || t(locale, 'unknownTitle'));
       return `${i + 1}. ${title}\n   ${String(r.url ?? '')}`;
     });
 
-    return `当前订阅 (${rows.length}/${cfg.maxPerGroup})：\n${lines.join('\n')}`;
+    return t(locale, 'list', { count: rows.length, max: cfg.maxPerGroup, items: lines.join('\n') });
   },
 });

package/commands/rss-preview/[url]/index.js

@@ -1,22 +1,23 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { rssMessages as t } from "../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { fetchFeed, formatFeedPreview, resolveRssConfig } from "../../../lib/feed.js";
 export default defineCommand({
-    description: '预览一个 RSS 源的最新内容（不订阅）',
+    description: '预览一个 RSS 源的最新内容（不订阅）', descriptionI18n: { en: "Preview the latest feed items without subscribing" },
     params: { url: { type: 'string' } },
-    async execute({ params, config }) {
+    async execute({ params, config, locale }) {
         const url = String(params.url ?? '').trim();
         if (!url)
-            return '请提供 RSS 源地址';
+            return t(locale, 'urlRequired');
         if (!/^https?:\/\//i.test(url))
-            return '请提供有效的 HTTP/HTTPS 地址';
+            return t(locale, 'httpRequired');
         const cfg = resolveRssConfig(config);
         try {
             const { title, items } = await fetchFeed(url, cfg.timeout);
-            return formatFeedPreview(title, items);
+            return formatFeedPreview(title, items, locale);
         }
         catch (e) {
-            return `解析失败: ${e.message}\n请确认是有效的 RSS/Atom 地址`;
+            return t(locale, 'previewFailed', { error: e.message });
         }
     },
 });

package/commands/rss-preview/[url]/index.ts

@@ -1,19 +1,20 @@
+import { rssMessages as t } from '../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { fetchFeed, formatFeedPreview, resolveRssConfig, type RssConfig } from '../../../src/feed.js';
 
 export default defineCommand<RssConfig>({
-  description: '预览一个 RSS 源的最新内容（不订阅）',
+  description: '预览一个 RSS 源的最新内容（不订阅）', descriptionI18n: { en: "Preview the latest feed items without subscribing" },
   params: { url: { type: 'string' } },
-  async execute({ params, config }) {
+  async execute({ params, config, locale }) {
     const url = String(params.url ?? '').trim();
-    if (!url) return '请提供 RSS 源地址';
-    if (!/^https?:\/\//i.test(url)) return '请提供有效的 HTTP/HTTPS 地址';
+    if (!url) return t(locale, 'urlRequired');
+    if (!/^https?:\/\//i.test(url)) return t(locale, 'httpRequired');
     const cfg = resolveRssConfig(config);
     try {
       const { title, items } = await fetchFeed(url, cfg.timeout);
-      return formatFeedPreview(title, items);
+      return formatFeedPreview(title, items, locale);
     } catch (e) {
-      return `解析失败: ${(e as Error).message}\n请确认是有效的 RSS/Atom 地址`;
+      return t(locale, 'previewFailed', { error: (e as Error).message });
     }
   },
 });

package/commands/rss-remove/[url]/index.js

@@ -1,33 +1,34 @@
 // Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { rssMessages as t } from "../../../lib/i18n.js";
 import { defineCommand } from 'zhin.js/command';
 import { channelSourceError, extractChannelInfo, subscriptionScope } from "../../../lib/channel.js";
 import { getRssSubs } from "../../../lib/db-store.js";
 import { rssRuntimeToken } from "../../../lib/runtime.js";
 export default defineCommand({
-    description: '取消一个 RSS 订阅',
+    description: '取消一个 RSS 订阅', descriptionI18n: { en: "Unsubscribe from an RSS feed" },
     params: { url: { type: 'string' } },
-    async execute({ params, input, use }) {
+    async execute({ params, input, use, locale }) {
         const Subs = getRssSubs(use(rssRuntimeToken).db);
         if (!Subs)
-            return 'RSS 数据库尚未就绪';
+            return t(locale, 'databaseUnavailable');
         const url = String(params.url ?? '').trim();
         if (!url)
-            return '请提供要取消的 RSS 源地址';
+            return t(locale, 'removeUrl');
         const channel = extractChannelInfo(input);
         if (!channel)
-            return channelSourceError(input);
+            return channelSourceError(input, locale);
         const rows = await Subs.select().where({
             url,
             ...subscriptionScope(channel),
         });
         if (rows.length === 0)
-            return '未找到该订阅';
+            return t(locale, 'notFound');
         const row = rows[0];
         // 表结构没有 id 列，删除必须按业务键匹配（与上面的 select 条件一致）。
         await Subs.delete().where({
             url,
             ...subscriptionScope(channel),
         });
-        return `已取消订阅: ${String(row.feed_title || url)}`;
+        return t(locale, 'removed', { feed: String(row.feed_title || url) });
     },
 });

package/commands/rss-remove/[url]/index.ts

@@ -1,3 +1,4 @@
+import { rssMessages as t } from '../../../src/i18n.js';
 import { defineCommand } from 'zhin.js/command';
 import { channelSourceError, extractChannelInfo, subscriptionScope } from '../../../src/channel.js';
 import { getRssSubs } from '../../../src/db-store.js';
@@ -5,23 +6,23 @@ import type { RssConfig } from '../../../src/feed.js';
 import { rssRuntimeToken } from '../../../src/runtime.js';
 
 export default defineCommand<RssConfig>({
-  description: '取消一个 RSS 订阅',
+  description: '取消一个 RSS 订阅', descriptionI18n: { en: "Unsubscribe from an RSS feed" },
   params: { url: { type: 'string' } },
-  async execute({ params, input, use }) {
+  async execute({ params, input, use, locale }) {
     const Subs = getRssSubs(use(rssRuntimeToken).db);
-    if (!Subs) return 'RSS 数据库尚未就绪';
+    if (!Subs) return t(locale, 'databaseUnavailable');
 
     const url = String(params.url ?? '').trim();
-    if (!url) return '请提供要取消的 RSS 源地址';
+    if (!url) return t(locale, 'removeUrl');
 
     const channel = extractChannelInfo(input);
-    if (!channel) return channelSourceError(input);
+    if (!channel) return channelSourceError(input, locale);
     const rows = await Subs.select().where({
       url,
       ...subscriptionScope(channel),
     });
 
-    if (rows.length === 0) return '未找到该订阅';
+    if (rows.length === 0) return t(locale, 'notFound');
 
     const row = rows[0]!;
     // 表结构没有 id 列，删除必须按业务键匹配（与上面的 select 条件一致）。
@@ -29,6 +30,6 @@ export default defineCommand<RssConfig>({
       url,
       ...subscriptionScope(channel),
     });
-    return `已取消订阅: ${String(row.feed_title || url)}`;
+    return t(locale, 'removed', { feed: String(row.feed_title || url) });
   },
 });