deepseek-harness-wallet 0.1.4 → 0.1.5

package/CHANGELOG.md

@@ -1,6 +1,13 @@
 # Changelog
 
-All notable changes to this project are documented here.
+All notable changes to this project are documented in this file.
+
+## 0.1.5 - 2026-08-18
+
+- 修复输入框内的余额标签被固定压缩成 44px 极简显示的问题，现在按实际可用空间在完整 / 紧凑 / 极简三档间自动切换。 / Fixed the composer chip always collapsing to its 44px compact value; it now switches between full, fit, and compact layouts by measured space.
+- 修复缩放比例不等于 100% 时被误判为空间不足的问题。 / Fixed compact mode being mis-triggered whenever the scale was not 100%.
+- 修复芯片拖到输入框旁悬浮时被其他面板遮挡的问题。 / Fixed docked chips being covered by neighbouring host panels.
+- 输入框内缩放上限调整为 120%，悬浮 / 侧边停靠时仍可到 125%。 / The scale slider is capped at 120% in the composer row; floating and side docks keep the full 75–125% range.
 
 ## 0.1.4 - 2026-08-17
 

package/README.md

@@ -1,26 +1,18 @@
 # DeepSeek Harness Control Center
 
-### DeepSeek Harness monitoring, alerts, recharge, and session control center · DeepSeek Harness 监控、提醒、充值与会话控制中心
+[![npm version](https://img.shields.io/npm/v/deepseek-harness-wallet?label=npm&color=5965d8)](https://www.npmjs.com/package/deepseek-harness-wallet)
+[![GitHub release](https://img.shields.io/github/v/release/feibi-mochi/deepseek-harness-control-center?label=release&color=5965d8)](https://github.com/feibi-mochi/deepseek-harness-control-center/releases)
+[![CI](https://github.com/feibi-mochi/deepseek-harness-control-center/actions/workflows/validate.yml/badge.svg)](https://github.com/feibi-mochi/deepseek-harness-control-center/actions/workflows/validate.yml)
+[![DeepSeek Harness](https://img.shields.io/badge/DeepSeek%20Harness-0.1.0--rc.6-4aa3ff)](https://github.com/deepseek-ai/DeepSeek-Harness)
+[![License: MIT](https://img.shields.io/badge/license-MIT-3b7a57)](./LICENSE)
 
-[English](./README.md) · [简体中文](https://github.com/feibi-mochi/deepseek-harness-control-center/blob/main/docs/i18n/README.zh-CN.md)
+**DeepSeek Harness monitoring, alerts, recharge, and session control center.**
 
-**Version:** 0.1.4 · **DeepSeek Harness:** 0.1.0-rc.6 · **License:** MIT
+`Balance ¥5.89 · Session ¥0.72 · Official 18.8M | Third-party 800K · ↗ Recharge`
 
-**A local-first monitoring and control companion for DeepSeek Harness Web.**
+[English](./README.md) · [简体中文](https://github.com/feibi-mochi/deepseek-harness-control-center/blob/main/docs/i18n/README.zh-CN.md) · [Install](#install) · [Compatibility](#browser-desktop-and-os-compatibility) · [Changelog](./CHANGELOG.md)
 
-DeepSeek Harness can keep several conversations and model providers active at once, but the information needed to manage them is normally scattered: the official account balance is on one page, token usage is buried in stream events, a long-running conversation may finish in a background tab, and session cleanup is separate again. DeepSeek Harness Control Center brings those signals and controls into one small surface beside the composer while retaining `deepseek-harness-wallet` as its installation and compatibility identifier. It is designed to answer three everyday questions without interrupting the conversation: **How much official balance remains? What has this conversation used? Does anything need my attention?**
-
-The resident chip combines the live DeepSeek balance, the open conversation's estimated official spend, official token usage, third-party token totals, and the official recharge shortcut. Accounting is isolated twice—by conversation and by provider—so one conversation cannot borrow another conversation's counters, and third-party traffic cannot become DeepSeek spend. Official cost is accumulated when each usage event arrives using the price active at that moment; later peak/off-peak changes therefore do not rewrite historical estimates. The detail panel expands this summary into per-currency balance rows, token splits, session spend, refresh controls, and a configurable CNY low-balance threshold.
-
-Monitoring is paired with deliberate actions. A low balance changes the wallet's visual state and emits one alert until the balance recovers. The recharge shortcut always targets DeepSeek's fixed official top-up URL, and the first use shows the destination before leaving Harness. Completion reminders cover a different kind of waiting: they can remain until manually dismissed or close after a selected delay, combine simultaneous completions into a queue, coordinate across tabs, and open the relevant conversation when clicked. If a system notification cannot be shown, the same event falls back to an in-page notice instead of disappearing silently.
-
-The interface is meant to live with the user's workspace rather than occupy it. The chip may remain in the composer, move freely, preview and snap to supported page edges or regions, switch between compact horizontal and vertical arrangements, scale from the control panel, or minimize directly to a movable dot. If the composer becomes too narrow for the full home chip, it keeps a clickable balance/token value instead of overflowing underneath the model selector. Official and third-party data can be shown independently while preventing an empty all-hidden state. The details panel itself is draggable and remembers its last position, and saved positions are fitted back into the viewport when the window changes.
-
-Session controls keep two very different operations separate. **Clear current-session wallet data** removes only this plugin's balance-derived spend and token counters for the open conversation; it does not delete the conversation. **Permanent session deletion** is an optional host integration, not a deletion engine supplied by this npm package. It appears only when the current DSH host advertises a real deletion path, remains opt-in, and still requires confirmation; unsupported hosts keep the setting disabled. This boundary prevents a decorative switch from promising an operation the surrounding application cannot perform.
-
-The trust model is intentionally narrow. The plugin registers no model tools, injects no prompt text, and adds no model-token overhead. Its host-side accounting is kept in the local DSH storage, while layout and reminder preferences use browser-compatible local storage. The existing DSH credential is used only for the official balance request, and recharge navigation is fixed to the official DeepSeek domain. The plugin does not collect payment details, estimate third-party money values without a price source, or merge balances across currencies.
-
-Compatibility is based on capabilities rather than operating-system names. A normal DSH Web environment uses standards-based browser behavior; restricted Electron, Tauri, or other desktop shells can provide a small adapter for notifications, storage, and external links without changing accounting or UI logic. Optional features degrade visibly when a capability is absent. This keeps the project useful as a broader Harness monitoring and session-control center while leaving room for future provider adapters, history views, and other management features without changing the established npm package identity.
+> 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.
 
 > If DeepSeek Harness Control Center helps you, please consider leaving a ⭐ Star. Thank you!
 
@@ -41,6 +33,24 @@ Compatibility is based on capabilities rather than operating-system names. A nor
 - **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.
 
+## Project overview
+
+### One place for the signals that matter
+
+DeepSeek Harness can keep several conversations and model providers active at once, but balance, usage, background-task status, and session actions normally live in different places. Control Center brings the information worth checking repeatedly beside the composer, so the current workflow can answer three questions at a glance: **How much official balance remains? What has this conversation used? Does anything need attention?**
+
+### Present when needed, quiet when not
+
+The project is designed around quick reading and in-context action rather than another full-page dashboard. Its compact surface expands only when needed, adapts to the available space, and leaves layout and reminder behavior under the user's control. Accounting remains separated by conversation and provider, while wallet-data cleanup and permanent session deletion remain intentionally different operations.
+
+### Extensible without hiding the boundaries
+
+The npm package handles monitoring and interface behavior; optional host powers are enabled only when DSH actually provides them. That capability-based boundary keeps unsupported actions visibly unavailable and gives browsers or desktop wrappers a small, reviewable adaptation surface. Future providers and controls can therefore be added without changing the established `deepseek-harness-wallet` package identity or silently expanding what the plugin is trusted to do.
+
+> **Want permanent session deletion?** It cannot be enabled by configuring the plugin alone. Give the [integration guide](./integrations/dsh-session-delete/README.md) and [Agent adaptation prompt](./integrations/dsh-session-delete/AGENT_PROMPT.md) to an Agent with access to the buildable DSH source. The control-panel switch becomes available only after the host implementation is built, tested, and advertises the capability.
+
+Details: [compatibility](#browser-desktop-and-os-compatibility) · [data and trust](#data--trust) · [pricing](#pricing-timeline)
+
 ## Install
 
 From npm:

package/lib/client.js

@@ -250,7 +250,8 @@ window.__ModuleLoader__.load({
 
     var css = [
       '.dshw_anchor{display:inline-flex;align-items:center;min-height:22px;min-width:0;vertical-align:middle}',
-      '.dshw_anchorHome{container-name:dshw-home;container-type:inline-size;overflow:hidden;min-width:44px}',
+      '.dshw_anchorHome{overflow:hidden;min-width:44px}',
+      '.dshw_chipLift{z-index:80!important}',
       '.dshw_anchorHome>.dshw_chip{box-sizing:border-box;max-width:100%;min-width:0;overflow:hidden}',
       '.dshw_chip{border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.15));background:transparent;height:22px;color:var(--dsw-alias-label-primary,#1f2328);white-space:nowrap;border-radius:999px;align-items:stretch;font-size:12px;line-height:1;display:inline-flex;position:relative;touch-action:none;user-select:none;cursor:grab}',
       '.dshw_chip:hover,.dshw_chip:focus-within{border-color:var(--dsw-alias-brand-primary,#4aa3ff)}',
@@ -307,8 +308,13 @@ window.__ModuleLoader__.load({
       '.dshw_notice{box-sizing:border-box;width:100%;display:flex;align-items:flex-start;gap:8px;padding:10px 10px 10px 12px;border:1px solid var(--dsw-alias-border-l2,rgba(0,0,0,.15));border-radius:9px;background:var(--dsw-alias-bg-overlay,#fff);color:var(--dsw-alias-label-primary,#1f2328);box-shadow:0 6px 20px rgba(0,0,0,.2);font-size:12px;line-height:1.45;pointer-events:auto;cursor:pointer}',
       '.dshw_noticeCopy{min-width:0;display:flex;flex:1;flex-direction:column;gap:2px}.dshw_noticeCopy span{white-space:pre-line;overflow-wrap:anywhere}',
       '.dshw_noticeClose{flex:none;width:24px;height:24px;border:0;border-radius:5px;background:transparent;color:inherit;font-size:18px;line-height:1;cursor:pointer}.dshw_noticeClose:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(0,0,0,.06))}',
-      '@container dshw-home (max-width:90px){.dshw_anchorHome .dshw_chip{width:100%}.dshw_anchorHome .dshw_chipMain{box-sizing:border-box;width:100%;min-width:0;overflow:hidden;justify-content:center;padding:0 3px}.dshw_anchorHome .dshw_chipMain>span{display:none}.dshw_anchorHome .dshw_chipMain>.dshw_homePrimary{display:inline;min-width:0;overflow:hidden;text-overflow:ellipsis}.dshw_anchorHome .dshw_homePrimaryLabel{display:none}.dshw_anchorHome .dshw_recharge{display:none}}',
-      '@supports not (container-type:inline-size){@media (max-width:640px){.dshw_anchorHome .dshw_chip{width:100%}.dshw_anchorHome .dshw_chipMain{box-sizing:border-box;width:100%;min-width:0;overflow:hidden;justify-content:center;padding:0 3px}.dshw_anchorHome .dshw_chipMain>span{display:none}.dshw_anchorHome .dshw_chipMain>.dshw_homePrimary{display:inline;min-width:0;overflow:hidden;text-overflow:ellipsis}.dshw_anchorHome .dshw_homePrimaryLabel{display:none}.dshw_anchorHome .dshw_recharge{display:none}}}',
+      // Home-fit and compact modes are toggled by measured space (see the
+      // home-space effect in WalletChip), not by container queries:
+      // container-type:inline-size on a content-sized flex item detaches its
+      // width from the chip, so flex layouts resolve it to min-width (44px)
+      // even when the row has room.
+      '.dshw_anchorHome.dshw_fit .dshw_chipMain>span:not(.dshw_homePrimary){display:none}',
+      '.dshw_anchorHome.dshw_compact .dshw_chip{width:100%}.dshw_anchorHome.dshw_compact .dshw_chipMain{box-sizing:border-box;width:100%;min-width:0;overflow:hidden;justify-content:center;padding:0 3px}.dshw_anchorHome.dshw_compact .dshw_chipMain>span{display:none}.dshw_anchorHome.dshw_compact .dshw_chipMain>.dshw_homePrimary{display:inline;min-width:0;overflow:hidden;text-overflow:ellipsis}.dshw_anchorHome.dshw_compact .dshw_homePrimaryLabel{display:none}.dshw_anchorHome.dshw_compact .dshw_recharge{display:none}',
       '@media (max-width:420px){.dshw_chipDocked:not(.dshw_chipVertical){max-width:calc(100vw - 4px);font-size:10px}.dshw_chipDocked:not(.dshw_chipVertical) .dshw_chipMain{gap:3px;padding:0 4px}.dshw_chipDocked:not(.dshw_chipVertical) .dshw_recharge{padding:0 4px}}'
     ].join('')
 
@@ -687,6 +693,18 @@ window.__ModuleLoader__.load({
       return node || null
     }
 
+    function isStackingContext(style) {
+      if (!style) return false
+      if (style.position === 'fixed' || style.position === 'sticky') return true
+      if (style.zIndex !== 'auto' && style.position !== 'static') return true
+      if (style.transform !== 'none' || style.filter !== 'none' || style.perspective !== 'none') return true
+      if (style.willChange === 'transform' || style.willChange === 'filter' || style.willChange === 'opacity' || style.willChange === 'z-index') return true
+      if (style.contain && style.contain !== 'none') return true
+      if (style.isolation === 'isolate') return true
+      if (style.opacity !== '1') return true
+      return false
+    }
+
     function findComposerRect(node, viewportWidth, viewportHeight) {
       var composer = findComposerNode(node, viewportWidth, viewportHeight)
       return composer && typeof composer.getBoundingClientRect === 'function' ? composer.getBoundingClientRect() : null
@@ -799,6 +817,8 @@ window.__ModuleLoader__.load({
       var [chipScale, setChipScale] = React.useState(function () {
         try { return normalizeChipScale(compatibility.storage.getItem(CHIP_SCALE_KEY)) } catch (e) { return 1 }
       })
+      var [homeMode, setHomeMode] = React.useState('full')
+      var chipLiftHostRef = React.useRef(null)
       var [dataVisibility, setDataVisibility] = React.useState(function () {
         try {
           var savedVisibility = compatibility.storage.getItem(DATA_VISIBILITY_KEY)
@@ -855,6 +875,8 @@ window.__ModuleLoader__.load({
 
       function saveChipScale(next) {
         next = normalizeChipScale(next)
+        var cap = chipLayoutRef.current.dock === 'home' ? 1.2 : 1.25
+        if (next > cap) next = cap
         chipScaleRef.current = next
         setChipScale(next)
         try { compatibility.storage.setItem(CHIP_SCALE_KEY, String(next)) } catch (e) { /* ignore */ }
@@ -1211,6 +1233,35 @@ window.__ModuleLoader__.load({
         if (event.preventDefault) event.preventDefault()
       }
 
+      // A docked chip is position:fixed, but it still renders inside the host
+      // composer subtree; hosts commonly wrap that subtree in a low stacking
+      // context (dsh uses z-index:1), which caps the chip under neighbouring
+      // top-level panels. The node must stay in place so React's delegated
+      // events keep working, so instead lift the outermost trapping ancestor
+      // context while any dock mode is active.
+      useLayoutEffect(function () {
+        if (chipLayout.dock === 'home') return
+        var node = chipAnchorRef.current
+        if (node === null || typeof window === 'undefined' || !window.getComputedStyle) return
+        var outermost = null
+        while (node && node !== document.body) {
+          if (isStackingContext(window.getComputedStyle(node))) outermost = node
+          node = node.parentElement
+        }
+        chipLiftHostRef.current = outermost
+        if (outermost && outermost.classList) outermost.classList.add('dshw_chipLift')
+        return function () {
+          if (outermost && outermost.classList) outermost.classList.remove('dshw_chipLift')
+          if (chipLiftHostRef.current === outermost) chipLiftHostRef.current = null
+        }
+      }, [chipLayout.dock])
+
+      // A stored 125% from a floating/side dock must come back down when the
+      // chip returns to the space-constrained home row.
+      React.useEffect(function () {
+        if (chipLayout.dock === 'home' && chipScaleRef.current > 1.2) saveChipScale(1.2)
+      }, [chipLayout.dock])
+
       useLayoutEffect(function () {
         var node = chipRef.current
         if (node === null) return
@@ -1218,6 +1269,55 @@ window.__ModuleLoader__.load({
         var measured = { width: rect.width, height: rect.height, scale: chipScaleRef.current }
         if (node.classList && node.classList.contains('dshw_chipVertical')) chipSizeRef.current.vertical = measured
         else chipSizeRef.current.horizontal = measured
+      }, [chipLayout.dock, chipScale, data, showOfficial, showThird, homeMode])
+
+      useLayoutEffect(function () {
+        if (chipLayout.dock !== 'home') return
+        var anchor = chipAnchorRef.current
+        var chip = chipRef.current
+        if (!anchor || !chip) return
+
+        function measureHomeMode() {
+          var current = chipAnchorRef.current
+          var chipNode = chipRef.current
+          if (!current || !chipNode) return null
+          // Try each tier in place and let the composer row's own flex pressure
+          // accept or squeeze it: a tier fits when the chip's allocated width
+          // matches its content width. All readings come from the chip itself
+          // so the scale slider's zoom factor cancels out; the anchor's
+          // parent slot wrapper can be display:contents, so measuring
+          // ancestors is not reliable.
+          var compact = current.classList.contains('dshw_compact')
+          current.classList.remove('dshw_compact')
+          current.classList.remove('dshw_fit')
+          var mode
+          if (chipNode.clientWidth >= chipNode.scrollWidth - 1) {
+            mode = 'full'
+          } else {
+            current.classList.add('dshw_fit')
+            mode = chipNode.clientWidth >= chipNode.scrollWidth - 1 ? 'fit' : 'compact'
+            current.classList.remove('dshw_fit')
+          }
+          if (compact) current.classList.add('dshw_compact')
+          return mode
+        }
+
+        function evaluateHomeSpace() {
+          var next = measureHomeMode()
+          if (next) setHomeMode(next)
+        }
+
+        evaluateHomeSpace()
+        window.addEventListener('resize', evaluateHomeSpace)
+        var observer = typeof ResizeObserver !== 'undefined' ? new ResizeObserver(evaluateHomeSpace) : null
+        if (observer) {
+          observer.observe(anchor)
+          observer.observe(chip)
+        }
+        return function () {
+          window.removeEventListener('resize', evaluateHomeSpace)
+          if (observer) observer.disconnect()
+        }
       }, [chipLayout.dock, chipScale, data, showOfficial, showThird])
 
       useLayoutEffect(function () {
@@ -1377,6 +1477,9 @@ window.__ModuleLoader__.load({
       var thirdTokens = third.tokens ? totalTokens(third.tokens) : 0
       var low = showOfficial && snapshot.lowBalance === true
       var chipDock = chipLayout.dock
+      // The home toolbar row cannot fit the widest scale on narrow windows, so
+      // cap the slider there; floating and side docks keep the full range.
+      var scaleMaxPercent = chipDock === 'home' ? 120 : 125
       var chipVertical = chipDock === 'left' || chipDock === 'right' || chipDock === 'content-left'
       var chipClass = low ? 'dshw_chip dshw_chipLow' : 'dshw_chip'
       var cssZoom = compatibility.supportsCssZoom()
@@ -1455,7 +1558,7 @@ window.__ModuleLoader__.load({
           onClick: onRechargeClick
         }, '\u2197\u5145') : null)
 
-      var chipHost = React.createElement('span', { ref: chipAnchorRef, className: chipDock === 'home' ? 'dshw_anchor dshw_anchorHome' : 'dshw_anchor' }, chip)
+      var chipHost = React.createElement('span', { ref: chipAnchorRef, className: chipDock === 'home' ? 'dshw_anchor dshw_anchorHome' + (homeMode === 'compact' ? ' dshw_compact' : homeMode === 'fit' ? ' dshw_fit' : '') : 'dshw_anchor' }, chip)
       var snapPreviewElement = snapPreview ? React.createElement('div', {
         className: snapPreview.vertical ? 'dshw_snapPreview dshw_snapPreviewVertical' : 'dshw_snapPreview',
         style: { left: snapPreview.x, top: snapPreview.y, width: snapPreview.width, height: snapPreview.height },
@@ -1531,7 +1634,7 @@ window.__ModuleLoader__.load({
             className: 'dshw_scaleInput',
             type: 'range',
             min: '75',
-            max: '125',
+            max: String(scaleMaxPercent),
             step: '5',
             value: String(Math.round(chipScale * 100)),
             'aria-label': '钱包芯片比例',

package/package.json

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