dsh-desktop-statusbar 1.0.1 → 2.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/README.en.md CHANGED
@@ -1,120 +1,96 @@
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/anywhere-labs/dsh-desktop"><img alt="dsh desktop" src="https://img.shields.io/badge/dsh%20desktop-2.0.10-%238957e5"></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://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar"><img alt="1024Store" src="https://img.shields.io/badge/1024Store-listed-orange"></a>
11
- </p>
12
-
13
- <p align="center"><a href="README.md">中文</a> | English</p>
14
-
15
- Replaces the stats line under the composer in the DSH desktop app with a configurable status bar: pick your own fields, arrange their order, enter per-model prices, and get live cost estimates using DeepSeek's official peak/off-peak rates.
16
-
17
- > Noncommercial license ([PolyForm Noncommercial 1.0.0](LICENSE)): free to use and modify for personal use, study, teaching and nonprofit organizations; **commercial use is not permitted**.
18
-
19
- ![Status bar](docs/statusbar.en.png)
20
-
21
- ## Features
22
-
23
- - **10 optional fields**: session status (running state + peak/off-peak window), turns and steps, cache hit rate, time to first token, output speed, elapsed time, current-turn cost, session cost, balance, token count
24
- - **Custom order**: drag the handle in the settings page to reorder; unchecking a field only hides it without changing its position; "Restore defaults" returns to the factory order with every field selected
25
- - **Cost estimation**: priced with DeepSeek's official peak/off-peak rules — each call is calculated with the model and the moment it actually happened, then summed, so calls that cross time windows or models never get mixed up
26
- - **Model price library**: set your own price per model, with a "peak/off-peak pricing" toggle (unchecked means one flat price all day); adding a price later retroactively recalculates earlier calls that had been skipped
27
- - **Account balance**: reads the DeepSeek balance endpoint directly, refreshed every minute (the key stays in local memory only — never written to disk, never forwarded)
28
- - **Bilingual UI**: follows the DSH language setting
29
-
30
- ## Installation
31
-
32
- ### Option 1: plugin marketplace / npm
33
-
34
- Published on [npm](https://www.npmjs.com/package/dsh-desktop-statusbar) and listed in [DSH 1024Store](https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar) (category: UI Enhancements):
35
-
36
- ```powershell
37
- dsh plugin --profile desktop add dsh-desktop-statusbar
38
- ```
39
-
40
- Replace `desktop` with your own profile name. You can also install straight from the GitHub source (identical content):
41
-
42
- ```powershell
43
- dsh plugin --profile desktop add github:raphael-y7/dsh-desktop-statusbar
44
- ```
45
-
46
- ### Option 2: manual installation
47
-
48
- 1. Clone the project into the DSH local plugin directory:
49
-
50
- ```powershell
51
- git clone https://github.com/raphael-y7/dsh-desktop-statusbar "$env:USERPROFILE\.dsh\local-plugins\dsh-desktop-statusbar"
52
- ```
53
-
54
- 2. Install the single dependency (`zod`):
55
-
56
- ```powershell
57
- cd "$env:USERPROFILE\.dsh\local-plugins\dsh-desktop-statusbar"
58
- npm install --omit=dev
59
- ```
60
-
61
- 3. Register it with DSH's own command line (it adds the dependency declaration and the link for you):
62
-
63
- ```powershell
64
- dsh plugin --profile desktop add "$env:USERPROFILE\.dsh\local-plugins\dsh-desktop-statusbar"
65
- ```
66
-
67
- 4. Restart DSH and refresh the page.
68
-
69
- ## Usage
70
-
71
- Open **Settings → Status bar**:
72
-
73
- ![Settings page](docs/settings.en.png)
74
-
75
- - **Basics**: enable the status bar, allow wrapping
76
- - **Data fields**: check the fields you want, drag the six-dot handle on the right to reorder
77
- - **Custom model prices**: enter the prices for the models you use (per million tokens, in CNY). Click "Edit" to expand, then "Save" to commit; a new model defaults to a flat all-day price — enable "peak/off-peak pricing" when you need the split
78
-
79
- ### Billing rules
80
-
81
- Peak hours are **Beijing time, Monday to Friday, 09:00–12:00 and 14:00–18:00**; everything else is off-peak and costs half the peak rate — consistent with DeepSeek's official documentation ([Models & Pricing](https://api-docs.deepseek.com/zh-cn/quick_start/pricing), checked 2026-09-15).
82
-
83
- Public holidays and make-up workdays are **not handled separately**: the official rule only looks at the day of the week, so a holiday falling on a weekday is still billed as peak/off-peak, and a make-up workday falling on a weekend is still billed at the off-peak rate.
84
-
85
- ![Custom model prices](docs/pricing.en.png)
86
-
87
- ### Things to know
88
-
89
- Models **without a price in the library are skipped and not billed** (not a miscalculation — the price is simply unknown). Once you add the price, every earlier call of that model is recalculated into the total. The status bar fields update immediately; there is no need to reopen the session.
90
-
91
- ## Known limitations
92
-
93
- - The model name shown by "current session usage" is reported by the status bar to the plugin backend and then read by the settings page — the DSH settings page is a global slot and cannot read session projections, so this detour is unavoidable
94
- - Hiding the official stats line relies on the DSH slot contract (`conversation.composer.dock`) rather than the official component's class names, so DSH rebuilding its assets will not break it; if DSH changes the slot itself, this plugin has to follow
95
- - The session projection keeps only the latest 4000 calls; older ones no longer take part in cost recalculation
96
-
97
- ## Development
98
-
99
- ```
100
- tests/ 16 test scripts (plain Node, no browser needed)
101
- tools/ test.cjs runs them all; sync-from-plugin.cjs copies the plugin directory sources into the project
102
- ```
103
-
104
- ```powershell
105
- node tools/test.cjs
106
- ```
107
-
108
- Coverage: field placeholders and formatting, peak/off-peak boundaries across weekends and weekdays, price self-healing and recalculation, storage-key migration, metric hover, host routes, navigation icon replacement, dead-code scan.
109
-
110
- ## License
111
-
112
- This project uses the [PolyForm Noncommercial 1.0.0](LICENSE): **permitted** for personal use, research, study, teaching and hobby projects, as well as charitable, educational, public research, public safety/health, environmental and government use; **permitted** to modify and redistribute (with the license and attribution preserved); **commercial use is not permitted**.
113
-
114
- This is not an OSI-approved open source license — the source is public, but commercial use requires separate permission.
115
-
116
- ## Acknowledgements
117
-
118
- The idea comes from the DSH community project [`@bananiceee/dsh-status-bar`](https://www.npmjs.com/package/@bananiceee/dsh-status-bar) (MIT): hide the official stats line and take over with a self-built bar.
119
-
120
- This project is an **independent implementation**. Line-by-line comparison against version 0.1.10 of that project: of 1415 non-empty lines, 247 are textually identical (17.5%), and 190 of those are short lines such as `}` and `);`; **only 9 identical lines are longer than 40 characters**, all of them required DSH platform integration boilerplate (`ctx.slots.inject(...)`, `useProjection("tokenUsage")`, module wrapper scaffolding) and generic function names (`apply`, `formatTokens`, `segmentView`). Beyond those there is no shared code.
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.1.7-%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 | Highest / lowest cache hit rate |
31
+ | TTFT | Fastest / slowest first-token delay |
32
+ | TPS | 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**.
package/README.md CHANGED
@@ -1,120 +1,96 @@
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/anywhere-labs/dsh-desktop"><img alt="dsh desktop" src="https://img.shields.io/badge/dsh%20desktop-2.0.10-%238957e5"></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://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar"><img alt="1024Store" src="https://img.shields.io/badge/1024Store-listed-orange"></a>
11
- </p>
12
-
13
- <p align="center">中文 | <a href="README.en.md">English</a></p>
14
-
15
- 把 DSH 桌面端对话区底部的统计行换成一条可配置的状态栏:字段自己挑、顺序自己排、模型单价自己填,费用按官方峰谷口径实时估算。
16
-
17
- > 非商业许可([PolyForm Noncommercial 1.0.0](LICENSE)):个人使用、学习、教学、非营利组织都可以自由使用和修改,**禁止商业用途**。
18
-
19
- ![底栏效果](docs/statusbar.png)
20
-
21
- ## 功能
22
-
23
- - **10 个可选字段**:会话状态(运行状态 + 峰谷时段)、轮次与步数、缓存命中率、首字延迟、输出速度、运行用时、本次费用、会话费用、余额、Token 计数
24
- - **自定义顺序**:设置页里拖动把手调整顺序,取消勾选只隐藏、不改变位置;点「恢复默认设置」一键回到出厂顺序并全选
25
- - **费用估算**:按 DeepSeek 官方的峰谷口径计价,每条调用按**自己发生的那一刻**和**自己使用的模型**分别计算后累加,跨时段、跨模型都不会串价
26
- - **模型价格库**:可自定义每个模型的单价;支持「峰谷计价」开关(不勾选就是全天同价);补填单价后,之前没算上的历史调用会自动补算
27
- - **账户余额**:直连 DeepSeek 余额接口,每分钟刷新(key 只在本机内存中使用,不落盘、不转发)
28
- - **中英双语**:跟随 DSH 的语言设置
29
-
30
- ## 安装
31
-
32
- ### 方式一:插件市场 / npm
33
-
34
- 已发布到 [npm](https://www.npmjs.com/package/dsh-desktop-statusbar),并收录进 [DSH 1024Store](https://deepseek1024.com/plugins/Rapheal-Y7/dsh-desktop-statusbar)(分类:UI 增强):
35
-
36
- ```powershell
37
- dsh plugin --profile desktop add dsh-desktop-statusbar
38
- ```
39
-
40
- 把 `desktop` 换成你自己的 profile 名。不想走 npm 也可以直接装 GitHub 源(内容与 npm 版一致):
41
-
42
- ```powershell
43
- dsh plugin --profile desktop add github:raphael-y7/dsh-desktop-statusbar
44
- ```
45
-
46
- ### 方式二:手动安装
47
-
48
- 1. 把本项目放进 DSH 的本地插件目录:
49
-
50
- ```powershell
51
- git clone https://github.com/raphael-y7/dsh-desktop-statusbar "$env:USERPROFILE\.dsh\local-plugins\dsh-desktop-statusbar"
52
- ```
53
-
54
- 2. 安装依赖(只有一个,`zod`):
55
-
56
- ```powershell
57
- cd "$env:USERPROFILE\.dsh\local-plugins\dsh-desktop-statusbar"
58
- npm install --omit=dev
59
- ```
60
-
61
- 3. 用 DSH 自己的命令行装进 profile(它会自动补上依赖声明与链接):
62
-
63
- ```powershell
64
- dsh plugin --profile desktop add "$env:USERPROFILE\.dsh\local-plugins\dsh-desktop-statusbar"
65
- ```
66
-
67
- 4. 重启 DSH,刷新页面。
68
-
69
- ## 使用
70
-
71
- 打开 **设置 → 状态栏**:
72
-
73
- ![设置页](docs/settings.png)
74
-
75
- - **基础**:启用状态栏、允许换行
76
- - **数据字段**:勾选要显示的字段,按住右侧六点拖动排序
77
- - **自定义模型价格**:填写你使用的模型单价(每百万 tokens / 元)。点「修改」展开编辑,改完点「保存」才写入;新增的模型默认全天同价,需要区分峰谷时勾上「峰谷计价」
78
-
79
- ### 计费口径
80
-
81
- 高峰时段为**北京时间周一至周五 9:00-12:00、14:00-18:00**,其余为空闲时段,空闲价为高峰价的一半 —— 与 DeepSeek 官方文档一致([模型 & 价格](https://api-docs.deepseek.com/zh-cn/quick_start/pricing),2026-09-15 核对)。
82
-
83
- 节假日与调休**不单独处理**:官方规则只按星期几判断,所以法定假日落在工作日仍按峰谷算,调休上班的周末仍按空闲价。
84
-
85
- ![自定义模型价格](docs/pricing.png)
86
-
87
- ### 需要注意
88
-
89
- 价格库里**没有单价的模型会被跳过不计费**(不是算错,是不知道单价)。补上单价后,该模型此前所有调用会自动补算进总计。底栏的字段会即时更新,不用重开会话。
90
-
91
- ## 已知限制
92
-
93
- - 「当前会话使用」显示的模型名由底栏上报给插件后端再由设置页读取 —— DSH 的设置页是全局槽,拿不到会话投影,所以这一步绕不开
94
- - 隐藏官方状态栏依赖 DSH 的 slot 契约(`conversation.composer.dock`),不依赖官方组件的类名,因此 DSH 更新构建产物不会失效;但如果 DSH 改动 slot 本身,需要跟着改
95
- - 会话投影只保留最近 4000 条调用记录,超出后最旧的记录不再参与费用重算
96
-
97
- ## 开发
98
-
99
- ```
100
- tests/ 16 个测试脚本(纯 Node,不需要浏览器)
101
- tools/ test.cjs 跑全部测试、sync-from-plugin.cjs 把插件目录的源码同步进项目
102
- ```
103
-
104
- ```powershell
105
- node tools/test.cjs
106
- ```
107
-
108
- 测试覆盖:字段占位与格式化、峰谷边界与跨周末/工作日、价格自愈与补算、存储键迁移、指标悬停、host 路由、导航图标替换、死代码扫描。
109
-
110
- ## 许可
111
-
112
- 本项目采用 [PolyForm Noncommercial 1.0.0](LICENSE):**允许**个人使用、研究、学习、教学、业余项目,以及慈善、教育、公共研究、公共安全/健康、环保、政府机构使用;**允许**修改与再分发(需保留许可与署名);**禁止**任何商业用途。
113
-
114
- 这不是 OSI 认可的开源许可证 —— 源码公开,但商业使用需要另行获得授权。
115
-
116
- ## 致谢
117
-
118
- 思路来自 DSH 社区的 [`@bananiceee/dsh-status-bar`](https://www.npmjs.com/package/@bananiceee/dsh-status-bar)(MIT 许可):隐藏官方统计行、用自建底栏接管。
119
-
120
- 本项目为**独立实现**。与该项目的 0.1.10 版逐行比对结果:非空行 1415 行中有 247 行文字相同(17.5%),其中 190 行是 `}`、`);` 这类短行;**长于 40 字符的相同行仅 9 行**,全部是 DSH 平台集成的必要写法(`ctx.slots.inject(...)`、`useProjection("tokenUsage")`、模块包装样板等)与通用函数命名(`apply`、`formatTokens`、`segmentView` 等)。除这些之外没有相同代码片段。
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.1.7-%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):允许个人、研究、学习、教学与非营利使用,允许修改与再分发(保留署名),**禁止商业用途**。
Binary file
Binary file
Binary file
Binary file
Binary file
Binary file