@jxgame2020/dsh-token-quota 0.1.11 → 0.1.13

package/lib/types/index.js

@@ -225,6 +225,8 @@ export class TokenQuotaService extends Service {
     checkUpdates = true;
     /** Cached upgrade availability; recomputed by {@link refreshUpgrade}. */
     upgrade = null;
+    /** Error message from the most recent update check; null = no error. */
+    upgradeError = null;
     /** Timer for the periodic update check. */
     updateTimer;
     /** In-flight update check, to coalesce the periodic and manual triggers. */
@@ -243,6 +245,8 @@ export class TokenQuotaService extends Service {
     disposeRouteLog;
     /** Disposer for the optional manual-check route (`POST /token-quota/check-updates`). */
     disposeRouteCheck;
+    /** Disposer for the optional clear-log route (`POST /token-quota/clear-log`). */
+    disposeRouteClear;
     /** Disposer for the webServer-arrival watcher when the service mounts later. */
     disposeRouteWatcher;
     /**
@@ -376,6 +380,37 @@ export class TokenQuotaService extends Service {
                 });
             },
         });
+        this.disposeRouteClear = server.register({
+            kind: 'exact',
+            path: '/token-quota/clear-log',
+            handler: (req, res) => {
+                if (req.method !== 'POST') {
+                    res.writeHead(405);
+                    res.end();
+                    return;
+                }
+                const chunks = [];
+                req.on('data', (chunk) => { chunks.push(Buffer.from(chunk)); });
+                req.on('end', () => {
+                    let before = '';
+                    try {
+                        const raw = Buffer.concat(chunks).toString('utf8');
+                        if (raw.length > 0) {
+                            const payload = JSON.parse(raw);
+                            before = typeof payload.before === 'string' ? payload.before : '';
+                        }
+                    }
+                    catch {
+                        res.writeHead(400, { 'content-type': 'application/json' });
+                        res.end(JSON.stringify({ error: 'bad payload' }));
+                        return;
+                    }
+                    const updated = this.clearLogBefore(before);
+                    res.writeHead(200, { 'content-type': 'application/json', 'cache-control': 'no-store' });
+                    res.end(JSON.stringify(updated));
+                });
+            },
+        });
     }
     /** Query the npm registry and rebuild the cached upgrade info (coalesced). */
     refreshUpgrade() {
@@ -394,6 +429,7 @@ export class TokenQuotaService extends Service {
         const current = __TOKEN_QUOTA_VERSION__;
         if (current === undefined || current === '') {
             this.upgrade = null;
+            this.upgradeError = null;
             return;
         }
         let latest;
@@ -404,18 +440,26 @@ export class TokenQuotaService extends Service {
             });
             if (!response.ok) {
                 this.upgrade = null;
+                this.upgradeError = `registry responded ${response.status} ${response.statusText}`;
                 return;
             }
             const manifest = await response.json();
             latest = typeof manifest.version === 'string' ? manifest.version : undefined;
         }
-        catch {
-            // Offline / registry failure: keep showing nothing rather than erroring.
+        catch (err) {
             this.upgrade = null;
+            const msg = err instanceof Error ? err.message : String(err);
+            // Common Node fetch error shapes include the URL; surface a short reason.
+            this.upgradeError = msg.includes('fetch failed')
+                ? '无法访问 npm registry（网络超时或被墙）'
+                : msg.includes('aborted')
+                    ? '请求超时（10s）'
+                    : msg;
             return;
         }
         if (latest === undefined || !isNewer(latest, current)) {
             this.upgrade = null;
+            this.upgradeError = null;
             return;
         }
         const profile = findProfile();
@@ -429,6 +473,7 @@ export class TokenQuotaService extends Service {
             commands,
             installKind: profile?.installKind ?? 'registry',
         };
+        this.upgradeError = null;
     }
     /** Start or stop the periodic update check to match the current setting. */
     syncUpdateChecking() {
@@ -470,6 +515,25 @@ export class TokenQuotaService extends Service {
         entries.sort((left, right) => right.day.localeCompare(left.day) || left.key.localeCompare(right.key));
         return { entries };
     }
+    /**
+     * Remove all historical cycles whose day portion strictly precedes `before`
+     * (format `YYYY-MM-DD`). The current cycle is never cleared. Returns the
+     * trimmed log so the client can refresh immediately.
+     */
+    clearLogBefore(before) {
+        if (!/^\d{4}-\d{2}-\d{2}$/.test(before))
+            return this.readLog();
+        const kept = {};
+        for (const [cycle, usageByKey] of Object.entries(this.history)) {
+            const dayPart = cycle.slice(0, 10);
+            if (dayPart >= before) {
+                kept[cycle] = usageByKey;
+            }
+        }
+        this.history = kept;
+        this.scheduleWrite();
+        return this.readLog();
+    }
     /** Read the current snapshot (also used by tests and inspection). */
     readSnapshot() {
         this.rollCycleIfNeeded();
@@ -488,7 +552,7 @@ export class TokenQuotaService extends Service {
             });
         }
         entries.sort((left, right) => left.key.localeCompare(right.key));
-        return { day: this.cycle, entries, upgrade: this.upgrade };
+        return { day: this.cycle, entries, upgrade: this.upgrade, upgradeError: this.upgradeError };
     }
     /** Today's used tokens for one model key, or `0`. */
     usedToday(key) {
@@ -728,6 +792,8 @@ export class TokenQuotaService extends Service {
             this.disposeRouteLog();
         if (this.disposeRouteCheck !== undefined)
             this.disposeRouteCheck();
+        if (this.disposeRouteClear !== undefined)
+            this.disposeRouteClear();
         this.flush();
     }
     safeSplit(key) {

package/lib/types/types.d.ts

@@ -125,6 +125,8 @@ export interface TokenQuotaSnapshot {
     entries: TokenQuotaEntry[];
     /** Upgrade availability; `null` when no newer version is known. */
     upgrade: TokenQuotaUpgrade | null;
+    /** Error from the most recent update check; `null` = no error (or never checked). */
+    upgradeError: string | null;
 }
 /** One historical daily usage record, shown in the log dialog. */
 export interface TokenQuotaLogEntry {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@jxgame2020/dsh-token-quota",
   "description": "Daily per-model token quota accounting, enforcement, and a floating quota panel for the DeepSeek Harness — a fully self-contained plugin (no core-Harness wiring, no generated RPC contract)",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "publishConfig": {
     "access": "public"
   },