dsh-whale-widget 0.2.8 → 0.2.10

package/README.md

@@ -10,7 +10,7 @@ DeepSeek Harness（DSH）Web 界面右下角的常驻余额挂件：小鲸鱼气
 - 💰 **余额**：60 秒自动刷新 + 点击鲸鱼手动刷新；余额变化时数字**滚动动画**；瞬时网络抖动自动沿用最近余额不报错
 - 📊 **今日已用**：两种模式任选（见下），显示今日消耗金额
   - **小鲸鱼记账（推荐，免令牌）**：不需要任何会话令牌，鲸鱼娘每次观测余额后用余额差值自动记账（`.dshw-usage.json`，跨天自动归零归档）
-  - **实时·令牌**：填入平台会话令牌后直接调用平台用量接口，按**峰谷定价**（空闲 9:00–12:00 与 14:00–18:00 之外 / 高峰 9–12 与 14–18 点）实时换算今日已用
+  - **实时·令牌**：填入平台会话令牌后直接调用平台用量接口，按**峰谷定价**（工作日高峰 9:00–12:00 与 14:00–18:00，其余空闲；2026-08-23 起周末全天按谷价）实时换算今日已用
 - 💬 **每轮对话消耗统计**：监听本机会话事件，每轮对话结束后弹出本轮消耗金额（精确 usage，非估算）
   - 菜单可开关「每轮对话后自动显示消耗金额」；「自动关闭时间」可自定义秒数（填 0 表示不自动关闭）
   - 消耗金额泡泡显示期间，余额变动不弹普通泡泡
@@ -43,7 +43,24 @@ dsh-whale-widget/
 
 ## 安装
 
-### 方式 A：本地安装（推荐，从当前仓库）
+### 方式 A：直接从 GitHub 安装（推荐）
+
+无需本地克隆，一条命令安装：
+
+```powershell
+dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget
+```
+
+说明：
+
+- 装完后插件会出现在 DSH 的**插件管理页面**里，之后可以直接在页面里更新，无需再手动执行命令
+- 网络环境需要代理时，先设置代理环境变量再执行：
+  ```powershell
+  $env:http_proxy="http://<ip>:<port>"; $env:https_proxy="http://<ip>:<port>"; $env:all_proxy="socks5://<ip>:<port>"; dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget
+  ```
+- 安装完成后重启 `dsh web`，再 F5 刷新浏览器
+
+### 方式 B：本地安装（从当前仓库）
 
 在**仓库根目录**（`DeepSeek-Balance-Whale-Widget`，即 `package.json` 所在目录）执行：
 
@@ -62,7 +79,7 @@ dsh plugin --profile web add link:.
 - 安装完成后重启 `dsh web`，再 F5 刷新浏览器
 - **如果之后移动了源码目录**，必须重新执行一次 `dsh plugin --profile web add link:.<新路径>`。若提示已存在/冲突，先 `dsh plugin --profile web remove dsh-whale-widget` 再重新 add
 
-### 方式 B：发布到 npm 后安装
+### 方式 C：发布到 npm 后安装
 
 ```powershell
 dsh plugin --profile web add dsh-whale-widget
@@ -77,10 +94,11 @@ dsh plugin --profile web add dsh-whale-widget
 
 步骤：
 1. 确保 pnpm 可用（没有就先：npm install -g pnpm）
-2. 在 Web profile 安装：
-   dsh plugin --profile web add dsh-whale-widget
-   如果要从本地仓库链接安装（例如本地克隆的仓库根目录），则用：
-   dsh plugin --profile web add link:.<仓库绝对路径>
+2. 在 Web profile 安装（任选一种来源）：
+   首选，直接从 GitHub 安装（无需本地克隆，装完可在插件管理页面里更新）：
+     dsh plugin --profile web add github:MeteorNOX/DeepSeek-Balance-Whale-Widget
+   或从本地仓库链接安装（例如本地克隆的仓库根目录）：
+     dsh plugin --profile web add link:.<仓库绝对路径>
    （注意：仓库根目录就是插件包，不要写成 link:.\dsh-whale-widget 这种带子目录的路径）
 3. 如果报 pnpm 阻止构建脚本（allowBuilds 相关），在 C:\Users\<用户名>\.dsh\profiles\web\pnpm-workspace.yaml 的 allowBuilds 下加对应的包 key，然后重跑
 4. 重启 dsh web，然后 F5 刷新浏览器
@@ -146,7 +164,7 @@ Remove-Item "$web\DSniang02.png" -ErrorAction SilentlyContinue
 
 **① 小鲸鱼记账（推荐，默认）—— 完全不需要额外配置**
 
-鲸鱼娘自己用**余额差值**记账：每次观测到余额下降就把差值累加到当天用量，跨天自动归零归档（保留 30 天）。只要配好了 `DEEPSEEK_API_KEY` 就能用，**开箱即用**。
+鲸鱼娘自己用**余额差值**记账：每次观测到余额下降就把差值累加到当天用量，跨天自动归零归档（保留 30 天）；观测币种发生变化时只重置基准、不记差值（防止多币种账户切换污染账本）。只要配好了 `DEEPSEEK_API_KEY` 就能用，**开箱即用**。
 
 - 账本文件：`$DSH_HOME/.dshw-usage.json`（自动生成）
 - 优点：零配置、免令牌

package/lib/index.js

@@ -63,7 +63,8 @@ const RUA_GIF_CANDIDATES = [
   'D:/TestBox/deepseek/rua.gif',
 ]
 // DeepSeek CNY prices per million tokens: [空闲时段价, 高峰时段价].
-// 高峰时段：每日 9:00–12:00 和 14:00–18:00（北京时间）。Adjust here if DeepSeek changes pricing.
+// 高峰时段：工作日 9:00–12:00 和 14:00–18:00（北京时间）；2026-08-23 起周末全天谷价。
+// Adjust here if DeepSeek changes pricing.
 const PEAK_HOURS = [
   [9, 12],
   [14, 18],
@@ -88,9 +89,18 @@ function priceFor(model) {
   return PRICING._default
 }
 // bucket time is an epoch second; derive the Beijing local hour to pick peak vs off-peak price.
+// 2026-08-23 起（北京时间）周末（周六/周日）全天按谷价；生效时刻之前的历史
+// 分桶仍按旧规则计价，所以周末判定带生效分界。
+const WEEKEND_VALLEY_FROM_SEC = Math.floor(Date.UTC(2026, 7, 22, 16, 0, 0) / 1000) // = 北京时间 2026-08-23 00:00
 function isPeakTime(timeSec) {
   if (!isFinite(Number(timeSec))) return false
-  const hour = new Date(Number(timeSec) * 1000 + 8 * 3600 * 1000).getUTCHours()
+  const n = Number(timeSec)
+  const bj = new Date(n * 1000 + 8 * 3600 * 1000)
+  if (n >= WEEKEND_VALLEY_FROM_SEC) {
+    const dow = bj.getUTCDay() // 0=周日 6=周六（bj 按 UTC 读即为北京日历日）
+    if (dow === 0 || dow === 6) return false
+  }
+  const hour = bj.getUTCHours()
   for (const [start, end] of PEAK_HOURS) {
     if (hour >= start && hour < end) return true
   }
@@ -611,6 +621,10 @@ function showCostBubble(amount) {
   if (costBubbleTimer) { clearTimeout(costBubbleTimer); costBubbleTimer = null }
   if (bubbleTimer) { clearTimeout(bubbleTimer); bubbleTimer = null }
   if (gifFadeTimer) { clearTimeout(gifFadeTimer); gifFadeTimer = null }
+  // 取消进行中的余额数字滚动与延迟计时器，避免竞态覆盖成本金额
+  if (animId) { cancelAnimationFrame(animId); animId = null }
+  if (animDelayTimer) { clearTimeout(animDelayTimer); animDelayTimer = null }
+  if (settleTimer) { clearTimeout(settleTimer); settleTimer = null }
   costBubbleActive = true
   bubbleRandomActive = false
   bubbleShown = true
@@ -672,6 +686,11 @@ function animateAmount(from, to, currency, duration) {
   }
   var startTime = null
   function step(ts) {
+    // 帧级保护：成本泡泡出现后立即停止滚动，避免后续帧把余额写进金额行
+    if (costBubbleActive) {
+      animId = null
+      return
+    }
     if (startTime === null) startTime = ts
     var t = Math.min(1, (ts - startTime) / duration)
     var eased = 1 - Math.pow(1 - t, 3)
@@ -1640,10 +1659,16 @@ function apply(ctx) {
       }
       return false
     }
-    // 记账模式：每次观测到余额后，用余额正差值累计当天用量（跨天自动归零并归档）
-    function recordLedgerUsage(currentBalance) {
+    // 记账模式：每次观测到余额后，用余额正差值累计当天用量（跨天自动归零并归档）。
+    // 币种感知：观测币种与上次不同时只重置基准、不记差值——数值跳变来自币种
+    // 切换而非真实消费（[0] 选币时代 CNY/USD 随机切换曾记出巨额假账，见 #13）。
+    function recordLedgerUsage(currentBalance, currency) {
       const t = todayKey()
       let led = readUsageLedger()
+      const cur = String(currency || '')
+      const currencyChanged =
+        typeof led.lastCurrency === 'string' && led.lastCurrency !== '' &&
+        cur !== '' && led.lastCurrency !== cur
       if (led.date !== t) {
         if (led.date && typeof led.todayUsage === 'number') {
           led.history = led.history || {}
@@ -1651,13 +1676,19 @@ function apply(ctx) {
         }
         led.date = t
         led.lastBalance = currentBalance
+        led.lastCurrency = cur
         led.todayUsage = 0
+      } else if (currencyChanged) {
+        // 币种切换：只换基准，不把差值记成消费
+        led.lastBalance = currentBalance
+        led.lastCurrency = cur
       } else {
         const prev = typeof led.lastBalance === 'number' ? led.lastBalance : currentBalance
         if (typeof prev === 'number' && typeof currentBalance === 'number' && currentBalance < prev) {
           led.todayUsage = (typeof led.todayUsage === 'number' ? led.todayUsage : 0) + (prev - currentBalance)
         }
         led.lastBalance = currentBalance
+        led.lastCurrency = cur
       }
       const keys = Object.keys(led.history || {}).sort()
       while (keys.length > 30) {
@@ -1674,7 +1705,7 @@ function apply(ctx) {
       const payload = await fetchBalance()
       if (!payload.ok) return payload
       // 无论哪种模式，都先把余额观测记入账本（自动累积「鲸鱼记账」数据）
-      const led = recordLedgerUsage(Number(payload.totalBalance))
+      const led = recordLedgerUsage(Number(payload.totalBalance), payload.currency)
       const cfg = readSizeConfig() || {}
       const mode = normalizeUsageMode(cfg.usageMode)
       const full = { ...payload }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-whale-widget",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "DSH Web 界面右下角的 DeepSeek 余额小鲸鱼挂件（含今日已用、峰谷定价、随机台词、音效与每轮消耗统计）",
   "keywords": [
     "dsh",
@@ -17,6 +17,14 @@
     "cordis.patch.yml",
     "README.md"
   ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget/issues"
+  },
+  "homepage": "https://github.com/MeteorNOX/DeepSeek-Balance-Whale-Widget#readme",
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"