dsh-plugin-diepi

dsh-plugin-diepi ist ein unabhängig gepflegtes Community-DSH-Plugin: Nutzer formulieren Tageslinien-Aktien- oder ETF-Strategien in natürlicher Sprache, DSH übernimmt Dialog und Orchestrierung, diepi-mcp stellt ein eingeschränktes Tool-Protokoll bereit, diepi übernimmt Datenvalidierung, Kausalitätsprüfung, Abgleich, Buchführung und unveränderliche Ergebnis-Artefakte.

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

Die aktuelle Version ist Developer Preview: Das Python-Paket ist diepi-mcp 0.1.0a1, das npm-Bundle ist dsh-plugin-diepi 0.1.0-alpha.1. Dieses Projekt ist kein offizielles DeepSeek-Projekt und stellt keine offizielle Unterstützung dar.

Funktionen

• Tageslinien, Bargeldkonto, einzelne A-Aktie oder ETF.

• StrategySpec v1 / ma_crossover: Strikter Kreuzungspunkt von schnellem und langsamem gleitendem Mittelwert, optional mit Umsatzverstärkungsfilter.

• Vorbörsliche Entscheidungen lesen nur vollständige Tageslinien bis T-1; Aufträge werden frühestens bei Markteröffnung am T-Tag abgeglichen.

• Unterstützt raw_only-, adjusted_only- und strikt ausgerichtete dual-Daten.

• Backtests werden asynchron in Warteschlangen verarbeitet; submission_id macht Wiederholungsversuche bei unbekannten Timeouts idempotent.

• Datenquellen, Handelstage, Strategievorlagen, Ausführungsparameter und finale Artefakte werden schichtweise gebunden.

• Das DSH-Bundle mountet automatisch acht eingeschränkte MCP-Tools und die diepi-quant-research-Skill.

Beliebige Python-Skripte, Minuten-Strategieprotokolle, Leerverkäufe, Hebel, Futures, Live-Handel, Broker-Zugangsdaten, integrierte Marktdaten-Downloads, Parameter-Optimierer oder GUIs werden derzeit nicht unterstützt. Modelle können über dieses Plugin keine Pfade, Befehle, SQL oder Python-Quellcode übergeben.

Related MCP server: OpenFinClaw CLI

Fünf-Minuten-Synthetik-Erlebnis

Beim ersten Erlebnis werden keine echten Marktdaten aus diesem Repository oder dem diePi-Repository gelesen. diepi-mcp init erstellt außerhalb des DSH-Arbeitsbereichs exklusiv einen neuen Adapter-Home-Ordner und ruft den deterministischen Demo-Generator von diePi auf, der fiktive Preise, Volumina, Handelstage und Wertpapierkennungen erzeugt; diese Daten dienen nur zur Verifizierung von Installation und Protokollanbindung.

Anforderungen:

• Python 3.10+;

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

• pnpm 11.7.x, wobei pnpm im PATH sein muss;

• DSH 0.1.0-rc.7 (primäre Unterstützung) oder 0.1.0-rc.8 (Canary).

Installieren Sie zuerst das koordinierte Release von Python Alpha und erstellen Sie einen neuen Host-eigenen Root. adapter-home-alpha1 darf noch nicht existieren:

$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

Der Initialisierungsbefehl lehnt das Überschreiben, Zusammenführen oder Wiederverwenden bestehender Ziele ab. Er erstellt das Ziel und die .diepi-mcp-incomplete-Markierung zunächst exklusiv, schreibt dann den gestaffelten Payload per exclusive-create und committet schließlich diepi-mcp.json und entfernt die Markierung. Bei einem Fehler bleibt ein unvollständiges Verzeichnis ohne nutzbare Konfiguration zurück; es wird niemals gelöscht oder ein Wettlaufziel übernommen; bitte verwenden Sie stattdessen ein neues Verzeichnis oder lassen Sie den Host-Besitzer den Inhalt prüfen und manuell bereinigen. Die erzeugte Konfiguration enthält nur relative Pfade; state, results und synthetische Daten verbleiben im Adapter-Home und gelangen nicht in den Agent-Arbeitsbereich oder das Git-Repository. examples/config.example.json dient nur als Schema-Referenz und muss nicht manuell kopiert werden. In Produktionsumgebungen sollte zusätzlich über Dateiberechtigungen sichergestellt werden, dass der Agent Marktdaten nur lesen und weder Konfiguration, MCP-Umgebung, state noch results-Root beschreiben kann.

Die DSH-Plugin-Verwaltung ruft nacktes pnpm auf. Node kann die von DSH verwendete Version über Corepack fixieren:

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

Wenn das aktuelle Node kein corepack enthält, installieren Sie es bitte gemäß der offiziellen Corepack/pnpm-Dokumentation und fahren Sie fort. Installieren Sie in das web-Profil, nicht in ein beliebiges benutzerdefiniertes Profil, das nur das Basis-Bundle enthält:

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

Änderungen an Plugin-Mitgliedern werden erst bei einem neuen DSH-Prozess wirksam. Für Headless-Nutzung:

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

Wenn Sie das Test-Bundle aus diesem Repository auschecken, ersetzen Sie den Paketnamen im Repository-Stammverzeichnis durch ./dsh. Installieren Sie das npm-Paket nicht direkt von der Repository-URL; das npm-Paket befindet sich im Unterverzeichnis dsh/.

Beim Aktivieren erzwingt das Bundle, dass DIEPI_MCP_COMMAND und DIEPI_MCP_CONFIG explizite absolute Pfade sind. Es greift nicht auf gleichnamige ausführbare Dateien im PATH zurück und errät auch keinen Konfigurationsspeicherort. Der Arbeitsordner des MCP-Unterprozesses ist fest auf das Host-eigene Konfigurationsverzeichnis gesetzt, nicht auf den Agent-Arbeitsbereich.

Von natürlicher Sprache zum Backtest

Beispiel:

Verwenden Sie 510300.SH-Tagesdaten, kaufen Sie voll ein, wenn die 5-Tage-Linie die 20-Tage-Linie von unten kreuzt, und verkaufen Sie voll, wenn sie von oben kreuzt; Backtest für 2024.

Der Agent erstellt zunächst eine überprüfbare StrategySpec v1 und ruft dann der Reihe nach auf:

1. capabilities

2. preview_strategy

3. validate_data

4. start_backtest mit einer neuen submission_id, die mit req_ beginnt

5. job_status, bei Bedarf cancel_job

6. get_result

Bei MCP-Timeout oder Übertragungsunterbrechung muss mit exakt denselben Parametern und derselben submission_id wiederholt werden. Nur wenn alle folgenden Bedingungen erfüllt sind, dürfen Ergebnisse verglichen werden:

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

Eigene Marktdaten und Tushare-Skill

Die minimale Eingabe sind rohe Tagesdaten gemäß diePi market_data_v1; die beste Eingabe sind vollständig ausgerichtete rohe, HFQ- und ursprüngliche Anpassungsfaktor-Dreischienendaten. Dass eine Upstream-Schnittstelle Daten als hfq bezeichnet, beweist nicht, dass sie die Faktor-Invarianz von diePi erfüllt; maßgeblich ist der diePi-Validator.

Das Plugin enthält keine eingebauten Konnektoren, transportiert keine echten Marktdaten, speichert keine Token und installiert auch keine externen Skills automatisch. Bei fehlenden Daten kann der Agent den Nutzer zur unabhängig installierten Tushare offizielle Skill führen. Wir dokumentieren nur einen geprüften Upstream-Commit als manuelle Übergabereferenz; Installation, Netzwerkberechtigungen, Zugangsdaten, Anbieterbedingungen und Aktualisierungsentscheidungen liegen vollständig beim Nutzer. Ausführliche Regeln finden Sie unter Tushare handoff.

Die externe Skill schreibt nur in ein neues Staging-Root. Der Host-Besitzer muss außerhalb der Sitzung validieren, als undurchsichtiges dataset registrieren, das Daten-Root einfrieren und MCP neu starten; eine einzelne Agent-Sitzung darf diese Grenze nicht überspringen.

Versions- und Kompatibilitätsstrategie

• diepi-mcp==0.1.0a1 hängt exakt von diepi==0.1.1 ab. Dies ist beabsichtigt: Der Adapter hängt derzeit von den Abbruch-Callbacks, Quellen-Identität, Kalender-Identität und atomaren Artefakt-Semantiken von diePi ab; ein breiter 0.1.x-Bereich kann Kompatibilität nicht beweisen.

• DSH rc.7 ist die primär unterstützte Alpha-Version; rc.8 ist die Canary-Vorschau. Beide befinden sich noch in der Developer Preview; für rc.8-Tests sollte eine separate DSH_HOME verwendet werden, nicht der rc.7-Sitzungszustand.

• Das Harness bringt @deepseek-ai/dsh-mcp-client und @deepseek-ai/dsh-skill-filesystem mit; dieses Bundle enthält sie nicht erneut.

Die harte Veröffentlichungsreihenfolge verlangt, dass diepi==0.1.1 zuerst aus dem koordinierten Python-Index installierbar ist; die Plugin-CI muss davor fehlschlagen, anstatt den Pin zu lockern. Anschließend validiert das Release-Gate den SHA-256 der Download-Kandidaten, installiert das sdist in einer sauberen Umgebung und testet in den vier Kombinationen Windows/Ubuntu, Node 22/24, web/headless, DSH rc.7/rc.8 das Wheel und das gepackte npm-tgz. In jeder Kombination wird ein direkter MCP-/Adapter-Synthetic-Smoke-Test mit echtem DSH-Start ausgeführt; nach dem Settle des Loaders werden strikt die acht mcp__diepi__*-Tools entdeckt und capabilities aufgerufen. Diese modellfreie Schlüsselsonde beansprucht keine Abdeckung von DSH-vermittelten Abbrüchen, Crash-Wiederverbindungen oder echten Modelleffekten; diese Grenzfälle werden durch Quellcode-Tests oder separat dokumentierte manuelle Release-Validierungen abgedeckt.

Sicherheitsgrenzen

MCP stdio ist ein Host-Prozess und befindet sich nicht in der Datei-Sandbox des Agents. Konfiguration, ausführbare Dateien, Daten-Root, state und results müssen vom Host-Besitzer kontrolliert werden. Hashes beweisen die Identitätskonsistenz zwischen Artefakten, können aber ein Agent-beschreibbares Verzeichnis nicht in eine vertrauenswürdige Beweiswurzel verwandeln, noch beweisen sie echte Marktdaten, rechtmäßige Autorisierung oder das Fehlen von Survivorship-Bias.

Das detaillierte Bedrohungsmodell und der Eingang für vertrauliche Schwachstellenmeldungen finden Sie unter SECURITY.md.

Entwicklung

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

Beitragsregeln finden Sie unter CONTRIBUTING.md, Versionsänderungen unter CHANGELOG.md.

Haftungsausschluss und Lizenz

Dieses Projekt dient ausschließlich der Software-Engineering-Validierung, quantitativen Forschung und historischen Backtests. Die Ausgaben stellen keine Anlageberatung, Handelsaufforderung, Ertragszusage oder Broker-Dienstleistung dar; Backtests können durch Datenqualität, Survivorship-Bias, Anpassungsfaktoren, Abgleichsannahmen, Gebühren, Slippage und Überanpassung beeinträchtigt werden. Der Nutzer trägt die Verantwortung für Datenquellen, Anbieterlizenzen, Modellnutzung und Anlageentscheidungen.

Apache-2.0, siehe LICENSE. Drittbeziehungen siehe THIRD_PARTY_NOTICES.md. Die zugehörigen Namen und Kennzeichen von DeepSeek, DeepSeek Harness und DSH gehören ihren jeweiligen Rechteinhabern; dieses Projekt steht in keiner Zugehörigkeits- oder Befürwortungsbeziehung zu ihnen.