From 083d6ae9c7c25daf9c9e268da6e23ebd6f2ae533 Mon Sep 17 00:00:00 2001
From: Codex <codex@users.noreply.github.com>
Date: Tue, 3 Nov 2026 02:24:27 +0800
Subject: [PATCH] docs: define the paper trading minimum observation period

---
 .../strategy-promotion-risk-standard.zh-CN.md | 30 +++++++++++++++++++
 1 file changed, 30 insertions(+)

diff --git a/docs/strategy-promotion-risk-standard.zh-CN.md b/docs/strategy-promotion-risk-standard.zh-CN.md
index 51d5099c..32a60110 100644
--- a/docs/strategy-promotion-risk-standard.zh-CN.md
+++ b/docs/strategy-promotion-risk-standard.zh-CN.md
@@ -26,6 +26,36 @@
 
 补充约束：Kelly 只能输出研究建议，必须同时受现有组合风险预算、仓位上限和 fractional Kelly 上限约束，不能增加或覆盖既有预算。默认样本不足、缺少正负收益两侧、缺少回撤观测或超过回撤上限时，结果必须为 `PARKED` 且建议仓位为零；不得用小样本外推。
 
+## Paper-trading minimum observation period
+
+模拟交易（Paper）的最短观察期按**相关交易所日历中已结束的完整交易日**计算，
+不能按日历日或经过的小时数换算。观察必须覆盖该交易日的完整交易时段；
+尚未收盘、只观察了部分时段、半日市、提前中止的交易日均不计入。
+交易所休市的周末、节假日也不计入；日历、时区或完整时段证据缺失时，
+不得推定该日有效。同一完整交易日只计一次。
+
+最短观察期只允许显式设置为 **3 至 5（含）之间的整数**，推荐 **5 个完整交易日**。
+采用更严格的 fail-closed 口径：未设置、缺失、无法读取、类型无效或超出范围时，
+均判定为**门槛未满足**，不能回退为较低天数，也不能仅因已观察 5 天而通过。
+布尔值不视为整数；`None`、字符串 `"5"`、浮点数 `3.0`、`True`、`False`，
+以及 `2`、`6`、`0` 和负数均无效；只有整数 `3`、`4`、`5` 有效。
+推荐值是有效配置的选择建议，不是配置缺失或错误时的自动放行值。
+
+达到最短观察期只是必要条件，不代表 `live_ready` 已通过，也不自动获得晋级
+或资金权限。仍须确认对账无差异、告警已解决、既有风险检查保持不变且通过，
+并由 owner 在网站上另行作出决定。3–5 个交易日的样本较短，可能漏掉运行故障
+或不同市场状态；不能用天数达标替代这些检查。Live、Kelly、所有止损开关
+（包括 `PORTFOLIO_LOSS_STOPLOSS_ENABLED`）保持 OFF，本规则不启用任何开关。
+
+本节仅规定通用 Paper 最短观察期，不缩短或覆盖候选专属的研究、Shadow 或
+前瞻观察窗口。[前瞻观察自动化契约](forward-observation-runtime-contract.zh-CN.md)
+中的冻结 policy 继续适用，包括 SOXL 的 252 个交易日示例；候选所需窗口尚未
+完成时，不能凭本节 3–5 天要求达标而认定其完成。
+
+本节为书面规则，尚未接入通用 Paper 天数配置、交易日计数器或机器放行检查；
+现有 validator、schema 和晋级检查的行为不变，不能以本文存在作为机器验证
+或运行时已满足门槛的证据。
+
 ## 风险指标最低标准
 
 证据包里的 `risk` 必须至少包含以下内容：