koishi-plugin-codex-reset 0.1.6 → 0.1.7

package/README.md

@@ -30,6 +30,8 @@
 
 从 0.1.6 起，需要启用 Koishi 数据库服务（例如 SQLite、MySQL 或 PostgreSQL）。完整 API 快照、ETag、最近同步时间和下次允许请求的时间保存在 `codex_reset_cache` 表中，相同 API 地址共用一份记录。所有查询命令只读数据库，不直接请求上游；首次同步尚未成功时会提示稍后再试。重启、重载插件后仍可查询已保存的数据，并继续遵守冷却时间。同步失败时保留上次成功的数据，可能暂时不是最新状态。
 
+插件启动时立即检查并尝试同步，无需先等待 11 分钟；如果数据库中仍有未结束的冷却时间，则等待剩余时间后同步。从 0.1.7 起，首次同步期间的查询会等待正在进行的那次请求，不额外发请求。尚无快照且处于冷却时，命令会显示剩余等待秒数；启动日志也会说明当前数据和下次同步时间。同步按已保存的截止时间调度，重启不会重新等满一个轮询周期。
+
 后台默认每 660 秒同步一次；旧配置小于 660 秒时，实际请求也不会快于 660 秒。请求前先保存冷却时间，收到 HTTP 429 或 503 时遵循 `Retry-After`（也支持响应正文的 `retryAfter` 秒数），冷却期间不会因重启或手动查询再次请求。数据库写入失败时不会继续发起新的上游请求。
 
 图片生成最多同时进行 2 项，新的图片任务至少间隔 3 秒；历史图片超过 120 条事件时会提示缩小查询范围。图片中的长篇来源文字会截短。API 响应上限为 4 MiB。

package/lib/index.js

@@ -248,13 +248,32 @@ class CodexResetMonitor {
         // Commands only read the database. A missing snapshot must not turn every
         // user command into another upstream request during a rate-limit window.
         try {
-            return (await this.snapshots.read()).snapshot;
+            let cache = await this.snapshots.read();
+            if (!cache.snapshot && this.pollPromise) {
+                // Startup sync may still be receiving its first response. Wait for the
+                // existing poll instead of replying before it can populate the table.
+                await this.pollPromise;
+                cache = await this.snapshots.read();
+            }
+            return cache.snapshot;
         }
         catch (error) {
             this.ctx.logger('codex-reset').warn(`读取重置数据失败：${error instanceof Error ? error.message : String(error)}`);
             return null;
         }
     }
+    async unavailableMessage() {
+        try {
+            const cache = await this.snapshots.read();
+            const seconds = Math.ceil((cache.nextFetchAt - Date.now()) / 1000);
+            if (seconds > 0)
+                return `暂时无法获取 Codex 重置事件数据：尚无可用缓存，约 ${seconds} 秒后自动重试同步。`;
+        }
+        catch {
+            // ensureSnapshot already records database read failures.
+        }
+        return '暂时无法获取 Codex 重置事件数据：首次同步尚未完成，请稍后再试。';
+    }
     async poll() {
         if (this.disposed)
             return;
@@ -269,10 +288,31 @@ class CodexResetMonitor {
         }
     }
     async start() {
+        this.ctx.logger('codex-reset').info('启动重置事件同步检查。');
         await this.poll();
-        if (!this.disposed) {
-            this.ctx.setInterval(() => this.poll(), Math.max(cache_1.MIN_POLL_INTERVAL_MS, this.config.pollInterval * 1000));
+        await this.scheduleNextPoll();
+    }
+    async scheduleNextPoll() {
+        if (this.disposed)
+            return;
+        let delay = Math.max(cache_1.MIN_POLL_INTERVAL_MS, this.config.pollInterval * 1000);
+        try {
+            const cache = await this.snapshots.read();
+            if (cache.nextFetchAt > Date.now())
+                delay = cache.nextFetchAt - Date.now();
+            this.ctx.logger('codex-reset').info(cache.snapshot
+                ? `重置数据已就绪（${cache.snapshot.events.length} 条事件），约 ${Math.ceil(delay / 1000)} 秒后同步。`
+                : `尚无可用重置数据，约 ${Math.ceil(delay / 1000)} 秒后自动重试同步。`);
+        }
+        catch (error) {
+            this.ctx.logger('codex-reset').warn(`读取同步计划失败：${error instanceof Error ? error.message : String(error)}`);
         }
+        if (this.disposed)
+            return;
+        this.ctx.setTimeout(async () => {
+            await this.poll();
+            await this.scheduleNextPoll();
+        }, Math.max(1000, Math.min(delay, 2_147_483_647)));
     }
     dispose() {
         this.disposed = true;
@@ -447,7 +487,7 @@ class CodexResetMonitor {
         try {
             const headers = {
                 Accept: 'application/json',
-                'User-Agent': 'koishi-plugin-codex-reset/0.1.6',
+                'User-Agent': 'koishi-plugin-codex-reset/0.1.7',
             };
             if (cache.etag && cache.snapshot)
                 headers['If-None-Match'] = cache.etag;
@@ -531,7 +571,7 @@ function apply(ctx, config) {
         .action(async () => {
         const snapshot = await monitor.ensureSnapshot();
         if (!snapshot)
-            return '暂时无法获取 Codex 重置事件数据，请稍后再试。';
+            return monitor.unavailableMessage();
         const summary = (0, stats_1.analyzeProbability)(snapshot);
         if (!monitor.hasPuppeteer)
             return (0, stats_1.formatProbability)(summary);
@@ -553,7 +593,7 @@ function apply(ctx, config) {
         .action(async () => {
         const snapshot = await monitor.ensureSnapshot();
         if (!snapshot)
-            return '暂时无法获取 Codex 重置事件数据，请稍后再试。';
+            return monitor.unavailableMessage();
         const now = new Date();
         const latest = (0, stats_1.findLatestConfirmedReset)(snapshot, now);
         if (!latest)
@@ -581,7 +621,7 @@ function apply(ctx, config) {
         try {
             const image = await monitor.createCalendarImage();
             if (!image)
-                return '暂时无法生成日历图片，请稍后再试。';
+                return monitor.unavailableMessage();
             return koishi_1.h.image(image, 'image/png');
         }
         catch (error) {
@@ -600,7 +640,7 @@ function apply(ctx, config) {
         try {
             const snapshot = await monitor.ensureSnapshot();
             if (!snapshot)
-                return '暂时无法获取 Codex 重置事件数据，请稍后再试。';
+                return monitor.unavailableMessage();
             const now = new Date();
             const historyRange = argv.options?.all
                 ? 'all'
@@ -610,7 +650,7 @@ function apply(ctx, config) {
                 return `历史事件超过 ${MAX_HISTORY_EVENTS} 条，请缩小查询的月份范围。`;
             const image = await monitor.createHistoryImage(events, now);
             if (!image)
-                return '暂时无法生成历史时间线图片，请稍后再试。';
+                return monitor.unavailableMessage();
             return koishi_1.h.image(image, 'image/png');
         }
         catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "koishi-plugin-codex-reset",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Monitor AIHOT Codex reset events and notify Koishi channels.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",