dsh-cost-meter 1.9.61 → 1.9.63

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 CHANGED
@@ -1,115 +1,122 @@
1
- <h1 align="center">dsh-cost-meter</h1>
2
-
3
- <p align="center">Cost tracking and subscription quotas for DeepSeek Harness</p>
4
-
5
- <p align="center">
6
- <a href="https://github.com/Han-1413141/dsh-cost-meter/releases/latest"><img src="https://img.shields.io/badge/version-1.9.61-4176E6?style=flat-square" alt="version"></a>
7
- <a href="https://www.npmjs.com/package/dsh-cost-meter"><img src="https://img.shields.io/npm/dm/dsh-cost-meter?label=downloads&style=flat-square&color=4176E6" alt="npm monthly downloads"></a>
8
- <a href="https://github.com/Han-1413141/dsh-cost-meter/stargazers"><img src="https://img.shields.io/github/stars/Han-1413141/dsh-cost-meter?label=stars&style=flat-square&color=D9A400" alt="GitHub stars"></a>
9
- <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT license"></a>
10
- </p>
11
-
12
- <p align="center"><b>English</b> | <a href="README.zh-CN.md">简体中文</a></p>
13
- <p align="center"><a href="#installation">Install</a> · <a href="#feature-overview">Features</a> · <a href="#screenshots--walkthrough">Screenshots</a> · <a href="#documentation">Docs</a> · <a href="#community">Community</a></p>
14
-
15
- Track costs and tokens by conversation, model and call. View account balances, subscription quotas and budgets together, with separate API charges and Plan equivalents, multi-provider pricing, peak/off-peak alerts, and configurable sidebar and composer displays.
16
-
17
- <p align="center">
18
- <img src="docs/promo.en.png" alt="Whale-themed project illustration" width="1280">
19
- <br><sub>Project illustration</sub>
20
- </p>
21
-
22
- ## Installation
23
-
24
- Requires **Node.js ≥ 20, DSH 0.2.0 or later**, and pnpm available to DSH. See [host compatibility](docs/host-compatibility.md).
25
-
26
- ```sh
27
- dsh plugin --profile web add dsh-cost-meter
28
- ```
29
-
30
- Restart `dsh web` after installation or updates. **Desktop** uses its bundled CLI and the `desktop` profile; follow the [Desktop guide](docs/install-troubleshooting.md#desktop-安装与更新).
31
-
32
- <details>
33
- <summary>Windows installer / pinned version</summary>
34
-
35
- The PowerShell installer checks pnpm and Git and uses the `web` profile by default:
36
-
37
- ```powershell
38
- irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.9.61/install.ps1 | iex
39
- ```
40
-
41
- Install a pinned Git tag:
42
-
43
- ```sh
44
- dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.9.61
45
- ```
46
-
47
- See [installation and updates](docs/install.en.md) for uninstalling or installing without Git.
48
-
49
- </details>
50
-
51
- Current release **v1.9.61**: [release notes](docs/update-notes-1.9.61.md#english) · [troubleshooting](docs/install-troubleshooting.md)
52
-
53
- ## Feature overview
54
-
55
- - **Conversation and call costs**: Cost entries in the composer, header and each turn. Inspect rates, tokens, recorded inputs and tool results, including parent/subagent cost attribution.
56
- - **Statistics and exports**: Filter by date, provider and model; inspect trends, rankings, cache hit rates and token heatmaps. Export one or all retained conversations, and view local-model API-equivalent costs separately.
57
- - **Quotas and balances**: Codex / ChatGPT, OpenCode Go, MiniMax, Claude, GLM, Kimi, Qianwen, MiMo, OpenDesign and other plans, plus CLIProxyAPI multi-account quotas and custom HTTP balance sources.
58
- - **Multi-provider pricing**: Automatic model matching, editable rates and multipliers, and peak/off-peak tiers. Sync DeepSeek official prices and the OpenRouter catalog; separate API charges from Plan equivalents.
59
- - **Budgets and pricing alerts**: Daily, monthly, cumulative or custom-date budgets. Peak/off-peak schedules and countdowns, with popup and system notifications before a change.
60
- - **Display and history**: Configure sidebar cards, composer entries, quota strips and turn costs. Chinese/English UI, dark themes and mobile layouts; historical imports, retention and storage controls.
61
-
62
- See [features and screenshots](docs/features.en.md) for entry points and [model and plan support](docs/model-and-plan-adaptation.en.md) for providers and credentials.
63
-
64
- ## Screenshots & walkthrough
65
-
66
- | Cost trends and model ranking | Conversation cost distribution |
67
- |---|---|
68
- | [![Cost trends](docs/images/statistics.png)](docs/images/statistics.png) | [![Conversation treemap](docs/images/treemap.png)](docs/images/treemap.png) |
69
-
70
- | Subscription quotas and balances | Display settings and interactive preview |
71
- |---|---|
72
- | [![Quotas and balances](docs/images/quotas.png)](docs/images/quotas.png) | [![Display settings](docs/images/display.png)](docs/images/display.png) |
73
-
74
- Select an image for full resolution. [More views: call details, prices, history, dark themes and mobile](docs/features.en.md).
75
-
76
- ## Documentation
77
-
78
- | Topic | Guides |
79
- |---|---|
80
- | Setup and use | [Install, update and uninstall](docs/install.en.md) · [Troubleshooting](docs/install-troubleshooting.md) · [Display settings](docs/display-settings.md) |
81
- | Statistics and billing | [Billing rules](docs/billing.en.md) · [Statistics and details](docs/billing-statistics.md#english) · [Models and plans](docs/model-and-plan-adaptation.en.md) · [Peak schedules](docs/provider-peak-schedules.md) |
82
- | Balances and quotas | [Credentials](docs/balance-credentials.md) · [Custom balances](docs/custom-balance-sources.en.md) · [Gateway quotas](docs/cliproxyapi-quota.md) · [Plan estimates](docs/token-plan-stats.md#english) |
83
- | History and storage | [Retention and cleanup](docs/pricing-history-storage.md) · [Repricing](docs/model-history-repricing.md) · [External usage](docs/external-usage.md) · [Ledger recovery](docs/ledger-lock-recovery.md#english) |
84
- | Development | [Architecture and development](docs/architecture.en.md) · [Contributing](CONTRIBUTING.md) · [Host compatibility](docs/host-compatibility.md) |
85
- | Releases | [Update history](docs/UPDATE-HISTORY.md) · [CHANGELOG](CHANGELOG.md) |
86
-
87
- ## Community
88
-
89
- [Open an issue](https://github.com/Han-1413141/dsh-cost-meter/issues) with plugin and host versions, reproduction steps and relevant logs. The WeChat group is available for usage questions and feature discussions.
90
-
91
- <p align="center">
92
- <a href="docs/community-wechat.png"><img src="docs/community-wechat.png" alt="WeChat community QR code" width="280"></a>
93
- </p>
94
-
95
- ## Contributors
96
-
97
- Thanks to everyone who contributes reports, ideas, documentation and code.
98
-
99
- <a href="https://github.com/Han-1413141/dsh-cost-meter/graphs/contributors">
100
- <img src="https://contrib.rocks/image?repo=Han-1413141/dsh-cost-meter" alt="Contributors">
101
- </a>
102
-
103
- ## Star History
104
-
105
- <a href="https://www.star-history.com/?repos=han-1413141%2Fdsh-cost-meter&type=timeline&legend=bottom-right">
106
- <picture>
107
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&theme=dark&legend=bottom-right" />
108
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&legend=bottom-right" />
109
- <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&legend=bottom-right" />
110
- </picture>
111
- </a>
112
-
113
- ## License
114
-
115
- [MIT](LICENSE) © 2026 dsh-cost-meter contributors
1
+ <h1 align="center">dsh-cost-meter</h1>
2
+
3
+ <p align="center">Cost tracking and subscription quotas for DeepSeek Harness</p>
4
+
5
+ <p align="center">
6
+ <a href="https://github.com/Han-1413141/dsh-cost-meter/releases/latest"><img src="https://img.shields.io/badge/version-1.9.63-4176E6?style=flat-square" alt="version"></a>
7
+ <a href="https://www.npmjs.com/package/dsh-cost-meter"><img src="https://img.shields.io/npm/dm/dsh-cost-meter?label=downloads&style=flat-square&color=4176E6" alt="npm monthly downloads"></a>
8
+ <a href="https://github.com/Han-1413141/dsh-cost-meter/stargazers"><img src="https://img.shields.io/github/stars/Han-1413141/dsh-cost-meter?label=stars&style=flat-square&color=D9A400" alt="GitHub stars"></a>
9
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT license"></a>
10
+ </p>
11
+
12
+ <p align="center"><b>English</b> | <a href="README.zh-CN.md">简体中文</a></p>
13
+ <p align="center"><a href="#installation">Install</a> · <a href="#feature-overview">Features</a> · <a href="#screenshots--walkthrough">Screenshots</a> · <a href="#documentation">Docs</a> · <a href="#community">Community</a></p>
14
+
15
+ Track costs and tokens by conversation, model and call. View account balances, subscription quotas and budgets together, with separate API charges and Plan equivalents, multi-provider pricing, peak/off-peak alerts, and configurable sidebar and composer displays.
16
+
17
+ <p align="center">
18
+ <img src="docs/promo.en.png" alt="Whale-themed project illustration" width="1280">
19
+ <br><sub>Project illustration</sub>
20
+ </p>
21
+
22
+ <picture>
23
+ <source media="(prefers-color-scheme: dark)" srcset="docs/images/conversation-dark.png">
24
+ <img src="docs/images/conversation-light.png" alt="Full conversation view with costs, subscription quotas and account balance" width="1280">
25
+ </picture>
26
+
27
+ <p align="center"><sub>Full conversation view in light or dark mode to match your theme. Screenshots use example data.</sub></p>
28
+
29
+ ## Installation
30
+
31
+ Requires **Node.js ≥ 20, DSH 0.2.0 or later**, and pnpm available to DSH. See [host compatibility](docs/host-compatibility.md).
32
+
33
+ ```sh
34
+ dsh plugin --profile web add dsh-cost-meter
35
+ ```
36
+
37
+ Restart `dsh web` after installation or updates. **Desktop** uses its bundled CLI and the `desktop` profile; follow the [Desktop guide](docs/install-troubleshooting.md#desktop-安装与更新).
38
+
39
+ <details>
40
+ <summary>Windows installer / pinned version</summary>
41
+
42
+ The PowerShell installer checks pnpm and Git and uses the `web` profile by default:
43
+
44
+ ```powershell
45
+ irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.9.63/install.ps1 | iex
46
+ ```
47
+
48
+ Install a pinned Git tag:
49
+
50
+ ```sh
51
+ dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.9.63
52
+ ```
53
+
54
+ See [installation and updates](docs/install.en.md) for uninstalling or installing without Git.
55
+
56
+ </details>
57
+
58
+ Current release **v1.9.63**: [release notes](docs/update-notes-1.9.63.md#english) · [troubleshooting](docs/install-troubleshooting.md)
59
+
60
+ ## Feature overview
61
+
62
+ - **Conversation and call costs**: Cost entries in the composer, header and each turn. Inspect rates, tokens, recorded inputs and tool results, including parent/subagent cost attribution.
63
+ - **Statistics and exports**: Filter by date, provider and model; inspect trends, rankings, cache hit rates and token heatmaps. Export one or all retained conversations, and view local-model API-equivalent costs separately.
64
+ - **Quotas and balances**: Codex / ChatGPT, OpenCode Go, MiniMax, Claude, GLM, Kimi, Qianwen, MiMo, OpenDesign and other plans, plus CLIProxyAPI multi-account quotas and custom HTTP balance sources.
65
+ - **Multi-provider pricing**: Automatic model matching, editable rates and multipliers, and peak/off-peak tiers. Sync DeepSeek official prices and the OpenRouter catalog; separate API charges from Plan equivalents.
66
+ - **Budgets and pricing alerts**: Daily, monthly, cumulative or custom-date budgets. Peak/off-peak schedules and countdowns, with popup and system notifications before a change.
67
+ - **Display and history**: Configure sidebar cards, composer entries, quota strips and turn costs. Chinese/English UI, dark themes and mobile layouts; historical imports, retention and storage controls.
68
+
69
+ See [features and screenshots](docs/features.en.md) for entry points and [model and plan support](docs/model-and-plan-adaptation.en.md) for providers and credentials.
70
+
71
+ ## Screenshots & walkthrough
72
+
73
+ | Cost trends and model ranking | Conversation cost distribution |
74
+ |---|---|
75
+ | [![Cost trends](docs/images/statistics.png)](docs/images/statistics.png) | [![Conversation treemap](docs/images/treemap.png)](docs/images/treemap.png) |
76
+
77
+ | Subscription quotas and balances | Display settings and interactive preview |
78
+ |---|---|
79
+ | [![Quotas and balances](docs/images/quotas.png)](docs/images/quotas.png) | [![Display settings](docs/images/display.png)](docs/images/display.png) |
80
+
81
+ Select an image for full resolution. [More views: call details, prices, history, dark themes and mobile](docs/features.en.md).
82
+
83
+ ## Documentation
84
+
85
+ | Topic | Guides |
86
+ |---|---|
87
+ | Setup and use | [Install, update and uninstall](docs/install.en.md) · [Troubleshooting](docs/install-troubleshooting.md) · [Display settings](docs/display-settings.md) |
88
+ | Statistics and billing | [Billing rules](docs/billing.en.md) · [Statistics and details](docs/billing-statistics.md#english) · [Models and plans](docs/model-and-plan-adaptation.en.md) · [Peak schedules](docs/provider-peak-schedules.md) |
89
+ | Balances and quotas | [Credentials](docs/balance-credentials.md) · [Custom balances](docs/custom-balance-sources.en.md) · [Gateway quotas](docs/cliproxyapi-quota.md) · [Plan estimates](docs/token-plan-stats.md#english) |
90
+ | History and storage | [Retention and cleanup](docs/pricing-history-storage.md) · [Repricing](docs/model-history-repricing.md) · [External usage](docs/external-usage.md) · [Ledger recovery](docs/ledger-lock-recovery.md#english) |
91
+ | Development | [Architecture and development](docs/architecture.en.md) · [Contributing](CONTRIBUTING.md) · [Host compatibility](docs/host-compatibility.md) |
92
+ | Releases | [Update history](docs/UPDATE-HISTORY.md) · [CHANGELOG](CHANGELOG.md) |
93
+
94
+ ## Community
95
+
96
+ [Open an issue](https://github.com/Han-1413141/dsh-cost-meter/issues) with plugin and host versions, reproduction steps and relevant logs. The WeChat group is available for usage questions and feature discussions.
97
+
98
+ <p align="center">
99
+ <a href="docs/community-wechat.png"><img src="docs/community-wechat.png" alt="WeChat community QR code" width="280"></a>
100
+ </p>
101
+
102
+ ## Contributors
103
+
104
+ Thanks to everyone who contributes reports, ideas, documentation and code.
105
+
106
+ <a href="https://github.com/Han-1413141/dsh-cost-meter/graphs/contributors">
107
+ <img src="https://contrib.rocks/image?repo=Han-1413141/dsh-cost-meter" alt="Contributors">
108
+ </a>
109
+
110
+ ## Star History
111
+
112
+ <a href="https://www.star-history.com/?repos=han-1413141%2Fdsh-cost-meter&type=timeline&legend=bottom-right">
113
+ <picture>
114
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&theme=dark&legend=bottom-right" />
115
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&legend=bottom-right" />
116
+ <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&legend=bottom-right" />
117
+ </picture>
118
+ </a>
119
+
120
+ ## License
121
+
122
+ [MIT](LICENSE) © 2026 dsh-cost-meter contributors
package/README.zh-CN.md CHANGED
@@ -1,115 +1,122 @@
1
- <h1 align="center">dsh-cost-meter</h1>
2
-
3
- <p align="center">DeepSeek Harness 费用统计与订阅额度插件</p>
4
-
5
- <p align="center">
6
- <a href="https://github.com/Han-1413141/dsh-cost-meter/releases/latest"><img src="https://img.shields.io/badge/version-1.9.61-4176E6?style=flat-square" alt="version"></a>
7
- <a href="https://www.npmjs.com/package/dsh-cost-meter"><img src="https://img.shields.io/npm/dm/dsh-cost-meter?label=downloads&style=flat-square&color=4176E6" alt="npm monthly downloads"></a>
8
- <a href="https://github.com/Han-1413141/dsh-cost-meter/stargazers"><img src="https://img.shields.io/github/stars/Han-1413141/dsh-cost-meter?label=stars&style=flat-square&color=D9A400" alt="GitHub stars"></a>
9
- <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT license"></a>
10
- </p>
11
-
12
- <p align="center"><a href="README.md">English</a> | <b>简体中文</b></p>
13
- <p align="center"><a href="#安装">安装</a> · <a href="#功能总览">功能</a> · <a href="#图文演示">界面</a> · <a href="#文档">文档</a> · <a href="#交流与反馈">交流</a></p>
14
-
15
- 按会话、模型和调用查看费用与 Token 用量,集中显示账户余额、套餐额度和预算。支持 API 费用与 Plan 等值费用分开统计、多厂商定价、峰谷提醒,以及侧栏和输入区的独立显示设置。
16
-
17
- <p align="center">
18
- <img src="docs/promo.png" alt="鲸鱼主题项目宣传图" width="1280">
19
- <br><sub>项目宣传图</sub>
20
- </p>
21
-
22
- ## 安装
23
-
24
- 需要 **Node.js ≥ 20、DSH 0.2.0 或更新版本**,以及 DSH 可用的 pnpm。[宿主兼容记录](docs/host-compatibility.md)
25
-
26
- ```sh
27
- dsh plugin --profile web add dsh-cost-meter
28
- ```
29
-
30
- 安装或更新后重启 `dsh web`。**Desktop** 使用应用自带 CLI 和 `desktop` Profile,见 [Desktop 安装与更新](docs/install-troubleshooting.md#desktop-安装与更新)。
31
-
32
- <details>
33
- <summary>Windows 一键安装 / 固定版本安装</summary>
34
-
35
- PowerShell 脚本自动检查 pnpm 和 Git,默认安装到 `web` Profile:
36
-
37
- ```powershell
38
- irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.9.61/install.ps1 | iex
39
- ```
40
-
41
- 固定 Git tag 安装:
42
-
43
- ```sh
44
- dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.9.61
45
- ```
46
-
47
- 更新、卸载及无 Git 的安装方法见[安装说明](docs/install.md)。
48
-
49
- </details>
50
-
51
- 当前版本 **v1.9.61**:[更新说明](docs/update-notes-1.9.61.md#中文) · [安装排障](docs/install-troubleshooting.md)
52
-
53
- ## 功能总览
54
-
55
- - **费用明细**:输入区、标题栏和每轮回复显示费用;展开查看单价、Token、输入内容及工具结果。支持父子代理费用归属。
56
- - **费用统计**:按日期、渠道和模型筛选,查看趋势、模型排行、缓存命中率与 Token 热图;导出单个或全部会话记录;单独查看本地模型的 API 等值费用。
57
- - **套餐额度**:支持 Codex / ChatGPT、OpenCode Go、MiniMax、Claude、GLM、Kimi、千问、MiMo、OpenDesign 等;提供 CLIProxyAPI 多账号额度及自定义 HTTP 余额查询。
58
- - **模型定价**:自动匹配模型价格,编辑单价、倍率及峰谷档位;同步 DeepSeek 官方价格和 OpenRouter 目录。API 与 Plan 分开统计。
59
- - **预算提醒**:按日、月、累计或自定义日期设预算;显示峰谷时段和倒计时,支持切换前弹窗与系统通知。
60
- - **显示与历史**:自定义侧栏、输入区、额度横条和每轮费用;支持中英双语、深色主题和手机端。可导入历史、设置保留范围及管理存储。
61
-
62
- 功能入口和配置见[功能与截图](docs/features.md);厂商、模型及凭据要求见[适配说明](docs/model-and-plan-adaptation.md)。
63
-
64
- ## 图文演示
65
-
66
- | 费用趋势与模型排行 | 单个会话费用分布 |
67
- |---|---|
68
- | [![费用趋势与模型排行](docs/images/statistics.png)](docs/images/statistics.png) | [![会话费用矩形图](docs/images/treemap.png)](docs/images/treemap.png) |
69
-
70
- | 套餐额度与余额 | 显示设置与交互预览 |
71
- |---|---|
72
- | [![套餐额度与余额](docs/images/quotas.png)](docs/images/quotas.png) | [![显示设置与交互预览](docs/images/display.png)](docs/images/display.png) |
73
-
74
- 点击图片查看大图。[更多界面:调用详情、价格、历史、深色与手机端](docs/features.md)
75
-
76
- ## 文档
77
-
78
- | 主题 | 文档 |
79
- |---|---|
80
- | 安装与使用 | [安装、更新、卸载](docs/install.md) · [安装排障](docs/install-troubleshooting.md) · [显示设置](docs/display-settings.md) |
81
- | 统计与计费 | [计费规则](docs/billing.md) · [统计与明细](docs/billing-statistics.md#简体中文) · [模型定价与适配](docs/model-and-plan-adaptation.md) · [峰谷时段](docs/provider-peak-schedules.md) |
82
- | 余额与套餐 | [凭据来源](docs/balance-credentials.md) · [自定义余额](docs/custom-balance-sources.md) · [网关额度](docs/cliproxyapi-quota.md) · [套餐用量估算](docs/token-plan-stats.md) |
83
- | 历史与存储 | [保留与清理](docs/pricing-history-storage.md) · [历史重定价](docs/model-history-repricing.md) · [外部用量](docs/external-usage.md) · [账本恢复](docs/ledger-lock-recovery.md#简体中文) |
84
- | 开发与贡献 | [架构与开发](docs/architecture.md) · [贡献指南](CONTRIBUTING.md) · [宿主兼容](docs/host-compatibility.md) |
85
- | 版本记录 | [更新历史](docs/UPDATE-HISTORY.md) · [CHANGELOG](CHANGELOG.md) |
86
-
87
- ## 交流与反馈
88
-
89
- [提交 issue](https://github.com/Han-1413141/dsh-cost-meter/issues) 时请附插件版本、宿主版本、复现步骤和相关日志。使用交流与功能讨论可加入微信群。
90
-
91
- <p align="center">
92
- <a href="docs/community-wechat.png"><img src="docs/community-wechat.png" alt="微信交流群二维码" width="280"></a>
93
- </p>
94
-
95
- ## 贡献者
96
-
97
- 感谢社区的问题报告、功能建议、文档和代码贡献。
98
-
99
- <a href="https://github.com/Han-1413141/dsh-cost-meter/graphs/contributors">
100
- <img src="https://contrib.rocks/image?repo=Han-1413141/dsh-cost-meter" alt="Contributors">
101
- </a>
102
-
103
- ## Star 增长记录
104
-
105
- <a href="https://www.star-history.com/?repos=han-1413141%2Fdsh-cost-meter&type=timeline&legend=bottom-right">
106
- <picture>
107
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&theme=dark&legend=bottom-right" />
108
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&legend=bottom-right" />
109
- <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&legend=bottom-right" />
110
- </picture>
111
- </a>
112
-
113
- ## License
114
-
115
- [MIT](LICENSE) © 2026 dsh-cost-meter contributors
1
+ <h1 align="center">dsh-cost-meter</h1>
2
+
3
+ <p align="center">DeepSeek Harness 费用统计与订阅额度插件</p>
4
+
5
+ <p align="center">
6
+ <a href="https://github.com/Han-1413141/dsh-cost-meter/releases/latest"><img src="https://img.shields.io/badge/version-1.9.63-4176E6?style=flat-square" alt="version"></a>
7
+ <a href="https://www.npmjs.com/package/dsh-cost-meter"><img src="https://img.shields.io/npm/dm/dsh-cost-meter?label=downloads&style=flat-square&color=4176E6" alt="npm monthly downloads"></a>
8
+ <a href="https://github.com/Han-1413141/dsh-cost-meter/stargazers"><img src="https://img.shields.io/github/stars/Han-1413141/dsh-cost-meter?label=stars&style=flat-square&color=D9A400" alt="GitHub stars"></a>
9
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="MIT license"></a>
10
+ </p>
11
+
12
+ <p align="center"><a href="README.md">English</a> | <b>简体中文</b></p>
13
+ <p align="center"><a href="#安装">安装</a> · <a href="#功能总览">功能</a> · <a href="#图文演示">界面</a> · <a href="#文档">文档</a> · <a href="#交流与反馈">交流</a></p>
14
+
15
+ 按会话、模型和调用查看费用与 Token 用量,集中显示账户余额、套餐额度和预算。支持 API 费用与 Plan 等值费用分开统计、多厂商定价、峰谷提醒,以及侧栏和输入区的独立显示设置。
16
+
17
+ <p align="center">
18
+ <img src="docs/promo.png" alt="鲸鱼主题项目宣传图" width="1280">
19
+ <br><sub>项目宣传图</sub>
20
+ </p>
21
+
22
+ <picture>
23
+ <source media="(prefers-color-scheme: dark)" srcset="docs/images/conversation-dark.png">
24
+ <img src="docs/images/conversation-light.png" alt="完整会话界面,包含会话费用、套餐额度与账户余额" width="1280">
25
+ </picture>
26
+
27
+ <p align="center"><sub>完整会话界面,随主题切换浅色与深色。截图使用示例数据。</sub></p>
28
+
29
+ ## 安装
30
+
31
+ 需要 **Node.js ≥ 20、DSH 0.2.0 或更新版本**,以及 DSH 可用的 pnpm。[宿主兼容记录](docs/host-compatibility.md)
32
+
33
+ ```sh
34
+ dsh plugin --profile web add dsh-cost-meter
35
+ ```
36
+
37
+ 安装或更新后重启 `dsh web`。**Desktop** 使用应用自带 CLI 和 `desktop` Profile,见 [Desktop 安装与更新](docs/install-troubleshooting.md#desktop-安装与更新)。
38
+
39
+ <details>
40
+ <summary>Windows 一键安装 / 固定版本安装</summary>
41
+
42
+ PowerShell 脚本自动检查 pnpm 和 Git,默认安装到 `web` Profile:
43
+
44
+ ```powershell
45
+ irm https://raw.githubusercontent.com/Han-1413141/dsh-cost-meter/v1.9.63/install.ps1 | iex
46
+ ```
47
+
48
+ 固定 Git tag 安装:
49
+
50
+ ```sh
51
+ dsh plugin --profile web add github:Han-1413141/dsh-cost-meter#v1.9.63
52
+ ```
53
+
54
+ 更新、卸载及无 Git 的安装方法见[安装说明](docs/install.md)。
55
+
56
+ </details>
57
+
58
+ 当前版本 **v1.9.63**:[更新说明](docs/update-notes-1.9.63.md#中文) · [安装排障](docs/install-troubleshooting.md)
59
+
60
+ ## 功能总览
61
+
62
+ - **费用明细**:输入区、标题栏和每轮回复显示费用;展开查看单价、Token、输入内容及工具结果。支持父子代理费用归属。
63
+ - **费用统计**:按日期、渠道和模型筛选,查看趋势、模型排行、缓存命中率与 Token 热图;导出单个或全部会话记录;单独查看本地模型的 API 等值费用。
64
+ - **套餐额度**:支持 Codex / ChatGPT、OpenCode Go、MiniMax、Claude、GLM、Kimi、千问、MiMo、OpenDesign 等;提供 CLIProxyAPI 多账号额度及自定义 HTTP 余额查询。
65
+ - **模型定价**:自动匹配模型价格,编辑单价、倍率及峰谷档位;同步 DeepSeek 官方价格和 OpenRouter 目录。API 与 Plan 分开统计。
66
+ - **预算提醒**:按日、月、累计或自定义日期设预算;显示峰谷时段和倒计时,支持切换前弹窗与系统通知。
67
+ - **显示与历史**:自定义侧栏、输入区、额度横条和每轮费用;支持中英双语、深色主题和手机端。可导入历史、设置保留范围及管理存储。
68
+
69
+ 功能入口和配置见[功能与截图](docs/features.md);厂商、模型及凭据要求见[适配说明](docs/model-and-plan-adaptation.md)。
70
+
71
+ ## 图文演示
72
+
73
+ | 费用趋势与模型排行 | 单个会话费用分布 |
74
+ |---|---|
75
+ | [![费用趋势与模型排行](docs/images/statistics.png)](docs/images/statistics.png) | [![会话费用矩形图](docs/images/treemap.png)](docs/images/treemap.png) |
76
+
77
+ | 套餐额度与余额 | 显示设置与交互预览 |
78
+ |---|---|
79
+ | [![套餐额度与余额](docs/images/quotas.png)](docs/images/quotas.png) | [![显示设置与交互预览](docs/images/display.png)](docs/images/display.png) |
80
+
81
+ 点击图片查看大图。[更多界面:调用详情、价格、历史、深色与手机端](docs/features.md)
82
+
83
+ ## 文档
84
+
85
+ | 主题 | 文档 |
86
+ |---|---|
87
+ | 安装与使用 | [安装、更新、卸载](docs/install.md) · [安装排障](docs/install-troubleshooting.md) · [显示设置](docs/display-settings.md) |
88
+ | 统计与计费 | [计费规则](docs/billing.md) · [统计与明细](docs/billing-statistics.md#简体中文) · [模型定价与适配](docs/model-and-plan-adaptation.md) · [峰谷时段](docs/provider-peak-schedules.md) |
89
+ | 余额与套餐 | [凭据来源](docs/balance-credentials.md) · [自定义余额](docs/custom-balance-sources.md) · [网关额度](docs/cliproxyapi-quota.md) · [套餐用量估算](docs/token-plan-stats.md) |
90
+ | 历史与存储 | [保留与清理](docs/pricing-history-storage.md) · [历史重定价](docs/model-history-repricing.md) · [外部用量](docs/external-usage.md) · [账本恢复](docs/ledger-lock-recovery.md#简体中文) |
91
+ | 开发与贡献 | [架构与开发](docs/architecture.md) · [贡献指南](CONTRIBUTING.md) · [宿主兼容](docs/host-compatibility.md) |
92
+ | 版本记录 | [更新历史](docs/UPDATE-HISTORY.md) · [CHANGELOG](CHANGELOG.md) |
93
+
94
+ ## 交流与反馈
95
+
96
+ [提交 issue](https://github.com/Han-1413141/dsh-cost-meter/issues) 时请附插件版本、宿主版本、复现步骤和相关日志。使用交流与功能讨论可加入微信群。
97
+
98
+ <p align="center">
99
+ <a href="docs/community-wechat.png"><img src="docs/community-wechat.png" alt="微信交流群二维码" width="280"></a>
100
+ </p>
101
+
102
+ ## 贡献者
103
+
104
+ 感谢社区的问题报告、功能建议、文档和代码贡献。
105
+
106
+ <a href="https://github.com/Han-1413141/dsh-cost-meter/graphs/contributors">
107
+ <img src="https://contrib.rocks/image?repo=Han-1413141/dsh-cost-meter" alt="Contributors">
108
+ </a>
109
+
110
+ ## Star 增长记录
111
+
112
+ <a href="https://www.star-history.com/?repos=han-1413141%2Fdsh-cost-meter&type=timeline&legend=bottom-right">
113
+ <picture>
114
+ <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&theme=dark&legend=bottom-right" />
115
+ <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&legend=bottom-right" />
116
+ <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=han-1413141/dsh-cost-meter&type=timeline&legend=bottom-right" />
117
+ </picture>
118
+ </a>
119
+
120
+ ## License
121
+
122
+ [MIT](LICENSE) © 2026 dsh-cost-meter contributors