DeepSeek Harness(dsh web)プラグイン。リクエストごとにトークン使用量を中継サイトへ帰属させ、プロジェクト別分類・残高・サブスクリプション枠・利用分析・費用見積もり・CSV/JSON エクスポートに対応。ゼロコンフィグ、認証情報不要。
DSH 統合
互換
作者による申告
安全性監査
未監査
最終検証日
2026-08-24
ライセンス
MIT
01どんなタスクに使えるのか?
DeepSeek Harness のトークン使用量を、実際にリクエストを処理した中継サイトごとに帰属させ、プロジェクト別に分類し、費用を見積もる
Web パネル「用量帳本」:中継サイト帰属、プロジェクト別使用量、残高、サブスクリプション枠、利用分析、CSV/JSON エクスポート
中継サイト(New API / Sub2API / 公式 DeepSeek)を経由してトラフィックを流す DeepSeek Harness(dsh web)利用者で、トークン支出を会計したい人
02DeepSeek Harness への導入方法
前提条件
- DeepSeek Harness の `web` profile —— `@deepseek-ai/dsh >= 0.1.0-rc.6`
- 中継サイトの `baseURL` がホストの provider 設定にすでに書かれていること(プラグインが自動検出、認証情報は不要)
インストール手順
- 01
`dsh plugin --profile web add "github:zh667/TokenLedger"` を実行する
$ dsh plugin --profile web add "github:zh667/TokenLedger"
- 02
起動中の `dsh web` を再起動してブラウザをハードリフレッシュ;サイドバー下部に「用量帳本」が表示される
$ dsh web
- 03
バージョンを固定するには完全な 40 文字の commit SHA を使う(例:`github:zh667/TokenLedger#<sha>`)
- 04
アップグレードは `dsh plugin --profile web update dsh-tokenledger`、削除は `dsh plugin --profile web remove dsh-tokenledger`
$ dsh plugin --profile web update dsh-tokenledger
導入成功の確認
作者は未記載
ロールバック
- dsh plugin --profile web remove dsh-tokenledger
03DSH 統合と能力の範囲
dsh plugin CLI 経由で DeepSeek Harness の web profile に導入し、サイドバーに「用量帳本(Usage Ledger)」の入口を登録する。要 `@deepseek-ai/dsh >= 0.1.0-rc.6`。
中継サイト帰属
ホストの provider 設定(provider ごとの baseURL)→正規化した中継オリジンごとにグループ化;同一サイトの複数キーは 1 行にまとまり、サイト名はドメインになる
プロジェクト別帰属
セッション開始時のディレクトリ→セッション開始ディレクトリごとにグループ化(登録済みワークスペースはタイトル、未登録はディレクトリ名;サブディレクトリ起点も含む)
ゼロコンフィグ検出
ホストの provider 設定→provider 設定から中継サイトを読み出す(再入力不要);`baseURL` のみ読み、認証情報は一切触らない
残高
アカウントごとに 1 本の通常キー(公式 DeepSeek / New API / Sub2API)→残高を表示;無制限キーは偽の残高ではなく「使用済み」と報告
サブスクリプション枠
残高ではなくプランを売る中継アカウント→5 時間 / 毎週 / 毎月の各ローリング枠がそれぞれ進捗バーとリセット時刻付きで表示
利用分析
記録済みの使用量→今日 / 今月 / 累計の 3 ウィンドウ、サイト・モデル別ドリルダウン、キャッシュヒット率、1 年アクティビティヒートマップ
費用見積もり
有効日で区分された料金表、階層課金、ピーク/オフピーク→推定費用を算出;価格未設定モデルは 0 ではなくダッシュ(—)を表示
エクスポートと診断
記録済みの使用量→CSV / JSON エクスポート、インデックス健全性、帰属できなかった行数を別掲
読み取り専用ループバック
ループバック GET リクエスト→2 つのエンドポイントはループバック GET のみ受け付け、peer socket アドレスで保護;プロンプト・ツール引数・応答本文は一切読まない
ループバック専用の GET エンドポイントを 2 つ公開する
04誰に向いているのか?使うべきでない場面は?
向いている用途
- 中継サイト(New API / Sub2API / 公式 DeepSeek)を経由してトラフィックを流す DeepSeek Harness(dsh web)利用者で、トークン支出を会計したい人
不向きな用途
- バージョンを固定するには完全な 40 文字の commit SHA が必須。パッケージマネージャは ref を `git ls-remote` が公開する参照リストと照合するため、短縮 SHA はどれにも合致せず `Could not resolve` で失敗します。
05互換性・メンテナンス・セキュリティ上の注意
- プラグインは API キーや上流の生レスポンスをブラウザに送信せず、プロンプト・ツール引数・応答内容も一切読みません。
- バージョンを固定するには完全な 40 文字の commit SHA が必須。パッケージマネージャは ref を `git ls-remote` が公開する参照リストと照合するため、短縮 SHA はどれにも合致せず `Could not resolve` で失敗します。
- DeepSeek Harness の web profile(`@deepseek-ai/dsh >= 0.1.0-rc.6`)が必要。パネルは `dsh web` 内にのみ表示されます。
MIT · 活発にメンテナンス中(最新リリース v0.1.0、2026-08-15)
06よくある質問
TokenLedger に API キーを入力する必要がありますか?
いいえ。プラグインはホストの provider 設定から `baseURL` だけを読んで中継サイトを検出します。その横の認証情報には一切触れず、API キーや上流の生レスポンスをブラウザに送ることもありません。
インストール時に特定のバージョンを固定するには?
spec に完全な 40 文字の commit SHA を使ってください(例:`github:zh667/TokenLedger#<sha>`)。パッケージマネージャは ref を `git ls-remote` の参照リストと照合するため、短縮 SHA はどれにも合致せず `Could not resolve` で失敗します。
残高と枠はどの中継サイトに対応していますか?
公式 DeepSeek・New API・Sub2API——アカウントごとに 1 本の通常キー。無制限キーは偽の残高ではなく「使用済み」と報告し、プランを売るアカウントはローリングの 5 時間 / 毎週 / 毎月の枠バーを表示します。
TokenLedger は何を読まず、何を送りませんか?
2 つのエンドポイントはループバック GET のみ受け付け、peer socket アドレスで保護されています。プロンプト・ツール引数・応答内容は読まず、API キーや上流の生レスポンスをブラウザに送ることもありません。
プラグインのアップグレードや削除はどうしますか?
アップグレードは `dsh plugin --profile web update dsh-tokenledger`、削除は `dsh plugin --profile web remove dsh-tokenledger` を実行してください。同じ spec を再 add すると最新の `main` を再解析します。
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データと出典
需要 DeepSeek Harness `web` profile(`@deepseek-ai/dsh >= 0.1.0-rc.6`)。
dsh plugin --profile web add "github:zh667/TokenLedger"
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-08-24。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
