dsh-plugin-diepi

dsh-plugin-diepi は独立にメンテナンスされているコミュニティ DSH プラグインです。ユーザーは自然言語で日次株・ETF 戦略を表現し、DSH が対話とオーケストレーションを担当し、diepi-mcp が制約付きツールプロトコルを提供し、diePi がデータ検証・因果境界・マッチング・記帳・不変の結果成果物を担当します。

自然语言
  -> DSH + diepi-quant-research Skill
  -> StrategySpec v1（结构化、可预览、拒绝任意代码）
  -> diepi-mcp（MCP stdio、作业队列、证据绑定）
  -> 独立 diePi 子进程
  -> 已验证的 RunArtifact / ResultContract

現在のバージョンは Developer Preview です。Python パッケージは diepi-mcp 0.1.0a1、npm bundle は dsh-plugin-diepi 0.1.0-alpha.1 です。本プロジェクトは DeepSeek 公式プロジェクトではなく、いかなる公式の承認も表しません。

できること

• 日次、現金口座、単一の A 株または ETF。

• StrategySpec v1 / ma_crossover：短期・長期の移動平均線の厳密なクロス、任意の売上高拡大フィルター。

• 前場の意思決定は T-1 までの完全な日次データのみを読み取り、注文は最も早く T 日の寄り付きでマッチングされます。

• raw_only、adjusted_only、および厳密にアラインされた dual データをサポート。

• バックテストは非同期でキューイングされ、submission_id により未知のタイムアウト再試行が冪等に保たれます。

• データソース、取引カレンダー、戦略テンプレート、実行パラメータ、最終成果物はレイヤーごとにバインドされます。

• DSH bundle は 8 つの制約付き MCP ツールと diepi-quant-research Skill を自動的にマウントします。

任意の Python、分単位の戦略プロトコル、ショート、レバレッジ、先物、実売、証券会社の認証情報、内蔵のマーケットデータダウンロード、パラメータオプティマイザー、GUI は現在サポートされていません。モデルは本プラグインを介してパス、コマンド、SQL、Python ソースコードを渡すことはできません。

Related MCP server: OpenFinClaw CLI

5 分間の synthetic 体験

初回体験では、本リポジトリや diePi リポジトリの実際のマーケットデータを読み取りません。diepi-mcp init-config は DSH ワークスペース外で排他的に新しい adapter home をクレームし、diePi の同じ deterministic demo generator を呼び出して、架空の価格、売買高、取引日、証券ラベルを生成します。これらのデータはインストールとプロトコル配線の検証にのみ使用されます。

要件：

• Python 3.10+；

• Node.js ^22.19.0 || >=24.0.0；

• pnpm 11.7.x、かつ pnpm が PATH にあること；

• DSH 0.1.0-rc.7（メインサポート）または 0.1.0-rc.8（canary）。

まず、調整されたリリース後の Python Alpha をインストールし、新しい host-owned ルートを作成します。adapter-home-alpha1 はまだ存在してはなりません：

$hostRoot = Join-Path $env:LOCALAPPDATA "diepi-mcp-host"
$adapterHome = Join-Path $hostRoot "adapter-home-alpha1"
New-Item -ItemType Directory -Force -Path $hostRoot | Out-Null

python -m venv (Join-Path $hostRoot "venv")
$experiencePython = Join-Path $hostRoot "venv\Scripts\python.exe"
$mcpCommand = Join-Path $hostRoot "venv\Scripts\diepi-mcp.exe"

& $experiencePython -m pip install "diepi-mcp==0.1.0a1"
& $mcpCommand init-config --target $adapterHome

$env:DIEPI_MCP_COMMAND = (Resolve-Path $mcpCommand).Path
$env:DIEPI_MCP_CONFIG = (Resolve-Path (Join-Path $adapterHome "diepi-mcp.json")).Path
& $env:DIEPI_MCP_COMMAND --check-config

初期化コマンドは、既存のターゲットの上書き、マージ、再利用を拒否します。まず排他的にターゲットと .diepi-mcp-incomplete マーカーを作成し、次に exclusive-create で staged payload を書き込み、最後に diepi-mcp.json をコミットしてマーカーを削除します。失敗した場合、利用可能な設定のない incomplete ディレクトリが残りますが、競合するターゲットを削除したり引き継いだりすることはありません。新しいディレクトリを使用するか、host owner が内容を確認して手動でクリーンアップしてください。生成された設定には相対パスのみが含まれ、state、results、synthetic データはすべて adapter home に残り、Agent ワークスペースや Git リポジトリには入りません。 examples/config.example.json はスキーマの参考に過ぎず、手動でコピーする必要はありません。本番環境では、ファイル権限により Agent がマーケットデータを読み取り専用にし、設定、MCP 環境、state、results ルートを書き込めないようにする必要があります。

DSH のプラグインマネージャーは素の pnpm を呼び出します。Node に Corepack が含まれている場合は、DSH が使用するバージョンを固定できます：

corepack enable
corepack prepare pnpm@11.7.0 --activate
pnpm --version

現在の Node に corepack が含まれていない場合は、Corepack/pnpm の公式手順に従ってインストールしてから続行してください。任意のカスタムプロファイルではなく、web プロファイルにインストールします：

dsh plugin --profile web add dsh-plugin-diepi@0.1.0-alpha.1
dsh --profile web --dump-config
dsh web --no-open

プラグインメンバーの変更は、新しい DSH プロセスにのみ有効です。ヘッドレスを使用する場合：

dsh plugin --profile headless add dsh-plugin-diepi@0.1.0-alpha.1
dsh --profile headless --dump-config
dsh --profile headless

本リポジトリからテストバンドルをチェックアウトする場合、リポジトリルートでパッケージ名を ./dsh に置き換えます。Git リポジトリのルート URL から npm パッケージを直接インストールしないでください。npm パッケージは dsh/ サブディレクトリにあります。

バンドルはアクティベーション時に DIEPI_MCP_COMMAND と DIEPI_MCP_CONFIG が明示的な絶対パスであることを強制します。PATH 内の同じ名前の実行可能ファイルにフォールバックしたり、設定の場所を推測したりしません。MCP サブプロセスの作業ディレクトリは、Agent ワークスペースではなく、host が所有する設定ディレクトリに固定されます。

自然言語からバックテストへ

例：

510300.SH の日次データを使用し、5 日移動平均線が 20 日移動平均線を上抜けたら全額投資、下抜けたら全額売却。2024 年のバックテスト。

Agent はまずレビュー可能な StrategySpec v1 を生成し、次に以下の順で呼び出します：

1. capabilities

2. preview_strategy

3. validate_data

4. 新しい req_ で始まる submission_id を使用して start_backtest を呼び出します

5. job_status、必要に応じて cancel_job

6. get_result

MCP タイムアウトや転送中断が発生した場合は、完全に同じパラメータと同じ submission_id で再試行する必要があります。結果を比較できるのは、以下の条件がすべて成立する場合のみです：

artifact_verified == true
adapter_attribution_verified == true
result_committed == true
result_status == SUCCESS
rankable == true

独自のマーケットデータと Tushare Skill

最小入力は diePi market_data_v1 に準拠した raw 日次データです。最適な入力は、完全にアラインされた raw、HFQ、および元の調整係数の 3 トラックです。上流インターフェースがデータを hfq と呼ぶことは、それが diePi の因子恒等式を満たすことを証明するものではなく、最終的には diePi validator が判断します。

プラグインにはコネクタは組み込まれておらず、実際のマーケットデータは含まれず、トークンは保存されず、外部 Skill を自動的にインストールすることもありません。データが不足している場合、Agent はユーザーを独立してインストールされた Tushare 公式 Skill に誘導できます。私たちはレビュー済みの上流コミットを手動ハンドオフの参照としてのみ記録します。インストール、ネットワーク権限、認証情報、ベンダー条件、更新の決定はすべてユーザーが制御します。詳細なルールは Tushare handoff を参照してください。

外部 Skill はデータを新しいステージングルートに書き込むことのみを担当します。host オーナーはセッション外で検証し、不透明な dataset_id として登録し、データルートをフリーズし、MCP を再起動する必要があります。単一の Agent セッションはこの境界をスキップできません。

バージョンと互換性ポリシー

• diepi-mcp==0.1.0a1 は diepi==0.1.1 に正確に依存します。これは意図的です。adapter は現在、diePi のキャンセルコールバック、ソースエビデンス、カレンダー ID、アトミックな成果物セマンティクスに依存しており、広い 0.1.x 範囲は互換性を証明できません。

• DSH rc.7 は Alpha のメインサポートバージョンです。rc.8 は将来の canary です。両方ともまだ Developer Preview であり、rc.8 のテストは独立した DSH_HOME を使用し、rc.7 のセッション状態を再利用しないでください。

• Harness には @deepseek-ai/dsh-mcp-client と @deepseek-ai/dsh-skill-filesystem が含まれています。本バンドルはそれらを重複して持ち込みません。

リリース順序のハードゲートは、まず diepi==0.1.1 が調整された Python インデックスからインストール可能であることです。プラグイン CI はそれ以前に失敗するべきであり、ピンを緩めるべきではありません。その後、リリースゲートはダウンロード候補の SHA-256 を検証し、クリーンな環境で sdist をインストールし、Windows/Ubuntu、Node 22/24、web/headless、DSH rc.7/rc.8 の 4 つのグリッドで wheel とパッケージ化された npm tgz をインストールします。各グリッドは wheel 上の直接 MCP/adapter synthetic smoke を実行し、実際に DSH を起動し、Loader settle 後に 8 つの mcp__diepi__* ツールを厳密に発見し、capabilities を呼び出します。このモデルフリーのキープローブは、DSH を介したキャンセル、クラッシュ再接続、実際のモデル効果をカバーするものではありません。これらの境界はソーステストまたは個別に記録された手動リリース検証によって処理されます。

セキュリティ境界

MCP stdio はホストプロセスであり、Agent ファイルサンドボックス内にはありません。設定、実行可能ファイル、データルート、state、results はホストオーナーが制御する必要があります。ハッシュは成果物間の同一性を証明しますが、Agent が書き込み可能なディレクトリを信頼できる証拠ルートに変えることはできず、マーケットデータの真実性、合法的な承認、またはサバイバーシップバイアスの欠如を証明することもできません。

詳細な脅威モデルと非公開の脆弱性報告エントリは SECURITY.md にあります。

開発

python -m venv .venv
.\.venv\Scripts\python.exe -m pip install ".[dev]"
.\.venv\Scripts\python.exe -m pytest -m "not integration"
.\.venv\Scripts\ruff.exe check src tests
.\.venv\Scripts\python.exe -m build
.\.venv\Scripts\python.exe -m twine check dist\*

Push-Location dsh
npm pack --dry-run
Pop-Location

貢献ルールは CONTRIBUTING.md、 バージョン変更は CHANGELOG.md にあります。

免責事項とライセンス

本プロジェクトはソフトウェアエンジニアリングの検証、定量調査、歴史的なバックテストにのみ使用されます。出力は投資アドバイス、取引の申し出、収益の保証、または証券サービスの提供を構成するものではありません。バックテストはデータ品質、サバイバーシップバイアス、復元、マッチングの仮定、手数料、スリッページ、過学習の影響を受ける可能性があります。ユーザーはデータソース、ベンダーライセンス、モデル使用、投資決定に対して責任を負います。

Apache-2.0、詳細は LICENSE を参照してください。サードパーティの関係は THIRD_PARTY_NOTICES.md にあります。DeepSeek、DeepSeek Harness、DSH の関連する名前とロゴはそれぞれの権利者に帰属します。本プロジェクトはそれらと提携または承認関係にありません。