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` に対して開発
インストール手順
- 01
$ npm から導入(推奨):`dsh plugin --profile web add dsh-usage-panel`
- 02
GitHub から導入:`dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel`
$ dsh plugin --profile web add github:AlfredChaos/dsh-usage-panel
- 03
ローカルの checkout から導入:`dsh plugin --profile web add ./dsh-usage-panel`
$ dsh plugin --profile web add ./dsh-usage-panel
- 04
`dsh --profile web` を再起動し、設定 → Usage を開く
$ dsh --profile web
導入成功の確認
- 初回表示では Usage ページがキャッシュから KPI カードとヒートマップを描画する
- 更新ボタンは同期的な再スキャンを強制する
ロールバック
- `dsh plugin --profile web remove dsh-usage-panel`
03DSH 統合と能力の範囲
ネイティブな 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 で謳われていません。
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” と範囲が明示されます。
07関連する DSH ワークフロー
dsh-tui
by ccch1mneyyy
Claude Code 風の全画面 TUI プラグイン。鯨トップバー、リアルタイム状態行、思考ストリーミング、Esc 二連打の巻き戻し、コンテキスト進捗バーと TPS メーター搭載。npm で一発インストール
dsh-better-sidebar
by omdsh-dev
ファイル表示・編集、ターミナル、Git、サブエージェントのページを内蔵し、サードパーティによる新規サイドバーページの登録にも対応する拡張可能なサイドバー基盤
dsh-media-desk
by woniuniuniu
DeepSeek Harness向けのメディア制作ワークスペース。ひらめきの記録から台本、表紙、画像、絵コンテの作成まで行えます。
dsh-drawai
by fourzkw
DeepSeek Harnessの右サイドバーに編集可能なキャンバスを追加します。モデルが画像を直接変更するための2つのツールも利用できます。
08データと出典
The plugin aggregates persisted session logs (incrementally, via the session-projection mechanism) and never writes anyt…
The plugin ships as a bundle: `dsh plugin add` appends it to the profile's bundle list
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-10。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
