From 0929d11d78e9b43799bc2039c5ff49d9f0b78300 Mon Sep 17 00:00:00 2001
From: Pigbibi <20649888+Pigbibi@users.noreply.github.com>
Date: Tue, 7 Apr 2026 03:29:59 +0800
Subject: [PATCH] docs: publish strategy entrypoint release line

---
 README.md      | 22 ++++++++++++++++++++++
 pyproject.toml |  4 ++--
 2 files changed, 24 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index ec9eb44..f7e9e50 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,17 @@ Standalone crypto strategy repository for QuantStrategyLab platforms.
 
 This repository owns pure strategy logic and strategy metadata. The downstream execution repo still owns exchange access, market-data fetches, runtime state, circuit breakers, Flexible Earn handling, notifications, and order placement.
 
+### Contract boundary
+
+The supported downstream surface is now the manifest-backed unified entrypoint for each live profile.
+
+- `CryptoStrategies` owns pure decision logic and manifest metadata
+- `BinancePlatform` loads that entrypoint through `QuantPlatformKit`
+- shared outputs stay inside `StrategyDecision`
+- exchange-specific safety checks, order sequencing, and artifact freshness handling stay in the execution repo
+
+Legacy `core` / `rotation` modules may still exist as internal implementation details, but downstream runtimes should not bind to those component names anymore.
+
 ### Strategy index
 
 | Profile | Downstream runtime today | Core idea |
@@ -95,6 +106,17 @@ These strategies are consumed by platform repositories through `QuantPlatformKit
 
 这个仓库负责纯策略逻辑和策略元数据。下游执行仓库继续负责交易所接入、行情获取、运行时状态、熔断、Flexible Earn、通知和实际下单。
 
+### 契约边界
+
+当前正式对下游开放的是每个 live profile 的 manifest 驱动统一 entrypoint。
+
+- `CryptoStrategies` 负责纯决策逻辑和 manifest 元数据
+- `BinancePlatform` 通过 `QuantPlatformKit` 加载这个 entrypoint
+- 共享输出保持在 `StrategyDecision` 契约内
+- 交易所专属安全检查、下单顺序和 artifact 新鲜度校验继续放在执行仓库
+
+旧的 `core` / `rotation` 模块可以继续作为仓库内部实现细节存在，但下游运行时不应再绑定这些组件名。
+
 ### 策略索引
 
 | 策略档位 | 当前下游运行仓库 | 核心思路 |
diff --git a/pyproject.toml b/pyproject.toml
index d17b891..1cfde2a 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -4,12 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "crypto-strategies"
-version = "0.3.0"
+version = "0.4.0"
 description = "Shared crypto 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]