dsh-balance-ball 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Star_Robin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,7 +1,11 @@
-# dsh-account-balance
+# dsh-balance-ball
 
 DeepSeek Harness 插件：一个可拖动的悬浮球，常驻显示你的 **DeepSeek 账户余额**，点击展开详情面板，查看实时价格、今日价格走势和 token 消耗估算。
 
+![悬浮球](assets/screenshot-ball.png)
+
+![详情面板](assets/screenshot-panel.png)
+
 ## 功能
 
 - **悬浮球**：圆形、可拖动、可固定，颜色随余额状态变化（绿=充足、黄=少于10元、红=耗尽）
@@ -15,13 +19,13 @@ DeepSeek Harness 插件：一个可拖动的悬浮球，常驻显示你的 **Dee
 ### 方式一：npm
 
 ```bash
-dsh plugin add dsh-account-balance
+dsh plugin add dsh-balance-ball
 ```
 
 ### 方式二：GitHub
 
 ```bash
-dsh plugin --profile web add github:<你的用户名>/dsh-account-balance
+dsh plugin --profile web add github:StarRob1n/dsh-account-balance
 ```
 
 安装后重启 DSH，右下角会出现悬浮球。

package/lib/client.js

@@ -330,17 +330,33 @@ window.__ModuleLoader__.load({
     function BalanceWidget() {
       const { state, reload } = useBalance();
       const [open, setOpen] = react.useState(false);
-      // 位置状态：默认右下角，用 useState 驱动（拖动时更新，菜单跟随）
+      const STORE_KEY = "dsh-balance-ball/pos";
+      // 位置状态：优先从 localStorage 恢复上次位置，否则默认右下角
       const [pos, setPos] = react.useState(() => {
         const vv = typeof window !== "undefined" ? window.visualViewport : null;
         const vw = (vv && vv.width) || (typeof window !== "undefined" ? document.documentElement.clientWidth : 0) || (typeof window !== "undefined" ? window.innerWidth : 0);
         const vh = (vv && vv.height) || (typeof window !== "undefined" ? document.documentElement.clientHeight : 0) || (typeof window !== "undefined" ? window.innerHeight : 0);
-        return {
-          left: vw > 0 ? vw - BALL_SIZE - 20 : 100,
-          top: vh > 0 ? vh - BALL_SIZE - 100 : 200,
-        };
+        const defLeft = vw > 0 ? vw - BALL_SIZE - 20 : 100;
+        const defTop = vh > 0 ? vh - BALL_SIZE - 100 : 200;
+        // 尝试恢复上次位置（越界则回退默认）
+        try {
+          const saved = JSON.parse(localStorage.getItem(STORE_KEY) || "null");
+          if (saved && typeof saved.left === "number" && typeof saved.top === "number") {
+            const maxX = vw - BALL_SIZE;
+            const maxY = vh - BALL_SIZE;
+            return {
+              left: Math.max(0, Math.min(saved.left, maxX)),
+              top: Math.max(0, Math.min(saved.top, maxY)),
+            };
+          }
+        } catch (_) {}
+        return { left: defLeft, top: defTop };
       });
-      const move = react.useCallback((p) => setPos(p), []);
+      const move = react.useCallback((p) => {
+        setPos(p);
+        // 持久化位置，重启后恢复
+        try { localStorage.setItem(STORE_KEY, JSON.stringify(p)); } catch (_) {}
+      }, []);
       const close = react.useCallback(() => setOpen(false), []);
       const toggle = react.useCallback(() => setOpen((o) => !o), []);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-balance-ball",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "悬浮球显示 DeepSeek 账户余额（OAuth 登录），附带实时价格、今日价格走势与 token 消耗估算区间。可拖动、可固定，点击展开详情面板。",
   "type": "module",
   "main": "lib/index.js",
@@ -13,7 +13,9 @@
     "lib/index.js",
     "lib/client.js",
     "cordis.patch.yml",
-    "README.md"
+    "README.md",
+    "assets",
+    "screenshots.json"
   ],
   "dsh": {
     "bundle": {
@@ -41,6 +43,20 @@
     }
   },
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/StarRob1n/dsh-account-balance.git"
+  },
+  "homepage": "https://github.com/StarRob1n/dsh-account-balance#readme",
+  "keywords": [
+    "deepseek",
+    "deepseek-harness",
+    "dsh",
+    "dsh-plugin",
+    "balance",
+    "billing",
+    "usage"
+  ],
   "engines": {
     "node": ">=20",
     "dsh": ">=0.2.0"

package/screenshots.json

@@ -0,0 +1,4 @@
+[
+  "assets/screenshot-ball.png",
+  "assets/screenshot-panel.png"
+]