koishi-plugin-youtube-notifier 1.0.7

package/README.md

@@ -0,0 +1,70 @@
+# koishi-plugin-youtube-notifier
+
+[![npm](https://img.shields.io/npm/v/koishi-plugin-youtube-notifier?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-youtube-notifier)
+[![GitHub](https://img.shields.io/github/license/svip886/koishi-plugin-youtube-notifier?style=flat-square)](https://github.com/svip886/koishi-plugin-youtube-notifier/blob/main/LICENSE)
+
+YouTube 频道动态与直播开播提醒插件，支持 Puppeteer 抓取、数据库持久化及自定义代理。
+
+## 功能特性
+
+- **多频道监控**：支持同时监控多个 YouTube 频道的社区动态和直播状态。
+- **多平台推送**：支持将消息推送到自定义的群组。
+- **Puppeteer 驱动**：使用 Puppeteer 进行页面解析，支持复杂的页面渲染。
+- **自定义代理**：支持配置 HTTP 代理，解决国内环境网络访问问题。
+- **Notifier 集成**：支持 Koishi 的 `notifier` 服务，提供更好的通知展示。
+- **状态持久化**：使用数据库记录上次推送状态，防止重复通知。
+
+## 安装
+
+```bash
+npm install koishi-plugin-youtube-notifier
+```
+
+## 配置项
+
+| 参数 | 类型 | 默认值 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `channels` | `array` | `[]` | 订阅频道列表，包含 `id` (频道ID) 和 `targets` (推送群组ID列表) |
+| `interval` | `number` | `300000` | 轮询间隔（毫秒），默认为 5 分钟 |
+| `proxy` | `string` | - | 代理服务器地址，例如 `http://127.0.0.1:7890` |
+
+## 依赖项
+
+本插件需要以下服务支持：
+- `puppeteer`: 用于网页抓取
+- `database`: 用于状态持久化
+- `notifier` (可选): 用于结构化通知
+
+## 开源协议
+
+MIT License.
+
+## 更新日志
+
+### 1.0.7
+
+- **修复**：显式声明 `"type": "commonjs"` 以彻底解决 ESM 加载冲突。
+
+### 1.0.6
+
+- **回退**：将项目回退为 CommonJS 模式，以解决部分环境下的 `ERR_REQUIRE_ESM` 加载错误。
+
+### 1.0.5
+
+- **重要更新**：项目切换为 ESM (ECMAScript Module) 模式。
+- **修复**：修正了 Puppeteer 浏览器启动逻辑，支持正确的 `executablePath` 获取。
+- **修复**：修正了 HTTP 代理配置属性名为 `proxyAgent`。
+- **优化**：优化了 npm 发布包体积，移除了不必要的源码、配置和缓存文件。
+- **安全**：移除了仓库中的 `package-lock.json`。
+
+### 1.0.0
+
+- 初始版本发布。
+- 支持 YouTube 频道社区动态监控。
+- 支持 YouTube 直播状态监控。
+- 支持 Puppeteer 抓取与自定义代理配置。
+- 集成 Koishi 数据库与通知服务。
+
+## 仓库地址
+
+[GitHub Repository](https://github.com/svip886/koishi-plugin-youtube-notifier.git)

package/dist/index.d.ts

@@ -0,0 +1,37 @@
+import { Context, Schema } from 'koishi';
+export declare const name = "youtube-notifier";
+export declare const inject: {
+    required: string[];
+    optional: string[];
+};
+export interface Config {
+    channels: {
+        id: string;
+        targets: string[];
+    }[];
+    interval: number;
+    proxy?: string;
+}
+export declare const Config: Schema<Config>;
+declare module 'koishi' {
+    interface Tables {
+        youtube_status: YoutubeStatus;
+    }
+    interface Context {
+        notifier: Notifier;
+    }
+}
+export interface Notifier {
+    create(options: {
+        title: string;
+        content: string;
+        target: string;
+    }): Promise<void>;
+}
+export interface YoutubeStatus {
+    id: string;
+    lastPostId: string;
+    lastLiveId: string;
+    isLive: boolean;
+}
+export declare function apply(ctx: Context, config: Config): void;

package/dist/index.js

@@ -0,0 +1,138 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = exports.inject = exports.name = void 0;
+exports.apply = apply;
+const koishi_1 = require("koishi");
+const puppeteer_core_1 = __importDefault(require("puppeteer-core"));
+exports.name = 'youtube-notifier';
+exports.inject = {
+    required: ['puppeteer', 'database'],
+    optional: ['notifier'],
+};
+exports.Config = koishi_1.Schema.object({
+    channels: koishi_1.Schema.array(koishi_1.Schema.object({
+        id: koishi_1.Schema.string().required().description('YouTube 频道 ID (例如 UC-hM6YJuNYV19LAJg37K9Bw)'),
+        targets: koishi_1.Schema.array(koishi_1.Schema.string()).description('推送目标群组 ID'),
+    })).description('订阅频道列表'),
+    interval: koishi_1.Schema.number().default(300000).description('轮询间隔 (毫秒)'),
+    proxy: koishi_1.Schema.string().description('代理服务器地址 (例如 http://127.0.0.1:7890)'),
+});
+async function getChannelStatus(ctx, channelId, proxy) {
+    const browser = await puppeteer_core_1.default.launch({
+        executablePath: ctx.puppeteer.executable,
+        args: proxy ? [`--proxy-server=${proxy}`] : [],
+    });
+    const page = await browser.newPage();
+    try {
+        // 检查社区帖子
+        await page.goto(`https://www.youtube.com/channel/${channelId}/community`, { waitUntil: 'networkidle2' });
+        const lastPostId = await page.evaluate(() => {
+            const element = document.querySelector('ytd-backstage-post-thread-renderer');
+            return element?.getAttribute('id') || '';
+        });
+        // 检查直播状态
+        await page.goto(`https://www.youtube.com/channel/${channelId}/live`, { waitUntil: 'networkidle2' });
+        const isLive = await page.evaluate(() => {
+            return !!document.querySelector('meta[itemprop="isLiveBroadcast"][content="True"]');
+        });
+        let lastLiveId = '';
+        if (isLive) {
+            lastLiveId = await page.evaluate(() => {
+                const link = document.querySelector('link[rel="canonical"]');
+                return link?.getAttribute('href')?.split('v=')[1] || '';
+            });
+        }
+        return { lastPostId, isLive, lastLiveId };
+    }
+    finally {
+        await browser.close();
+    }
+}
+function apply(ctx, config) {
+    ctx.model.extend('youtube_status', {
+        id: 'string',
+        lastPostId: 'string',
+        lastLiveId: 'string',
+        isLive: 'boolean',
+    }, {
+        primary: 'id',
+    });
+    ctx.on('ready', async () => {
+        // 代理可用性检测
+        if (config.proxy) {
+            try {
+                await ctx.http.get('https://www.youtube.com', {
+                    proxyAgent: config.proxy,
+                    timeout: 10000,
+                });
+                ctx.logger('youtube-notifier').info(`代理检测成功: ${config.proxy}`);
+            }
+            catch (e) {
+                ctx.logger('youtube-notifier').warn(`代理检测失败: ${config.proxy}, 请检查代理配置或网络环境`);
+            }
+        }
+        const timer = setInterval(async () => {
+            for (const channelConfig of config.channels) {
+                try {
+                    const current = await getChannelStatus(ctx, channelConfig.id, config.proxy);
+                    const [saved] = await ctx.database.get('youtube_status', { id: channelConfig.id });
+                    if (!saved) {
+                        // 初次运行，仅保存当前状态不推送
+                        await ctx.database.create('youtube_status', {
+                            id: channelConfig.id,
+                            ...current
+                        });
+                        continue;
+                    }
+                    // 新动态提醒
+                    if (current.lastPostId && current.lastPostId !== saved.lastPostId) {
+                        const title = `YouTube 新动态`;
+                        const content = `频道 ${channelConfig.id} 发布了新动态：https://www.youtube.com/post/${current.lastPostId}`;
+                        if (ctx.notifier) {
+                            for (const target of channelConfig.targets) {
+                                await ctx.notifier.create({
+                                    title,
+                                    content,
+                                    target,
+                                });
+                            }
+                        }
+                        else {
+                            for (const target of channelConfig.targets) {
+                                ctx.broadcast([target], `[${title}] ${content}`);
+                            }
+                        }
+                    }
+                    // 开播状态变更提醒
+                    if (current.isLive && (!saved.isLive || current.lastLiveId !== saved.lastLiveId)) {
+                        const title = `YouTube 开播提醒`;
+                        const content = `频道 ${channelConfig.id} 正在直播！\n传送门：https://www.youtube.com/watch?v=${current.lastLiveId}`;
+                        if (ctx.notifier) {
+                            for (const target of channelConfig.targets) {
+                                await ctx.notifier.create({
+                                    title,
+                                    content,
+                                    target,
+                                });
+                            }
+                        }
+                        else {
+                            for (const target of channelConfig.targets) {
+                                ctx.broadcast([target], `[${title}] ${content}`);
+                            }
+                        }
+                    }
+                    // 更新数据库记录
+                    await ctx.database.set('youtube_status', channelConfig.id, current);
+                }
+                catch (e) {
+                    ctx.logger('youtube-notifier').error(`检查频道 ${channelConfig.id} 失败:`, e);
+                }
+            }
+        }, config.interval);
+        ctx.on('dispose', () => clearInterval(timer));
+    });
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "koishi-plugin-youtube-notifier",
+  "version": "1.0.7",
+  "description": "YouTube channel post and live notifier for Koishi",
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "keywords": [
+    "koishi",
+    "plugin",
+    "youtube",
+    "notifier",
+    "puppeteer"
+  ],
+  "author": "Qoder",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/svip886/koishi-plugin-youtube-notifier.git"
+  },
+  "bugs": {
+    "url": "https://github.com/svip886/koishi-plugin-youtube-notifier/issues"
+  },
+  "homepage": "https://github.com/svip886/koishi-plugin-youtube-notifier#readme",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "koishi": {
+    "description": {
+      "zh": "YouTube 频道动态与直播开播提醒"
+    },
+    "service": {
+      "required": [
+        "puppeteer",
+        "database"
+      ],
+      "optional": [
+        "notifier"
+      ]
+    }
+  },
+  "dependencies": {
+    "koishi-plugin-puppeteer": "^3.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "koishi": "^4.17.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "koishi": "^4.17.0"
+  }
+}