重置项目

refer/backend/app/tickflow/policy.py

@@ -31,9 +31,8 @@ _CAPSET_CACHE_FILE = "capabilities.json"
 # 旧缓存(无此字段或版本更低)会被判定过期,触发重新探测。
 # v2: 拆分 depth5 → depth5(单只) + depth5.batch(批量)
 # v3: 探测补全 quote.batch(此前 tiers.yaml 声明了但 _probe_real 漏探测)
-# v4: 5 档重构 —— 新增 none 档(无key/无效key),free 档重定义(走 free-api 服务器,
-#     仅历史日K)。判定改为复权因子分水岭:_classify_tier 接管档位判定。
-_CACHE_SCHEMA_VERSION = 4
+# v5: Free 档补充付费服务器 quote.by_symbol(10rpm/5标的),用于自选股实时监控。
+_CACHE_SCHEMA_VERSION = 5
 
 # 探测用最小代价请求:挑流通性最好的 1 只标的试
 _PROBE_SYMBOL = "600000.SH"  # 浦发银行,长期不会退市
@@ -110,7 +109,7 @@ def _call_with_retry(fn, attempts: int = 3, backoff: float = 0.6) -> None:
 def _probe_real(tiers: dict) -> tuple[CapabilitySet, list[str]]:
     """逐 capability 试探。需要 API key。
 
-    **关键**:探测始终在付费端点上进行,用 key 鉴权验证有效性。
+    **关键**:探测始终在付费端点(api.tickflow.org)上进行,用 key 鉴权验证有效性。
     绝不能读旧 capabilities 缓存的档位来选服务器 —— 否则首次保存 key 时,
     旧缓存是 none 档 → get_client() 返回 free 服务器 → free 服务器忽略 key →
     乱填 key 也能拿到日K → 误判成 free 档(鸡生蛋蛋生鸡的循环依赖 bug)。
@@ -122,7 +121,7 @@ def _probe_real(tiers: dict) -> tuple[CapabilitySet, list[str]]:
 
     key = secrets_store.get_tickflow_key()
     # 探测专用客户端:强制走付费端点验证 key。
-    # base_url 用用户自定义端点(若已配置测速切换),否则默认付费端点。
+    # base_url 用用户自定义端点(若已配置测速切换),否则默认 api.tickflow.org。
     probe_base = _base_url() or PAID_ENDPOINT
     tf = TickFlow(api_key=key, base_url=probe_base)
     available: dict[Cap, CapabilityLimits] = {}
@@ -278,7 +277,7 @@ def detect_capabilities(force: bool = False) -> CapabilitySet:
             _persist(capset, "None", log=probe_log, missing=[], extras=[], invalid_key=True)
             return capset
         if classified.is_free:
-            # 免费有效 key:能力按 free 档(= none 档能力,走 free-api 服务器)
+            # 免费有效 key:按 free 档能力持久化(日K free-api + 按标的实时)。
             capset = _tier_to_capset(tiers["free"])
             _persist(capset, "Free", log=probe_log + ["✓ 免费有效 key(运行时走 free-api 服务器)"], missing=[], extras=[])
             return capset