dsh-plugin-balance-usage 0.0.0-stage → 1.0.0
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/CHANGELOG.md +13 -0
- package/LICENSE +21 -0
- package/README.md +52 -2
- package/client.js +1349 -0
- package/cordis.patch.yml +3 -0
- package/docs/DETAIL.md +75 -0
- package/icon.svg +9 -0
- package/index.js +443 -0
- package/locale/en.json +7 -0
- package/locale/zh.json +7 -0
- package/package.json +71 -4
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
# 更新日志
|
|
2
|
+
|
|
3
|
+
## 1.0.0
|
|
4
|
+
|
|
5
|
+
首个公开版本。
|
|
6
|
+
|
|
7
|
+
- 侧栏底部入口:显示账户余额与今日 Token 用量,窄轨模式收为图标 + 状态点。
|
|
8
|
+
- 入口数字自动刷新:面板关着 30 秒、开着 15 秒,窗口重获焦点或标签页回到前台时立即补刷,不必点开面板就能看到余额与用量变化。
|
|
9
|
+
- 面板:充值 / 赠送余额、今日 / 累计用量、输入 / 输出 / 缓存读取(含缓存命中率)、近 14 天柱状图。
|
|
10
|
+
- 按运营商 / 模型分组,可折叠;星标设置「主线」,决定侧栏显示的数字。
|
|
11
|
+
- 桌面版在应用内以主内容区标签页打开官方用量页(复用宿主账号态);Web 版回退新标签页。
|
|
12
|
+
- 跟随主题令牌(浅色 / 深色 / 跟随系统)与界面语言(中 / 英),支持键盘操作与焦点管理。
|
|
13
|
+
- 用量由本机会话日志聚合,不上传数据。
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
# MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 kasshuang
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,53 @@
|
|
|
1
|
-
#
|
|
1
|
+
# dsh-plugin-balance-usage · 侧栏余额与用量
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
在 DeepSeek Harness(DSH)左侧栏底部加一个入口,直接把 **账户余额** 和 **今日 Token 用量** 摆在手边;点开面板可以看累计用量、近 14 天走势、按运营商 / 模型分组折叠与「主线」设置,并在应用内直接打开官方用量页。
|
|
4
|
+
|
|
5
|
+
## 功能
|
|
6
|
+
|
|
7
|
+
- **侧栏常驻入口**:宽栏显示「余额 + 今日用量」,折叠成窄轨时显示图标 + 状态点;数字自己刷新(关着 30 秒、开着 15 秒,窗口切回前台立刻补一次),不用点开也能看到变化。
|
|
8
|
+
- **账户余额**:来自 DeepSeek 平台账户接口(与「设置 → 账号与余额」同源),区分充值余额与赠送余额。
|
|
9
|
+
- **Token 用量**:读取本机会话日志(`~/.dsh/sessions/**/session.v4.jsonl.zstd`)汇总今日 / 累计 / 输入 / 输出 / 缓存读取与近 14 天柱状图。
|
|
10
|
+
- **多运营商 / 多模型**:按 `provider → model` 分组,可折叠;点星标把某个模型设为「主线」,侧栏显示的数字跟随主线(未设置时自动取最近使用的模型)。
|
|
11
|
+
- **官方用量详情**:面板底部按钮。桌面版在 **主内容区** 里以标签页打开官方 `platform.deepseek.com/usage`(复用宿主已注入的账号态,无需重新登录、不跳浏览器);Web 版退化为新标签页打开。
|
|
12
|
+
- **跟随主题与语言**:只用 `--dsw-alias-*` 主题变量,浅色 / 深色 / 跟随系统均可;中英文随界面语言切换,含键盘可达(Esc 关闭、焦点回到入口、Tab 循环)。
|
|
13
|
+
|
|
14
|
+
## 安装
|
|
15
|
+
|
|
16
|
+
在 DSH 里打开 **插件 → 添加插件 → 安装 npm 包**,输入:
|
|
17
|
+
|
|
18
|
+
```
|
|
19
|
+
dsh-plugin-balance-usage
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
安装后侧栏底部立即出现入口(客户端插件热载生效,必要时刷新页面)。
|
|
23
|
+
|
|
24
|
+
### 从市场索引安装
|
|
25
|
+
|
|
26
|
+
若你的 DSH 已添加下列索引源,可直接在 **插件 → 发现** 里点安装:
|
|
27
|
+
|
|
28
|
+
```
|
|
29
|
+
https://cdn.jsdelivr.net/gh/kasshuang/dsh-plugin-balance-usage@main/market/index.json
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
## 数据与隐私
|
|
33
|
+
|
|
34
|
+
- 余额通过 DSH 官方的 `deepseekAccount` Remote 读取,本插件不接触、不保存任何凭据。
|
|
35
|
+
- 用量由 **本机** 会话日志聚合而成,不上传任何数据;扫描结果在内存中缓存 20 秒。
|
|
36
|
+
- 面板里「近 N 天 · M 次请求」的口径是 **本机会话**,因此可能小于平台账单(平台统计所有客户端与 API 调用)。
|
|
37
|
+
|
|
38
|
+
## 已知限制
|
|
39
|
+
|
|
40
|
+
- 应用内用量页仅在桌面版可用(浏览器没有 `dshPlatform` 桥,回退为外链)。
|
|
41
|
+
- 历史用量依赖本机会话日志;换机或清理 `~/.dsh/sessions` 后统计从零开始。
|
|
42
|
+
|
|
43
|
+
## 开发
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
git clone https://github.com/kasshuang/dsh-plugin-balance-usage.git
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
在 DSH 里 **插件 → 添加插件 → 从本地目录安装**,指向仓库根目录即可(DSH 会以 link 方式加载,改完客户端代码热载生效)。详细设计与踩坑记录见 [docs/DETAIL.md](docs/DETAIL.md)。
|
|
50
|
+
|
|
51
|
+
## 许可证
|
|
52
|
+
|
|
53
|
+
MIT
|