dsh-whale-usage
桥接后的新产物：把 dsh-whale-widget（桌面鲸鱼挂件）与 dsh-usage-stats（用量统计）合并为一个自包含插件，并在挂件上提供「记账 / 实时令牌 / 应用用量」配置界面。不改原插件包，对上游更新免疫。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-whale-usage@0.1.4
Whale Usage 以 dsh-whale-usage 发布，当前版本为 0.1.4。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Self-contained DSH plugin that merges two existing plugins into one, and adds an accounting / real-time-token / app-usage configuration panel on the desktop whale widget.
Does not modify the original packages — it absorbs their source logic at the bottom layer, so it is immune to upstream updates. After installing, you can maintain two fewer plugins (
dsh-whale-widgetanddsh-usage-statsmay be uninstalled).
| Absorbed source | Capabilities | Original author / repo |
|---|---|---|
dsh-whale-widget | Bottom-right DeepSeek balance whale widget (balance, peak/off-peak pricing, random quotes & sounds, ledger / token usage modes) | zhu1090093659/dsh-web-ui |
dsh-usage-stats | Per-DSH-session app usage data engine (token trends, model breakdown, activity) | lanlandeli/dsh-usage-stats |
dsh-whale-usage is the bridge & merge product: it replaces both plugins above with a single
self-contained one. © credits: CREDITS.md.
Usage config panel — usage mode / pricing / sounds / volume / peak times.
App-usage dashboard — tokens, sessions, messages, activity heatmap, top model.
Peak / off-peak pricing time periods (weekly).
Install as a normal package — do NOT link it via a junction. A junction makes dependencies fail to resolve upward (e.g.
schemastery/react) and desyncs the package name fromcordis.patch.yml; both break DSH startup.
# Recommended — install from npm (published): https://www.npmjs.com/package/dsh-whale-usage
dsh plugin --profile web add dsh-whale-usage
# or: npm install dsh-whale-usage
# From source: this repo (or after cloning it on the target machine)
dsh plugin --profile web add <absolute path to this folder>
# Or install the built tarball
dsh plugin --profile web add <path>/dsh-whale-usage-0.1.4.tgz
# Or use the convenience scripts
bash scripts/install.sh # macOS / Linux / Git Bash
powershell -ExecutionPolicy Bypass -File scripts/install.ps1 # Windows
After installing, restart DSH and hard-refresh the browser (Cmd/Ctrl+Shift+R):
Because this plugin replaces the original two, uninstall
dsh-whale-widgetanddsh-usage-statsonly after confirming this plugin works:dsh plugin --profile web remove dsh-whale-widget·dsh plugin --profile web remove dsh-usage-stats
config:
indexConcurrency: 2 # usage engine concurrency for reading historical sessions
cacheWriteDelayMs: 1000 # debounce before writing local stats
apiPath: /usage-stats/v1 # app-usage API prefix
Data is stored locally:
~/.dsh/.dshw-*.json$DSH_HOME/usage-statsdsh-whale-usage/
├── lib/ # built plugin (host: index.js, usage-host.js, whale-host.js; client: client.js)
├── assets/ # whale images / sounds
├── cordis.patch.yml # DSH bundle patch (plugin id dsh-whale-usage)
├── dsh.plugin.json # DSH plugin manifest (id / version / main / client.main)
├── package.json # npm package (name dsh-whale-usage, MIT)
├── LICENSE / CREDITS.md# MIT + upstream credits
├── README.md / README.zh.md
├── docs/ # dev notes (development.md) + screenshots
└── scripts/install.* # one-click install scripts
See docs/development.md for architecture, building the tarball
(npm pack), and re-syncing upstream fixes (lib/whale-host.js, lib/usage-host.js).
docs/development.md.中文说明见 README.zh.md。