koishi-plugin-wordpress-notifier 2.8.0 → 2.8.2

package/README.md

@@ -37,22 +37,43 @@ npm install koishi-plugin-wordpress-notifier
 
 在 `koishi.yml` 中配置插件：
 
+### 多站点配置（推荐）
+
 ```yaml
 plugins:
   wordpress-notifier:
-    wordpressUrl: 'https://your-wordpress-site.com'  # WordPress 网站地址
-    interval: 3600000  # 检查间隔（毫秒，默认 1 小时）
-    targets:
-      - '2801323326'  # 推送目标（群号或 QQ 号）
-    enableAutoPush: true  # 是否启用自动推送
-    enableUpdatePush: false  # 是否启用文章更新推送
-    enableUserPush: false  # 是否启用新用户注册推送
-    mentionAll: false  # 是否 @全体成员
-    maxArticles: 5  # 每次最多推送的文章数量
-    # 可选：WordPress API 认证配置
-    # 使用应用程序密码，更安全
-    # username: 'your-wordpress-username'
-    # applicationPassword: 'your-application-password'  # 例如：hGR2 sPFu Yncl xHc4 AvJq cUtB
+    # 多站点配置
+    sites:
+      - id: 'blog'  # 站点唯一标识
+        name: '博客站点'  # 站点名称（用于显示）
+        url: 'https://your-wordpress-site.com'  # WordPress 网站地址
+        interval: 3600000  # 检查间隔（毫秒，默认 1 小时）
+        targets:  # 推送目标（群号或 QQ 号）
+          - '2801323326'
+        enableAutoPush: true  # 是否启用自动推送
+        enableUpdatePush: false  # 是否启用文章更新推送
+        enableUserPush: false  # 是否启用新用户注册推送
+        mentionAll: false  # 是否 @全体成员
+        maxArticles: 5  # 每次最多推送的文章数量
+        username: 'your-wordpress-username'  # WordPress 用户名（用于 Basic 认证）
+        applicationPassword: 'your-application-password'  # WordPress 应用程序密码
+        # 推送模板配置
+        pushTemplate:
+          showExcerpt: false  # 是否显示摘要
+          dateFormat: 'YYYY-MM-DD HH:mm'  # 日期格式
+          linkPosition: 'bottom'  # 链接位置：top, bottom, none
+          showAuthor: false  # 是否显示作者
+    
+    # 超级管理员配置
+    superAdmins:
+      - '123456789'  # 超级管理员 QQ 号
+    
+    # 推送失败通知配置
+    failureNotification:
+      enable: true  # 是否启用推送失败通知
+      threshold: 3  # 连续失败阈值，达到此值时发送通知
+      notificationTargets:  # 通知目标（超级管理员 QQ 号），留空则使用 superAdmins
+        - '123456789'
 ```
 
 ### 如何获取WordPress应用程序密码
@@ -71,16 +92,29 @@ plugins:
 
 | 参数 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
-| `wordpressUrl` | string | 必填 | WordPress 网站地址（例如：https://example.com） |
-| `interval` | number | 3600000 | 检查间隔，单位毫秒（默认 1 小时 = 3600000 毫秒） |
-| `targets` | array | 必填 | 推送目标列表，可以是群号或 QQ 号 |
-| `enableAutoPush` | boolean | true | 是否启用自动推送 |
-| `enableUpdatePush` | boolean | false | 是否启用文章更新推送 |
-| `enableUserPush` | boolean | false | 是否启用新用户注册推送 |
-| `mentionAll` | boolean | false | 是否在推送时 @全体成员 |
-| `maxArticles` | number | 5 | 每次最多推送的文章数量 |
-| `username` | string | 可选 | WordPress 用户名（用于 Basic 基础认证，与应用程序密码配合使用） |
-| `applicationPassword` | string | 可选 | WordPress 应用程序密码（用于 Basic 基础认证，例如：hGR2sPFuYnclxHc4AvJqcUtB） |
+| `sites` | array | 必填 | 多站点配置列表 |
+| `sites[].id` | string | 必填 | 站点唯一标识（如 "blog"、"news" 等） |
+| `sites[].name` | string | 必填 | 站点名称（用于显示） |
+| `sites[].url` | string | 必填 | WordPress 网站地址（例如：https://example.com） |
+| `sites[].interval` | number | 3600000 | 检查间隔，单位毫秒（默认 1 小时 = 3600000 毫秒） |
+| `sites[].targets` | array | 必填 | 推送目标列表，可以是群号或 QQ 号 |
+| `sites[].enableAutoPush` | boolean | true | 是否启用自动推送 |
+| `sites[].enableUpdatePush` | boolean | false | 是否启用文章更新推送 |
+| `sites[].enableUserPush` | boolean | false | 是否启用新用户注册推送 |
+| `sites[].mentionAll` | boolean | false | 是否在推送时 @全体成员 |
+| `sites[].maxArticles` | number | 5 | 每次最多推送的文章数量 |
+| `sites[].username` | string | 可选 | WordPress 用户名（用于 Basic 基础认证，与应用程序密码配合使用） |
+| `sites[].applicationPassword` | string | 可选 | WordPress 应用程序密码（用于 Basic 基础认证，例如：hGR2sPFuYnclxHc4AvJqcUtB） |
+| `sites[].pushTemplate` | object | 必填 | 推送模板配置 |
+| `sites[].pushTemplate.showExcerpt` | boolean | false | 是否显示摘要 |
+| `sites[].pushTemplate.dateFormat` | string | 'YYYY-MM-DD HH:mm' | 日期格式 |
+| `sites[].pushTemplate.linkPosition` | string | 'bottom' | 链接位置：top, bottom, none |
+| `sites[].pushTemplate.showAuthor` | boolean | false | 是否显示作者 |
+| `superAdmins` | array | [] | 超级管理员 QQ 号列表 |
+| `failureNotification` | object | - | 推送失败通知配置 |
+| `failureNotification.enable` | boolean | true | 是否启用推送失败通知 |
+| `failureNotification.threshold` | number | 3 | 连续失败阈值，达到此值时发送通知 |
+| `failureNotification.notificationTargets` | array | [] | 通知目标（超级管理员 QQ 号），留空则使用 superAdmins |
 
 ## 使用命令
 
@@ -116,45 +150,61 @@ plugins:
 
 显示当前插件配置状态，包括网站地址、检查间隔、推送目标等。
 
-### 切换自动推送开关
+### 切换指定站点的自动推送开关
+
+```
+/wordpress.site.toggle <siteId>
+```
+
+开启或关闭指定站点的自动推送功能。
+
+### 切换指定站点的 @全体成员 开关
+
+```
+/wordpress.site.mention <siteId>
+```
+
+开启或关闭指定站点的 @全体成员 功能。
+
+### 切换指定站点的文章更新推送开关
 
 ```
-/wordpress.toggle
+/wordpress.site.toggle-update <siteId>
 ```
 
-开启或关闭自动推送功能。
+开启或关闭指定站点的文章更新推送功能。
 
-### 切换 @全体成员 开关
+### 切换指定站点的新用户注册推送开关
 
 ```
-/wordpress.mention
+/wordpress.site.toggle-user <siteId>
 ```
 
-开启或关闭 @全体成员 功能。
+开启或关闭指定站点的新用户注册推送功能。
 
-### 切换文章更新推送开关
+### 修改指定站点的 WordPress 地址
 
 ```
-/wordpress.toggle-update
+/wordpress.site.set-url <siteId> <url>
 ```
 
-开启或关闭文章更新推送功能。
+修改指定站点的 WordPress 地址。
 
-### 切换新用户注册推送开关
+### 查看插件运行指标统计
 
 ```
-/wordpress.toggle-user
+/wordpress.stats
 ```
 
-开启或关闭新用户注册推送功能。
+查看插件运行指标统计，包括 API 调用次数、推送成功率等。
 
-### 修改 WordPress 站点地址
+### 查看插件健康状态
 
 ```
-/wordpress.set-url <url>
+/wordpress.health
 ```
 
-修改 WordPress 站点地址。
+查看插件健康状态，包括数据库连接、API 可达性、Bot 在线状态等。
 
 ### 查看已推送文章列表
 
@@ -339,6 +389,45 @@ npm install
 
 ## 版本历史
 
+### 2.8.2 (2026-02-19)
+
+- 🚀 全面升级插件功能，支持多站点管理和高级配置
+
+**核心功能升级**
+- ✅ 支持多站点配置，可同时监控多个 WordPress 站点
+- ✅ 每个站点独立配置推送目标、推送模板和开关状态
+- ✅ 支持自定义推送模板，可配置是否显示摘要、日期格式、链接位置等
+- ✅ 新增推送失败通知功能，关键失败主动提醒超级管理员
+
+**稳定性与安全**
+- ✅ 实现 WordPress API 限流防护，避免触发 WordPress API 限流
+- ✅ 添加数据库连接异常处理，自动检测连接状态并恢复
+- ✅ 增强消息内容安全过滤，添加敏感词过滤逻辑
+
+**运维与监控**
+- ✅ 新增运行指标统计，支持查看 API 调用成功率、推送成功率等
+- ✅ 新增健康状态检查命令，返回插件核心状态
+- ✅ 优化日志记录，提供更详细的错误信息
+
+**命令系统优化**
+- ✅ 新增站点管理命令，支持按站点 ID 管理配置
+- ✅ 保留原有命令的同时，添加更细粒度的站点控制命令
+
+### 2.8.1 (2026-02-19)
+
+- 🐛 修复 MySQL 主键约束错误 (ER_PRIMARY_CANT_HAVE_NULL)
+
+**核心修复**
+- ✅ 增强 `checkAndFixTableStructure` 函数，添加表结构自动修复机制
+- ✅ 当表结构不正确时，自动删除旧表并重新初始化，确保主键约束正确设置
+- ✅ 为 `wordpress_post_updates`、`wordpress_user_registrations` 和 `wordpress_config` 表添加自动修复逻辑
+- ✅ 优化 `loadPersistentConfig` 函数，添加更详细的错误处理，确保即使数据库操作失败也能继续运行
+- ✅ 修改 `updatePostUpdateRecord` 函数，移除错误抛出，确保推送流程不会被数据库操作失败中断
+
+**稳定性提升**
+- ✅ 增加数据库操作的容错能力，提高插件在各种环境下的稳定性
+- ✅ 优化错误日志记录，提供更详细的错误信息，便于排查问题
+
 ### 2.8.0 (2026-02-18)
 
 - 🚀 全面优化插件稳定性、性能和功能完整性

package/lib/index.d.ts

@@ -6,16 +6,24 @@ declare module 'koishi' {
         wordpress_post_updates: WordPressPostUpdateRecord;
         wordpress_user_registrations: WordPressUserRegistrationRecord;
         wordpress_config: WordPressConfigRecord;
+        wordpress_version: WordPressVersionRecord;
     }
 }
+export interface WordPressVersionRecord {
+    id: number;
+    version: string;
+    updatedAt: Date;
+}
 export interface WordPressConfigRecord {
     id: number;
     key: string;
     value: string;
     updatedAt: Date;
 }
-export interface Config {
-    wordpressUrl: string;
+export interface WordPressSiteConfig {
+    id: string;
+    name: string;
+    url: string;
     interval: number;
     targets: string[];
     enableAutoPush: boolean;
@@ -25,7 +33,21 @@ export interface Config {
     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: number;
@@ -58,12 +80,14 @@ export interface WordPressUser {
 }
 export interface WordPressPostUpdateRecord {
     id: number;
+    siteId: string;
     postId: number;
     lastModified: Date;
     pushedAt: Date;
 }
 export interface WordPressUserRegistrationRecord {
     id: number;
+    siteId: string;
     userId: number;
     pushedAt: Date;
 }