dsh-desktop-statusbar 2.0.2 → 2.1.1

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/LICENSE CHANGED
@@ -1,77 +1,21 @@
1
- Required Notice: Copyright 2026 北浮森屿 (https://github.com/raphael-y7/dsh-desktop-statusbar)
2
-
3
- PolyForm Noncommercial License 1.0.0
4
-
5
- https://polyformproject.org/licenses/noncommercial/1.0.0
6
-
7
- ## Acceptance
8
-
9
- In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
10
-
11
- ## Copyright License
12
-
13
- The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor's copyright in it for any permitted purpose. However, you may only distribute the software according to [Distribution License](#distribution-license) and make changes or new works based on the software according to [Changes and New Works License](#changes-and-new-works-license).
14
-
15
- ## Distribution License
16
-
17
- The licensor grants you an additional copyright license to distribute copies of the software. Your license to distribute covers distributing the software with changes and new works permitted by [Changes and New Works License](#changes-and-new-works-license).
18
-
19
- ## Notices
20
-
21
- You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with `Required Notice:` that the licensor provided with the software. For example:
22
-
23
- > Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
24
-
25
- ## Changes and New Works License
26
-
27
- The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
28
-
29
- ## Patent License
30
-
31
- The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
32
-
33
- ## Noncommercial Purposes
34
-
35
- Any noncommercial purpose is a permitted purpose.
36
-
37
- ## Personal Uses
38
-
39
- Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
40
-
41
- ## Noncommercial Organizations
42
-
43
- Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
44
-
45
- ## Fair Use
46
-
47
- You may have "fair use" rights for the software under the law. These terms do not limit them.
48
-
49
- ## No Other Rights
50
-
51
- These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else. These terms do not imply any other licenses.
52
-
53
- ## Patent Defense
54
-
55
- If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
56
-
57
- ## Violations
58
-
59
- The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice. Otherwise, all your licenses end immediately.
60
-
61
- ## No Liability
62
-
63
- _**As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.**_
64
-
65
- ## Definitions
66
-
67
- The **licensor** is the individual or entity offering these terms, and the **software** is the software the licensor makes available under these terms.
68
-
69
- **You** refers to the individual or entity agreeing to these terms.
70
-
71
- **Your company** is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. **Control** means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.
72
-
73
- **Your licenses** are all the licenses granted to you for the software under these terms.
74
-
75
- **Use** means anything you do with the software requiring one of your licenses.
76
-
77
- © PolyForm Project Inc.
1
+ MIT License
2
+
3
+ Copyright (c) 2026 北浮森屿
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.en.md CHANGED
@@ -1,96 +1,108 @@
1
- <h1 align="center">dsh-desktop-statusbar</h1>
2
-
3
- <p align="center">
4
- <a href="https://github.com/raphael-y7/dsh-desktop-statusbar/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/raphael-y7/dsh-desktop-statusbar?style=social"></a>
5
- <a href="https://www.npmjs.com/package/dsh-desktop-statusbar"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-desktop-statusbar?color=red"></a>
6
- <a href="LICENSE"><img alt="license" src="https://img.shields.io/badge/license-PolyForm%20Noncommercial%201.0.0-green"></a>
7
- <a href="https://github.com/deepseek-ai/deepseek-harness"><img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-0.2.0--rc.1-%234d6bfe"></a>
8
- <a href="https://nodejs.org/"><img alt="node" src="https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-%235fa04e"></a>
9
- <img alt="language" src="https://img.shields.io/github/languages/top/raphael-y7/dsh-desktop-statusbar?color=yellow">
10
- <a href="https://dshfind.com/zh/plugins/raphael-y7/dsh-desktop-statusbar"><img alt="dshfind" src="https://img.shields.io/badge/dshfind-listed-%2300a884"></a>
11
- <a href="https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar"><img alt="1024Store" src="https://img.shields.io/badge/1024Store-listed-orange"></a>
12
- </p>
13
-
14
- <p align="center"><a href="README.md">中文</a> | English</p>
15
-
16
- Replaces the stats line under the message input in the DSH desktop app with a configurable status bar: fields, ordering, per-model prices and currency are all configurable, with live cost estimates using DeepSeek's official peak/off-peak rates.
17
-
18
- > Noncommercial licence: free for personal, study, teaching and nonprofit use, with modification allowed; **commercial use is not permitted** ([PolyForm Noncommercial 1.0.0](LICENSE)).
19
-
20
- ![Status bar](docs/statusbar.en.png)
21
-
22
- ## Features
23
-
24
- - **10 optional fields**: session status, peak / off-peak check, turns and steps, combined hit, TTFT, TPS, run time, this turn cost, session cost, balance
25
- - **Click a field for details**:
26
-
27
- | Field | Content |
28
- | --- | --- |
29
- | Session status | Context occupancy: system prompt / tool definitions / messages |
30
- | Combined hit | This turn / highest / lowest cache hit rate |
31
- | TTFT | This turn / fastest / slowest first-token delay |
32
- | TPS | This turn / fastest / slowest output speed |
33
- | Run time | Model time / tool calls |
34
- | This turn cost | Token breakdown for this turn |
35
- | Session cost | Cumulative token breakdown for the whole session |
36
- | Balance | Top-up balance / granted balance |
37
-
38
- - **Cost estimation**: priced with the official peak/off-peak rules; each call is computed from the moment it happened and the model it used
39
- - **Price book**: your own prices, an optional peak/off-peak split, and a CNY / USD currency switch
40
- - **Also**: one-click holiday calendar update, balance refreshed every minute, bilingual UI
41
-
42
- ## Install
43
-
44
- In the DSH desktop app, open **Plugins → Add plugin** and install by package name:
45
-
46
- ```
47
- dsh-desktop-statusbar
48
- ```
49
-
50
- Where the npm registry is not reachable, the same dialog offers the China mainland mirror as the install source. A GitHub repository URL is also accepted:
51
-
52
- ```
53
- https://github.com/raphael-y7/dsh-desktop-statusbar
54
- ```
55
-
56
- Command line:
57
-
58
- ```powershell
59
- dsh plugin --profile desktop add dsh-desktop-statusbar
60
- ```
61
-
62
- Published on npm and listed on [dshfind](https://dshfind.com/zh/plugins/raphael-y7/dsh-desktop-statusbar) and [1024Store](https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar).
63
-
64
- ## Usage
65
-
66
- Open **Settings → Status bar**:
67
-
68
- ![Settings page](docs/settings.en.png)
69
-
70
- - **Session status**: the ring at the front of the bar — progress shows context occupancy and colour the run state (grey idle / green running / red error / amber pending approval); click it for the token composition
71
- - **Stats fields**: ticking controls visibility only, so unticking hides a field without moving it; drag the handle on the right to reorder; "Reset settings" restores the factory order
72
- - **Custom model prices**: enter a model name and "Add" to create an entry; "Edit" opens the editor and changes are written on save; tick "peak / off-peak pricing" to split by time of day, otherwise a flat all-day price applies
73
- - **Currency**: CNY or USD in the top-right corner of the editor. Switching replaces the two built-in models with that currency's official reference prices (edited entries are kept) and changes the symbol in the cost fields; the balance follows the currency reported by the API
74
- - **Holidays**: "Update holidays" fetches and writes the next year's public-holiday calendar
75
- - **Balance**: refreshed once a minute
76
-
77
- ### Billing rules
78
-
79
- Peak hours are **09:00–12:00 and 14:00–18:00 Beijing time, Monday to Friday**, and off-peak rates are half the peak rates; Chinese public holidays and weekends are billed off-peak all day (matching the [official docs](https://api-docs.deepseek.com/quick_start/pricing), checked 2026-09).
80
-
81
- ![Custom model prices](docs/pricing.en.png)
82
-
83
- ## Known limitations
84
-
85
- - Fastest / slowest TTFT and speed come from a new host-side projection: **you must fully quit and restart DSH** before it starts collecting
86
- - A model with no price is not billed; adding the price back-fills its earlier calls
87
-
88
- ## Development
89
-
90
- ```powershell
91
- node tools/test.cjs
92
- ```
93
-
94
- ## Licence
95
-
96
- [PolyForm Noncommercial 1.0.0](LICENSE): permitted for personal, research, study, teaching and nonprofit use, and for modification and redistribution (keep attribution); **commercial use is not permitted**.
1
+ <h1 align="center">dsh-desktop-statusbar</h1>
2
+
3
+ <p align="center">
4
+ <a href="https://github.com/raphael-y7/dsh-desktop-statusbar/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/raphael-y7/dsh-desktop-statusbar?style=social"></a>
5
+ <a href="https://github.com/deepseek-ai/deepseek-harness"><img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-0.2.0--rc.2-%234d6bfe"></a>
6
+ <a href="https://dshfind.com/zh/plugins/raphael-y7/dsh-desktop-statusbar"><img alt="dshfind" src="https://img.shields.io/badge/dshfind-listed-%2300a884"></a>
7
+ <a href="https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar"><img alt="1024Store" src="https://img.shields.io/badge/1024Store-listed-orange"></a>
8
+ <a href="https://www.npmjs.com/package/dsh-desktop-statusbar"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-desktop-statusbar?color=red"></a>
9
+ <br>
10
+ <a href="https://nodejs.org/"><img alt="node" src="https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-%238b5cf6"></a>
11
+ <img alt="language" src="https://img.shields.io/github/languages/top/raphael-y7/dsh-desktop-statusbar?color=yellow">
12
+ <a href="LICENSE"><img alt="license" src="https://img.shields.io/badge/license-MIT-%235fa04e"></a>
13
+ </p>
14
+
15
+ <p align="center"><a href="README.md">中文</a> | English</p>
16
+
17
+ Replaces the stats line under the message input in the DSH desktop app with a configurable status bar: fields, ordering, per-model prices and currency are all configurable, with live cost estimates using DeepSeek's official peak/off-peak rates.
18
+
19
+ ![Status bar](docs/statusbar.en.png)
20
+
21
+ ## Features
22
+
23
+ - **10 optional fields**: context occupancy (the ring at the head of the bar), peak / off-peak check, turns & steps, cache hit rate, output speed, TTFT, run time, this turn cost, session cost, balance
24
+ - **Click a field for details**:
25
+
26
+ | Field | Content |
27
+ | --- | --- |
28
+ | Context ring (bar head) | System prompt / tool definitions / messages |
29
+ | Peak / off-peak check | Usage heat map: day / week / month / year |
30
+ | Turns & steps | Context compactions / skills injected / tool calls |
31
+ | Combined hit | This turn / highest / lowest cache hit rate |
32
+ | TPS | This turn / fastest / slowest speed |
33
+ | TTFT | This turn / fastest / slowest first-token delay |
34
+ | Run time | Wait time / model time / tool calls |
35
+ | This turn cost | Token breakdown for this turn |
36
+ | Session cost | Cumulative token breakdown for this session |
37
+ | Balance | Top-up balance / granted balance / quota left |
38
+
39
+ - **Session data drill-down**: context compactions mark the node they happened at, skills injected counts the skills injected in this session, and tool calls list every tool the session used by count; click the title to go back up
40
+ - **Version check and update**: DSH checks for the latest version on startup, shows a hint next to the "Status bar" nav item when one is available, and offers a one-click update button in settings
41
+ - **GitHub support**: your support is the biggest motivation for the developer to keep going! Click the button to open the GitHub project page and help with a star — thanks, everyone!
42
+ - **Cost estimation**: priced with the official peak/off-peak rules; each call is computed from the moment it happened and the model it used
43
+ - **Price book**: your own prices, an optional peak/off-peak split, and a CNY / USD currency switch
44
+ - **Also**: one-click holiday calendar update, balance refreshed every minute, bilingual UI
45
+
46
+ ## Install
47
+
48
+ In the DSH desktop app, open **Plugins → Add plugin** and install by package name:
49
+
50
+ ```
51
+ dsh-desktop-statusbar
52
+ ```
53
+
54
+ Where the npm registry is not reachable, the same dialog offers the China mainland mirror as the install source. A GitHub repository URL is also accepted:
55
+
56
+ ```
57
+ https://github.com/raphael-y7/dsh-desktop-statusbar
58
+ ```
59
+
60
+ Command line:
61
+
62
+ ```powershell
63
+ dsh plugin --profile desktop add dsh-desktop-statusbar
64
+ ```
65
+
66
+ ### Install from npm
67
+
68
+ Both ways above install from the npm registry; the package name is `dsh-desktop-statusbar`. To check the current version on npm:
69
+
70
+ ```powershell
71
+ npm view dsh-desktop-statusbar version
72
+ ```
73
+
74
+ Also listed on [dshfind](https://dshfind.com/zh/plugins/raphael-y7/dsh-desktop-statusbar) and [1024Store](https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar).
75
+
76
+ ## Usage
77
+
78
+ Open **Settings → Status bar**:
79
+
80
+ ![Settings page](docs/settings.en.png)
81
+
82
+ - **Context occupancy**: the ring at the head of the bar — progress shows the share of context used, the gap marks the compaction threshold, and the colour shows the run state (grey idle / green running / red error / amber pending approval)
83
+ - **Stats fields**: ticking controls visibility only, so unticking hides a field without moving it; drag the handle on the right to reorder; "Reset settings" restores the factory order
84
+ - **Custom model prices**: enter a model name and "Add" to create an entry; "Edit" opens the editor and changes are written on save; tick "peak / off-peak pricing" to split by time of day, otherwise a flat all-day price applies
85
+ - **Currency**: CNY or USD in the top-right corner of the editor. Switching replaces the two built-in models with that currency's official reference prices (edited entries are kept) and changes the symbol in the cost fields; the balance follows the currency reported by the API
86
+ - **Holidays**: click "Update holidays" to fetch and write the next year's public-holiday calendar
87
+ - **Balance**: refreshed once a minute
88
+
89
+ ### Billing rules
90
+
91
+ Peak hours are **09:00–12:00 and 14:00–18:00 Beijing time, Monday to Friday**, and off-peak rates are half the peak rates; Chinese public holidays and weekends are billed off-peak all day (matching the [official docs](https://api-docs.deepseek.com/quick_start/pricing), checked 2026-09).
92
+
93
+ ![Custom model prices](docs/pricing.en.png)
94
+
95
+ ## Known limitations
96
+
97
+ - Fastest / slowest TTFT and speed come from a new host-side projection: **you must fully quit and restart DSH** before it starts collecting
98
+ - A model with no price is not billed; adding the price back-fills its earlier calls
99
+
100
+ ## Development
101
+
102
+ ```powershell
103
+ node tools/test.cjs
104
+ ```
105
+
106
+ ## Licence
107
+
108
+ [MIT](LICENSE): free to use, modify and redistribute; keep the copyright and licence notice.
package/README.md CHANGED
@@ -1,96 +1,108 @@
1
- <h1 align="center">dsh-desktop-statusbar</h1>
2
-
3
- <p align="center">
4
- <a href="https://github.com/raphael-y7/dsh-desktop-statusbar/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/raphael-y7/dsh-desktop-statusbar?style=social"></a>
5
- <a href="https://www.npmjs.com/package/dsh-desktop-statusbar"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-desktop-statusbar?color=red"></a>
6
- <a href="LICENSE"><img alt="license" src="https://img.shields.io/badge/license-PolyForm%20Noncommercial%201.0.0-green"></a>
7
- <a href="https://github.com/deepseek-ai/deepseek-harness"><img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-0.2.0--rc.1-%234d6bfe"></a>
8
- <a href="https://nodejs.org/"><img alt="node" src="https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-%235fa04e"></a>
9
- <img alt="language" src="https://img.shields.io/github/languages/top/raphael-y7/dsh-desktop-statusbar?color=yellow">
10
- <a href="https://dshfind.com/zh/plugins/raphael-y7/dsh-desktop-statusbar"><img alt="dshfind" src="https://img.shields.io/badge/dshfind-listed-%2300a884"></a>
11
- <a href="https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar"><img alt="1024Store" src="https://img.shields.io/badge/1024Store-listed-orange"></a>
12
- </p>
13
-
14
- <p align="center">中文 | <a href="README.en.md">English</a></p>
15
-
16
- 以一条可配置的状态栏替换 DSH 桌面端对话区底部的统计行:字段、顺序、模型单价与计价单位均可配置,费用按官方峰谷口径实时估算。
17
-
18
- > 非商业许可:个人、学习、教学与非营利使用均可自由使用和修改,**禁止商业用途**([PolyForm Noncommercial 1.0.0](LICENSE))。
19
-
20
- ![底栏效果](docs/statusbar.png)
21
-
22
- ## 功能
23
-
24
- - **10 个可选字段**:会话状态、峰谷判断、轮次与步数、综合命中、首字平均、输出速度、运行用时、本轮费用、总计费用、余额
25
- - **点击字段可查看详情**:
26
-
27
- | 字段 | 内容 |
28
- | --- | --- |
29
- | 会话状态 | 上下文占用:系统提示词 / 工具定义 / 对话消息 |
30
- | 综合命中 | 本轮 / 最高 / 最低缓存命中率 |
31
- | 首字平均 | 本轮 / 最快 / 最慢首字延迟 |
32
- | 输出速度 | 本轮 / 最快 / 最慢输出速度 |
33
- | 运行用时 | 模型用时 / 工具调用 |
34
- | 本轮费用 | 本轮会话的 token 明细 |
35
- | 总计费用 | 整个会话累计的 token 明细 |
36
- | 余额 | 充值余额 / 赠金余额 |
37
-
38
- - **费用估算**:按官方峰谷口径计价,每条调用按其发生时刻与所用模型分别计算
39
- - **价格库**:自定义单价、峰谷分档、CNY / USD 计价单位
40
- - **其他**:节假日日历一键更新、账户余额每分钟刷新、中英双语
41
-
42
- ## 安装
43
-
44
- 在 DSH 桌面端打开 **插件 → 添加插件**,输入包名后安装:
45
-
46
- ```
47
- dsh-desktop-statusbar
48
- ```
49
-
50
- 网络受限时,可在同一对话框内将安装源切换为「中国大陆镜像源」。亦支持 GitHub 仓库地址:
51
-
52
- ```
53
- https://github.com/raphael-y7/dsh-desktop-statusbar
54
- ```
55
-
56
- 命令行方式:
57
-
58
- ```powershell
59
- dsh plugin --profile desktop add dsh-desktop-statusbar
60
- ```
61
-
62
- 已发布至 npm,并收录于 [dshfind](https://dshfind.com/zh/plugins/raphael-y7/dsh-desktop-statusbar) 与 [1024Store](https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar)。
63
-
64
- ## 使用
65
-
66
- 打开 **设置 → 状态栏**:
67
-
68
- ![设置页](docs/settings.png)
69
-
70
- - **会话状态**:栏首圆环,进度表示上下文占用,颜色表示运行状态(空闲灰 / 运行绿 / 报错红 / 待审批黄),点击查看各部分的 token 构成
71
- - **统计字段**:勾选控制显示,取消勾选仅隐藏、不改变位置;拖动右侧把手调整顺序;「恢复默认设置」恢复出厂顺序并全选
72
- - **自定义模型价格**:输入模型名并「添加」以新增条目;「修改」展开编辑区,保存后写入;需区分峰谷时段时勾选「峰谷计价」,否则按全天同价计算
73
- - **计价单位**:价格编辑区右上角可选 CNY 或 USD。切换时内置的两款模型改用对应币种的官方参考价(已修改的条目保留),费用段的符号随之变化;余额按接口返回的币种显示
74
- - **节假日**:点「更新节假峰谷」获取并写入下一年的放假安排
75
- - **余额**:每分钟自动刷新
76
-
77
- ### 计费口径
78
-
79
- 高峰时段为**北京时间周一至周五 9:00-12:00、14:00-18:00**,空闲价为高峰价的一半;法定节假日与周末全天按空闲价计费(与[官方文档](https://api-docs.deepseek.com/zh-cn/quick_start/pricing)一致,2026-09 核对)。
80
-
81
- ![自定义模型价格](docs/pricing.png)
82
-
83
- ## 已知限制
84
-
85
- - 最快 / 最慢首字与速度来自 host 新增的投影,**升级后需完全退出并重启 DSH** 才开始统计
86
- - 价格库中缺少单价的模型不计费,补充单价后自动补算
87
-
88
- ## 开发
89
-
90
- ```powershell
91
- node tools/test.cjs
92
- ```
93
-
94
- ## 许可
95
-
96
- [PolyForm Noncommercial 1.0.0](LICENSE):允许个人、研究、学习、教学与非营利使用,允许修改与再分发(保留署名),**禁止商业用途**。
1
+ <h1 align="center">dsh-desktop-statusbar</h1>
2
+
3
+ <p align="center">
4
+ <a href="https://github.com/raphael-y7/dsh-desktop-statusbar/stargazers"><img alt="GitHub stars" src="https://img.shields.io/github/stars/raphael-y7/dsh-desktop-statusbar?style=social"></a>
5
+ <a href="https://github.com/deepseek-ai/deepseek-harness"><img alt="DeepSeek Harness" src="https://img.shields.io/badge/DeepSeek%20Harness-0.2.0--rc.2-%234d6bfe"></a>
6
+ <a href="https://dshfind.com/zh/plugins/raphael-y7/dsh-desktop-statusbar"><img alt="dshfind" src="https://img.shields.io/badge/dshfind-listed-%2300a884"></a>
7
+ <a href="https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar"><img alt="1024Store" src="https://img.shields.io/badge/1024Store-listed-orange"></a>
8
+ <a href="https://www.npmjs.com/package/dsh-desktop-statusbar"><img alt="npm version" src="https://img.shields.io/npm/v/dsh-desktop-statusbar?color=red"></a>
9
+ <br>
10
+ <a href="https://nodejs.org/"><img alt="node" src="https://img.shields.io/badge/node-%5E22.19%20%7C%7C%20%3E%3D24-%238b5cf6"></a>
11
+ <img alt="language" src="https://img.shields.io/github/languages/top/raphael-y7/dsh-desktop-statusbar?color=yellow">
12
+ <a href="LICENSE"><img alt="license" src="https://img.shields.io/badge/license-MIT-%235fa04e"></a>
13
+ </p>
14
+
15
+ <p align="center">中文 | <a href="README.en.md">English</a></p>
16
+
17
+ 以一条可配置的状态栏替换 DSH 桌面端对话区底部的统计行:字段、顺序、模型单价与计价单位均可配置,费用按官方峰谷口径实时估算。
18
+
19
+ ![底栏效果](docs/statusbar.png)
20
+
21
+ ## 功能
22
+
23
+ - **10 个可选字段**:上下文占用(栏首圆环)、峰谷判断、轮次&步数、缓存命中率、输出速度、首字平均、运行用时、本轮费用、总计费用、余额
24
+ - **点击字段可查看详情**:
25
+
26
+ | 字段 | 内容 |
27
+ | --- | --- |
28
+ | 上下文占用(栏首圆环) | 系统提示词 / 工具定义 / 对话消息 |
29
+ | 峰谷判断 | 日 / 周 / 月 / 年数据统计热力图 |
30
+ | 轮次&步数 | 上下文压缩 / 技能注入 / 工具调用 |
31
+ | 综合命中 | 本轮 / 最高 / 最低缓存命中率 |
32
+ | 综合速度 | 本轮 / 最快 / 最慢速度 |
33
+ | 首字平均 | 本轮 / 最快 / 最慢首字延迟 |
34
+ | 运行用时 | 等待用时 / 模型用时 / 工具调用 |
35
+ | 本轮费用 | 本轮会话的 token 明细 |
36
+ | 总计费用 | 当前会话的累计 token 明细 |
37
+ | 余额 | 充值余额 / 赠金余额 / 剩余配额 |
38
+
39
+ - **会话数据下钻**:上下文压缩逐次标注发生节点,技能注入统计当前会话注入的技能,工具调用按次数列出会话使用的所有工具;点击标题返回上一层
40
+ - **版本自检与更新**:DSH启动时自动检测最新版本,发现新版时在「状态栏」导航项旁显示提示,并在设置页提供一键更新按钮
41
+ - **费用估算**:按官方峰谷口径计价,每条调用按其发生时刻与所用模型分别计算
42
+ - **价格库**:自定义单价、峰谷分档、CNY / USD 计价单位
43
+ - **GitHub支持**:用户的支持是开发者持续开发的最大动力!点击按钮转跳GitHub项目页,帮忙点亮Star支持一下,感谢各位!
44
+ - **其他**:节假日日历一键更新、账户余额每分钟刷新、中英双语
45
+
46
+ ## 安装
47
+
48
+ 在 DSH 桌面端打开 **插件 → 添加插件**,输入包名后安装:
49
+
50
+ ```
51
+ dsh-desktop-statusbar
52
+ ```
53
+
54
+ 网络受限时,可在同一对话框内将安装源切换为「中国大陆镜像源」。亦支持 GitHub 仓库地址:
55
+
56
+ ```
57
+ https://github.com/raphael-y7/dsh-desktop-statusbar
58
+ ```
59
+
60
+ 命令行方式:
61
+
62
+ ```powershell
63
+ dsh plugin --profile desktop add dsh-desktop-statusbar
64
+ ```
65
+
66
+ ### 从 npm 安装
67
+
68
+ 插件面板与命令行两种方式,安装源默认都是 npm registry,包名为 `dsh-desktop-statusbar`。想确认 npm 上的当前版本:
69
+
70
+ ```powershell
71
+ npm view dsh-desktop-statusbar version
72
+ ```
73
+
74
+ 本插件亦收录于 [dshfind](https://dshfind.com/zh/plugins/raphael-y7/dsh-desktop-statusbar) 与 [1024Store](https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar)。
75
+
76
+ ## 使用
77
+
78
+ 打开 **设置 → 状态栏**:
79
+
80
+ ![设置页](docs/settings.png)
81
+
82
+ - **上下文占用**:栏首圆环,进度表示上下文占用比例,缺口表示上下文压缩阈值,颜色表示运行状态(空闲灰 / 运行绿 / 报错红 / 待审批黄)
83
+ - **统计字段**:勾选控制显示,取消勾选仅隐藏、不改变位置;拖动右侧把手调整顺序;「恢复默认设置」恢复出厂顺序并全选
84
+ - **自定义模型价格**:输入模型名并「添加」以新增条目;「修改」展开编辑区,保存后写入;需区分峰谷时段时勾选「峰谷计价」,否则按全天同价计算
85
+ - **计价单位**:价格编辑区右上角可选 CNY 或 USD。切换时内置的两款模型改用对应币种的官方参考价(已修改的条目保留),费用段的符号随之变化;余额按接口返回的币种显示
86
+ - **节假日**:点击「更新节假峰谷」获取并写入下一年的放假安排
87
+ - **余额**:每分钟自动刷新
88
+
89
+ ### 计费口径
90
+
91
+ 高峰时段为**北京时间周一至周五 9:00-12:00、14:00-18:00**,空闲价为高峰价的一半;法定节假日与周末全天按空闲价计费(与[官方文档](https://api-docs.deepseek.com/zh-cn/quick_start/pricing)一致,2026-09 核对)。
92
+
93
+ ![自定义模型价格](docs/pricing.png)
94
+
95
+ ## 已知限制
96
+
97
+ - 最快 / 最慢首字与速度来自 host 新增的投影,**升级后需完全退出并重启 DSH** 才开始统计
98
+ - 价格库中缺少单价的模型不计费,补充单价后自动补算
99
+
100
+ ## 开发
101
+
102
+ ```powershell
103
+ node tools/test.cjs
104
+ ```
105
+
106
+ ## 许可
107
+
108
+ [MIT](LICENSE):可自由使用、修改与再分发;保留版权与许可声明即可。
Binary file
package/docs/pricing.png CHANGED
Binary file
Binary file
package/docs/settings.png CHANGED
Binary file
Binary file
Binary file
package/icon.svg ADDED
@@ -0,0 +1,10 @@
1
+ <svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
2
+ <path d="M5.01 28.5A15 15 0 1 1 30.99 28.5" stroke="url(#gauge)" stroke-width="2.8" stroke-linecap="round" />
3
+ <path d="M18 21l6-6" stroke="url(#gauge)" stroke-width="2.8" stroke-linecap="round" />
4
+ <defs>
5
+ <linearGradient id="gauge" x1="5" y1="12" x2="31" y2="29" gradientUnits="userSpaceOnUse">
6
+ <stop stop-color="#54ECE7" />
7
+ <stop offset="1" stop-color="#658EFF" />
8
+ </linearGradient>
9
+ </defs>
10
+ </svg>