MIT ライセンスの既定読み取り専用 DSH 解析プラグイン。セッション履歴からコスト / トークン / ツール呼び出しのレポートを生成し、決定論的な診断・協業レビュー・PNG / HTML / PDF 書き出しに対応します。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-09-06
ライセンス
MIT
01どんなタスクに使えるのか？
DSH セッション履歴を日報 / 週報 / 月報 / 年報 / カスタム期間の分析レポートに集計する
コスト、トークン、ツール呼び出し、リトライバースト、危険操作、シークレットパターン存在検知を含む決定論的診断
エージェントがセッション・期間ごとに何をし、いくら消費したかを見たい DSH ユーザー
共有や保管用に DeepTrace レポートを書き出す
Web パネルレポート、PNG、印刷用 HTML ページ、PDF（A4）。`whale_report` ツールは markdown も返す
エージェントのコストや協業をレビュー、あるいは期間レポートを保管するチーム
02DeepSeek Harness への導入方法
前提条件
- DSH（DeepSeek Harness、web）環境。公式互換ベースラインは DSH 0.1.1-rc.2（peer 範囲 `>=0.1.1-rc.2 <0.2.0`）
- （任意）DSH-better-sidebar を入れると + メニューに深跡 Tab が表示される。未導入時は右下のフローティングボタンが代替
インストール手順
- 01
`dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"` を実行し dsh web に登録（推奨・全機能）
$ dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"
- 02
$ dsh web を再起動してホストコードを有効化。クライアント bundle はプラグインと共に自動更新される
- 03
（依存のみ）`npm install dsh-whale-report@0.6.1`——パッケージを入れるだけで、DSH プラグインとしては登録されない
$ npm install dsh-whale-report@0.6.1
導入成功の確認
- DSH web サイドバーの + メニューから深跡 Tab を開く（better-sidebar 未導入時は右下のフローティングボタン）
ロールバック
- dsh プラグインマネージャーからアンインストール。データは公式シーム経由で、アンインストールはクリーン
03DSH 統合と能力の範囲
dsh web に `dsh plugin --profile web add` で登録する DSH プラグイン（公式シーム ctx.sessionQuery + storage domain）
期間レポート（6 プリセット）
DSH セッションイベントログ（公式シーム ctx.sessionQuery + storage domain）→日報 / 週報 / 月報 / 年報 / 滾動 24h / カスタム期間レポート。前期比 ▲/▼ 付き
コスト・トークン計算（読み取り専用）
セッションイベント→コスト（公式の朝夕値段・実効日ベース）、トークン、ツール呼び出し、リトライバースト、危険操作、シークレットパターン存在検知
既定読み取り専用；制御された Apply シーム（shell.timeoutMs）
決定論的診断（Repeated Tool Failure / Retry Waste / Peak Cost）→提案 + 証拠 + 検証計画。承認後は `shell.timeoutMs` のみを 1 件変更し、VERIFIED / NOT IMPROVED / INCONCLUSIVE を判定
ユーザー承認後にのみ `shell.timeoutMs` 設定を書き込む。他の設定は自動変更しない書き出し（Web / PNG / HTML / PDF）
canonical レポート→Web レポート、PNG（メイン報）、印刷用 HTML ページ、A4 PDF。`whale_report` ツールは markdown を返す
04誰に向いているのか？使うべきでない場面は？
向いている用途
- エージェントがセッション・期間ごとに何をし、いくら消費したかを見たい DSH ユーザー
- エージェントのコストや協業をレビュー、あるいは期間レポートを保管するチーム
不向きな用途
- コストは推定値であり請求書ではない——公式の朝夕値段と実効日から計算され、最終は DeepSeek Platform の請求に準じます。
05互換性・メンテナンス・セキュリティ上の注意
- コストは推定値であり請求書ではない——公式の朝夕値段と実効日から計算され、最終は DeepSeek Platform の請求に準じます。
- Apply が対応するのは `shell.timeoutMs` のみ。単一の、ユーザー承認済み・復元可能な変更。任意の config / shell / code mutation は不可、自動ロールバックもセルフヒーリングもしません。
- 既定は読み取り専用。セッション履歴は書き換えない。シークレットスキャンはパターンラベルのみ記録（原文非保存）。修正シグナルはカテゴリと件数のみ保存。
readme_verified
06よくある質問
DeepSeek Harness へはどう導入しますか？
`dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"` を実行して dsh web を再起動すれば、フル機能の DSH プラグインとして登録されます。npm のみの導入はエンジンだけで、Web UI や `whale_report` ツールは含まれません。
DeepTrace は何を計測しますか？
セッションイベントログをコスト（公式の朝夕値段・実効日ベース）、トークン、ツール呼び出し、リトライバースト、危険操作、シークレットパターン存在検知（原文非保存）、セッション詳細に集計し、6 種の期間に対応します。
安全ですか、データを変更しますか？
既定は読み取り専用でセッション履歴を書き換えません。書き込めるのはユーザー承認済みの `shell.timeoutMs` 調整だけで、自動ロールバックもセルフヒーリングもしません。
コストの数値は正確ですか？
いいえ——コストは公式の朝夕値段と実効日からの推定であり、プロバイダーの請求書ではありません。最終は DeepSeek Platform の請求に準じます。
レポートをどう書き出しますか？
パネル内は完全な Web レポートです。メイン報は PNG 書き出し、印刷用 HTML ページ、またはパネルを PDF（A4）に印刷できます。チャットでは `whale_report` ツールが markdown レポートを返します。
07関連する DSH ワークフロー
weknora
by tencent
オープンソースのLLMナレッジプラットフォーム。生ドキュメントを検索可能なRAG、自律推論エージェント、自己更新型Wikiへ変換する。
honcho
by plastic-labs
ステートフルなエージェントを構築するためのメモリライブラリ。会話履歴や状態を管理し、長期的な文脈保持を実現します。
webnovel-writer
by lingfengqaq
Claude Codeを基盤にした長編Web小説向けの執筆支援システム。AIの「忘却」や「幻覚」を抑え、200万字規模の連載制作に対応します。
mirage
by strukto-ai
AI エージェント向けの統合仮想ファイルシステム
08データと出典
**① DSH 插件安装（推荐，完整功能）** —— 注册进 dsh web
dsh plugin --profile web add "github:SenmuuuuW/dsh-whale-report"
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-09-06。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。