deepseek-harness-wallet 0.3.5 → 0.3.8

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable changes to this project are documented in this file.
 
+## 0.3.8 - 2026-09-02
+
+- 新增第三方 API 自定义价格（Issue #36）：可按精确 Provider/模型设置币种以及每百万 Token 的输入、缓存读、缓存写和输出价格；本会话与 365 天账本会按当前规则重新估算，并始终标注为用户自定义估算。 / Added custom third-party API pricing (Issue #36) with exact Provider/model matching, currency, and per-million input/cache-read/cache-write/output rates; current-session and 365-day ledger totals are recalculated from the active user rule and always labeled as estimates.
+- 自定义价格保存在本机 `wallet.json`，支持修改、删除、观察到的路由建议、输入边界与官方/套餐 Provider 隔离；不会保存 API Key，也不会更改历史 Token。 / Custom prices persist locally in `wallet.json`, support editing, deletion, observed-route suggestions, bounded inputs, and strict separation from official/plan providers; no API keys or historical token counts are changed.
+
+## 0.3.7 - 2026-09-01
+
+- 适配 DeepSeek Harness `0.1.2-alpha.3` 的新客户端包结构：移除已被官方删除的 `@deepseek-ai/dsh-client-runtime` 清单边，继续通过 Cordis `sessions` 服务和现存 UI slot 合约工作；同时保留 `0.1.1-rc.2` 兼容。 / Adapted to the new DeepSeek Harness `0.1.2-alpha.3` client package layout by removing the retired `@deepseek-ai/dsh-client-runtime` manifest edge while continuing to consume the Cordis `sessions` service and surviving UI-slot contracts; `0.1.1-rc.2` compatibility is retained.
+- 在隔离的 alpha.3 构建和数据目录中完成 npm 安装、完整 Harness 构建、Web 启动、插件后端、设置页、365 天账本、背景选项和健康检查验证，未向测试环境写入真实凭据。 / Verified npm installation, a full Harness build, Web startup, plugin host routes, settings UI, 365-day ledger, background controls, and health checks in isolated alpha.3 source/data directories without copying real credentials into the test environment.
+
+## 0.3.6 - 2026-08-28
+
+- 峰谷时钟新增明确的「透明 / 实色」背景选择，不加入自动模式；透明模式常态不铺底，悬停时使用主题实色，实色模式保持原有卡片背景。 / Added an explicit peak-clock background choice between transparent and solid, without an automatic mode; transparent mode removes the normal fill and uses the themed solid hover surface, while solid mode keeps the existing card background.
+- 设置页和时钟控制面板共享该偏好，并同步保存到宿主钱包存储；覆盖默认、悬浮、竖排、浅色和深色主题，避免透明卡片文字或悬浮卡片背景异常。 / The setting is shared by the settings page and clock control panel and backed by the host wallet store; default, floating, vertical, light, and dark-theme paths are covered so transparent cards remain readable and floating cards keep a valid surface.
+
 ## 0.3.5 - 2026-08-27
 
 - 修复 BigModel / Z.ai 中国区 Coding Plan 接口将 `TOKENS_LIMIT` 改名为 `CREDIT_LIMIT` 后被误判为“套餐接口返回格式已变化”的问题；兼容新旧字段，支持只有新额度字段的响应，并在接口提供时显示已用/总量、剩余量和重置时间。 / Fixed BigModel / Z.ai China Coding Plan responses being misclassified as “the plan response format changed” after `TOKENS_LIMIT` was renamed to `CREDIT_LIMIT`; both names are supported, credit-only responses are accepted, and available used/total, remaining, and reset values are shown when provided.

package/README.md

@@ -14,7 +14,7 @@
 
 > A local-first companion that keeps account status, per-conversation usage, completion reminders, official recharge, flexible layout, and host-gated session controls beside the DSH composer.
 
-> **Version:** v0.3.5 is the current stable release on GitHub and npm.
+> **Version:** v0.3.8 is the current release on GitHub and npm.
 
 > If DeepSeek Harness Control Center helps you, please consider leaving a ⭐ Star. Thank you!
 
@@ -31,10 +31,11 @@
 - **Z.ai Coding Plan quotas** — a generic official-plan adapter monitors configured Global and China plans without exposing credentials. It separates the 5-hour model-token window from monthly MCP-tool usage, leads with quota remaining from 100% down while keeping usage as secondary context, retains the last successful snapshot on failure, and never converts subscription quota into CNY balance.
 - **Provider-aware composer surfaces** — the chip and sidebar clock follow the session's selected provider/model. Z.ai replaces DeepSeek balance, recharge, and peak pricing with plan-window summaries; unrelated providers show only their own session tokens, and DeepSeek V4 restores the wallet and peak clock.
 - **365-day local usage ledger** — Wallet settings keeps the heatmap visible, while compact wallet panels keep it collapsible. Stable request identities are deduplicated, official cost is locked at usage time, official and third-party data stay separate, and prompts or responses are never stored. Collection begins after upgrading to v0.3.2; older aggregate counters have no trustworthy dates and are not backfilled.
-- **Third-party total** — current-session tokens (input / cache read / output). No balance guessing, no cost math, zero configuration.
+- **Third-party total** — current-session tokens (input / cache read / output) remain available with zero configuration.
+- **Custom third-party pricing** — enter an exact Provider/model route, currency, and per-million input/cache-read/cache-write/output rates. Current-session and 365-day ledger costs are recalculated locally from the saved rule and clearly labeled as user-defined estimates, never as provider balances or invoices.
 - **Provider classification** — observed wrapper routes appear in the settings page; opted-in routes join the official token/cost bucket for subsequent calls and are priced with the official table. Existing history is not retroactively reclassified.
 - **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).
-- **Move, dock, and scale** — drag the chip freely, preview nearby snap targets, use compact horizontal or vertical layouts, adjust its scale from the control panel, and show official or third-party data independently. The choices are remembered locally.
+- **Move, dock, and scale** — drag the chip freely, preview nearby snap targets, use compact horizontal or vertical layouts, adjust its scale from the control panel, and show official or third-party data independently. The peak clock background can be explicitly set to transparent (solid on hover) or solid; there is no automatic mode. The choices are remembered locally.
 - **Composer-label controls and skin compatibility** — independently show/hide the composer label or reduce it to the primary remaining value (DeepSeek balance, Z.ai five-hour quota) without disabling reminders, settings, plan monitoring, or history. The standard chip also resists broad skin button rules and aligns with maid-atelier's 38px navy-and-gold composer toolbar.
 - **Floating window mode** — detach the detail panel into a draggable window with a remembered position, or minimize it directly to a freely movable dot; the dot turns red below the threshold.
 - **Completion reminders** — optionally notify when a conversation finishes, with persistent or timed modes, queueing and deduplication for simultaneous completions, cross-tab coordination, and an in-page fallback when system notifications are unavailable.
@@ -73,13 +74,13 @@ Details: [compatibility](#browser-desktop-and-os-compatibility) · [data and tru
 
 ## Install
 
-From npm (stable v0.3.5):
+From npm (published stable v0.3.8):
 
 ```sh
 dsh plugin --profile web add deepseek-harness-wallet
 ```
 
-or from GitHub `main` (current v0.3.5 source):
+or from GitHub `main`:
 
 ```sh
 dsh plugin --profile web add github:feibi-mochi/deepseek-harness-control-center
@@ -116,6 +117,7 @@ The client contains no operating-system-specific feature branch; it checks the W
 | Verification level | Coverage |
 | --- | --- |
 | Real environment checked for this release | Windows + current Edge + DSH Web |
+| Verified Harness versions | `0.1.1-rc.2` and isolated `0.1.2-alpha.3` Web profiles; the alpha profile was built from its official tag and started with no real credentials |
 | Automated compatibility checks | Browser notification failure, in-page fallback, cross-tab fallback, storage fallback, CSS-scale fallback, and synchronous/asynchronous desktop adapters |
 | Capability-compatible targets | Current Chrome, Edge, and Firefox on Windows/macOS/Linux; Safari on macOS; Electron/Tauri-style DSH wrappers that provide the requirements below |
 
@@ -148,7 +150,7 @@ For buildable DSH hosts, the npm package and repository include a versioned [Age
 | 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 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 encrypted in `$DSH_HOME/storages/accounts.json`, with an encrypted `accounts.json.bak` fallback for a missing, corrupt, or undecryptable primary. Windows uses current-user DPAPI; other platforms use an owner-only AES-GCM key file, so move `accounts.json`, `.bak`, and `.key` together. If neither copy can be read, account writes fail closed. |
-| Usage ledger | Local events live in `$DSH_HOME/storages/wallet.json` with a `wallet.json.bak` recovery copy. Missing/corrupt primaries recover automatically; if neither copy is readable, wallet writes fail closed. Up to 365 days of session/provider/model/token metadata and locked cost are kept—never prompts, tool arguments, or response bodies. |
+| Usage ledger | Local events and custom third-party price rules live in `$DSH_HOME/storages/wallet.json` with a `wallet.json.bak` recovery copy. Missing/corrupt primaries recover automatically; if neither copy is readable, wallet writes fail closed. Up to 365 days of session/provider/model/token metadata and official locked cost are kept—never prompts, tool arguments, response bodies, or API keys. Third-party estimates are recalculated from the current custom rule. |
 | 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. |
 | Model surface | No tools registered, no prompt injection, zero token cost. |
@@ -172,6 +174,7 @@ Historical deepseek-chat and deepseek-reasoner records retain their original fla
 
 - [x] 365-day Token heatmap and rebuildable local usage ledger
 - [x] Z.ai Coding Plan Global/China monitoring on a generic official-plan adapter contract
+- [x] User-defined third-party Provider/model pricing
 - [ ] Additional provider price/balance adapters only after real-account validation
 
 ## License

package/index.js

@@ -33,7 +33,7 @@ const OFFICIAL_PROVIDER = 'deepseek-official'
 // DeepSeek's official paid-API bucket by the wrapper-provider alias control.
 const PLAN_PROVIDER_IDS = new Set(PLAN_ADAPTERS.map((adapter) => adapter.provider))
 const RECHARGE_URL = 'https://platform.deepseek.com/top_up'
-const PLUGIN_VERSION = '0.3.5'
+const PLUGIN_VERSION = '0.3.8'
 const PRICING_SOURCE_URL = 'https://api-docs.deepseek.com/zh-cn/quick_start/pricing/'
 const PRICING_SYNC_INTERVAL_MS = 6 * 60 * 60_000
 const PRICING_SYNC_TIMEOUT_MS = 8_000
@@ -49,10 +49,12 @@ const ACCOUNTS_CRYPTO_VERSION = 1
 const CREDENTIAL_REF = 'DEEPSEEK_API_KEY'
 const DEFAULT_THRESHOLD = 5
 const BALANCE_REFRESH_MS = 60_000
-const STORE_VERSION = 5
+const STORE_VERSION = 6
 const HISTORY_VERSION = 1
 const HISTORY_RETENTION_DAYS = 365
 const HISTORY_MAX_EVENTS = 20_000
+const CUSTOM_PRICE_MAX_RULES = 100
+const CUSTOM_PRICE_MAX_RATE = 1_000_000
 const HISTORY_TIMEZONE = 'Asia/Shanghai'
 const DAY_MS = 86_400_000
 const PLAN_REFRESH_MS = 5 * 60_000
@@ -68,6 +70,7 @@ const UI_PREFERENCE_KEYS = new Set([
   'dshw-low-blink-v1',
   'dshw-peakring-v1',
   'dshw-peak-orient-v1',
+  'dshw-peak-background-v1',
   'dshw-peak-recharge-v1',
   'dshw-peak-scale-v1',
   'dshw-peak-dock-v1',
@@ -732,6 +735,15 @@ function removeSessionContribution(event) {
       bucket.unpriced = Math.max(0, currentUnpriced - 1)
       bucket.priced = bucket.unpriced === 0
     }
+  } else if (bucket.routes && bucket.routes[event.provider] && bucket.routes[event.provider].models) {
+    const routeCounters = bucket.routes[event.provider].models[event.model]
+    if (routeCounters !== null && typeof routeCounters === 'object') {
+      subtractUsage(routeCounters, event.usage)
+      if (Object.values(routeCounters).every((value) => finiteCounter(value) === 0)) {
+        delete bucket.routes[event.provider].models[event.model]
+      }
+      if (Object.keys(bucket.routes[event.provider].models).length === 0) delete bucket.routes[event.provider]
+    }
   }
 }
 
@@ -811,17 +823,24 @@ function historyAggregate(events) {
   }
   total.cost = official.cost
   total.priced = official.priced
-  return {
-    official: publicHistoryAggregate(official, true),
-    third: publicHistoryAggregate(third, false),
-    total: publicHistoryAggregate(total, official.calls > 0),
-    cacheHitRate: cacheInput + cacheRead > 0 ? Math.round(cacheRead / (cacheInput + cacheRead) * 1000) / 10 : null,
-    models: [...models.values()].map((model) => ({
+  const publicModels = [...models.values()].map((model) => {
+    const aggregate = publicHistoryAggregate(model, model.official)
+    const priced = model.official ? null : customCostOf(model.provider, model.model, model.tokens, store.customPrices)
+    return {
       provider: model.provider,
       model: model.model,
       official: model.official,
-      ...publicHistoryAggregate(model, model.official),
-    })),
+      ...aggregate,
+      customCost: priced === null ? null : { cost: priced.cost, currency: priced.currency },
+    }
+  })
+  const customCosts = customCostTotals(publicModels)
+  return {
+    official: publicHistoryAggregate(official, true),
+    third: { ...publicHistoryAggregate(third, false), customCosts },
+    total: { ...publicHistoryAggregate(total, official.calls > 0), customCosts },
+    cacheHitRate: cacheInput + cacheRead > 0 ? Math.round(cacheRead / (cacheInput + cacheRead) * 1000) / 10 : null,
+    models: publicModels,
   }
 }
 
@@ -902,6 +921,90 @@ export function isOfficialProvider(provider, extraProviders) {
   return Array.isArray(extraProviders) && extraProviders.includes(provider)
 }
 
+function customPriceRate(value) {
+  if (typeof value !== 'number' || !Number.isFinite(value) || value < 0 || value > CUSTOM_PRICE_MAX_RATE) return null
+  return Math.round(value * 1_000_000) / 1_000_000
+}
+
+/** Normalize one exact third-party provider/model price rule (rates are per 1M tokens). */
+export function normalizeCustomPriceRule(value) {
+  const source = value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {}
+  const provider = boundedString(source.provider, 100)
+  const model = boundedString(source.model, 160)
+  const currency = typeof source.currency === 'string' ? source.currency.toUpperCase() : ''
+  const input = customPriceRate(source.input)
+  const cacheRead = customPriceRate(source.cacheRead)
+  const cacheWrite = customPriceRate(source.cacheWrite)
+  const output = customPriceRate(source.output)
+  if (provider === null || model === null || !/^[A-Z]{3}$/.test(currency)) return null
+  if (provider === OFFICIAL_PROVIDER || isPlanProvider(provider)) return null
+  if (provider === '__proto__' || provider === 'prototype' || provider === 'constructor') return null
+  if (model === '__proto__' || model === 'prototype' || model === 'constructor') return null
+  if ([input, cacheRead, cacheWrite, output].some((rate) => rate === null)) return null
+  return { provider, model, currency, input, cacheRead, cacheWrite, output }
+}
+
+/** Normalize, deduplicate, and bound persisted custom third-party price rules. */
+export function normalizeCustomPrices(value) {
+  if (!Array.isArray(value)) return []
+  const rules = new Map()
+  for (const candidate of value) {
+    const rule = normalizeCustomPriceRule(candidate)
+    if (rule === null) continue
+    const key = rule.provider + '\u0000' + rule.model
+    if (rules.has(key)) rules.delete(key)
+    rules.set(key, rule)
+    if (rules.size > CUSTOM_PRICE_MAX_RULES) rules.delete(rules.keys().next().value)
+  }
+  return [...rules.values()]
+}
+
+/** Price one exact third-party route from user-entered per-million-token rates. */
+export function customCostOf(provider, model, usage, rules) {
+  if (typeof provider !== 'string' || typeof model !== 'string') return null
+  const rule = normalizeCustomPrices(rules).find((entry) => entry.provider === provider && entry.model === model)
+  if (rule === undefined) return null
+  const counters = historyUsageCounters(usage)
+  const cost = (
+    counters.input * rule.input
+    + counters.cacheRead * rule.cacheRead
+    + counters.cacheWrite * rule.cacheWrite
+    + counters.output * rule.output
+  ) / 1e6
+  return { cost, currency: rule.currency, rule }
+}
+
+function normalizeThirdPartyRoutes(value) {
+  const source = value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {}
+  const routes = {}
+  let providers = 0
+  let models = 0
+  for (const [provider, rawProvider] of Object.entries(source)) {
+    if (boundedString(provider, 100) === null || provider === OFFICIAL_PROVIDER || isPlanProvider(provider)) continue
+    if (provider === '__proto__' || provider === 'prototype' || provider === 'constructor') continue
+    const rawModels = rawProvider !== null && typeof rawProvider === 'object' && !Array.isArray(rawProvider)
+      ? rawProvider.models
+      : null
+    const normalizedModels = normalizeModels(rawModels)
+    if (Object.keys(normalizedModels).length === 0) continue
+    routes[provider] = { models: normalizedModels }
+    providers += 1
+    models += Object.keys(normalizedModels).length
+    if (providers >= 100 || models >= 1_000) break
+  }
+  return routes
+}
+
+function customCostTotals(rows) {
+  const totals = {}
+  for (const row of rows) {
+    if (row === null || typeof row !== 'object' || !row.customCost) continue
+    const currency = row.customCost.currency
+    totals[currency] = (totals[currency] || 0) + row.customCost.cost
+  }
+  return totals
+}
+
 export function normalizeUiPreferences(value) {
   const source = value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {}
   const normalized = {}
@@ -963,7 +1066,10 @@ export function normalizeStoreData(value, atMs = Date.now()) {
     const rawSession = value !== null && typeof value === 'object' && !Array.isArray(value) ? value : {}
     sessions[sessionId] = {
       official: migratedOfficialBucket(rawSession.official, atMs),
-      third: { models: normalizeModels(rawSession.third && rawSession.third.models) },
+      third: {
+        models: normalizeModels(rawSession.third && rawSession.third.models),
+        routes: normalizeThirdPartyRoutes(rawSession.third && rawSession.third.routes),
+      },
     }
     sessionCount += 1
     if (sessionCount >= 5_000) break
@@ -975,6 +1081,7 @@ export function normalizeStoreData(value, atMs = Date.now()) {
     sessions,
     officialProviders: normalizeProviderList(source.officialProviders),
     knownProviders: normalizeProviderList(source.knownProviders),
+    customPrices: normalizeCustomPrices(source.customPrices),
     plans: normalizePlanSnapshotCache(source.plans, atMs),
     preferences: normalizeUiPreferences(source.preferences),
   }
@@ -992,7 +1099,7 @@ let usageStorageRecovered = false
 let usageStoreSkipBackupOnce = false
 
 function emptyStoreData() {
-  return { version: STORE_VERSION, thresholds: { CNY: DEFAULT_THRESHOLD }, accountThresholds: {}, sessions: {}, officialProviders: [], knownProviders: [], plans: {}, preferences: {}, history: emptyHistory() }
+  return { version: STORE_VERSION, thresholds: { CNY: DEFAULT_THRESHOLD }, accountThresholds: {}, sessions: {}, officialProviders: [], knownProviders: [], customPrices: [], plans: {}, preferences: {}, history: emptyHistory() }
 }
 
 function readStoreFile(path) {
@@ -1702,7 +1809,7 @@ function recordUsage(options, usage, atMs = Date.now()) {
     store.knownProviders = normalizeProviderList([...store.knownProviders, provider])
   }
   if (!Object.hasOwn(store.sessions, sessionId)) {
-    store.sessions[sessionId] = { official: emptyBucket(true), third: emptyBucket(false) }
+    store.sessions[sessionId] = { official: emptyBucket(true), third: { models: {}, routes: {} } }
   }
   const event = createHistoryEvent(request, usage, atMs, store.officialProviders)
   const previousEvent = event !== null && store.history && store.history.events ? store.history.events[event.eventId] : undefined
@@ -1715,6 +1822,10 @@ function recordUsage(options, usage, atMs = Date.now()) {
   else {
     if (!Object.hasOwn(bucket.models, model)) bucket.models[model] = emptyCounters()
     addUsage(bucket.models[model], usage)
+    if (bucket.routes === null || typeof bucket.routes !== 'object' || Array.isArray(bucket.routes)) bucket.routes = {}
+    if (!Object.hasOwn(bucket.routes, provider)) bucket.routes[provider] = { models: {} }
+    if (!Object.hasOwn(bucket.routes[provider].models, model)) bucket.routes[provider].models[model] = emptyCounters()
+    addUsage(bucket.routes[provider].models[model], usage)
   }
   recordHistoryEvent(event)
 }
@@ -1836,6 +1947,42 @@ function balanceTotal() {
   return sumBalances(balance.balances)
 }
 
+function thirdPartyRouteView(bucket) {
+  const routes = []
+  const source = normalizeThirdPartyRoutes(bucket && bucket.routes)
+  for (const [provider, providerState] of Object.entries(source)) {
+    if (isPlanProvider(provider) || isOfficialProvider(provider, store.officialProviders)) continue
+    for (const [model, counters] of Object.entries(providerState.models)) {
+      const priced = customCostOf(provider, model, counters, store.customPrices)
+      routes.push({
+        provider,
+        model,
+        tokens: counters,
+        totalTokens: historyTokenTotal(counters),
+        customCost: priced === null ? null : { cost: priced.cost, currency: priced.currency },
+      })
+    }
+  }
+  return routes
+}
+
+function knownThirdPartyRoutes() {
+  const found = new Map()
+  for (const session of Object.values(store.sessions)) {
+    for (const route of thirdPartyRouteView(session && session.third)) {
+      found.set(route.provider + '\u0000' + route.model, { provider: route.provider, model: route.model })
+    }
+  }
+  for (const event of Object.values(store.history && store.history.events ? store.history.events : {})) {
+    if (!event || event.official || isPlanProvider(event.provider) || isOfficialProvider(event.provider, store.officialProviders)) continue
+    const provider = boundedString(event.provider, 100)
+    const model = boundedString(event.model, 160)
+    if (provider !== null && model !== null) found.set(provider + '\u0000' + model, { provider, model })
+    if (found.size >= 500) break
+  }
+  return [...found.values()].slice(0, 500)
+}
+
 function sessionView(sessionId) {
   if (sessionId === undefined || sessionId === '') return { official: null, third: null }
   // Own-property lookup only: session ids like `__proto__`, `constructor` or
@@ -1852,6 +1999,7 @@ function sessionView(sessionId) {
   }
   const official = bucketTotals(session.official)
   const third = bucketTotals(session.third)
+  const thirdRoutes = thirdPartyRouteView(session.third)
   return {
     official: {
       tokens: official,
@@ -1859,7 +2007,12 @@ function sessionView(sessionId) {
       priced: session.official.priced === true,
       models: session.official.models,
     },
-    third: { tokens: third, models: session.third.models },
+    third: {
+      tokens: third,
+      models: session.third.models,
+      routes: thirdRoutes,
+      customCosts: customCostTotals(thirdRoutes),
+    },
   }
 }
 
@@ -1907,6 +2060,8 @@ function snapshotView(sessionId) {
       builtinOfficial: OFFICIAL_PROVIDER,
       official: [...store.officialProviders],
       known: store.knownProviders.filter((p) => p !== OFFICIAL_PROVIDER && !store.officialProviders.includes(p)),
+      customPrices: [...store.customPrices],
+      knownRoutes: knownThirdPartyRoutes(),
     },
     plans: planView(now),
   }
@@ -2190,6 +2345,7 @@ historyEventCount = store.history && store.history.events ? Object.keys(store.hi
         const body = await readBody(req)
         if (body === null || !Array.isArray(body.providers)) return json(res, 400, { ok: false, error: 'providers array is required' })
         store.officialProviders = normalizeProviderList(body.providers)
+        store.customPrices = store.customPrices.filter((rule) => !store.officialProviders.includes(rule.provider))
         scheduleSave(ctx.logger)
         return json(res, 200, {
           ok: true,
@@ -2198,6 +2354,40 @@ historyEventCount = store.history && store.history.events ? Object.keys(store.hi
         })
       },
     })
+    const disposeCustomPrices = ctx.webServer.register({
+      kind: 'exact',
+      path: '/api/wallet/custom-prices',
+      handler: async (req, res) => {
+        if (req.method === 'GET') {
+          return json(res, 200, { ok: true, rules: [...store.customPrices], knownRoutes: knownThirdPartyRoutes() })
+        }
+        if (usageStorageLocked) return json(res, 423, { ok: false, error: 'usage-storage-locked' })
+        if (req.method !== 'POST' && req.method !== 'DELETE') {
+          return json(res, 405, { ok: false, error: 'method-not-allowed' })
+        }
+        const body = await readBody(req, 16_384)
+        if (body === null) return json(res, 400, { ok: false, error: 'invalid-body' })
+        if (req.method === 'POST') {
+          const rule = normalizeCustomPriceRule(body.rule)
+          if (rule === null) return json(res, 400, { ok: false, error: 'invalid-custom-price' })
+          if (isOfficialProvider(rule.provider, store.officialProviders)) {
+            return json(res, 400, { ok: false, error: 'official-provider-not-allowed' })
+          }
+          store.customPrices = normalizeCustomPrices([
+            ...store.customPrices.filter((entry) => entry.provider !== rule.provider || entry.model !== rule.model),
+            rule,
+          ])
+          scheduleSave(ctx.logger)
+          return json(res, 200, { ok: true, rules: [...store.customPrices], knownRoutes: knownThirdPartyRoutes() })
+        }
+        const provider = boundedString(body.provider, 100)
+        const model = boundedString(body.model, 160)
+        if (provider === null || model === null) return json(res, 400, { ok: false, error: 'provider-and-model-required' })
+        store.customPrices = store.customPrices.filter((entry) => entry.provider !== provider || entry.model !== model)
+        scheduleSave(ctx.logger)
+        return json(res, 200, { ok: true, rules: [...store.customPrices], knownRoutes: knownThirdPartyRoutes() })
+      },
+    })
     const disposeAccounts = ctx.webServer.register({
       kind: 'exact',
       path: '/api/wallet/accounts',
@@ -2284,6 +2474,7 @@ historyEventCount = store.history && store.history.events ? Object.keys(store.hi
       disposePlans()
       disposeAccounts()
       disposeProviders()
+      disposeCustomPrices()
       disposeActivate()
       disposeRemove()
       clearInterval(balanceTimer)

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.3.5'
+    var WALLET_VERSION = '0.3.8'
     var CONFIRM_KEY = 'dsh-wallet-recharge-confirmed'
     var CHIP_LAYOUT_KEY = 'dshw-chip-layout-v4'
     var PANEL_POS_KEY = 'dshw-panel-pos-v1'
@@ -37,6 +37,7 @@ window.__ModuleLoader__.load({
     var LOW_BLINK_KEY = 'dshw-low-blink-v1'
     var PEAK_RING_KEY = 'dshw-peakring-v1'
     var PEAK_ORIENT_KEY = 'dshw-peak-orient-v1'
+    var PEAK_BACKGROUND_KEY = 'dshw-peak-background-v1'
     var PEAK_RECHARGE_KEY = 'dshw-peak-recharge-v1'
     var PEAK_SCALE_KEY = 'dshw-peak-scale-v1'
     var PEAK_DOCK_KEY = 'dshw-peak-dock-v1'
@@ -54,7 +55,7 @@ window.__ModuleLoader__.load({
     var CHIP_HOME_SNAP = 96
     var BACKED_PREFERENCE_KEYS = new Set([
       CHIP_STYLE_KEY, CHIP_BALANCE_ONLY_KEY, DATA_VISIBILITY_KEY, CHIP_SCALE_KEY,
-      NOTIFY_CONFIG_KEY, LOW_BLINK_KEY, PEAK_RING_KEY, PEAK_ORIENT_KEY,
+      NOTIFY_CONFIG_KEY, LOW_BLINK_KEY, PEAK_RING_KEY, PEAK_ORIENT_KEY, PEAK_BACKGROUND_KEY,
       PEAK_RECHARGE_KEY, PEAK_SCALE_KEY, PEAK_DOCK_KEY, PEAK_NOTIFY_KEY,
       PERMANENT_DELETE_KEY
     ])
@@ -609,6 +610,15 @@ window.__ModuleLoader__.load({
       '.dshw_settingChoiceCopy{min-width:0;display:flex;flex-direction:column;gap:1px}',
       '.dshw_settingChoiceCopy strong{font-size:11px;font-weight:550;white-space:nowrap;color:var(--dsw-alias-label-primary,inherit)}',
       '.dshw_settingChoiceCopy span{font-size:9.5px;color:var(--dsw-alias-label-secondary,var(--dsw-alias-label-tertiary,#667085));white-space:nowrap;overflow:hidden;text-overflow:ellipsis}',
+      '.dshw_priceForm{display:grid;grid-template-columns:minmax(120px,1.25fr) minmax(140px,1.5fr) 72px repeat(4,minmax(74px,.7fr)) auto;gap:7px;align-items:end;padding:10px 12px}',
+      '.dshw_priceField{display:grid;gap:4px;min-width:0}',
+      '.dshw_priceField>span{font-size:9.5px;color:var(--dsw-alias-label-secondary,var(--dsw-alias-label-tertiary,#667085))}',
+      '.dshw_priceField .dshw_input,.dshw_priceField .dshw_select{box-sizing:border-box;width:100%;height:28px}',
+      '.dshw_priceRules{display:grid;gap:6px;padding:0 12px 11px}',
+      '.dshw_priceRule{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:10px;align-items:center;padding:7px 9px;border:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.15));border-radius:8px;background:var(--dsw-alias-bg-layer-2,var(--dsw-alias-bg-layer-1,rgba(127,127,127,.04)))}',
+      '.dshw_priceRule strong,.dshw_priceRule span{display:block;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}',
+      '.dshw_priceRule strong{font-size:11px}.dshw_priceRule span{font-size:9.5px;color:var(--dsw-alias-label-secondary,var(--dsw-alias-label-tertiary,#667085))}',
+      '@media(max-width:980px){.dshw_priceForm{grid-template-columns:repeat(2,minmax(0,1fr))}.dshw_priceForm>.dshw_btn{min-height:28px}}',
       '.dshw_switch{position:relative;flex:none;width:34px;height:20px;display:inline-flex;cursor:pointer}',
       '.dshw_switch>input{position:absolute;inset:0;opacity:0;margin:0;cursor:pointer}',
       '.dshw_track{position:absolute;inset:0;border-radius:999px;background:var(--dsw-alias-border-l3,rgba(127,127,127,.3));transition:background-color .15s}',
@@ -643,6 +653,11 @@ window.__ModuleLoader__.load({
       '.dshw_footRing{width:100%;box-sizing:border-box;display:flex;align-items:center;gap:8px;margin:2px 0 8px;padding:7px 9px;border:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.18));border-radius:11px;background:var(--dsw-alias-bg-layer-1,var(--dsw-alias-bg-base,rgba(127,127,127,.04)));color:var(--dsw-alias-label-primary,inherit);font-size:12.5px;cursor:grab;user-select:none;touch-action:none;transition:border-color .15s ease,background-color .15s ease}',
       'body[data-dsh-maid-atelier]:not([data-ds-dark-theme]) .dshw_footRing{--dsw-alias-label-primary:#f8f3e8;--dsw-alias-label-secondary:#d7def0;--dsw-alias-label-tertiary:#b5c1dd;--dsw-alias-border-l1:rgba(225,191,124,.62);--dsw-alias-border-l3:rgba(181,196,229,.34);--dsw-alias-interactive-bg-hover:rgba(41,61,111,.98);color:#f8f3e8;background:linear-gradient(145deg,rgba(34,55,106,.95),rgba(10,25,62,.97));border-color:rgba(225,191,124,.62);box-shadow:inset 0 0 0 2px rgba(5,15,45,.44),0 4px 11px rgba(1,7,24,.22)}',
       'body[data-dsh-maid-atelier][data-ds-dark-theme] .dshw_footRing{--dsw-alias-label-primary:#f8f3e8;--dsw-alias-label-secondary:#d7def0;--dsw-alias-label-tertiary:#b5c1dd;--dsw-alias-border-l1:rgba(211,180,119,.52);--dsw-alias-border-l3:rgba(181,196,229,.34);--dsw-alias-interactive-bg-hover:rgba(41,61,111,.96);color:#f8f3e8;background:rgba(18,32,70,.92);border-color:rgba(211,180,119,.52);box-shadow:inset 0 1px rgba(255,255,255,.07),0 4px 12px rgba(0,0,0,.24)}',
+      '.dshw_footRing[data-dshw-peak-background="transparent"]:not(.dshw_footRingFloating){background:transparent;box-shadow:none}',
+      '.dshw_footRing[data-dshw-peak-background="transparent"]:not(.dshw_footRingFloating):hover{background:var(--dsw-alias-bg-layer-1,var(--dsw-alias-bg-base,rgba(127,127,127,.04)));box-shadow:none}',
+      'body[data-dsh-maid-atelier] .dshw_footRing[data-dshw-peak-background="transparent"]:not(.dshw_footRingFloating){background:transparent;box-shadow:none}',
+      'body[data-dsh-maid-atelier]:not([data-ds-dark-theme]) .dshw_footRing[data-dshw-peak-background="transparent"]:not(.dshw_footRingFloating):hover{background:linear-gradient(145deg,rgba(34,55,106,.95),rgba(10,25,62,.97));box-shadow:inset 0 0 0 2px rgba(5,15,45,.44),0 4px 11px rgba(1,7,24,.22)}',
+      'body[data-dsh-maid-atelier][data-ds-dark-theme] .dshw_footRing[data-dshw-peak-background="transparent"]:not(.dshw_footRingFloating):hover{background:rgba(18,32,70,.92);box-shadow:inset 0 1px rgba(255,255,255,.07),0 4px 12px rgba(0,0,0,.24)}',
       '.dshw_footRing:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(127,127,127,.1));border-color:var(--dsw-alias-border-l2,rgba(127,127,127,.28))}',
       '.dshw_footRing.dshw_low{border-color:var(--dsw-alias-state-error-primary,#e5534b)}',
       '.dshw_footRingRail{width:42px;height:42px;min-height:42px;margin:3px 0 6px;padding:0;justify-content:center;border-radius:50%;background:transparent;border:none;cursor:pointer}',
@@ -902,6 +917,15 @@ window.__ModuleLoader__.load({
       }
     }
 
+    function customCostsText(costs) {
+      if (!costs || typeof costs !== 'object') return ''
+      return Object.keys(costs).sort().filter(function (currency) {
+        return Number.isFinite(costs[currency])
+      }).map(function (currency) {
+        return fmtCurrency(costs[currency], currency)
+      }).join(' + ')
+    }
+
     function selectBalanceInfo(balance) {
       if (!balance || !Array.isArray(balance.balances) || balance.balances.length === 0) return null
       var currency = typeof balance.currency === 'string' ? balance.currency.toUpperCase() : null
@@ -987,6 +1011,10 @@ window.__ModuleLoader__.load({
       return value === 'hidden' ? 'hidden' : 'standard'
     }
 
+    function normalizePeakBackground(value) {
+      return value === 'solid' ? 'solid' : 'transparent'
+    }
+
     function readBalanceOnly() {
       try {
         var saved = compatibility.storage.getItem(CHIP_BALANCE_ONLY_KEY)
@@ -1390,7 +1418,8 @@ window.__ModuleLoader__.load({
 
     function historyHeatValue(day, metric) {
       if (!day) return 0
-      if (metric === 'cost') return Number.isFinite(day.cost) ? day.cost : 0
+      if (metric === 'cost') return (Number.isFinite(day.cost) ? day.cost : 0)
+        + (day.customCosts && Number.isFinite(day.customCosts.CNY) ? day.customCosts.CNY : 0)
       return Number.isFinite(day.totalTokens) ? day.totalTokens : 0
     }
 
@@ -1542,8 +1571,8 @@ window.__ModuleLoader__.load({
               tabIndex: day.calls > 0 || isSelected || isToday ? 0 : -1,
               className: 'dshw_historyCell dshw_historyCell' + level + (isToday ? ' dshw_historyCellToday' : '') + (isSelected ? ' dshw_historyCellSelected' : ''),
               style: { gridColumn: String(Math.floor((index + firstWeekday) / 7) + 1), gridRow: String(weekday + 1) },
-              title: day.date + ' · ' + fmtTokens(day.totalTokens) + ' token · ' + (day.cost === null ? '未定价' : historyMoney(day.cost)) + ' · ' + day.calls + ' 次调用',
-              'aria-label': day.date + '，' + (metric === 'cost' ? (day.cost === null ? '未定价' : historyMoney(day.cost)) : fmtTokens(day.totalTokens) + ' token') + '，' + day.calls + ' 次调用',
+              title: day.date + ' · ' + fmtTokens(day.totalTokens) + ' token · 官方 ' + (day.cost === null ? '未定价' : historyMoney(day.cost)) + (customCostsText(day.customCosts) ? ' · 三方估 ' + customCostsText(day.customCosts) : '') + ' · ' + day.calls + ' 次调用',
+              'aria-label': day.date + '，' + (metric === 'cost' ? ((day.cost === null ? '官方未定价' : historyMoney(day.cost)) + (customCostsText(day.customCosts) ? '，第三方估算 ' + customCostsText(day.customCosts) : '')) : fmtTokens(day.totalTokens) + ' token') + '，' + day.calls + ' 次调用',
               'aria-selected': isSelected,
               'aria-current': isToday ? 'date' : undefined,
               onClick: function () { loadHistory(day.date) }
@@ -1560,7 +1589,7 @@ window.__ModuleLoader__.load({
             : breakdown.map(function (row) {
               return React.createElement('div', { key: row.provider + ':' + row.model, className: 'dshw_historyDetailRow' },
                 React.createElement('span', { className: 'dshw_historyDetailName', title: row.provider + ' · ' + row.model }, row.model),
-                React.createElement('span', null, fmtTokens(row.totalTokens) + ' · ' + row.calls + ' 次' + (row.cost === null ? '' : ' · ' + historyMoney(row.cost))))
+                React.createElement('span', null, fmtTokens(row.totalTokens) + ' · ' + row.calls + ' 次' + (row.cost === null ? '' : ' · ' + historyMoney(row.cost)) + (row.customCost ? ' · 估 ' + fmtCurrency(row.customCost.cost, row.customCost.currency) : '')))
             })
           body = React.createElement(React.Fragment, null,
             React.createElement('div', { className: 'dshw_historySummary' },
@@ -1568,6 +1597,7 @@ window.__ModuleLoader__.load({
               React.createElement('div', null, React.createElement('span', null, '今天'), React.createElement('strong', null, fmtTokens(today.totalTokens))),
               React.createElement('div', null, React.createElement('span', null, '本月'), React.createElement('strong', null, fmtTokens(month.totalTokens))),
               React.createElement('div', null, React.createElement('span', null, '缓存命中'), React.createElement('strong', null, history.summary.cacheHitRate === null || history.summary.cacheHitRate === undefined ? '--' : history.summary.cacheHitRate + '%'))),
+            customCostsText(total.customCosts) ? React.createElement('div', { className: 'dshw_historyLegend' }, '第三方按当前自定义价估算：' + customCostsText(total.customCosts)) : null,
             React.createElement('div', { className: 'dshw_historyMetricToggle', role: 'group', 'aria-label': '历史热力图指标' },
                React.createElement('button', { type: 'button', className: metric === 'tokens' ? 'dshw_historyMetricActive' : '', 'aria-pressed': metric === 'tokens', onClick: function () { setMetric('tokens') } }, 'Token'),
                React.createElement('button', { type: 'button', className: metric === 'cost' ? 'dshw_historyMetricActive' : '', 'aria-pressed': metric === 'cost', onClick: function () { setMetric('cost') } }, '费用')),
@@ -1859,6 +1889,12 @@ window.__ModuleLoader__.load({
       var [nameDraft, setNameDraft] = React.useState('')
       var [keyDraft, setKeyDraft] = React.useState('')
       var [switchingId, setSwitchingId] = React.useState(null)
+      var [priceRules, setPriceRules] = React.useState([])
+      var [knownPriceRoutes, setKnownPriceRoutes] = React.useState([])
+      var [priceNotice, setPriceNotice] = React.useState(null)
+      var [priceDraft, setPriceDraft] = React.useState({
+        provider: '', model: '', currency: 'CNY', input: '', cacheRead: '', cacheWrite: '', output: ''
+      })
       var [visibility, setVisibility] = React.useState(function () {
         try {
           var saved = compatibility.storage.getItem(DATA_VISIBILITY_KEY)
@@ -1896,6 +1932,9 @@ window.__ModuleLoader__.load({
       var [peakOrient, setPeakOrient] = React.useState(function () {
         try { return compatibility.storage.getItem(PEAK_ORIENT_KEY) || 'horizontal' } catch (e) { return 'horizontal' }
       })
+      var [peakBackground, setPeakBackground] = React.useState(function () {
+        try { return normalizePeakBackground(compatibility.storage.getItem(PEAK_BACKGROUND_KEY)) } catch (e) { return 'transparent' }
+      })
       var [peakRecharge, setPeakRecharge] = React.useState(function () {
         try { return compatibility.storage.getItem(PEAK_RECHARGE_KEY) !== 'false' } catch (e) { return true }
       })
@@ -1929,6 +1968,7 @@ window.__ModuleLoader__.load({
           try { setRingEnabled(compatibility.storage.getItem(PEAK_RING_KEY) !== 'false') } catch (e) { /* ignore */ }
           try { setPeakNotifyEnabled(compatibility.storage.getItem(PEAK_NOTIFY_KEY) === 'true') } catch (e) { /* ignore */ }
           try { setPeakOrient(compatibility.storage.getItem(PEAK_ORIENT_KEY) || 'horizontal') } catch (e) { /* ignore */ }
+          try { setPeakBackground(normalizePeakBackground(compatibility.storage.getItem(PEAK_BACKGROUND_KEY))) } catch (e) { /* ignore */ }
           try { setPeakRecharge(compatibility.storage.getItem(PEAK_RECHARGE_KEY) !== 'false') } catch (e) { /* ignore */ }
           try {
             var savedPeakScale = Number.parseFloat(compatibility.storage.getItem(PEAK_SCALE_KEY))
@@ -1960,6 +2000,9 @@ window.__ModuleLoader__.load({
           fetch('/api/wallet/snapshot').then(function (resp) { return resp.json() }).then(function (json) {
             if (!stopped && json && json.ok) {
               setSnapshot(json)
+              var providerState = json.providers || {}
+              setPriceRules(Array.isArray(providerState.customPrices) ? providerState.customPrices : [])
+              setKnownPriceRoutes(Array.isArray(providerState.knownRoutes) ? providerState.knownRoutes : [])
               setThresholdDraft(json.threshold !== undefined && json.threshold !== null ? json.threshold.toFixed(2) : '')
             }
           }).catch(function () { /* ignore */ })
@@ -2095,6 +2138,14 @@ window.__ModuleLoader__.load({
         compatibility.dispatch(PEAK_RING_EVENT)
       }
 
+      function persistPeakBackground(next) {
+        next = normalizePeakBackground(next)
+        setPeakBackground(next)
+        try { compatibility.storage.setItem(PEAK_BACKGROUND_KEY, next) } catch (e) { /* ignore */ }
+        compatibility.dispatch(SETTINGS_EVENT)
+        compatibility.dispatch(PEAK_RING_EVENT)
+      }
+
       function persistPeakRecharge(next) {
         setPeakRecharge(next)
         try { compatibility.storage.setItem(PEAK_RECHARGE_KEY, String(next)) } catch (e) { /* ignore */ }
@@ -2138,6 +2189,85 @@ window.__ModuleLoader__.load({
         }).catch(function () { setThresholdNotice('\u4fdd\u5b58\u5931\u8d25') })
       }
 
+      function applyCustomPriceResponse(json) {
+        if (!json || json.ok !== true) return false
+        setPriceRules(Array.isArray(json.rules) ? json.rules : [])
+        setKnownPriceRoutes(Array.isArray(json.knownRoutes) ? json.knownRoutes : [])
+        return true
+      }
+
+      function saveCustomPrice() {
+        if (usageLocked) { setPriceNotice('用量账本已锁定，无法保存'); return }
+        var numeric = ['input', 'cacheRead', 'cacheWrite', 'output'].reduce(function (out, key) {
+          var value = Number.parseFloat(priceDraft[key])
+          out[key] = Number.isFinite(value) && value >= 0 ? value : null
+          return out
+        }, {})
+        if (!priceDraft.provider.trim() || !priceDraft.model.trim() || Object.values(numeric).some(function (value) { return value === null })) {
+          setPriceNotice('请填写 Provider、模型及四项非负价格')
+          return
+        }
+        setPriceNotice('正在保存…')
+        fetch('/api/wallet/custom-prices', {
+          method: 'POST',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ rule: {
+            provider: priceDraft.provider.trim(),
+            model: priceDraft.model.trim(),
+            currency: priceDraft.currency,
+            input: numeric.input,
+            cacheRead: numeric.cacheRead,
+            cacheWrite: numeric.cacheWrite,
+            output: numeric.output
+          } })
+        }).then(function (resp) { return resp.json().then(function (json) { return { ok: resp.ok, json: json } }) }).then(function (result) {
+          if (!result.ok || !applyCustomPriceResponse(result.json)) throw new Error(result.json && result.json.error ? result.json.error : 'save-failed')
+          setPriceNotice('已保存；本会话与历史账本按当前自定义价重新估算')
+        }).catch(function (error) {
+          setPriceNotice(error && error.message === 'official-provider-not-allowed' ? '官方计费 Provider 不能设置第三方价格' : '保存失败，请检查填写内容')
+        })
+      }
+
+      function removeCustomPrice(rule) {
+        if (usageLocked) return
+        setPriceNotice('正在删除…')
+        fetch('/api/wallet/custom-prices', {
+          method: 'DELETE',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ provider: rule.provider, model: rule.model })
+        }).then(function (resp) { return resp.json().then(function (json) { return { ok: resp.ok, json: json } }) }).then(function (result) {
+          if (!result.ok || !applyCustomPriceResponse(result.json)) throw new Error('delete-failed')
+          setPriceNotice('已删除价格规则')
+        }).catch(function () { setPriceNotice('删除失败') })
+      }
+
+      function editCustomPrice(rule) {
+        setPriceDraft({
+          provider: rule.provider,
+          model: rule.model,
+          currency: rule.currency,
+          input: String(rule.input),
+          cacheRead: String(rule.cacheRead),
+          cacheWrite: String(rule.cacheWrite),
+          output: String(rule.output)
+        })
+        setPriceNotice('已载入，可修改后保存')
+      }
+
+      function useCurrentRouteForPrice() {
+        if (!settingsModelSelection || typeof settingsModelSelection.provider !== 'string' || typeof settingsModelSelection.model !== 'string') {
+          setPriceNotice('当前会话尚未选择可识别的模型')
+          return
+        }
+        setPriceDraft(function (current) {
+          return Object.assign({}, current, {
+            provider: settingsModelSelection.provider,
+            model: settingsModelSelection.model
+          })
+        })
+        setPriceNotice('已填入当前会话的 Provider 与模型')
+      }
+
       function reloadAccounts() {
         fetch('/api/wallet/accounts').then(function (resp) { return resp.json() }).then(function (json) {
           if (json && json.ok) {
@@ -2488,6 +2618,18 @@ window.__ModuleLoader__.load({
             },
               React.createElement('option', { value: 'horizontal' }, '横向排列'),
               React.createElement('option', { value: 'vertical' }, '纵向排列'))),
+          React.createElement('div', { className: 'dshw_settingChoice' },
+            React.createElement('span', { className: 'dshw_settingChoiceCopy' },
+              React.createElement('strong', null, '时钟背景'),
+              React.createElement('span', null, peakBackground === 'solid' ? '侧边栏常态保持实色' : '侧边栏透明，悬停实色；悬浮保持实色')),
+            React.createElement('select', {
+              className: 'dshw_select',
+              'aria-label': '峰谷时钟背景',
+              value: peakBackground,
+              onChange: function (event) { persistPeakBackground(event.target.value) }
+            },
+              React.createElement('option', { value: 'transparent' }, '透明（悬停实色）'),
+              React.createElement('option', { value: 'solid' }, '实色'))),
           React.createElement('div', { className: 'dshw_settingChoice' },
             React.createElement('span', { className: 'dshw_settingChoiceCopy' },
               React.createElement('strong', null, '时钟大小'),
@@ -2563,6 +2705,65 @@ window.__ModuleLoader__.load({
         rows.push(React.createElement('div', { key: 'pr-card', className: 'dshw_setCard', style: { display: 'block' } }, providerRows))
       }
 
+      // —— 第三方 API 自定义价格（Issue #36） ——
+      rows.push(React.createElement('div', { key: 'cp-head', className: 'dshw_accountHeader', style: { marginTop: '8px' } },
+        React.createElement('span', null,
+          React.createElement('span', { className: 'dshw_title' }, '第三方 API 自定义价格'),
+          React.createElement('span', { className: 'dshw_muted', style: { display: 'block', marginTop: '2px', fontSize: '10px' } }, '每 100 万 Token；仅作本机估算，不代表第三方账单')),
+        React.createElement('button', {
+          type: 'button', className: 'dshw_btn',
+          disabled: settingsProviderMode.kind !== 'third',
+          title: settingsProviderMode.kind === 'third' ? '填入当前会话选择的 Provider 与模型' : '请先切换到第三方模型',
+          onClick: useCurrentRouteForPrice
+        }, '使用当前模型')))
+      var providerOptions = Array.from(new Set(knownPriceRoutes.map(function (route) { return route && route.provider }).filter(Boolean)))
+      var modelOptions = Array.from(new Set(knownPriceRoutes.filter(function (route) {
+        return route && (!priceDraft.provider || route.provider === priceDraft.provider)
+      }).map(function (route) { return route.model }).filter(Boolean)))
+      function updatePriceDraft(key, value) {
+        setPriceDraft(function (current) { var next = Object.assign({}, current); next[key] = key === 'currency' ? String(value).toUpperCase().slice(0, 3) : value; return next })
+      }
+      function priceField(key, label, type, options) {
+        return React.createElement('label', { key: key, className: 'dshw_priceField' },
+          React.createElement('span', null, label),
+          type === 'select'
+            ? React.createElement('select', { className: 'dshw_select', value: priceDraft[key], 'aria-label': label, onChange: function (event) { updatePriceDraft(key, event.target.value) } },
+                options.map(function (option) { return React.createElement('option', { key: option, value: option }, option) }))
+            : React.createElement('input', {
+                className: 'dshw_input', type: type, min: type === 'number' ? '0' : undefined,
+                max: type === 'number' ? '1000000' : undefined, step: type === 'number' ? '0.000001' : undefined,
+                list: key === 'provider' ? 'dshw-price-providers' : key === 'model' ? 'dshw-price-models' : undefined,
+                value: priceDraft[key], 'aria-label': label,
+                onChange: function (event) { updatePriceDraft(key, event.target.value) }
+              }))
+      }
+      var priceForm = React.createElement('div', { className: 'dshw_priceForm' },
+        priceField('provider', 'Provider ID', 'text'),
+        priceField('model', '模型 ID', 'text'),
+        priceField('currency', '币种', 'text'),
+        priceField('input', '输入', 'number'),
+        priceField('cacheRead', '缓存读', 'number'),
+        priceField('cacheWrite', '缓存写', 'number'),
+        priceField('output', '输出', 'number'),
+        React.createElement('button', { type: 'button', className: 'dshw_btn dshw_btnPrimary', disabled: usageLocked, onClick: saveCustomPrice }, '保存'),
+        React.createElement('datalist', { id: 'dshw-price-providers' }, providerOptions.map(function (provider) { return React.createElement('option', { key: provider, value: provider }) })),
+        React.createElement('datalist', { id: 'dshw-price-models' }, modelOptions.map(function (model) { return React.createElement('option', { key: model, value: model }) })))
+      var priceRuleRows = priceRules.map(function (rule) {
+        return React.createElement('div', { key: rule.provider + ':' + rule.model, className: 'dshw_priceRule' },
+          React.createElement('span', null,
+            React.createElement('strong', { title: rule.provider + ' · ' + rule.model }, rule.provider + ' · ' + rule.model),
+            React.createElement('span', null, rule.currency + '/1M · 入 ' + rule.input + ' · 缓读 ' + rule.cacheRead + ' · 缓写 ' + rule.cacheWrite + ' · 出 ' + rule.output)),
+          React.createElement('span', { className: 'dshw_settingsInline' },
+            React.createElement('button', { type: 'button', className: 'dshw_btn', onClick: function () { editCustomPrice(rule) } }, '编辑'),
+            React.createElement('button', { type: 'button', className: 'dshw_btn', disabled: usageLocked, onClick: function () { removeCustomPrice(rule) } }, '删除')))
+      })
+      rows.push(React.createElement('div', { key: 'cp-card', className: 'dshw_setCard wide', style: { display: 'block' } },
+        priceForm,
+        priceNotice ? React.createElement('div', { className: 'dshw_muted', role: 'status', style: { padding: '0 12px 8px' } }, priceNotice) : null,
+        priceRuleRows.length > 0
+          ? React.createElement('div', { className: 'dshw_priceRules' }, priceRuleRows)
+          : React.createElement('div', { className: 'dshw_muted', style: { padding: '0 12px 11px' } }, '暂无规则；填写后即可看到第三方费用估算')))
+
       rows.push(React.createElement(PlanUsagePanel, { key: 'plans', compact: false }))
       rows.push(React.createElement(UsageHistoryPanel, { key: 'history', sessionId: null, alwaysOpen: true }))
 
@@ -2833,6 +3034,9 @@ window.__ModuleLoader__.load({
       var [orient, setOrient] = React.useState(function () {
         try { return compatibility.storage.getItem(PEAK_ORIENT_KEY) || 'horizontal' } catch (e) { return 'horizontal' }
       })
+      var [peakBackground, setPeakBackground] = React.useState(function () {
+        try { return normalizePeakBackground(compatibility.storage.getItem(PEAK_BACKGROUND_KEY)) } catch (e) { return 'transparent' }
+      })
       var [showRecharge, setShowRecharge] = React.useState(function () {
         try { return compatibility.storage.getItem(PEAK_RECHARGE_KEY) !== 'false' } catch (e) { return true }
       })
@@ -2893,6 +3097,7 @@ window.__ModuleLoader__.load({
           try {
             setShown(compatibility.storage.getItem(PEAK_RING_KEY) !== 'false')
             setOrient(compatibility.storage.getItem(PEAK_ORIENT_KEY) || 'horizontal')
+            setPeakBackground(normalizePeakBackground(compatibility.storage.getItem(PEAK_BACKGROUND_KEY)))
             setShowRecharge(compatibility.storage.getItem(PEAK_RECHARGE_KEY) !== 'false')
             var val = Number.parseFloat(compatibility.storage.getItem(PEAK_SCALE_KEY))
             setPeakScale(Number.isFinite(val) ? Math.min(1.2, Math.max(1.0, val)) : 1.0)
@@ -3132,6 +3337,12 @@ window.__ModuleLoader__.load({
         try { compatibility.storage.setItem(PEAK_ORIENT_KEY, val) } catch (e) { /* ignore */ }
         announcePrefs()
       }
+      function updateBackground(val) {
+        val = normalizePeakBackground(val)
+        setPeakBackground(val)
+        try { compatibility.storage.setItem(PEAK_BACKGROUND_KEY, val) } catch (e) { /* ignore */ }
+        announcePrefs()
+      }
       function updateScale(val) {
         val = Math.min(1.2, Math.max(1.0, Math.round(val * 20) / 20))
         setPeakScale(val)
@@ -3284,6 +3495,7 @@ window.__ModuleLoader__.load({
       var cardElement = React.createElement('div', {
         ref: cardNodeRef,
         className: containerClasses.join(' '),
+        'data-dshw-peak-background': peakBackground,
         style: Object.keys(cardStyle).length > 0 ? cardStyle : undefined,
         title: state.tip + ' · 余额 ' + balText + ' · ' + costLabel + ' ' + costText + (isRail ? ' · 点击前往官方充值' : ' · 点击展开专属控制面板 / 按住拖拽'),
         'aria-label': state.ariaText + '，余额 ' + balText + '，' + costLabel + ' ' + costText,
@@ -3406,6 +3618,17 @@ window.__ModuleLoader__.load({
           },
             React.createElement('option', { value: 'horizontal' }, '横向排列'),
             React.createElement('option', { value: 'vertical' }, '纵向排列'))),
+        React.createElement('div', { className: 'dshw_peakRow' },
+          React.createElement('span', { className: 'dshw_muted' }, '时钟背景'),
+          React.createElement('select', {
+            className: 'dshw_select',
+            style: { height: '24px', fontSize: '11px' },
+            'aria-label': '控制面板时钟背景',
+            value: peakBackground,
+            onChange: function (e) { updateBackground(e.target.value) }
+          },
+            React.createElement('option', { value: 'transparent' }, '透明（悬停实色）'),
+            React.createElement('option', { value: 'solid' }, '实色'))),
         React.createElement('div', { className: 'dshw_peakRow' },
           React.createElement('span', { className: 'dshw_muted' }, '时钟大小 (' + Math.round(peakScale * 100) + '%)'),
           React.createElement('span', { className: 'dshw_scaleControl' },
@@ -4485,6 +4708,13 @@ window.__ModuleLoader__.load({
       var third = session.third || {}
       var officialTokens = official.tokens ? totalTokens(official.tokens) : 0
       var thirdTokens = third.tokens ? totalTokens(third.tokens) : 0
+      var thirdCustomText = customCostsText(third.customCosts)
+      var activeThirdRoute = activeProviderMode.kind === 'third' && Array.isArray(third.routes)
+        ? third.routes.find(function (route) { return route.provider === activeProviderMode.provider && route.model === activeProviderMode.model })
+        : null
+      var activeThirdCostText = activeThirdRoute && activeThirdRoute.customCost
+        ? fmtCurrency(activeThirdRoute.customCost.cost, activeThirdRoute.customCost.currency)
+        : ''
       var activePlanSource = activeProviderMode.kind === 'zai'
         ? planSourceForProvider(snapshot, activeProviderMode.provider)
         : null
@@ -4533,10 +4763,10 @@ window.__ModuleLoader__.load({
             React.createElement('span', { className: 'dshw_homePrimaryLabel' }, '5h 剩 '),
             React.createElement('span', { className: 'dshw_homePrimaryValue' }, planTokenRemaining)))
         } else if (activeProviderMode.kind === 'third') {
-          if (chipVertical) chipTextParts.push(verticalMetric('third', '本场', fmtTokens(thirdTokens)))
+          if (chipVertical) chipTextParts.push(verticalMetric('third', activeThirdCostText ? '本估' : '本场', activeThirdCostText || fmtTokens(thirdTokens)))
           else chipTextParts.push(React.createElement('span', { key: 'third', className: 'dshw_homePrimary' },
-            React.createElement('span', { className: 'dshw_homePrimaryLabel' }, '本场 '),
-            React.createElement('span', { className: 'dshw_homePrimaryValue' }, fmtTokens(thirdTokens))))
+            React.createElement('span', { className: 'dshw_homePrimaryLabel' }, activeThirdCostText ? '本估 ' : '本场 '),
+            React.createElement('span', { className: 'dshw_homePrimaryValue' }, activeThirdCostText || fmtTokens(thirdTokens))))
         } else {
           if (chipVertical) chipTextParts.push(verticalMetric('bal', '余额', balanceText))
           else chipTextParts.push(React.createElement('span', { key: 'bal', className: 'dshw_balanceText dshw_homePrimary' },
@@ -4561,10 +4791,12 @@ window.__ModuleLoader__.load({
         if (chipVertical) {
           chipTextParts.push(verticalMetric('provider', '模型', thirdProviderName))
           chipTextParts.push(verticalMetric('third', '本场', fmtTokens(thirdTokens)))
+          if (activeThirdCostText) chipTextParts.push(verticalMetric('third-cost', '估算', activeThirdCostText))
         } else {
           chipTextParts.push(React.createElement('span', { key: 'provider', className: 'dshw_homePrimary' },
             React.createElement('span', { className: 'dshw_homePrimaryValue' }, thirdProviderName)))
           chipTextParts.push(React.createElement('span', { key: 'third' }, '本场 ' + fmtTokens(thirdTokens)))
+          if (activeThirdCostText) chipTextParts.push(React.createElement('span', { key: 'third-cost' }, '估 ' + activeThirdCostText))
         }
       } else if (chipVertical) {
         if (showDeepSeek) {
@@ -4682,6 +4914,11 @@ window.__ModuleLoader__.load({
       thirdRows.push(React.createElement('div', { key: 't-t', className: 'dshw_row' },
         React.createElement('span', { className: 'dshw_muted' }, '\u7b2c\u4e09\u65b9 token'),
         React.createElement('span', null, '\u8f93\u5165 ' + fmtTokens(third.tokens && third.tokens.input) + ' \u00b7 \u7f13\u5b58\u8bfb ' + fmtTokens(third.tokens && third.tokens.cacheRead) + ' \u00b7 \u8f93\u51fa ' + fmtTokens(third.tokens && third.tokens.output))))
+      if (thirdCustomText) {
+        thirdRows.push(React.createElement('div', { key: 't-c', className: 'dshw_row' },
+          React.createElement('span', { className: 'dshw_muted' }, '自定义估算'),
+          React.createElement('span', { title: '按当前自定义价格计算，不代表第三方账单' }, thirdCustomText)))
+      }
 
       var thresholdInput = React.createElement('input', {
         className: 'dshw_input',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "deepseek-harness-wallet",
-  "description": "Local-first DeepSeek Harness control center for balance monitoring, usage accounting, a 365-day local token ledger, Z.ai Coding Plan quota monitoring, official pricing sync, peak/off-peak status, encrypted multi-account switching, health checks, completion reminders, recharge, and host-gated session controls.",
-  "version": "0.3.5",
+  "description": "Local-first DeepSeek Harness control center for balance monitoring, usage accounting, custom third-party API pricing, a 365-day local token ledger, Z.ai Coding Plan quotas, official pricing sync, encrypted multi-account switching, reminders, recharge, and host-gated session controls.",
+  "version": "0.3.8",
   "type": "module",
   "main": "index.js",
   "exports": {
@@ -56,7 +56,6 @@
     "client": {
       "platform": "web",
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-ui-slots",
         "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-model-selection"