koishi-plugin-wordpress-notifier 2.9.1 → 2.9.4

package/lib/commands.js

@@ -1,98 +1,74 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CommandService = void 0;
-// 简化实现，避免继承 Service 类的问题
+// WordPress 推送插件命令系统 - 全新设计
 class CommandService {
-    constructor(ctx, config, wordpressService, storageService) {
+    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() {
-        // 创建父命令
-        const wordpressParent = this.ctx.command('wordpress', 'WordPress 推送插件主命令');
-        const wpParent = this.ctx.command('wp', 'WordPress 推送插件主命令（简写）');
-        // 查询最新文章
-        wordpressParent
-            .subcommand('.最新 [count]', '查询 WordPress 最新文章')
-            .alias('.latest')
-            .action(async ({ session }, count) => {
+        // 直接注册所有命令为独立命令，使用 wp-xxx 格式
+        // 查看最新文章
+        this.ctx.command('wp-news [count]', '查看最新文章 (默认5篇)')
+            .action(async (argv, count) => {
             try {
-                // 发送加载提示
-                if (session) {
-                    await session.send('🔍 正在查询最新文章...');
-                }
-                const articleCount = Math.min(parseInt(count || '5') || 5, 20); // 限制最多20篇
-                // 使用真实的 WordPress API 获取最新文章
+                const articleCount = Math.min(parseInt(count || '5') || 5, 20);
                 const articles = await this.wordpressService.getLatestPosts(articleCount);
                 if (!articles || articles.length === 0) {
-                    return '暂无最新文章';
+                    return '📭 暂无最新文章';
                 }
-                let message = '📰 最新文章列表\n\n';
+                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}\n发布时间：${date}\n链接：${link}\n\n`;
+                    message += `${index + 1}. ${title}\n👤 ${author} | 📅 ${date}\n🔗 ${link}\n\n`;
                 });
                 return message;
             }
             catch (error) {
-                this.ctx.logger.error('Failed to get latest posts:', error);
-                return '获取最新文章失败';
+                this.ctx.logger.error('获取最新文章失败:', error);
+                return `❌ 获取最新文章失败：${error instanceof Error ? error.message : '未知错误'}`;
             }
         });
-        wpParent
-            .subcommand('.latest [count]', '查询 WordPress 最新文章')
-            .alias('.最新')
-            .action(async ({ session }, count) => {
+        // 浏览文章列表
+        this.ctx.command('wp-list [page]', '浏览文章列表 (每页10篇)')
+            .action(async (argv, page) => {
             try {
-                // 发送加载提示
-                if (session) {
-                    await session.send('🔍 正在查询最新文章...');
-                }
-                const articleCount = Math.min(parseInt(count || '5') || 5, 20); // 限制最多20篇
-                // 使用真实的 WordPress API 获取最新文章
-                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}\n发布时间：${date}\n链接：${link}\n\n`;
-                });
-                return message;
-            }
-            catch (error) {
-                this.ctx.logger.error('Failed to get latest posts:', error);
-                return '获取最新文章失败';
-            }
-        });
-        // 查询文章列表
-        wordpressParent
-            .subcommand('.列表 [page] [perPage]', '查询 WordPress 文章列表')
-            .alias('.list')
-            .action(async ({ session }, page, perPage) => {
-            try {
-                // 发送加载提示
-                if (session) {
-                    await session.send('🔍 正在查询文章列表...');
-                }
-                // 验证分页参数
                 const pageNum = Math.max(1, parseInt(page || '1') || 1);
-                const perPageNum = Math.min(20, Math.max(1, parseInt(perPage || '10') || 10)); // 限制每页最多20条
-                // 使用真实的 WordPress API 获取文章列表
-                // 注意：WordPress REST API 默认从第1页开始，这里直接使用 pageNum
-                const articles = await this.wordpressService.getLatestPosts(perPageNum);
+                const perPage = 10;
+                const articles = await this.wordpressService.getLatestPosts(perPage, pageNum);
                 if (!articles || articles.length === 0) {
-                    return '暂无文章';
+                    return '📭 暂无文章';
                 }
                 let message = `📋 文章列表 (第 ${pageNum} 页)\n\n`;
                 articles.forEach((article, index) => {
@@ -100,146 +76,65 @@ class CommandService {
                     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}\n发布时间：${date}\n链接：${link}\n\n`;
+                    message += `${index + 1}. ${title}\n👤 ${author} | 📅 ${date}\n🔗 ${link}\n\n`;
                 });
                 return message;
             }
             catch (error) {
-                this.ctx.logger.error('Failed to get posts:', error);
-                return '获取文章列表失败';
-            }
-        });
-        wpParent
-            .subcommand('.list [page] [perPage]', '查询 WordPress 文章列表')
-            .alias('.列表')
-            .action(async ({ session }, page, perPage) => {
-            try {
-                // 发送加载提示
-                if (session) {
-                    await session.send('🔍 正在查询文章列表...');
-                }
-                // 验证分页参数
-                const pageNum = Math.max(1, parseInt(page || '1') || 1);
-                const perPageNum = Math.min(20, Math.max(1, parseInt(perPage || '10') || 10)); // 限制每页最多20条
-                // 使用真实的 WordPress API 获取文章列表
-                // 注意：WordPress REST API 默认从第1页开始，这里直接使用 pageNum
-                const articles = await this.wordpressService.getLatestPosts(perPageNum);
-                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}\n发布时间：${date}\n链接：${link}\n\n`;
-                });
-                return message;
-            }
-            catch (error) {
-                this.ctx.logger.error('Failed to get posts:', error);
-                return '获取文章列表失败';
-            }
-        });
-        // 查询单篇文章
-        wordpressParent
-            .subcommand('.文章 <id>', '查询指定 WordPress 文章')
-            .alias('.article')
-            .action(async ({ session }, id) => {
-            try {
-                // 验证 ID 参数
-                const articleId = parseInt(id);
-                if (isNaN(articleId) || articleId <= 0) {
-                    return '请输入有效的文章 ID（必须是正整数）';
-                }
-                // 发送加载提示
-                if (session) {
-                    await session.send(`🔍 正在查询文章 ID: ${articleId}...`);
-                }
-                // 使用真实的 WordPress API 获取文章详情
-                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;
-                // 移除 HTML 标签并截断内容
-                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(`Failed to get post ${id}:`, error);
-                return '获取文章详情失败';
+                this.ctx.logger.error('获取文章列表失败:', error);
+                return `❌ 获取文章列表失败：${error instanceof Error ? error.message : '未知错误'}`;
             }
         });
-        wpParent
-            .subcommand('.article <id>', '查询指定 WordPress 文章')
-            .alias('.文章')
-            .action(async ({ session }, id) => {
+        // 查看文章详情
+        this.ctx.command('wp-post <id>', '查看指定文章详情')
+            .action(async (argv, id) => {
             try {
-                // 验证 ID 参数
                 const articleId = parseInt(id);
                 if (isNaN(articleId) || articleId <= 0) {
-                    return '请输入有效的文章 ID（必须是正整数）';
+                    return '❌ 请输入有效的文章 ID';
                 }
-                // 发送加载提示
-                if (session) {
-                    await session.send(`🔍 正在查询文章 ID: ${articleId}...`);
-                }
-                // 使用真实的 WordPress API 获取文章详情
                 const article = await this.wordpressService.getPostById(articleId);
                 if (!article) {
-                    return '文章不存在';
+                    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;
-                // 移除 HTML 标签并截断内容
                 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}`;
+                return `📄 文章详情\n\n` +
+                    `🎯 标题：${title}\n` +
+                    `👤 作者：${author}\n` +
+                    `📅 时间：${date}\n\n` +
+                    `📝 内容：${displayContent}\n\n` +
+                    `🔗 阅读全文：${link}`;
             }
             catch (error) {
-                this.ctx.logger.error(`Failed to get post ${id}:`, error);
-                return '获取文章详情失败';
+                this.ctx.logger.error(`获取文章详情失败:`, error);
+                return `❌ 获取文章详情失败：${error instanceof Error ? error.message : '未知错误'}`;
             }
         });
-        // 推送开关控制
-        wordpressParent
-            .subcommand('.开关 [status]', '控制 WordPress 推送开关')
-            .alias('.toggle')
+        // 控制推送开关（管理员）
+        this.ctx.command('wp-push [status]', '控制群推送开关 (仅管理员)')
             .userFields(['authority'])
-            .action(async ({ session }, status) => {
+            .action(async (argv, status) => {
             try {
-                // 检查权限：需要管理员权限
-                if (!session?.user?.authority || session.user.authority < 3) {
-                    return '权限不足，需要管理员权限才能执行此操作';
-                }
-                if (!session.channelId) {
-                    return '请在群聊中使用此命令';
+                const session = argv.session;
+                if (!this.isAdmin(session)) {
+                    return '❌ 权限不足，需要管理员权限';
                 }
-                const groupId = session.channelId;
-                // 获取当前状态
+                const groupId = session.channelId || 'global';
                 const pushConfig = await this.storageService.getPushConfig(groupId);
                 const currentStatus = pushConfig?.enabled || false;
-                // 如果没有指定状态，返回当前状态
                 if (!status) {
-                    return `当前推送开关状态：${currentStatus ? '开启' : '关闭'}`;
+                    return `📡 当前推送状态：${currentStatus ? '开启' : '关闭'}`;
                 }
-                // 计算新状态
                 const newStatus = status === 'on' ? true : status === 'off' ? false : !currentStatus;
-                // 如果状态没有变化，返回提示
                 if (newStatus === currentStatus) {
-                    return `推送开关状态未变化，当前状态：${currentStatus ? '开启' : '关闭'}`;
+                    return `📡 推送状态未变化：${currentStatus ? '开启' : '关闭'}`;
                 }
-                // 更新存储中的状态
                 await this.storageService.setPushConfig({
                     groupId,
                     enabled: newStatus,
@@ -247,144 +142,183 @@ class CommandService {
                     enableAtAll: pushConfig?.enableAtAll || false,
                     lastPushTime: new Date()
                 });
-                return `推送开关已${newStatus ? '开启' : '关闭'}`;
+                return `📡 推送开关已${newStatus ? '开启' : '关闭'}`;
             }
             catch (error) {
-                this.ctx.logger.error('Failed to toggle push:', error);
-                return '操作失败';
+                this.ctx.logger.error('控制推送开关失败:', error);
+                return `❌ 操作失败：${error instanceof Error ? error.message : '未知错误'}`;
             }
         });
-        wpParent
-            .subcommand('.toggle [status]', '控制 WordPress 推送开关')
-            .alias('.开关')
-            .userFields(['authority'])
-            .action(async ({ session }, status) => {
+        // 管理个人订阅
+        this.ctx.command('wp-sub [status]', '管理个人推送订阅')
+            .action(async (argv, status) => {
             try {
-                // 检查权限：需要管理员权限
-                if (!session?.user?.authority || session.user.authority < 3) {
-                    return '权限不足，需要管理员权限才能执行此操作';
-                }
-                if (!session.channelId) {
-                    return '请在群聊中使用此命令';
+                const session = argv.session;
+                if (!session?.userId) {
+                    return '❌ 请在私聊或群聊中使用此命令';
                 }
-                const groupId = session.channelId;
-                // 获取当前状态
-                const pushConfig = await this.storageService.getPushConfig(groupId);
-                const currentStatus = pushConfig?.enabled || false;
-                // 如果没有指定状态，返回当前状态
+                const userId = session.userId;
+                const groupId = session.channelId || 'private';
+                const currentStatus = await this.storageService.isUserSubscribed(userId, groupId);
                 if (!status) {
-                    return `当前推送开关状态：${currentStatus ? '开启' : '关闭'}`;
+                    return `🔔 当前订阅状态：${currentStatus ? '开启' : '关闭'}`;
                 }
-                // 计算新状态
                 const newStatus = status === 'on' ? true : status === 'off' ? false : !currentStatus;
-                // 如果状态没有变化，返回提示
                 if (newStatus === currentStatus) {
-                    return `推送开关状态未变化，当前状态：${currentStatus ? '开启' : '关闭'}`;
+                    return `🔔 订阅状态未变化：${currentStatus ? '开启' : '关闭'}`;
                 }
-                // 更新存储中的状态
-                await this.storageService.setPushConfig({
-                    groupId,
-                    enabled: newStatus,
-                    enableUpdatePush: pushConfig?.enableUpdatePush || true,
-                    enableAtAll: pushConfig?.enableAtAll || false,
-                    lastPushTime: new Date()
-                });
-                return `推送开关已${newStatus ? '开启' : '关闭'}`;
+                await this.storageService.setUserSubscription(userId, groupId, newStatus);
+                return `🔔 订阅状态已${newStatus ? '开启' : '关闭'}`;
             }
             catch (error) {
-                this.ctx.logger.error('Failed to toggle push:', error);
-                return '操作失败';
+                this.ctx.logger.error('管理订阅失败:', error);
+                return `❌ 操作失败：${error instanceof Error ? error.message : '未知错误'}`;
             }
         });
-        // 订阅管理
-        wordpressParent
-            .subcommand('.订阅 [status]', '管理 WordPress 推送订阅')
-            .alias('.subscribe')
-            .action(async ({ session }, status) => {
+        // 手动检查推送（管理员）
+        this.ctx.command('wp-check', '手动触发一次推送检查 (仅管理员)')
+            .userFields(['authority'])
+            .action(async (argv) => {
             try {
-                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 ? '开启' : '关闭'}`;
+                const session = argv.session;
+                // 1. 再次确认权限 (防御性编程)
+                if (!this.isAdmin(session)) {
+                    this.ctx.logger.warn(`用户 ${session?.userId} 权限不足，尝试执行 wp-check`);
+                    return '❌ 权限不足，需要管理员权限';
                 }
-                // 更新存储中的订阅状态
-                await this.storageService.setUserSubscription(userId, groupId, newStatus);
-                return `订阅状态已${newStatus ? '开启' : '关闭'}`;
+                this.ctx.logger.info(`用户 ${session.userId} 手动触发推送检查`);
+                // 2. 执行检查
+                await this.scheduleService.triggerCheck();
+                // 3. 返回明确的成功消息，不要返回 undefined 或空
+                return '🔄 已触发推送检查\n\n' +
+                    '⏰ 检查过程可能需要几分钟\n' +
+                    '⚠️ 请勿重复触发，避免推送风暴\n' +
+                    '📢 检查结果将通过群聊通知';
             }
             catch (error) {
-                this.ctx.logger.error('Failed to toggle subscription:', error);
-                return '操作失败';
+                this.ctx.logger.error('手动检查推送内部错误:', error);
+                return `❌ 触发检查时发生内部错误：${error instanceof Error ? error.message : '未知错误'}`;
             }
         });
-        wpParent
-            .subcommand('.subscribe [status]', '管理 WordPress 推送订阅')
-            .alias('.订阅')
-            .action(async ({ session }, status) => {
+        // 查看详细帮助
+        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 {
-                if (!session?.userId) {
-                    return '请在私聊或群聊中使用此命令';
+                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`;
                 }
-                const userId = session.userId;
-                const groupId = session.channelId || 'private';
-                // 获取当前订阅状态
-                const currentStatus = await this.storageService.isUserSubscribed(userId, groupId);
-                // 如果没有指定状态，返回当前订阅状态
-                if (!status) {
-                    return `当前订阅状态：${currentStatus ? '开启' : '关闭'}`;
+                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`;
                 }
-                // 计算新状态
-                const newStatus = status === 'on' ? true : status === 'off' ? false : !currentStatus;
-                // 如果状态没有变化，返回提示
-                if (newStatus === currentStatus) {
-                    return `订阅状态未变化，当前状态：${currentStatus ? '开启' : '关闭'}`;
+                statusMessage += '\n';
+                // 个人订阅状态
+                if (session?.userId) {
+                    const isSubscribed = await this.storageService.isUserSubscribed(session.userId, groupId);
+                    statusMessage += '【个人订阅】\n';
+                    statusMessage += `订阅状态：${isSubscribed ? '开启' : '关闭'}\n\n`;
                 }
-                // 更新存储中的订阅状态
-                await this.storageService.setUserSubscription(userId, groupId, newStatus);
-                return `订阅状态已${newStatus ? '开启' : '关闭'}`;
+                // 推送时间范围
+                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('Failed to toggle subscription:', error);
-                return '操作失败';
+                this.ctx.logger.error('获取插件状态失败:', error);
+                return `❌ 获取插件状态失败：${error instanceof Error ? error.message : '未知错误'}`;
             }
         });
-        // 帮助指令
-        wordpressParent
-            .subcommand('.帮助', '查看 WordPress 插件帮助')
-            .alias('.help')
-            .action(() => {
-            return `📖 WordPress 推送插件帮助\n\n` +
-                `1. wordpress 最新 / wp latest [数量] - 查询最新文章\n` +
-                `2. wordpress 列表 / wp list [页码] [数量] - 查询文章列表\n` +
-                `3. wordpress 文章 / wp article <ID> - 查询单篇文章\n` +
-                `4. wordpress 开关 / wp toggle [on|off] - 控制推送开关 (管理员)\n` +
-                `5. wordpress 订阅 / wp subscribe [on|off] - 管理个人订阅\n` +
-                `6. wordpress 帮助 / wp help - 查看此帮助\n\n` +
-                `🤖 由 WordPress 推送机器人提供`;
-        });
-        wpParent
-            .subcommand('.help', '查看 WordPress 插件帮助')
-            .alias('.帮助')
+        // 主命令
+        this.ctx.command('wp', 'WordPress 推送插件主命令')
             .action(() => {
-            return `📖 WordPress 推送插件帮助\n\n` +
-                `1. wordpress 最新 / wp latest [数量] - 查询最新文章\n` +
-                `2. wordpress 列表 / wp list [页码] [数量] - 查询文章列表\n` +
-                `3. wordpress 文章 / wp article <ID> - 查询单篇文章\n` +
-                `4. wordpress 开关 / wp toggle [on|off] - 控制推送开关 (管理员)\n` +
-                `5. wordpress 订阅 / wp subscribe [on|off] - 管理个人订阅\n` +
-                `6. wordpress 帮助 / wp help - 查看此帮助\n\n` +
-                `🤖 由 WordPress 推送机器人提供`;
+            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篇文章';
         });
     }
 }

package/lib/index.d.ts

@@ -16,6 +16,10 @@ export interface Config {
     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;