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-бандл 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-бандл автоматически подключает восемь ограниченных MCP-инструментов и навык diepi-quant-research Skill.

Пока не поддерживаются произвольный Python, минутные протоколы стратегий, шорт, кредитное плечо, фьючерсы, реальная торговля, учётные данные брокера, встроенная загрузка котировок, оптимизатор параметров или GUI. Модель не может передавать через этот плагин пути, команды, SQL или исходный код Python.

Related MCP server: OpenFinClaw CLI

Пятиминутный synthetic-опыт

При первом опыте не читаются реальные котировки из этого репозитория или репозитория diePi. diepi-mcp init-config эксклюзивно занимает новый adapter home за пределами рабочей области DSH и вызывает тот же детерминированный demo-генератор diePi, создавая вымышленные цены, объёмы, торговые дни и метки ценных бумаг; эти данные используются только для проверки установки и соединения протокола.

Требования:

• 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 и создайте новый корень, принадлежащий хосту. 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, затем записывает staged payload с exclusive-create и только потом фиксирует diepi-mcp.json и удаляет маркер. При сбое остаётся неполный каталог без рабочей конфигурации; он никогда не удаляет и не перехватывает конкурентную цель; используйте новый каталог или вручную очистите его после проверки владельцем хоста. Сгенерированная конфигурация содержит только относительные пути; state, results и synthetic-данные остаются в adapter home и не попадают в рабочую область агента или Git-репозиторий. examples/config.example.json — это только справочник по схеме, его не нужно копировать вручную. В производственной среде следует также с помощью прав доступа к файлам дать агенту только чтение котировок и запретить запись в конфигурацию, 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. Для headless-режима:

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

При проверке тестового бандла из этого репозитория замените имя пакета на ./dsh в корне репозитория. Не устанавливайте npm-пакет напрямую из корневого URL репозитория Git; npm-пакет находится в подкаталоге dsh/.

При активации бандл принудительно требует, чтобы DIEPI_MCP_COMMAND и DIEPI_MCP_CONFIG были явными абсолютными путями. Он не откатывается к исполняемому файлу с тем же именем в PATH и не угадывает расположение конфигурации. Рабочий каталог дочернего MCP-процесса фиксируется как каталог конфигурации, принадлежащий хосту, а не рабочая область агента.

От естественного языка к бэктесту

Например:

Используй дневные данные 510300.SH, при пересечении 5-дневной скользящей вверх через 20-дневную — полная позиция, при пересечении вниз — выход; прогони бэктест за 2024 год.

Сначала агент генерирует проверяемый StrategySpec v1, затем последовательно вызывает:

1. capabilities

2. preview_strategy

3. validate_data

4. start_backtest с новым submission_id, начинающимся с req_

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

Минимальный ввод — это raw-дневные данные, соответствующие diePi market_data_v1; наилучший ввод — полностью выровненные три дорожки: raw, HFQ и исходные коэффициенты реинвестирования. То, что вышестоящий интерфейс называет данные hfq, не доказывает, что они удовлетворяют тождеству коэффициентов diePi; окончательное решение за валидатором diePi.

Плагин не содержит встроенных коннекторов, не поставляет реальные котировки, не хранит токены и не устанавливает внешние навыки автоматически. При отсутствии данных агент может направить пользователя к отдельно установленному официальному навыку Tushare. Мы фиксируем только проверенный вышестоящий коммит как справочную точку ручной передачи; установка, сетевые разрешения, учётные данные, условия поставщика и решения об обновлении контролируются пользователем. Подробные правила см. в Tushare handoff.

Внешний навык отвечает только за запись данных в новый корень staging. Владелец хоста должен вне сеанса проверить, зарегистрировать как непрозрачный dataset_id, заморозить корень данных и перезапустить MCP; один сеанс агента не может обойти эту границу.

Версии и стратегия совместимости

• diepi-mcp==0.1.0a1 точно зависит от diepi==0.1.1. Это намеренно: адаптер в настоящее время зависит от семантики отмены, доказательств происхождения, календарной идентичности и атомарных артефактов diePi, и широкий диапазон 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 в чистом окружении и устанавливает wheel и упакованный npm tgz в четырёх комбинациях: Windows/Ubuntu, Node 22/24, web/headless, DSH rc.7/rc.8. В каждой ячейке выполняется прямой MCP/adapter synthetic smoke на wheel и реально запускается DSH; после стабилизации Loader строго обнаруживаются восемь инструментов mcp__diepi__* и вызывается capabilities. Этот безмодельный ключевой зонд не претендует на покрытие отмены через DSH, переподключения при сбое или эффектов реальной модели; эти границы покрываются исходными тестами или отдельно задокументированным ручным выпускным тестированием.

Границы безопасности

MCP stdio — это процесс хоста, он не находится в файловой песочнице агента. Конфигурация, исполняемые файлы, корень данных, state и results должны контролироваться владельцем хоста. Хэши доказывают согласованность идентичности между артефактами, но не превращают каталог, доступный для записи агенту, в доверенный корень доказательств и не доказывают подлинность котировок, законное разрешение или отсутствие систематической ошибки выжившего.

Подробная модель угроз и канал для конфиденциальных отчётов об уязвимостях — в 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 принадлежат их соответствующим правообладателям; этот проект не аффилирован с ними и не одобрен ими.