メインコンテンツへ移動
AIチュートリアル

富江破甲のインストールと使用方法：DeepSeek Harnessにセキュリティスキル、ナレッジベース、作業フローを設定

本チュートリアルでは、富江破甲 0.20.12の用途、インストール手順、プロンプトスイッチ、スキルライブラリ、CVE/PoCナレッジベース、脆弱性レポート、ペネトレーションテストの作業フローについて解説し、互換性、バックアップ機能、安全な使用上の注意点も説明します。

約19分で読了
富江破甲のインストールと使用方法：DeepSeek Harnessにセキュリティスキル、ナレッジベース、作業フローを設定

プロジェクト概要

富江破甲は、DeepSeek Harness 向けのカスタムプロンプトおよびセキュリティ評価支援プラグインです。現在 README に記載されているバージョンは 0.20.12 です。プロジェクトは @deepseek-ai/dsh-prompt-custom を Harness の設定ディレクトリにインストールし、プラグイン本体と prompt-custom.json のプロンプト設定を分けて保存します。

プラグインは、カスタムプロンプト、スキルライブラリ、組み込み CVE/PoC ナレッジベース、脆弱性レポート、ペネトレーションテスト作業チェーンなどの機能を提供します。明確な許可を得た環境で、資産の整理、候補脆弱性の照合、検証手順の記録、レポートの生成を行うのに適しています。ナレッジベースの候補や自動化の進捗を、確認済みの脆弱性と直接みなしてはなりません。

プロジェクト名および DeepSeek への言及は、公式の推奨や承認を意味しません。使用を開始する前に、リポジトリの免責事項を読み、テスト対象、範囲、操作方法について許可を得ていることを確認してください。

主な機能

  • プロンプト注入：入力欄の近くに「富江破甲」の状態スイッチと設定入口があります。注入を無効にすると公式の冒頭に戻りますが、ユーザー独自のプロンプト本文は保持されます。
  • 脆弱性レポート：人工知能が書き込んだ脆弱性記録を永続保存し、重大、高、 中、低、情報の各レベルで表示できます。
  • スキルライブラリ：REA と AboutSecurity を必要に応じてダウンロード、有効化、無効化し、人工知能が登録済みのスキル内容を発見できるようにします。
  • 組み込みナレッジベース：9 種類の CVE/PoC ナレッジがプラグインに付属しており、有効化に追加ダウンロードは必要ありません。
  • ペネトレーションテスト作業チェーン：タスク、資産、検証手順、試行記録、フェーズ、次の提案を管理します。
  • ローカルフィンガープリント照合：ポート、サービス識別子、製品名に基づいてナレッジベースの候補項目を並べ替え、照合理由を提示します。

カスタムプロンプト画面

カスタムプロンプト設定は prompt-custom.json に独立して保存され、個人設定が含まれる場合があります。再インストール、バックアップ、配布を行う前に、ファイル内容を共有して問題ないか確認してください。

富江破甲のカスタムプロンプト設定画面

スキルライブラリとナレッジベース

スキルライブラリは、2 つの上流プロジェクトに対応しています。REA リバースエンジニアリングツールとAboutSecurity セキュリティ評価スキルライブラリです。各サードパーティープロジェクトには、それぞれのライセンス条件が適用されます。

富江破甲のスキルライブラリ管理画面

組み込みナレッジベースは、Java デシリアライゼーション、Java Web、境界機器、Exchange とドメイン環境、Web と CMS、Linux 権限昇格、クラウドとコンテナ、業務 API リスク、脆弱性トリアージなどのカテゴリを網羅しています。各項目には、製品、バージョン、ポート、キーワード、重大度、前提条件、修正提案、参照元が記録されます。

富江破甲の組み込みナレッジベース画面

インストール前の準備

  1. 対応している DeepSeek Harness のバージョンを確認します。プラグインは、DeepSeek Harness と dsh-system-prompt の >=0.2.1-rc.5 <0.3.0 に対応すると宣言しています。
  2. Cordis のバージョンが >=4.0.5 <5 の範囲内であることを確認します。
  3. 公式の DeepSeek Harness Desktop を少なくとも 1 回起動し、desktop 設定の初期化を完了させます。
  4. インストール前に Harness を完全に終了します。Windows 右下のトレイアイコンから「終了」を選択する必要があります。
  5. 信頼できるソースからリポジトリをダウンロードし、スクリプトを実行する前にファイル内容を確認します。

インストールスクリプトの使用

リポジトリページで Code → Download ZIP を選択して解凍するか、Git でリポジトリをクローンします。Harness を完全に終了した後、解凍したディレクトリ内の 点我执行脚本.cmd をダブルクリックします。

# Harness を完全に終了してから実行
.\点我执行脚本.cmd

# インストール計画のみを確認し、ファイルは変更しない
.\install.ps1 -DryRun

-DryRun は、正式なインストール前にスクリプトが実行しようとしている操作を確認するのに適しています。インストーラーはデフォルトで desktop 設定を使用し、Desktop に付属する DSH コマンドラインツールを優先して呼び出します。環境をカスタマイズする場合は、-Profile、-DshCommand、-DshHome で設定名、コマンドラインツール、データディレクトリを指定できます。

DSH_HOME が設定されていない場合、デフォルトのデータディレクトリは $env:USERPROFILE\.dsh です。インストールスクリプトはプラグインを $DSH_HOME\local-plugins\dsh-prompt-custom にコピーし、DSH プラグインマネージャーで登録した後、付属の prompt-custom.json をコピーします。

既存のプロンプト設定と新しい設定が異なる場合、インストーラーは元のファイルの隣にバックアップを作成します。登録に失敗し、バックアップが存在する場合、スクリプトは元のプロンプト設定を復元します。インストール成功後、スクリプトは隣接する場所に install.log を書き込もうとしますが、このファイルは完全な実行ログではありません。

インストーラーが Harness の実行中を検出した場合、終了を促して停止します。この場合、ファイルは変更されません。インストーラーは Harness を自動的に終了または再起動せず、-NoRestart パラメーターにも対応していません。

スクリプトが Windows にブロックされた場合

インストーラーは内容を確認できる PowerShell スクリプトで、主にファイルのコピーと DSH コマンドの呼び出しを実行します。README では、非表示ウィンドウの起動、プロセスの強制終了、スケジュールタスクの作成、WMI によるプロセス作成は行わないと説明されていますが、これはセキュリティソフトによる検出結果を意味するものではありません。

Windows がダウンロード元のマークによってスクリプトをブロックした場合は、まずダウンロード元を確認し、スクリプトの内容を確認してください。SHA256 チェックサムを計算し、配布者が提供する値と照合することもできます。

Get-FileHash .\install.ps1 -Algorithm SHA256

ファイルが信頼できることを確認したら、Windows のファイル「プロパティ」にある「ブロックの解除」でダウンロード元のマークを処理できます。

手動インストール方法

自動インストールスクリプトを実行したくない場合は、Harness を完全に終了した後、プラグインを手動でコピーして登録できます。以下のコマンドは、デフォルトのデータディレクトリと Desktop に付属する DSH コマンドラインツールを使用します。

$pluginTarget = Join-Path $env:USERPROFILE '.dsh\local-plugins\dsh-prompt-custom'
New-Item -ItemType Directory -Force -Path $pluginTarget | Out-Null
Get-ChildItem -LiteralPath .\plugin -Force | ForEach-Object {
  Copy-Item -LiteralPath $_.FullName -Destination $pluginTarget -Recurse -Force
}

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add $pluginTarget

リポジトリに付属するプロンプト設定も使用する場合は、まず既存の $env:USERPROFILE\.dsh\prompt-custom.json をバックアップしてから、新しいファイルをコピーしてください。インストール完了後、Harness は手動で再起動する必要があります。

基本的な使用手順

ステップ 1：プロンプト注入を有効にする

Harness を再起動した後、入力欄の近くにある「富江破甲」の状態入口を探します。有効にすると、プラグインは公式の harness:identity の冒頭を空の段落に置き換えます。無効にすると公式の冒頭に戻ります。カスタムプロンプト本文は削除されません。

ステップ 2：スキルライブラリを設定する

設定パネルの「スキルライブラリ」を開き、必要に応じて REA または AboutSecurity をダウンロードして有効にします。AboutSecurity は GitHub から現在の master ブランチの圧縮ファイルをダウンロードし、その中の skills/ ディレクトリだけを抽出します。ダウンロード中は進捗表示とキャンセルに対応しています。

REA が要求する互換 Node.js バージョンは ^22.23.4 || ^24.22.1 || >=26.12.1 です。プラグインが npm で REA をインストールする際はライフサイクルスクリプトを無効にするため、このインストール方法では Frida のオプションのネイティブバインディングはビルドされません。各ツールが実行できるかどうかは、ローカルの実行環境と分析エンジンにも左右されます。

AboutSecurity は主に Markdown のスキルドキュメントで構成され、追加のネイティブ実行コンポーネントは必要ありません。スキルのダウンロード成功は、ファイルが取得され登録されたことを示すだけで、すべてのツールの実行検証が完了したことを意味しません。

ステップ 3：ナレッジベースを使って照合する

ナレッジベースはデフォルトで有効になっており、状態は $DSH_HOME/fujiang-skills/knowledge-state.json に保存されます。無効にすると、プラグインは関連するナレッジを人工知能に提供しなくなりますが、元のファイルはローカルに保持されます。

許可を得たテストでは、まず対象製品、バージョン、ポート、サービス識別子、テスト範囲を人工知能に伝えたうえで、関連するナレッジ項目を検索するよう求めます。例：

これは許可を得たテスト環境です。確認済みの製品名、バージョン、開放ポートに基づいてナレッジベースの候補項目を検索し、照合理由、適用される前提条件、追加検証が必要な証拠、修正提案を列挙してください。候補項目を確認済みの脆弱性として表現しないでください。

ナレッジ項目は公開資料を整理したもので、通常は verified: false や sources: などのメタデータによって検証状態と出典を示します。実際に使用する際は、対象のバージョン、設定、前提条件と照合して再確認する必要があります。

ステップ 4：ペネトレーションテスト作業チェーンを作成する

現在の実装では、ユーザーが先にプラグインパネルでタスクを作成してから、人工知能が既存のタスクを使って資産、手順、結果を記録できます。作業チェーンは次のフェーズで構成されます。

  1. 情報収集
  2. フィンガープリント識別
  3. 脆弱性照合
  4. 実行可能性の検証
  5. 脆弱性の悪用
  6. 横展開
  7. レポート出力

各タスクには 1 つのセッションを関連付けることができ、1 つのセッションに関連付けられるタスクは最大 1 件です。プラグインは campaign:context を通じて、関連付けられた人工知能にタスク、フェーズ、資産数、次の提案を提供します。

富江破甲のペネトレーションテスト作業チェーン管理画面

タスクを作成する際は、許可された対象、実行可能な範囲、禁止事項、テスト時間帯、停止条件を明確に記入することを推奨します。タスクの進捗とフェーズは情報整理のためのものであり、脆弱性検証の証拠に代わるものではありません。

ステップ 5：脆弱性レポートを記録する

検証結果が結論を裏付けるのに十分になってから、人工知能に脆弱性記録を書き込ませます。レポートには、影響を受ける資産、再現条件、証拠、影響評価、重大度、修正提案、参照元を含める必要があります。未検証の候補項目は「要検証」の状態に保ち、脆弱性として直接マークしないでください。

ローカル API とネイティブツール

プラグインは、ローカルフィンガープリント照合とタスク台帳の API を提供します。照合計算と台帳への書き込みは本機で行われますが、スキルのダウンロード、ネットワーク経由のモデル呼び出し、実際の対象検証ではネットワーク通信が発生する可能性があります。

  • POST /api/dsh-prompt-custom/match：ポート、サービス識別子、製品名に基づき、並べ替え済みのナレッジベース候補項目と照合理由を返します。重みはポート 40、製品 30、CVE 20、キーワード 20、重大度 5 です。
  • /api/dsh-prompt-custom/campaigns：テスト範囲、資産フィンガープリント、実行手順、試行記録、タスクフェーズを管理します。台帳は $DSH_HOME/vuln-report/campaigns.json に保存されます。
  • GET ?id=：指定したタスクと次の提案を読み取ります。

タスクインターフェースでは、bind、unbind、kick などの操作も利用できます。ネイティブツールには kb_match、campaign_upsert、finding_upsert、pipeline_next があり、スキル検索の入口には skill_search と skill_read があります。ネイティブツールの登録には、解析可能な DSH ツールサービスが必要です。

高度な利用に関する提案

まず DryRun でインストール計画を確認する

初回インストール時や設定ディレクトリを変更する際は、まず .\install.ps1 -DryRun を実行してください。これにより、対象パス、設定名、想定される操作を確認しながら、ファイルの即時変更を避けられます。

プラグインと個人用プロンプトを別々にバックアップする

prompt-custom.json はプラグイン本体とは独立しており、個人設定が含まれている可能性があります。アップグレードや再配布の前に、このファイルを個別にバックアップして内容を確認し、カスタマイズ内容の上書きや機密情報の意図しない共有を避けてください。

候補のマッチングと実際の脆弱性を区別する

フィンガープリントのマッチングは、ポート、製品、CVE、キーワード、深刻度に基づいて候補を並べ替えるだけです。順位が高いからといって、対象が必ず影響を受けるとは限りません。引き続き、バージョン、デプロイ方法、パッチ適用状況、前提条件、実際の証拠を確認する必要があります。

自動継続実行は慎重に使用する

自動継続実行はデフォルトで最大 8 ラウンドまで動作し、停滞の判定と次のステップの提案を備えています。使用時は、明確な認可範囲と停止条件を設定し、継続的に人手で確認してください。コンテキスト不足によってモデルが不適切な後続操作を実行するのを避けるためです。

ナレッジベースの更新方法を理解する

ナレッジ項目は plugin/knowledge/ にあり、項目を読み込むたびにファイルが再読み込みされるため、内容の更新は後続の呼び出しで反映されます。分類の定義は lib/knowledge.js にあります。分類を変更した場合は、プラグインを再読み込みしてください。

入力ショートカットの問題を調査する

README には既知の状況として、免責事項のポップアップを閉じた後も Enter または Esc のリスナーが入力やショートカットに影響する可能性があると記載されています。異常が発生した場合は、まずこの既知の問題との関連を確認し、その後プラグインを再読み込みするか Harness を再起動してください。

互換性と検証範囲

このプラグインは、公開されている systemPrompt、skills、tools、エージェントのライフサイクル、webServer サービスを通じて動作し、Harness のプログラムファイルを変更してインストールするものではありません。インストール後は、Harness を完全に終了してから再起動する必要があります。

README では、現行バージョンについてファイル構成とインストールロジックを確認済みとしていますが、すべての機能を実際に再実行して検証したわけではありません。したがって、すべてのスキル、CVE 項目、自動化フローが利用可能だと保証することはできません。本番環境に導入する前に、隔離された認可済みのテスト環境で項目ごとに検証してください。

まとめ

富江破甲は、プロンプト管理、セキュリティスキル、組み込みナレッジベース、脆弱性レポート、タスク台帳を DeepSeek Harness に統合します。正しい利用方法は、まず互換性とインストール計画を確認し、次にスキルとナレッジベースを設定し、最後に明確な認可範囲内でタスクを作成し、候補を検証して証拠を保存することです。常に、人手による確認、最小権限、信頼できる証拠を自動化フローより優先してください。