koishi-plugin-wordpress-notifier 2.9.1 → 2.9.4

package/README.md

@@ -9,7 +9,18 @@
 - 👤 **新用户注册推送**：当 WordPress 有新用户注册时，自动推送到指定 QQ 群聊
 - 🎯 **支持私聊推送**：可以将文章推送到指定 QQ 用户
 - ⏰ **定时检查**：定期检查 WordPress 网站的更新
-- 📝 **文本消息格式**：所有推送均使用清晰的文本格式
+- 📝 **多格式消息**：支持文本和卡片两种消息格式
+- 🛡️ **并发控制**：使用 p-limit 实现智能并发控制，避免触发平台频率限制
+- 📊 **失败统计**：精确的失败统计和告警机制
+- 🌍 **平台兼容**：支持 QQ、Telegram、Discord 等多个平台
+- ⚙️ **灵活配置**：支持自定义推送时间范围和管理员告警
+- 🚀 **性能优化**：10秒缓存防抖，避免重复请求
+- 🔄 **智能重试**：仅对 GET 请求进行重试，防止重复写操作
+- 📈 **监控增强**：整合命令次数、请求成功率、响应耗时等统计信息
+- 🧹 **内存管理**：定时清理缓存，避免内存堆积
+- 🔧 **资源清理**：完善队列清理，适配热重载
+- 📋 **命令系统**：支持 wp-xxx 格式的命令，包括文章查询和推送管理
+- 📊 **插件状态**：新增 wp-status 命令，显示详细的服务状态
 
 ## 安装方法
 
@@ -41,8 +52,11 @@ npm install koishi-plugin-wordpress-notifier
 - **allowAtAll**：是否允许@全体成员，默认 `false`
 
 ### 其他配置
-- **messageType**：消息类型，可选 `text`、`card`，默认 `text`（当前版本默认使用文本格式）
-- **signatureKey**：卡片消息签名密钥（当前版本未使用）
+- **messageType**：消息类型，可选 `text`、`card`，默认 `text`
+- **signatureKey**：卡片消息签名密钥
+- **adminUserId**：管理员用户 ID，用于接收推送失败告警
+- **pushStartTime**：允许推送的开始时间（小时），默认 9
+- **pushEndTime**：允许推送的结束时间（小时），默认 22
 
 ## 使用示例
 
@@ -59,7 +73,10 @@ npm install koishi-plugin-wordpress-notifier
   "enableUserRegisterPush": false,
   "defaultGroups": ["123456789", "987654321"],
   "allowAtAll": false,
-  "messageType": "text"
+  "messageType": "text",
+  "adminUserId": "123456789",
+  "pushStartTime": 9,
+  "pushEndTime": 22
 }
 ```
 
@@ -73,6 +90,36 @@ npm install koishi-plugin-wordpress-notifier
 }
 ```
 
+## 命令系统
+
+### 文章查询命令
+
+- **wp-最新 [数量]**：查看最新文章（默认5篇）
+  - 示例：`wp-最新` 或 `wp-最新 10`
+
+- **wp-列表 [页码]**：浏览历史文章列表
+  - 示例：`wp-列表` 或 `wp-列表 2`
+
+- **wp-详情 <文章ID>**：查看指定文章详情
+  - 示例：`wp-详情 123`
+
+### 推送管理命令
+
+- **wp-开关 [on|off]**：开启/关闭群推送（仅管理员）
+  - 示例：`wp-开关 on` 或 `wp-开关 off`
+
+- **wp-订阅 [on|off]**：订阅/取消私聊推送
+  - 示例：`wp-订阅 on` 或 `wp-订阅 off`
+
+- **wp-同步**：手动触发一次推送检查（仅管理员）
+  - 示例：`wp-同步`
+
+- **wp-状态**：查看插件状态
+  - 示例：`wp-状态`
+
+- **wp-帮助**：查看详细使用说明
+  - 示例：`wp-帮助`
+
 ## 消息格式
 
 ### 新文章推送
@@ -158,21 +205,43 @@ npm install koishi-plugin-wordpress-notifier
 
 ## 版本历史
 
-### v2.9.1
-- 🎉 **正式版本**：基于 Beta 版本的稳定发布
-- 📝 统一使用文本格式发送消息
-- 🔧 修复数据库配置存储错误
-- 🎯 优化推送逻辑，提高可靠性
-- 🚀 提升性能和稳定性
-- 🔄 移除用户信息更新推送功能，专注于核心功能
+### v2.9.4
+- 🎉 **Bug 修复**：修复文章更新检测误判问题，仅使用修改时间判断，避免因哈希值变化导致所有文章被重复推送
+- 🚀 **性能优化**：将文章检查数量从 20 篇减少到 10 篇，减少不必要的检查
+- ✨ **功能完善**：完整实现新用户注册推送功能
+- 📊 **用户体验**：添加详细的更新检测日志，便于调试和追踪
+- 🔧 **代码优化**：改进更新检测逻辑，使用秒级时间戳比较，避免精度问题
+
+### v2.9.3
+- 🎉 **并发控制**：使用 p-limit 替代手动队列，彻底解决线程安全问题
+- 🚀 **性能优化**：添加 10 秒缓存防抖，避免重复请求
+- 🔄 **智能重试**：限制仅 GET 请求重试，防止重复写操作
+- 🧹 **内存管理**：添加定时清理缓存，避免内存堆积
+- 🔧 **资源清理**：完善队列清理，适配热重载
+- 📈 **监控增强**：整合命令次数、请求成功率、响应耗时等统计信息
+- 🔍 **类型安全**：补全 _embedded / error 等 TypeScript 类型
+- 🎯 **错误体系**：自定义 AuthCooldownError，统一错误处理
+- 📊 **状态命令**：增强 wp-status 命令，显示更详细的服务状态
+
+### v2.9.2
+- 🎉 **架构重构**：完全重构了定时任务服务，解决了并发风暴问题
+- 🛡️ **并发控制**：实现了推送任务队列，限制最大并发推送数为 3
+- 📊 **智能失败统计**：重构失败计数逻辑，避免告警风暴
+- 🔄 **完善更新检测**：实现了基于修改时间和哈希值的文章更新检测
+- 🎯 **竞态条件修复**：添加运行标志，防止重复执行和重复推送
+- ⚙️ **灵活时间配置**：支持自定义推送时间范围
+- 🚨 **管理员告警**：支持将失败告警发送到指定管理员
+- 🌍 **多平台支持**：添加了 Telegram、Discord 等平台的卡片渲染器
+- 🔧 **资源管理**：完善了服务销毁和资源清理逻辑
+- 🚀 **性能优化**：批量执行推送任务，提高效率
 
-### v2.9.1-Beta
-- 🎉 **重构版本**：完全重构了插件架构，提高了代码质量和可维护性
-- ✨ 新增用户信息更新推送功能
+### v2.9.1
+- 🎉 **正式版本**：完全重构了插件架构，提高了代码质量和可维护性
 - 📝 统一使用文本格式发送消息
 - 🔧 修复数据库配置存储错误
 - 🎯 优化推送逻辑，提高可靠性
 - 🚀 提升性能和稳定性
+- 🔄 专注于核心功能：文章推送、文章更新推送和用户注册推送
 
 ### v1.1.1
 - 📝 统一使用文本格式发送消息

package/lib/commands.d.ts

@@ -2,11 +2,15 @@ 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;
-    constructor(ctx: Context, config: Config, wordpressService: WordPressService, storageService: StorageService);
+    private scheduleService;
+    constructor(ctx: Context, config: Config, wordpressService: WordPressService, storageService: StorageService, scheduleService: ScheduleService);
+    private isSuperAdmin;
+    private isAdmin;
     private initCommands;
 }