koishi-plugin-wordpress-notifier 2.9.0 → 2.9.3

package/lib/commands.d.ts

@@ -0,0 +1,16 @@
+import { Context } from 'koishi';
+import { Config } from './index';
+import { WordPressService } from './wordpress';
+import { StorageService } from './storage';
+import { ScheduleService } from './schedule';
+export declare class CommandService {
+    private ctx;
+    private config;
+    private wordpressService;
+    private storageService;
+    private scheduleService;
+    constructor(ctx: Context, config: Config, wordpressService: WordPressService, storageService: StorageService, scheduleService: ScheduleService);
+    private isSuperAdmin;
+    private isAdmin;
+    private initCommands;
+}

package/lib/commands.js

@@ -0,0 +1,325 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandService = void 0;
+// WordPress 推送插件命令系统 - 全新设计
+class CommandService {
+    constructor(ctx, config, wordpressService, storageService, scheduleService) {
+        this.ctx = ctx;
+        this.config = config;
+        this.wordpressService = wordpressService;
+        this.storageService = storageService;
+        this.scheduleService = scheduleService;
+        // 添加调试：确认服务已注入
+        if (!this.scheduleService) {
+            this.ctx.logger.error('致命错误: ScheduleService 未注入!');
+        }
+        else {
+            this.ctx.logger.info('CommandService 初始化成功，ScheduleService 已就绪');
+        }
+        this.initCommands();
+    }
+    // 检查用户是否为超级管理员
+    isSuperAdmin(userId) {
+        return this.config.superAdminUserIds?.includes(userId) || false;
+    }
+    // 检查用户是否为管理员（超级管理员或拥有足够权限）
+    isAdmin(session) {
+        const userId = session?.userId;
+        if (!userId)
+            return false;
+        // 优先检查超级管理员
+        if (this.isSuperAdmin(userId)) {
+            return true;
+        }
+        // 然后检查权限等级
+        return session?.user?.authority >= 3;
+    }
+    initCommands() {
+        // 直接注册所有命令为独立命令，使用 wp-xxx 格式
+        // 查看最新文章
+        this.ctx.command('wp-news [count]', '查看最新文章 (默认5篇)')
+            .action(async (argv, count) => {
+            try {
+                const articleCount = Math.min(parseInt(count || '5') || 5, 20);
+                const articles = await this.wordpressService.getLatestPosts(articleCount);
+                if (!articles || articles.length === 0) {
+                    return '📭 暂无最新文章';
+                }
+                let message = '📰 最新文章\n\n';
+                articles.forEach((article, index) => {
+                    const title = article.title?.rendered || '无标题';
+                    const date = new Date(article.date).toLocaleDateString('zh-CN');
+                    const link = article.link || this.config.wordpressUrl;
+                    const author = article.author_name || '未知作者';
+                    message += `${index + 1}. ${title}\n👤 ${author} | 📅 ${date}\n🔗 ${link}\n\n`;
+                });
+                return message;
+            }
+            catch (error) {
+                this.ctx.logger.error('获取最新文章失败:', error);
+                return `❌ 获取最新文章失败：${error instanceof Error ? error.message : '未知错误'}`;
+            }
+        });
+        // 浏览文章列表
+        this.ctx.command('wp-list [page]', '浏览文章列表 (每页10篇)')
+            .action(async (argv, page) => {
+            try {
+                const pageNum = Math.max(1, parseInt(page || '1') || 1);
+                const perPage = 10;
+                const articles = await this.wordpressService.getLatestPosts(perPage, pageNum);
+                if (!articles || articles.length === 0) {
+                    return '📭 暂无文章';
+                }
+                let message = `📋 文章列表 (第 ${pageNum} 页)\n\n`;
+                articles.forEach((article, index) => {
+                    const title = article.title?.rendered || '无标题';
+                    const date = new Date(article.date).toLocaleDateString('zh-CN');
+                    const link = article.link || this.config.wordpressUrl;
+                    const author = article.author_name || '未知作者';
+                    message += `${index + 1}. ${title}\n👤 ${author} | 📅 ${date}\n🔗 ${link}\n\n`;
+                });
+                return message;
+            }
+            catch (error) {
+                this.ctx.logger.error('获取文章列表失败:', error);
+                return `❌ 获取文章列表失败：${error instanceof Error ? error.message : '未知错误'}`;
+            }
+        });
+        // 查看文章详情
+        this.ctx.command('wp-post <id>', '查看指定文章详情')
+            .action(async (argv, id) => {
+            try {
+                const articleId = parseInt(id);
+                if (isNaN(articleId) || articleId <= 0) {
+                    return '❌ 请输入有效的文章 ID';
+                }
+                const article = await this.wordpressService.getPostById(articleId);
+                if (!article) {
+                    return '📭 文章不存在';
+                }
+                const title = article.title?.rendered || '无标题';
+                const author = article.author_name || '未知作者';
+                const date = new Date(article.date).toLocaleString('zh-CN');
+                const content = article.content?.rendered || '无内容';
+                const link = article.link || this.config.wordpressUrl;
+                const plainContent = content.replace(/<[^>]+>/g, '').trim();
+                const displayContent = plainContent.length > 500 ? plainContent.substring(0, 500) + '...' : plainContent;
+                return `📄 文章详情\n\n` +
+                    `🎯 标题：${title}\n` +
+                    `👤 作者：${author}\n` +
+                    `📅 时间：${date}\n\n` +
+                    `📝 内容：${displayContent}\n\n` +
+                    `🔗 阅读全文：${link}`;
+            }
+            catch (error) {
+                this.ctx.logger.error(`获取文章详情失败:`, error);
+                return `❌ 获取文章详情失败：${error instanceof Error ? error.message : '未知错误'}`;
+            }
+        });
+        // 控制推送开关（管理员）
+        this.ctx.command('wp-push [status]', '控制群推送开关 (仅管理员)')
+            .userFields(['authority'])
+            .action(async (argv, status) => {
+            try {
+                const session = argv.session;
+                if (!this.isAdmin(session)) {
+                    return '❌ 权限不足，需要管理员权限';
+                }
+                const groupId = session.channelId || 'global';
+                const pushConfig = await this.storageService.getPushConfig(groupId);
+                const currentStatus = pushConfig?.enabled || false;
+                if (!status) {
+                    return `📡 当前推送状态：${currentStatus ? '开启' : '关闭'}`;
+                }
+                const newStatus = status === 'on' ? true : status === 'off' ? false : !currentStatus;
+                if (newStatus === currentStatus) {
+                    return `📡 推送状态未变化：${currentStatus ? '开启' : '关闭'}`;
+                }
+                await this.storageService.setPushConfig({
+                    groupId,
+                    enabled: newStatus,
+                    enableUpdatePush: pushConfig?.enableUpdatePush || true,
+                    enableAtAll: pushConfig?.enableAtAll || false,
+                    lastPushTime: new Date()
+                });
+                return `📡 推送开关已${newStatus ? '开启' : '关闭'}`;
+            }
+            catch (error) {
+                this.ctx.logger.error('控制推送开关失败:', error);
+                return `❌ 操作失败：${error instanceof Error ? error.message : '未知错误'}`;
+            }
+        });
+        // 管理个人订阅
+        this.ctx.command('wp-sub [status]', '管理个人推送订阅')
+            .action(async (argv, status) => {
+            try {
+                const session = argv.session;
+                if (!session?.userId) {
+                    return '❌ 请在私聊或群聊中使用此命令';
+                }
+                const userId = session.userId;
+                const groupId = session.channelId || 'private';
+                const currentStatus = await this.storageService.isUserSubscribed(userId, groupId);
+                if (!status) {
+                    return `🔔 当前订阅状态：${currentStatus ? '开启' : '关闭'}`;
+                }
+                const newStatus = status === 'on' ? true : status === 'off' ? false : !currentStatus;
+                if (newStatus === currentStatus) {
+                    return `🔔 订阅状态未变化：${currentStatus ? '开启' : '关闭'}`;
+                }
+                await this.storageService.setUserSubscription(userId, groupId, newStatus);
+                return `🔔 订阅状态已${newStatus ? '开启' : '关闭'}`;
+            }
+            catch (error) {
+                this.ctx.logger.error('管理订阅失败:', error);
+                return `❌ 操作失败：${error instanceof Error ? error.message : '未知错误'}`;
+            }
+        });
+        // 手动检查推送（管理员）
+        this.ctx.command('wp-check', '手动触发一次推送检查 (仅管理员)')
+            .userFields(['authority'])
+            .action(async (argv) => {
+            try {
+                const session = argv.session;
+                // 1. 再次确认权限 (防御性编程)
+                if (!this.isAdmin(session)) {
+                    this.ctx.logger.warn(`用户 ${session?.userId} 权限不足，尝试执行 wp-check`);
+                    return '❌ 权限不足，需要管理员权限';
+                }
+                this.ctx.logger.info(`用户 ${session.userId} 手动触发推送检查`);
+                // 2. 执行检查
+                await this.scheduleService.triggerCheck();
+                // 3. 返回明确的成功消息，不要返回 undefined 或空
+                return '🔄 已触发推送检查\n\n' +
+                    '⏰ 检查过程可能需要几分钟\n' +
+                    '⚠️ 请勿重复触发，避免推送风暴\n' +
+                    '📢 检查结果将通过群聊通知';
+            }
+            catch (error) {
+                this.ctx.logger.error('手动检查推送内部错误:', error);
+                return `❌ 触发检查时发生内部错误：${error instanceof Error ? error.message : '未知错误'}`;
+            }
+        });
+        // 查看详细帮助
+        this.ctx.command('wp-help', '查看详细使用说明')
+            .action(() => {
+            return '📖 WordPress 推送插件帮助\n\n' +
+                '【文章相关】\n' +
+                'wp-news [数量]    查看最新文章 (默认5篇)\n' +
+                'wp-list [页码]    浏览文章列表 (每页10篇)\n' +
+                'wp-post <ID>      查看指定文章详情\n\n' +
+                '【推送管理】\n' +
+                'wp-push [on|off]  控制群推送开关 (管理员)\n' +
+                'wp-sub [on|off]   管理个人订阅\n' +
+                'wp-check          手动检查推送 (管理员)\n' +
+                'wp-status         查看插件状态\n' +
+                'wp-help           查看详细帮助\n\n' +
+                '【使用示例】\n' +
+                '• wp-news 8      → 查看最新8篇文章\n' +
+                '• wp-list 2      → 查看第2页文章\n' +
+                '• wp-post 456    → 查看ID为456的文章\n' +
+                '• wp-push on     → 开启群推送\n' +
+                '• wp-sub off     → 取消个人订阅\n' +
+                '• wp-check       → 手动检查推送\n' +
+                '• wp-status      → 查看插件状态\n\n' +
+                '💡 提示：所有命令都以 wp- 开头\n' +
+                '👑 管理员可以使用所有命令\n' +
+                '🙋 普通用户可以使用文章查询和个人订阅命令';
+        });
+        // 查看插件状态
+        this.ctx.command('wp-status', '查看插件状态')
+            .action(async (argv) => {
+            try {
+                const session = argv.session;
+                const groupId = session.channelId || 'global';
+                // 获取推送配置
+                const pushConfig = await this.storageService.getPushConfig(groupId);
+                // 获取 WordPress 服务状态
+                const wordpressStatus = this.wordpressService.getStatus();
+                // 构建状态信息
+                let statusMessage = '📊 WordPress 推送插件状态\n\n';
+                // 基本信息
+                statusMessage += '【基本信息】\n';
+                statusMessage += `WordPress 站点：${this.config.wordpressUrl}\n`;
+                statusMessage += `API 端点：${this.config.apiEndpoint || '/wp-json/wp/v2'}\n`;
+                statusMessage += `WordPress 连接：${wordpressStatus.isAuthenticated ? '正常' : '连接失败'}\n`;
+                if (wordpressStatus.inCooldown) {
+                    statusMessage += `认证冷却中：${wordpressStatus.cooldownTimeRemaining} 秒\n`;
+                }
+                statusMessage += `推送间隔：${this.config.checkInterval || 30} 分钟\n\n`;
+                // 推送配置
+                statusMessage += '【推送配置】\n';
+                statusMessage += `群推送状态：${pushConfig?.enabled ? '开启' : '关闭'}\n`;
+                statusMessage += `更新推送：${pushConfig?.enableUpdatePush ? '开启' : '关闭'}\n`;
+                statusMessage += `允许@全体：${pushConfig?.enableAtAll ? '开启' : '关闭'}\n`;
+                if (pushConfig?.lastPushTime) {
+                    statusMessage += `上次推送：${new Date(pushConfig.lastPushTime).toLocaleString('zh-CN')}\n`;
+                }
+                statusMessage += '\n';
+                // 个人订阅状态
+                if (session?.userId) {
+                    const isSubscribed = await this.storageService.isUserSubscribed(session.userId, groupId);
+                    statusMessage += '【个人订阅】\n';
+                    statusMessage += `订阅状态：${isSubscribed ? '开启' : '关闭'}\n\n`;
+                }
+                // 推送时间范围
+                statusMessage += '【推送时间】\n';
+                const startHour = this.config.pushStartTime || 9;
+                const endHour = this.config.pushEndTime || 22;
+                statusMessage += `允许推送时间：${startHour}:00-${endHour}:00\n`;
+                const currentHour = new Date().getHours();
+                const isPushTime = currentHour >= startHour && currentHour <= endHour;
+                statusMessage += `当前是否允许推送：${isPushTime ? '是' : '否'}\n\n`;
+                // 服务统计
+                statusMessage += '【服务统计】\n';
+                statusMessage += `总请求数：${wordpressStatus.stats.totalRequests}\n`;
+                statusMessage += `成功请求：${wordpressStatus.stats.successfulRequests}\n`;
+                statusMessage += `失败请求：${wordpressStatus.stats.failedRequests}\n`;
+                statusMessage += `成功率：${wordpressStatus.stats.successRate}\n`;
+                statusMessage += `平均响应时间：${wordpressStatus.stats.averageResponseTime}\n`;
+                statusMessage += `命令调用次数：${wordpressStatus.stats.commandCount}\n\n`;
+                // 缓存信息
+                statusMessage += '【缓存信息】\n';
+                statusMessage += `缓存大小：${wordpressStatus.cache.size}\n`;
+                statusMessage += `缓存时长：${wordpressStatus.cache.duration} 秒\n`;
+                statusMessage += `清理间隔：${wordpressStatus.cache.cleanupInterval} 秒\n\n`;
+                // 并发控制
+                statusMessage += '【并发控制】\n';
+                statusMessage += `最大并发：${wordpressStatus.concurrency.max}\n\n`;
+                // 功能特性
+                statusMessage += '【功能特性】\n';
+                statusMessage += `重试机制：${wordpressStatus.features.retryEnabled ? '开启' : '关闭'}\n`;
+                statusMessage += `重试次数：${wordpressStatus.features.retryLimit}\n`;
+                statusMessage += `缓存机制：${wordpressStatus.features.cacheEnabled ? '开启' : '关闭'}\n`;
+                statusMessage += `并发控制：${wordpressStatus.features.concurrencyControl ? '开启' : '关闭'}\n\n`;
+                // 命令提示
+                statusMessage += '💡 提示：\n';
+                statusMessage += '• 使用 wp-push on/off 开启/关闭群推送\n';
+                statusMessage += '• 使用 wp-sub on/off 开启/关闭个人订阅\n';
+                statusMessage += '• 使用 wp-check 手动触发推送检查\n';
+                statusMessage += '• 使用 wp-help 查看详细帮助';
+                return statusMessage;
+            }
+            catch (error) {
+                this.ctx.logger.error('获取插件状态失败:', error);
+                return `❌ 获取插件状态失败：${error instanceof Error ? error.message : '未知错误'}`;
+            }
+        });
+        // 主命令
+        this.ctx.command('wp', 'WordPress 推送插件主命令')
+            .action(() => {
+            return 'WordPress 推送插件命令帮助\n\n' +
+                '📖 可用命令：\n' +
+                '- wp-news [数量]    查看最新文章\n' +
+                '- wp-list [页码]    浏览文章列表\n' +
+                '- wp-post <ID>      查看文章详情\n' +
+                '- wp-push [on|off]  控制群推送开关 (管理员)\n' +
+                '- wp-sub [on|off]   管理个人订阅\n' +
+                '- wp-check          手动检查推送 (管理员)\n' +
+                '- wp-status         查看插件状态\n' +
+                '- wp-help           查看详细帮助\n\n' +
+                '💡 示例：wp-news 10 查看最新10篇文章';
+        });
+    }
+}
+exports.CommandService = CommandService;

package/lib/index.d.ts

@@ -1,99 +1,25 @@
 import { Context, Schema } from 'koishi';
+import { MessageType } from './push';
+export declare const name = "wordpress-push";
 export declare const inject: string[];
-export declare const name = "wordpress-notifier";
-declare module 'koishi' {
-    interface Tables {
-        wordpress_post_updates: WordPressPostUpdateRecord;
-        wordpress_user_registrations: WordPressUserRegistrationRecord;
-        wordpress_config: WordPressConfigRecord;
-        wordpress_version: WordPressVersionRecord;
-    }
-}
-export interface WordPressVersionRecord {
-    id: string;
-    version: string;
-    updatedAt: Date;
-}
-export interface WordPressConfigRecord {
-    id: string;
-    key: string;
-    value: string;
-    updatedAt: Date;
-}
-export interface WordPressSiteConfig {
-    id: string;
-    name: string;
-    url: string;
-    interval: number;
-    targets: string[];
-    enableAutoPush: boolean;
-    enableUpdatePush: boolean;
-    enableUserPush: boolean;
-    mentionAll: boolean;
-    maxArticles: number;
-    username?: string;
-    applicationPassword?: string;
-    pushTemplate: {
-        showExcerpt: boolean;
-        dateFormat: string;
-        linkPosition: 'top' | 'bottom' | 'none';
-        showAuthor: boolean;
-    };
-}
 export interface Config {
-    sites: WordPressSiteConfig[];
-    superAdmins: string[];
-    failureNotification: {
-        enable: boolean;
-        threshold: number;
-        notificationTargets: string[];
-    };
-}
-export interface WordPressPost {
-    id: string;
-    title: {
-        rendered: string;
-    };
-    link: string;
-    date: string;
-    modified: string;
-    excerpt: {
-        rendered: string;
-    };
-    author: string;
-    categories: string[];
-    tags: string[];
-}
-export interface WordPressUser {
-    id: string;
-    name: string;
-    slug: string;
-    date?: string;
-    date_registered?: string;
-    registered_date?: string;
-    user_registered?: string;
-    created_at?: string;
-    registeredAt?: string;
-    email: string;
-    roles: string[];
-    [key: string]: any;
-}
-export interface WordPressPostUpdateRecord {
-    id: number;
-    siteId: string;
-    postId: number;
-    lastModified: Date;
-    pushedAt: Date;
-}
-export interface WordPressUserRegistrationRecord {
-    id: number;
-    siteId: string;
-    userId: number;
-    pushedAt: Date;
-}
-export interface WordPressNotification {
-    type: 'post' | 'update' | 'user';
-    data: any;
-}
-export declare const Config: Schema<Config>;
+    wordpressUrl: string;
+    apiEndpoint?: string;
+    authType?: 'none' | 'basic' | 'application-password';
+    username?: string;
+    password?: string;
+    checkInterval?: number;
+    enableAutoPush?: boolean;
+    enableUpdatePush?: boolean;
+    enableUserRegisterPush?: boolean;
+    defaultGroups?: string[];
+    allowAtAll?: boolean;
+    messageType?: MessageType;
+    signatureKey?: string;
+    adminUserId?: string;
+    superAdminUserIds?: string[];
+    pushStartTime?: number;
+    pushEndTime?: number;
+}
+export declare const schema: Schema<Config>;
 export declare function apply(ctx: Context, config: Config): void;