howmp/dsh-pentest

概要

dsh-pentestは、オープンソースのAIエージェントフレームワークである**DeepSeek Harness (DSH)*用のプラグインバンドルです。このバンドルは、DSHセッション内でセキュリティ評価データ（目標、意図、事実、発見事項、資産、およびそれらの関係）を記録、整理、視覚化できるペネトレーションテストモード*を追加します。

対象ユーザー

• すでにDSHを使用しており、ターゲットをテストするための明示的な許可を得ているセキュリティ専門家。
• ペネトレーションテストの成果物を構造化してキャプチャ・表示する必要があるカスタムDSHエージェントの開発者。
• LLM駆動のワークフロー内でセキュリティエンゲージメントを追跡するための、すぐに使えるUIを求めている方。

主要コンポーネント（READMEより）

コンポーネント	役割
ホストプラグイン (pentest.js)	エージェントがデータを保存するために呼び出す9つの pentest_* ツール（例: pentest_add_goal, pentest_add_finding, pentest_submit）を公開します。
SQLiteバックエンド (storage-sqlite.js)	Nodeの組み込み node:sqlite を使用して、ペネトレーションテストのグラフを $DSH_HOME/storages/pentest-sessions.db に永続化します。
Web UI (ui-pentest.client.js)	DSH Webクライアントに新しいタブを追加し、探索グラフ、脆弱性リスト、資産ビュー、Markdownレポートの4つのサブビューを提供します。
ドメインモデル (spec.ts)	6つのテーブル（goals, intents, facts, findings, assets, edges）とエッジの語彙（spawns, yields, derived_from, proves, parent）を定義します。
プロジェクション層 (projection.ts)	データベース内の完全な履歴を保持しつつ、高速なUIレンダリングのために、保存されたグラフをウィンドウ化されたビュー（最新の200ノード/資産）に投影します。
プロトコル (instructions.ts)	LLMがペネトレーションテストのワークフローに従い、ツールを介してデータを書き込むようガイドするシステムプロンプト（pentest:protocol）を提供します。

使用方法

1. インストール – DSH CLI経由で、npm (dsh plugin add @howmp/dsh-pentest) からインストールするか、リリースされたtarballをダウンロードします。
2. DSHの再起動 – プラグインは自動的に登録され、セッションセレクターに新しい「ペネトレーションモード」が表示されます。
3. ペネトレーションテストの実行 – 提供されたツールを使用するか、サブエージェントに pentest_submit を呼び出させて、目標、意図、事実、発見事項、資産を追加します。すべての呼び出しはメインのDSHセッションログではなく、SQLiteデータベースに保存されます。
4. 探索 – UIには、エンゲージメントの有向グラフ、脆弱性リスト（深刻度、再現手順、影響を受ける資産を含む）、資産階層、および生成されたMarkdownレポートが表示されます。
5. エクスポート/修復 – このバンドルには、古いDSHバージョンによって破損したセッションログを修正するための dsh-pentest-repair スクリプトが付属しています。

制限事項と安全上の注意

• 認可されたテストのみ – このプラグインは法的に認可されたテストを目的としており、アクセス制御を強制するものではありません。
• セッションスコープのデータ – 各ペネトレーションテストの実行は単一のDSHセッション内に留まり、セッションをまたぐ永続性はありません。
• ウィンドウ化されたUI – UIには最新の200ノード/資産のみが表示されます。古いアイテムはデータベース内に保持されており、pentest_state または pentest_report を通じてアクセス可能です。
• ログの汚染なし – このプラグインは、古いDSHバージョンを壊さないように、独自のイベントをメインのDSHセッションログに書き込まないように設計されています。
• 互換性 – DSH ≥ 0.1.6およびNode ≥ 22.5が必要です。古いDSHバージョンでは、このバンドルの特定のプレリリース版が必要です。

なぜ重要なのか

セキュリティ評価には、ターゲット、発見事項、証拠、修正手順など、多くの可動部分が含まれます。このワークフローをLLM駆動のエージェントプラットフォームに直接組み込むことで、dsh-pentestは、アナリストがAIアシスタント環境から離れることなく、エンゲージメント全体を構造化、再現可能、かつ視覚化された状態に保つことを可能にします。

---

上記の詳細はすべてリポジトリのREADMEから直接引用したものであり、追加の機能は推測されていません。