小哥交易知識來源與產出物盤點

# 邏輯名稱 → (分組資料夾, 分組內的目錄名)。
# 分組資料夾為 None 代表「整個目錄被改名」而非搬進群組（notes／decks）。
LAYOUT: dict[str, tuple[str | None, str]] = {
    # 影片線
    "frames": ("YT影片線", "frames"),
    "transcripts": ("YT影片線", "transcripts"),
    "rule_cards": ("YT影片線", "rule_cards"),
    # 教材線
    "doc_pages": ("doc教材線", "doc_pages"),
    "doc_rule_cards": ("doc教材線", "doc_rule_cards"),
    "doc_notes": ("doc教材線", "doc_notes"),
    # 課程線
    "course_frames": ("course線上課程線", "course_frames"),
    "course_transcripts": ("course線上課程線", "course_transcripts"),
    "course_notes": ("course線上課程線", "course_notes"),
    "course_rule_cards": ("course線上課程線", "course_rule_cards"),
    # 選股線（2026-09-08）：規格 YAML／審閱表進版控，行情 parquet 與 HTML 不進
    "rule_specs": ("screener選股線", "rule_specs"),
    "screen_review": ("screener選股線", "review"),
    "market_data": ("screener選股線", "market_data"),
    "screen": ("screener選股線", "screen"),
    "feature_store": ("screener選股線", "feature_store"),
    "floor_list": ("screener選股線", "floor_list"),
    # 整份被改名的
    "notes": (None, "notes主手冊"),
    "decks": (None, "decks簡報線"),
}

def source_key(prov: dict) -> str | None:
    if prov.get("source") == "doc":
        doc, section = prov.get("doc"), prov.get("section")
        # 必須含教材名——兩份教材各有 1-1，只用小節鍵會把兩個不同小節算成同一個
        return f"doc｜{doc}｜{section}" if doc and section else None
    if prov.get("source") == "course":
        # 單位刻意是課程，不是影片 key——同一門課的多支影片算一次提及
        course = prov.get("course")
        return f"course｜{course}" if course else None
    if prov.get("source") == "external":
        # 外部筆記（2026-09-24 起）：一份筆記算一次；同篇貼文的多張卡共用 note_id
        origin, note_id = prov.get("origin"), prov.get("note_id")
        return f"external｜{origin}｜{note_id}" if origin and note_id else None
    if prov.get("source") == "ppa":
        # PPA：一篇文章算一次，同篇多支影片不灌水（與課程線同理）；必須排在「缺 source 視為影片」之前
        article = prov.get("article_dir")
        return f"ppa｜{article}" if article else None
    # source 缺漏一律視為影片：09-25 前影片萃取器從不寫這欄，現已補上，這條保留作防線
    vid = prov.get("video_id")
    return f"video｜{vid}" if vid else None

rule_id: floor-stock-rebound-strategy
title: 地板股搶反彈：收盤跌破地板且本日放大量
direction: 做多
timeframe: 搶反彈        # 2026-09-23 新增的第五個 timeframe
conditions:
- field: at_floor          # 來自 feature_store 地板股資料庫
  op: ==
  value: true
- field: vol_ratio_incl    # 含當日的 20 日均量倍數，不是 vol_ratio
  op: '>='
  value: 2.0
threshold_source: 補的     # 地板門檻非原話；量能 2 倍是原話，但單一欄位只能誠實標「補的」
status: approved          # PM 手動拍板，propose_rule_specs 不會覆寫