策略管理与版本化:改了规格就要升版本

注册 ma_cross@1.0.0   指纹 6b30f73cc9f0

改了规格却不升版本 → 被拒绝：
  版本冲突：ma_cross@1.0.0 已存在且指纹不同
            （6b30f73cc9f0 vs b44970cb9ee2）
            **改了规格就要升版本** —— 这条不能绕过。

一、注册表只做三件事

@dataclass
class StrategyVersion:
    name: str
    version: str
    spec: dict
    fingerprint: str = ""      # 自动由 spec 的 sha256 生成

"不做自动升版本"是刻意的。 自动升版本会让人失去"我改了一个会影响结果的东西"这个感觉——而那个感觉正是版本号存在的理由。

二、什么算"改了规格"

指纹是 spec 全字段的 sha256,所以任何字段变化都会改指纹:

🔧 动手做:偷偷改一个参数,却不升版本号——看它让不让(5 分钟)

跑策略注册的例子:先注册 [email protected],再只把 fast 从 5 改成 10,用同一个版本号 1.0.0 重新注册。

你会看到(实测):注册被拒绝,提示指纹冲突——同样是 1.0.0,指纹却从 6b30f73cc9f0 变成了 b44970cb9ee2。

想明白:"版本号"靠人自觉,人会偷懒——改了参数还挂着旧版本号,以后没人知道 1.0.0 到底是哪套参数。指纹把规格(参数、逻辑)哈希成一个值,一路带到回测结果里:你改了任何东西,指纹就变,想赖都赖不掉。改了规格就必须升版本——这条规矩由代码强制,不靠自觉。

三、指纹要一路带到底

系统里每一个环节都带着它:

Signal(spec_hash=...)      →  策略发出的每个信号
OrderReq(strategy=...)     →  每一笔委托
BacktestTask(strategy_fp)  →  每一次回测（p8.5）
equity.jsonl               →  每一条净值记录

这样任何一条净值曲线、任何一笔成交,都能反查到"它是哪份规格产生的"。

反过来说:如果一个系统里的成交记录没有策略指纹,那它出了问题就只能靠猜。

四、版本号怎么升(接 p4.10 的量化库规矩)

第二行是量化特有的,p4.10 已经讲过理由:

使用者会拿新版本重跑旧策略。结果变了却没提示,比 API 不兼容更危险——API 不兼容会立刻报错,结果变化不会。

📌 免责:本课为技术教学,策略仅为演示口径,不构成投资建议。