@lls-a1/dsh-balance-float 1.1.47 → 1.1.48
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +45 -68
- package/client.js +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -1,91 +1,68 @@
|
|
|
1
1
|
# 余额悬浮窗(balance-float)
|
|
2
2
|
|
|
3
|
-
DSH Web UI
|
|
4
|
-
|
|
3
|
+
DSH Web UI 的悬浮小窗,实时显示 **API 余额、今日已用、每轮消耗和峰谷定价**。
|
|
4
|
+
|
|
5
|
+
Host 半边在本地记账(按轮记 token 与费用、轮询余额),浏览器半边只读快照渲染,API Key 始终不出 Host 进程。
|
|
5
6
|
|
|
6
7
|
## 安装
|
|
7
8
|
|
|
8
|
-
|
|
9
|
+
已发布到 npm,在插件管理里输入包名即可:
|
|
9
10
|
|
|
10
11
|
```text
|
|
11
12
|
@lls-a1/dsh-balance-float
|
|
12
13
|
```
|
|
13
14
|
|
|
14
|
-
|
|
15
|
-
本地开发可以用 `link:/path/to/balance-float`,改完刷新页面即可生效。
|
|
16
|
-
|
|
17
|
-
启用后 profile 里会多出一行 `id: balance-float`,可在 `config` 里覆盖账本路径、轮询间隔和 `apiKeyRef`(默认 `DEEPSEEK_API_KEY`,取不到时余额相关数字保持不动,不会归零)。
|
|
15
|
+
本地开发用 `link:/path/to/balance-float` 挂载,改完 `client.js` 刷新页面生效,改 `index.js` 需重载插件。
|
|
18
16
|
|
|
19
|
-
##
|
|
17
|
+
## 功能
|
|
20
18
|
|
|
21
|
-
|
|
22
|
-
| --- | --- | --- |
|
|
23
|
-
| Host | `index.js` + `lib/` | 订阅会话事件记账、轮询余额、写本地账本,注册只读路由 `GET /balance-float/snapshot` |
|
|
24
|
-
| Client | `client.js` | 在 `shell.overlay` 里注册悬浮窗(可拖动、每 4 秒刷新、点开看明细) |
|
|
19
|
+
**余额与用量**
|
|
25
20
|
|
|
26
|
-
|
|
21
|
+
- 大号数字是当前 API 余额,点「充值 ↗」跳官方充值页;
|
|
22
|
+
- 今日已用 = 0 点余额 − 当前余额(能覆盖其它客户端的花费),并给出调用次数、tokens、峰谷拆分;
|
|
23
|
+
- 本轮消耗显示当前这一轮的 tokens 与费用,每轮结算后在胶囊左下浮出「本轮 ¥x」气泡,3 秒自动淡出。
|
|
27
24
|
|
|
28
|
-
|
|
29
|
-
- 首次运行若没有自己的账本,会从旧的 `.dshw-usage.json` **复制**一份做种子(余额、今日、历史、近期事件),之后两边互不影响。
|
|
30
|
-
- 字段:`date`、`dayStart`(今日 0 点余额)、`lastBalance`、`todayUsage`、`history`(按天)、`events`(每轮每模型一条,含 `ts`/`model`/`cost`/`tokens`)。
|
|
25
|
+
**峰谷定价**
|
|
31
26
|
|
|
32
|
-
|
|
27
|
+
- 峰时:工作日 `09:00–12:00`、`14:00–18:00`;其余为谷时(含周末与法定节假日);
|
|
28
|
+
- 卡片显示「当前按峰价/谷价计费」,**峰=红、谷=绿**,右侧倒计时精确到秒;
|
|
29
|
+
- 单价表列出 Flash / Pro 的命中、未命中、输出单价,当前生效的一侧高亮;
|
|
30
|
+
- 柱状图看近 7 天用量,点某根柱子看那天明细(总消耗、峰谷拆分、按模型费用)。
|
|
33
31
|
|
|
34
|
-
|
|
35
|
-
- **Token 分项**:卡片里「Token 用量」默认折叠,标题右侧显示合计,展开后逐行给出缓存命中率(保留一位小数)/ 未缓存输入 / 缓存读取 / 输出;按日明细里同样给出这些行(本版本之前写入的事件只有合计,会显示为 0 并附提示)。
|
|
36
|
-
- **余额**:每 `refreshSeconds`(默认 20 秒)用 `credentials.resolve(apiKeyRef)` 取官方 API Key,请求 `https://api.deepseek.com/user/balance`,写回 `lastBalance`。密钥不出 Host 进程,也不写日志。
|
|
37
|
-
- **今日已用**:`dayStart - lastBalance`(能覆盖本机其它客户端的花费),同时不低过本地事件合计;跨零点时把昨日合计归档进 `history`,并用当前余额作为新一天基线。检测到充值(余额变大)时重设基线而不是报负数。
|
|
38
|
-
- 拿不到 Key 或接口失败时只保留已有数字,不会把余额写成 0。
|
|
32
|
+
**Token 用量**(默认折叠)
|
|
39
33
|
|
|
40
|
-
|
|
34
|
+
标题右侧显示合计,展开后逐行看缓存命中率、未缓存输入、缓存读取、输出。
|
|
41
35
|
|
|
42
|
-
|
|
43
|
-
- 谷时:工作日 `12:00–14:00`、`18:00–次日 09:00`,以及周末、法定节假日全天。
|
|
44
|
-
- 卡片里「当前按X计费」后有一个 `?`,点开用两行展示(`峰` 红 / `谷` 绿各一行),再点收起,默认不占版面。
|
|
45
|
-
- 界面配色:**峰=红、谷=绿**(胶囊的时段标签、卡片徽标、单价表里当前生效的一侧)。
|
|
46
|
-
- 单价(元 / 百万 tokens,`谷 / 峰`):Flash 命中 `0.02 / 0.04`、未命中 `1 / 2`、输出 `4 / 8`;
|
|
47
|
-
Pro 命中 `0.15 / 0.3`、未命中 `4.5 / 9`、输出 `13.5 / 27`。
|
|
48
|
-
- 来源:<https://api-docs.deepseek.com/zh-cn/quick_start/pricing>。
|
|
49
|
-
- 2027 年节假日安排发布后,补 `lib/pricing.js` 的 `HOLIDAY_VALLEY` 表即可。
|
|
36
|
+
## 操作
|
|
50
37
|
|
|
51
|
-
|
|
38
|
+
| 操作 | 效果 |
|
|
39
|
+
| --- | --- |
|
|
40
|
+
| 拖动 | 任意位置,位置会被记住;拖到左右边缘 56px 内松手收成小球,只显示余额 |
|
|
41
|
+
| 点标题栏 | 收起卡片 |
|
|
42
|
+
| 点环形箭头 | 立即刷新(请求中旋转) |
|
|
43
|
+
| 点版本号 | 检查更新,有新版弹窗给「复制安装链接」 |
|
|
44
|
+
| 点 `?` | 展开/收起峰谷说明 |
|
|
52
45
|
|
|
53
|
-
|
|
54
|
-
- insert:
|
|
55
|
-
- id: balance-float
|
|
56
|
-
name: 'dsh-balance-float'
|
|
57
|
-
config:
|
|
58
|
-
storeFile: '' # 账本路径,默认 $DSH_HOME/balance-float/usage.json
|
|
59
|
-
legacyFile: '' # 首次运行的种子账本,默认 $DSH_HOME/.dshw-usage.json
|
|
60
|
-
refreshSeconds: 20 # 余额轮询间隔
|
|
61
|
-
apiKeyRef: DEEPSEEK_API_KEY
|
|
62
|
-
```
|
|
46
|
+
卡片自动向上或向下展开(下方空间不足时向上),内容超长时内部滚动。数据每 4 秒刷新,页面回到前台时立即补一次。
|
|
63
47
|
|
|
64
48
|
## 外观设置
|
|
65
49
|
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
- 悬浮窗每 4 秒轮询一次,页面回到前台、窗口获得焦点或展开面板时立即补一次。
|
|
86
|
-
- 刷新按钮(环形箭头,请求中旋转)立即刷新;**点标题栏即可收起**(没有单独的收起按钮)。
|
|
87
|
-
- 卡片大号余额右侧有「充值 ↗」按钮,新标签页打开官方充值页 `platform.deepseek.com/top_up`(官方没有充值 API,只做跳转)。
|
|
88
|
-
- 页脚版本号可点击检查更新:悬停显示检查结果(有新版/已最新/失败),有新版时弹窗给出「复制安装链接」(`github:ming-a1/dsh-balance-float`),升级由插件管理器完成;插件本身不会修改自己的文件。
|
|
89
|
-
- 展开方向自适应:默认从胶囊**向下展开**;胶囊贴在屏幕底部、下方空间不够(<340px)时改为**向上展开**,并把卡片高度限制在视口内、内容区滚动。
|
|
90
|
-
- 卡片比胶囊宽(316px),靠右时自动改为右边缘对齐,不会顶出屏幕;胶囊本身的位置保持不变。
|
|
91
|
-
- 动效方向跟着展开方向走:向下展开从上方滑入、向上收起;向上展开从下方向上浮出、向下收回。均无缩放,收起先播 180ms 再卸载。
|
|
50
|
+
胶囊右侧的滑杆图标打开面板,即时生效并保存在本地:
|
|
51
|
+
|
|
52
|
+
- **背景透明度** 0–90%、**边框** 0–100%、**阴影** 0–100%、**圆角** 0–20px;
|
|
53
|
+
- **贴边收成小球**:默认开,拖到屏幕边缘自动收成 46×46 的小方球。
|
|
54
|
+
|
|
55
|
+
「恢复默认」回到 0% / 100% / 100% / 圆角 16px。
|
|
56
|
+
|
|
57
|
+
## 数据位置
|
|
58
|
+
|
|
59
|
+
账本在 `$DSH_HOME/balance-float/usage.json`(原子写入,损坏自动重建)。首次运行若没有自己的账本,会从旧的 `.dshw-usage.json` 复制一份作种子,之后互不影响。
|
|
60
|
+
|
|
61
|
+
可在 `cordis.patch.yml` 的 `config` 里覆盖:
|
|
62
|
+
|
|
63
|
+
```yaml
|
|
64
|
+
storeFile: '' # 账本路径,默认 $DSH_HOME/balance-float/usage.json
|
|
65
|
+
legacyFile: '' # 种子账本,默认 $DSH_HOME/.dshw-usage.json
|
|
66
|
+
refreshSeconds: 20 # 余额轮询间隔
|
|
67
|
+
apiKeyRef: DEEPSEEK_API_KEY
|
|
68
|
+
```
|
package/client.js
CHANGED
|
@@ -382,7 +382,7 @@ window.__ModuleLoader__.load({
|
|
|
382
382
|
'@keyframes dbf-flash-up{0%{opacity:0;transform:translateY(4px)}12%{opacity:1;transform:translateY(0)}84%{opacity:1;transform:translateY(0)}100%{opacity:0;transform:translateY(2px)}}',
|
|
383
383
|
'.dbf-setting{padding:8px 11px;border-bottom:.5px solid var(--dsw-alias-border-l1)}',
|
|
384
384
|
'.dbf-setting:last-child{border-bottom:0}',
|
|
385
|
-
'.dbf-track{position:relative;height:26px;margin:2px
|
|
385
|
+
'.dbf-track{position:relative;height:26px;margin:2px 7px 0;cursor:pointer;touch-action:none;border-radius:6px}',
|
|
386
386
|
'.dbf-track:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#4d6bfe);outline-offset:2px}',
|
|
387
387
|
'.dbf-track-rail{position:absolute;left:0;right:0;top:50%;height:4px;transform:translateY(-50%);border-radius:2px;background:var(--dsw-alias-border-l1)}',
|
|
388
388
|
'.dbf-track-fill{position:absolute;left:0;top:50%;height:4px;transform:translateY(-50%);border-radius:2px;background:var(--dsw-alias-brand-primary,#4d6bfe)}',
|