koishi-plugin-wordpress-notifier 1.7.0 → 1.8.0

package/README.md

@@ -2,15 +2,16 @@
 
 自动从 WordPress 网站获取最新文章并推送到指定 QQ 群或私聊。
 
-## 功能特性
-
-- ✅ 自动从 WordPress REST API 获取最新文章
-- ✅ 定时推送新文章到指定 QQ 群或私聊
-- ✅ 支持手动查询最新文章和文章列表
-- ✅ 支持 @全体成员
-- ✅ 完善的去重机制，避免重复推送
-- ✅ 数据库持久化存储，机器人重启不丢失记录
-- ✅ 采用服务模式架构，便于扩展和维护
+## 功能特性
+
+- ✅ 自动从 WordPress REST API 获取最新文章
+- ✅ 定时推送新文章到指定 QQ 群或私聊
+- ✅ 支持手动查询最新文章和文章列表
+- ✅ 支持查询 WordPress 站点用户信息
+- ✅ 支持 @全体成员
+- ✅ 完善的去重机制，避免重复推送
+- ✅ 数据库持久化存储，机器人重启不丢失记录
+- ✅ 采用服务模式架构，便于扩展和维护
 - ✅ 支持自动推送开关
 
 ## 安装
@@ -46,14 +47,15 @@ plugins:
 
 ### 配置参数说明
 
-| 参数 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| `wordpressUrl` | string | 必填 | WordPress 网站地址（例如：https://example.com） |
-| `interval` | number | 3600000 | 检查间隔，单位毫秒（默认 1 小时 = 3600000 毫秒） |
-| `targets` | array | 必填 | 推送目标列表，可以是群号或 QQ 号 |
-| `enableAutoPush` | boolean | true | 是否启用自动推送 |
-| `mentionAll` | boolean | false | 是否在推送时 @全体成员 |
-| `maxArticles` | number | 5 | 每次最多推送的文章数量 |
+| 参数 | 类型 | 默认值 | 说明 |
+|------|------|--------|------|
+| `wordpressUrl` | string | 必填 | WordPress 网站地址（例如：https://example.com） |
+| `interval` | number | 3600000 | 检查间隔，单位毫秒（默认 1 小时 = 3600000 毫秒） |
+| `targets` | array | 必填 | 推送目标列表，可以是群号或 QQ 号 |
+| `enableAutoPush` | boolean | true | 是否启用自动推送 |
+| `mentionAll` | boolean | false | 是否在推送时 @全体成员 |
+| `maxArticles` | number | 5 | 每次最多推送的文章数量 |
+| `superAdmins` | array | [] | 超级管理员列表（QQ 号），拥有修改站点地址的权限 |
 
 ## 使用命令
 
@@ -97,14 +99,54 @@ plugins:
 
 开启或关闭自动推送功能。
 
-### 切换 @全体成员 开关
-
-```
-/wordpress.mention
-```
-
-开启或关闭 @全体成员 功能。
-
+### 切换 @全体成员 开关
+
+```
+/wordpress.mention
+```
+
+开启或关闭 @全体成员 功能。
+
+### 查看站点用户列表
+
+```
+/wordpress.users
+```
+
+显示 WordPress 站点的所有用户列表，包含用户 ID、名称、角色和个人主页链接。
+
+### 查看特定用户信息
+
+```
+/wordpress.user <id>
+```
+
+显示指定 ID 用户的详细信息，包括用户 ID、昵称、角色、个人主页、注册时间和个人简介。
+
+### 修改 WordPress 站点地址
+
+```
+/wordpress.set-url <url>
+```
+
+修改 WordPress 站点地址，仅超级管理员可用。
+
+### 查看已推送文章列表
+
+```
+/wordpress.pushed
+```
+
+查看已推送的文章列表，按推送时间倒序排列，显示文章 ID 和推送时间。
+
+### 清理旧推送记录
+
+```
+/wordpress.clean [days]
+```
+
+清理指定天数前的推送记录，默认清理 30 天前的记录，仅超级管理员可用。
+
 ### 插件菜单
 
 ```
@@ -204,32 +246,63 @@ cd external/wordpress-notifier
 npm install
 ```
 
-## 版本历史
-
-### 1.3.0 (2024-01-14)
-
-- 📝 更新作者邮箱为 kate522@88.com
-- 🔗 更新仓库地址为正确的 GitHub URL
-- 📝 优化 README.md 文档和链接
-
-### 1.2.0 (2024-01-14)
-
-- 📝 优化 README.md 文档，添加详细的安装说明和常见问题
-- 📦 优化 npm 包结构，只包含必要文件
-
-### 1.1.0 (2024-01-14)
-
-- ✨ 新增数据库持久化存储功能
-- 🐛 修复推送目标配置问题，使用 `ctx.broadcast([target], message)` 正确发送到指定目标
-- 🐛 修复 HTTP 服务注入问题，添加 `'http'` 到 inject 数组
-- 📝 添加 `.npmignore` 文件，确保 npm 发布时只包含必要文件
-- 📦 更新依赖项
-
-### 1.0.0 (初始版本)
-
-- 🎉 首次发布
-- ✅ 基础推送功能
-- ✅ 命令系统
+## 版本历史
+
+### 1.8.0 (2026-01-19)
+
+- ✨ 新增超级管理员功能，允许修改 WordPress 站点地址
+- ✅ 添加 `superAdmins` 配置项，支持指定超级管理员
+- ✅ 添加 `/wordpress.set-url <url>` 命令，仅超级管理员可用
+- 🐛 修复角色显示问题，移除不可靠的 roles 字段
+- 📝 更新 README.md 文档，添加超级管理员功能说明
+
+### 1.7.1 (2026-01-19)
+
+- 🐛 修复用户查询功能中 roles 字段为 undefined 的错误
+- 📝 更新 README.md 文档，添加用户查询功能说明
+
+### 1.7.0 (2026-01-19)
+
+- ✨ 新增查询 WordPress 站点用户信息功能
+- ✅ 添加 `/wordpress.users` 命令，查看站点用户列表
+- ✅ 添加 `/wordpress.user <id>` 命令，查看特定用户信息
+- 📝 更新主菜单，添加新命令选项
+- 🔧 优化数据库表定义
+
+### 1.6.0 (2026-01-15)
+
+- 🐛 修复消息发送问题，使用 `bot.sendMessage` 替代 `broadcast`
+- 🔧 优化消息发送逻辑
+
+### 1.5.0 (2026-01-15)
+
+- 🐛 修复数据库主键问题，添加 `id` 字段作为主键
+- 🔧 优化数据库表结构
+
+### 1.3.0 (2024-01-14)
+
+- 📝 更新作者邮箱为 kate522@88.com
+- 🔗 更新仓库地址为正确的 GitHub URL
+- 📝 优化 README.md 文档和链接
+
+### 1.2.0 (2024-01-14)
+
+- 📝 优化 README.md 文档，添加详细的安装说明和常见问题
+- 📦 优化 npm 包结构，只包含必要文件
+
+### 1.1.0 (2024-01-14)
+
+- ✨ 新增数据库持久化存储功能
+- 🐛 修复推送目标配置问题，使用 `ctx.broadcast([target], message)` 正确发送到指定目标
+- 🐛 修复 HTTP 服务注入问题，添加 `'http'` 到 inject 数组
+- 📝 添加 `.npmignore` 文件，确保 npm 发布时只包含必要文件
+- 📦 更新依赖项
+
+### 1.0.0 (初始版本)
+
+- 🎉 首次发布
+- ✅ 基础推送功能
+- ✅ 命令系统
 - ✅ 去重机制
 
 ## 许可证

package/lib/index.d.ts

@@ -13,6 +13,7 @@ export interface Config {
     enableAutoPush: boolean;
     mentionAll: boolean;
     maxArticles: number;
+    superAdmins: string[];
 }
 export interface WordPressPost {
     id: number;
@@ -38,8 +39,11 @@ export interface WordPressUser {
         '48': string;
         '96': string;
     };
-    registered_date: string;
-    roles: string[];
+    registered_date?: string;
+    roles?: string[];
+    slug?: string;
+    url?: string;
+    meta?: any[];
 }
 export interface WordPressPostRecord {
     id: number;

package/lib/index.js

@@ -11,7 +11,8 @@ exports.Config = koishi_1.Schema.object({
     targets: koishi_1.Schema.array(koishi_1.Schema.string()).description('推送目标（群号或 QQ 号）'),
     enableAutoPush: koishi_1.Schema.boolean().default(true).description('是否启用自动推送'),
     mentionAll: koishi_1.Schema.boolean().default(false).description('是否 @全体成员'),
-    maxArticles: koishi_1.Schema.number().default(5).description('每次最多推送的文章数量')
+    maxArticles: koishi_1.Schema.number().default(5).description('每次最多推送的文章数量'),
+    superAdmins: koishi_1.Schema.array(koishi_1.Schema.string()).default([]).description('超级管理员列表（QQ 号）')
 });
 function apply(ctx, config) {
     ctx.logger.info('WordPress 推送插件已加载');
@@ -19,6 +20,9 @@ function apply(ctx, config) {
         id: 'integer',
         postId: 'integer',
         pushedAt: 'timestamp'
+    }, {
+        primary: ['id'],
+        autoInc: true
     });
     async function fetchLatestPosts() {
         try {
@@ -151,7 +155,7 @@ function apply(ctx, config) {
         }
         let message = '👥 WordPress 站点用户列表：\n\n';
         for (const user of users) {
-            message += `${user.id}. ${user.name}（${user.roles.join(', ')}）\n`;
+            message += `${user.id}. ${user.name}\n`;
             message += `🔗 ${user.link}\n\n`;
         }
         return message;
@@ -170,12 +174,13 @@ function apply(ctx, config) {
         let message = `👤 用户信息：\n\n`;
         message += `ID: ${user.id}\n`;
         message += `昵称: ${user.name}\n`;
-        message += `角色: ${user.roles.join(', ')}\n`;
         message += `个人主页: ${user.link}\n`;
         if (user.description) {
             message += `简介: ${user.description.replace(/<[^>]*>/g, '')}\n`;
         }
-        message += `注册时间: ${new Date(user.registered_date).toLocaleString('zh-CN')}\n`;
+        if (user.registered_date) {
+            message += `注册时间: ${new Date(user.registered_date).toLocaleString('zh-CN')}\n`;
+        }
         return message;
     });
     ctx.command('wordpress.push', '手动推送最新文章')
@@ -207,20 +212,88 @@ function apply(ctx, config) {
         config.mentionAll = !config.mentionAll;
         return `@全体成员 已${config.mentionAll ? '开启' : '关闭'}`;
     });
+    ctx.command('wordpress.set-url <url>', '修改 WordPress 站点地址（仅超级管理员可用）')
+        .action(async ({ session }, url) => {
+        const userId = session?.userId || 'unknown';
+        ctx.logger.info(`命令 wordpress.set-url 被调用，调用者：${userId}，新地址：${url}`);
+        // 检查是否为超级管理员
+        if (!session?.userId || !config.superAdmins.includes(session.userId)) {
+            ctx.logger.warn(`用户 ${userId} 尝试修改站点地址，但不是超级管理员`);
+            return '你没有权限执行此命令';
+        }
+        // 修改站点地址
+        config.wordpressUrl = url;
+        ctx.logger.info(`站点地址已修改为：${url}`);
+        return `WordPress 站点地址已修改为：${url}`;
+    });
+    ctx.command('wordpress.pushed', '查看已推送的文章列表')
+        .action(async () => {
+        ctx.logger.info('命令 wordpress.pushed 被调用');
+        // 获取已推送的文章记录
+        const records = await ctx.database.get('wordpress_posts', {}, {
+            sort: {
+                pushedAt: 'desc'
+            }
+        });
+        if (records.length === 0) {
+            return '暂无已推送文章记录';
+        }
+        let message = '📋 已推送文章列表（按时间倒序）：\n\n';
+        for (const record of records) {
+            message += `${record.id}. 文章 ID: ${record.postId}\n`;
+            message += `📅 推送时间: ${new Date(record.pushedAt).toLocaleString('zh-CN')}\n\n`;
+        }
+        return message;
+    });
+    ctx.command('wordpress.clean [days]', '清理指定天数前的推送记录（默认 30 天）')
+        .action(async ({ session }, days) => {
+        ctx.logger.info(`命令 wordpress.clean 被调用，天数：${days || '默认'}`);
+        // 检查是否为超级管理员
+        const userId = session?.userId || 'unknown';
+        if (!session?.userId || !config.superAdmins.includes(session.userId)) {
+            ctx.logger.warn(`用户 ${userId} 尝试清理记录，但不是超级管理员`);
+            return '你没有权限执行此命令';
+        }
+        // 设置默认天数
+        const daysToKeep = days ? parseInt(days) : 30;
+        if (isNaN(daysToKeep) || daysToKeep <= 0) {
+            return '请输入有效的天数';
+        }
+        // 计算清理时间点
+        const cutoffDate = new Date();
+        cutoffDate.setDate(cutoffDate.getDate() - daysToKeep);
+        // 获取所有记录
+        const allRecords = await ctx.database.get('wordpress_posts', {});
+        // 筛选需要删除的记录
+        const recordsToRemove = allRecords.filter(record => {
+            return new Date(record.pushedAt) < cutoffDate;
+        });
+        // 删除旧记录
+        let result = 0;
+        for (const record of recordsToRemove) {
+            await ctx.database.remove('wordpress_posts', { id: record.id });
+            result++;
+        }
+        ctx.logger.info(`已清理 ${result} 条 ${daysToKeep} 天前的推送记录`);
+        return `已清理 ${result} 条 ${daysToKeep} 天前的推送记录`;
+    });
     ctx.command('wordpress', 'WordPress 推送插件菜单')
         .action(() => {
         ctx.logger.info('命令 wordpress 被调用');
-        return `📚 WordPress 推送插件菜单：
-
-🔹 /wordpress.status - 查看插件状态
-🔹 /wordpress.latest - 查看最新文章
-🔹 /wordpress.list - 查看文章列表
-🔹 /wordpress.users - 查看站点用户列表
-🔹 /wordpress.user <id> - 查看特定用户信息
-🔹 /wordpress.push - 手动推送最新文章
-🔹 /wordpress.toggle - 切换自动推送开关
-🔹 /wordpress.mention - 切换 @全体成员 开关
-
+        return `📚 WordPress 推送插件菜单：
+
+🔹 /wordpress.status - 查看插件状态
+🔹 /wordpress.latest - 查看最新文章
+🔹 /wordpress.list - 查看文章列表
+🔹 /wordpress.users - 查看站点用户列表
+🔹 /wordpress.user <id> - 查看特定用户信息
+🔹 /wordpress.push - 手动推送最新文章
+🔹 /wordpress.set-url <url> - 修改 WordPress 站点地址
+🔹 /wordpress.pushed - 查看已推送文章列表
+🔹 /wordpress.clean [days] - 清理旧推送记录
+🔹 /wordpress.toggle - 切换自动推送开关
+🔹 /wordpress.mention - 切换 @全体成员 开关
+
 💡 提示：所有命令都需要加 / 前缀`;
     });
     ctx.on('ready', async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-wordpress-notifier",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "WordPress 文章自动推送到 QQ",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",