@zhin.js/plugin-rss 3.0.2 → 3.0.4

package/lib/poll.js

@@ -0,0 +1,152 @@
+/**
+ * Feed poll helpers: detect new items; optional OutboundHost push to subscribers.
+ */
+import { fetchFeed } from './feed.js';
+import { getRssSeen, getRssSubs } from './db-store.js';
+let _outboundPush = null;
+export function setRssOutboundPush(push) {
+    _outboundPush = push;
+}
+export function getRssOutboundPush() {
+    return _outboundPush;
+}
+function ts() {
+    return new Date().toISOString();
+}
+export function formatNewItems(feedTitle, items, maxItems) {
+    const lines = [`${feedTitle} 有 ${items.length} 条新内容：`];
+    for (const item of items.slice(0, maxItems)) {
+        lines.push('');
+        lines.push(`${item.title}`);
+        if (item.summary)
+            lines.push(item.summary);
+        if (item.link)
+            lines.push(item.link);
+    }
+    if (items.length > maxItems) {
+        lines.push(`\n...还有 ${items.length - maxItems} 条，请查看源站`);
+    }
+    return lines.join('\n');
+}
+export async function markItemsSeen(feedUrl, items) {
+    const Seen = getRssSeen();
+    if (!Seen)
+        return;
+    for (const item of items) {
+        const dup = await Seen.select().where({ feed_url: feedUrl, item_guid: item.guid });
+        if (dup.length === 0) {
+            await Seen.insert({
+                feed_url: feedUrl,
+                item_guid: item.guid,
+                item_title: item.title,
+                seen_at: ts(),
+            });
+        }
+    }
+}
+async function pushToSubscribers(feedUrl, content) {
+    const push = _outboundPush;
+    const Subs = getRssSubs();
+    if (!push || !Subs)
+        return 0;
+    const subscribers = await Subs.select().where({ url: feedUrl });
+    let pushed = 0;
+    for (const sub of subscribers) {
+        const adapterName = String(sub.adapter_name ?? '');
+        const channelId = String(sub.channel_id ?? '');
+        if (!adapterName || !channelId)
+            continue;
+        try {
+            await push({
+                adapterName,
+                endpointId: String(sub.endpoint_id ?? adapterName),
+                channelType: String(sub.channel_type ?? 'private'),
+                channelId,
+                content,
+            });
+            pushed += 1;
+        }
+        catch {
+            // OutboundHost already logs; continue other subscribers.
+        }
+    }
+    return pushed;
+}
+/**
+ * Check subscribed feeds for new items and mark them seen.
+ * When OutboundHost is wired, pushes formatted text to each subscriber channel.
+ */
+export async function checkSubscriptions(options) {
+    const Seen = getRssSeen();
+    const Subs = getRssSubs();
+    if (!Seen || !Subs) {
+        return { text: 'RSS 数据库尚未就绪', totalNew: 0, pushed: 0 };
+    }
+    const parts = [];
+    let totalNew = 0;
+    let pushed = 0;
+    for (const url of options.urls) {
+        try {
+            const { title, items } = await fetchFeed(url, options.config.timeout);
+            const seenRows = await Seen.select().where({ feed_url: url });
+            const seenGuids = new Set(seenRows.map((r) => String(r.item_guid ?? '')));
+            const newItems = items.filter((item) => item.guid && !seenGuids.has(item.guid));
+            if (newItems.length === 0) {
+                parts.push(`${title || url}: 无新内容`);
+                continue;
+            }
+            await markItemsSeen(url, newItems);
+            totalNew += newItems.length;
+            const body = formatNewItems(title || url, newItems, options.config.maxItems);
+            parts.push(body);
+            pushed += await pushToSubscribers(url, body);
+        }
+        catch (e) {
+            parts.push(`${url}: 检查失败 — ${e.message}`);
+        }
+    }
+    if (parts.length === 0)
+        return { text: '没有可检查的订阅', totalNew: 0, pushed: 0 };
+    const pushNote = _outboundPush
+        ? (pushed > 0 ? `，已推送 ${pushed} 个会话` : '，无出站推送')
+        : '（未装配 OutboundHost，仅本地标记）';
+    const header = totalNew > 0
+        ? `检查完成，共 ${totalNew} 条新内容${pushNote}`
+        : '检查完成，暂无新内容';
+    return { text: `${header}\n\n${parts.join('\n\n')}`, totalNew, pushed };
+}
+/**
+ * Periodically clean seen records older than 7 days.
+ */
+export async function cleanOldSeen() {
+    const Seen = getRssSeen();
+    if (!Seen)
+        return;
+    try {
+        const cutoff = new Date();
+        cutoff.setDate(cutoff.getDate() - 7);
+        const cutoffStr = cutoff.toISOString();
+        const all = await Seen.select();
+        const expired = all.filter((r) => typeof r.seen_at === 'string' && r.seen_at < cutoffStr);
+        for (const row of expired) {
+            await Seen.delete().where({ id: row.id });
+        }
+    }
+    catch {
+        // Cleanup failure must not break the main flow.
+    }
+}
+/**
+ * Poll all unique feed URLs across subscriptions.
+ */
+export async function pollAllFeeds(config) {
+    const Subs = getRssSubs();
+    if (!Subs)
+        return { text: 'RSS 数据库尚未就绪', totalNew: 0, pushed: 0 };
+    const all = await Subs.select();
+    const urls = [...new Set(all.map((s) => String(s.url ?? '')).filter(Boolean))];
+    if (urls.length === 0)
+        return { text: '暂无任何 RSS 订阅', totalNew: 0, pushed: 0 };
+    return checkSubscriptions({ urls, config });
+}
+//# sourceMappingURL=poll.js.map

package/lib/poll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poll.js","sourceRoot":"","sources":["../src/poll.ts"],"names":[],"mappings":"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"}

package/lib/rss-agent-deps.d.ts

@@ -0,0 +1,15 @@
+export interface RssAgentDeps {
+    getSubs: () => {
+        select: () => Promise<unknown[]>;
+    } | null;
+    fetchFeed: (url: string) => Promise<{
+        title: string;
+        items: Array<{
+            title: string;
+            link: string;
+        }>;
+    }>;
+}
+export declare function setRssAgentDeps(next: RssAgentDeps): void;
+export declare function getRssAgentDeps(): RssAgentDeps;
+//# sourceMappingURL=rss-agent-deps.d.ts.map

package/lib/rss-agent-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rss-agent-deps.d.ts","sourceRoot":"","sources":["../src/rss-agent-deps.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM;QAAE,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3D,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAAC;CACvG;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAExD;AAED,wBAAgB,eAAe,IAAI,YAAY,CAG9C"}

package/lib/rss-agent-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rss-agent-deps.js","sourceRoot":"","sources":["../src/rss-agent-deps.ts"],"names":[],"mappings":"AAKA,IAAI,IAAI,GAAwB,IAAI,CAAC;AAErC,MAAM,UAAU,eAAe,CAAC,IAAkB;IAChD,IAAI,GAAG,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAC7D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@zhin.js/plugin-rss",
-  "version": "3.0.2",
-  "description": "RSS/Atom feed subscription & push plugin for Zhin.js — subscribe feeds, auto-poll, push new items to groups",
+  "version": "3.0.4",
+  "description": "RSS/Atom feed subscription plugin for Zhin.js (Plugin Runtime)",
   "type": "module",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",
@@ -14,11 +14,12 @@
     "./package.json": "./package.json"
   },
   "files": [
+    "plugin.ts",
+    "schema.json",
+    "commands",
     "src",
     "lib",
     "agent",
-    "client",
-    "dist",
     "README.md"
   ],
   "keywords": [
@@ -30,10 +31,7 @@
     "atom",
     "feed",
     "subscription",
-    "push",
-    "notify",
-    "chatbot",
-    "im"
+    "push"
   ],
   "author": {
     "name": "lc-cn",
@@ -42,18 +40,27 @@
   },
   "license": "MIT",
   "dependencies": {
-    "rss-parser": "^3.13.0"
+    "rss-parser": "^3.13.0",
+    "@zhin.js/command": "1.0.2",
+    "@zhin.js/plugin-runtime": "1.1.0"
   },
   "devDependencies": {
     "typescript": "^6.0.3",
+    "vitest": "^4.1.10",
     "zod": "^4.4.3",
-    "zhin.js": "4.1.2",
-    "@zhin.js/agent": "1.0.3"
+    "@zhin.js/agent": "1.0.5"
   },
   "peerDependencies": {
     "zod": "^4.0.0",
-    "zhin.js": "4.1.2",
-    "@zhin.js/agent": "1.0.3"
+    "@zhin.js/agent": "1.0.5"
+  },
+  "peerDependenciesMeta": {
+    "@zhin.js/agent": {
+      "optional": true
+    },
+    "zod": {
+      "optional": true
+    }
   },
   "repository": {
     "type": "git",
@@ -64,17 +71,26 @@
     "access": "public",
     "registry": "https://registry.npmjs.org"
   },
-  "peerDependenciesMeta": {
-    "@zhin.js/agent": {
-      "optional": true
-    },
-    "zod": {
-      "optional": true
-    }
+  "engines": {
+    "node": "^20.19.0 || >=22.12.0"
+  },
+  "zhin": {
+    "protocol": 1,
+    "type": "plugin",
+    "entry": "./plugin.ts",
+    "engine": "^1.0.0",
+    "runtime": "trusted",
+    "features": [
+      {
+        "package": "@zhin.js/command",
+        "api": "^1.0.0"
+      }
+    ],
+    "plugins": []
   },
   "scripts": {
     "build": "tsc",
     "clean": "rimraf lib",
-    "test": "sh -c 'cd ../../.. && vitest run plugins/utils/rss/tests'"
+    "test": "NODE_OPTIONS=--experimental-strip-types vitest run --root ../../.. plugins/utils/rss/tests"
   }
 }

package/plugin.ts

@@ -0,0 +1,103 @@
+import {
+  definePlugin,
+  databaseHostToken,
+  outboundHostToken,
+  scheduleHostToken,
+} from '@zhin.js/plugin-runtime';
+import { fetchFeed, resolveRssConfig, type RssConfig } from './src/feed.js';
+import {
+  ensureRssMemoryDb,
+  getRssSubs,
+  setRssDb,
+  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);
+      setRssDb(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);
+  },
+});

package/schema.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "pollCron": {
+      "type": "string",
+      "default": "0 */5 * * * *",
+      "description": "轮询频率 (6 段 Cron 表达式)"
+    },
+    "maxPerGroup": {
+      "type": "number",
+      "default": 30,
+      "minimum": 1,
+      "maximum": 200
+    },
+    "maxItems": {
+      "type": "number",
+      "default": 5,
+      "minimum": 1,
+      "maximum": 20
+    },
+    "timeout": {
+      "type": "number",
+      "default": 15000,
+      "minimum": 1000,
+      "maximum": 60000
+    }
+  }
+}

package/src/channel.ts

@@ -0,0 +1,58 @@
+/**
+ * Extract subscription channel keys from Runtime Message (`input`).
+ * Gaps vs legacy: no `$channel` / `$group` — use `adapter` / `target` / `metadata`.
+ */
+
+export interface ChannelInfo {
+  adapterName: string;
+  endpointId: string;
+  channelType: string;
+  channelId: string;
+  senderId: string;
+  senderName: string;
+}
+
+/** Smoke / agent / execute()-without-dispatch fallback. */
+export const SMOKE_CHANNEL: ChannelInfo = {
+  adapterName: 'smoke',
+  endpointId: 'local',
+  channelType: 'private',
+  channelId: 'global',
+  senderId: '',
+  senderName: '',
+};
+
+export function extractChannelInfo(input: unknown): ChannelInfo {
+  if (!input || typeof input !== 'object') return { ...SMOKE_CHANNEL };
+
+  const msg = input as {
+    adapter?: string;
+    target?: string;
+    sender?: string;
+    metadata?: Record<string, unknown>;
+  };
+  const meta = msg.metadata ?? {};
+  const channelType = String(
+    meta.channelType ?? meta.type ?? meta.channel_type ?? 'private',
+  );
+  const channelId = String(
+    meta.channelId ?? meta.channel_id ?? msg.target ?? SMOKE_CHANNEL.channelId,
+  );
+  const adapterName = String(msg.adapter ?? meta.adapter ?? SMOKE_CHANNEL.adapterName);
+  const endpointId = String(
+    meta.endpoint ?? meta.endpointId ?? meta.endpoint_id ?? adapterName,
+  );
+  const senderId = String(msg.sender ?? meta.senderId ?? '');
+  const senderName = String(meta.senderName ?? meta.name ?? '');
+
+  if (!channelId) return { ...SMOKE_CHANNEL, adapterName, endpointId, senderId, senderName };
+
+  return {
+    adapterName,
+    endpointId,
+    channelType,
+    channelId,
+    senderId,
+    senderName,
+  };
+}

package/src/db-store.ts

@@ -0,0 +1,42 @@
+export {
+  createInMemoryRssDb,
+  RSS_SEEN_TABLE,
+  RSS_SUBS_TABLE,
+  type RssMemoryDb,
+  type RssModel,
+} from './memory-store.js';
+
+import {
+  createInMemoryRssDb,
+  RSS_SEEN_TABLE,
+  RSS_SUBS_TABLE,
+  type RssMemoryDb,
+  type RssModel,
+} from './memory-store.js';
+
+let _db: RssMemoryDb | null = null;
+
+export function ensureRssMemoryDb(): RssMemoryDb {
+  if (!_db) _db = createInMemoryRssDb();
+  return _db;
+}
+
+export function getRssDb(): RssMemoryDb | null {
+  return ensureRssMemoryDb();
+}
+
+export function setRssDb(db: RssMemoryDb | null): void {
+  _db = db;
+}
+
+export function resetRssDb(): void {
+  _db = null;
+}
+
+export function getRssSubs(): RssModel | null {
+  return ensureRssMemoryDb().models.get(RSS_SUBS_TABLE) ?? null;
+}
+
+export function getRssSeen(): RssModel | null {
+  return ensureRssMemoryDb().models.get(RSS_SEEN_TABLE) ?? null;
+}

package/src/feed.ts

@@ -0,0 +1,106 @@
+/**
+ * RSS feed fetch/preview helpers (no Plugin host).
+ */
+import Parser from 'rss-parser';
+
+export interface FeedItem {
+  title: string;
+  link: string;
+  date: string;
+  summary: string;
+  guid: string;
+}
+
+export interface RssConfig {
+  readonly pollCron: string;
+  readonly maxPerGroup: number;
+  readonly maxItems: number;
+  readonly timeout: number;
+}
+
+export const DEFAULT_RSS_CONFIG: RssConfig = {
+  pollCron: '0 */5 * * * *',
+  maxPerGroup: 30,
+  maxItems: 5,
+  timeout: 15_000,
+};
+
+export function resolveRssConfig(raw: Partial<RssConfig> | undefined): RssConfig {
+  return { ...DEFAULT_RSS_CONFIG, ...raw };
+}
+
+/**
+ * 剔除 HTML 标签与 `&nbsp;` 实体并折叠空白。
+ * 线性单遍扫描实现（手写状态机），语义等价于原先的
+ * `/<[^>]*>/g` → `/&nbsp;/g` → `/\s+/g` 三步 replace，但避免：
+ * - js/polynomial-redos：大量 `<` 无闭合时正则逐位重扫的二次方回溯；
+ * - js/incomplete-multi-character-sanitization：多趟 replace 的残留问题。
+ */
+export function stripHtml(html: string): string {
+  let out = '';
+  let pendingSpace = false;
+  let mayHaveTagEnd = html.includes('>');
+  let i = 0;
+  while (i < html.length) {
+    const ch = html[i]!;
+    if (ch === '<' && mayHaveTagEnd) {
+      const end = html.indexOf('>', i + 1);
+      if (end >= 0) {
+        i = end + 1;
+        continue;
+      }
+      // 后续不再有 `>`：剩余的 `<` 都是字面字符，不再重复扫描。
+      mayHaveTagEnd = false;
+    }
+    if (ch === '&' && html.startsWith('&nbsp;', i)) {
+      pendingSpace = true;
+      i += '&nbsp;'.length;
+      continue;
+    }
+    if (/\s/u.test(ch)) {
+      pendingSpace = true;
+      i += 1;
+      continue;
+    }
+    if (pendingSpace && out.length > 0) out += ' ';
+    pendingSpace = false;
+    out += ch;
+    i += 1;
+  }
+  return out;
+}
+
+export async function fetchFeed(
+  url: string,
+  timeout = DEFAULT_RSS_CONFIG.timeout,
+): Promise<{ title: string; items: FeedItem[] }> {
+  const parser = new Parser({
+    timeout,
+    headers: {
+      'User-Agent': 'ZhinBot-RSS/1.0',
+      Accept: 'application/rss+xml, application/atom+xml, application/xml, text/xml',
+    },
+  });
+  const feed = await parser.parseURL(url);
+  const items: FeedItem[] = (feed.items || []).slice(0, 20).map((item) => ({
+    title: (item.title || '').trim(),
+    link: (item.link || '').trim(),
+    date: item.isoDate || item.pubDate || '',
+    summary: stripHtml(item.contentSnippet || item.content || '').slice(0, 200),
+    guid: item.guid || item.link || item.title || '',
+  }));
+  return { title: (feed.title || url).trim(), items };
+}
+
+export function formatFeedPreview(title: string, items: FeedItem[]): string {
+  if (items.length === 0) return `${title}: 暂无内容`;
+  const lines = [`${title} (共 ${items.length} 条)`];
+  for (const item of items.slice(0, 5)) {
+    lines.push('');
+    lines.push(`${item.title}`);
+    if (item.date) lines.push(`  ${new Date(item.date).toLocaleString('zh-CN')}`);
+    if (item.link) lines.push(`  ${item.link}`);
+  }
+  if (items.length > 5) lines.push(`\n...还有 ${items.length - 5} 条`);
+  return lines.join('\n');
+}