Apache-2.0 の TypeScript プラグイン(dsh 0.2.x、Node ^22.19 || >=24.9)。DeepSeek Harness のセッションを受動的に OTLP トレース/メトリクスと Langfuse observations へ書き出し、送信前の匿名化、有界なオフラインバッファ、バックオフ再試行を備えます。
DSH 統合
ネイティブ実行
作者による申告
安全性監査
未監査
最終検証日
2026-11-20
ライセンス
Apache-2.0
01どんなタスクに使えるのか?
DeepSeek Harness のすべてのセッションを、既存の可観測性基盤に標準的なトレースとメトリクスとして流し込む
1 ターン 1 トレース。ステップ、ツール呼び出し(所要時間・状態・リトライ推論)、LLM 生成がそれぞれ span になり、provider/model 別のトークン数、USD コスト、任意のコンテキスト圧力 gauge が付きます
セッションごとのレイテンシ、ツール利用、コストを OpenTelemetry や Langfuse で把握したいプラットフォーム/エージェント開発者
プロンプト/完了テキストのレベルまで可観測にしつつ、鍵や原文を外に出さない
キュー投入・バッファ・送信のどの段階よりも前に、キー名の匿名化、鍵パターンの除去、文字数予算による切り詰めを終えたレコード。本文が不要ならサイズとカウントだけを送ることもできます
データ取り扱いやコンプライアンスの要件がありつつ、LLM 単位の追跡は欲しいチーム
バックエンド障害や切断時にも観測データを落とさず、harness も止めない
非同期バッチ送信と決定論的な指数バックオフ再試行、そして再試行を使い切った後の有界な永続バッファ。未送信バッチは再起動後も残ります
観測バックエンドが落ちただけでセッションが詰まる事態を許容できない運用/SRE 担当者
02DeepSeek Harness への導入方法
前提条件
- Node `^22.19.0 || >=24.9.0`。純 ESM パッケージで、実行時依存は `zod` のみ
- DeepSeek Harness CLI の engines が `>=0.2.1-0 <0.3.0` または `>=0.2.2-0 <0.3.0` に収まっていること(プラグインは `@deepseek-ai/dsh@0.2.2-rc.1` で開発・テスト)
- 送信先が 1 つ以上: OTLP/HTTP のエンドポイント(`/v1/traces` と `/v1/metrics` はプラグインが付加)、または Langfuse の `baseUrl` + `publicKey` + `secretKey`
インストール手順
- 01
プロファイルに入れる: npm 公開版は `dsh plugin --profile web add dsh-observe`、最新 main は `dsh plugin --profile web add github:PerryLink/dsh-observe`、リポジトリで `pnpm pack` した tarball は `dsh plugin --profile web add ./dsh-observe-<version>.tgz`。
$ dsh plugin --profile web add dsh-observe
- 02
pnpm が `ERR_PNPM_IGNORED_BUILDS`(esbuild のプラットフォームバイナリに対する無害な検査)を出す場合は、`pnpm-workspace.yaml` に `allowBuilds: { esbuild: true }` を追加します。正確なスニペットは dsh CLI が表示します。
- 03
プロファイルパッチで有効化: `cordis.patch.yml` の該当行は既定で無効なので、`enabled: true` を設定し、`otlp.endpoint` か `langfuse.baseUrl` + `langfuse.publicKey` + `langfuse.secretKey` のどちらか(両方でも可)を設定します。
導入成功の確認
- `dsh --profile web --dump-config | grep -A2 'id: dsh-observe'` で、プラグイン行と設定値がプロファイルに入ったことを確認します。
- `/observe` のような手動トリガーのコマンドはありません。バックエンドに最初のトレースとメトリクスが届くか(Langfuse 側は observations)を確認し、`remote.enabled: true` にすると `observe/status` から設定済みバックエンド、キューの深さ、バッファ使用量が読めます。
ロールバック
- `dsh plugin --profile web remove dsh-observe`。またはプロファイルパッチから該当行を削除します。
03DSH 統合と能力の範囲
`dsh plugin --profile <name> add dsh-observe` でプロファイルに入れるネイティブプラグイン。harness の session/event ストリームを購読し、OTLP のトレース/メトリクスと Langfuse の observations として書き出すだけで、ツールもコマンドも登録しません。
ターン/ステップ/ツール/LLM の span 生成
harness の session/event ストリーム→1 ターン 1 トレース。ステップ、ツール呼び出し(所要時間・状態・リトライ推論)、LLM 生成の span がぶら下がり、span と trace の id は決定論的で再現可能
トークン・コスト・コンテキストのメトリクス
セッションイベントの provider/model 属性と、任意の `pricing` 価格表→provider/model 別のトークン数、USD コスト(最初に一致した価格ルールが適用)、`ctx.tokenMeter` に基づくコンテキスト圧力 gauge
`pricing` のどのルールもモデルに一致しない場合、コストメトリクスは生成されない送信前の匿名化と切り詰め
prompt、completion、ツール引数、ツール結果→構造的なキー名の匿名化、組み込みの鍵パターンと独自正規表現、文字数予算(prompt/completion 各 4000、ツール引数と結果は各 2000、span 属性 512)を適用したレコード
本文は切り詰められるため、長い prompt/completion は原文のまま残らない非同期バッチと永続バッファ
キューに入った span とメトリクスのレコード→件数(256 件)またはタイマー(5000ms)で flush、失敗時は 5 回・1000ms×2 の決定論的バックオフ(上限 60000ms)で再試行し、最終的に有界な永続 spool(10000 件、古い順に破棄)へ退避。30000ms ごとに戻し入れし、再起動後も残ります
バッファはストレージを消費する(容量は有界で、あふれた分は古いレコードから破棄)ストレージから読み戻したレコードは sink に渡す前に再検証される実行時のマスタースイッチ
`observe/setEnabled`(`remote.enabled: true` のときだけ公開)→アンインストールせずに書き出しを停止/再開でき、`observe/status` からスイッチ状態、設定済みバックエンド、キューの深さ、バッファ使用量が読めます
プロファイルに `observe` という名前の remote サービスが登録される(同じ名前を二重登録しないこと)
04誰に向いているのか?使うべきでない場面は?
向いている用途
- セッションごとのレイテンシ、ツール利用、コストを OpenTelemetry や Langfuse で把握したいプラットフォーム/エージェント開発者
- データ取り扱いやコンプライアンスの要件がありつつ、LLM 単位の追跡は欲しいチーム
- 観測バックエンドが落ちただけでセッションが詰まる事態を許容できない運用/SRE 担当者
不向きな用途
- 両側ともバージョン指定があります。`engines.dsh` は `>=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0` で、現行の基準は `@deepseek-ai/dsh@0.2.2-rc.1`。パッケージ自体は Node `^22.19.0 || >=24.9.0` の純 ESM です。セッション形式 V4(ツール結果が `role: 'tool'` の一級メッセージになる)に追随しているため、対象は 0.2.x 系の harness です。
- Langfuse の公開鍵/秘密鍵と OTLP のリクエストヘッダーは、自分が設定したエンドポイントにだけ送られます。プラグイン自身は資格情報を保存せず、README もクレデンシャル参照か環境変数注入を使い、鍵をプロファイルパッチに書いてコミットしないよう求めています。
05互換性・メンテナンス・セキュリティ上の注意
- 両側ともバージョン指定があります。`engines.dsh` は `>=0.2.1-0 <0.3.0 || >=0.2.2-0 <0.3.0` で、現行の基準は `@deepseek-ai/dsh@0.2.2-rc.1`。パッケージ自体は Node `^22.19.0 || >=24.9.0` の純 ESM です。セッション形式 V4(ツール結果が `role: 'tool'` の一級メッセージになる)に追随しているため、対象は 0.2.x 系の harness です。
- Langfuse の公開鍵/秘密鍵と OTLP のリクエストヘッダーは、自分が設定したエンドポイントにだけ送られます。プラグイン自身は資格情報を保存せず、README もクレデンシャル参照か環境変数注入を使い、鍵をプロファイルパッチに書いてコミットしないよう求めています。
- 要求する権限は 3 つだけです。設定したエンドポイントへの外向き通信、セッションイベントストリームの読み取り、オフラインバッファへの書き込み。ネイティブコードもファイルシステムアクセスもなく、モデルツール、ユーザー向けコマンド、client slot は登録しません。セッションログファイルは読まず、リアルタイムのイベントストリームだけを消費します。
- サンプリングはありません。有効化した span ファミリーはすべて書き出されるため、トラフィックの多いプロファイルでは `capture.*` と `batch.maxBufferRecords` を自分で調整する必要があります。また OTLP メトリクスは設計上リトライ/バッファ経路を通らず、flush を 1 回落としても次の累積集計で自己回復します。
Apache-2.0 · 活発にメンテナンス中(最新リリース v0.2.29、2026-11-18 公開)
06よくある質問
prompt やツール引数は原文のままバックエンドへ送られますか?
原文のままでは送られません。各レコードはキューに入る前に 3 段階の処理を通ります。構造的なキー名の匿名化(key/token/secret/password/authorization/credential/apiKey は常に対象で、`sanitize.redactKeys` で部分文字列を追加可能)、組み込みの鍵パターン(API key、GitHub token、AWS key、bearer 資格情報、秘密鍵)と `sanitize.redactPatterns` の独自正規表現、そして文字数予算による切り詰め(prompt と completion は各 4000 文字、ツール引数と結果は各 2000、span 属性は 512)です。本文が不要なら `llm.prompt` と `llm.completion` を `false` にすると、サイズとカウントだけが残ります。
バックエンドが落ちたりネットワークが切れたりしたらデータは失われますか?
通常の span とメトリクスは「再試行 → オフラインバッファへ退避」の経路を通ります。バッチは `retry.maxAttempts`(既定 5 回)と `retry.baseDelayMs × retry.factor` の決定論的な指数バックオフで再試行され、使い切るかメモリ上のキューが `batch.maxQueueRecords` を超えると、有界な永続 spool(`batch.maxBufferRecords` の既定は 10000、古い順に破棄)へ移ります。さらに `batch.bufferRetryIntervalMs`(既定 30000ms)ごとに戻し入れされ、再起動後も未送信バッチは残ります。例外は README が明記している OTLP メトリクスで、累積集計のため flush を 1 回落としても次で自己回復します。
reasoning(思考の連鎖)も書き出されますか?
既定では書き出されます。`llm.reasoning` は有効で、reasoning は `gen_ai.completion.reasoning` という独立した属性として送られ、`gen_ai.completion` に混ざることはありません(Langfuse では generation の metadata に入ります)。README は、思考の連鎖にはユーザーの原文やモデルが逐語的に復唱したコンテキストが含まれ得るため、送信前にコンプライアンス要件を評価するよう注意し、不要なら `llm.reasoning: false` を設定するよう案内しています。`llm.completion: false` は本文と reasoning の両方を止めます。
セッションが遅くなりませんか?
収集と匿名化はイベントハンドラー内で同期的に走りますが、送信はすべて非同期です。キューは件数またはタイマーで flush され、`session/flush` はあくまでベストエフォートの kick で、永続化チェックポイントがリモートバックエンドを待つことはありません。書き出し失敗は警告・カウント(`observe.export_failures`)・再試行を経てバッファに入り、イベントハンドラー自体の例外も捕捉して記録されるため、可観測性が harness のホットパスを塞ぐことはありません。
同じプロファイル内で他のプラグインと取り合いになりますか?
登録する範囲はかなり狭く、注入するサービスキーは `storageDomain` の 1 つだけ、購読するイベントは `session/event`、`session/flush`、`session/disposed` の 3 つだけで、ツール、コマンド、client slot、waterfall は登録しません。唯一の注意点は任意の `observe` remote サービス(`remote.enabled`、既定は無効)で、同じプロファイル内で同名サービスを別のプラグインが使っている場合は片方だけを有効にします。可観測性プラグインをさらに追加しても問題ありません(Cordis のブロードキャストなので互いに飢えません)が、トレースは 2 系統になります。
07関連する DSH ワークフロー
dsh-our-free-model
by ebony-vinyl
ログインやAPIキーなしでDeepSeek V4.1 FlashやKimi K3などを利用できるとし、無料・無制限をうたうDeepSeek Harness向けプラグインです。
dsh-routing-suite
by yjh051108
DeepSeek Harness(dsh)向けのルーティング套件。まずランタイムインジェクターを導入し、続いてタスク認識型の推論モードルーター(P1〜P23 を計測済み)を組み込めます。
dsh-ops
by t-auto
Bash と PowerShell コマンドを実行し、ローカルファイルを検索および編集し、DSH から長期にわたるバックグラウンドジョブを管理します.
dsh-connect-workbuddy
by dingminhua
ローカルにサインインしたWorkBuddyモデルをDeepSeek Harnessへ接続。読み取り専用のクレジット概要とモデル管理を提供。
08データと出典
把每次会话变成标准 OTLP trace 与 Langfuse 观测——发出去之前先脱敏,默认什么都不发。
它只做导出——不注册任何模型工具、不注册用户可见命令,全部行为由配置决定
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日:2026-11-20。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。
