@zhin.js/plugin-rss 3.0.5 → 3.0.7

package/commands/rss-add/[url:string].js

@@ -0,0 +1,58 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from '@zhin.js/command';
+import { extractChannelInfo } from "../../lib/channel.js";
+import { getRssSeen, getRssSubs } from "../../lib/db-store.js";
+import { fetchFeed, resolveRssConfig } from "../../lib/feed.js";
+import { markItemsSeen } from "../../lib/poll.js";
+export default defineCommand({
+    description: '订阅一个 RSS/Atom 源',
+    async execute({ params, config, input }) {
+        const Subs = getRssSubs();
+        if (!Subs)
+            return 'RSS 数据库尚未就绪，请稍后重试';
+        const url = String(params.url ?? '').trim();
+        if (!url)
+            return '请提供 RSS 源地址，格式：rss-add <URL>';
+        if (!/^https?:\/\//i.test(url))
+            return '请提供有效的 HTTP/HTTPS 地址';
+        const channel = extractChannelInfo(input);
+        const cfg = resolveRssConfig(config);
+        const existing = await Subs.select().where({
+            url,
+            adapter_name: channel.adapterName,
+            channel_type: channel.channelType,
+            channel_id: channel.channelId,
+        });
+        if (existing.length > 0)
+            return '当前会话已订阅该源，无需重复添加';
+        const currentSubs = await Subs.select().where({
+            adapter_name: channel.adapterName,
+            channel_type: channel.channelType,
+            channel_id: channel.channelId,
+        });
+        if (currentSubs.length >= cfg.maxPerGroup) {
+            return `当前会话订阅数已达上限 (${cfg.maxPerGroup})，请先取消一些`;
+        }
+        let feedTitle = '';
+        try {
+            const { title, items } = await fetchFeed(url, cfg.timeout);
+            feedTitle = title;
+            await markItemsSeen(url, items);
+        }
+        catch (e) {
+            return `无法解析该地址: ${e.message}\n请确认是有效的 RSS/Atom 源`;
+        }
+        await Subs.insert({
+            url,
+            feed_title: feedTitle,
+            adapter_name: channel.adapterName,
+            endpoint_id: channel.endpointId,
+            channel_type: channel.channelType,
+            channel_id: channel.channelId,
+            creator_id: channel.senderId,
+            creator_name: channel.senderName,
+            created_at: new Date().toISOString(),
+        });
+        return `订阅成功！\n源: ${feedTitle || url}\n新内容将在轮询时推送到本会话（需 OutboundHost）`;
+    },
+});

package/commands/rss-check/[url:string=].js

@@ -0,0 +1,41 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from '@zhin.js/command';
+import { extractChannelInfo } from "../../lib/channel.js";
+import { getRssSubs } from "../../lib/db-store.js";
+import { resolveRssConfig } from "../../lib/feed.js";
+import { checkSubscriptions } from "../../lib/poll.js";
+export default defineCommand({
+    description: '手动触发检查 RSS 更新',
+    async execute({ params, config, input }) {
+        const Subs = getRssSubs();
+        if (!Subs)
+            return 'RSS 数据库尚未就绪';
+        const channel = extractChannelInfo(input);
+        const cfg = resolveRssConfig(config);
+        const targetUrl = String(params.url ?? '').trim();
+        let urls;
+        if (targetUrl) {
+            const rows = await Subs.select().where({
+                url: targetUrl,
+                adapter_name: channel.adapterName,
+                channel_type: channel.channelType,
+                channel_id: channel.channelId,
+            });
+            if (rows.length === 0)
+                return '当前会话未订阅该源';
+            urls = [targetUrl];
+        }
+        else {
+            const rows = await Subs.select().where({
+                adapter_name: channel.adapterName,
+                channel_type: channel.channelType,
+                channel_id: channel.channelId,
+            });
+            if (rows.length === 0)
+                return '当前会话没有任何订阅';
+            urls = [...new Set(rows.map((r) => String(r.url ?? '')).filter(Boolean))];
+        }
+        const result = await checkSubscriptions({ urls, config: cfg });
+        return result.text;
+    },
+});

package/commands/rss-list.js

@@ -0,0 +1,28 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { defineCommand } from '@zhin.js/command';
+import { extractChannelInfo } from "../lib/channel.js";
+import { getRssSubs } from "../lib/db-store.js";
+import { resolveRssConfig } from "../lib/feed.js";
+export default defineCommand({
+    description: '查看当前会话的所有 RSS 订阅',
+    async execute({ config, input }) {
+        const Subs = getRssSubs();
+        if (!Subs)
+            return 'RSS 数据库尚未就绪';
+        const channel = extractChannelInfo(input);
+        const cfg = resolveRssConfig(config);
+        const rows = await Subs.select().where({
+            adapter_name: channel.adapterName,
+            channel_type: channel.channelType,
+            channel_id: channel.channelId,
+        });
+        if (rows.length === 0) {
+            return '当前会话没有订阅任何 RSS 源\n使用 rss-add <URL> 添加订阅';
+        }
+        const lines = rows.map((r, i) => {
+            const title = String(r.feed_title || '(未知标题)');
+            return `${i + 1}. ${title}\n   ${String(r.url ?? '')}`;
+        });
+        return `当前订阅 (${rows.length}/${cfg.maxPerGroup})：\n${lines.join('\n')}`;
+    },
+});

package/commands/rss-preview/[url:string].js

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

package/commands/rss-remove/[url:string].js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhin.js/plugin-rss",
-  "version": "3.0.5",
+  "version": "3.0.7",
   "description": "RSS/Atom feed subscription plugin for Zhin.js (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
@@ -14,7 +14,7 @@
     "./package.json": "./package.json"
   },
   "files": [
-    "plugin.ts",
+    "plugin.js",
     "schema.json",
     "commands",
     "src",
@@ -41,18 +41,18 @@
   "license": "MIT",
   "dependencies": {
     "rss-parser": "^3.13.0",
-    "@zhin.js/command": "1.0.3",
-    "@zhin.js/plugin-runtime": "1.1.1"
+    "@zhin.js/plugin-runtime": "1.1.1",
+    "@zhin.js/command": "1.0.4"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
     "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "@zhin.js/agent": "1.0.6"
+    "@zhin.js/agent": "1.0.8"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "@zhin.js/agent": "1.0.6"
+    "@zhin.js/agent": "1.0.8"
   },
   "peerDependenciesMeta": {
     "@zhin.js/agent": {
@@ -77,7 +77,7 @@
   "zhin": {
     "protocol": 1,
     "type": "plugin",
-    "entry": "./plugin.ts",
+    "entry": "./plugin.js",
     "engine": "^1.0.0",
     "runtime": "trusted",
     "features": [

package/plugin.js

@@ -0,0 +1,91 @@
+// Generated by build-plugin-runtime-entries.mjs. Do not edit.
+import { definePlugin, databaseHostToken, outboundHostToken, scheduleHostToken, } from '@zhin.js/plugin-runtime';
+import { fetchFeed, resolveRssConfig } from "./lib/feed.js";
+import { ensureRssMemoryDb, getRssSubs, provideRssDb, RSS_SEEN_TABLE, RSS_SUBS_TABLE, } from "./lib/db-store.js";
+import { setRssAgentDeps } from "./lib/rss-agent-deps.js";
+import { cleanOldSeen, pollAllFeeds, setRssOutboundPush } from "./lib/poll.js";
+function defineRssTables(db) {
+    db.define(RSS_SUBS_TABLE, {
+        url: { type: 'text', nullable: false },
+        feed_title: { type: 'text', default: '' },
+        adapter_name: { type: 'text', nullable: false },
+        endpoint_id: { type: 'text', default: '' },
+        channel_type: { type: 'text', default: 'private' },
+        channel_id: { type: 'text', nullable: false },
+        creator_id: { type: 'text', default: '' },
+        creator_name: { type: 'text', default: '' },
+        created_at: { type: 'text', default: '' },
+    });
+    db.define(RSS_SEEN_TABLE, {
+        feed_url: { type: 'text', nullable: false },
+        item_guid: { type: 'text', nullable: false },
+        item_title: { type: 'text', default: '' },
+        seen_at: { type: 'text', default: '' },
+    });
+}
+/**
+ * Plugin Runtime:
+ * - Commands: add/list/remove/check.
+ * - DB: prefer `databaseHostToken`; else in-memory.
+ * - Outbound: `outboundHostToken` pushes new items to subscriber channels.
+ * - Cron: `scheduleHostToken` poll job when available.
+ */
+export default definePlugin({
+    name: 'rss',
+    metadata: {
+        displayName: 'RSS',
+    },
+    setup(context) {
+        const config = resolveRssConfig(context.config.get());
+        if (context.resources.has(databaseHostToken)) {
+            const host = context.resources.use(databaseHostToken);
+            defineRssTables(host);
+            // provide 自动挂 lifecycle：代际结束反注册，避免悬挂到上一代的 host
+            provideRssDb(context, host);
+        }
+        else {
+            ensureRssMemoryDb();
+        }
+        if (context.resources.has(outboundHostToken)) {
+            const outbound = context.resources.use(outboundHostToken);
+            setRssOutboundPush(async (input) => {
+                await outbound.send({
+                    adapter: input.adapterName,
+                    endpointId: input.endpointId,
+                    channelType: input.channelType,
+                    channelId: input.channelId,
+                    content: input.content,
+                });
+            });
+            context.lifecycle.add(() => setRssOutboundPush(null));
+        }
+        setRssAgentDeps({
+            getSubs: () => getRssSubs(),
+            fetchFeed: (url) => fetchFeed(url, config.timeout).then((f) => ({
+                title: f.title,
+                items: f.items.map((i) => ({ title: i.title, link: i.link })),
+            })),
+        });
+        if (!context.resources.has(scheduleHostToken))
+            return;
+        const schedule = context.resources.use(scheduleHostToken);
+        const dispose = schedule.register({
+            id: 'rss/poll_feeds',
+            cron: config.pollCron,
+            description: 'Poll RSS subscriptions',
+            async execute() {
+                await pollAllFeeds(config);
+            },
+        });
+        const disposeClean = schedule.register({
+            id: 'rss/clean_old_seen',
+            cron: '0 0 4 * * *',
+            description: 'Clean seen records older than 7 days',
+            async execute() {
+                await cleanOldSeen();
+            },
+        });
+        context.lifecycle.add(dispose);
+        context.lifecycle.add(disposeClean);
+    },
+});

package/plugin.ts

@@ -1,104 +0,0 @@
-import {
-  definePlugin,
-  databaseHostToken,
-  outboundHostToken,
-  scheduleHostToken,
-} from '@zhin.js/plugin-runtime';
-import { fetchFeed, resolveRssConfig, type RssConfig } from './src/feed.js';
-import {
-  ensureRssMemoryDb,
-  getRssSubs,
-  provideRssDb,
-  RSS_SEEN_TABLE,
-  RSS_SUBS_TABLE,
-} from './src/db-store.js';
-import { setRssAgentDeps } from './src/rss-agent-deps.js';
-import { cleanOldSeen, pollAllFeeds, setRssOutboundPush } from './src/poll.js';
-
-function defineRssTables(db: { define: (name: string, schema: Record<string, unknown>) => void }): void {
-  db.define(RSS_SUBS_TABLE, {
-    url: { type: 'text', nullable: false },
-    feed_title: { type: 'text', default: '' },
-    adapter_name: { type: 'text', nullable: false },
-    endpoint_id: { type: 'text', default: '' },
-    channel_type: { type: 'text', default: 'private' },
-    channel_id: { type: 'text', nullable: false },
-    creator_id: { type: 'text', default: '' },
-    creator_name: { type: 'text', default: '' },
-    created_at: { type: 'text', default: '' },
-  });
-  db.define(RSS_SEEN_TABLE, {
-    feed_url: { type: 'text', nullable: false },
-    item_guid: { type: 'text', nullable: false },
-    item_title: { type: 'text', default: '' },
-    seen_at: { type: 'text', default: '' },
-  });
-}
-
-/**
- * Plugin Runtime:
- * - Commands: add/list/remove/check.
- * - DB: prefer `databaseHostToken`; else in-memory.
- * - Outbound: `outboundHostToken` pushes new items to subscriber channels.
- * - Cron: `scheduleHostToken` poll job when available.
- */
-export default definePlugin<RssConfig>({
-  name: 'rss',
-  metadata: {
-    displayName: 'RSS',
-  },
-  setup(context) {
-    const config = resolveRssConfig(context.config.get());
-    if (context.resources.has(databaseHostToken)) {
-      const host = context.resources.use(databaseHostToken);
-      defineRssTables(host);
-      // provide 自动挂 lifecycle：代际结束反注册，避免悬挂到上一代的 host
-      provideRssDb(context, host);
-    } else {
-      ensureRssMemoryDb();
-    }
-
-    if (context.resources.has(outboundHostToken)) {
-      const outbound = context.resources.use(outboundHostToken);
-      setRssOutboundPush(async (input) => {
-        await outbound.send({
-          adapter: input.adapterName,
-          endpointId: input.endpointId,
-          channelType: input.channelType,
-          channelId: input.channelId,
-          content: input.content,
-        });
-      });
-      context.lifecycle.add(() => setRssOutboundPush(null));
-    }
-
-    setRssAgentDeps({
-      getSubs: () => getRssSubs() as { select: () => Promise<unknown[]> } | null,
-      fetchFeed: (url) => fetchFeed(url, config.timeout).then((f) => ({
-        title: f.title,
-        items: f.items.map((i) => ({ title: i.title, link: i.link })),
-      })),
-    });
-
-    if (!context.resources.has(scheduleHostToken)) return;
-    const schedule = context.resources.use(scheduleHostToken);
-    const dispose = schedule.register({
-      id: 'rss/poll_feeds',
-      cron: config.pollCron,
-      description: 'Poll RSS subscriptions',
-      async execute() {
-        await pollAllFeeds(config);
-      },
-    });
-    const disposeClean = schedule.register({
-      id: 'rss/clean_old_seen',
-      cron: '0 0 4 * * *',
-      description: 'Clean seen records older than 7 days',
-      async execute() {
-        await cleanOldSeen();
-      },
-    });
-    context.lifecycle.add(dispose);
-    context.lifecycle.add(disposeClean);
-  },
-});