ディレクトリに戻る

dsh-usage-panel

キュレーションリスト掲載メンテナンス: 活発

alfredchaos/dsh-usage-panel

DeepSeek Harness 消費統計プラグイン:設定ページに token 使用量 KPI、半年のアクティビティヒートマップ、モデル別積み上げ棒グラフとドーナツグラフ

GitHub で見る
$ npm から導入(推奨):`dsh plugin --profile web add dsh-usage-panel`

14

スター

2

フォーク

TypeScript

言語

MIT

ライセンス

2026-08-15

作成日

2026-09-15

最終プッシュ

MIT ライセンスの dsh バンドルプラグイン。セッションログからの読み取り専用トークン計帳で、フォークの二重計上防止、UTC の日別バケット、10 分の鮮度ウィンドウ、JSON / CSV エクスポートを備えます。

DSH 統合

ネイティブ実行

作者による申告

安全性監査

未監査

最終検証日

2026-11-10

ライセンス

MIT

01どんなタスクに使えるのか?

  • DeepSeek Harness が実際に消費したトークン量を、モデル・プロバイダ・日付ごとに把握する

    設定 → Usage ページ。全期間の合計、キャッシュヒット率、6 か月のアクティビティヒートマップ、日別の積み上げ棒、上位セッション、プロバイダ別バー、モデル別ドーナツ、JSON / CSV エクスポート

    プロキシを挟まずセッションログも書き換えずにコストを可視化したい DeepSeek Harness の利用者やチーム

  • 利用状況を請求・予算・表計算のために書き出す

    完全な JSON、日別 CSV、モデル別 CSV。数式インジェクション対策済みで RFC 4180 準拠、UTF-8 BOM 付き

    DSH の外でトークン消費を突き合わせる必要がある人

02DeepSeek Harness への導入方法

前提条件

  • `web` profile(ページは 設定 → Usage にあります)
  • README の実装メモでは DeepSeek Harness `0.1.5-rc.1` に対して開発

インストール手順

  1. 01

    $ npm から導入(推奨):`dsh plugin --profile web add dsh-usage-panel`

  2. 02

    GitHub から導入:`dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel`

    $ dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel

  3. 03

    ローカルの checkout から導入:`dsh plugin --profile web add ./dsh-usage-panel`

    $ dsh plugin --profile web add ./dsh-usage-panel

  4. 04

    `dsh --profile web` を再起動し、設定 → Usage を開く

    $ dsh --profile web

導入成功の確認

  • 初回表示では Usage ページがキャッシュから KPI カードとヒートマップを描画する
  • 更新ボタンは同期的な再スキャンを強制する

ロールバック

  • `dsh plugin --profile web remove dsh-usage-panel`

03DSH 統合と能力の範囲

DSH 統合ネイティブ実行

ネイティブな dsh バンドルプラグイン。`dsh plugin add` が profile のバンドル一覧へ追加し、バンドルパッチ行がホスト側を有効化します。ホスト側は共有 `/api` トランスポート上で `/api/usage-stats/overview` を提供し、クライアント側が 設定 → Usage ページを描画します。

  • 増分セッション投影

    コミット済みのセッションイベント→4 つの排他的バケット(未キャッシュ入力・出力・キャッシュ読み・キャッシュ書き)と、モデル別・プロバイダ別・日別(UTC)のマップ

    チェックポイントが永続化されるため、再起動や keep-warm でも再生コストはほぼゼロプラグインがセッションログへ書き戻すことは一切ない
  • 計上のルール

    `request/header`、`request/context`、`assistant/message`、`llm/retry`、`compaction/summary` イベント→モデル帰属は context の基準値と header の上書きで決定、ステップの usage がストリーミング中の暫定値を置換、リトライは回数として計上しトークンには含めない、圧縮の usage はそのモデルへ帰属

    reasoning トークンは output に含まれているため二重計上しない
  • フォークの二重計上防止

    永続シードプレフィックス(`inheritedEventCount`)内のイベント→フォークしたセッションが親の usage を二重計上しない

    `session/end-seed` マーカーは resume / fork の計上エポックを区切るだけ
  • 鮮度フラグ付きのキャッシュ応答

    ブラウザからのペイロード要求→10 分以内は新鮮として扱い、それより古いものは `stale` フラグ付きで即座に返しつつバックグラウンドで再スキャン

    keep-warm タイマーが 10 分ごとに再スキャンブラウザも直近の成功ペイロードを localStorage に保存(バージョンと構造を検証)

04誰に向いているのか?使うべきでない場面は?

向いている用途

  • プロキシを挟まずセッションログも書き換えずにコストを可視化したい DeepSeek Harness の利用者やチーム
  • DSH の外でトークン消費を突き合わせる必要がある人

不向きな用途

  • README には DeepSeek Harness `0.1.5-rc.1` に対して開発したと記されています。互換性マトリックスの宣言はありません。

05互換性・メンテナンス・セキュリティ上の注意

  • README には DeepSeek Harness `0.1.5-rc.1` に対して開発したと記されています。互換性マトリックスの宣言はありません。
  • 日別のバケットとエクスポートは UTC の暦日(`YYYY-MM-DD`)を使い、ヒートマップの副題にも範囲(“last 6 months · UTC”)が明示されます。
  • 投影サービスが使えない場合、読み取り専用の `sessionQuery` で全セッションログを再生する経路へ縮退し、増分経路より遅くなります。
  • 統計の対象は永続化されたセッションログのみです。請求書レベルの正確性やプロバイダの請求額との突合は README で謳われていません。
2026-08-152026-09-15v0.2.3

MIT · 継続的にメンテナンス中(最新リリース v0.2.3、2026-09-15)

06よくある質問

セッションログは書き換えられますか?

いいえ。セッション投影(使えない場合は全件再スキャン)で永続化済みのセッションログを集計するだけで、書き戻しは行いません。そのため再起動をまたいで統計が残り、プラグイン導入前のセッションも対象になります。

キャッシュヒット率の計算式は?

`cache read ÷ (uncached input + cache read + cache write)` で、読み取りと書き込みの実量も併記されます。

フォークしたセッションは二重計上されますか?

いいえ。永続シードプレフィックス(`inheritedEventCount`)内のイベントは計上されないため、フォークが親の usage を二重計上することはありません。`session/end-seed` マーカーは resume / fork の計上エポックを区切るだけです。

数値が古いと表示されるのはなぜですか?

ペイロードは 10 分間は新鮮として扱われ、それより古いものは `stale` フラグ付きで即座に返しつつバックグラウンドで再スキャンします。keep-warm タイマーは 10 分ごとに再スキャンし、更新ボタンは常に同期スキャンを強制します。

日別バケットのタイムゾーンは?

バケットもエクスポートも UTC の暦日(`YYYY-MM-DD`)です。ヒートマップの副題には “last 6 months · UTC” と範囲が明示されます。

08データと出典

  • 作者による申告github.comf77e7f4a6f15…

    The plugin aggregates persisted session logs (incrementally, via the session-projection mechanism) and never writes anyt…

  • 作者による申告github.comf77e7f4a6f15…

    The plugin ships as a bundle: `dsh plugin add` appends it to the profile's bundle list

このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-10。誤りを見つけた場合は、修正を送信してください。

🏆

dsh プラグイン おすすめ

最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。

DSH Plugins は DeepSeek Harness プラグインの独立したコミュニティ ディレクトリです。DeepSeek との提携・公認はありません。サードパーティ製プラグインはセキュリティ監査を受けていません。インストール前にソースコードをご確認ください。

DeepSeek Harnessの新着プラグインを毎週お届け。スパムはありません。