返回目录

dsh-usage

精选清单收录维护状态: 活跃

aisland-sjl/dsh-usage

持久 Dock 与可自定义的余额与用量面板:活动热力图、双通道对比,本地优先且隐私安全。

前往 GitHub
$ dsh plugin --profile web add "github:Aisland-SJL/dsh-usage"

153

星标

24

Fork

JavaScript

语言

MIT

许可证

2026-08-16

创建于

2026-10-28

最近推送

MIT 许可证、本地优先的 DeepSeek Harness(`dsh web`)插件,提供常驻余额/用量停靠面板与活动热力图,对比 DSH 与 Claude Code 通道,且消息文本绝不离开本机。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-08-30

许可证

MIT

01它能帮你完成什么?

  • Keep DeepSeek Harness balance, credit and token usage permanently visible inside the dsh web GUI

    A persistent floating dock plus a customizable balance / token-usage panel (today, month, cache hit) that glows green when healthy and folds into a balance pill on collapse

    DeepSeek Harness (dsh web) users who want their balance and token stats glanceable at all times instead of buried in logs

  • Compare DSH vs Claude Code channel usage and inspect cache hit rates locally

    A channel-share ratio bar, a 14-day usage log with per-model drilldown, and a 28-day activity heatmap

    Users who run both DeepSeek Harness and Claude Code and want a local-only dashboard of cross-channel token usage

02如何接入 DeepSeek Harness?

前置条件

  • DeepSeek Harness `web` profile with `@deepseek-ai/dsh >= 0.1.0-rc.6`

安装步骤

  1. 01

    $ dsh plugin --profile web add "github:Aisland-SJL/dsh-usage"

  2. 02

    Restart `dsh web`, then hard-refresh the browser.

    $ dsh web

验证接入成功

  • After restarting `dsh web` and hard-refreshing the browser, the dock appears at the bottom-left.

回滚

  • dsh plugin --profile web remove dsh-usage

03DSH 适配与能力边界

DSH 适配原生运行时

Installed as a `dsh web` plugin via `dsh plugin --profile web add`; runs a persistent floating dock and balance/usage panel inside the DeepSeek Harness web GUI (`dsh web`).

  • Persistent floating dock

    DeepSeek Harness web GUI (`dsh web`)→Always-visible balance pill/dock at bottom-left that mirrors your pins and folds into a tiny pill when the sidebar collapses

    Persists widget layout, accent, background and panel opacity in localStorage
  • Balance & usage panel (seven widgets)

    Credential references from `~/.dsh/.credentials.yaml`→Balance breakdown, today/month token totals, cache hit rates, channel share and usage log with per-model drilldown

  • Local-only usage API

    Loopback-only GET requests→JSON provider list, unified balance snapshot and per-day/per-model token aggregates via `/api/usage/*`

    Serves three loopback-only GET endpoints; non-loopback callers get `403`Credentials resolved server-side through Harness's credentials seam; secrets are never cached or echoed
  • Activity heatmap & dual-channel comparison

    DSH token usage and Claude Code `~/.claude/projects` JSONL→28-day × 6-band activity heatmap and a DSH-vs-Claude Code channel ratio bar

    Parses and discards Claude Code logs line-by-line; only aggregated numbers reach the cache

04适合谁?何时不该用?

适合

  • DeepSeek Harness (dsh web) users who want their balance and token stats glanceable at all times instead of buried in logs
  • Users who run both DeepSeek Harness and Claude Code and want a local-only dashboard of cross-channel token usage

不适合

  • Do not expose these loopback endpoints through a reverse proxy to LAN or the public internet.
  • Requires the DeepSeek Harness `web` profile with `@deepseek-ai/dsh >= 0.1.0-rc.6`.

05兼容性、维护与安全提示

  • Do not expose these loopback endpoints through a reverse proxy to LAN or the public internet.
  • Requires the DeepSeek Harness `web` profile with `@deepseek-ai/dsh >= 0.1.0-rc.6`.
  • Providers without a public balance API show an explicit "no public balance interface" state — the plugin never guesses a balance.
2026-08-162026-08-18v0.2.0

MIT — actively maintained (latest release v0.2.0, 2026-08-16)

06常见问题

如何在 DeepSeek Harness 中安装 dsh-usage?

运行 `dsh plugin --profile web add "github:Aisland-SJL/dsh-usage"`,然后重启 `dsh web` 并硬刷新浏览器。停靠面板会出现在左下角。需要 DeepSeek Harness 的 `web` 配置(`@deepseek-ai/dsh >= 0.1.0-rc.6`)。

dsh-usage 有什么前置要求?

需要 DeepSeek Harness 的 `web` 配置,且 `@deepseek-ai/dsh >= 0.1.0-rc.6`。各提供方的凭据(如 `DEEPSEEK_API_KEY`)存放在 `~/.dsh/.credentials.yaml`;插件只读取凭据引用,绝不直接接触密钥。

dsh-usage 如何与 DeepSeek Harness 连接?

它是一个 `dsh web` GUI 插件。它提供三个仅限 loopback 的 GET 端点,并通过 Harness 的凭据通道在服务端解析凭据;上游调用强制 HTTPS 并做 DNS 固定。它不在 agent 内部运行,而是在 `dsh web` 界面中渲染悬浮停靠面板。

dsh-usage 与普通用量统计工具有什么不同?

它专为 DeepSeek Harness 打造:镜像你的固定项(pins),对比 DSH 通道与 Claude Code 通道(解析 `~/.claude/projects` 的 JSONL),并且全程本地优先——消息文本绝不离开本机,采用隐私优先、仅 loopback 的设计。

如何更新或移除 dsh-usage?

更新用 `dsh plugin --profile web update dsh-usage`,移除用 `dsh plugin --profile web remove dsh-usage`。移除后,下次重启 `dsh web` 时停靠面板即消失。

08数据与来源

  • 作者声明github.com6b67e6d400dc…

    for the [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) Web GUI (`dsh web`).

  • 作者声明github.com6b67e6d400dc…

    Requires a DeepSeek Harness `web` profile (`@deepseek-ai/dsh >= 0.1.0-rc.6`).

  • 作者声明github.com6b67e6d400dc…

    dsh plugin --profile web add "github:Aisland-SJL/dsh-usage"

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-30。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。