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는 알 수 없는 타임아웃 재시도를 멱등적으로 유지합니다.

• 데이터 소스, 거래일 달력, 전략 템플릿, 실행 파라미터 및 최종 artifact가 계층별로 바인딩됩니다.

• DSH 번들은 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을 배타적으로 점유(claim)하고, 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 공식 설명에 따라 먼저 설치한 후 계속하세요. base 번들만 포함된 임의의 커스텀 프로필이 아니라 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로 바꾸세요. Git 저장소 루트 URL에서 직접 npm 패키지를 설치하지 마세요; npm 패키지는 dsh/ 하위 디렉터리에 있습니다.

번들은 활성화 시 DIEPI_MCP_COMMAND와 DIEPI_MCP_CONFIG가 모두 명시적 절대 경로일 것을 강제합니다. PATH에서 동일한 이름의 실행 파일로 폴백하지 않으며, 구성 위치를 추측하지도 않습니다. MCP 하위 프로세스의 작업 디렉터리는 Agent 작업 공간이 아닌 host-owned 구성 디렉터리로 고정됩니다.

자연어에서 백테스트까지

예:

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로 안내할 수 있습니다. 우리는 검토된 업스트림 commit 하나만 수동 인수인계 참조로 기록합니다; 설치, 네트워크 권한, 자격증명, 공급업체 약관 및 업데이트 결정은 모두 사용자가 제어합니다. 자세한 규칙은 Tushare handoff를 참조하세요.

외부 Skill은 데이터를 새 staging 루트에 쓰는 역할만 담당합니다. host owner는 세션 외부에서 검증하고, 불투명한 dataset_id로 등록하고, 데이터 루트를 동결한 후 MCP를 재시작해야 합니다; 단일 Agent 세션은 이 경계를 건너뛸 수 없습니다.

버전 및 호환성 정책

• diepi-mcp==0.1.0a1은 diepi==0.1.1에 정확히 의존합니다. 이는 의도적입니다: adapter는 현재 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 index에서 설치할 수 있어야 한다는 것입니다; 플러그인 CI는 그 전에 pin을 완화하는 대신 실패해야 합니다. 이후 릴리스 게이트는 다운로드 후보의 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를 호출합니다. 이 무모델 key 프로브는 DSH를 통한 취소, 크래시 재연결 또는 실제 모델 효과를 커버한다고 주장하지 않습니다; 이러한 경계는 소스 테스트 또는 별도로 기록된 수동 릴리스 검증이 담당합니다.

보안 경계

MCP stdio는 host 프로세스이며, Agent 파일 샌드박스 안에 있지 않습니다. 구성, 실행 파일, 데이터 루트, state 및 results는 host owner가 제어해야 합니다. 해시는 아티팩트 간의 정체성 일관성을 증명하지만, 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 참조. 제3자 관계는 THIRD_PARTY_NOTICES.md를 참조하세요. DeepSeek, DeepSeek Harness 및 DSH 관련 명칭과 로고는 각 권리 보유자의 소유입니다; 이 프로젝트는 이들과 제휴 또는 보증 관계가 없습니다.