deepseek-harness-wallet 0.2.5 → 0.2.6

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 All notable changes to this project are documented in this file.
 
+## 0.2.6 - 2026-08-23
+
+- 跟随 DeepSeek 官方规则更新峰谷计费：自 2026-08-23 北京时间 00:00 起，周六、周日全天按低谷价计费；工作日高峰仍为 09:00–12:00、14:00–18:00。 / Updated peak/off-peak billing to match DeepSeek's official rule: from 2026-08-23 00:00 Beijing, Saturday and Sunday are all-day off-peak; weekday peak windows remain 09:00–12:00 and 14:00–18:00.
+- 环形卡片同步显示周末全天低谷，并将倒计时指向下一个工作日 09:00。 / Updated the ring card to show weekend all-day off-peak and count down to the next weekday 09:00.
+
 ## 0.2.5 - 2026-08-23
 
 - 修复浮动峰谷卡片在窗口缩放、卡片放大或历史坐标过期后可能跑出视口的问题；加载、缩放、排版切换和 resize 都会重新钳制位置。 / Fixed floating peak cards escaping the viewport after resize, scale changes, or stale saved coordinates; load, scale, layout changes, and resize now re-clamp the position.

package/README.md

@@ -22,8 +22,8 @@
 余额 ¥5.89 · 本场 ¥0.72 · 官 18.8M | 三方 800K · ↗充
 ```
 
-- **Official DeepSeek** — live balance (60s global refresh with fast boot retries), current-session cost locked to the price active for each usage event (including the 2026-08-17 peak/off-peak rollout), and token breakdown.
-- **24h peak/off-peak ring clock** — resident sidebar footer widget indicating real-time pricing windows (peak vs. 50% discount off-peak), countdown to next switch, and optional desktop switch notifications.
+- **Official DeepSeek** — live balance (60s global refresh with fast boot retries), an estimated current-session cost (not an official bill) locked to the price active for each usage event, including the 2026-08-17 peak/off-peak rollout, and token breakdown.
+- **v4 peak/off-peak ring clock** — a resident 24-hour sidebar footer widget for `v4-flash` and `v4-pro`, indicating real-time pricing windows (peak vs. 50% discount off-peak), countdown to the next switch, and optional desktop switch notifications. Weekdays use 09:00–12:00 and 14:00–18:00 Beijing time; Saturday and Sunday are all-day off-peak from 2026-08-23. Other models keep their flat rates.
 - **Third-party total** — current-session tokens (input / cache read / output). No balance guessing, no cost math, zero configuration.
 - **Provider classification** — observed wrapper routes appear in the settings page; opted-in routes join the official token/cost bucket and are priced with the official table.
 - **Click the chip** to open the detail panel: correctly formatted per-currency balances, cost and token splits, a freely editable low-balance threshold for the active account and currency (two decimals, persisted per account; alerts never mix currencies), manual refresh, and a jump to the official recharge page (first click shows the domain for confirmation — anti-phishing).
@@ -34,13 +34,14 @@
 - **Low-balance alert** — below the threshold the chip turns red with a breathing animation and fires one desktop notification; it resets automatically once the balance recovers.
 - **Theme-native UI** — built entirely on `--dsw-alias-*` theme variables, so light and dark themes both render correctly; the panel closes when you click outside and flips open-direction near screen edges.
 - **Clear current-session wallet data** — one button clears only the open conversation's token/cost records; it does not delete the conversation, and every other conversation is untouched.
-
 
-- Open the wallet panel → **账户管理** to add accounts (name + API key), switch the active one, or remove them.
+## Multi-account
+
+- Open the wallet panel → **Account Management（账户管理）** to add accounts (name + API key), switch the active one, or remove them.
 - The first account added becomes the active account automatically and is synced into the credentials seam.
 - Switching prompts a confirmation because it changes **LLM billing** for subsequent requests: the switch writes the account key into the credentials seam (`credentials.set('DEEPSEEK_API_KEY', ...)`), and since the llm-deepseek provider route resolves that reference per request, the very next LLM call is billed with the new account — no restart needed.
-- Account keys are stored plaintext in `$DSH_HOME/storages/accounts.json`; the UI only ever shows masked keys. Balance lookups prefer the active account's key and fall back to the credentials seam when no account is active.
-- Session cost follows the active account's currency: USD-settled accounts show `本约 $x` — a clearly-labeled estimate converted from the CNY price table at the vendor's long-standing list ratio (not a live FX rate); CNY accounts show the exact `本场 ¥x`.
+- Account keys are stored in plaintext in `$DSH_HOME/storages/accounts.json`; the UI only shows masked keys. Treat the DSH data directory as a local credential store and protect access to it. Balance lookups prefer the active account's key and fall back to the credentials seam when no account is active.
+- Session usage estimates follow the active account's currency: USD-settled accounts show `本约 $x`, converted from the CNY price table at the vendor's long-standing list ratio (not a live FX rate); CNY accounts show `本场 ¥x`. These are local estimates, not an official invoice.
 - If `DEEPSEEK_API_KEY` is supplied by the launching environment, switching is refused with a clear error (the credentials provider rejects shadowed writes) — unset it in your shell to enable switching.
 
 
@@ -78,6 +79,14 @@ dsh plugin --profile web add github:feibi-mochi/deepseek-harness-control-center
 
 Restart `dsh web`, then hard-refresh the page.
 
+## Quick use
+
+1. Click the wallet or peak/off-peak card to open its control panel.
+2. Choose horizontal or vertical layout, then use the scale control between 100% and 120%.
+3. Turn the official recharge button off when you need a smaller card; official and third-party rows can also be shown independently.
+4. Drag the card to any open area. If it is hard to find after a layout change, use **Reset/Dock（归位/停靠）** in the panel to return it to the sidebar.
+5. The card follows the host light/dark theme. A hard refresh after upgrading makes sure the new client bundle is loaded.
+
 ### Update
 
 ```sh
@@ -129,8 +138,8 @@ For buildable DSH hosts, the npm package and repository include a versioned [Age
 | Item | Behavior |
 | --- | --- |
 | Token accounting | Listens to the `llm/stream` event and buckets per session and provider: `deepseek-official` plus explicitly opted-in wrapper routes use the official bucket; other providers stay third-party; each usage event also locks its contemporaneous official price, so multiple sessions and pricing windows never mix. |
-| Balance | The key from the credentials seam (or the active account's key) never leaves this machine except as the `Authorization` header of the official `/user/balance` request. |
-| Accounts | Keys live in `$DSH_HOME/storages/accounts.json` (plaintext, matching the harness's own credential storage); the UI only ever shows masked keys, and switching writes the chosen key into the credentials seam for LLM billing. |
+| Balance | The wallet plugin itself sends the active key directly only to the official `/user/balance` endpoint. When multi-account switching is enabled, the selected key is also written into the DSH credentials seam; DSH may then use it for subsequent model requests. |
+| Accounts | Keys live in `$DSH_HOME/storages/accounts.json` in plaintext, matching the harness's own credential storage. The UI only shows masked keys, and switching writes the chosen key into the credentials seam for subsequent LLM billing. Protect the DSH data directory as you would any local credential store. |
 | Session log | The plugin writes no events; its data lives in `$DSH_HOME/storages/wallet.json`. |
 | Local settings | Layout, scale, visibility, reminder, and panel settings stay in browser-compatible local storage. |
 | Permanent deletion | Opt-in and host-gated. The wallet never advertises the action unless the host implements the matching session deletion path. |
@@ -146,6 +155,7 @@ CNY per 1M tokens, curated from official announcements (cache writes are not bil
 - Since 2026-08-17 00:00 Beijing — peak/off-peak pricing for the v4 models (peak windows Beijing 09:00–12:00 / 14:00–18:00; off-peak is half the peak rate):
   - v4-flash (off-peak / peak): cache read 0.05 / 0.10, input 1.5 / 3, output 4.5 / 9
   - v4-pro (off-peak / peak): cache read 0.15 / 0.30, input 4.5 / 9, output 13.5 / 27
+- Since 2026-08-23 00:00 Beijing — Saturday and Sunday are no longer split into peak/off-peak windows; weekend calls use the off-peak rates all day. Weekday peak windows remain 09:00–12:00 and 14:00–18:00.
 
 deepseek-chat and deepseek-reasoner keep their flat rates. Each usage event is priced when it arrives; upgrading from 0.1.2 migrates legacy counters once using the then-current rate. Costs are estimates; the API-returned balance is authoritative.
 

package/index.js

@@ -35,14 +35,24 @@ const DEFAULT_THRESHOLD = 5
 const BALANCE_REFRESH_MS = 60_000
 const STORE_VERSION = 2
 
-// Beijing (UTC+8, no DST) peak windows: 09:00-12:00 and 14:00-18:00.
+// Beijing (UTC+8, no DST) weekday peak windows: 09:00-12:00 and 14:00-18:00.
+// From 2026-08-23 00:00 Beijing, Saturday and Sunday are off-peak all day.
 // Exposed to clients via snapshot.pricingWindows so the ring clock renders
 // from the active policy instead of hard-coding hours in the bundle.
 const PEAK_WINDOWS = [{ startHour: 9, endHour: 12 }, { startHour: 14, endHour: 18 }]
 const OFF_PEAK_RATE = 0.5
 const BEIJING_OFFSET_MS = 8 * 3600_000
+const WEEKEND_OFF_PEAK_SINCE = Date.UTC(2026, 7, 22, 16)
+
+function isBeijingWeekend(atMs) {
+  if (!Number.isFinite(atMs)) return false
+  const beijingDate = new Date(atMs + BEIJING_OFFSET_MS)
+  const day = beijingDate.getUTCDay()
+  return day === 0 || day === 6
+}
 
 export function isBeijingPeak(atMs) {
+  if (atMs >= WEEKEND_OFF_PEAK_SINCE && isBeijingWeekend(atMs)) return false
   const hours = ((atMs + BEIJING_OFFSET_MS) % 86_400_000) / 3_600_000
   return (hours >= 9 && hours < 12) || (hours >= 14 && hours < 18)
 }
@@ -661,6 +671,7 @@ function sessionView(sessionId) {
 function snapshotView(sessionId) {
   const currency = balanceCurrency(balance.balances)
   const active = activeAccount()
+  const now = Date.now()
   return {
     ok: true,
     balance: {
@@ -692,7 +703,9 @@ function snapshotView(sessionId) {
       offsetMinutes: 480,
       windows: PEAK_WINDOWS.map(w => ({ startHour: w.startHour, endHour: w.endHour })),
       offPeakRate: OFF_PEAK_RATE,
-      isPeak: isBeijingPeak(Date.now()),
+      isPeak: isBeijingPeak(now),
+      weekendOffPeak: now >= WEEKEND_OFF_PEAK_SINCE && isBeijingWeekend(now),
+      weekendOffPeakSince: WEEKEND_OFF_PEAK_SINCE,
     },
     accounts: {
       activeId: accounts.activeId,

package/lib/client.js

@@ -23,7 +23,7 @@ window.__ModuleLoader__.load({
 
     var POLL_MS = 15000
     // Keep in lockstep with package.json; a test enforces the sync.
-    var WALLET_VERSION = '0.2.5'
+    var WALLET_VERSION = '0.2.6'
     var CONFIRM_KEY = 'dsh-wallet-recharge-confirmed'
     var CHIP_LAYOUT_KEY = 'dshw-chip-layout-v4'
     var PANEL_POS_KEY = 'dshw-panel-pos-v1'
@@ -552,7 +552,7 @@ window.__ModuleLoader__.load({
     // Noon = 0h at 12 o'clock, clockwise. Optional size scales the 76-unit
     // viewBox down for tight hosts (sidebar foot row / rail circle); optional
     // ariaText overrides the fallback label with the full screen-reader state.
-    function peakRingSVG(windows, nowHour, size, ariaText) {
+    function peakRingSVG(windows, nowHour, size, ariaText, allOffPeak) {
       var sizePx = typeof size === 'number' && size > 0 ? size : 76
       var R = 28
       var CX = 38
@@ -561,6 +561,18 @@ window.__ModuleLoader__.load({
       // No pricing policy resolved: one neutral full ring, no arcs, no pointer
       // — the clock shows an unconfigured state and claims no price.
       if (!Array.isArray(windows) || windows.length === 0) {
+        if (allOffPeak === true) {
+          return React.createElement('svg', {
+            width: sizePx, height: sizePx, viewBox: '0 0 76 76',
+            role: 'img', className: 'dshw_peakRing',
+            'aria-label': ariaText || '当前为周末低谷时段，全天半价'
+          },
+            React.createElement('circle', {
+              key: 'weekend-off', cx: CX, cy: CY, r: R, fill: 'none',
+              className: 'dshw_ringOff dshw_ringNow', strokeWidth: 6.5,
+              strokeDasharray: CIRC.toFixed(2) + ' 0', strokeDashoffset: '0'
+            }))
+        }
         return React.createElement('svg', {
           width: sizePx, height: sizePx, viewBox: '0 0 76 76',
           role: 'img', className: 'dshw_peakRing',
@@ -1722,8 +1734,47 @@ window.__ModuleLoader__.load({
       var windows = policy && Array.isArray(policy.windows) ? policy.windows.filter(function (w) {
         return w && Number.isFinite(w.startHour) && Number.isFinite(w.endHour) && w.endHour > w.startHour
       }) : []
+      var weekendOffPeak = policy && policy.weekendOffPeak === true
+      if (weekendOffPeak) {
+        var offsetMinutes = policy && Number.isFinite(policy.offsetMinutes) ? policy.offsetMinutes : 480
+        var beijingNow = Number.isFinite(nowMs) ? new Date(nowMs + offsetMinutes * 60000) : null
+        var day = beijingNow && Number.isFinite(beijingNow.getTime()) ? beijingNow.getUTCDay() : 6
+        var daysUntilMonday = day === 6 ? 2 : 1
+        var nextSwitchMs = beijingNow && Number.isFinite(beijingNow.getTime())
+          ? Date.UTC(
+            beijingNow.getUTCFullYear(), beijingNow.getUTCMonth(), beijingNow.getUTCDate() + daysUntilMonday,
+            9 - (offsetMinutes / 60), 0, 0, 0
+          ) - offsetMinutes * 60000
+          : NaN
+        var weekendMsLeft = Number.isFinite(nextSwitchMs) && Number.isFinite(nowMs)
+          ? Math.max(0, nextSwitchMs - nowMs)
+          : 0
+        var weekendHours = Math.floor(weekendMsLeft / 3600000)
+        var weekendMinutes = Math.floor((weekendMsLeft % 3600000) / 60000)
+        var weekendLeftText = weekendHours > 0
+          ? weekendHours + ' 小时 ' + weekendMinutes + ' 分'
+          : weekendMinutes + ' 分钟'
+        var weekendLeftShort = weekendHours > 0
+          ? weekendHours + 'h' + (weekendMinutes > 0 ? weekendMinutes + 'm' : '')
+          : weekendMinutes + 'm'
+        var weekendDateKey = beijingNow && Number.isFinite(beijingNow.getTime())
+          ? [beijingNow.getUTCFullYear(), String(beijingNow.getUTCMonth() + 1).padStart(2, '0'), String(beijingNow.getUTCDate()).padStart(2, '0')].join('-')
+          : 'weekend'
+        var weekendTzName = policy.timezone || 'Asia/Shanghai'
+        return {
+          configured: true, windows: [], weekendOffPeak: true, inPeak: false,
+          nextHour: 9,
+          ariaText: '当前为周末低谷时段，全天按半价计费，周一 09:00 恢复标准价',
+          tip: '峰谷时钟 · 当前周末低谷 · 周一 09:00 恢复标准价 · 还有 ' + weekendLeftText + ' · ' + weekendTzName,
+          periodName: '周末低谷', rateBadge: '半价',
+          countdownSummary: '周一 09:00 切换 · 剩 ' + weekendLeftShort,
+          windowSummary: '周末全天低谷 · 工作日高峰 09:00–12:00 / 14:00–18:00',
+          periodId: 'weekend-off-' + weekendDateKey,
+          switchBody: '周末低谷结束，已进入工作日高峰时段，按标准价计费',
+        }
+      }
       if (windows.length === 0) {
-        return { configured: false, windows: [], ariaText: '峰谷计费时段未配置', tip: '峰谷时钟 · 计费时段未配置', periodId: null }
+        return { configured: false, windows: [], weekendOffPeak: false, ariaText: '峰谷计费时段未配置', tip: '峰谷时钟 · 计费时段未配置', periodId: null }
       }
       var inPeak = false
       var segStart = null
@@ -1786,7 +1837,7 @@ window.__ModuleLoader__.load({
       var tip = '峰谷时钟 · 当前' + period + ' · ' + switchText + ' · 还有 ' + leftText
         + ' · 高峰 ' + winText + '（' + tzName + '）' + localNote
       return {
-        configured: true, windows: windows, inPeak: inPeak,
+        configured: true, windows: windows, weekendOffPeak: false, inPeak: inPeak,
         nextHour: nextHour, ariaText: ariaText, tip: tip,
         periodName: periodName, rateBadge: rateBadge,
         countdownSummary: countdownSummary, windowSummary: windowSummary,
@@ -2240,7 +2291,7 @@ window.__ModuleLoader__.load({
           onClick: handleResetDock
         }, '↩ 归位') : null,
         React.createElement('div', { style: { flex: 'none', display: 'flex', alignItems: 'center', justifyContent: 'center' } },
-          peakRingSVG(state.configured ? state.windows : null, wallHourIn(tzName, offsetMinutes, new Date(nowMs)), clockSize, state.ariaText)
+          peakRingSVG(state.configured ? state.windows : null, wallHourIn(tzName, offsetMinutes, new Date(nowMs)), clockSize, state.ariaText, state.weekendOffPeak)
         ),
         !isRail ? React.createElement('div', { className: 'dshw_footRingLabel' },
           React.createElement('div', { className: 'dshw_footRingHeader' },

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "deepseek-harness-wallet",
   "description": "Local-first account monitoring, usage accounting, official recharge, completion reminders, flexible layout, host-gated session controls, and multi-account management with hot account switching for DeepSeek Harness.",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "type": "module",
   "main": "index.js",
   "exports": {