diff --git a/README.md b/README.md index 9e4df396..d3d9e313 100644 --- a/README.md +++ b/README.md @@ -11,6 +11,17 @@ Standalone `us_equity` strategy repository for QuantStrategyLab platforms. This repository is the strategy layer: it owns pure signal, allocation, and target-computation logic plus strategy metadata. Downstream platform repositories still own broker adapters, order routing, schedule, secrets, and notifications. +### Contract boundary + +The current integration path is: + +- live profiles expose manifest-backed unified entrypoints +- downstream platforms load those entrypoints through `QuantPlatformKit` +- strategy outputs stay inside the shared `StrategyDecision` contract +- broker-specific execution order, UI rows, and notification layout stay in platform repositories + +Legacy strategy functions may still exist as internal adapters, but downstream runtimes should treat `entrypoints/` and manifests as the supported integration surface. + ### Strategy index | Canonical profile | Display name | Compatible platforms | Cadence | Benchmark | Role | Status | @@ -273,6 +284,17 @@ PYTHONPATH=src:. python3 scripts/backtest_russell_1000_multi_factor_defensive.py 这个仓库负责**纯策略层**:信号、仓位、目标权重计算,以及策略元数据。下游平台仓库继续负责券商适配、下单方式、调度、密钥和通知。 +### 契约边界 + +当前主线集成方式已经固定为: + +- live profile 暴露 manifest 驱动的统一 entrypoint +- 下游平台通过 `QuantPlatformKit` 加载这些 entrypoint +- 策略输出保持在共享 `StrategyDecision` 契约内 +- 券商专属执行顺序、UI 展示行和通知布局继续留在平台仓库 + +旧策略函数可以继续作为仓库内部 adapter 存在,但下游运行时应把 `entrypoints/` 和 manifest 当成正式接入面。 + ### 策略索引 | Canonical profile | 显示名 | 当前下游运行仓库 | 核心思路 | diff --git a/pyproject.toml b/pyproject.toml index 7b627269..bb8c7fdc 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta" [project] name = "us-equity-strategies" -version = "0.6.0" +version = "0.7.0" description = "Shared US equity strategy catalog and implementations" readme = "README.md" requires-python = ">=3.11" dependencies = [ - "quant-platform-kit @ git+https://github.com/QuantStrategyLab/QuantPlatformKit.git@5174d9e40f79fffae47450a42e26434145d28b31", + "quant-platform-kit @ git+https://github.com/QuantStrategyLab/QuantPlatformKit.git@v0.7.0", ] [tool.setuptools]