Upload 24 files

app.py

@@ -1,483 +1,46 @@
-"""
-Chan Compass — US edition
-Multi-timeframe Chan-theory signals · sector rotation · local-LLM research.
-
-UI follows Adobe Spectrum 2 design language (https://s2.spectrum.adobe.com /
-github.com/adobe/react-spectrum), approximated in Gradio CSS:
-  * Adobe Clean is proprietary → Source Sans 3 (Adobe's open font) instead
-  * Spectrum 2 accent blue #0265DC, gray-50 canvas, white cards
-  * signature fully-rounded "pill" buttons, soft 16px card radii, focus rings
-"""
-from __future__ import annotations
-
-import os
-import threading
-
-import gradio as gr
-import pandas as pd
-
-import automation
-import emailer
-import finetune_data
-import llm_local
-import news_watch
-import paths
-import research_agent
-import rotation
-import signal_runner
-
-# ─────────────────────────────────────────── Spectrum 2 theme ──
-# Single source of truth: theme.py from the Chan Compass · Spectrum 2 design
-# system (tokens mirrored from the design package's tokens/*.css).
-from theme import THEME as theme, CSS as S2_CSS
-
-# ─────────────────────────────────────────── UI callbacks ──
-def ui_run_signals(tickers_text, force):
-    """Signals ONLY — pure rule engine, zero LLM, parallel downloads. Fast."""
-    import time
-    t0 = time.time()
-    tickers = [t for t in tickers_text.replace("\n", ",").split(",") if t.strip()]
-    df, details, summary, errors = signal_runner.run_signals(tickers or None,
-                                                             force=bool(force))
-    if errors:
-        summary += " · some tickers skipped (data not ready yet — run again)"
-    automation.STATE["signals_df"] = df
-    automation.STATE["signals_details"] = details
-    automation.STATE["signals_summary"] = summary
-    choices = sorted(details.keys())
-    return (
-        df if df is not None else pd.DataFrame(),
-        f"{summary} · {time.time()-t0:.1f}s (rule engine only — no LLM in this path)",
-        gr.update(choices=choices, value=(choices[0] if choices else None)),
-    )
-
-
-def ui_show_detail(ticker):
-    if not ticker:
-        return "Select a ticker after running the analysis."
-    raw = signal_runner.stock_raw_read(ticker)
-    if not raw:
-        return "No data for this ticker yet — run the analysis first."
-    return f"**Raw read:**\n\n{raw}"
-
-
-def ui_explain_detail(ticker):
-    raw = signal_runner.stock_raw_read(ticker or "")
-    if not raw:
-        yield "Run the analysis and select a ticker first."
-        return
-    # The full Chan ruling chain (Chinese) is kept BACKSTAGE in STATE and fed to
-    # the model alongside the English raw read, so the summary reflects the real
-    # multi-timeframe reasoning — but the chain is never shown and output is
-    # English only. (This restores the merged raw-read + ruling-chain logic.)
-    chain = automation.STATE.get("signals_details", {}).get(ticker or "", "")
-    chain_core = chain.split("日线买卖点逐项诊断")[0].strip()[:2000] if chain else ""
-    prompt = ("You are an equity analyst. Write a SHORT plain-English summary "
-              "(≤100 words) for a long-term holder of a US stock: the situation "
-              "today, whether to act or wait, and the key price levels.\n"
-              "Use the FACT LINE for the numbers, and the RULING CHAIN (a "
-              "Chinese multi-timeframe Chan-theory decision log) for the reasoning "
-              "— translate and synthesize it; output ENGLISH ONLY, no Chinese "
-              "characters, do not quote the log, no disclaimers.\n\n"
-              f"FACT LINE:\n{raw}")
-    if chain_core:
-        prompt += f"\n\nRULING CHAIN (translate & synthesize, don't quote):\n{chain_core}"
-    yield "🤖 _Summary Sub-Agent (Chan-Tuned Qwen3-1.7B · llama.cpp) is explaining…_"
-    final = ""
-    for acc in llm_local.chat_stream(prompt, max_tokens=260, temperature=0.2,
-                                     worker="translator"):
-        final = acc
-        yield "🤖 **AI Summary (Summary Sub-Agent · Chan-Tuned Qwen3-1.7B):**\n\n" + acc
-    # capture (raw read → narrative) as a fine-tuning pair (🎯 Well-Tuned)
-    try:
-        import finetune_data
-        finetune_data.record(raw, final)
-    except Exception:
-        pass
-
-
-def ui_refresh_rotation():
-    """Tables only — instant. AI narrative is a separate on-demand button."""
-    d1, d5, d20, asof = rotation.build_rotation(force=True)
-    automation.STATE["rotation"] = (d1, d5, d20, asof)
-    raw = rotation.rotation_brief(d1, d5, d20)
-    automation.STATE["rotation_narrative"] = raw
-    return (rotation.fmt_table(d1), rotation.fmt_table(d5), rotation.fmt_table(d20),
-            f"Sector flows as of **{asof}**", f"**Raw read:**\n{raw}")
-
-
-def ui_rotation_ai():
-    d1, d5, d20, asof = automation.STATE["rotation"]
-    if d1 is None:
-        yield "Refresh the rotation tables first."
-        return
-    brief = rotation.rotation_brief(d1, d5, d20)
-    prompt = ("You are a US equity market strategist. Based only on the sector flow "
-              "data below (SPDR ETF proxy: change% × dollar volume, plus RS vs SPY), "
-              "write a crisp brief (<150 words): 1) where capital is rotating INTO/OUT "
-              "OF; 2) do 1-day moves agree with the 5/20-day trend; 3) one watch item. "
-              "No disclaimers.\n\nDATA:\n" + brief[:2200])
-    yield ("🤖 _Narrator sub-agent (Qwen3-1.7B · llama.cpp) is reading the flow "
-           "tables — first words in ~5-15s…_")
-    for acc in llm_local.chat_stream(prompt, max_tokens=340, worker="narrator"):
-        yield "🤖 **Narrator sub-agent (Qwen3-1.7B · llama.cpp):**\n\n" + acc
-
-
-def ui_save_holdings(text):
-    saved = news_watch.save_holdings(text.replace("\n", ",").split(","))
-    return f"Saved {len(saved)} holding(s): {', '.join(saved) if saved else '—'}"
-
-
-def ui_check_news():
-    last = ""
-    for md in news_watch.check_holdings_news_stream():
-        last = md
-        yield md
-    automation.STATE["news_md"] = last
-
-
-def ui_research(ticker):
-    progress, report = "", ""
-    for progress, report in research_agent.run_research_stream(ticker):
-        yield progress, report, gr.update()
-    reports = research_agent.list_reports()
-    newest = reports[0] if reports else None
-    yield progress, report, gr.update(choices=reports, value=newest)
-
-
-def ui_open_report(fname):
-    return research_agent.read_report(fname)
-
-
-def ui_load_model(name):
-    return llm_local.load_model(name, worker="deep")
-
-
-
-_SELFTEST = {"done": False, "result": ""}
-
-
-def _publish_traces(repo_id: str):
-    """One-click: upload /data/traces to the Hub as a dataset, using the
-    HF_TOKEN secret. No command line needed."""
-    repo_id = (repo_id or "").strip()
-    if "/" not in repo_id:
-        return "⚠️ Enter a repo id like `username/dataset-name`."
-    token = (os.environ.get("HF_TOKEN") or os.environ.get("HUGGING_FACE_HUB_TOKEN")
-             or "").strip()
-    if not token:
-        return ("⚠️ No `HF_TOKEN` secret found. Add it in Space → Settings → "
-                "Variables and secrets (a **write** token), then try again.")
-    try:
-        import paths
-        traces = [f for f in os.listdir(paths.TRACES_DIR) if f.endswith(".json")]
-    except OSError:
-        traces = []
-    if not traces:
-        return "⚠️ No traces yet — run a few Auto Research reports first."
-    try:
-        from huggingface_hub import HfApi
-        api = HfApi(token=token)
-        api.create_repo(repo_id, repo_type="dataset", exist_ok=True)
-        # a small README so the dataset page explains itself
-        card = (
-            "---\nlicense: mit\ntags: [agent-trace, finance, chan-theory, llama-cpp]\n---\n\n"
-            "# Chan Compass — agent traces\n\n"
-            "JSON traces from the Chan Compass multi-agent research desk. Each file "
-            "is one ticker's run: the plan, every evidence-tool call and its result, "
-            "and each local sub-agent's request and response. Shared for the "
-            "Build Small hackathon (*Sharing is Caring*).\n\n"
-            "*Educational data — not investment advice.*\n")
-        import tempfile
-        rp = os.path.join(tempfile.gettempdir(), "README.md")
-        with open(rp, "w", encoding="utf-8") as f:
-            f.write(card)
-        api.upload_file(path_or_fileobj=rp, path_in_repo="README.md",
-                        repo_id=repo_id, repo_type="dataset")
-        api.upload_folder(folder_path=paths.TRACES_DIR, path_in_repo="traces",
-                          repo_id=repo_id, repo_type="dataset")
-        url = f"https://huggingface.co/datasets/{repo_id}"
-        return (f"✅ Published **{len(traces)}** trace(s) to [{repo_id}]({url}). "
-                f"Put that link in your submission for the *Sharing is Caring* badge.")
-    except Exception as e:
-        return f"❌ Upload failed: {e}"
-
-
-def _export_dataset():
-    n = finetune_data.count()
-    if n == 0:
-        return ("⚠️ **0 training pairs captured yet.** Pairs are saved only when "
-                "the **Signals → AI summary** finishes with a model loaded. Steps: "
-                "1) Model tab — wait for the Summary sub-agent to show ✅; "
-                "2) Signals — Run analysis, pick a ticker, click **AI summary**, "
-                "let it finish; repeat a few times; 3) come back and Export.",
-                gr.update(visible=False))
-    path = finetune_data.export()
-    if not path:
-        return ("⚠️ Export failed to write the file (storage error). Try again.",
-                gr.update(visible=False))
-    # Copy to a folder under the app's working dir, which Gradio serves
-    # reliably (the /data bucket and /tmp are not in Gradio's allowed paths).
-    import shutil
-    served_dir = os.path.join(os.getcwd(), "exports")
-    os.makedirs(served_dir, exist_ok=True)
-    served = os.path.join(served_dir, os.path.basename(path))
-    try:
-        shutil.copy(path, served)
-    except OSError:
-        served = path
-    msg = (f"✅ Exported **{n}** captured pair(s). Download below, then follow "
-           f"`finetune/FINETUNE_GUIDE.md` to LoRA-tune Qwen3-1.7B and publish it.")
-    return msg, gr.update(value=served, visible=True)
-
-
-def _run_selftest():
-    """Run the self-test now (used by both the auto-timer and the manual button)
-    and cache the verdict so the two never fight over the output box."""
-    out = llm_local.quick_test()
-    ok = "not loaded" not in out and "error" not in out.lower()
-    _SELFTEST["done"] = True
-    _SELFTEST["result"] = (("✅ **Every agent is OK now** — self-test passed:\n\n" + out)
-                           if ok else ("⚠️ Self-test finished with issues:\n\n" + out))
-    return _SELFTEST["result"]
-
-
-def _auto_selftest():
-    """Auto-runs ONCE the moment every sub-agent is loaded. After that it returns
-    the cached verdict unchanged, so it never overwrites a manual test result."""
-    if _SELFTEST["done"]:
-        return _SELFTEST["result"]
-    workers = llm_local.WORKERS
-    if not all(w["llm"] is not None for w in workers.values()):
-        ready = sum(1 for w in workers.values() if w["llm"] is not None)
-        return f"⏳ Loading sub-agents… {ready}/{len(workers)} ready (self-test will run automatically)."
-    return _run_selftest()
-
-
-def _manual_selftest():
-    """Manual button: always re-runs and shows the fresh verdict."""
-    return _run_selftest()
-
-
-# ─────────────────────────────────────────── layout ──
-_GR_MAJOR = int(gr.__version__.split(".")[0])
-_style_kw = {} if _GR_MAJOR >= 6 else {"theme": theme, "css": S2_CSS}
-
-with gr.Blocks(title="Chan Compass · US", **_style_kw) as demo:
-    gr.HTML("""
-    <div id="s2-hero">
-      <div class="mark">🧭</div>
-      <div>
-        <h1>Chan Compass <span>· US Markets</span></h1>
-        <p>Multi-timeframe 缠论 (Chan theory) engine — monthly → 1m nested-interval
-           confirmation · sector rotation · local sub-agent pool (llama.cpp).</p>
-      </div>
-      <div class="chips">
-        <span>🧠 Local · no cloud APIs</span><span>🦙 llama.cpp</span>
-        <span>🤖 4 sub-agents · 1.7B+4B</span><span>📊 Yahoo Finance</span>
-        <span>⏰ 18:10 ET</span><span>💾 /data bucket</span><span>🎨 Spectrum 2</span>
-      </div>
-    </div>""")
-
-    with gr.Tab("📈 Signals"):
-        with gr.Row():
-            tickers_in = gr.Textbox(value=", ".join(signal_runner.DEFAULT_POOL),
-                                    label="Ticker pool (comma separated)", scale=4)
-            force_cb = gr.Checkbox(value=False, label="Force fresh download", scale=1)
-            run_btn = gr.Button("▶ Run analysis", variant="primary", scale=1)
-        sig_summary = gr.Markdown(automation.STATE["signals_summary"])
-        sig_table = gr.Dataframe(label="Tomorrow's plan — long-hold mode (sorted: BUY → SELL → HOLD → WAIT)",
-                                 interactive=False, wrap=True)
-        gr.Markdown("**Stock summary** — pick a ticker for a plain-English raw read, "
-                    "then let the Summary sub-agent write an AI Summary.",
-                    elem_classes=["s2-footnote"])
-        with gr.Row():
-            detail_pick = gr.Dropdown(choices=[], label="Ticker", scale=2)
-            explain_btn = gr.Button("🤖 AI summary (local LLM)", scale=1)
-        detail_box = gr.Markdown(label="Raw read")
-        explain_box = gr.Markdown(elem_classes=["llm-out"])
-        with gr.Row():
-            sig_email = gr.Textbox(label="Email this summary to", scale=4,
-                                   placeholder="name@example.com (comma-separate for several)")
-            sig_email_btn = gr.Button("✉ Send Email", scale=1)
-        sig_email_status = gr.Markdown()
-
-    with gr.Tab("🔄 Sector Rotation"):
-        gr.Markdown("Capital rotation across the 11 SPDR sector ETFs (full S&P 500 coverage). "
-                    "**Flow proxy = price change % × dollar volume**; RS = return minus SPY. "
-                    "True per-sector fund-flow feeds are paid data — this is the standard free proxy.")
-        with gr.Row():
-            rot_btn = gr.Button("↻ Refresh rotation (instant)", variant="primary")
-            rot_ai_btn = gr.Button("🤖 AI narrative (local LLM)")
-        rot_asof = gr.Markdown("Press refresh (or Run analysis on the Signals tab).")
-        with gr.Row():
-            rot_1d = gr.Dataframe(label="1-Day (today's rotation)", interactive=False)
-        with gr.Row():
-            rot_5d = gr.Dataframe(label="5-Day (week trend)", interactive=False)
-            rot_20d = gr.Dataframe(label="20-Day (month trend)", interactive=False)
-        rot_ai = gr.Markdown(label="AI rotation narrative", elem_classes=["llm-out"])
-        with gr.Row():
-            rot_email = gr.Textbox(label="Email this narrative to", scale=4,
-                                   placeholder="name@example.com (comma-separate for several)")
-            rot_email_btn = gr.Button("✉ Send Email", scale=1)
-        rot_email_status = gr.Markdown()
-
-    with gr.Tab("📰 Watchlist News"):
-        gr.Markdown("Daily rule: for each **holding**, only **today's** news is checked. "
-                    "News found → AI brief is pushed below. No news → the ticker is ignored "
-                    "(listed under *Quiet today*).")
-        with gr.Row():
-            hold_in = gr.Textbox(value=", ".join(news_watch.load_holdings()),
-                                 label="My holdings (comma separated)", scale=3)
-            save_btn = gr.Button("💾 Save holdings", scale=1)
-            news_btn = gr.Button("🔍 Check today's news", variant="primary", scale=1)
-        hold_status = gr.Markdown()
-        news_out = gr.Markdown(elem_classes=["llm-out"])
-        with gr.Row():
-            news_email = gr.Textbox(label="Email this news brief to", scale=4,
-                                    placeholder="name@example.com (comma-separate for several)")
-            news_email_btn = gr.Button("✉ Send Email", scale=1)
-        news_email_status = gr.Markdown()
-
-    with gr.Tab("🧪 Auto Research"):
-        gr.Markdown("**Multi-step research agent** (fully local): PLAN → 5 evidence tools "
-                    "(fundamentals · quarterly financials · price action · **the Chan engine "
-                    "itself** · news) → section-by-section analysis → report. Every step is "
-                    "logged to a JSON **agent trace** on persistent storage. "
-                    "New tickers entering the signal pool get a report **auto-generated** "
-                    "by the daily pipeline.")
-        with gr.Row():
-            res_in = gr.Textbox(label="Ticker", placeholder="e.g. NVDA", scale=3)
-            res_btn = gr.Button("🤖 Run research agent", variant="primary", scale=1)
-        res_progress = gr.Markdown()
-        res_out = gr.Markdown(elem_classes=["llm-out"])
-        with gr.Row():
-            res_email = gr.Textbox(label="Email this report to", scale=4,
-                                   placeholder="name@example.com (comma-separate for several)")
-            res_email_btn = gr.Button("✉ Send Email", scale=1)
-        res_email_status = gr.Markdown()
-        gr.Markdown("**Report library** (auto + manual, stored on `/data`):",
-                    elem_classes=["s2-footnote"])
-        with gr.Row():
-            rep_pick = gr.Dropdown(choices=research_agent.list_reports(),
-                                   label="Saved reports", scale=3)
-            rep_open = gr.Button("📂 Open report", scale=1)
-        rep_view = gr.Markdown()
-
-    with gr.Tab("⏰ Automation"):
-        gr.Markdown(paths.storage_status())
-        auto_md = gr.Markdown(automation.schedule_info())
-        with gr.Row():
-            auto_now = gr.Button("⚡ Run now", variant="primary")
-        auto_msg = gr.Markdown()
-        auto_log = gr.Textbox(lines=14, label="Pipeline log (live — updates every 2s)",
-                              elem_id="detail-log")
-        traces_md = gr.Markdown(research_agent.list_traces())
-        gr.Markdown("**📡 Share traces** — publish every JSON agent trace in "
-                    "`/data/traces` as a Hugging Face **dataset** (one click, uses "
-                    "your `HF_TOKEN` secret — no command line). Earns *Sharing is "
-                    "Caring*.", elem_classes=["s2-footnote"])
-        with gr.Row():
-            trace_repo = gr.Textbox(
-                value="ranranrunforit/chan-compass-agent-traces",
-                label="Dataset repo id", scale=3)
-            trace_pub = gr.Button("📡 Publish traces as dataset", scale=1)
-        trace_pub_status = gr.Markdown()
-        trace_pub.click(_publish_traces, trace_repo, trace_pub_status)
-        auto_log_timer = gr.Timer(2.0)
-
-        def _auto_tick():
-            log = "\n".join(automation.STATE["log"][-40:]) or "(no log yet)"
-            return log, research_agent.list_traces()
-
-        auto_log_timer.tick(_auto_tick, None, [auto_log, traces_md])
-
-    with gr.Tab("🧠 Model"):
-        gr.Markdown("All AI runs **locally** through **llama.cpp** (llama-cpp-python) with "
-                    "Qwen3 GGUF weights — every option is far below the 32B-parameter cap, "
-                    "and nothing leaves the machine. **First load installs the llama.cpp "
-                    "runtime + downloads the GGUF (one-time, usually 1–3 min; worst case "
-                    "~15 min if it has to compile).** Signals/rotation/news never depend on it.")
-        gr.Markdown("**Sub-agent pool:** Summary Sub-Agent (Chan-Tuned Qwen3-1.7B, "
-                    "fixed) handles Explain / rotation narrative / news briefs; "
-                    "`deep` Analyst writes research reports. Each has its own lock — "
-                    "they run in parallel. Pick the Analyst model below:")
-        model_pick = gr.Radio(choices=list(llm_local.MODEL_ZOO.keys()),
-                              value=llm_local.DEFAULT_MODEL, label="Analyst (deep) model")
-        with gr.Row():
-            load_btn = gr.Button("⬇ Load model", variant="primary")
-            test_btn = gr.Button("⚡ Test sub-agents now")
-        model_status = gr.Markdown(llm_local.status())
-        model_test_out = gr.Markdown()
-        model_timer = gr.Timer(2.0)
-        model_timer.tick(lambda: llm_local.status(), None, model_status)
-        autotest_timer = gr.Timer(3.0)
-        autotest_timer.tick(_auto_selftest, None, model_test_out)
-
-        gr.Markdown("---\n### 🎯 Fine-tuning dataset (Well-Tuned badge)\n"
-                    "Every Signals **AI summary** you run is saved as a "
-                    "(raw read → narrative) training pair on `/data`. Capture a "
-                    "few hundred, export the JSONL, then follow `FINETUNE_GUIDE.md` "
-                    "to LoRA-tune Qwen3-1.7B and publish it.")
-        ft_status = gr.Markdown(finetune_data.status_line())
-        ft_export = gr.Button("⬇ Export dataset (JSONL)", variant="primary")
-        ft_out = gr.Markdown()
-        ft_file = gr.File(label="Download training data", visible=False)
-        ft_timer = gr.Timer(3.0)
-        ft_timer.tick(lambda: finetune_data.status_line(), None, ft_status)
-        ft_export.click(_export_dataset, None, [ft_out, ft_file])
-
-    gr.Markdown("Chan Compass · educational tool, not investment advice · "
-                "data: Yahoo Finance · design language: Adobe Spectrum 2",
-                elem_classes=["s2-footnote"])
-
-    # wiring
-    run_btn.click(ui_run_signals, [tickers_in, force_cb],
-                  [sig_table, sig_summary, detail_pick])
-    detail_pick.change(ui_show_detail, detail_pick, detail_box)
-    explain_btn.click(ui_explain_detail, detail_pick, explain_box)
-    rot_btn.click(ui_refresh_rotation, None, [rot_1d, rot_5d, rot_20d, rot_asof, rot_ai])
-    rot_ai_btn.click(ui_rotation_ai, None, rot_ai)
-    save_btn.click(ui_save_holdings, hold_in, hold_status)
-    news_btn.click(ui_check_news, None, news_out)
-    res_btn.click(ui_research, res_in, [res_progress, res_out, rep_pick])
-    sig_email_btn.click(lambda body, to: emailer.send_result(body, to, "Signals summary"),
-                        [explain_box, sig_email], sig_email_status)
-    rot_email_btn.click(lambda body, to: emailer.send_result(body, to, "Sector rotation"),
-                        [rot_ai, rot_email], rot_email_status)
-    news_email_btn.click(lambda body, to: emailer.send_result(body, to, "Watchlist news"),
-                         [news_out, news_email], news_email_status)
-    res_email_btn.click(lambda body, to: emailer.send_result(body, to, "Research report"),
-                        [res_out, res_email], res_email_status)
-    rep_open.click(ui_open_report, rep_pick, rep_view)
-    auto_now.click(lambda: automation.run_pipeline(force=True), None, auto_msg)
-    load_btn.click(ui_load_model, model_pick, model_status)
-    test_btn.click(_manual_selftest, None, model_test_out)
-
-automation.start_scheduler()
-
-# Auto-load the default local model in the background so AI features (English
-# explanations, rotation narrative, research agent) are ready without a click.
-def _auto_load_model():
-    try:
-        automation._log("Auto-loading sub-agents (llama.cpp)…")
-        llm_local.auto_load_all()
-    except Exception as e:
-        automation._log(f"Sub-agent auto-load failed: {e}")
-
-try:
-    import paths as _paths
-    automation._log(_paths.storage_status())
-except Exception:
-    pass
-if os.environ.get("AUTO_LOAD_MODEL", "1") == "1":
-    threading.Thread(target=_auto_load_model, daemon=True).start()
-
-if __name__ == "__main__":
-    import paths as _p
-    _allowed = [os.path.join(os.getcwd(), "exports"), _p.DATASET_DIR]
-    os.makedirs(_allowed[0], exist_ok=True)
-    if _GR_MAJOR >= 6:
-        demo.launch(theme=theme, css=S2_CSS, allowed_paths=_allowed)
-    else:
-        demo.launch(allowed_paths=_allowed)
+/* ============================================================
+   SPACING & SIZING — Chan Compass · Spectrum 2
+   Spectrum 2 spacing scale (px): 0 2 4 8 12 16 20 24 28 32 40 48 64 80 96.
+   8px is the base rhythm. Padding uses px; layout gaps reuse the same scale.
+   ============================================================ */
+
+:root {
+  --space-0:    0;
+  --space-50:   2px;
+  --space-75:   4px;
+  --space-100:  8px;    /* base unit */
+  --space-150:  12px;
+  --space-200:  16px;
+  --space-250:  20px;
+  --space-300:  24px;
+  --space-400:  32px;
+  --space-500:  40px;
+  --space-600:  48px;
+  --space-700:  64px;
+  --space-800:  80px;
+  --space-900:  96px;
+
+  /* ---- Corner radii (Spectrum 2) ---- */
+  --radius-none:    0;
+  --radius-sm:      4px;    /* chips, small controls   */
+  --radius-default: 8px;    /* inputs, buttons (square)*/
+  --radius-lg:      10px;   /* nested cards            */
+  --radius-xl:      16px;   /* cards, panels          */
+  --radius-2xl:     20px;   /* hero, large surfaces   */
+  --radius-full:    9999px; /* pills, avatars         */
+
+  /* ---- Border widths ---- */
+  --border-width-100: 1px;
+  --border-width-200: 2px;
+  --border-width-400: 4px;
+
+  /* ---- Control heights (medium scale) ---- */
+  --control-height-sm: 28px;
+  --control-height-md: 32px;
+  --control-height-lg: 40px;
+
+  /* ---- Layout ---- */
+  --container-max: 1280px;
+  --field-radius:  var(--radius-default);
+  --card-radius:   var(--radius-xl);
+}

automation.py

@@ -1,147 +1,61 @@
-"""
-automation.py — daily auto-update pipeline.
-
-Chosen update time (requirement #2): **18:10 America/New_York**, Mon–Fri.
-Why: NYSE/Nasdaq close at 16:00 ET; the closing auction, after-hours prints
-and Yahoo's consolidated daily bar settle over the following ~1–2 hours.
-By 18:10 ET the official daily OHLCV is stable, so we always capture the
-finished trading day exactly once (= 07:10 next morning Beijing time).
-
-Pipeline per run:
-    1. refresh data for the signal pool + holdings + sector ETFs (yfinance)
-    2. re-run multi-level Chan signals  → cached for the Signals tab
-    3. rebuild the sector rotation tables
-    4. check today's news for every holding (push brief / ignore if quiet)
-
-NOTE for Hugging Face free Spaces: free hardware sleeps after ~48h without
-traffic, and a sleeping Space cannot fire its scheduler. Everything here also
-runs on demand via the "Run now" button; on paid "always-on" hardware the
-schedule fires unattended.
-"""
-from __future__ import annotations
-
-import datetime as dt
-import threading
-import traceback
-from zoneinfo import ZoneInfo
-
-NY = ZoneInfo("America/New_York")
-RUN_HOUR, RUN_MINUTE = 18, 10
-
-STATE = {
-    "signals_df": None,
-    "signals_details": {},
-    "signals_summary": "Not run yet — press “Run now” or wait for the 18:10 ET schedule.",
-    "rotation": (None, None, None, "—"),
-    "rotation_narrative": "",
-    "news_md": "",
-    "last_run": None,
-    "running": False,
-    "log": [],
+/* ============================================================
+   TYPOGRAPHY — Chan Compass · Spectrum 2
+   Spectrum 2 desktop UI base = 14px, modular scale ratio 1.125.
+   Three families: sans (UI/headings), serif (editorial), code (mono).
+   ============================================================ */
+
+:root {
+  /* ---- Families ---- */
+  --font-sans: 'Source Sans 3', 'Adobe Clean', ui-sans-serif, system-ui, -apple-system, sans-serif;
+  --font-serif: 'Source Serif 4', 'Adobe Clean Serif', Georgia, 'Times New Roman', serif;
+  --font-code: 'Source Code Pro', ui-monospace, 'SF Mono', Menlo, Monaco, monospace;
+
+  /* ---- Type scale (ratio 1.125, base 14px) ---- */
+  --font-size-50:   11px;
+  --font-size-75:   12px;
+  --font-size-100:  14px;   /* UI base */
+  --font-size-200:  16px;
+  --font-size-300:  18px;
+  --font-size-400:  20px;
+  --font-size-500:  22px;
+  --font-size-600:  25px;
+  --font-size-700:  28px;
+  --font-size-800:  32px;
+  --font-size-900:  36px;
+  --font-size-1000: 40px;
+  --font-size-1100: 45px;
+  --font-size-1200: 50px;
+
+  /* ---- Weights (Source Sans 3 axis) ---- */
+  --font-weight-regular:  400;
+  --font-weight-medium:   500;
+  --font-weight-semibold: 600;
+  --font-weight-bold:     700;
+  --font-weight-black:    800;
+
+  /* ---- Line heights ---- */
+  --line-height-ui:      1.3;   /* UI components, tight        */
+  --line-height-heading: 1.15;  /* large display headings      */
+  --line-height-body:    1.5;   /* paragraphs, spacious        */
+  --line-height-code:    1.45;
+
+  /* ---- Letter spacing ---- */
+  --letter-spacing-heading: -0.015em;  /* Spectrum tightens large type */
+  --letter-spacing-ui:      0;
+  --letter-spacing-caps:    0.06em;     /* eyebrows / overlines         */
+
+  /* ============================================================
+     SEMANTIC TYPE ROLES
+     ============================================================ */
+  --type-display:  var(--font-weight-bold) var(--font-size-1000)/var(--line-height-heading) var(--font-sans);
+  --type-h1:       var(--font-weight-bold) var(--font-size-800)/var(--line-height-heading) var(--font-sans);
+  --type-h2:       var(--font-weight-bold) var(--font-size-600)/var(--line-height-heading) var(--font-sans);
+  --type-h3:       var(--font-weight-semibold) var(--font-size-400)/var(--line-height-ui) var(--font-sans);
+  --type-h4:       var(--font-weight-semibold) var(--font-size-300)/var(--line-height-ui) var(--font-sans);
+  --type-body-lg:  var(--font-weight-regular) var(--font-size-300)/var(--line-height-body) var(--font-sans);
+  --type-body:     var(--font-weight-regular) var(--font-size-100)/var(--line-height-body) var(--font-sans);
+  --type-ui:       var(--font-weight-regular) var(--font-size-100)/var(--line-height-ui) var(--font-sans);
+  --type-ui-bold:  var(--font-weight-semibold) var(--font-size-100)/var(--line-height-ui) var(--font-sans);
+  --type-detail:   var(--font-weight-regular) var(--font-size-75)/var(--line-height-ui) var(--font-sans);
+  --type-code:     var(--font-weight-regular) var(--font-size-75)/var(--line-height-code) var(--font-code);
 }
-_lock = threading.Lock()
-
-
-def _log(msg: str):
-    stamp = dt.datetime.now(NY).strftime("%m-%d %H:%M:%S ET")
-    STATE["log"] = (STATE["log"] + [f"[{stamp}] {msg}"])[-60:]
-
-
-def run_pipeline(tickers=None, force: bool = True) -> str:
-    """Full daily refresh. Safe to call from the UI or the scheduler."""
-    import news_watch
-    import rotation
-    import signal_runner
-
-    with _lock:
-        if STATE["running"]:
-            return "A pipeline run is already in progress."
-        STATE["running"] = True
-    try:
-        _log("Pipeline start: refreshing data + signals…")
-        df, details, summary, errors = signal_runner.run_signals(tickers, force=force)
-        STATE["signals_df"] = df
-        STATE["signals_details"] = details
-        STATE["signals_summary"] = summary
-        for e in errors:
-            _log(f"signal skip: {e}")
-        _log(f"Signals done: {summary}")
-
-        d1, d5, d20, asof = rotation.build_rotation(force=force)
-        STATE["rotation"] = (d1, d5, d20, asof)
-        # LLM narrative is generated ON DEMAND from the Rotation tab button —
-        # the pipeline itself never waits on the model.
-        STATE["rotation_narrative"] = rotation.rotation_brief(d1, d5, d20)
-        _log(f"Sector rotation rebuilt (as of {asof}).")
-
-        STATE["news_md"] = news_watch.check_holdings_news()
-        _log("Holdings news checked.")
-
-        # ── Feature 4: auto research report for every NEW ticker in the pool ──
-        try:
-            import json
-            import os
-            import paths
-            import research_agent
-            known_path = os.path.join(paths.OUTPUT_DIR, "known_tickers.json")
-            try:
-                with open(known_path, encoding="utf-8") as f:
-                    known = set(json.load(f))
-            except (OSError, ValueError):
-                known = set()
-            current = set(df["Ticker"].tolist()) if df is not None and len(df) else set()
-            new_tickers = sorted(current - known)
-            generated = set()
-            for t in new_tickers[:5]:  # safety cap per run
-                _log(f"New ticker {t} → auto-generating research report…")
-                report, trace = research_agent.run_research(t, auto=True)
-                if report:
-                    generated.add(t)
-                    _log(f"Report for {t} done{' (+trace)' if trace else ''}.")
-                else:
-                    _log(f"Report for {t} postponed (sub-agents still loading) — "
-                         f"will retry on the next run.")
-            done_set = known | (current - (set(new_tickers) - generated))
-            if current:
-                with open(known_path, "w", encoding="utf-8") as f:
-                    json.dump(sorted(done_set), f)
-        except Exception as e:
-            _log(f"Auto-research skipped: {e}")
-
-        STATE["last_run"] = dt.datetime.now(NY)
-        _log("Pipeline finished.")
-        return f"Done. {summary}"
-    except Exception as e:
-        traceback.print_exc()
-        _log(f"Pipeline error: {e}")
-        return f"Pipeline error: {e}"
-    finally:
-        STATE["running"] = False
-
-
-def start_scheduler():
-    """Cron: Mon–Fri 18:10 America/New_York."""
-    try:
-        from apscheduler.schedulers.background import BackgroundScheduler
-        from apscheduler.triggers.cron import CronTrigger
-    except Exception as e:
-        _log(f"APScheduler unavailable: {e}")
-        return None
-    sched = BackgroundScheduler(timezone=NY)
-    sched.add_job(run_pipeline, CronTrigger(day_of_week="mon-fri",
-                                            hour=RUN_HOUR, minute=RUN_MINUTE),
-                  id="daily_pipeline", max_instances=1, coalesce=True)
-    sched.start()
-    _log(f"Scheduler armed: Mon–Fri {RUN_HOUR:02d}:{RUN_MINUTE:02d} America/New_York.")
-    return sched
-
-
-def schedule_info() -> str:
-    now = dt.datetime.now(NY)
-    last = STATE["last_run"].strftime("%Y-%m-%d %H:%M ET") if STATE["last_run"] else "never"
-    return (f"**Schedule:** Mon–Fri **{RUN_HOUR:02d}:{RUN_MINUTE:02d} America/New_York** "
-            f"(market closes 16:00 ET; by 18:10 the official daily bar has settled — "
-            f"that's 07:10 next morning Beijing time).\n\n"
-            f"**Now (ET):** {now.strftime('%Y-%m-%d %H:%M')} · **Last run:** {last}\n\n"
-            f"⚠️ On free Space hardware the app sleeps when idle and the timer can't fire; "
-            f"use **Run now**, or upgrade to always-on hardware for unattended updates.")

base.css

@@ -0,0 +1,13 @@
+/* ============================================================
+   Chan Compass · Spectrum 2 Design System
+   Global entry point — consumers link THIS one file.
+   Import order: fonts → primitives → semantics. Keep this file
+   as @import lines only.
+   ============================================================ */
+
+@import url('tokens/fonts.css');
+@import url('tokens/colors.css');
+@import url('tokens/typography.css');
+@import url('tokens/spacing.css');
+@import url('tokens/elevation.css');
+@import url('tokens/base.css');

chan_engine.py

@@ -1,1451 +1,514 @@
 """
-缠论引擎 v2.1 (原始版, 用于P0-P3改造的基线)
+Chan Compass — US edition  ·  Spectrum 2 frontend (redesigned layout)
+====================================================================
+Same backend, cleaner face. EVERY feature of v3.9 is preserved — all six
+tabs, every callback, every timer, the email rows, the fine-tune export and
+the trace publisher — only the layout is reorganised for a simpler, more
+beautiful Adobe Spectrum 2 experience:
+
+  • each tab opens with a framed "control bar" grouping its primary inputs
+  • the per-tab "Email this result" row is tucked into a collapsible accordion
+  • short eyebrow labels + help text replace dense paragraphs
+  • the signature accent-framed AI output panel (.llm-out)
+
+The UI is mounted on a server with gr.mount_gradio_app (see server.py) — or
+just `demo.launch()` here. Backend modules are imported unchanged.
 """
 from __future__ import annotations
-from dataclasses import dataclass, field
-from typing import Optional
-import numpy as np
-import pandas as pd
-
-PIVOT_MAX_EXTEND_SEGS = 6
-
-
-@dataclass
-class Fractal:
-    idx: int
-    date: pd.Timestamp
-    kind: str
-    price: float
-    k_high: float
-    k_low: float
-
-
-@dataclass
-class Bi:
-    start: Fractal
-    end: Fractal
-    direction: str
-    bars: int
-    high: float
-    low: float
-    @property
-    def amplitude(self) -> float:
-        return self.high - self.low
-
-
-@dataclass
-class Seg:
-    start: Fractal
-    end: Fractal
-    direction: str
-    bis: list
-    high: float
-    low: float
-    confirmed: bool = True
-
-
-@dataclass
-class Pivot:
-    start_date: pd.Timestamp
-    end_date: pd.Timestamp
-    zg: float
-    zd: float
-    gg: float
-    dd: float
-    bis: list
-    direction: str
-    zg_date: Optional[pd.Timestamp] = None
-    zd_date: Optional[pd.Timestamp] = None
-    gg_date: Optional[pd.Timestamp] = None
-    dd_date: Optional[pd.Timestamp] = None
-    g: Optional[float] = None
-    d: Optional[float] = None
-    state: str = 'new'
-    death_combo: str = ''
-    capped: bool = False
-    upgraded_level: str = ''
-
-
-@dataclass
-class DivergenceGrade:
-    grade: str
-    area_ok: bool
-    dif_ok: bool
-    area_ratio: float
-    a_area: float
-    c_area: float
-    a_dif: float
-    c_dif: float
-    direction: str
-    reason: str
-    is_trend_divergence: bool = False
-    n_trend_pivots: int = 0
-
-
-@dataclass
-class Signal:
-    kind: str
-    date: pd.Timestamp
-    price: float
-    reason: str
-    pivot_zg: Optional[float] = None
-    pivot_zd: Optional[float] = None
-    macd_ratio: Optional[float] = None
-    dif_value: Optional[float] = None
-    n_pivots: int = 0
-    trend: str = ''
-    extras: dict = field(default_factory=dict)
-    diverge_grade: Optional[DivergenceGrade] = None
-
-
-def merge_klines(df: pd.DataFrame) -> pd.DataFrame:
-    if len(df) == 0:
-        return df.copy()
-    h = df['high'].values; l = df['low'].values; d = df['date'].values
-    out_h, out_l, out_d, out_idx = [h[0]], [l[0]], [d[0]], [0]
-    for i in range(1, len(df)):
-        ph, pl = out_h[-1], out_l[-1]; ch, cl = h[i], l[i]
-        direction = 1 if (len(out_h) >= 2 and out_h[-1] >= out_h[-2]) else (1 if len(out_h) < 2 else -1)
-        contained_a = ph >= ch and pl <= cl
-        contained_b = ch >= ph and cl <= pl
-        if contained_a or contained_b:
-            if direction >= 0:
-                out_h[-1] = max(ph, ch); out_l[-1] = max(pl, cl)
-            else:
-                out_h[-1] = min(ph, ch); out_l[-1] = min(pl, cl)
-            out_idx[-1] = i
-        else:
-            out_h.append(ch); out_l.append(cl); out_d.append(d[i]); out_idx.append(i)
-    return pd.DataFrame({'date': out_d, 'high': out_h, 'low': out_l, 'orig_idx': out_idx})
-
-
-def find_fractals(merged: pd.DataFrame) -> list:
-    res = []
-    n = len(merged)
-    if n < 3:
-        return res
-    h = merged['high'].values; l = merged['low'].values; d = merged['date'].values
-    hi = h[1:-1]; hp = h[:-2]; hn = h[2:]
-    li = l[1:-1]; lp = l[:-2]; ln = l[2:]
-    top = (hi > hp) & (hi > hn) & (li >= lp) & (li >= ln)
-    bot = (li < lp) & (li < ln) & (hi <= hp) & (hi <= hn)
-    idxs = np.nonzero(top | bot)[0]
-    if len(idxs) == 0:
-        return res
-    # 仅对被选中的(稀疏)分型点构造 Timestamp, 避免对全序列逐根转换
-    is_top = top  # 局部别名
-    for j in idxs:
-        i = j + 1
-        if is_top[j]:
-            res.append(Fractal(i, pd.Timestamp(d[i]), 'top', float(h[i]), float(h[i]), float(l[i])))
-        else:
-            res.append(Fractal(i, pd.Timestamp(d[i]), 'bottom', float(l[i]), float(h[i]), float(l[i])))
-    return res
-
-
-def find_bis(fractals: list, min_k: int = 4) -> list:
-    if len(fractals) < 2:
-        return []
-    cleaned = [fractals[0]]
-    for fx in fractals[1:]:
-        last = cleaned[-1]
-        if fx.kind == last.kind:
-            if fx.kind == 'top' and fx.price > last.price:
-                cleaned[-1] = fx
-            elif fx.kind == 'bottom' and fx.price < last.price:
-                cleaned[-1] = fx
-        else:
-            cleaned.append(fx)
-    alt = [cleaned[0]]
-    for fx in cleaned[1:]:
-        if fx.kind != alt[-1].kind and fx.idx - alt[-1].idx >= min_k - 1:
-            alt.append(fx)
-        elif fx.kind != alt[-1].kind:
-            continue
-    bis = []
-    for i in range(len(alt) - 1):
-        a, b = alt[i], alt[i+1]
-        if a.kind == b.kind:
-            continue
-        direction = 'up' if b.kind == 'top' else 'down'
-        bis.append(Bi(start=a, end=b, direction=direction, bars=b.idx - a.idx,
-                      high=max(a.price, b.price), low=min(a.price, b.price)))
-    return bis
-
-
-def _find_feature_fractal(std: list, seg_dir: str):
-    """[保留] 供调试/对照用的非增量实现; 主路径已改用 _first_feature_fractal_incremental。"""
-    up = (seg_dir == 'up')
-    for i in range(1, len(std) - 1):
-        a = std[i-1]; b = std[i]; c = std[i+1]
-        if up:
-            if b['high'] > a['high'] and b['high'] > c['high'] \
-               and b['low'] > a['low'] and b['low'] > c['low']:
-                return (i, b.get('has_gap_before', False))
-        else:
-            if b['low'] < a['low'] and b['low'] < c['low'] \
-               and b['high'] < a['high'] and b['high'] < c['high']:
-                return (i, b.get('has_gap_before', False))
-    return None
-
-
-def _first_feature_fractal_incremental(bis, start_i, end_i, seg_dir):
-    """增量构建特征序列, 在第一个特征分型被"锁定"时立即返回。
-
-    锁定条件: 出现特征分型(a,b,c)后, 再追加一个新的标准元素(即 c 之后
-    已有一个不被包含的元素 d)。此时 c 不会再被向后合并改变, 分型 b 的
-    左右高低关系已固定, 与"先把整段展开再找首个分型"语义等价。
-    返回 (b_first_bi_idx, b_has_gap_before) 或 None。
-    """
-    feat_dir = 'down' if seg_dir == 'up' else 'up'
-    up = (seg_dir == 'up')
-    std = []  # 每元素: [high, low, bi_idx, has_gap_before, first_bi_idx]
-    for k in range(start_i, end_i + 1):
-        b = bis[k]
-        if b.direction != feat_dir:
-            continue
-        ch = b.high; cl = b.low
-        if not std:
-            std.append([ch, cl, k, False, k]); continue
-        prev = std[-1]
-        ph = prev[0]; pl = prev[1]
-        contained = (ph >= ch and pl <= cl) or (ch >= ph and cl <= pl)
-        if contained:
-            if up:
-                prev[0] = ph if ph > ch else ch
-                prev[1] = pl if pl > cl else cl
-            else:
-                prev[0] = ph if ph < ch else ch
-                prev[1] = pl if pl < cl else cl
-            prev[2] = k
-            continue
-        std.append([ch, cl, k, gap_flag(cl, ch, ph, pl)] + [k])
-        # 锁定检查: 需要至少4个已定型元素, 才能保证倒数第3个(候选分型b)
-        # 的右邻c已被其后元素d终结、不会再被向后合并。
-        if len(std) >= 4:
-            a = std[-4]; bm = std[-3]; c = std[-2]
-            if up:
-                ok = (bm[0] > a[0] and bm[0] > c[0] and bm[1] > a[1] and bm[1] > c[1])
-            else:
-                ok = (bm[1] < a[1] and bm[1] < c[1] and bm[0] < a[0] and bm[0] < c[0])
-            if ok:
-                return (bm[4], bm[3])
-    # 收尾: 末端无后继元素, 用最终 std 找首个内部分型(与原实现等价)
-    for i in range(1, len(std) - 1):
-        a = std[i-1]; bm = std[i]; c = std[i+1]
-        if up:
-            ok = (bm[0] > a[0] and bm[0] > c[0] and bm[1] > a[1] and bm[1] > c[1])
-        else:
-            ok = (bm[1] < a[1] and bm[1] < c[1] and bm[0] < a[0] and bm[0] < c[0])
-        if ok:
-            return (bm[4], bm[3])
-    return None
-
-
-def gap_flag(cl, ch, ph, pl):
-    return (cl > ph) or (ch < pl)
-
-
-def _seq_fractal_confirms_reversal(bis, start_i, end_i, cur_dir):
-    fr = _first_feature_fractal_incremental(bis, start_i, end_i, cur_dir)
-    if fr is None:
-        return (False, None)
-    feat_first_bi, has_gap = fr
-    seg_end_bi = feat_first_bi - 1
-    if seg_end_bi <= start_i:
-        return (False, None)
-    if has_gap:
-        opp = 'down' if cur_dir == 'up' else 'up'
-        fr2 = _first_feature_fractal_incremental(bis, feat_first_bi, end_i, opp)
-        if fr2 is None:
-            return (False, None)
-    return (True, seg_end_bi)
-
-
-def find_segs(bis: list) -> list:
-    n = len(bis)
-    if n < 3:
-        return []
-    base = bis[0].start.price
-    look = min(3, n)
-    net = bis[look - 1].end.price - base
-    cur_dir = 'up' if net > 0 else 'down'
-    segs = []
-    i = 0
-    while i < n - 2:
-        confirmed, seg_end_bi = _seq_fractal_confirms_reversal(bis, i, n - 1, cur_dir)
-        if confirmed and seg_end_bi > i:
-            seg_bis = bis[i:seg_end_bi + 1]
-            net_up = seg_bis[-1].end.price > seg_bis[0].start.price
-            if (cur_dir == 'up') == net_up:
-                segs.append(Seg(start=bis[i].start, end=seg_bis[-1].end, direction=cur_dir,
-                                bis=seg_bis, high=max(b.high for b in seg_bis),
-                                low=min(b.low for b in seg_bis), confirmed=True))
-                i = seg_end_bi + 1
-                cur_dir = 'down' if cur_dir == 'up' else 'up'
-                continue
-        alt = 'down' if cur_dir == 'up' else 'up'
-        confirmed2, seg_end_bi2 = _seq_fractal_confirms_reversal(bis, i, n - 1, alt)
-        if confirmed2 and seg_end_bi2 > i:
-            seg_bis = bis[i:seg_end_bi2 + 1]
-            net_up = seg_bis[-1].end.price > seg_bis[0].start.price
-            if (alt == 'up') == net_up:
-                segs.append(Seg(start=seg_bis[0].start, end=seg_bis[-1].end, direction=alt,
-                                bis=seg_bis, high=max(b.high for b in seg_bis),
-                                low=min(b.low for b in seg_bis), confirmed=True))
-                i = seg_end_bi2 + 1
-                cur_dir = 'down' if alt == 'up' else 'up'
-                continue
-        break
-    if i < n - 1 and (n - i) >= 1:
-        seg_bis = bis[i:]
-        if len(seg_bis) >= 1:
-            net_up = seg_bis[-1].end.price > seg_bis[0].start.price
-            d = 'up' if net_up else 'down'
-            segs.append(Seg(start=seg_bis[0].start, end=seg_bis[-1].end, direction=d,
-                            bis=seg_bis, high=max(b.high for b in seg_bis),
-                            low=min(b.low for b in seg_bis), confirmed=False))
-    return segs
-
-
-PIVOT_UPGRADE_SPAN_DAYS = 540
-
-
-def find_pivots(bis: list, segs: Optional[list] = None) -> list:
-    confirmed_segs = [s for s in (segs or []) if getattr(s, 'confirmed', True)]
-    units = confirmed_segs if len(confirmed_segs) >= 3 else bis
-    using_segs = units is confirmed_segs
-    pivots = []; n = len(units)
-    if n < 3:
-        return pivots
-
-    bi_pos = {id(b): k for k, b in enumerate(bis)}
-
-    def _unit_bi_range(u):
-        if hasattr(u, 'bis'):
-            idxs = [bi_pos[id(b)] for b in u.bis if id(b) in bi_pos]
-            return (min(idxs), max(idxs)) if idxs else (0, 0)
-        k = bi_pos.get(id(u), 0)
-        return (k, k)
-
-    def _unit_bi_indices(unit_list):
-        out = []
-        for u in unit_list:
-            a, b = _unit_bi_range(u)
-            out.extend(range(a, b + 1))
-        return sorted(set(out))
-
-    def _unit_high_date(u):
-        return u.start.date if u.start.price >= u.end.price else u.end.date
-
-    def _unit_low_date(u):
-        return u.start.date if u.start.price <= u.end.price else u.end.date
-
-    max_ext = PIVOT_MAX_EXTEND_SEGS if PIVOT_MAX_EXTEND_SEGS else 10 ** 9
-
-    i = 0
-    while i <= n - 3:
-        b1, b2, b3 = units[i], units[i+1], units[i+2]
-        r1 = (b1.low, b1.high)
-        r2 = (b2.low, b2.high)
-        r3 = (b3.low, b3.high)
-        zg = min(r1[1], r2[1], r3[1]); zd = max(r1[0], r2[0], r3[0])
-        if zg > zd:
-            direction = b1.direction; zg_orig, zd_orig = zg, zd; gg, dd = zg, zd
-            highs = [r1[1], r2[1], r3[1]]; lows = [r1[0], r2[0], r3[0]]
-            zg_bi = (b1, b2, b3)[highs.index(zg_orig)]
-            zd_bi = (b1, b2, b3)[lows.index(zd_orig)]
-            zg_d = _unit_high_date(zg_bi)
-            zd_d = _unit_low_date(zd_bi)
-            gg_d, dd_d = zg_d, zd_d
-            zn_dir = direction
-            gn_list = []; dn_list = []
-            for bb in (b1, b2, b3):
-                if bb.direction == zn_dir:
-                    gn_list.append(max(bb.start.price, bb.end.price))
-                    dn_list.append(min(bb.start.price, bb.end.price))
-            piv_units = [i, i+1, i+2]; j = i + 3
-            capped = False
-            while j < n:
-                if (len(piv_units) - 3) >= max_ext:
-                    capped = True
-                    break
-                bj = units[j]; lo_j = bj.low; hi_j = bj.high
-                if hi_j >= zd_orig and lo_j <= zg_orig:
-                    if hi_j > gg:
-                        gg = hi_j; gg_d = _unit_high_date(bj)
-                    if lo_j < dd:
-                        dd = lo_j; dd_d = _unit_low_date(bj)
-                    if bj.direction == zn_dir:
-                        gn_list.append(hi_j); dn_list.append(lo_j)
-                    piv_units.append(j); j += 1
-                else:
-                    break
-            g_val = min(gn_list) if gn_list else zg_orig
-            d_val = max(dn_list) if dn_list else zd_orig
-            piv_bis = _unit_bi_indices([units[k] for k in piv_units]) if using_segs else piv_units
-            p_start = b1.start.date
-            p_end = units[piv_units[-1]].end.date
-            piv = Pivot(start_date=p_start, end_date=p_end,
-                        zg=zg_orig, zd=zd_orig, gg=gg, dd=dd, bis=piv_bis, direction=direction,
-                        zg_date=zg_d, zd_date=zd_d, gg_date=gg_d, dd_date=dd_d,
-                        g=g_val, d=d_val, capped=capped)
-            try:
-                span_days = (pd.Timestamp(p_end) - pd.Timestamp(p_start)).days
-            except Exception:
-                span_days = 0
-            if capped or span_days > PIVOT_UPGRADE_SPAN_DAYS:
-                piv.upgraded_level = 'weekly'
-            pivots.append(piv)
-            i = piv_units[-1] + 1
-        else:
-            i += 1
-
-    for k in range(1, len(pivots)):
-        prev, cur = pivots[k-1], pivots[k]
-        no_overlap = (cur.dd > prev.gg) or (cur.gg < prev.dd)
-        if no_overlap:
-            cur.state = 'new'
-        else:
-            cur.state = 'expand'
-
-    for k in range(len(pivots) - 1):
-        cur = pivots[k]
-        nxt = pivots[k + 1]
-        gap_start = cur.bis[-1] + 1
-        gap_end = nxt.bis[0]
-        gap_bis = bis[gap_start:gap_end] if gap_end > gap_start else []
-        if len(gap_bis) >= 2:
-            leave = gap_bis[:max(1, len(gap_bis) // 2)]
-            pull = gap_bis[max(1, len(gap_bis) // 2):]
-            leave_trend = len(leave) >= 3
-            pull_trend = len(pull) >= 3
-            if leave_trend and not pull_trend:
-                cur.death_combo = 'trend+consol'
-            elif leave_trend and pull_trend:
-                cur.death_combo = 'trend+counter'
-            else:
-                cur.death_combo = 'consol+counter'
-    return pivots
-
-
-def classify_trend(pivots: list) -> str:
-    if len(pivots) < 2:
-        return 'consolidation'
-    p1, p2 = pivots[-2], pivots[-1]
-    if p2.dd > p1.gg:
-        return 'up_trend'
-    if p2.gg < p1.dd:
-        return 'down_trend'
-    if (p2.zg < p1.zd and p2.gg >= p1.dd) or (p2.zd > p1.zg and p2.dd <= p1.gg):
-        return 'expanding'
-    return 'consolidation'
-
 
-def count_trend_pivots(pivots: list) -> int:
-    if not pivots:
-        return 0
-    if len(pivots) == 1:
-        return 1
-    cnt = 1
-    for k in range(len(pivots) - 1, 0, -1):
-        p_prev, p_cur = pivots[k - 1], pivots[k]
-        if p_cur.dd > p_prev.gg:
-            cnt += 1
-        elif p_cur.gg < p_prev.dd:
-            cnt += 1
-        else:
-            break
-    return cnt
+import os
+import threading
 
+import gradio as gr
+import pandas as pd
 
-def calc_macd(close: pd.Series, fast=12, slow=26, signal=9):
-    ema_fast = close.ewm(span=fast, adjust=False).mean()
-    ema_slow = close.ewm(span=slow, adjust=False).mean()
-    dif = ema_fast - ema_slow
-    dea = dif.ewm(span=signal, adjust=False).mean()
-    macd_bar = 2 * (dif - dea)
-    return dif, dea, macd_bar
-
-
-def macd_area_between(start_date, end_date, bar_series, date_series, direction):
-    mask = (date_series >= start_date) & (date_series <= end_date)
-    vals = bar_series[mask]
-    if len(vals) == 0:
-        return 0.0
-    if direction == 'up':
-        return float(vals.clip(lower=0).sum())
-    return float(vals.clip(upper=0).abs().sum())
-
-
-def dif_extreme_in(start_date, end_date, dif_series, date_series, kind='peak'):
-    mask = (date_series >= start_date) & (date_series <= end_date)
-    vals = dif_series[mask]
-    if len(vals) == 0:
-        return 0.0
-    return float(vals.max()) if kind == 'peak' else float(vals.min())
-
-
-class ChanAnalyzer:
-    DIVERGE_RATIO = 0.80
-    PIVOT_TOLERANCE = 0.02
-    MIN_BI_BARS = 4
-    DIF_TOLERANCE = 0.01
-
-    CFG = {
-        'b1_allow_consol_diverge': True,
-        'b3s3_first_pullback_only': False,
-        'b2s2_anchor_to_first': False,
-        'b2_macd_zero_pullback': False,
-        'drop_upgraded_pivots': False,
-        # L88-90 中阴阶段MACD精确运用: 中阴判定除BOLL收口外, 加入MACD特征
-        #   'off'  = 维持原判定(仅BOLL收口+末笔未离开中枢)
-        #   'and'  = 须同时满足"黄白线绕0轴缠绕"(更严格, 减少误判中阴而拦截的好买点)
-        #   'or'   = 满足其一即算中阴(更宽松, 拦截更多)
-        'zhongyin_macd_mode': 'or',   # 实测'or'最优: 累计收益+35pp(383%→418%), 胜率45.3%→46.8%
-    }
-
-    def __init__(self, df: pd.DataFrame):
-        self.df_raw = df.reset_index(drop=True)
-        self.close = self.df_raw['close']
-        self.dif, self.dea, self.macd_bar = calc_macd(self.close)
-        self.merged = merge_klines(self.df_raw)
-        self.fractals = find_fractals(self.merged)
-        self.bis = find_bis(self.fractals, min_k=self.MIN_BI_BARS)
-        self._bi_index = {id(b): k for k, b in enumerate(self.bis)}
-        self.segs = find_segs(self.bis)
-        self.pivots_all = find_pivots(self.bis, self.segs)
-        if self.CFG.get('drop_upgraded_pivots'):
-            last_upg_idx = -1
-            for k, p in enumerate(self.pivots_all):
-                if p.upgraded_level:
-                    last_upg_idx = k
-            operative = [p for k, p in enumerate(self.pivots_all)
-                         if k > last_upg_idx and not p.upgraded_level]
-            self.pivots = operative
-        else:
-            self.pivots = self.pivots_all
-        self.trend = classify_trend(self.pivots)
-
-    @property
-    def n_bis(self): return len(self.bis)
-    @property
-    def n_segs(self): return len(self.segs)
-    @property
-    def n_pivots(self): return len(self.pivots)
-    @property
-    def n_pivots_all(self): return len(self.pivots_all)
-    @property
-    def n_trend_pivots(self): return count_trend_pivots(self.pivots)
-    @property
-    def has_upgraded_pivot(self):
-        return any(p.upgraded_level for p in self.pivots_all)
-
-    @staticmethod
-    def _ds(ts):
-        ts = pd.Timestamp(ts)
-        if ts.hour == 0 and ts.minute == 0:
-            return ts.strftime('%Y-%m-%d')
-        return ts.strftime('%Y-%m-%d %H:%M')
-
-    def _validate_abc(self, direction: str):
-        if self.n_pivots < 2:
-            return None
-        last_piv = self.pivots[-1]
-        prev_piv = self.pivots[-2]
-        ratio = len(prev_piv.bis) / max(len(last_piv.bis), 1)
-        if not (1 / 3 <= ratio <= 3):
-            return None
-        a_start_idx = prev_piv.bis[0]
-        a_end_idx = last_piv.bis[0]
-        if a_end_idx <= a_start_idx:
-            return None
-        c_start_idx = last_piv.bis[-1] + 1
-        if c_start_idx >= self.n_bis:
-            return None
-        return {'a_start_idx': a_start_idx, 'a_end_idx': a_end_idx,
-                'b_pivot': last_piv, 'c_start_idx': c_start_idx}
-
-    def _validate_abc_consol(self, direction: str):
-        if self.n_pivots < 1:
-            return None
-        piv = self.pivots[-1]
-        a_end_idx = piv.bis[0]
-        if a_end_idx <= 0:
-            return None
-        c_start_idx = piv.bis[-1] + 1
-        if c_start_idx >= self.n_bis:
-            return None
-        want = 'down' if direction == 'down' else 'up'
-        a_start_idx = a_end_idx
-        for k in range(a_end_idx - 1, -1, -1):
-            a_start_idx = k
-            if k >= 1 and self.bis[k].direction != want and self.bis[k-1].direction != want:
-                a_start_idx = k + 1
-                break
-        if a_start_idx >= a_end_idx:
-            return None
-        return {'a_start_idx': a_start_idx, 'a_end_idx': a_end_idx,
-                'b_pivot': piv, 'c_start_idx': c_start_idx}
-
-    def _check_c_new_extreme(self, c_start_idx: int, direction: str):
-        want = 'up' if direction == 'up' else 'down'
-        c_bis = [self.bis[k] for k in range(c_start_idx, self.n_bis)
-                 if self.bis[k].direction == want]
-        if not c_bis:
-            return False, None
-        last_piv = self.pivots[-1] if self.pivots else None
-        if direction == 'up':
-            c_ext = max(b.end.price for b in c_bis)
-            prior = (last_piv.gg if last_piv is not None
-                     else max((b.high for b in self.bis[:c_start_idx]), default=0.0))
-            return c_ext > prior * (1 - 0.001), c_ext
-        else:
-            c_ext = min(b.end.price for b in c_bis)
-            prior = (last_piv.dd if last_piv is not None
-                     else min((b.low for b in self.bis[:c_start_idx]), default=1e18))
-            return c_ext < prior * (1 + 0.001), c_ext
-
-    def _b_returns_to_zero(self, pivot) -> bool:
-        dates = self.df_raw['date']
-        mask = (dates >= pivot.start_date) & (dates <= pivot.end_date)
-        dif_b = self.dif[mask]
-        dea_b = self.dea[mask]
-        if len(dif_b) == 0 or len(dea_b) == 0:
-            return False
-        def near_zero(x):
-            if x.min() <= 0 <= x.max():
-                return True
-            return x.abs().min() < max(float(x.abs().max()), 1e-9) * 0.25
-        return near_zero(dif_b) and near_zero(dea_b)
-
-    def detect_double_pullback_to_zero(self, window: int = 40) -> bool:
-        n = len(self.dif)
-        if n < 10:
-            return False
-        dif = self.dif.iloc[-min(window, n):].reset_index(drop=True)
-        dea = self.dea.iloc[-min(window, n):].reset_index(drop=True)
-        hist = self.macd_bar.iloc[-min(window, n):].reset_index(drop=True)
-        scale = max(float(dif.abs().max()), float(dea.abs().max()), 1e-9)
-        near = scale * 0.25
-        zero_pulls = [i for i in range(len(dif))
-                      if abs(float(dif.iloc[i])) <= near and abs(float(dea.iloc[i])) <= near]
-        if len(zero_pulls) < 2:
-            return False
-        def peak_between(left, right):
-            vals = dif.iloc[left + 1:right]
-            if len(vals) < 2:
-                return None
-            rel = int(vals.idxmax())
-            return float(dif.iloc[rel]), float(hist.iloc[max(left + 1, rel - 3):rel + 1].clip(lower=0).sum())
-        def trough_between(left, right):
-            vals = dif.iloc[left + 1:right]
-            if len(vals) < 2:
-                return None
-            rel = int(vals.idxmin())
-            return float(dif.iloc[rel]), float(hist.iloc[max(left + 1, rel - 3):rel + 1].clip(upper=0).abs().sum())
-        first_pull, second_pull = zero_pulls[-2], zero_pulls[-1]
-        p1, p2 = peak_between(first_pull, second_pull), peak_between(second_pull, len(dif))
-        if p1 and p2 and p1[0] > 0 and p2[0] > 0 and p2[0] < p1[0] and p2[1] <= p1[1]:
-            return True
-        t1, t2 = trough_between(first_pull, second_pull), trough_between(second_pull, len(dif))
-        if t1 and t2 and t1[0] < 0 and t2[0] < 0 and t2[0] > t1[0] and t2[1] <= t1[1]:
-            return True
-        return False
-
-    def divergence_strength_by_position(self) -> str:
-        if len(self.dif) < 5:
-            return 'strong_pullback'
-        dif_now = float(self.dif.iloc[-1])
-        dif_abs_max = float(self.dif.abs().max())
-        if dif_abs_max <= 1e-9:
-            return 'strong_pullback'
-        if abs(dif_now) >= dif_abs_max * 0.85:
-            return 'weak_pullback'
-        return 'strong_pullback'
-
-    def classify_post_divergence(self, direction: str) -> dict:
-        if not self.pivots or self.n_bis < 2:
-            return {'evolution': 'unknown', 'reason': '无中枢或笔不足'}
-        last_piv = self.pivots[-1]
-        after_idx = last_piv.bis[-1] + 1
-        def first_reversal_seg(want_dir):
-            for s in self.segs:
-                if not getattr(s, 'confirmed', True) or s.direction != want_dir:
-                    continue
-                try:
-                    first_idx = self._bi_index[id(s.bis[0])]
-                except KeyError:
-                    continue
-                if first_idx >= after_idx:
-                    return s
-            return None
-        if direction == 'down':
-            rebound = first_reversal_seg('up')
-            if rebound is None:
-                rebound = None
-                for b in self.bis[after_idx:]:
-                    if b.direction == 'up':
-                        rebound = b; break
-            if rebound is None:
-                return {'evolution': 'unknown', 'reason': '无反弹笔'}
-            if rebound.high < last_piv.zd:
-                return {'evolution': 'case1_extend',
-                        'reason': f'反弹高{rebound.high:.3f}<最后中枢ZD{last_piv.zd:.3f} → 第29课情况①未回中枢(最弱,宜尽快撤)'}
-            if rebound.high >= last_piv.zd:
-                return {'evolution': 'case2_3_turn',
-                        'reason': f'反弹回到中枢(高{rebound.high:.3f}≥ZD{last_piv.zd:.3f}) → 第29课情况②③转折(可持有等三买)'}
-            return {'evolution': 'case1_extend',
-                    'reason': f'反弹未回中枢(高{rebound.high:.3f}<ZD{last_piv.zd:.3f}) → 偏向中枢扩展'}
-        else:
-            pullback = first_reversal_seg('down')
-            if pullback is None:
-                pullback = None
-                for b in self.bis[after_idx:]:
-                    if b.direction == 'down':
-                        pullback = b; break
-            if pullback is None:
-                return {'evolution': 'unknown', 'reason': '无回落笔'}
-            if pullback.low > last_piv.zg:
-                return {'evolution': 'case1_extend',
-                        'reason': f'回落低{pullback.low:.3f}>最后中枢ZG{last_piv.zg:.3f} → 第29课情况①未回中枢(最弱)'}
-            if pullback.low <= last_piv.zg:
-                return {'evolution': 'case2_3_turn',
-                        'reason': f'回落回到中枢(低{pullback.low:.3f}≤ZG{last_piv.zg:.3f}) → 第29课情况②③转折'}
-            return {'evolution': 'case1_extend',
-                    'reason': f'回落未回中枢 → 偏向中枢扩展'}
-
-    def macd_wrap_zero(self, window: int = 15) -> bool:
-        """L88-90: 中阴阶段的MACD特征 —— 黄白线(DIF/DEA)绕0轴缠绕。
-        近window根K线中, DIF与DEA的绝对值大多压在历史摆幅的25%以内即视为缠绕。"""
-        n = len(self.dif)
-        if n < window + 5:
-            return False
-        dif = self.dif.iloc[-window:]
-        dea = self.dea.iloc[-window:]
-        scale = max(float(self.dif.abs().tail(120).max()),
-                    float(self.dea.abs().tail(120).max()), 1e-9)
-        near = scale * 0.25
-        frac = float(((dif.abs() <= near) & (dea.abs() <= near)).mean())
-        return frac >= 0.6
-
-    def macd_clarity(self, window: int = 60) -> dict:
-        """L50: 本级别MACD的"清晰度" —— 柱子面积幅度 + 黄白线分离度, 归一化打分。
-        清晰度高的级别其背驰判定更可靠; 多级别联立时应优先采信清晰级别的MACD结论。"""
-        n = len(self.dif)
-        if n < 10:
-            return {'score': 0.0, 'label': '数据不足'}
-        w = min(window, n)
-        dif = self.dif.iloc[-w:]
-        dea = self.dea.iloc[-w:]
-        hist = self.macd_bar.iloc[-w:]
-        px = max(float(self.close.iloc[-1]), 1e-9)
-        bar_amp = float(hist.abs().mean()) / px          # 柱子相对幅度
-        sep     = float((dif - dea).abs().mean()) / px   # 黄白线分离度
-        # 黄白线贴着0轴乱绕 → 不清晰
-        wrap_penalty = 0.5 if self.macd_wrap_zero() else 1.0
-        score = (bar_amp * 0.6 + sep * 0.4) * 1e3 * wrap_penalty
-        label = '清晰' if score >= 1.0 else ('一般' if score >= 0.4 else '模糊(黄白线/柱子贴0轴)')
-        return {'score': round(score, 3), 'label': label,
-                'bar_amp': round(bar_amp * 1e3, 3), 'sep': round(sep * 1e3, 3)}
-
-    def in_zhongyin(self) -> dict:
-        n = len(self.close)
-        if n < 20 or not self.pivots:
-            return {'in_zhongyin': False, 'boll_squeeze': False, 'reason': '数据不足'}
-        ma = self.close.rolling(20).mean()
-        sd = self.close.rolling(20).std()
-        if ma.iloc[-1] and ma.iloc[-1] > 0:
-            width = float((4 * sd.iloc[-1]) / ma.iloc[-1])
-        else:
-            width = 0.0
-        wseries = (4 * sd / ma).dropna().tail(60)
-        squeeze = bool(len(wseries) >= 20 and width <= wseries.quantile(0.30))
-        osc = self.zhongshu_oscillation_monitor()
-        macd_wrap = self.macd_wrap_zero()
-        dbl_pull = self.detect_double_pullback_to_zero()
-        mode = self.CFG.get('zhongyin_macd_mode', 'off')
-        if mode == 'and':
-            in_zy = (not osc.get('alert', False)) and squeeze and macd_wrap
-        elif mode == 'or':
-            in_zy = (not osc.get('alert', False)) and (squeeze or macd_wrap)
-        else:
-            in_zy = (not osc.get('alert', False)) and squeeze
-        reason = (f"BOLL带宽{width:.3f}{'(收口→中阴)' if squeeze else '(开口)'}; "
-                  f"MACD黄白线{'绕0轴缠绕(L88-90中阴特征)' if macd_wrap else '已展开'}"
-                  f"{'; 双回拉0轴(L89: 中阴结束转折预备)' if dbl_pull else ''}; {osc.get('reason','')}")
-        return {'in_zhongyin': in_zy, 'boll_squeeze': squeeze,
-                'macd_wrap_zero': macd_wrap, 'double_pullback_zero': dbl_pull,
-                'reason': reason}
-
-    def zhongshu_oscillation_monitor(self) -> dict:
-        if not self.pivots or self.n_bis < 1:
-            return {'alert': False, 'direction': '', 'reason': '无中枢'}
-        last_piv = self.pivots[-1]
-        cur = self.bis[-1]
-        if cur.low > last_piv.zg:
-            return {'alert': True, 'direction': 'up',
-                    'reason': f'第92课: 末笔({cur.low:.3f}~{cur.high:.3f})已离开中枢上沿ZG{last_piv.zg:.3f} → 向上变盘预警'}
-        if cur.high < last_piv.zd:
-            return {'alert': True, 'direction': 'down',
-                    'reason': f'第92课: 末笔({cur.low:.3f}~{cur.high:.3f})已离开中枢下沿ZD{last_piv.zd:.3f} → 向下变盘预警'}
-        return {'alert': False, 'direction': '', 'reason': '末笔仍在中枢区间内, 中枢震荡延续'}
-
-    def bottom_construction_state(self) -> str:
-        has_b1 = self.detect_b1() is not None
-        has_b3 = self.detect_b3() is not None
-        has_s3 = self.detect_s3() is not None
-        if has_s3:
-            return 'failed'
-        if has_b3:
-            return 'completed'
-        if has_b1:
-            return 'constructing'
-        return 'none'
-
-    def _seg_index_range(self, seg):
-        m = self._bi_index
-        try:
-            return m[id(seg.bis[0])], m[id(seg.bis[-1])]
-        except KeyError:
-            return None
-
-    def _bi_exit_pullback_fallback(self, pivot, exit_dir: str, pull_dir: str):
-        pe = pivot.bis[-1]
-        leave = pull = None
-        for k in range(pe + 1, self.n_bis):
-            b = self.bis[k]
-            if leave is None:
-                if b.direction == exit_dir:
-                    leave = b
-                continue
-            if b.direction == pull_dir:
-                pull = b
-                break
-        if leave is None or pull is None:
-            return None
-        return leave, pull
-
-    def _last_exit_pullback_segments(self, pivot, exit_dir: str, pull_dir: str):
-        pivot_end = pivot.bis[-1]
-        seq = []
-        for s in (self.segs or []):
-            if not getattr(s, 'confirmed', True):
-                continue
-            rng = self._seg_index_range(s)
-            if rng is None:
-                continue
-            first_idx, last_idx = rng
-            if last_idx < pivot_end:
-                continue
-            seq.append((s, first_idx, last_idx))
-        first_only = self.CFG.get('b3s3_first_pullback_only')
-        if first_only:
-            for i in range(len(seq) - 1):
-                leave, lf, _ = seq[i]
-                pull = seq[i + 1][0]
-                if leave.direction == exit_dir and pull.direction == pull_dir and lf >= pivot_end:
-                    return leave, pull
-        else:
-            for i in range(len(seq) - 1, 0, -1):
-                pull, _, _ = seq[i]
-                leave, _, _ = seq[i - 1]
-                if leave.direction == exit_dir and pull.direction == pull_dir:
-                    return leave, pull
-        return self._bi_exit_pullback_fallback(pivot, exit_dir, pull_dir)
-
-    def assess_divergence(self, a_start, a_end, c_start, c_end, direction: str) -> DivergenceGrade:
-        dates = self.df_raw['date']
-        n_tp = self.n_trend_pivots
-        is_trend_div = n_tp >= 2
-        a_area = macd_area_between(a_start, a_end, self.macd_bar, dates, direction)
-        c_area = macd_area_between(c_start, c_end, self.macd_bar, dates, direction)
-        if a_area <= 1e-9:
-            return DivergenceGrade('NONE', False, False, 0.0, a_area, c_area, 0.0, 0.0,
-                                   direction, 'A段MACD面积为0,无可比基准',
-                                   is_trend_divergence=is_trend_div, n_trend_pivots=n_tp)
-        ratio = c_area / a_area
-        area_ok = ratio < self.DIVERGE_RATIO
-        TOL = self.DIF_TOLERANCE
-        if direction == 'up':
-            a_dif = dif_extreme_in(a_start, a_end, self.dif, dates, 'peak')
-            c_dif = dif_extreme_in(c_start, c_end, self.dif, dates, 'peak')
-            dif_ok = c_dif < a_dif * (1 - TOL)
-        else:
-            a_dif = dif_extreme_in(a_start, a_end, self.dif, dates, 'trough')
-            c_dif = dif_extreme_in(c_start, c_end, self.dif, dates, 'trough')
-            dif_ok = c_dif > a_dif * (1 - TOL)
-        ext_label = 'DIF峰' if direction == 'up' else 'DIF谷'
-        div_kind = '趋势背驰' if is_trend_div else '盘整背驰'
-        if area_ok and dif_ok:
-            grade = 'STRONG'
-            reason = f'标准{div_kind}(面积+DIF均满足)|A面积:{a_area:.4f} C面积:{c_area:.4f}(比值{ratio:.1%}<{self.DIVERGE_RATIO:.0%})|{ext_label} A:{a_dif:.4f} C:{c_dif:.4f}|{n_tp}中枢'
-        elif area_ok and not dif_ok:
-            grade = 'WEAK'
-            reason = f'{div_kind}信号(面积触发)|A面积:{a_area:.4f} C面积:{c_area:.4f}(比值{ratio:.1%}<{self.DIVERGE_RATIO:.0%})|{n_tp}中枢'
-        elif dif_ok and not area_ok:
-            grade = 'WEAK'
-            reason = f'{div_kind}信号(DIF触发)|{ext_label} A:{a_dif:.4f} C:{c_dif:.4f}|{n_tp}中枢'
-        else:
-            grade = 'NONE'
-            reason = f'无背驰(两判据均不满足)|面积比{ratio:.1%}>={self.DIVERGE_RATIO:.0%}|{ext_label} A:{a_dif:.4f} C:{c_dif:.4f}'
-        return DivergenceGrade(grade, area_ok, dif_ok, ratio, a_area, c_area, a_dif, c_dif,
-                               direction, reason, is_trend_divergence=is_trend_div, n_trend_pivots=n_tp)
-
-    def _find_prev_b1(self) -> tuple:
-        if not self.pivots:
-            return (None, '')
-        last_piv = self.pivots[-1]
-        pivot_first_bi_idx = last_piv.bis[0]
-        if pivot_first_bi_idx <= 0:
-            return (None, '')
-        downs = []
-        for k in range(pivot_first_bi_idx - 1, -1, -1):
-            b = self.bis[k]
-            downs.append(b)
-            if b.direction == 'up' and k - 1 >= 0 and self.bis[k-1].direction == 'down':
-                if len(downs) >= 4:
-                    break
-        down_bis = [b for b in downs if b.direction == 'down']
-        if not down_bis:
-            return (None, '')
-        b1 = min(down_bis, key=lambda b: b.end.price)
-        return (b1.end.price, self._ds(b1.end.date))
-
-    def _find_prev_b2(self) -> tuple:
-        b1_price, b1_date_str = self._find_prev_b1()
-        if b1_price is None or not self.pivots:
-            return (None, '')
-        b1_date = pd.Timestamp(b1_date_str)
-        last_piv = self.pivots[-1]
-        right_bi_idx = last_piv.bis[-1] + 1
-        for b in self.bis[:right_bi_idx]:
-            if b.direction != 'down':
-                continue
-            if b.end.date <= b1_date:
-                continue
-            if b.end.price > b1_price + 1e-9:
-                return (b.end.price, self._ds(b.end.date))
-        return (None, '')
-
-    def _find_prev_s1(self) -> tuple:
-        if not self.pivots:
-            return (None, '')
-        last_piv = self.pivots[-1]
-        pivot_first_bi_idx = last_piv.bis[0]
-        if pivot_first_bi_idx <= 0:
-            return (None, '')
-        ups = []
-        for k in range(pivot_first_bi_idx - 1, -1, -1):
-            b = self.bis[k]
-            ups.append(b)
-            if b.direction == 'down' and k - 1 >= 0 and self.bis[k-1].direction == 'up':
-                if len(ups) >= 4:
-                    break
-        up_bis = [b for b in ups if b.direction == 'up']
-        if not up_bis:
-            return (None, '')
-        s1 = max(up_bis, key=lambda b: b.end.price)
-        return (s1.end.price, self._ds(s1.end.date))
-
-    def _find_prev_s2(self) -> tuple:
-        s1_price, s1_date_str = self._find_prev_s1()
-        if s1_price is None or not self.pivots:
-            return (None, '')
-        s1_date = pd.Timestamp(s1_date_str)
-        last_piv = self.pivots[-1]
-        right_bi_idx = last_piv.bis[-1] + 1
-        for b in self.bis[:right_bi_idx]:
-            if b.direction != 'up':
-                continue
-            if b.end.date <= s1_date:
-                continue
-            if b.end.price < s1_price - 1e-9:
-                return (b.end.price, self._ds(b.end.date))
-        return (None, '')
-
-    def detect_b1(self) -> Optional[Signal]:
-        if self.n_bis < 5:
-            return None
-        cur = self.bis[-1]
-        if cur.direction != 'down':
-            return None
-        dif_now = float(self.dif.iloc[-1])
-        if dif_now >= 0:
-            return None
-        trend_ok = (self.n_pivots >= 2 and self.trend == 'down_trend')
-        consol_ok = (self.CFG.get('b1_allow_consol_diverge') and self.n_pivots >= 1)
-        if not (trend_ok or consol_ok):
-            return None
-        abc = self._validate_abc('down')
-        if abc is None and consol_ok:
-            abc = self._validate_abc_consol('down')
-        if abc is None:
-            return None
-        c_ok, c_low = self._check_c_new_extreme(abc['c_start_idx'], 'down')
-        if not c_ok:
-            return None
-        last_piv = self.pivots[-1]
-        a_down = [self.bis[k] for k in range(abc['a_start_idx'], abc['a_end_idx'])
-                  if self.bis[k].direction == 'down']
-        c_down = [self.bis[k] for k in range(abc['c_start_idx'], self.n_bis)
-                  if self.bis[k].direction == 'down']
-        if not a_down or not c_down:
-            return None
-        dg = self.assess_divergence(a_down[0].start.date, a_down[-1].end.date,
-                                    c_down[0].start.date, c_down[-1].end.date, 'down')
-        if dg.grade == 'NONE':
-            return None
-        div_kind = '趋势底背驰' if dg.is_trend_divergence else '盘整底背驰(第27课)'
-        b_zero = self._b_returns_to_zero(last_piv)
-        dbl_pull = self.detect_double_pullback_to_zero()
-        pos_strength = self.divergence_strength_by_position()
-        post_evo = self.classify_post_divergence('down')
-        a_low_bi = min(a_down, key=lambda b: b.end.price)
-        c_low_bi = min(c_down, key=lambda b: b.end.price)
-        return Signal(kind='B1', date=self.df_raw['date'].iloc[-1], price=float(self.close.iloc[-1]),
-                      reason=f'{div_kind}一买|{self.n_pivots}中枢|ABC三段{"+B回0轴" if b_zero else ""}|{dg.reason}|DIF={dif_now:.4f}<0',
-                      pivot_zg=last_piv.zg, pivot_zd=last_piv.zd, macd_ratio=dg.area_ratio, dif_value=dif_now,
-                      n_pivots=self.n_pivots, trend=self.trend,
-                      extras={'a_seg': (a_down[0].start.date, a_down[-1].end.date, a_down[0].start.price, a_down[-1].end.price),
-                              'diverge_grade': dg.grade,
-                              'a_low': float(a_low_bi.end.price),
-                              'a_low_date': self._ds(a_low_bi.end.date),
-                              'b1_price': float(cur.end.price),
-                              'b1_date': self._ds(cur.end.date),
-                              'macd_grade': dg.grade,
-                              'macd_area_ratio': dg.area_ratio,
-                              'dif_ok': dg.dif_ok,
-                              'area_ok': dg.area_ok,
-                              'b_returns_zero': b_zero,
-                              'double_pullback': dbl_pull,
-                              'pos_strength': pos_strength,
-                              'post_evolution': post_evo['evolution'],
-                              'c_new_low': c_low,
-                              'c_new_low_date': self._ds(c_low_bi.end.date),
-                              'n_trend_pivots': self.n_trend_pivots,
-                              'price_date': self._ds(cur.end.date),
-                              'pivot_zg_date': self._ds(last_piv.zg_date) if last_piv.zg_date else '',
-                              'pivot_zd_date': self._ds(last_piv.zd_date) if last_piv.zd_date else '',
-                              'pivot_start_date': self._ds(last_piv.start_date),
-                              'pivot_end_date': self._ds(last_piv.end_date)},
-                      diverge_grade=dg)
-
-    def detect_b2(self) -> Optional[Signal]:
-        if self.n_bis < 4:
-            return None
-        cur = self.bis[-1]
-        if cur.direction != 'down':
-            return None
-        prev_downs = [b for b in self.bis[:-1] if b.direction == 'down']
-        if not prev_downs:
-            return None
-        prev = prev_downs[-1]
-        if not (cur.low >= prev.low and cur.end.price > prev.end.price):
-            return None
-        cur_price = float(self.close.iloc[-1])
-        if cur_price < cur.end.price * (1 - self.PIVOT_TOLERANCE):
-            return None
-        if self.CFG.get('b2s2_anchor_to_first'):
-            b1_anchor, _ = self._find_prev_b1()
-            if b1_anchor is None:
-                return None
-            if cur.end.price < b1_anchor - 1e-9:
-                return None
-        dif_now = float(self.dif.iloc[-1])
-        if self.CFG.get('b2_macd_zero_pullback'):
-            look = self.dif.tail(12)
-            crossed_up = bool((look > 0).any())
-            if not crossed_up:
-                return None
-            if dif_now < -self.DIF_TOLERANCE:
-                return None
-        last_piv = self.pivots[-1] if self.pivots else None
-        b1_price, b1_date = prev.end.price, self._ds(prev.end.date)
-        return Signal(kind='B2', date=self.df_raw['date'].iloc[-1], price=cur_price,
-                      reason=f'二买:一买后回踩不破|当前低{cur.end.price:.3f}>一买{b1_price:.3f}|二买不以背驰为成立条件(第21课)',
-                      pivot_zg=None, pivot_zd=None,
-                      macd_ratio=None, dif_value=dif_now, n_pivots=self.n_pivots, trend=self.trend,
-                      extras={'prev_low': prev.end.price, 'cur_low': cur.end.price,
-                              'cur_low_date': self._ds(cur.end.date),
-                              'prev_low_date': self._ds(prev.end.date),
-                              'b1_price': b1_price,
-                              'b1_date': b1_date,
-                              'price_date': self._ds(cur.end.date),
-                              'context_pivot_zg': last_piv.zg if last_piv else None,
-                              'context_pivot_zd': last_piv.zd if last_piv else None,
-                              'context_pivot_zg_date': self._ds(last_piv.zg_date) if last_piv and last_piv.zg_date else '',
-                              'context_pivot_zd_date': self._ds(last_piv.zd_date) if last_piv and last_piv.zd_date else '',
-                              'context_pivot_start_date': self._ds(last_piv.start_date) if last_piv else '',
-                              'context_pivot_end_date': self._ds(last_piv.end_date) if last_piv else ''},
-                      diverge_grade=None)
-
-    def detect_b3(self) -> Optional[Signal]:
-        if self.n_bis < 5 or self.n_pivots < 1:
-            return None
-        late_trend_b3 = self.n_trend_pivots >= 2
-        last_piv = self.pivots[-1]
-        zg, zd = last_piv.zg, last_piv.zd
-        piv_height = zg - zd
-        cur = self.bis[-1]
-        if cur.direction != 'up':
-            return None
-        pair = self._last_exit_pullback_segments(last_piv, 'up', 'down')
-        if pair is None:
-            return None
-        exit_seg, pull_seg = pair
-        if not (exit_seg.low <= zg * (1 + self.PIVOT_TOLERANCE) and exit_seg.high > zg):
-            return None
-        if pull_seg.low < zg * (1 - self.PIVOT_TOLERANCE):
-            return None
-        leaves_pivot = pull_seg.low >= zg
-        cur_price = float(self.close.iloc[-1])
-        if cur_price <= zg:
-            return None
-        ex_amp = exit_seg.high - exit_seg.low
-        if piv_height > 0 and ex_amp < piv_height * 0.5:
-            return None
-        if len(last_piv.bis) < 3:
-            return None
-        confirm_txt = '回踩离枢确认(新中枢生成)' if leaves_pivot else '回踩贴ZG(容差内,新中枢待确认)'
-        b1_price, b1_date = self._find_prev_b1()
-        b2_price, b2_date = self._find_prev_b2()
-        warn_txt = '|第二个以上同向中枢,实盘宜改用低级别一买' if late_trend_b3 else ''
-        return Signal(kind='B3', date=self.df_raw['date'].iloc[-1], price=cur_price,
-                      reason=f'标准三买|ZG={zg:.3f},ZD={zd:.3f}|线段离枢:{exit_seg.low:.3f}→{exit_seg.high:.3f}(幅度{ex_amp:.3f})|线段回试低{pull_seg.low:.3f}|{confirm_txt}|当前{cur_price:.3f}>ZG{warn_txt}',
-                      pivot_zg=zg, pivot_zd=zd, macd_ratio=None, dif_value=float(self.dif.iloc[-1]),
-                      n_pivots=self.n_pivots, trend=self.trend,
-                      extras={'exit_seg': (exit_seg.low, exit_seg.high),
-                              'pull_low': pull_seg.low,
-                              'pull_low_date': self._ds(pull_seg.end.date),
-                              'exit_start_date': self._ds(exit_seg.start.date),
-                              'exit_end_date': self._ds(exit_seg.end.date),
-                              'b1_price': b1_price,
-                              'b1_date': b1_date,
-                              'b2_price': b2_price,
-                              'b2_date': b2_date,
-                              'piv_bi_count': len(last_piv.bis), 'leaves_pivot': leaves_pivot,
-                              'late_trend_b3': late_trend_b3,
-                              'price_date': self._ds(self.df_raw['date'].iloc[-1]),
-                              'pivot_zg_date': self._ds(last_piv.zg_date) if last_piv.zg_date else '',
-                              'pivot_zd_date': self._ds(last_piv.zd_date) if last_piv.zd_date else '',
-                              'pivot_start_date': self._ds(last_piv.start_date),
-                              'pivot_end_date': self._ds(last_piv.end_date)},
-                      diverge_grade=None)
-
-    def detect_s1(self) -> Optional[Signal]:
-        if self.n_bis < 5:
-            return None
-        cur = self.bis[-1]
-        if cur.direction != 'up':
-            return None
-        trend_ok = (self.n_pivots >= 2 and self.trend == 'up_trend')
-        consol_ok = (self.CFG.get('b1_allow_consol_diverge') and self.n_pivots >= 1)
-        if not (trend_ok or consol_ok):
-            return None
-        abc = self._validate_abc('up')
-        if abc is None and consol_ok:
-            abc = self._validate_abc_consol('up')
-        if abc is None:
-            return None
-        last_piv = self.pivots[-1]
-        a_start_idx = abc['a_start_idx']; a_end_idx = abc['a_end_idx']
-        if a_end_idx <= a_start_idx:
-            return None
-        a_up_bis = [self.bis[k] for k in range(a_start_idx, a_end_idx) if self.bis[k].direction == 'up']
-        if not a_up_bis:
-            return None
-        a_high = max(b.end.price for b in a_up_bis)
-        c_start_idx = last_piv.bis[-1] + 1
-        c_up_bis = [self.bis[k] for k in range(c_start_idx, self.n_bis) if self.bis[k].direction == 'up']
-        if not c_up_bis:
-            return None
-        c_high = max(b.end.price for b in c_up_bis)
-        if c_high <= a_high:
-            return None
-        a_high_bi = max(a_up_bis, key=lambda b: b.end.price)
-        dg = self.assess_divergence(a_up_bis[0].start.date, a_up_bis[-1].end.date,
-                                    c_up_bis[0].start.date, c_up_bis[-1].end.date, 'up')
-        if dg.grade == 'NONE':
-            return None
-        b_zero = self._b_returns_to_zero(last_piv)
-        dbl_pull = self.detect_double_pullback_to_zero()
-        pos_strength = self.divergence_strength_by_position()
-        post_evo = self.classify_post_divergence('up')
-        dif_now = float(self.dif.iloc[-1])
-        c_high_bi = max(c_up_bis, key=lambda b: b.end.price)
-        return Signal(kind='S1', date=self.df_raw['date'].iloc[-1], price=float(self.close.iloc[-1]),
-                      reason=f'一卖|上涨趋势{self.n_pivots}中枢|价创新高C{c_high:.3f}>A段高{a_high:.3f}{"+B回0轴" if b_zero else ""}|{dg.reason}',
-                      pivot_zg=last_piv.zg, pivot_zd=last_piv.zd, macd_ratio=dg.area_ratio, dif_value=dif_now,
-                      n_pivots=self.n_pivots, trend=self.trend,
-                      extras={'a_high': a_high, 'c_high': c_high, 'a_area': dg.a_area, 'c_area': dg.c_area,
-                              'diverge_grade': dg.grade,
-                              'a_high_date': self._ds(a_high_bi.end.date),
-                              'b_returns_zero': b_zero,
-                              'double_pullback': dbl_pull,
-                              'pos_strength': pos_strength,
-                              'post_evolution': post_evo['evolution'],
-                              'c_high_date': self._ds(c_high_bi.end.date),
-                              'price_date': self._ds(cur.end.date),
-                              'pivot_zg_date': self._ds(last_piv.zg_date) if last_piv.zg_date else '',
-                              'pivot_zd_date': self._ds(last_piv.zd_date) if last_piv.zd_date else '',
-                              'pivot_start_date': self._ds(last_piv.start_date),
-                              'pivot_end_date': self._ds(last_piv.end_date)},
-                      diverge_grade=dg)
-
-    def detect_s2(self) -> Optional[Signal]:
-        if self.n_bis < 4:
-            return None
-        cur = self.bis[-1]
-        if cur.direction != 'up':
-            return None
-        prev_ups = [b for b in self.bis[:-1] if b.direction == 'up']
-        if not prev_ups:
-            return None
-        prev = prev_ups[-1]
-        if cur.high < prev.high and cur.end.price < prev.end.price:
-            cur_price = float(self.close.iloc[-1])
-            if cur_price > cur.end.price * (1 + self.PIVOT_TOLERANCE):
-                return None
-            if self.CFG.get('b2s2_anchor_to_first'):
-                s1_anchor, _ = self._find_prev_s1()
-                if s1_anchor is None:
-                    return None
-                if cur.end.price > s1_anchor + 1e-9:
-                    return None
-            dif_now = float(self.dif.iloc[-1])
-            last_piv = self.pivots[-1] if self.pivots else None
-            s1_price, s1_date = prev.end.price, self._ds(prev.end.date)
-            return Signal(kind='S2', date=self.df_raw['date'].iloc[-1], price=cur_price,
-                          reason=f'二卖:一卖后反弹不破|当前高{cur.end.price:.3f}<一卖{s1_price:.3f}|二卖不以背驰为成立条件(第21课)',
-                          pivot_zg=None, pivot_zd=None,
-                          dif_value=dif_now, n_pivots=self.n_pivots, trend=self.trend,
-                          extras={'prev_high': prev.end.price, 'cur_high': cur.end.price,
-                                  'cur_high_date': self._ds(cur.end.date),
-                                  'prev_high_date': self._ds(prev.end.date),
-                                  's1_price': s1_price, 's1_date': s1_date,
-                                  'price_date': self._ds(cur.end.date),
-                                  'context_pivot_zg': last_piv.zg if last_piv else None,
-                                  'context_pivot_zd': last_piv.zd if last_piv else None,
-                                  'context_pivot_zg_date': self._ds(last_piv.zg_date) if last_piv and last_piv.zg_date else '',
-                                  'context_pivot_zd_date': self._ds(last_piv.zd_date) if last_piv and last_piv.zd_date else '',
-                                  'context_pivot_start_date': self._ds(last_piv.start_date) if last_piv else '',
-                                  'context_pivot_end_date': self._ds(last_piv.end_date) if last_piv else ''},
-                          diverge_grade=None)
-        return None
-
-    def detect_s3(self) -> Optional[Signal]:
-        if self.n_bis < 5 or self.n_pivots < 1:
-            return None
-        last_piv = self.pivots[-1]
-        zg, zd = last_piv.zg, last_piv.zd
-        if len(self.bis) < 3:
-            return None
-        cur = self.bis[-1]
-        if cur.direction != 'down':
-            return None
-        s1_price, s1_date = self._find_prev_s1()
-        s2_price, s2_date = self._find_prev_s2()
-        base_dates = {'price_date': self._ds(self.df_raw['date'].iloc[-1]),
-                      's1_price': s1_price, 's1_date': s1_date,
-                      's2_price': s2_price, 's2_date': s2_date,
-                      'pivot_zg_date': self._ds(last_piv.zg_date) if last_piv.zg_date else '',
-                      'pivot_zd_date': self._ds(last_piv.zd_date) if last_piv.zd_date else '',
-                      'pivot_start_date': self._ds(last_piv.start_date),
-                      'pivot_end_date': self._ds(last_piv.end_date)}
-        pair = self._last_exit_pullback_segments(last_piv, 'down', 'up')
-        if pair is None:
-            return None
-        exit_seg, pull_seg = pair
-        if not (exit_seg.high >= zd * (1 - self.PIVOT_TOLERANCE) and exit_seg.low < zd):
-            return None
-        if pull_seg.high > zd * (1 + self.PIVOT_TOLERANCE):
-            return None
-        if float(self.close.iloc[-1]) >= zd:
-            return None
-        return Signal(kind='S3', date=self.df_raw['date'].iloc[-1], price=float(self.close.iloc[-1]),
-                      reason=f'标准三卖|ZD={zd:.3f}|线段离枢低{exit_seg.low:.3f}<ZD|线段回抽高{pull_seg.high:.3f}未过ZD',
-                      pivot_zg=zg, pivot_zd=zd, dif_value=float(self.dif.iloc[-1]),
-                      n_pivots=self.n_pivots, trend=self.trend, extras=base_dates, diverge_grade=None)
-
-    def get_signal(self) -> Optional[Signal]:
-        for fn in [self.detect_s1, self.detect_s2, self.detect_s3]:
-            sig = fn()
-            if sig is not None:
-                return sig
-        for fn in [self.detect_b3, self.detect_b2, self.detect_b1]:
-            sig = fn()
-            if sig is not None:
-                return sig
-        return None
-
-    def get_all_signals(self) -> list:
-        all_sigs = []
-        for fn in [self.detect_b1, self.detect_b2, self.detect_b3,
-                   self.detect_s1, self.detect_s2, self.detect_s3]:
-            sig = fn()
-            if sig is not None:
-                all_sigs.append(sig)
-        return all_sigs
-
-    def l36_segment_note(self) -> str:
-        """L36 结合律: 走势分解的唯一性靠结合律保证 —— a+A+b+B+c 的划分中, 同一段
-        K线不能既归前段又归后段。本引擎线段划分采用特征序列分型(标准缠论)处理
-        包含关系, 分型一旦确认即锁定段的归属, 等价于结合律的程序化执行。
-        该函数对当前末端给出"是否存在划分歧义"的提示。"""
-        if len(self.segs) < 2:
-            return '第36课: 线段不足2段, 无划分歧义问题'
-        last = self.segs[-1]
-        n_last = len(getattr(last, 'bis', []) or [])
-        if n_last < 3:
-            return (f'第36课: 末段仅{n_last}笔(<3), 末端划分尚未唯一确认 —— '
-                    f'当下操作应按两种归属做完全分类预案, 等待特征序列分型锁定')
-        return '第36课: 末段≥3笔且特征序列分型已锁定, 当前划分唯一, 无歧义'
-
-    def diagnose(self) -> dict:
-        cur_price = float(self.close.iloc[-1]) if len(self.close) else 0.0
-        last = self.bis[-1] if self.bis else None
-        out = {k: [] for k in ('B1', 'B2', 'B3', 'S1', 'S2', 'S3')}
-        def add(k, ok, msg):
-            out[k].append(('✓' if ok else '✗') + ' ' + msg)
-        add('B1', self.n_bis >= 5, f'笔数 {self.n_bis} >= 5')
-        add('B1', self.n_pivots >= 2, f'中枢数 {self.n_pivots} >= 2')
-        add('B1', self.trend == 'down_trend', f'当前走势={self.trend}, B1要求下跌趋势')
-        add('B1', bool(last and last.direction == 'down'), f'最后一笔方向={last.direction if last else ""}, B1要求向下')
-        add('B1', float(self.dif.iloc[-1]) < 0 if len(self.dif) else False, f'DIF={float(self.dif.iloc[-1]):.4f}, B1要求DIF<0')
-        abc_down = self._validate_abc('down')
-        add('B1', abc_down is not None, 'A/B/C三段背驰结构成立')
-        if abc_down is not None:
-            c_ok, c_low = self._check_c_new_extreme(abc_down['c_start_idx'], 'down')
-            add('B1', c_ok, f'C段创新低{"" if c_low is None else f"({c_low:.3f})"}')
-        add('B2', self.n_bis >= 4, f'笔数 {self.n_bis} >= 4')
-        add('B2', bool(last and last.direction == 'down'), f'最后一笔方向={last.direction if last else ""}, B2要求回踩向下')
-        prev_downs = [b for b in self.bis[:-1] if b.direction == 'down'] if last else []
-        add('B2', bool(prev_downs), '存在同一轮前一个下跌低点作为一买锚')
-        if last and prev_downs:
-            prev = prev_downs[-1]
-            add('B2', last.low >= prev.low and last.end.price > prev.end.price,
-                f'回踩不创新低: 本次低{last.end.price:.3f} > 一买/前低{prev.end.price:.3f}')
-            add('B2', cur_price >= last.end.price * (1 - self.PIVOT_TOLERANCE),
-                f'现价{cur_price:.3f}未跌破B2回踩锚{last.end.price:.3f}; 跌破则二买失效')
-        add('B3', self.n_pivots >= 1, f'中枢数 {self.n_pivots} >= 1')
-        add('B3', bool(last and last.direction == 'up'), f'最后一笔方向={last.direction if last else ""}, B3要求向上确认')
-        if self.pivots:
-            p = self.pivots[-1]
-            pair = self._last_exit_pullback_segments(p, 'up', 'down')
-            add('B3', pair is not None, '存在已确认线段级别的向上离枢 + 向下回试')
-            if pair is not None:
-                exit_seg, pull_seg = pair
-                add('B3', exit_seg.low <= p.zg * (1 + self.PIVOT_TOLERANCE) and exit_seg.high > p.zg,
-                    f'离枢线段突破ZG: {exit_seg.low:.3f}~{exit_seg.high:.3f}, ZG={p.zg:.3f}')
-                add('B3', pull_seg.low >= p.zg * (1 - self.PIVOT_TOLERANCE),
-                    f'回试低点{pull_seg.low:.3f}不破ZG={p.zg:.3f}')
-                add('B3', cur_price > p.zg, f'现价{cur_price:.3f}站上ZG={p.zg:.3f}')
-        add('S1', self.n_bis >= 5, f'笔数 {self.n_bis} >= 5')
-        add('S1', self.n_pivots >= 2, f'中枢数 {self.n_pivots} >= 2')
-        add('S1', self.trend == 'up_trend', f'当前走势={self.trend}, S1要求上涨趋势')
-        add('S1', bool(last and last.direction == 'up'), f'最后一笔方向={last.direction if last else ""}, S1要求向上')
-        abc_up = self._validate_abc('up')
-        add('S1', abc_up is not None, 'A/B/C三段顶背驰结构成立')
-        if abc_up is not None:
-            c_ok, c_high = self._check_c_new_extreme(abc_up['c_start_idx'], 'up')
-            add('S1', c_ok, f'C段创新高{"" if c_high is None else f"({c_high:.3f})"}')
-        add('S2', self.n_bis >= 4, f'笔数 {self.n_bis} >= 4')
-        add('S2', bool(last and last.direction == 'up'), f'最后一笔方向={last.direction if last else ""}, S2要求反弹向上')
-        prev_ups = [b for b in self.bis[:-1] if b.direction == 'up'] if last else []
-        add('S2', bool(prev_ups), '存在同一轮前一个上涨高点作为一卖锚')
-        if last and prev_ups:
-            prev = prev_ups[-1]
-            add('S2', last.high < prev.high and last.end.price < prev.end.price,
-                f'反弹不创新高: 本次高{last.end.price:.3f} < 一卖/前高{prev.end.price:.3f}')
-            add('S2', cur_price <= last.end.price * (1 + self.PIVOT_TOLERANCE),
-                f'现价{cur_price:.3f}未重新升破S2反弹锚{last.end.price:.3f}; 升破则二卖失效')
-        add('S3', self.n_pivots >= 1, f'中枢数 {self.n_pivots} >= 1')
-        add('S3', bool(last and last.direction == 'down'), f'最后一笔方向={last.direction if last else ""}, S3要求向下确认')
-        if self.pivots:
-            p = self.pivots[-1]
-            pair = self._last_exit_pullback_segments(p, 'down', 'up')
-            add('S3', pair is not None, '存在已确认线段级别的向下离枢 + 向上回抽')
-            if pair is not None:
-                exit_seg, pull_seg = pair
-                add('S3', exit_seg.high >= p.zd * (1 - self.PIVOT_TOLERANCE) and exit_seg.low < p.zd,
-                    f'离枢线段跌破ZD: {exit_seg.low:.3f}~{exit_seg.high:.3f}, ZD={p.zd:.3f}')
-                add('S3', pull_seg.high <= p.zd * (1 + self.PIVOT_TOLERANCE),
-                    f'回抽高点{pull_seg.high:.3f}不破ZD={p.zd:.3f}')
-                add('S3', cur_price < p.zd, f'现价{cur_price:.3f}跌破ZD={p.zd:.3f}')
-        return out
-
-
-class SameLevelDecomposition:
-    def __init__(self, analyzer: 'ChanAnalyzer'):
-        self.an = analyzer
-        self.segs = analyzer.segs
-
-    def current_phase(self) -> dict:
-        if len(self.segs) < 2:
-            return {'seg_dir': '', 'stage': 'unknown', 'action': 'WATCH',
-                    'reason': '线段不足, 无法做同级别分解'}
-        last = self.segs[-1]
-        prev = self.segs[-2]
-        seg_dir = last.direction
-        if seg_dir == 'up':
-            stage = 'up_run'
-            prev_up = None
-            for s in reversed(self.segs[:-1]):
-                if s.direction == 'up':
-                    prev_up = s; break
-            if prev_up is None:
-                return {'seg_dir': seg_dir, 'stage': stage, 'action': 'HOLD',
-                        'reason': '向上段运作中(无前向上段可比), 持有'}
-            if last.high <= prev_up.high:
-                return {'seg_dir': seg_dir, 'stage': stage, 'action': 'SELL',
-                        'reason': f'向上段不创新高({last.high:.3f}≤前高{prev_up.high:.3f}) → 先卖(第38课)'}
-            dg = self.an.assess_divergence(prev_up.start.date, prev_up.end.date,
-                                           last.start.date, last.end.date, 'up')
-            if dg.grade != 'NONE':
-                return {'seg_dir': seg_dir, 'stage': stage, 'action': 'SELL',
-                        'reason': f'向上段创新高但盘整背驰({dg.grade}) → 卖(第38课)'}
-            return {'seg_dir': seg_dir, 'stage': stage, 'action': 'HOLD',
-                    'reason': '向上段创新高且不背驰 → 持有(第38课)'}
-        else:
-            stage = 'down_run'
-            prev_down = None
-            for s in reversed(self.segs[:-1]):
-                if s.direction == 'down':
-                    prev_down = s; break
-            if prev_down is None:
-                return {'seg_dir': seg_dir, 'stage': stage, 'action': 'WATCH',
-                        'reason': '向下段运作中(无前向下段可比), 观望等买点'}
-            if last.low >= prev_down.low:
-                return {'seg_dir': seg_dir, 'stage': stage, 'action': 'BUY',
-                        'reason': f'向下段不创新低({last.low:.3f}≥前低{prev_down.low:.3f}) → 买入(第38课)'}
-            dg = self.an.assess_divergence(prev_down.start.date, prev_down.end.date,
-                                           last.start.date, last.end.date, 'down')
-            if dg.grade != 'NONE':
-                return {'seg_dir': seg_dir, 'stage': stage, 'action': 'BUY',
-                        'reason': f'向下段创新低但盘整背驰({dg.grade}) → 买入(第38课)'}
-            return {'seg_dir': seg_dir, 'stage': stage, 'action': 'WATCH',
-                    'reason': '向下段创新低且不背驰 → 观望等下跌背驰(第38课)'}
-
-
-class BottomTracker:
-    def __init__(self):
-        self.state = 'none'
-
-    def update(self, analyzer: 'ChanAnalyzer') -> str:
-        snap = analyzer.bottom_construction_state()
-        if self.state in ('none', 'failed', 'completed'):
-            if snap == 'constructing':
-                self.state = 'constructing'
-            elif snap == 'completed':
-                self.state = 'completed'
-            elif snap == 'failed':
-                self.state = 'failed'
-            else:
-                self.state = 'none'
-        elif self.state == 'constructing':
-            if snap == 'completed':
-                self.state = 'completed'
-            elif snap == 'failed':
-                self.state = 'failed'
-        return self.state
+import automation
+import emailer
+import finetune_data
+import llm_local
+import news_watch
+import paths
+import research_agent
+import rotation
+import signal_runner
+
+# Spectrum 2 theme — single source of truth (tokens mirror the design system).
+from theme import THEME as theme, CSS as S2_CSS
+
+
+# ════════════════════════════════════════════════════ UI callbacks ══
+# (identical to v3.9 — backend logic untouched)
+def ui_run_signals(tickers_text, force):
+    """Signals ONLY — pure rule engine, zero LLM, parallel downloads. Fast."""
+    import time
+    t0 = time.time()
+    tickers = [t for t in tickers_text.replace("\n", ",").split(",") if t.strip()]
+    df, details, summary, errors = signal_runner.run_signals(tickers or None,
+                                                             force=bool(force))
+    if errors:
+        summary += " · some tickers skipped (data not ready yet — run again)"
+    automation.STATE["signals_df"] = df
+    automation.STATE["signals_details"] = details
+    automation.STATE["signals_summary"] = summary
+    choices = sorted(details.keys())
+    return (
+        df if df is not None else pd.DataFrame(),
+        f"{summary} · {time.time()-t0:.1f}s (rule engine only — no LLM in this path)",
+        gr.update(choices=choices, value=(choices[0] if choices else None)),
+    )
+
+
+def ui_show_detail(ticker):
+    if not ticker:
+        return "Select a ticker after running the analysis."
+    raw = signal_runner.stock_raw_read(ticker)
+    if not raw:
+        return "No data for this ticker yet — run the analysis first."
+    return f"**Raw read:**\n\n{raw}"
+
+
+def ui_explain_detail(ticker):
+    raw = signal_runner.stock_raw_read(ticker or "")
+    if not raw:
+        yield "Run the analysis and select a ticker first."
+        return
+    # The full Chan ruling chain (Chinese) is kept BACKSTAGE in STATE and fed to
+    # the model alongside the English raw read, so the summary reflects the real
+    # multi-timeframe reasoning — but the chain is never shown and output is
+    # English only. (This restores the merged raw-read + ruling-chain logic.)
+    chain = automation.STATE.get("signals_details", {}).get(ticker or "", "")
+    chain_core = chain.split("日线买卖点逐项诊断")[0].strip()[:2000] if chain else ""
+    prompt = ("You are an equity analyst. Write a SHORT plain-English summary "
+              "(≤100 words) for a long-term holder of a US stock: the situation "
+              "today, whether to act or wait, and the key price levels.\n"
+              "Use the FACT LINE for the numbers, and the RULING CHAIN (a "
+              "Chinese multi-timeframe Chan-theory decision log) for the reasoning "
+              "— translate and synthesize it; output ENGLISH ONLY, no Chinese "
+              "characters, do not quote the log, no disclaimers.\n\n"
+              f"FACT LINE:\n{raw}")
+    if chain_core:
+        prompt += f"\n\nRULING CHAIN (translate & synthesize, don't quote):\n{chain_core}"
+    yield "🤖 _Summary Sub-Agent (Chan-Tuned Qwen3-1.7B · llama.cpp) is explaining…_"
+    final = ""
+    for acc in llm_local.chat_stream(prompt, max_tokens=260, temperature=0.2,
+                                     worker="translator"):
+        final = acc
+        yield "🤖 **AI Summary (Summary Sub-Agent · Chan-Tuned Qwen3-1.7B):**\n\n" + acc
+    # capture (raw read → narrative) as a fine-tuning pair (🎯 Well-Tuned)
+    try:
+        import finetune_data
+        finetune_data.record(raw, final)
+    except Exception:
+        pass
+
+
+def ui_refresh_rotation():
+    """Tables only — instant. AI narrative is a separate on-demand button."""
+    d1, d5, d20, asof = rotation.build_rotation(force=True)
+    automation.STATE["rotation"] = (d1, d5, d20, asof)
+    raw = rotation.rotation_brief(d1, d5, d20)
+    automation.STATE["rotation_narrative"] = raw
+    return (rotation.fmt_table(d1), rotation.fmt_table(d5), rotation.fmt_table(d20),
+            f"Sector flows as of **{asof}**", f"**Raw read:**\n{raw}")
+
+
+def ui_rotation_ai():
+    d1, d5, d20, asof = automation.STATE["rotation"]
+    if d1 is None:
+        yield "Refresh the rotation tables first."
+        return
+    brief = rotation.rotation_brief(d1, d5, d20)
+    prompt = ("You are a US equity market strategist. Based only on the sector flow "
+              "data below (SPDR ETF proxy: change% × dollar volume, plus RS vs SPY), "
+              "write a crisp brief (<150 words): 1) where capital is rotating INTO/OUT "
+              "OF; 2) do 1-day moves agree with the 5/20-day trend; 3) one watch item. "
+              "No disclaimers.\n\nDATA:\n" + brief[:2200])
+    yield ("🤖 _Narrator sub-agent (Qwen3-1.7B · llama.cpp) is reading the flow "
+           "tables — first words in ~5-15s…_")
+    for acc in llm_local.chat_stream(prompt, max_tokens=340, worker="narrator"):
+        yield "🤖 **Narrator sub-agent (Qwen3-1.7B · llama.cpp):**\n\n" + acc
+
+
+def ui_save_holdings(text):
+    saved = news_watch.save_holdings(text.replace("\n", ",").split(","))
+    return f"Saved {len(saved)} holding(s): {', '.join(saved) if saved else '—'}"
+
+
+def ui_check_news():
+    last = ""
+    for md in news_watch.check_holdings_news_stream():
+        last = md
+        yield md
+    automation.STATE["news_md"] = last
+
+
+def ui_research(ticker):
+    progress, report = "", ""
+    for progress, report in research_agent.run_research_stream(ticker):
+        yield progress, report, gr.update()
+    reports = research_agent.list_reports()
+    newest = reports[0] if reports else None
+    yield progress, report, gr.update(choices=reports, value=newest)
+
+
+def ui_open_report(fname):
+    return research_agent.read_report(fname)
+
+
+def ui_load_model(name):
+    return llm_local.load_model(name, worker="deep")
+
+
+_SELFTEST = {"done": False, "result": ""}
+
+
+def _publish_traces(repo_id: str):
+    """One-click: upload /data/traces to the Hub as a dataset, using the
+    HF_TOKEN secret. No command line needed."""
+    repo_id = (repo_id or "").strip()
+    if "/" not in repo_id:
+        return "⚠️ Enter a repo id like `username/dataset-name`."
+    token = (os.environ.get("HF_TOKEN") or os.environ.get("HUGGING_FACE_HUB_TOKEN")
+             or "").strip()
+    if not token:
+        return ("⚠️ No `HF_TOKEN` secret found. Add it in Space → Settings → "
+                "Variables and secrets (a **write** token), then try again.")
+    try:
+        import paths
+        traces = [f for f in os.listdir(paths.TRACES_DIR) if f.endswith(".json")]
+    except OSError:
+        traces = []
+    if not traces:
+        return "⚠️ No traces yet — run a few Auto Research reports first."
+    try:
+        from huggingface_hub import HfApi
+        api = HfApi(token=token)
+        api.create_repo(repo_id, repo_type="dataset", exist_ok=True)
+        # a small README so the dataset page explains itself
+        card = (
+            "---\nlicense: mit\ntags: [agent-trace, finance, chan-theory, llama-cpp]\n---\n\n"
+            "# Chan Compass — agent traces\n\n"
+            "JSON traces from the Chan Compass multi-agent research desk. Each file "
+            "is one ticker's run: the plan, every evidence-tool call and its result, "
+            "and each local sub-agent's request and response. Shared for the "
+            "Build Small hackathon (*Sharing is Caring*).\n\n"
+            "*Educational data — not investment advice.*\n")
+        import tempfile
+        rp = os.path.join(tempfile.gettempdir(), "README.md")
+        with open(rp, "w", encoding="utf-8") as f:
+            f.write(card)
+        api.upload_file(path_or_fileobj=rp, path_in_repo="README.md",
+                        repo_id=repo_id, repo_type="dataset")
+        api.upload_folder(folder_path=paths.TRACES_DIR, path_in_repo="traces",
+                          repo_id=repo_id, repo_type="dataset")
+        url = f"https://huggingface.co/datasets/{repo_id}"
+        return (f"✅ Published **{len(traces)}** trace(s) to [{repo_id}]({url}). "
+                f"Put that link in your submission for the *Sharing is Caring* badge.")
+    except Exception as e:
+        return f"❌ Upload failed: {e}"
+
+
+def _export_dataset():
+    n = finetune_data.count()
+    if n == 0:
+        return ("⚠️ **0 training pairs captured yet.** Pairs are saved only when "
+                "the **Signals → AI summary** finishes with a model loaded. Steps: "
+                "1) Model tab — wait for the Summary sub-agent to show ✅; "
+                "2) Signals — Run analysis, pick a ticker, click **AI summary**, "
+                "let it finish; repeat a few times; 3) come back and Export.",
+                gr.update(visible=False))
+    path = finetune_data.export()
+    if not path:
+        return ("⚠️ Export failed to write the file (storage error). Try again.",
+                gr.update(visible=False))
+    # Copy to a folder under the app's working dir, which Gradio serves
+    # reliably (the /data bucket and /tmp are not in Gradio's allowed paths).
+    import shutil
+    served_dir = os.path.join(os.getcwd(), "exports")
+    os.makedirs(served_dir, exist_ok=True)
+    served = os.path.join(served_dir, os.path.basename(path))
+    try:
+        shutil.copy(path, served)
+    except OSError:
+        served = path
+    msg = (f"✅ Exported **{n}** captured pair(s). Download below, then follow "
+           f"`finetune/FINETUNE_GUIDE.md` to LoRA-tune Qwen3-1.7B and publish it.")
+    return msg, gr.update(value=served, visible=True)
+
+
+def _run_selftest():
+    """Run the self-test now (used by both the auto-timer and the manual button)
+    and cache the verdict so the two never fight over the output box."""
+    out = llm_local.quick_test()
+    ok = "not loaded" not in out and "error" not in out.lower()
+    _SELFTEST["done"] = True
+    _SELFTEST["result"] = (("✅ **Every agent is OK now** — self-test passed:\n\n" + out)
+                           if ok else ("⚠️ Self-test finished with issues:\n\n" + out))
+    return _SELFTEST["result"]
+
+
+def _auto_selftest():
+    """Auto-runs ONCE the moment every sub-agent is loaded. After that it returns
+    the cached verdict unchanged, so it never overwrites a manual test result."""
+    if _SELFTEST["done"]:
+        return _SELFTEST["result"]
+    workers = llm_local.WORKERS
+    if not all(w["llm"] is not None for w in workers.values()):
+        ready = sum(1 for w in workers.values() if w["llm"] is not None)
+        return f"⏳ Loading sub-agents… {ready}/{len(workers)} ready (self-test will run automatically)."
+    return _run_selftest()
+
+
+def _manual_selftest():
+    """Manual button: always re-runs and shows the fresh verdict."""
+    return _run_selftest()
+
+
+# ════════════════════════════════════════════════════ layout ══
+_GR_MAJOR = int(gr.__version__.split(".")[0])
+_style_kw = {} if _GR_MAJOR >= 6 else {"theme": theme, "css": S2_CSS}
+
+with gr.Blocks(title="Chan Compass · US", **_style_kw) as demo:
+  with gr.Column(elem_id="s2-app"):
+    gr.HTML("""
+    <div id="s2-hero">
+      <div class="mark">🧭</div>
+      <div>
+        <h1>Chan Compass <span>· US Markets</span></h1>
+        <p>Multi-timeframe 缠论 (Chan theory) engine — monthly → 1m nested-interval
+           confirmation · sector rotation · local sub-agent pool (llama.cpp).</p>
+      </div>
+      <div class="chips">
+        <span>🧠 Local · no cloud</span><span>🦙 llama.cpp</span>
+        <span>🤖 4 sub-agents</span><span>📊 Yahoo Finance</span>
+        <span>⏰ 18:10 ET</span><span>🎨 Spectrum 2</span>
+      </div>
+    </div>""")
+
+    # ─────────────────────────────────────── Signals ──
+    with gr.Tab("📈 Signals"):
+        gr.Markdown("STEP 1 · SCAN YOUR POOL", elem_classes=["s2-eyebrow"])
+        with gr.Group(elem_classes=["s2-bar"]):
+            with gr.Row():
+                tickers_in = gr.Textbox(value=", ".join(signal_runner.DEFAULT_POOL),
+                                        label="Ticker pool (comma separated)", scale=4)
+                force_cb = gr.Checkbox(value=False, label="Force fresh download", scale=1)
+                run_btn = gr.Button("▶ Run analysis", variant="primary", scale=1)
+        sig_summary = gr.Markdown(automation.STATE["signals_summary"])
+        sig_table = gr.Dataframe(label="Tomorrow's plan — long-hold mode (sorted: BUY → SELL → HOLD → WAIT)",
+                                 interactive=False, wrap=True)
+
+        gr.Markdown("STEP 2 · EXPLAIN ONE TICKER", elem_classes=["s2-eyebrow"])
+        gr.Markdown("Pick a ticker for a plain-English raw read, then let the Summary "
+                    "sub-agent write an AI summary.", elem_classes=["s2-help"])
+        with gr.Group(elem_classes=["s2-bar"]):
+            with gr.Row():
+                detail_pick = gr.Dropdown(choices=[], label="Ticker", scale=2)
+                explain_btn = gr.Button("🤖 AI summary (local LLM)", variant="primary", scale=1)
+        detail_box = gr.Markdown(label="Raw read")
+        explain_box = gr.Markdown(elem_classes=["llm-out"])
+        with gr.Accordion("✉ Email this summary", open=False):
+            with gr.Row():
+                sig_email = gr.Textbox(label="Send to", scale=4,
+                                       placeholder="name@example.com (comma-separate for several)")
+                sig_email_btn = gr.Button("✉ Send Email", scale=1)
+            sig_email_status = gr.Markdown()
+
+    # ─────────────────────────────────────── Sector Rotation ──
+    with gr.Tab("🔄 Sector Rotation"):
+        gr.Markdown("Capital rotation across the 11 SPDR sector ETFs (full S&P 500). "
+                    "**Flow proxy = change % × dollar volume**; RS = return minus SPY. "
+                    "True per-sector fund-flow feeds are paid data — this is the standard free proxy.",
+                    elem_classes=["s2-help"])
+        with gr.Group(elem_classes=["s2-bar"]):
+            with gr.Row():
+                rot_btn = gr.Button("↻ Refresh rotation (instant)", variant="primary", scale=1)
+                rot_ai_btn = gr.Button("🤖 AI narrative (local LLM)", scale=1)
+        rot_asof = gr.Markdown("Press refresh (or Run analysis on the Signals tab).")
+        with gr.Row():
+            rot_1d = gr.Dataframe(label="1-Day (today's rotation)", interactive=False)
+        with gr.Row():
+            rot_5d = gr.Dataframe(label="5-Day (week trend)", interactive=False)
+            rot_20d = gr.Dataframe(label="20-Day (month trend)", interactive=False)
+        rot_ai = gr.Markdown(label="AI rotation narrative", elem_classes=["llm-out"])
+        with gr.Accordion("✉ Email this narrative", open=False):
+            with gr.Row():
+                rot_email = gr.Textbox(label="Send to", scale=4,
+                                       placeholder="name@example.com (comma-separate for several)")
+                rot_email_btn = gr.Button("✉ Send Email", scale=1)
+            rot_email_status = gr.Markdown()
+
+    # ─────────────────────────────────────── Watchlist News ──
+    with gr.Tab("📰 Watchlist News"):
+        gr.Markdown("Daily rule: for each **holding**, only **today's** news is checked. "
+                    "News found → AI brief below. No news → ticker is listed under *Quiet today*.",
+                    elem_classes=["s2-help"])
+        with gr.Group(elem_classes=["s2-bar"]):
+            with gr.Row():
+                hold_in = gr.Textbox(value=", ".join(news_watch.load_holdings()),
+                                     label="My holdings (comma separated)", scale=3)
+                save_btn = gr.Button("💾 Save holdings", scale=1)
+                news_btn = gr.Button("🔍 Check today's news", variant="primary", scale=1)
+        hold_status = gr.Markdown()
+        news_out = gr.Markdown(elem_classes=["llm-out"])
+        with gr.Accordion("✉ Email this news brief", open=False):
+            with gr.Row():
+                news_email = gr.Textbox(label="Send to", scale=4,
+                                        placeholder="name@example.com (comma-separate for several)")
+                news_email_btn = gr.Button("✉ Send Email", scale=1)
+            news_email_status = gr.Markdown()
+
+    # ─────────────────────────────────────── Auto Research ──
+    with gr.Tab("🧪 Auto Research"):
+        gr.Markdown("**Multi-step research agent** (fully local): PLAN → 5 evidence tools "
+                    "(fundamentals · quarterly financials · price action · **the Chan engine "
+                    "itself** · news) → section-by-section analysis → report. Every step is "
+                    "logged to a JSON **agent trace**. New pool tickers get a report "
+                    "**auto-generated** by the daily pipeline.", elem_classes=["s2-help"])
+        with gr.Group(elem_classes=["s2-bar"]):
+            with gr.Row():
+                res_in = gr.Textbox(label="Ticker", placeholder="e.g. NVDA", scale=3)
+                res_btn = gr.Button("🤖 Run research agent", variant="primary", scale=1)
+        res_progress = gr.Markdown()
+        res_out = gr.Markdown(elem_classes=["llm-out"])
+        with gr.Accordion("✉ Email this report", open=False):
+            with gr.Row():
+                res_email = gr.Textbox(label="Send to", scale=4,
+                                       placeholder="name@example.com (comma-separate for several)")
+                res_email_btn = gr.Button("✉ Send Email", scale=1)
+            res_email_status = gr.Markdown()
+
+        gr.Markdown("REPORT LIBRARY", elem_classes=["s2-eyebrow"])
+        gr.Markdown("Auto + manual reports, stored on `/data`.", elem_classes=["s2-help"])
+        with gr.Group(elem_classes=["s2-bar"]):
+            with gr.Row():
+                rep_pick = gr.Dropdown(choices=research_agent.list_reports(),
+                                       label="Saved reports", scale=3)
+                rep_open = gr.Button("📂 Open report", scale=1)
+        rep_view = gr.Markdown()
+
+    # ─────────────────────────────────────── Automation ──
+    with gr.Tab("⏰ Automation"):
+        gr.Markdown(paths.storage_status())
+        auto_md = gr.Markdown(automation.schedule_info())
+        with gr.Group(elem_classes=["s2-bar"]):
+            with gr.Row():
+                auto_now = gr.Button("⚡ Run now", variant="primary")
+        auto_msg = gr.Markdown()
+        auto_log = gr.Textbox(lines=14, label="Pipeline log (live — updates every 2s)",
+                              elem_id="detail-log")
+        traces_md = gr.Markdown(research_agent.list_traces())
+        gr.Markdown("SHARE AGENT TRACES", elem_classes=["s2-eyebrow"])
+        gr.Markdown("Publish every JSON agent trace in `/data/traces` as a Hugging Face "
+                    "**dataset** (one click, uses your `HF_TOKEN` secret — no command line). "
+                    "Earns *Sharing is Caring*.", elem_classes=["s2-help"])
+        with gr.Group(elem_classes=["s2-bar"]):
+            with gr.Row():
+                trace_repo = gr.Textbox(
+                    value="ranranrunforit/chan-compass-agent-traces",
+                    label="Dataset repo id", scale=3)
+                trace_pub = gr.Button("📡 Publish traces as dataset", variant="primary", scale=1)
+        trace_pub_status = gr.Markdown()
+        trace_pub.click(_publish_traces, trace_repo, trace_pub_status)
+        auto_log_timer = gr.Timer(2.0)
+
+        def _auto_tick():
+            log = "\n".join(automation.STATE["log"][-40:]) or "(no log yet)"
+            return log, research_agent.list_traces()
+
+        auto_log_timer.tick(_auto_tick, None, [auto_log, traces_md])
+
+    # ─────────────────────────────────────── Model ──
+    with gr.Tab("🧠 Model"):
+        gr.Markdown("All AI runs **locally** through **llama.cpp** with Qwen3 GGUF weights — "
+                    "every option is far below the 32B cap, and nothing leaves the machine. "
+                    "**First load installs the runtime + downloads the GGUF (one-time, usually "
+                    "1–3 min; worst case ~15 min if it compiles).** Signals/rotation/news never "
+                    "depend on it.", elem_classes=["s2-help"])
+        gr.Markdown("**Sub-agent pool:** Summary (Chan-Tuned Qwen3-1.7B, fixed) handles "
+                    "Explain / rotation narrative / news briefs; `deep` Analyst writes research "
+                    "reports. Each has its own lock — they run in parallel.", elem_classes=["s2-help"])
+        with gr.Group(elem_classes=["s2-bar"]):
+            model_pick = gr.Radio(choices=list(llm_local.MODEL_ZOO.keys()),
+                                  value=llm_local.DEFAULT_MODEL, label="Analyst (deep) model")
+            with gr.Row():
+                load_btn = gr.Button("⬇ Load model", variant="primary", scale=1)
+                test_btn = gr.Button("⚡ Test sub-agents now", scale=1)
+        model_status = gr.Markdown(llm_local.status())
+        model_test_out = gr.Markdown()
+        model_timer = gr.Timer(2.0)
+        model_timer.tick(lambda: llm_local.status(), None, model_status)
+        autotest_timer = gr.Timer(3.0)
+        autotest_timer.tick(_auto_selftest, None, model_test_out)
+
+        gr.Markdown("🎯 FINE-TUNING DATASET", elem_classes=["s2-eyebrow"])
+        gr.Markdown("Every Signals **AI summary** you run is saved as a (raw read → narrative) "
+                    "training pair on `/data`. Capture a few hundred, export the JSONL, then "
+                    "follow `FINETUNE_GUIDE.md` to LoRA-tune Qwen3-1.7B and publish it.",
+                    elem_classes=["s2-help"])
+        ft_status = gr.Markdown(finetune_data.status_line())
+        with gr.Group(elem_classes=["s2-bar"]):
+            ft_export = gr.Button("⬇ Export dataset (JSONL)", variant="primary")
+        ft_out = gr.Markdown()
+        ft_file = gr.File(label="Download training data", visible=False)
+        ft_timer = gr.Timer(3.0)
+        ft_timer.tick(lambda: finetune_data.status_line(), None, ft_status)
+        ft_export.click(_export_dataset, None, [ft_out, ft_file])
+
+    gr.Markdown("Chan Compass · educational tool, not investment advice · "
+                "data: Yahoo Finance · design language: Adobe Spectrum 2",
+                elem_classes=["s2-footnote"])
+
+    # ─────────────────────────────────────── wiring (unchanged) ──
+    run_btn.click(ui_run_signals, [tickers_in, force_cb],
+                  [sig_table, sig_summary, detail_pick])
+    detail_pick.change(ui_show_detail, detail_pick, detail_box)
+    explain_btn.click(ui_explain_detail, detail_pick, explain_box)
+    rot_btn.click(ui_refresh_rotation, None, [rot_1d, rot_5d, rot_20d, rot_asof, rot_ai])
+    rot_ai_btn.click(ui_rotation_ai, None, rot_ai)
+    save_btn.click(ui_save_holdings, hold_in, hold_status)
+    news_btn.click(ui_check_news, None, news_out)
+    res_btn.click(ui_research, res_in, [res_progress, res_out, rep_pick])
+    sig_email_btn.click(lambda body, to: emailer.send_result(body, to, "Signals summary"),
+                        [explain_box, sig_email], sig_email_status)
+    rot_email_btn.click(lambda body, to: emailer.send_result(body, to, "Sector rotation"),
+                        [rot_ai, rot_email], rot_email_status)
+    news_email_btn.click(lambda body, to: emailer.send_result(body, to, "Watchlist news"),
+                         [news_out, news_email], news_email_status)
+    res_email_btn.click(lambda body, to: emailer.send_result(body, to, "Research report"),
+                        [res_out, res_email], res_email_status)
+    rep_open.click(ui_open_report, rep_pick, rep_view)
+    auto_now.click(lambda: automation.run_pipeline(force=True), None, auto_msg)
+    load_btn.click(ui_load_model, model_pick, model_status)
+    test_btn.click(_manual_selftest, None, model_test_out)
+
+
+# ════════════════════════════════════════════════════ boot ══
+automation.start_scheduler()
+
+
+def _auto_load_model():
+    try:
+        automation._log("Auto-loading sub-agents (llama.cpp)…")
+        llm_local.auto_load_all()
+    except Exception as e:
+        automation._log(f"Sub-agent auto-load failed: {e}")
+
+
+try:
+    import paths as _paths
+    automation._log(_paths.storage_status())
+except Exception:
+    pass
+if os.environ.get("AUTO_LOAD_MODEL", "1") == "1":
+    threading.Thread(target=_auto_load_model, daemon=True).start()
+
+
+if __name__ == "__main__":
+    import paths as _p
+    _allowed = [os.path.join(os.getcwd(), "exports"), _p.DATASET_DIR]
+    os.makedirs(_allowed[0], exist_ok=True)
+    if _GR_MAJOR >= 6:
+        demo.launch(theme=theme, css=S2_CSS, allowed_paths=_allowed)
+    else:
+        demo.launch(allowed_paths=_allowed)

chan_enhance.py

@@ -1,123 +1,147 @@
 """
-chan_enhance.py —— 缠论系统增强(查漏补缺) · 纯函数版(非Hook)
+automation.py — daily auto-update pipeline.
+
+Chosen update time (requirement #2): **18:10 America/New_York**, Mon–Fri.
+Why: NYSE/Nasdaq close at 16:00 ET; the closing auction, after-hours prints
+and Yahoo's consolidated daily bar settle over the following ~1–2 hours.
+By 18:10 ET the official daily OHLCV is stable, so we always capture the
+finished trading day exactly once (= 07:10 next morning Beijing time).
+
+Pipeline per run:
+    1. refresh data for the signal pool + holdings + sector ETFs (yfinance)
+    2. re-run multi-level Chan signals  → cached for the Signals tab
+    3. rebuild the sector rotation tables
+    4. check today's news for every holding (push brief / ignore if quiet)
+
+NOTE for Hugging Face free Spaces: free hardware sleeps after ~48h without
+traffic, and a sleeping Space cannot fire its scheduler. Everything here also
+runs on demand via the "Run now" button; on paid "always-on" hardware the
+schedule fires unattended.
 """
 from __future__ import annotations
 
-
-W_REVERSAL = 1.0
-W_TRAP     = 0.85
-W_RELAY    = 0.6
-W_UNKNOWN  = 0.7
-
-# 第16课 六种基本走势 → 买法分类的中文名(配合英文 method 一起展示)
-METHOD_CN = {
-    'reversal': '反转式(下跌+盘整+上涨 / 趋势底背驰一买, 力度最强, 权重最高)',
-    'trap':     '陷阱式(下跌+上涨, 空头陷阱式二买, 中等力度)',
-    'relay':    '中继式(上涨+盘整+上涨, 三买, 趋势中继)',
-    'unknown':  '未分类',
+import datetime as dt
+import threading
+import traceback
+from zoneinfo import ZoneInfo
+
+NY = ZoneInfo("America/New_York")
+RUN_HOUR, RUN_MINUTE = 18, 10
+
+STATE = {
+    "signals_df": None,
+    "signals_details": {},
+    "signals_summary": "Not run yet — press “Run now” or wait for the 18:10 ET schedule.",
+    "rotation": (None, None, None, "—"),
+    "rotation_narrative": "",
+    "news_md": "",
+    "last_run": None,
+    "running": False,
+    "log": [],
 }
-
-WEAK_ARM_GAIN = 0.04
-WEAK_GIVEBACK = 0.22
-
-L92_EXIT_ENABLE      = False
-L92_EXIT_FLOATING_MAX = 0.015
-L92_ZD_BREAK_BUF      = 0.0
-
-
-def classify_buy_method(sig_kind, ml) -> str:
-    sig = ml.daily.signal if (ml and ml.daily) else None
-    dg = getattr(sig, 'diverge_grade', None) if sig is not None else None
-    if sig_kind == 'B1':
-        return 'reversal'
-    if sig_kind == 'B3':
-        return 'relay'
-    if sig_kind == 'B2':
-        # L37 背驰分辨: 只有"趋势背驰"(≥2个同向中枢后的背驰)才是标准的趋势转折,
-        # 对应第16课"下跌+盘整+上涨"反转式买法; 盘整背驰力度弱, 仍按陷阱式处理。
-        if (dg is not None and getattr(dg, 'grade', '') == 'STRONG'
-                and getattr(dg, 'is_trend_divergence', False)):
-            return 'reversal'
-        return 'trap'
-    return 'unknown'
-
-
-def l37_divergence_note(ml) -> str:
-    """L37 背驰分辨(区分背驰段构成): 趋势背驰=至少两个同向中枢后的背驰, 转折级别高;
-    盘整背驰=单中枢内的力度衰竭, 只保证回拉中枢, 不保证反转。"""
-    sig = ml.daily.signal if (ml and ml.daily) else None
-    dg = getattr(sig, 'diverge_grade', None) if sig is not None else None
-    if dg is None or getattr(dg, 'grade', 'NONE') == 'NONE':
-        return ''
-    if getattr(dg, 'is_trend_divergence', False):
-        return (f'第37课: 趋势背驰({getattr(dg, "n_trend_pivots", "?")}个同向中枢), '
-                f'转折至少回拉至最后一个中枢, 大概率反转 → 可按反转式买法重仓')
-    return ('第37课: 盘整背驰(背驰段内仅1个中枢), 只保证回拉中枢一次, '
-            '不保证趋势反转 → 轻仓短打, 回拉到中枢即考虑兑现')
-
-
-def buy_method_weight(sig_kind, ml):
-    method = classify_buy_method(sig_kind, ml)
-    wmap = {'reversal': W_REVERSAL, 'trap': W_TRAP, 'relay': W_RELAY, 'unknown': W_UNKNOWN}
-    return method, wmap.get(method, W_UNKNOWN)
-
-
-def recompute_evo(ml) -> str:
-    sig = ml.daily.signal if (ml and ml.daily) else None
-    if sig is not None:
-        evo = (sig.extras or {}).get('post_evolution', '')
-        if evo:
-            return evo
-    dv = ml.daily if ml else None
-    if dv is not None and dv.zd is not None and dv.zg is not None:
-        if ml.cur_price < dv.zd:
-            return 'case1_extend'
-    return ''
-
-
-def weak_evo_giveback(pos, ml, default_giveback):
-    evo = recompute_evo(ml) if ml is not None else (pos.get('post_evo') or '')
-    if evo == 'case1_extend':
-        return WEAK_ARM_GAIN, WEAK_GIVEBACK
-    return None, default_giveback
-
-
-def l92_should_exit(pos, ml, close_p, floating):
-    if not L92_EXIT_ENABLE or ml is None or ml.daily is None:
-        return None
-    if floating > L92_EXIT_FLOATING_MAX:
-        return None
-    zd = ml.daily.zd
-    if zd is None:
+_lock = threading.Lock()
+
+
+def _log(msg: str):
+    stamp = dt.datetime.now(NY).strftime("%m-%d %H:%M:%S ET")
+    STATE["log"] = (STATE["log"] + [f"[{stamp}] {msg}"])[-60:]
+
+
+def run_pipeline(tickers=None, force: bool = True) -> str:
+    """Full daily refresh. Safe to call from the UI or the scheduler."""
+    import news_watch
+    import rotation
+    import signal_runner
+
+    with _lock:
+        if STATE["running"]:
+            return "A pipeline run is already in progress."
+        STATE["running"] = True
+    try:
+        _log("Pipeline start: refreshing data + signals…")
+        df, details, summary, errors = signal_runner.run_signals(tickers, force=force)
+        STATE["signals_df"] = df
+        STATE["signals_details"] = details
+        STATE["signals_summary"] = summary
+        for e in errors:
+            _log(f"signal skip: {e}")
+        _log(f"Signals done: {summary}")
+
+        d1, d5, d20, asof = rotation.build_rotation(force=force)
+        STATE["rotation"] = (d1, d5, d20, asof)
+        # LLM narrative is generated ON DEMAND from the Rotation tab button —
+        # the pipeline itself never waits on the model.
+        STATE["rotation_narrative"] = rotation.rotation_brief(d1, d5, d20)
+        _log(f"Sector rotation rebuilt (as of {asof}).")
+
+        STATE["news_md"] = news_watch.check_holdings_news()
+        _log("Holdings news checked.")
+
+        # ── Feature 4: auto research report for every NEW ticker in the pool ──
+        try:
+            import json
+            import os
+            import paths
+            import research_agent
+            known_path = os.path.join(paths.OUTPUT_DIR, "known_tickers.json")
+            try:
+                with open(known_path, encoding="utf-8") as f:
+                    known = set(json.load(f))
+            except (OSError, ValueError):
+                known = set()
+            current = set(df["Ticker"].tolist()) if df is not None and len(df) else set()
+            new_tickers = sorted(current - known)
+            generated = set()
+            for t in new_tickers[:5]:  # safety cap per run
+                _log(f"New ticker {t} → auto-generating research report…")
+                report, trace = research_agent.run_research(t, auto=True)
+                if report:
+                    generated.add(t)
+                    _log(f"Report for {t} done{' (+trace)' if trace else ''}.")
+                else:
+                    _log(f"Report for {t} postponed (sub-agents still loading) — "
+                         f"will retry on the next run.")
+            done_set = known | (current - (set(new_tickers) - generated))
+            if current:
+                with open(known_path, "w", encoding="utf-8") as f:
+                    json.dump(sorted(done_set), f)
+        except Exception as e:
+            _log(f"Auto-research skipped: {e}")
+
+        STATE["last_run"] = dt.datetime.now(NY)
+        _log("Pipeline finished.")
+        return f"Done. {summary}"
+    except Exception as e:
+        traceback.print_exc()
+        _log(f"Pipeline error: {e}")
+        return f"Pipeline error: {e}"
+    finally:
+        STATE["running"] = False
+
+
+def start_scheduler():
+    """Cron: Mon–Fri 18:10 America/New_York."""
+    try:
+        from apscheduler.schedulers.background import BackgroundScheduler
+        from apscheduler.triggers.cron import CronTrigger
+    except Exception as e:
+        _log(f"APScheduler unavailable: {e}")
         return None
-    if close_p < zd * (1 - L92_ZD_BREAK_BUF) and close_p > pos.get('stop_px', 0):
-        return ('L92_EXIT',
-                f'第92课中枢震荡监视器: 现价{close_p:.3f}已破日线中枢下沿ZD{zd:.3f}'
-                f'(向下变盘) 且浮盈仅{floating:+.1%} → 提前减仓, 不等磨到结构止损')
-    return None
-
-
-def predict_enhance(ml) -> dict:
-    out = {}
-    if ml is None or ml.daily is None:
-        return out
-    sig_kind = ml.final_kind or ''
-    if sig_kind in ('B1', 'B2', 'B3'):
-        method, weight = buy_method_weight(sig_kind, ml)
-        out['buy_method'] = method
-        out['buy_method_cn'] = METHOD_CN.get(method, method)
-        out['suggest_weight'] = weight
-        out['l16_note'] = f'第16课: 买法分类={method}〔{METHOD_CN.get(method, method)}〕, 建议仓位权重{weight:.2f}'
-    l37 = l37_divergence_note(ml)
-    if l37:
-        out['l37_note'] = l37
-    evo = recompute_evo(ml)
-    if evo:
-        out['post_evolution'] = evo
-        out['evo_hint'] = ('第29课: 最弱形态(反弹/回落未回中枢), 持有宜收紧移动止盈, 尽快兑现'
-                           if evo == 'case1_extend'
-                           else '第29课: 形态较强(回到中枢), 可持有等三买/趋势延续')
-    zd = ml.daily.zd
-    if zd is not None and ml.cur_price < zd:
-        out['l92_warn'] = f'第92课: 现价{ml.cur_price:.3f}已在日线中枢下沿ZD{zd:.3f}下方 → 向下变盘预警'
-    return out
+    sched = BackgroundScheduler(timezone=NY)
+    sched.add_job(run_pipeline, CronTrigger(day_of_week="mon-fri",
+                                            hour=RUN_HOUR, minute=RUN_MINUTE),
+                  id="daily_pipeline", max_instances=1, coalesce=True)
+    sched.start()
+    _log(f"Scheduler armed: Mon–Fri {RUN_HOUR:02d}:{RUN_MINUTE:02d} America/New_York.")
+    return sched
+
+
+def schedule_info() -> str:
+    now = dt.datetime.now(NY)
+    last = STATE["last_run"].strftime("%Y-%m-%d %H:%M ET") if STATE["last_run"] else "never"
+    return (f"**Schedule:** Mon–Fri **{RUN_HOUR:02d}:{RUN_MINUTE:02d} America/New_York** "
+            f"(market closes 16:00 ET; by 18:10 the official daily bar has settled — "
+            f"that's 07:10 next morning Beijing time).\n\n"
+            f"**Now (ET):** {now.strftime('%Y-%m-%d %H:%M')} · **Last run:** {last}\n\n"
+            f"⚠️ On free Space hardware the app sleeps when idle and the timer can't fire; "
+            f"use **Run now**, or upgrade to always-on hardware for unattended updates.")

chan_glue.py

@@ -1,70 +1,1451 @@
 """
-chan_glue.py — wires the user's notebook-style modules together at runtime.
-
-The original chan_engine.py / chan_multilevel.py were written as notebook cells:
-chan_multilevel references `ChanAnalyzer` / `Signal` via a commented-out import.
-Because both files use `from __future__ import annotations` and resolve names at
-call time, we can simply inject the symbols into the module namespace — the Chan
-analysis logic itself is left 100% untouched.
-
-Also provides a small LRU-cached analyzer factory (the original chan_common.py
-was A-share specific and is not used in the US version).
+缠论引擎 v2.1 (原始版, 用于P0-P3改造的基线)
 """
 from __future__ import annotations
+from dataclasses import dataclass, field
+from typing import Optional
+import numpy as np
+import pandas as pd
 
-import hashlib
-from collections import OrderedDict
+PIVOT_MAX_EXTEND_SEGS = 6
 
-import pandas as pd
 
-import chan_engine
-import chan_multilevel
-
-# ── inject cross-module symbols (replaces the commented `from chan_engine import …`) ──
-chan_multilevel.ChanAnalyzer = chan_engine.ChanAnalyzer
-chan_multilevel.Signal = chan_engine.Signal
-chan_engine.PIVOT_MAX_EXTEND_SEGS = chan_engine.PIVOT_MAX_EXTEND_SEGS  # no-op, keeps linters calm
-
-# Re-exports for app code
-ChanAnalyzer = chan_engine.ChanAnalyzer
-Signal = chan_engine.Signal
-MultiLevelChan = chan_multilevel.MultiLevelChan
-MultiLevelSignal = chan_multilevel.MultiLevelSignal
-resample_weekly = chan_multilevel.resample_weekly
-resample_monthly = chan_multilevel.resample_monthly
-set_analyzer_factory = chan_multilevel.set_analyzer_factory
-
-# ── cached analyzer factory ──────────────────────────────────────────────
-_CACHE: "OrderedDict[str, chan_engine.ChanAnalyzer]" = OrderedDict()
-_CACHE_MAX = 64
-
-
-def _df_key(level: str, df: pd.DataFrame) -> str:
-    n = len(df)
-    if n == 0:
-        return f"{level}-empty"
-    last = str(df['date'].iloc[-1])
-    first = str(df['date'].iloc[0])
-    tail_close = float(df['close'].iloc[-1])
-    raw = f"{level}|{n}|{first}|{last}|{tail_close:.6f}"
-    return hashlib.md5(raw.encode()).hexdigest()
-
-
-def cached_analyzer(level: str, df: pd.DataFrame):
-    key = _df_key(level, df)
-    if key in _CACHE:
-        _CACHE.move_to_end(key)
-        return _CACHE[key]
-    an = chan_engine.ChanAnalyzer(df.reset_index(drop=True))
-    _CACHE[key] = an
-    while len(_CACHE) > _CACHE_MAX:
-        _CACHE.popitem(last=False)
-    return an
-
-
-def install():
-    """Install the cached analyzer factory into MultiLevelChan."""
-    set_analyzer_factory(cached_analyzer)
-
-
-install()
+@dataclass
+class Fractal:
+    idx: int
+    date: pd.Timestamp
+    kind: str
+    price: float
+    k_high: float
+    k_low: float
+
+
+@dataclass
+class Bi:
+    start: Fractal
+    end: Fractal
+    direction: str
+    bars: int
+    high: float
+    low: float
+    @property
+    def amplitude(self) -> float:
+        return self.high - self.low
+
+
+@dataclass
+class Seg:
+    start: Fractal
+    end: Fractal
+    direction: str
+    bis: list
+    high: float
+    low: float
+    confirmed: bool = True
+
+
+@dataclass
+class Pivot:
+    start_date: pd.Timestamp
+    end_date: pd.Timestamp
+    zg: float
+    zd: float
+    gg: float
+    dd: float
+    bis: list
+    direction: str
+    zg_date: Optional[pd.Timestamp] = None
+    zd_date: Optional[pd.Timestamp] = None
+    gg_date: Optional[pd.Timestamp] = None
+    dd_date: Optional[pd.Timestamp] = None
+    g: Optional[float] = None
+    d: Optional[float] = None
+    state: str = 'new'
+    death_combo: str = ''
+    capped: bool = False
+    upgraded_level: str = ''
+
+
+@dataclass
+class DivergenceGrade:
+    grade: str
+    area_ok: bool
+    dif_ok: bool
+    area_ratio: float
+    a_area: float
+    c_area: float
+    a_dif: float
+    c_dif: float
+    direction: str
+    reason: str
+    is_trend_divergence: bool = False
+    n_trend_pivots: int = 0
+
+
+@dataclass
+class Signal:
+    kind: str
+    date: pd.Timestamp
+    price: float
+    reason: str
+    pivot_zg: Optional[float] = None
+    pivot_zd: Optional[float] = None
+    macd_ratio: Optional[float] = None
+    dif_value: Optional[float] = None
+    n_pivots: int = 0
+    trend: str = ''
+    extras: dict = field(default_factory=dict)
+    diverge_grade: Optional[DivergenceGrade] = None
+
+
+def merge_klines(df: pd.DataFrame) -> pd.DataFrame:
+    if len(df) == 0:
+        return df.copy()
+    h = df['high'].values; l = df['low'].values; d = df['date'].values
+    out_h, out_l, out_d, out_idx = [h[0]], [l[0]], [d[0]], [0]
+    for i in range(1, len(df)):
+        ph, pl = out_h[-1], out_l[-1]; ch, cl = h[i], l[i]
+        direction = 1 if (len(out_h) >= 2 and out_h[-1] >= out_h[-2]) else (1 if len(out_h) < 2 else -1)
+        contained_a = ph >= ch and pl <= cl
+        contained_b = ch >= ph and cl <= pl
+        if contained_a or contained_b:
+            if direction >= 0:
+                out_h[-1] = max(ph, ch); out_l[-1] = max(pl, cl)
+            else:
+                out_h[-1] = min(ph, ch); out_l[-1] = min(pl, cl)
+            out_idx[-1] = i
+        else:
+            out_h.append(ch); out_l.append(cl); out_d.append(d[i]); out_idx.append(i)
+    return pd.DataFrame({'date': out_d, 'high': out_h, 'low': out_l, 'orig_idx': out_idx})
+
+
+def find_fractals(merged: pd.DataFrame) -> list:
+    res = []
+    n = len(merged)
+    if n < 3:
+        return res
+    h = merged['high'].values; l = merged['low'].values; d = merged['date'].values
+    hi = h[1:-1]; hp = h[:-2]; hn = h[2:]
+    li = l[1:-1]; lp = l[:-2]; ln = l[2:]
+    top = (hi > hp) & (hi > hn) & (li >= lp) & (li >= ln)
+    bot = (li < lp) & (li < ln) & (hi <= hp) & (hi <= hn)
+    idxs = np.nonzero(top | bot)[0]
+    if len(idxs) == 0:
+        return res
+    # 仅对被选中的(稀疏)分型点构造 Timestamp, 避免对全序列逐根转换
+    is_top = top  # 局部别名
+    for j in idxs:
+        i = j + 1
+        if is_top[j]:
+            res.append(Fractal(i, pd.Timestamp(d[i]), 'top', float(h[i]), float(h[i]), float(l[i])))
+        else:
+            res.append(Fractal(i, pd.Timestamp(d[i]), 'bottom', float(l[i]), float(h[i]), float(l[i])))
+    return res
+
+
+def find_bis(fractals: list, min_k: int = 4) -> list:
+    if len(fractals) < 2:
+        return []
+    cleaned = [fractals[0]]
+    for fx in fractals[1:]:
+        last = cleaned[-1]
+        if fx.kind == last.kind:
+            if fx.kind == 'top' and fx.price > last.price:
+                cleaned[-1] = fx
+            elif fx.kind == 'bottom' and fx.price < last.price:
+                cleaned[-1] = fx
+        else:
+            cleaned.append(fx)
+    alt = [cleaned[0]]
+    for fx in cleaned[1:]:
+        if fx.kind != alt[-1].kind and fx.idx - alt[-1].idx >= min_k - 1:
+            alt.append(fx)
+        elif fx.kind != alt[-1].kind:
+            continue
+    bis = []
+    for i in range(len(alt) - 1):
+        a, b = alt[i], alt[i+1]
+        if a.kind == b.kind:
+            continue
+        direction = 'up' if b.kind == 'top' else 'down'
+        bis.append(Bi(start=a, end=b, direction=direction, bars=b.idx - a.idx,
+                      high=max(a.price, b.price), low=min(a.price, b.price)))
+    return bis
+
+
+def _find_feature_fractal(std: list, seg_dir: str):
+    """[保留] 供调试/对照用的非增量实现; 主路径已改用 _first_feature_fractal_incremental。"""
+    up = (seg_dir == 'up')
+    for i in range(1, len(std) - 1):
+        a = std[i-1]; b = std[i]; c = std[i+1]
+        if up:
+            if b['high'] > a['high'] and b['high'] > c['high'] \
+               and b['low'] > a['low'] and b['low'] > c['low']:
+                return (i, b.get('has_gap_before', False))
+        else:
+            if b['low'] < a['low'] and b['low'] < c['low'] \
+               and b['high'] < a['high'] and b['high'] < c['high']:
+                return (i, b.get('has_gap_before', False))
+    return None
+
+
+def _first_feature_fractal_incremental(bis, start_i, end_i, seg_dir):
+    """增量构建特征序列, 在第一个特征分型被"锁定"时立即返回。
+
+    锁定条件: 出现特征分型(a,b,c)后, 再追加一个新的标准元素(即 c 之后
+    已有一个不被包含的元素 d)。此时 c 不会再被向后合并改变, 分型 b 的
+    左右高低关系已固定, 与"先把整段展开再找首个分型"语义等价。
+    返回 (b_first_bi_idx, b_has_gap_before) 或 None。
+    """
+    feat_dir = 'down' if seg_dir == 'up' else 'up'
+    up = (seg_dir == 'up')
+    std = []  # 每元素: [high, low, bi_idx, has_gap_before, first_bi_idx]
+    for k in range(start_i, end_i + 1):
+        b = bis[k]
+        if b.direction != feat_dir:
+            continue
+        ch = b.high; cl = b.low
+        if not std:
+            std.append([ch, cl, k, False, k]); continue
+        prev = std[-1]
+        ph = prev[0]; pl = prev[1]
+        contained = (ph >= ch and pl <= cl) or (ch >= ph and cl <= pl)
+        if contained:
+            if up:
+                prev[0] = ph if ph > ch else ch
+                prev[1] = pl if pl > cl else cl
+            else:
+                prev[0] = ph if ph < ch else ch
+                prev[1] = pl if pl < cl else cl
+            prev[2] = k
+            continue
+        std.append([ch, cl, k, gap_flag(cl, ch, ph, pl)] + [k])
+        # 锁定检查: 需要至少4个已定型元素, 才能保证倒数第3个(候选分型b)
+        # 的右邻c已被其后元素d终结、不会再被向后合并。
+        if len(std) >= 4:
+            a = std[-4]; bm = std[-3]; c = std[-2]
+            if up:
+                ok = (bm[0] > a[0] and bm[0] > c[0] and bm[1] > a[1] and bm[1] > c[1])
+            else:
+                ok = (bm[1] < a[1] and bm[1] < c[1] and bm[0] < a[0] and bm[0] < c[0])
+            if ok:
+                return (bm[4], bm[3])
+    # 收尾: 末端无后继元素, 用最终 std 找首个内部分型(与原实现等价)
+    for i in range(1, len(std) - 1):
+        a = std[i-1]; bm = std[i]; c = std[i+1]
+        if up:
+            ok = (bm[0] > a[0] and bm[0] > c[0] and bm[1] > a[1] and bm[1] > c[1])
+        else:
+            ok = (bm[1] < a[1] and bm[1] < c[1] and bm[0] < a[0] and bm[0] < c[0])
+        if ok:
+            return (bm[4], bm[3])
+    return None
+
+
+def gap_flag(cl, ch, ph, pl):
+    return (cl > ph) or (ch < pl)
+
+
+def _seq_fractal_confirms_reversal(bis, start_i, end_i, cur_dir):
+    fr = _first_feature_fractal_incremental(bis, start_i, end_i, cur_dir)
+    if fr is None:
+        return (False, None)
+    feat_first_bi, has_gap = fr
+    seg_end_bi = feat_first_bi - 1
+    if seg_end_bi <= start_i:
+        return (False, None)
+    if has_gap:
+        opp = 'down' if cur_dir == 'up' else 'up'
+        fr2 = _first_feature_fractal_incremental(bis, feat_first_bi, end_i, opp)
+        if fr2 is None:
+            return (False, None)
+    return (True, seg_end_bi)
+
+
+def find_segs(bis: list) -> list:
+    n = len(bis)
+    if n < 3:
+        return []
+    base = bis[0].start.price
+    look = min(3, n)
+    net = bis[look - 1].end.price - base
+    cur_dir = 'up' if net > 0 else 'down'
+    segs = []
+    i = 0
+    while i < n - 2:
+        confirmed, seg_end_bi = _seq_fractal_confirms_reversal(bis, i, n - 1, cur_dir)
+        if confirmed and seg_end_bi > i:
+            seg_bis = bis[i:seg_end_bi + 1]
+            net_up = seg_bis[-1].end.price > seg_bis[0].start.price
+            if (cur_dir == 'up') == net_up:
+                segs.append(Seg(start=bis[i].start, end=seg_bis[-1].end, direction=cur_dir,
+                                bis=seg_bis, high=max(b.high for b in seg_bis),
+                                low=min(b.low for b in seg_bis), confirmed=True))
+                i = seg_end_bi + 1
+                cur_dir = 'down' if cur_dir == 'up' else 'up'
+                continue
+        alt = 'down' if cur_dir == 'up' else 'up'
+        confirmed2, seg_end_bi2 = _seq_fractal_confirms_reversal(bis, i, n - 1, alt)
+        if confirmed2 and seg_end_bi2 > i:
+            seg_bis = bis[i:seg_end_bi2 + 1]
+            net_up = seg_bis[-1].end.price > seg_bis[0].start.price
+            if (alt == 'up') == net_up:
+                segs.append(Seg(start=seg_bis[0].start, end=seg_bis[-1].end, direction=alt,
+                                bis=seg_bis, high=max(b.high for b in seg_bis),
+                                low=min(b.low for b in seg_bis), confirmed=True))
+                i = seg_end_bi2 + 1
+                cur_dir = 'down' if alt == 'up' else 'up'
+                continue
+        break
+    if i < n - 1 and (n - i) >= 1:
+        seg_bis = bis[i:]
+        if len(seg_bis) >= 1:
+            net_up = seg_bis[-1].end.price > seg_bis[0].start.price
+            d = 'up' if net_up else 'down'
+            segs.append(Seg(start=seg_bis[0].start, end=seg_bis[-1].end, direction=d,
+                            bis=seg_bis, high=max(b.high for b in seg_bis),
+                            low=min(b.low for b in seg_bis), confirmed=False))
+    return segs
+
+
+PIVOT_UPGRADE_SPAN_DAYS = 540
+
+
+def find_pivots(bis: list, segs: Optional[list] = None) -> list:
+    confirmed_segs = [s for s in (segs or []) if getattr(s, 'confirmed', True)]
+    units = confirmed_segs if len(confirmed_segs) >= 3 else bis
+    using_segs = units is confirmed_segs
+    pivots = []; n = len(units)
+    if n < 3:
+        return pivots
+
+    bi_pos = {id(b): k for k, b in enumerate(bis)}
+
+    def _unit_bi_range(u):
+        if hasattr(u, 'bis'):
+            idxs = [bi_pos[id(b)] for b in u.bis if id(b) in bi_pos]
+            return (min(idxs), max(idxs)) if idxs else (0, 0)
+        k = bi_pos.get(id(u), 0)
+        return (k, k)
+
+    def _unit_bi_indices(unit_list):
+        out = []
+        for u in unit_list:
+            a, b = _unit_bi_range(u)
+            out.extend(range(a, b + 1))
+        return sorted(set(out))
+
+    def _unit_high_date(u):
+        return u.start.date if u.start.price >= u.end.price else u.end.date
+
+    def _unit_low_date(u):
+        return u.start.date if u.start.price <= u.end.price else u.end.date
+
+    max_ext = PIVOT_MAX_EXTEND_SEGS if PIVOT_MAX_EXTEND_SEGS else 10 ** 9
+
+    i = 0
+    while i <= n - 3:
+        b1, b2, b3 = units[i], units[i+1], units[i+2]
+        r1 = (b1.low, b1.high)
+        r2 = (b2.low, b2.high)
+        r3 = (b3.low, b3.high)
+        zg = min(r1[1], r2[1], r3[1]); zd = max(r1[0], r2[0], r3[0])
+        if zg > zd:
+            direction = b1.direction; zg_orig, zd_orig = zg, zd; gg, dd = zg, zd
+            highs = [r1[1], r2[1], r3[1]]; lows = [r1[0], r2[0], r3[0]]
+            zg_bi = (b1, b2, b3)[highs.index(zg_orig)]
+            zd_bi = (b1, b2, b3)[lows.index(zd_orig)]
+            zg_d = _unit_high_date(zg_bi)
+            zd_d = _unit_low_date(zd_bi)
+            gg_d, dd_d = zg_d, zd_d
+            zn_dir = direction
+            gn_list = []; dn_list = []
+            for bb in (b1, b2, b3):
+                if bb.direction == zn_dir:
+                    gn_list.append(max(bb.start.price, bb.end.price))
+                    dn_list.append(min(bb.start.price, bb.end.price))
+            piv_units = [i, i+1, i+2]; j = i + 3
+            capped = False
+            while j < n:
+                if (len(piv_units) - 3) >= max_ext:
+                    capped = True
+                    break
+                bj = units[j]; lo_j = bj.low; hi_j = bj.high
+                if hi_j >= zd_orig and lo_j <= zg_orig:
+                    if hi_j > gg:
+                        gg = hi_j; gg_d = _unit_high_date(bj)
+                    if lo_j < dd:
+                        dd = lo_j; dd_d = _unit_low_date(bj)
+                    if bj.direction == zn_dir:
+                        gn_list.append(hi_j); dn_list.append(lo_j)
+                    piv_units.append(j); j += 1
+                else:
+                    break
+            g_val = min(gn_list) if gn_list else zg_orig
+            d_val = max(dn_list) if dn_list else zd_orig
+            piv_bis = _unit_bi_indices([units[k] for k in piv_units]) if using_segs else piv_units
+            p_start = b1.start.date
+            p_end = units[piv_units[-1]].end.date
+            piv = Pivot(start_date=p_start, end_date=p_end,
+                        zg=zg_orig, zd=zd_orig, gg=gg, dd=dd, bis=piv_bis, direction=direction,
+                        zg_date=zg_d, zd_date=zd_d, gg_date=gg_d, dd_date=dd_d,
+                        g=g_val, d=d_val, capped=capped)
+            try:
+                span_days = (pd.Timestamp(p_end) - pd.Timestamp(p_start)).days
+            except Exception:
+                span_days = 0
+            if capped or span_days > PIVOT_UPGRADE_SPAN_DAYS:
+                piv.upgraded_level = 'weekly'
+            pivots.append(piv)
+            i = piv_units[-1] + 1
+        else:
+            i += 1
+
+    for k in range(1, len(pivots)):
+        prev, cur = pivots[k-1], pivots[k]
+        no_overlap = (cur.dd > prev.gg) or (cur.gg < prev.dd)
+        if no_overlap:
+            cur.state = 'new'
+        else:
+            cur.state = 'expand'
+
+    for k in range(len(pivots) - 1):
+        cur = pivots[k]
+        nxt = pivots[k + 1]
+        gap_start = cur.bis[-1] + 1
+        gap_end = nxt.bis[0]
+        gap_bis = bis[gap_start:gap_end] if gap_end > gap_start else []
+        if len(gap_bis) >= 2:
+            leave = gap_bis[:max(1, len(gap_bis) // 2)]
+            pull = gap_bis[max(1, len(gap_bis) // 2):]
+            leave_trend = len(leave) >= 3
+            pull_trend = len(pull) >= 3
+            if leave_trend and not pull_trend:
+                cur.death_combo = 'trend+consol'
+            elif leave_trend and pull_trend:
+                cur.death_combo = 'trend+counter'
+            else:
+                cur.death_combo = 'consol+counter'
+    return pivots
+
+
+def classify_trend(pivots: list) -> str:
+    if len(pivots) < 2:
+        return 'consolidation'
+    p1, p2 = pivots[-2], pivots[-1]
+    if p2.dd > p1.gg:
+        return 'up_trend'
+    if p2.gg < p1.dd:
+        return 'down_trend'
+    if (p2.zg < p1.zd and p2.gg >= p1.dd) or (p2.zd > p1.zg and p2.dd <= p1.gg):
+        return 'expanding'
+    return 'consolidation'
+
+
+def count_trend_pivots(pivots: list) -> int:
+    if not pivots:
+        return 0
+    if len(pivots) == 1:
+        return 1
+    cnt = 1
+    for k in range(len(pivots) - 1, 0, -1):
+        p_prev, p_cur = pivots[k - 1], pivots[k]
+        if p_cur.dd > p_prev.gg:
+            cnt += 1
+        elif p_cur.gg < p_prev.dd:
+            cnt += 1
+        else:
+            break
+    return cnt
+
+
+def calc_macd(close: pd.Series, fast=12, slow=26, signal=9):
+    ema_fast = close.ewm(span=fast, adjust=False).mean()
+    ema_slow = close.ewm(span=slow, adjust=False).mean()
+    dif = ema_fast - ema_slow
+    dea = dif.ewm(span=signal, adjust=False).mean()
+    macd_bar = 2 * (dif - dea)
+    return dif, dea, macd_bar
+
+
+def macd_area_between(start_date, end_date, bar_series, date_series, direction):
+    mask = (date_series >= start_date) & (date_series <= end_date)
+    vals = bar_series[mask]
+    if len(vals) == 0:
+        return 0.0
+    if direction == 'up':
+        return float(vals.clip(lower=0).sum())
+    return float(vals.clip(upper=0).abs().sum())
+
+
+def dif_extreme_in(start_date, end_date, dif_series, date_series, kind='peak'):
+    mask = (date_series >= start_date) & (date_series <= end_date)
+    vals = dif_series[mask]
+    if len(vals) == 0:
+        return 0.0
+    return float(vals.max()) if kind == 'peak' else float(vals.min())
+
+
+class ChanAnalyzer:
+    DIVERGE_RATIO = 0.80
+    PIVOT_TOLERANCE = 0.02
+    MIN_BI_BARS = 4
+    DIF_TOLERANCE = 0.01
+
+    CFG = {
+        'b1_allow_consol_diverge': True,
+        'b3s3_first_pullback_only': False,
+        'b2s2_anchor_to_first': False,
+        'b2_macd_zero_pullback': False,
+        'drop_upgraded_pivots': False,
+        # L88-90 中阴阶段MACD精确运用: 中阴判定除BOLL收口外, 加入MACD特征
+        #   'off'  = 维持原判定(仅BOLL收口+末笔未离开中枢)
+        #   'and'  = 须同时��足"黄白线绕0轴缠绕"(更严格, 减少误判中阴而拦截的好买点)
+        #   'or'   = 满足其一即算中阴(更宽松, 拦截更多)
+        'zhongyin_macd_mode': 'or',   # 实测'or'最优: 累计收益+35pp(383%→418%), 胜率45.3%→46.8%
+    }
+
+    def __init__(self, df: pd.DataFrame):
+        self.df_raw = df.reset_index(drop=True)
+        self.close = self.df_raw['close']
+        self.dif, self.dea, self.macd_bar = calc_macd(self.close)
+        self.merged = merge_klines(self.df_raw)
+        self.fractals = find_fractals(self.merged)
+        self.bis = find_bis(self.fractals, min_k=self.MIN_BI_BARS)
+        self._bi_index = {id(b): k for k, b in enumerate(self.bis)}
+        self.segs = find_segs(self.bis)
+        self.pivots_all = find_pivots(self.bis, self.segs)
+        if self.CFG.get('drop_upgraded_pivots'):
+            last_upg_idx = -1
+            for k, p in enumerate(self.pivots_all):
+                if p.upgraded_level:
+                    last_upg_idx = k
+            operative = [p for k, p in enumerate(self.pivots_all)
+                         if k > last_upg_idx and not p.upgraded_level]
+            self.pivots = operative
+        else:
+            self.pivots = self.pivots_all
+        self.trend = classify_trend(self.pivots)
+
+    @property
+    def n_bis(self): return len(self.bis)
+    @property
+    def n_segs(self): return len(self.segs)
+    @property
+    def n_pivots(self): return len(self.pivots)
+    @property
+    def n_pivots_all(self): return len(self.pivots_all)
+    @property
+    def n_trend_pivots(self): return count_trend_pivots(self.pivots)
+    @property
+    def has_upgraded_pivot(self):
+        return any(p.upgraded_level for p in self.pivots_all)
+
+    @staticmethod
+    def _ds(ts):
+        ts = pd.Timestamp(ts)
+        if ts.hour == 0 and ts.minute == 0:
+            return ts.strftime('%Y-%m-%d')
+        return ts.strftime('%Y-%m-%d %H:%M')
+
+    def _validate_abc(self, direction: str):
+        if self.n_pivots < 2:
+            return None
+        last_piv = self.pivots[-1]
+        prev_piv = self.pivots[-2]
+        ratio = len(prev_piv.bis) / max(len(last_piv.bis), 1)
+        if not (1 / 3 <= ratio <= 3):
+            return None
+        a_start_idx = prev_piv.bis[0]
+        a_end_idx = last_piv.bis[0]
+        if a_end_idx <= a_start_idx:
+            return None
+        c_start_idx = last_piv.bis[-1] + 1
+        if c_start_idx >= self.n_bis:
+            return None
+        return {'a_start_idx': a_start_idx, 'a_end_idx': a_end_idx,
+                'b_pivot': last_piv, 'c_start_idx': c_start_idx}
+
+    def _validate_abc_consol(self, direction: str):
+        if self.n_pivots < 1:
+            return None
+        piv = self.pivots[-1]
+        a_end_idx = piv.bis[0]
+        if a_end_idx <= 0:
+            return None
+        c_start_idx = piv.bis[-1] + 1
+        if c_start_idx >= self.n_bis:
+            return None
+        want = 'down' if direction == 'down' else 'up'
+        a_start_idx = a_end_idx
+        for k in range(a_end_idx - 1, -1, -1):
+            a_start_idx = k
+            if k >= 1 and self.bis[k].direction != want and self.bis[k-1].direction != want:
+                a_start_idx = k + 1
+                break
+        if a_start_idx >= a_end_idx:
+            return None
+        return {'a_start_idx': a_start_idx, 'a_end_idx': a_end_idx,
+                'b_pivot': piv, 'c_start_idx': c_start_idx}
+
+    def _check_c_new_extreme(self, c_start_idx: int, direction: str):
+        want = 'up' if direction == 'up' else 'down'
+        c_bis = [self.bis[k] for k in range(c_start_idx, self.n_bis)
+                 if self.bis[k].direction == want]
+        if not c_bis:
+            return False, None
+        last_piv = self.pivots[-1] if self.pivots else None
+        if direction == 'up':
+            c_ext = max(b.end.price for b in c_bis)
+            prior = (last_piv.gg if last_piv is not None
+                     else max((b.high for b in self.bis[:c_start_idx]), default=0.0))
+            return c_ext > prior * (1 - 0.001), c_ext
+        else:
+            c_ext = min(b.end.price for b in c_bis)
+            prior = (last_piv.dd if last_piv is not None
+                     else min((b.low for b in self.bis[:c_start_idx]), default=1e18))
+            return c_ext < prior * (1 + 0.001), c_ext
+
+    def _b_returns_to_zero(self, pivot) -> bool:
+        dates = self.df_raw['date']
+        mask = (dates >= pivot.start_date) & (dates <= pivot.end_date)
+        dif_b = self.dif[mask]
+        dea_b = self.dea[mask]
+        if len(dif_b) == 0 or len(dea_b) == 0:
+            return False
+        def near_zero(x):
+            if x.min() <= 0 <= x.max():
+                return True
+            return x.abs().min() < max(float(x.abs().max()), 1e-9) * 0.25
+        return near_zero(dif_b) and near_zero(dea_b)
+
+    def detect_double_pullback_to_zero(self, window: int = 40) -> bool:
+        n = len(self.dif)
+        if n < 10:
+            return False
+        dif = self.dif.iloc[-min(window, n):].reset_index(drop=True)
+        dea = self.dea.iloc[-min(window, n):].reset_index(drop=True)
+        hist = self.macd_bar.iloc[-min(window, n):].reset_index(drop=True)
+        scale = max(float(dif.abs().max()), float(dea.abs().max()), 1e-9)
+        near = scale * 0.25
+        zero_pulls = [i for i in range(len(dif))
+                      if abs(float(dif.iloc[i])) <= near and abs(float(dea.iloc[i])) <= near]
+        if len(zero_pulls) < 2:
+            return False
+        def peak_between(left, right):
+            vals = dif.iloc[left + 1:right]
+            if len(vals) < 2:
+                return None
+            rel = int(vals.idxmax())
+            return float(dif.iloc[rel]), float(hist.iloc[max(left + 1, rel - 3):rel + 1].clip(lower=0).sum())
+        def trough_between(left, right):
+            vals = dif.iloc[left + 1:right]
+            if len(vals) < 2:
+                return None
+            rel = int(vals.idxmin())
+            return float(dif.iloc[rel]), float(hist.iloc[max(left + 1, rel - 3):rel + 1].clip(upper=0).abs().sum())
+        first_pull, second_pull = zero_pulls[-2], zero_pulls[-1]
+        p1, p2 = peak_between(first_pull, second_pull), peak_between(second_pull, len(dif))
+        if p1 and p2 and p1[0] > 0 and p2[0] > 0 and p2[0] < p1[0] and p2[1] <= p1[1]:
+            return True
+        t1, t2 = trough_between(first_pull, second_pull), trough_between(second_pull, len(dif))
+        if t1 and t2 and t1[0] < 0 and t2[0] < 0 and t2[0] > t1[0] and t2[1] <= t1[1]:
+            return True
+        return False
+
+    def divergence_strength_by_position(self) -> str:
+        if len(self.dif) < 5:
+            return 'strong_pullback'
+        dif_now = float(self.dif.iloc[-1])
+        dif_abs_max = float(self.dif.abs().max())
+        if dif_abs_max <= 1e-9:
+            return 'strong_pullback'
+        if abs(dif_now) >= dif_abs_max * 0.85:
+            return 'weak_pullback'
+        return 'strong_pullback'
+
+    def classify_post_divergence(self, direction: str) -> dict:
+        if not self.pivots or self.n_bis < 2:
+            return {'evolution': 'unknown', 'reason': '无中枢或笔不足'}
+        last_piv = self.pivots[-1]
+        after_idx = last_piv.bis[-1] + 1
+        def first_reversal_seg(want_dir):
+            for s in self.segs:
+                if not getattr(s, 'confirmed', True) or s.direction != want_dir:
+                    continue
+                try:
+                    first_idx = self._bi_index[id(s.bis[0])]
+                except KeyError:
+                    continue
+                if first_idx >= after_idx:
+                    return s
+            return None
+        if direction == 'down':
+            rebound = first_reversal_seg('up')
+            if rebound is None:
+                rebound = None
+                for b in self.bis[after_idx:]:
+                    if b.direction == 'up':
+                        rebound = b; break
+            if rebound is None:
+                return {'evolution': 'unknown', 'reason': '无反弹笔'}
+            if rebound.high < last_piv.zd:
+                return {'evolution': 'case1_extend',
+                        'reason': f'反弹高{rebound.high:.3f}<最后中枢ZD{last_piv.zd:.3f} → 第29课情况①未回中枢(最弱,宜尽快撤)'}
+            if rebound.high >= last_piv.zd:
+                return {'evolution': 'case2_3_turn',
+                        'reason': f'反弹回到中枢(高{rebound.high:.3f}≥ZD{last_piv.zd:.3f}) → 第29课情况②③转折(可持有等三买)'}
+            return {'evolution': 'case1_extend',
+                    'reason': f'反弹未回中枢(高{rebound.high:.3f}<ZD{last_piv.zd:.3f}) → 偏向中枢扩展'}
+        else:
+            pullback = first_reversal_seg('down')
+            if pullback is None:
+                pullback = None
+                for b in self.bis[after_idx:]:
+                    if b.direction == 'down':
+                        pullback = b; break
+            if pullback is None:
+                return {'evolution': 'unknown', 'reason': '无回落笔'}
+            if pullback.low > last_piv.zg:
+                return {'evolution': 'case1_extend',
+                        'reason': f'回落低{pullback.low:.3f}>最后中枢ZG{last_piv.zg:.3f} → 第29课情况①未回中枢(最弱)'}
+            if pullback.low <= last_piv.zg:
+                return {'evolution': 'case2_3_turn',
+                        'reason': f'回落回到中枢(低{pullback.low:.3f}≤ZG{last_piv.zg:.3f}) → 第29课情况②③转折'}
+            return {'evolution': 'case1_extend',
+                    'reason': f'回落未回中枢 → 偏向中枢扩展'}
+
+    def macd_wrap_zero(self, window: int = 15) -> bool:
+        """L88-90: 中阴阶段的MACD特征 —— 黄白线(DIF/DEA)绕0轴缠绕。
+        近window根K线中, DIF与DEA的绝对值大多压在历史摆幅的25%以内即视为缠绕。"""
+        n = len(self.dif)
+        if n < window + 5:
+            return False
+        dif = self.dif.iloc[-window:]
+        dea = self.dea.iloc[-window:]
+        scale = max(float(self.dif.abs().tail(120).max()),
+                    float(self.dea.abs().tail(120).max()), 1e-9)
+        near = scale * 0.25
+        frac = float(((dif.abs() <= near) & (dea.abs() <= near)).mean())
+        return frac >= 0.6
+
+    def macd_clarity(self, window: int = 60) -> dict:
+        """L50: 本级别MACD的"清晰度" —— 柱子面积幅度 + 黄白线分离度, 归一化打分。
+        清晰度高的级别其背驰判定更可靠; 多级别联立时应优先采信清晰级别的MACD结论。"""
+        n = len(self.dif)
+        if n < 10:
+            return {'score': 0.0, 'label': '数据不足'}
+        w = min(window, n)
+        dif = self.dif.iloc[-w:]
+        dea = self.dea.iloc[-w:]
+        hist = self.macd_bar.iloc[-w:]
+        px = max(float(self.close.iloc[-1]), 1e-9)
+        bar_amp = float(hist.abs().mean()) / px          # 柱子相对幅度
+        sep     = float((dif - dea).abs().mean()) / px   # 黄白线分离度
+        # 黄白线贴着0轴乱绕 → 不清晰
+        wrap_penalty = 0.5 if self.macd_wrap_zero() else 1.0
+        score = (bar_amp * 0.6 + sep * 0.4) * 1e3 * wrap_penalty
+        label = '清晰' if score >= 1.0 else ('一般' if score >= 0.4 else '模糊(黄白线/柱子贴0轴)')
+        return {'score': round(score, 3), 'label': label,
+                'bar_amp': round(bar_amp * 1e3, 3), 'sep': round(sep * 1e3, 3)}
+
+    def in_zhongyin(self) -> dict:
+        n = len(self.close)
+        if n < 20 or not self.pivots:
+            return {'in_zhongyin': False, 'boll_squeeze': False, 'reason': '数据不足'}
+        ma = self.close.rolling(20).mean()
+        sd = self.close.rolling(20).std()
+        if ma.iloc[-1] and ma.iloc[-1] > 0:
+            width = float((4 * sd.iloc[-1]) / ma.iloc[-1])
+        else:
+            width = 0.0
+        wseries = (4 * sd / ma).dropna().tail(60)
+        squeeze = bool(len(wseries) >= 20 and width <= wseries.quantile(0.30))
+        osc = self.zhongshu_oscillation_monitor()
+        macd_wrap = self.macd_wrap_zero()
+        dbl_pull = self.detect_double_pullback_to_zero()
+        mode = self.CFG.get('zhongyin_macd_mode', 'off')
+        if mode == 'and':
+            in_zy = (not osc.get('alert', False)) and squeeze and macd_wrap
+        elif mode == 'or':
+            in_zy = (not osc.get('alert', False)) and (squeeze or macd_wrap)
+        else:
+            in_zy = (not osc.get('alert', False)) and squeeze
+        reason = (f"BOLL带宽{width:.3f}{'(收口→中阴)' if squeeze else '(开口)'}; "
+                  f"MACD黄白线{'绕0轴缠绕(L88-90中阴特征)' if macd_wrap else '已展开'}"
+                  f"{'; 双回拉0轴(L89: 中阴结束转折预备)' if dbl_pull else ''}; {osc.get('reason','')}")
+        return {'in_zhongyin': in_zy, 'boll_squeeze': squeeze,
+                'macd_wrap_zero': macd_wrap, 'double_pullback_zero': dbl_pull,
+                'reason': reason}
+
+    def zhongshu_oscillation_monitor(self) -> dict:
+        if not self.pivots or self.n_bis < 1:
+            return {'alert': False, 'direction': '', 'reason': '无中枢'}
+        last_piv = self.pivots[-1]
+        cur = self.bis[-1]
+        if cur.low > last_piv.zg:
+            return {'alert': True, 'direction': 'up',
+                    'reason': f'第92课: 末笔({cur.low:.3f}~{cur.high:.3f})已离开中枢上沿ZG{last_piv.zg:.3f} → 向上变盘预警'}
+        if cur.high < last_piv.zd:
+            return {'alert': True, 'direction': 'down',
+                    'reason': f'第92课: 末笔({cur.low:.3f}~{cur.high:.3f})已离开中枢下沿ZD{last_piv.zd:.3f} → 向下变盘预警'}
+        return {'alert': False, 'direction': '', 'reason': '末笔仍在中枢区间内, 中枢震荡延续'}
+
+    def bottom_construction_state(self) -> str:
+        has_b1 = self.detect_b1() is not None
+        has_b3 = self.detect_b3() is not None
+        has_s3 = self.detect_s3() is not None
+        if has_s3:
+            return 'failed'
+        if has_b3:
+            return 'completed'
+        if has_b1:
+            return 'constructing'
+        return 'none'
+
+    def _seg_index_range(self, seg):
+        m = self._bi_index
+        try:
+            return m[id(seg.bis[0])], m[id(seg.bis[-1])]
+        except KeyError:
+            return None
+
+    def _bi_exit_pullback_fallback(self, pivot, exit_dir: str, pull_dir: str):
+        pe = pivot.bis[-1]
+        leave = pull = None
+        for k in range(pe + 1, self.n_bis):
+            b = self.bis[k]
+            if leave is None:
+                if b.direction == exit_dir:
+                    leave = b
+                continue
+            if b.direction == pull_dir:
+                pull = b
+                break
+        if leave is None or pull is None:
+            return None
+        return leave, pull
+
+    def _last_exit_pullback_segments(self, pivot, exit_dir: str, pull_dir: str):
+        pivot_end = pivot.bis[-1]
+        seq = []
+        for s in (self.segs or []):
+            if not getattr(s, 'confirmed', True):
+                continue
+            rng = self._seg_index_range(s)
+            if rng is None:
+                continue
+            first_idx, last_idx = rng
+            if last_idx < pivot_end:
+                continue
+            seq.append((s, first_idx, last_idx))
+        first_only = self.CFG.get('b3s3_first_pullback_only')
+        if first_only:
+            for i in range(len(seq) - 1):
+                leave, lf, _ = seq[i]
+                pull = seq[i + 1][0]
+                if leave.direction == exit_dir and pull.direction == pull_dir and lf >= pivot_end:
+                    return leave, pull
+        else:
+            for i in range(len(seq) - 1, 0, -1):
+                pull, _, _ = seq[i]
+                leave, _, _ = seq[i - 1]
+                if leave.direction == exit_dir and pull.direction == pull_dir:
+                    return leave, pull
+        return self._bi_exit_pullback_fallback(pivot, exit_dir, pull_dir)
+
+    def assess_divergence(self, a_start, a_end, c_start, c_end, direction: str) -> DivergenceGrade:
+        dates = self.df_raw['date']
+        n_tp = self.n_trend_pivots
+        is_trend_div = n_tp >= 2
+        a_area = macd_area_between(a_start, a_end, self.macd_bar, dates, direction)
+        c_area = macd_area_between(c_start, c_end, self.macd_bar, dates, direction)
+        if a_area <= 1e-9:
+            return DivergenceGrade('NONE', False, False, 0.0, a_area, c_area, 0.0, 0.0,
+                                   direction, 'A段MACD面积为0,无可比基准',
+                                   is_trend_divergence=is_trend_div, n_trend_pivots=n_tp)
+        ratio = c_area / a_area
+        area_ok = ratio < self.DIVERGE_RATIO
+        TOL = self.DIF_TOLERANCE
+        if direction == 'up':
+            a_dif = dif_extreme_in(a_start, a_end, self.dif, dates, 'peak')
+            c_dif = dif_extreme_in(c_start, c_end, self.dif, dates, 'peak')
+            dif_ok = c_dif < a_dif * (1 - TOL)
+        else:
+            a_dif = dif_extreme_in(a_start, a_end, self.dif, dates, 'trough')
+            c_dif = dif_extreme_in(c_start, c_end, self.dif, dates, 'trough')
+            dif_ok = c_dif > a_dif * (1 - TOL)
+        ext_label = 'DIF峰' if direction == 'up' else 'DIF谷'
+        div_kind = '趋势背驰' if is_trend_div else '盘整背驰'
+        if area_ok and dif_ok:
+            grade = 'STRONG'
+            reason = f'标准{div_kind}(面积+DIF均满足)|A面积:{a_area:.4f} C面积:{c_area:.4f}(比值{ratio:.1%}<{self.DIVERGE_RATIO:.0%})|{ext_label} A:{a_dif:.4f} C:{c_dif:.4f}|{n_tp}中枢'
+        elif area_ok and not dif_ok:
+            grade = 'WEAK'
+            reason = f'{div_kind}信号(面积触发)|A面积:{a_area:.4f} C面积:{c_area:.4f}(比值{ratio:.1%}<{self.DIVERGE_RATIO:.0%})|{n_tp}中枢'
+        elif dif_ok and not area_ok:
+            grade = 'WEAK'
+            reason = f'{div_kind}信号(DIF触发)|{ext_label} A:{a_dif:.4f} C:{c_dif:.4f}|{n_tp}中枢'
+        else:
+            grade = 'NONE'
+            reason = f'无背驰(两判据均不满足)|面积比{ratio:.1%}>={self.DIVERGE_RATIO:.0%}|{ext_label} A:{a_dif:.4f} C:{c_dif:.4f}'
+        return DivergenceGrade(grade, area_ok, dif_ok, ratio, a_area, c_area, a_dif, c_dif,
+                               direction, reason, is_trend_divergence=is_trend_div, n_trend_pivots=n_tp)
+
+    def _find_prev_b1(self) -> tuple:
+        if not self.pivots:
+            return (None, '')
+        last_piv = self.pivots[-1]
+        pivot_first_bi_idx = last_piv.bis[0]
+        if pivot_first_bi_idx <= 0:
+            return (None, '')
+        downs = []
+        for k in range(pivot_first_bi_idx - 1, -1, -1):
+            b = self.bis[k]
+            downs.append(b)
+            if b.direction == 'up' and k - 1 >= 0 and self.bis[k-1].direction == 'down':
+                if len(downs) >= 4:
+                    break
+        down_bis = [b for b in downs if b.direction == 'down']
+        if not down_bis:
+            return (None, '')
+        b1 = min(down_bis, key=lambda b: b.end.price)
+        return (b1.end.price, self._ds(b1.end.date))
+
+    def _find_prev_b2(self) -> tuple:
+        b1_price, b1_date_str = self._find_prev_b1()
+        if b1_price is None or not self.pivots:
+            return (None, '')
+        b1_date = pd.Timestamp(b1_date_str)
+        last_piv = self.pivots[-1]
+        right_bi_idx = last_piv.bis[-1] + 1
+        for b in self.bis[:right_bi_idx]:
+            if b.direction != 'down':
+                continue
+            if b.end.date <= b1_date:
+                continue
+            if b.end.price > b1_price + 1e-9:
+                return (b.end.price, self._ds(b.end.date))
+        return (None, '')
+
+    def _find_prev_s1(self) -> tuple:
+        if not self.pivots:
+            return (None, '')
+        last_piv = self.pivots[-1]
+        pivot_first_bi_idx = last_piv.bis[0]
+        if pivot_first_bi_idx <= 0:
+            return (None, '')
+        ups = []
+        for k in range(pivot_first_bi_idx - 1, -1, -1):
+            b = self.bis[k]
+            ups.append(b)
+            if b.direction == 'down' and k - 1 >= 0 and self.bis[k-1].direction == 'up':
+                if len(ups) >= 4:
+                    break
+        up_bis = [b for b in ups if b.direction == 'up']
+        if not up_bis:
+            return (None, '')
+        s1 = max(up_bis, key=lambda b: b.end.price)
+        return (s1.end.price, self._ds(s1.end.date))
+
+    def _find_prev_s2(self) -> tuple:
+        s1_price, s1_date_str = self._find_prev_s1()
+        if s1_price is None or not self.pivots:
+            return (None, '')
+        s1_date = pd.Timestamp(s1_date_str)
+        last_piv = self.pivots[-1]
+        right_bi_idx = last_piv.bis[-1] + 1
+        for b in self.bis[:right_bi_idx]:
+            if b.direction != 'up':
+                continue
+            if b.end.date <= s1_date:
+                continue
+            if b.end.price < s1_price - 1e-9:
+                return (b.end.price, self._ds(b.end.date))
+        return (None, '')
+
+    def detect_b1(self) -> Optional[Signal]:
+        if self.n_bis < 5:
+            return None
+        cur = self.bis[-1]
+        if cur.direction != 'down':
+            return None
+        dif_now = float(self.dif.iloc[-1])
+        if dif_now >= 0:
+            return None
+        trend_ok = (self.n_pivots >= 2 and self.trend == 'down_trend')
+        consol_ok = (self.CFG.get('b1_allow_consol_diverge') and self.n_pivots >= 1)
+        if not (trend_ok or consol_ok):
+            return None
+        abc = self._validate_abc('down')
+        if abc is None and consol_ok:
+            abc = self._validate_abc_consol('down')
+        if abc is None:
+            return None
+        c_ok, c_low = self._check_c_new_extreme(abc['c_start_idx'], 'down')
+        if not c_ok:
+            return None
+        last_piv = self.pivots[-1]
+        a_down = [self.bis[k] for k in range(abc['a_start_idx'], abc['a_end_idx'])
+                  if self.bis[k].direction == 'down']
+        c_down = [self.bis[k] for k in range(abc['c_start_idx'], self.n_bis)
+                  if self.bis[k].direction == 'down']
+        if not a_down or not c_down:
+            return None
+        dg = self.assess_divergence(a_down[0].start.date, a_down[-1].end.date,
+                                    c_down[0].start.date, c_down[-1].end.date, 'down')
+        if dg.grade == 'NONE':
+            return None
+        div_kind = '趋势底背驰' if dg.is_trend_divergence else '盘整底背驰(第27课)'
+        b_zero = self._b_returns_to_zero(last_piv)
+        dbl_pull = self.detect_double_pullback_to_zero()
+        pos_strength = self.divergence_strength_by_position()
+        post_evo = self.classify_post_divergence('down')
+        a_low_bi = min(a_down, key=lambda b: b.end.price)
+        c_low_bi = min(c_down, key=lambda b: b.end.price)
+        return Signal(kind='B1', date=self.df_raw['date'].iloc[-1], price=float(self.close.iloc[-1]),
+                      reason=f'{div_kind}一买|{self.n_pivots}中枢|ABC三段{"+B回0轴" if b_zero else ""}|{dg.reason}|DIF={dif_now:.4f}<0',
+                      pivot_zg=last_piv.zg, pivot_zd=last_piv.zd, macd_ratio=dg.area_ratio, dif_value=dif_now,
+                      n_pivots=self.n_pivots, trend=self.trend,
+                      extras={'a_seg': (a_down[0].start.date, a_down[-1].end.date, a_down[0].start.price, a_down[-1].end.price),
+                              'diverge_grade': dg.grade,
+                              'a_low': float(a_low_bi.end.price),
+                              'a_low_date': self._ds(a_low_bi.end.date),
+                              'b1_price': float(cur.end.price),
+                              'b1_date': self._ds(cur.end.date),
+                              'macd_grade': dg.grade,
+                              'macd_area_ratio': dg.area_ratio,
+                              'dif_ok': dg.dif_ok,
+                              'area_ok': dg.area_ok,
+                              'b_returns_zero': b_zero,
+                              'double_pullback': dbl_pull,
+                              'pos_strength': pos_strength,
+                              'post_evolution': post_evo['evolution'],
+                              'c_new_low': c_low,
+                              'c_new_low_date': self._ds(c_low_bi.end.date),
+                              'n_trend_pivots': self.n_trend_pivots,
+                              'price_date': self._ds(cur.end.date),
+                              'pivot_zg_date': self._ds(last_piv.zg_date) if last_piv.zg_date else '',
+                              'pivot_zd_date': self._ds(last_piv.zd_date) if last_piv.zd_date else '',
+                              'pivot_start_date': self._ds(last_piv.start_date),
+                              'pivot_end_date': self._ds(last_piv.end_date)},
+                      diverge_grade=dg)
+
+    def detect_b2(self) -> Optional[Signal]:
+        if self.n_bis < 4:
+            return None
+        cur = self.bis[-1]
+        if cur.direction != 'down':
+            return None
+        prev_downs = [b for b in self.bis[:-1] if b.direction == 'down']
+        if not prev_downs:
+            return None
+        prev = prev_downs[-1]
+        if not (cur.low >= prev.low and cur.end.price > prev.end.price):
+            return None
+        cur_price = float(self.close.iloc[-1])
+        if cur_price < cur.end.price * (1 - self.PIVOT_TOLERANCE):
+            return None
+        if self.CFG.get('b2s2_anchor_to_first'):
+            b1_anchor, _ = self._find_prev_b1()
+            if b1_anchor is None:
+                return None
+            if cur.end.price < b1_anchor - 1e-9:
+                return None
+        dif_now = float(self.dif.iloc[-1])
+        if self.CFG.get('b2_macd_zero_pullback'):
+            look = self.dif.tail(12)
+            crossed_up = bool((look > 0).any())
+            if not crossed_up:
+                return None
+            if dif_now < -self.DIF_TOLERANCE:
+                return None
+        last_piv = self.pivots[-1] if self.pivots else None
+        b1_price, b1_date = prev.end.price, self._ds(prev.end.date)
+        return Signal(kind='B2', date=self.df_raw['date'].iloc[-1], price=cur_price,
+                      reason=f'二买:一买后回踩不破|当前低{cur.end.price:.3f}>一买{b1_price:.3f}|二买不以背驰为成立条件(第21课)',
+                      pivot_zg=None, pivot_zd=None,
+                      macd_ratio=None, dif_value=dif_now, n_pivots=self.n_pivots, trend=self.trend,
+                      extras={'prev_low': prev.end.price, 'cur_low': cur.end.price,
+                              'cur_low_date': self._ds(cur.end.date),
+                              'prev_low_date': self._ds(prev.end.date),
+                              'b1_price': b1_price,
+                              'b1_date': b1_date,
+                              'price_date': self._ds(cur.end.date),
+                              'context_pivot_zg': last_piv.zg if last_piv else None,
+                              'context_pivot_zd': last_piv.zd if last_piv else None,
+                              'context_pivot_zg_date': self._ds(last_piv.zg_date) if last_piv and last_piv.zg_date else '',
+                              'context_pivot_zd_date': self._ds(last_piv.zd_date) if last_piv and last_piv.zd_date else '',
+                              'context_pivot_start_date': self._ds(last_piv.start_date) if last_piv else '',
+                              'context_pivot_end_date': self._ds(last_piv.end_date) if last_piv else ''},
+                      diverge_grade=None)
+
+    def detect_b3(self) -> Optional[Signal]:
+        if self.n_bis < 5 or self.n_pivots < 1:
+            return None
+        late_trend_b3 = self.n_trend_pivots >= 2
+        last_piv = self.pivots[-1]
+        zg, zd = last_piv.zg, last_piv.zd
+        piv_height = zg - zd
+        cur = self.bis[-1]
+        if cur.direction != 'up':
+            return None
+        pair = self._last_exit_pullback_segments(last_piv, 'up', 'down')
+        if pair is None:
+            return None
+        exit_seg, pull_seg = pair
+        if not (exit_seg.low <= zg * (1 + self.PIVOT_TOLERANCE) and exit_seg.high > zg):
+            return None
+        if pull_seg.low < zg * (1 - self.PIVOT_TOLERANCE):
+            return None
+        leaves_pivot = pull_seg.low >= zg
+        cur_price = float(self.close.iloc[-1])
+        if cur_price <= zg:
+            return None
+        ex_amp = exit_seg.high - exit_seg.low
+        if piv_height > 0 and ex_amp < piv_height * 0.5:
+            return None
+        if len(last_piv.bis) < 3:
+            return None
+        confirm_txt = '回踩离枢确认(新中枢生成)' if leaves_pivot else '回踩贴ZG(容差内,新中枢待确认)'
+        b1_price, b1_date = self._find_prev_b1()
+        b2_price, b2_date = self._find_prev_b2()
+        warn_txt = '|第二个以上同向中枢,实盘宜改用低级别一买' if late_trend_b3 else ''
+        return Signal(kind='B3', date=self.df_raw['date'].iloc[-1], price=cur_price,
+                      reason=f'标准三买|ZG={zg:.3f},ZD={zd:.3f}|线段离枢:{exit_seg.low:.3f}→{exit_seg.high:.3f}(幅度{ex_amp:.3f})|线段回试低{pull_seg.low:.3f}|{confirm_txt}|当前{cur_price:.3f}>ZG{warn_txt}',
+                      pivot_zg=zg, pivot_zd=zd, macd_ratio=None, dif_value=float(self.dif.iloc[-1]),
+                      n_pivots=self.n_pivots, trend=self.trend,
+                      extras={'exit_seg': (exit_seg.low, exit_seg.high),
+                              'pull_low': pull_seg.low,
+                              'pull_low_date': self._ds(pull_seg.end.date),
+                              'exit_start_date': self._ds(exit_seg.start.date),
+                              'exit_end_date': self._ds(exit_seg.end.date),
+                              'b1_price': b1_price,
+                              'b1_date': b1_date,
+                              'b2_price': b2_price,
+                              'b2_date': b2_date,
+                              'piv_bi_count': len(last_piv.bis), 'leaves_pivot': leaves_pivot,
+                              'late_trend_b3': late_trend_b3,
+                              'price_date': self._ds(self.df_raw['date'].iloc[-1]),
+                              'pivot_zg_date': self._ds(last_piv.zg_date) if last_piv.zg_date else '',
+                              'pivot_zd_date': self._ds(last_piv.zd_date) if last_piv.zd_date else '',
+                              'pivot_start_date': self._ds(last_piv.start_date),
+                              'pivot_end_date': self._ds(last_piv.end_date)},
+                      diverge_grade=None)
+
+    def detect_s1(self) -> Optional[Signal]:
+        if self.n_bis < 5:
+            return None
+        cur = self.bis[-1]
+        if cur.direction != 'up':
+            return None
+        trend_ok = (self.n_pivots >= 2 and self.trend == 'up_trend')
+        consol_ok = (self.CFG.get('b1_allow_consol_diverge') and self.n_pivots >= 1)
+        if not (trend_ok or consol_ok):
+            return None
+        abc = self._validate_abc('up')
+        if abc is None and consol_ok:
+            abc = self._validate_abc_consol('up')
+        if abc is None:
+            return None
+        last_piv = self.pivots[-1]
+        a_start_idx = abc['a_start_idx']; a_end_idx = abc['a_end_idx']
+        if a_end_idx <= a_start_idx:
+            return None
+        a_up_bis = [self.bis[k] for k in range(a_start_idx, a_end_idx) if self.bis[k].direction == 'up']
+        if not a_up_bis:
+            return None
+        a_high = max(b.end.price for b in a_up_bis)
+        c_start_idx = last_piv.bis[-1] + 1
+        c_up_bis = [self.bis[k] for k in range(c_start_idx, self.n_bis) if self.bis[k].direction == 'up']
+        if not c_up_bis:
+            return None
+        c_high = max(b.end.price for b in c_up_bis)
+        if c_high <= a_high:
+            return None
+        a_high_bi = max(a_up_bis, key=lambda b: b.end.price)
+        dg = self.assess_divergence(a_up_bis[0].start.date, a_up_bis[-1].end.date,
+                                    c_up_bis[0].start.date, c_up_bis[-1].end.date, 'up')
+        if dg.grade == 'NONE':
+            return None
+        b_zero = self._b_returns_to_zero(last_piv)
+        dbl_pull = self.detect_double_pullback_to_zero()
+        pos_strength = self.divergence_strength_by_position()
+        post_evo = self.classify_post_divergence('up')
+        dif_now = float(self.dif.iloc[-1])
+        c_high_bi = max(c_up_bis, key=lambda b: b.end.price)
+        return Signal(kind='S1', date=self.df_raw['date'].iloc[-1], price=float(self.close.iloc[-1]),
+                      reason=f'一卖|上涨趋势{self.n_pivots}中枢|价创新高C{c_high:.3f}>A段高{a_high:.3f}{"+B回0轴" if b_zero else ""}|{dg.reason}',
+                      pivot_zg=last_piv.zg, pivot_zd=last_piv.zd, macd_ratio=dg.area_ratio, dif_value=dif_now,
+                      n_pivots=self.n_pivots, trend=self.trend,
+                      extras={'a_high': a_high, 'c_high': c_high, 'a_area': dg.a_area, 'c_area': dg.c_area,
+                              'diverge_grade': dg.grade,
+                              'a_high_date': self._ds(a_high_bi.end.date),
+                              'b_returns_zero': b_zero,
+                              'double_pullback': dbl_pull,
+                              'pos_strength': pos_strength,
+                              'post_evolution': post_evo['evolution'],
+                              'c_high_date': self._ds(c_high_bi.end.date),
+                              'price_date': self._ds(cur.end.date),
+                              'pivot_zg_date': self._ds(last_piv.zg_date) if last_piv.zg_date else '',
+                              'pivot_zd_date': self._ds(last_piv.zd_date) if last_piv.zd_date else '',
+                              'pivot_start_date': self._ds(last_piv.start_date),
+                              'pivot_end_date': self._ds(last_piv.end_date)},
+                      diverge_grade=dg)
+
+    def detect_s2(self) -> Optional[Signal]:
+        if self.n_bis < 4:
+            return None
+        cur = self.bis[-1]
+        if cur.direction != 'up':
+            return None
+        prev_ups = [b for b in self.bis[:-1] if b.direction == 'up']
+        if not prev_ups:
+            return None
+        prev = prev_ups[-1]
+        if cur.high < prev.high and cur.end.price < prev.end.price:
+            cur_price = float(self.close.iloc[-1])
+            if cur_price > cur.end.price * (1 + self.PIVOT_TOLERANCE):
+                return None
+            if self.CFG.get('b2s2_anchor_to_first'):
+                s1_anchor, _ = self._find_prev_s1()
+                if s1_anchor is None:
+                    return None
+                if cur.end.price > s1_anchor + 1e-9:
+                    return None
+            dif_now = float(self.dif.iloc[-1])
+            last_piv = self.pivots[-1] if self.pivots else None
+            s1_price, s1_date = prev.end.price, self._ds(prev.end.date)
+            return Signal(kind='S2', date=self.df_raw['date'].iloc[-1], price=cur_price,
+                          reason=f'二卖:一卖后反弹不破|当前高{cur.end.price:.3f}<一卖{s1_price:.3f}|二卖不以背驰为成立条件(第21课)',
+                          pivot_zg=None, pivot_zd=None,
+                          dif_value=dif_now, n_pivots=self.n_pivots, trend=self.trend,
+                          extras={'prev_high': prev.end.price, 'cur_high': cur.end.price,
+                                  'cur_high_date': self._ds(cur.end.date),
+                                  'prev_high_date': self._ds(prev.end.date),
+                                  's1_price': s1_price, 's1_date': s1_date,
+                                  'price_date': self._ds(cur.end.date),
+                                  'context_pivot_zg': last_piv.zg if last_piv else None,
+                                  'context_pivot_zd': last_piv.zd if last_piv else None,
+                                  'context_pivot_zg_date': self._ds(last_piv.zg_date) if last_piv and last_piv.zg_date else '',
+                                  'context_pivot_zd_date': self._ds(last_piv.zd_date) if last_piv and last_piv.zd_date else '',
+                                  'context_pivot_start_date': self._ds(last_piv.start_date) if last_piv else '',
+                                  'context_pivot_end_date': self._ds(last_piv.end_date) if last_piv else ''},
+                          diverge_grade=None)
+        return None
+
+    def detect_s3(self) -> Optional[Signal]:
+        if self.n_bis < 5 or self.n_pivots < 1:
+            return None
+        last_piv = self.pivots[-1]
+        zg, zd = last_piv.zg, last_piv.zd
+        if len(self.bis) < 3:
+            return None
+        cur = self.bis[-1]
+        if cur.direction != 'down':
+            return None
+        s1_price, s1_date = self._find_prev_s1()
+        s2_price, s2_date = self._find_prev_s2()
+        base_dates = {'price_date': self._ds(self.df_raw['date'].iloc[-1]),
+                      's1_price': s1_price, 's1_date': s1_date,
+                      's2_price': s2_price, 's2_date': s2_date,
+                      'pivot_zg_date': self._ds(last_piv.zg_date) if last_piv.zg_date else '',
+                      'pivot_zd_date': self._ds(last_piv.zd_date) if last_piv.zd_date else '',
+                      'pivot_start_date': self._ds(last_piv.start_date),
+                      'pivot_end_date': self._ds(last_piv.end_date)}
+        pair = self._last_exit_pullback_segments(last_piv, 'down', 'up')
+        if pair is None:
+            return None
+        exit_seg, pull_seg = pair
+        if not (exit_seg.high >= zd * (1 - self.PIVOT_TOLERANCE) and exit_seg.low < zd):
+            return None
+        if pull_seg.high > zd * (1 + self.PIVOT_TOLERANCE):
+            return None
+        if float(self.close.iloc[-1]) >= zd:
+            return None
+        return Signal(kind='S3', date=self.df_raw['date'].iloc[-1], price=float(self.close.iloc[-1]),
+                      reason=f'标准三卖|ZD={zd:.3f}|线段离枢低{exit_seg.low:.3f}<ZD|线段回抽高{pull_seg.high:.3f}未过ZD',
+                      pivot_zg=zg, pivot_zd=zd, dif_value=float(self.dif.iloc[-1]),
+                      n_pivots=self.n_pivots, trend=self.trend, extras=base_dates, diverge_grade=None)
+
+    def get_signal(self) -> Optional[Signal]:
+        for fn in [self.detect_s1, self.detect_s2, self.detect_s3]:
+            sig = fn()
+            if sig is not None:
+                return sig
+        for fn in [self.detect_b3, self.detect_b2, self.detect_b1]:
+            sig = fn()
+            if sig is not None:
+                return sig
+        return None
+
+    def get_all_signals(self) -> list:
+        all_sigs = []
+        for fn in [self.detect_b1, self.detect_b2, self.detect_b3,
+                   self.detect_s1, self.detect_s2, self.detect_s3]:
+            sig = fn()
+            if sig is not None:
+                all_sigs.append(sig)
+        return all_sigs
+
+    def l36_segment_note(self) -> str:
+        """L36 结合律: 走势分解的唯一性靠结合律保证 —— a+A+b+B+c 的划分中, 同一段
+        K线不能既归前段又归后段。本引擎线段划分采用特征序列分型(标准缠论)处理
+        包含关系, 分型一旦确认即锁定段的归属, 等价于结合律的程序化执行。
+        该函数对当前末端给出"是否存在划分歧义"的提示。"""
+        if len(self.segs) < 2:
+            return '第36课: 线段不足2段, 无划分歧义问题'
+        last = self.segs[-1]
+        n_last = len(getattr(last, 'bis', []) or [])
+        if n_last < 3:
+            return (f'第36课: 末段仅{n_last}笔(<3), 末端划分尚未唯一确认 —— '
+                    f'当下操作应按两种归属做完全分类预案, 等待特征序列分型锁定')
+        return '第36课: 末段≥3笔且特征序列分型已锁定, 当前划分唯一, 无歧义'
+
+    def diagnose(self) -> dict:
+        cur_price = float(self.close.iloc[-1]) if len(self.close) else 0.0
+        last = self.bis[-1] if self.bis else None
+        out = {k: [] for k in ('B1', 'B2', 'B3', 'S1', 'S2', 'S3')}
+        def add(k, ok, msg):
+            out[k].append(('✓' if ok else '✗') + ' ' + msg)
+        add('B1', self.n_bis >= 5, f'笔数 {self.n_bis} >= 5')
+        add('B1', self.n_pivots >= 2, f'中枢数 {self.n_pivots} >= 2')
+        add('B1', self.trend == 'down_trend', f'当前走势={self.trend}, B1要求下跌趋势')
+        add('B1', bool(last and last.direction == 'down'), f'最后一笔方向={last.direction if last else ""}, B1要求向下')
+        add('B1', float(self.dif.iloc[-1]) < 0 if len(self.dif) else False, f'DIF={float(self.dif.iloc[-1]):.4f}, B1要求DIF<0')
+        abc_down = self._validate_abc('down')
+        add('B1', abc_down is not None, 'A/B/C三段背驰结构成立')
+        if abc_down is not None:
+            c_ok, c_low = self._check_c_new_extreme(abc_down['c_start_idx'], 'down')
+            add('B1', c_ok, f'C段创新低{"" if c_low is None else f"({c_low:.3f})"}')
+        add('B2', self.n_bis >= 4, f'笔数 {self.n_bis} >= 4')
+        add('B2', bool(last and last.direction == 'down'), f'最后一笔方向={last.direction if last else ""}, B2要求回踩向下')
+        prev_downs = [b for b in self.bis[:-1] if b.direction == 'down'] if last else []
+        add('B2', bool(prev_downs), '存在同一轮前一个下跌低点作为一买锚')
+        if last and prev_downs:
+            prev = prev_downs[-1]
+            add('B2', last.low >= prev.low and last.end.price > prev.end.price,
+                f'回踩不创新低: 本次低{last.end.price:.3f} > 一买/前低{prev.end.price:.3f}')
+            add('B2', cur_price >= last.end.price * (1 - self.PIVOT_TOLERANCE),
+                f'现价{cur_price:.3f}未跌破B2回踩锚{last.end.price:.3f}; 跌破则二买失效')
+        add('B3', self.n_pivots >= 1, f'中枢数 {self.n_pivots} >= 1')
+        add('B3', bool(last and last.direction == 'up'), f'最后一笔方向={last.direction if last else ""}, B3要求向上确认')
+        if self.pivots:
+            p = self.pivots[-1]
+            pair = self._last_exit_pullback_segments(p, 'up', 'down')
+            add('B3', pair is not None, '存在已确认线段级别的向上离枢 + 向下回试')
+            if pair is not None:
+                exit_seg, pull_seg = pair
+                add('B3', exit_seg.low <= p.zg * (1 + self.PIVOT_TOLERANCE) and exit_seg.high > p.zg,
+                    f'离枢线段突破ZG: {exit_seg.low:.3f}~{exit_seg.high:.3f}, ZG={p.zg:.3f}')
+                add('B3', pull_seg.low >= p.zg * (1 - self.PIVOT_TOLERANCE),
+                    f'回试低点{pull_seg.low:.3f}不破ZG={p.zg:.3f}')
+                add('B3', cur_price > p.zg, f'现价{cur_price:.3f}站上ZG={p.zg:.3f}')
+        add('S1', self.n_bis >= 5, f'笔数 {self.n_bis} >= 5')
+        add('S1', self.n_pivots >= 2, f'中枢数 {self.n_pivots} >= 2')
+        add('S1', self.trend == 'up_trend', f'当前走势={self.trend}, S1要求上涨趋势')
+        add('S1', bool(last and last.direction == 'up'), f'最后一笔方向={last.direction if last else ""}, S1要求向上')
+        abc_up = self._validate_abc('up')
+        add('S1', abc_up is not None, 'A/B/C三段顶背驰结构成立')
+        if abc_up is not None:
+            c_ok, c_high = self._check_c_new_extreme(abc_up['c_start_idx'], 'up')
+            add('S1', c_ok, f'C段创新高{"" if c_high is None else f"({c_high:.3f})"}')
+        add('S2', self.n_bis >= 4, f'笔数 {self.n_bis} >= 4')
+        add('S2', bool(last and last.direction == 'up'), f'最后一笔方向={last.direction if last else ""}, S2要求反弹向上')
+        prev_ups = [b for b in self.bis[:-1] if b.direction == 'up'] if last else []
+        add('S2', bool(prev_ups), '存在同一轮前一个上涨高点作为一卖锚')
+        if last and prev_ups:
+            prev = prev_ups[-1]
+            add('S2', last.high < prev.high and last.end.price < prev.end.price,
+                f'反弹不创新高: 本次高{last.end.price:.3f} < 一卖/前高{prev.end.price:.3f}')
+            add('S2', cur_price <= last.end.price * (1 + self.PIVOT_TOLERANCE),
+                f'现价{cur_price:.3f}未重新升破S2反弹锚{last.end.price:.3f}; 升破则二卖失效')
+        add('S3', self.n_pivots >= 1, f'中枢数 {self.n_pivots} >= 1')
+        add('S3', bool(last and last.direction == 'down'), f'最后一笔方向={last.direction if last else ""}, S3要求向下确认')
+        if self.pivots:
+            p = self.pivots[-1]
+            pair = self._last_exit_pullback_segments(p, 'down', 'up')
+            add('S3', pair is not None, '存在已确认线段级别的向下离枢 + 向上回抽')
+            if pair is not None:
+                exit_seg, pull_seg = pair
+                add('S3', exit_seg.high >= p.zd * (1 - self.PIVOT_TOLERANCE) and exit_seg.low < p.zd,
+                    f'离枢线段跌破ZD: {exit_seg.low:.3f}~{exit_seg.high:.3f}, ZD={p.zd:.3f}')
+                add('S3', pull_seg.high <= p.zd * (1 + self.PIVOT_TOLERANCE),
+                    f'回抽高点{pull_seg.high:.3f}不破ZD={p.zd:.3f}')
+                add('S3', cur_price < p.zd, f'现价{cur_price:.3f}跌破ZD={p.zd:.3f}')
+        return out
+
+
+class SameLevelDecomposition:
+    def __init__(self, analyzer: 'ChanAnalyzer'):
+        self.an = analyzer
+        self.segs = analyzer.segs
+
+    def current_phase(self) -> dict:
+        if len(self.segs) < 2:
+            return {'seg_dir': '', 'stage': 'unknown', 'action': 'WATCH',
+                    'reason': '线段不足, 无法做同级别分解'}
+        last = self.segs[-1]
+        prev = self.segs[-2]
+        seg_dir = last.direction
+        if seg_dir == 'up':
+            stage = 'up_run'
+            prev_up = None
+            for s in reversed(self.segs[:-1]):
+                if s.direction == 'up':
+                    prev_up = s; break
+            if prev_up is None:
+                return {'seg_dir': seg_dir, 'stage': stage, 'action': 'HOLD',
+                        'reason': '向上段运作中(无前向上段可比), 持有'}
+            if last.high <= prev_up.high:
+                return {'seg_dir': seg_dir, 'stage': stage, 'action': 'SELL',
+                        'reason': f'向上段不创新高({last.high:.3f}≤前高{prev_up.high:.3f}) → 先卖(第38课)'}
+            dg = self.an.assess_divergence(prev_up.start.date, prev_up.end.date,
+                                           last.start.date, last.end.date, 'up')
+            if dg.grade != 'NONE':
+                return {'seg_dir': seg_dir, 'stage': stage, 'action': 'SELL',
+                        'reason': f'向上段创新高但盘整背驰({dg.grade}) → 卖(第38课)'}
+            return {'seg_dir': seg_dir, 'stage': stage, 'action': 'HOLD',
+                    'reason': '向上段创新高且不背驰 → 持有(第38课)'}
+        else:
+            stage = 'down_run'
+            prev_down = None
+            for s in reversed(self.segs[:-1]):
+                if s.direction == 'down':
+                    prev_down = s; break
+            if prev_down is None:
+                return {'seg_dir': seg_dir, 'stage': stage, 'action': 'WATCH',
+                        'reason': '向下段运作中(无前向下段可比), 观望等买点'}
+            if last.low >= prev_down.low:
+                return {'seg_dir': seg_dir, 'stage': stage, 'action': 'BUY',
+                        'reason': f'向下段不创新低({last.low:.3f}≥前低{prev_down.low:.3f}) → 买入(第38课)'}
+            dg = self.an.assess_divergence(prev_down.start.date, prev_down.end.date,
+                                           last.start.date, last.end.date, 'down')
+            if dg.grade != 'NONE':
+                return {'seg_dir': seg_dir, 'stage': stage, 'action': 'BUY',
+                        'reason': f'向下段创新低但盘整背驰({dg.grade}) → 买入(第38课)'}
+            return {'seg_dir': seg_dir, 'stage': stage, 'action': 'WATCH',
+                    'reason': '向下段创新低且不背驰 → 观望等下跌背驰(第38课)'}
+
+
+class BottomTracker:
+    def __init__(self):
+        self.state = 'none'
+
+    def update(self, analyzer: 'ChanAnalyzer') -> str:
+        snap = analyzer.bottom_construction_state()
+        if self.state in ('none', 'failed', 'completed'):
+            if snap == 'constructing':
+                self.state = 'constructing'
+            elif snap == 'completed':
+                self.state = 'completed'
+            elif snap == 'failed':
+                self.state = 'failed'
+            else:
+                self.state = 'none'
+        elif self.state == 'constructing':
+            if snap == 'completed':
+                self.state = 'completed'
+            elif snap == 'failed':
+                self.state = 'failed'
+        return self.state

chan_multilevel.py

@@ -1,884 +1,123 @@
-"""缠论多级别联立分析
-
-【本版改动 · 卖点区间套修复 (第24/44课)】
-
-旧逻辑的两个病根(对应回测中"卖在低位"与"提前卖飞"):
-  ① 卖在低位: 严格模式要求"30分钟出现三类卖点S3"才印证日线卖点。但S3是
-     次级别已经跌破其中枢、反抽不回的【转折确认点】—— 它出现时价格早已
-     离开顶部一大截。拿S3当卖出闸门, 等于规定"必须先跌下来才准卖", 结构上
-     注定卖不到一卖的高位, 最后落在二卖/三卖的低位。
-  ② 提前卖飞: 宽松模式下"30m最后一笔向下"即印证。第24课明示: 小级别背驰
-     (更别说仅仅一笔向下)未必引发大级别转折。任何一次30m级别的正常回调都
-     可能把日线WEAK级别的卖点"确认"掉 → 还没到顶就出局。
-     而且旧代码对次级别卖点【不做时间嵌套检查】: 30m在日线C段开始之前的
-     旧背驰也会被当作印证 —— "区间套"三个字里的"区间"丢了。
-
-新逻辑 (CFG['sell_nested_interval']=True):
-  第44课区间套的本义: 大级别进入背驰段后, 在该背驰段【时间区间内】找次级别
-  的背驰段, 再在其中找次次级别的背驰段, 逐级收敛到精确转折点。
-  对日线S1/S2, 次级别印证按优先级:
-    ① 嵌套顶背驰: 30m出现S1, 且其C段顶部落在日线背驰段(最后中枢之后→当下)
-       的时间窗口内、顶部价位贴近日线C段高点 → 精确卖点, 卖在高位区。
-    ② 次级别转折确认: 30m出现S3, 或30m末笔已跌破其最近中枢下沿ZD(第92课
-       向下变盘) → 转折已确认, 偏晚但必须卖。
-    ③ 两者皆无 → 次级别动能未竭, 第24课: 顶未到 → 【不卖】(防卖飞),
-       返回 action=HOLD + sell_armed=True 进入"区间套布防"状态:
-       回测端持仓转入布防, 之后任一条件触发(嵌套背驰出现/破30m中枢ZD/
-       较布防峰值回落超阈值)即离场 —— 既不提前卖飞, 也不一路坐滑梯到三卖。
-  S3(日线三卖)不走嵌套背驰: 三卖本身就是转折确认型卖点, 维持原确认逻辑。
+"""
+chan_enhance.py —— 缠论系统增强(查漏补缺) · 纯函数版(非Hook)
 """
 from __future__ import annotations
-from dataclasses import dataclass, field
-from typing import Optional
-import numpy as np
-import pandas as pd
-
-# from chan_engine import ChanAnalyzer, Signal
-
-
-# ── 卖点区间套参数 (第24/44课) ──
-NESTED_TOP_PRICE_TOL   = 0.03   # 嵌套顶背驰的顶部须贴近父级C段高点(3%以内), 否则属上一波动能
-NESTED_WINDOW_PAD_DAYS = 3      # 时间嵌套窗口的左侧容差(日)
-SELL_ARM_PEAK_DROP     = 0.04   # 布防后较峰值价回落≥4% → 顶部确认离场(回测端使用)
-SELL_ARM_DISARM_BREAK  = 0.03   # 布防后强势创新高超3%且卖点消失 → 背驰被消化, 撤防(第26课)
-
-
-def _default_make_analyzer(level, df):
-    return ChanAnalyzer(df.reset_index(drop=True))
-
-_MAKE_ANALYZER = _default_make_analyzer
-
-def set_analyzer_factory(fn):
-    global _MAKE_ANALYZER
-    _MAKE_ANALYZER = fn or _default_make_analyzer
-
-
-def resample_weekly(df_daily: pd.DataFrame) -> pd.DataFrame:
-    if df_daily.empty:
-        return df_daily.copy()
-    d = df_daily.copy()
-    d['date'] = pd.to_datetime(d['date'])
-    d = d.sort_values('date').reset_index(drop=True)
-    wk_period = d['date'].dt.to_period('W-FRI')
-    agg = {'open': 'first', 'high': 'max', 'low': 'min', 'close': 'last'}
-    if 'volume' in d.columns: agg['volume'] = 'sum'
-    if 'amount' in d.columns: agg['amount'] = 'sum'
-    g = d.groupby(wk_period, sort=True)
-    wk = g.agg(agg)
-    last_real = g['date'].max()
-    wk = wk.dropna(subset=['open', 'high', 'low', 'close']).reset_index(drop=True)
-    wk['date'] = list(last_real.values)
-    return wk
-
-
-def resample_monthly(df_daily: pd.DataFrame) -> pd.DataFrame:
-    if df_daily.empty:
-        return df_daily.copy()
-    d = df_daily.copy()
-    d['date'] = pd.to_datetime(d['date'])
-    d = d.sort_values('date').reset_index(drop=True)
-    mp = d['date'].dt.to_period('M')
-    agg = {'open': 'first', 'high': 'max', 'low': 'min', 'close': 'last'}
-    if 'volume' in d.columns: agg['volume'] = 'sum'
-    if 'amount' in d.columns: agg['amount'] = 'sum'
-    g = d.groupby(mp, sort=True)
-    mo = g.agg(agg)
-    last_real = g['date'].max()
-    mo = mo.dropna(subset=['open', 'high', 'low', 'close']).reset_index(drop=True)
-    mo['date'] = list(last_real.values)
-    return mo
-
-
-@dataclass
-class LevelView:
-    level: str
-    trend: str
-    n_pivots: int
-    n_bis: int
-    last_bi_dir: str
-    signal: Optional[Signal]
-    zg: Optional[float]
-    zd: Optional[float]
-    dif: Optional[float]
-    last_date: Optional[pd.Timestamp]
-    diagnostics: dict = field(default_factory=dict)
-
-
-@dataclass
-class MultiLevelSignal:
-    code: str
-    analysis_date: pd.Timestamp
-    weekly: LevelView
-    daily: LevelView
-    m30: Optional[LevelView]
-    action: str
-    confidence: str
-    final_kind: str
-    cur_price: float
-    chain: list = field(default_factory=list)
-    blocked_reason: str = ''
-    note: str = ''
-    confidence_reasons: list = field(default_factory=list)
-    diagnostics: dict = field(default_factory=dict)
-    monthly: Optional[LevelView] = None
-    # ── 卖点区间套布防 (第44课) ──
-    sell_armed: bool = False              # 日线S1/S2背驰已现、次级别动能未竭 → 持仓布防
-    arm_zd: Optional[float] = None        # 布防线①: 30m最近中枢下沿ZD(跌破即次级别转折确认)
-    arm_high: Optional[float] = None      # 父级背驰段C段高点(用于"新高消化背驰"撤防判定)
-
-    def explain(self) -> str:
-        lines = [f'  [{self.code}] {self.analysis_date.strftime("%Y-%m-%d")}  ¥{self.cur_price:.3f}']
-        lines.append(f'  最终: {self.action}  置信度={self.confidence}'
-                     + (f'  信号={self.final_kind}' if self.final_kind else ''))
-        lines.append('  ── 逐级裁决链 ──')
-        for lvl, concl, src in self.chain:
-            lines.append(f'    [{lvl:<7s}] {concl}')
-            if src:
-                lines.append(f'              └ 依据: {src}')
-        if self.blocked_reason:
-            lines.append(f'  ⚠ 拦截: {self.blocked_reason}')
-        if self.note:
-            lines.append(f'  说明: {self.note}')
-        if self.confidence_reasons:
-            lines.append('  置信度降档明细:')
-            for i, r in enumerate(self.confidence_reasons, 1):
-                lines.append(f'    {i}. {r}')
-        if self.diagnostics:
-            lines.append('  日线买卖点逐项诊断:')
-            for k in ('B1', 'B2', 'B3', 'S1', 'S2', 'S3'):
-                rows = self.diagnostics.get(k) or []
-                if not rows:
-                    continue
-                ok = all(str(x).startswith('✓') for x in rows)
-                lines.append(f'    {k} {"满足" if ok else "不满足"}')
-                for row in rows:
-                    lines.append(f'      {row}')
-        else:
-            lines.append('  日线买卖点逐项诊断: 未生成')
-        return '\n'.join(lines)
-
-
-class MultiLevelChan:
-    CFG = {
-        'use_monthly_gate': True,
-        'monthly_ma_filter': False,
-        'require_sublevel_sell_confirm': False,
-        'mode': 'short',
-        'zhongyin_block_buy': False,
-        'expose_m30_nosignal': False,
-        'require_60m_buy_confirm': False,  # L44区间套: 60m为日线直接次级别, 买点须经其印证
-        # L50 MACD级别选择: 看MACD要选"黄白线和柱子清晰"的级别。30m判据模糊而60m
-        # 清晰且60m已印证时, 采信60m的印证结论(避免被模糊级别的噪声误杀好买点)。
-        'l50_macd_level_select': False,
-        # ── 卖点区间套(第24/44课): 嵌套顶背驰精确定位 + 布防防卖飞 ──
-        #   True  = S1/S2用"时间嵌套的次级别顶背驰"定位高点; 未嵌套确认时不卖而布防
-        #   False = 维持旧逻辑(30m要S3 / 宽松末笔向下即卖)
-        'sell_nested_interval': True,
-        # L24: 周线上涨+日线盘整背驰的S1/S2 → 不全清, 转布防短差(撤防可骑回趋势)
-        'l24_weekly_uptrend_arm': False,  # 实测净亏(好卖点也被转布防), 默认关
-    }
-
-    # ── 速度优化: 次级别K线只取最近N根做缠论分解 ──
-    # 第17/44课: 次级别(60m/30m/15m/5m/1m)的职责是"印证当下转折", 其买卖点
-    # 只取决于最近的笔/线段/中枢结构; 几年前的分钟级历史对当下印证毫无贡献,
-    # 却让每个回测日都对上万根分钟K线重做合并/分型/笔/段, 是最大的耗时点。
-    # 截断只作用于次级别印证, 日/周/月线仍用全history(年线、月线大方向不受影响)。
-    SUB_TAIL = {'15m': 4000, '5m': 4800, '1m': 2000}
-
-    def __init__(self, df_daily, df_weekly=None, df_monthly=None, df_30m=None, df_60m=None,
-                 df_15m=None, df_5m=None, df_1m=None, code='', strict=True):
-        self.code = code
-        self.strict = strict
-        self.df_daily = df_daily.reset_index(drop=True) if not df_daily.empty else df_daily
-        self.df_30m = df_30m.reset_index(drop=True) if df_30m is not None and not df_30m.empty else None
-        self.df_60m = df_60m.reset_index(drop=True) if df_60m is not None and not df_60m.empty else None
-        self.df_15m = df_15m.reset_index(drop=True) if df_15m is not None and not df_15m.empty else None
-        self.df_5m = df_5m.reset_index(drop=True) if df_5m is not None and not df_5m.empty else None
-        self.df_1m = df_1m.reset_index(drop=True) if df_1m is not None and not df_1m.empty else None
-        self.df_weekly = df_weekly.reset_index(drop=True) if df_weekly is not None and not df_weekly.empty else None
-        self.df_monthly = df_monthly.reset_index(drop=True) if df_monthly is not None and not df_monthly.empty else None
-
-    @staticmethod
-    def _make_view(level, df, an=None, diagnose=True):
-        if an is None:
-            if df is None or len(df) < 30:
-                return None
-            try:
-                an = _MAKE_ANALYZER(level, df)
-            except Exception:
-                return None
-            if an is None:
-                return None
-        sig = an.get_signal()
-        zg = an.pivots[-1].zg if an.n_pivots > 0 else None
-        zd = an.pivots[-1].zd if an.n_pivots > 0 else None
-        return LevelView(level=level, trend=an.trend, n_pivots=an.n_pivots, n_bis=an.n_bis,
-                         last_bi_dir=an.bis[-1].direction if an.n_bis else '', signal=sig,
-                         zg=zg, zd=zd, dif=float(an.dif.iloc[-1]) if len(an.dif) else None,
-                         last_date=pd.Timestamp(df['date'].iloc[-1]),
-                         diagnostics=(an.diagnose() if diagnose else {}))
-
-    # ──────────────────────────────────────────────────────────────────
-    #  卖点区间套核心: 时间嵌套的次级别顶背驰 (第44课)
-    # ──────────────────────────────────────────────────────────────────
-    @staticmethod
-    def _parent_sell_window(parent_sig):
-        """父级(日线)背驰段的时间窗口与顶部价。
-        S1: 背驰段C段 = 最后中枢结束 → 当下; 顶 = C段高点 c_high。
-        S2: 窗口 = 一卖出现 → 当下(反抽段); 顶 = 一卖高点 prev_high。"""
-        ex = (parent_sig.extras or {}) if parent_sig is not None else {}
-        if parent_sig is None:
-            return '', '', None
-        if parent_sig.kind == 'S1':
-            w_start = ex.get('pivot_end_date') or ex.get('a_high_date') or ''
-            top = ex.get('c_high')
-        else:  # S2
-            w_start = ex.get('s1_date') or ex.get('prev_high_date') or ''
-            top = ex.get('prev_high')
-        w_end = ex.get('price_date') or ''
-        return w_start, w_end, top
-
-    def _nested_sell_check(self, sub_an, parent_sig, lvl_name, parent_kind):
-        """第44课区间套(卖点版): 在父级背驰段时间窗口内找次级别的嵌套顶背驰。
-        优先级: ①嵌套S1(精确高点, 卖在高位)
-               ②S3 / 末笔破次级别中枢ZD(转折已确认, 偏晚但必卖)
-               ③都没有 → 第24课: 次级别动能未竭, 顶未到 → 不卖(防卖飞), 转布防。
-        返回 (confirmed: bool, note: str)。"""
-        w_start, w_end, parent_top = self._parent_sell_window(parent_sig)
-
-        def in_window(dstr):
-            if not w_start or not dstr:
-                return True   # 信息不足时不因窗口否决(保守放行, 由价位贴近度把关)
-            try:
-                d = pd.Timestamp(dstr)
-                lo = pd.Timestamp(w_start) - pd.Timedelta(days=NESTED_WINDOW_PAD_DAYS)
-                hi = (pd.Timestamp(w_end) if w_end else d) + pd.Timedelta(days=1)
-                return lo <= d <= hi
-            except Exception:
-                return True
-
-        rejected = ''
-        # ① 嵌套顶背驰 S1 —— 区间套的本体: 背驰段中套背驰段
-        s1 = sub_an.detect_s1()
-        if s1 is not None:
-            ex2 = s1.extras or {}
-            td = ex2.get('c_high_date', '')
-            tp = ex2.get('c_high')
-            near_top = (parent_top is None or tp is None
-                        or tp >= parent_top * (1 - NESTED_TOP_PRICE_TOL))
-            if in_window(td) and near_top:
-                ptxt = f'(顶¥{tp:.3f}@{td})' if tp else ''
-                return True, (f'{lvl_name}嵌套顶背驰S1{ptxt}落在日线{parent_kind}背驰段窗口内 '
-                              f'—— 第44课区间套: 背驰段中套背驰段, 精确定位顶部, 卖在高位区')
-            rejected = (f'{lvl_name}虽有S1但【不嵌套】(顶@{td or "?"}不在父级背驰段'
-                        f'[{w_start}~{w_end}]窗口内, 或低于父级顶{NESTED_TOP_PRICE_TOL:.0%}以上)'
-                        f' → 属上一波的动能衰竭, 不作本次印证(防卖飞); ')
-        # ①b 父级为S2时, 次级别S2(一卖后反抽确认)也可嵌套印证
-        if parent_kind == 'S2':
-            s2 = sub_an.detect_s2()
-            if s2 is not None:
-                ex2 = s2.extras or {}
-                td = ex2.get('cur_high_date', '')
-                if in_window(td):
-                    return True, (f'{lvl_name}嵌套二卖S2(反抽顶@{td})落在日线S2窗口内 '
-                                  f'—— 第14课: 大级别二卖由次级别相应卖点定位')
-        # ② 转折已确认型: S3 / 末笔已破次级别中枢下沿
-        s3 = sub_an.detect_s3()
-        if s3 is not None:
-            return True, (f'{lvl_name}出现三类卖点S3 —— 第44课: 最后一个次级别中枢出现三卖, '
-                          f'转折已确认(偏晚, 但必须卖)')
-        try:
-            osc = sub_an.zhongshu_oscillation_monitor()
-            if osc.get('alert') and osc.get('direction') == 'down':
-                return True, (f'{lvl_name}末笔已离开其最近中枢下沿(第92课向下变盘) '
-                              f'—— 次级别转折确认, 高位区兑现')
-        except Exception:
-            pass
-        # ③ 次级别上冲动能已竭的当下确认: 末笔向下 + MACD柱已翻负(黄白线收敛下行)。
-        #    第24/44课: 区间套要的是"次级别走势的当下转折"; 末笔转下且红柱消失,
-        #    说明次级别这一冲已经结束 —— 此时日线背驰卖点立即执行, 不再等更深的破位
-        #    (这正是旧版"等30m三卖"卖在低位的病根)。只有次级别仍在上冲(末笔向上/
-        #    红柱未消)时才转入布防, 防的才是真正的"卖飞"。
-        try:
-            last_bi = sub_an.bis[-1] if sub_an.n_bis else None
-            bar_now = float(sub_an.macd_bar.iloc[-1]) if len(sub_an.macd_bar) else 0.0
-            if last_bi is not None and last_bi.direction == 'down' and bar_now < 0:
-                return True, (f'{lvl_name}末笔向下且MACD柱已翻负 —— 第24课: 次级别上冲动能已竭, '
-                              f'当下转折确认, 日线背驰卖点立即执行(不等{lvl_name}跌出三卖)')
-        except Exception:
-            pass
-        return False, (rejected + f'{lvl_name}动能未竭(末笔仍向上/MACD红柱未消): 无嵌套顶背驰/无S3 '
-                       f'→ 第24课: 次级别未转折, 大级别顶未到 → 暂不卖(防卖飞), 转入区间套布防')
-
-    def _confirm_30m_for_buy(self, m30, parent_kind=''):
-        if m30 is None or m30.n_bis < 5:
-            return False, '30分钟笔数不足(<5), 无法做次级别精确印证'
-        if parent_kind == 'B2':
-            if m30.detect_b1() is not None:
-                return True, '30分钟出现一类买点B1 —— 第14课: 大级别第二类买点由次一级别相应走势的一类买点构成'
-            if m30.detect_b2() is not None:
-                return True, '30分钟出现二类买点B2 —— 次级别一买后的回试确认, 属延后确认, 精度低于B1'
-            return False, '30分钟未出现B1/B2 —— 大级别二买缺少次级别买点确认'
-        for fn, name in ((m30.detect_b1,'B1'),(m30.detect_b3,'B3'),(m30.detect_b2,'B2')):
-            if fn() is not None:
-                return True, f'30分钟出现标准买点{name} —— 第44课: 次级别走势确认转折, 日线买点成立'
-        if self.strict:
-            return False, '30分钟未出现任何标准买点(B1/B2/B3) —— 严格模式: 第44课次级别印证未满足, 日线买点暂不成立'
-        if m30.bis[-1].direction == 'up':
-            return True, '30分钟最后一笔向上, 次级别已启动(宽松确认)'
-        return False, '30分钟最后一笔仍向下且无买点, 次级别未确认转折'
-
-    def _confirm_30m_for_sell(self, m30, parent_kind='', parent_sig=None):
-        if m30 is None or m30.n_bis < 5:
-            return False, '30分钟笔数不足(<5), 无法做次级别精确印证'
-        # ── 新: 卖点区间套(第24/44课) —— S1/S2用嵌套顶背驰定位高点 ──
-        if (self.CFG.get('sell_nested_interval') and parent_sig is not None
-                and parent_kind in ('S1', 'S2')):
-            return self._nested_sell_check(m30, parent_sig, '30分钟', parent_kind)
-        # ── 旧逻辑(S3父级 / 开关关闭时) ──
-        if parent_kind == 'S2':
-            if m30.detect_s1() is not None:
-                return True, '30分钟出现一类卖点S1 —— 大级别第二类卖点由次一级别相应走势的一类卖点精确定位'
-            if m30.detect_s2() is not None:
-                return True, '30分钟出现二类卖点S2 —— 次级别一卖后的反抽确认, 属延后确认, 精度低于S1'
-            return False, '30分钟未出现S1/S2 —— 大级别二卖缺少次级别卖点确认'
-        if m30.detect_s3() is not None:
-            return True, '30分钟出现三类卖点S3 —— 严格满足第44课"小背驰-大转折定理"的必要条件(最后一个次级别中枢出现三卖)'
-        if self.strict:
-            return False, '30分钟未出现三类卖点S3 —— 严格模式: 第44课明确要求"最后一个次级别中枢出现三卖", 必要条件未满足, 日线卖点不构成大级别转折'
-        if m30.detect_s1() is not None:
-            return True, '30分钟出现一类卖点(顶背驰), 次级别转折确认(宽松)'
-        if m30.bis[-1].direction == 'down':
-            return True, '30分钟最后一笔向下, 次级别已转弱(宽松确认)'
-        return False, '30分钟未出现卖点且最后一笔仍向上, 次级别未确认转折'
-
-    def _confirm_finer(self, an, is_buy, lvl_name, parent_name, parent_kind='', parent_sig=None):
-        if an is None or an.n_bis < 5:
-            return False, f'{lvl_name}笔数不足(<5), 无法做次级别精确印证'
-        if is_buy:
-            if parent_kind == 'B2':
-                if an.detect_b1() is not None:
-                    return True, f'{lvl_name}出现B1 —— 第14课: {parent_name}二买由次一级别一买构成'
-                if an.detect_b2() is not None:
-                    return True, f'{lvl_name}出现B2 —— 次级别一买后的回试确认, 属延后确认, 精度低于B1'
-                return False, f'{lvl_name}未出现B1/B2 —— {parent_name}二买缺少次级别买点确认'
-            for fn, name in ((an.detect_b1,'B1'),(an.detect_b3,'B3'),(an.detect_b2,'B2')):
-                if fn() is not None:
-                    return True, f'{lvl_name}出现标准买点{name} —— 第44课逐级处理: {lvl_name}走势确认{parent_name}的转折'
-            if self.strict:
-                return False, f'{lvl_name}未出现标准买点(B1/B2/B3) —— 严格模式: 末级印证未满足, 信号降级'
-            if an.bis[-1].direction == 'up':
-                return True, f'{lvl_name}最后一笔向上, 次级别已启动(宽松确认)'
-            return False, f'{lvl_name}最后一笔仍向下且无买点, 末级未确认, 信号降级'
-        else:
-            # ── 新: 卖点区间套向更细级别逐级传递(同一父级背驰段窗口) ──
-            if (self.CFG.get('sell_nested_interval') and parent_sig is not None
-                    and parent_kind in ('S1', 'S2')):
-                ok, note = self._nested_sell_check(an, parent_sig, lvl_name, parent_kind)
-                if ok:
-                    return True, note + f' —— 第44课逐级处理: {lvl_name}确认{parent_name}的转折'
-                return False, note
-            if parent_kind == 'S2':
-                if an.detect_s1() is not None:
-                    return True, f'{lvl_name}出现S1 —— {parent_name}二卖由次一级别一卖精确定位'
-                if an.detect_s2() is not None:
-                    return True, f'{lvl_name}出现S2 —— 次级别一卖后的反抽确认, 属延后确认, 精度低于S1'
-                return False, f'{lvl_name}未出现S1/S2 —— {parent_name}二卖缺少次级别卖点确认'
-            if an.detect_s3() is not None:
-                return True, f'{lvl_name}出现三类卖点S3 —— 第44课逐级处理: {lvl_name}走势确认{parent_name}的转折'
-            if self.strict:
-                return False, f'{lvl_name}未出现三类卖点S3 —— 严格模式: 末级印证未满足, 信号降级'
-            if an.detect_s1() is not None:
-                return True, f'{lvl_name}出现一类卖点(顶背驰), 次级别转折确认(宽松)'
-            if an.bis[-1].direction == 'down':
-                return True, f'{lvl_name}最后一笔向下, 次级别已转弱(宽松确认)'
-            return False, f'{lvl_name}未出现卖点且最后一笔仍向上, 末级未确认, 信号降级'
-
-    def _confirm_5m(self, m5, is_buy, parent_kind='', parent_sig=None):
-        return self._confirm_finer(m5, is_buy, '5分钟', '30分钟', parent_kind, parent_sig)
-
-    def _confirm_1m(self, m1, is_buy, parent_kind='', parent_sig=None):
-        return self._confirm_finer(m1, is_buy, '1分钟', '5分钟', parent_kind, parent_sig)
-
-    def analyze(self, analysis_date=None, positions=None):
-        if self.df_daily.empty or len(self.df_daily) < 30:
-            return None
-        df_d = self.df_daily
-        if analysis_date is not None:
-            analysis_date = pd.Timestamp(analysis_date)
-            df_d = df_d[df_d['date'] <= analysis_date].reset_index(drop=True)
-        if len(df_d) < 30:
-            return None
-        last_date = pd.Timestamp(df_d['date'].iloc[-1])
-        cur_price = float(df_d['close'].iloc[-1])
-
-        if self.df_weekly is not None:
-            df_w = self.df_weekly[self.df_weekly['date'] <= last_date].reset_index(drop=True)
-        else:
-            df_w = resample_weekly(df_d)
-        if self.df_monthly is not None:
-            df_mo = self.df_monthly[self.df_monthly['date'] <= last_date].reset_index(drop=True)
-        else:
-            df_mo = resample_monthly(df_d)
-        _tail = self.SUB_TAIL or {}
-        def _cut_sub(df, lvl):
-            if df is None:
-                return None
-            sub = df[df['date'] <= last_date + pd.Timedelta(days=1)]
-            n = _tail.get(lvl, 0)
-            if n and len(sub) > n:
-                sub = sub.tail(n)
-            return sub.reset_index(drop=True)
-        df_6  = _cut_sub(self.df_60m, '60m')
-        df_m  = _cut_sub(self.df_30m, '30m')
-        df_15 = _cut_sub(self.df_15m, '15m')
-        df_5  = _cut_sub(self.df_5m, '5m')
-        df_1  = _cut_sub(self.df_1m, '1m')
-
-        wv = self._make_view('weekly', df_w, diagnose=False)
-        mov = self._make_view('monthly', df_mo, diagnose=False) if self.CFG.get('use_monthly_gate') else None
-        daily_an = None
-        try:
-            if len(df_d) >= 30:
-                daily_an = _MAKE_ANALYZER('daily', df_d)
-        except Exception:
-            daily_an = None
-        dv = self._make_view('daily', df_d, an=daily_an, diagnose=False) if daily_an is not None \
-            else self._make_view('daily', df_d, diagnose=False)
-
-        m60_an = None
-        m60_built = False
-        def _get_m60():
-            nonlocal m60_an, m60_built
-            if not m60_built:
-                m60_built = True
-                if df_6 is not None and len(df_6) >= 30:
-                    try: m60_an = _MAKE_ANALYZER('60m', df_6)
-                    except Exception: m60_an = None
-            return m60_an
-
-        m30_an = None
-        m30_built = False
-        def _get_m30():
-            nonlocal m30_an, m30_built
-            if not m30_built:
-                m30_built = True
-                if df_m is not None and len(df_m) >= 30:
-                    try: m30_an = _MAKE_ANALYZER('30m', df_m)
-                    except Exception: m30_an = None
-            return m30_an
-
-        def _mv():
-            an = _get_m30()
-            if an is None:
-                return None
-            return self._make_view('30m', df_m, an=an, diagnose=False)
-
-        diagnostics = daily_an.diagnose() if daily_an is not None else {}
-
-        chain = []
-        yearline_dir = 'unknown'; yearline_val = None
-        if len(df_d) >= 60:
-            _n = min(250, len(df_d))
-            yearline_val = float(df_d['close'].tail(_n).mean()) if _n >= 20 else None
-            _ma = df_d['close'].rolling(min(250, len(df_d)), min_periods=20).mean()
-            if len(_ma) and not pd.isna(_ma.iloc[-1]):
-                yearline_val = float(_ma.iloc[-1])
-        if yearline_val is not None:
-            above = cur_price >= yearline_val
-            yearline_dir = 'above' if above else 'below'
-            ytxt = (f'现价¥{cur_price:.3f} {"≥" if above else "<"} 年线MA250 ¥{yearline_val:.3f} '
-                    f'→ {"站上年线, 长线可做多" if above else "年线下方, 第106课不做多(只看反弹/卖点)"}')
-            chain.append(('年线', ytxt,
-                          '第7/106课: 年线(MA250)是长线生命线; 站上才考虑做多, 跌破年线长线转空'))
-        else:
-            chain.append(('年线', '日线历史不足, 年线MA250 暂不可用', '第7/106课'))
-
-        monthly_dir = 'unknown'
-        if mov is not None:
-            monthly_dir = mov.trend
-            chain.append(('monthly', f'{monthly_dir}  (月线定大方向: L69 月线看最实质大方向)',
-                          '第69/108课: 月线分型/笔/线段确定中期大方向; 底部=第一类买点到中枢首次走出三买前'))
-            if self.CFG.get('monthly_ma_filter') and len(df_mo) >= 5:
-                ma5_m = float(df_mo['close'].tail(5).mean())
-                if cur_price < ma5_m and monthly_dir != 'down_trend':
-                    monthly_dir = 'down_trend'
-                    chain.append(('monthly', f'价({cur_price:.2f})在5月线({ma5_m:.2f})下 → 大方向按偏空处理',
-                                  '第106课: 5月线是长线的关键, 牛市第一轮调整不跌破5月线'))
-
-        if wv is None:
-            chain.append(('weekly', '周线数据不足(<30根), 方向未知', ''))
-            weekly_dir = 'unknown'
-        else:
-            weekly_dir = wv.trend
-            dir_txt = {'up_trend':'上涨趋势 → 日线只接受【买点】','down_trend':'下跌趋势 → 日线只接受【卖点】/观望',
-                       'consolidation':'盘整 → 日线买卖点都看,但降级'}.get(weekly_dir, weekly_dir)
-            chain.append(('weekly', f'{weekly_dir}  {dir_txt}',
-                          '第43课: 大级别走势类型限定小级别的操作方向; 不允许"上涨+上涨""下跌+下跌"'))
-
-        if dv is None:
-            return None
-        daily_sig = dv.signal
-        if daily_sig is None:
-            chain.append(('daily', f'{dv.trend}, 无买卖点信号', ''))
-        else:
-            chain.append(('daily', f'出现 {daily_sig.kind}: {daily_sig.reason[:400]}', '第21课: 买卖点完备性定理'))
-
-        if daily_sig is None:
-            action, conf, note = self._no_signal_decision(wv, dv, cur_price)
-            m30_ns = _mv() if self.CFG.get('expose_m30_nosignal') else None
-            return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=m30_ns,
-                                    action=action, confidence=conf, final_kind='', cur_price=cur_price, chain=chain, note=note,
-                                    diagnostics=diagnostics, monthly=mov)
-
-        is_buy = daily_sig.kind in ('B1','B2','B3')
-        is_sell = daily_sig.kind in ('S1','S2','S3')
-
-        if self.CFG.get('zhongyin_block_buy') and is_buy and daily_sig.kind != 'B3' and daily_an is not None:
-            zy = daily_an.in_zhongyin()
-            if zy.get('in_zhongyin'):
-                chain.append(('中阴', f'第88-90课: 当前处中阴(方向未定+BOLL收口) → 暂不开新仓: {zy["reason"][:120]}', '第89课: 中阴阶段方向未定, 不宜开新仓'))
-                return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=None,
-                                        action='WATCH', confidence='LOW', final_kind=daily_sig.kind, cur_price=cur_price,
-                                        chain=chain, blocked_reason='中阴方向未定', note='中阴阶段暂不开仓(L88-90)',
-                                        diagnostics=diagnostics, monthly=mov)
-
-        if positions:
-            fail_kinds = []
-            for bk, pos in positions.items():
-                stop = pos.get('stop_px')
-                if stop is not None and cur_price < stop:
-                    fail_kinds.append(bk)
-            if fail_kinds:
-                chain.append(('证伪', f'持仓{"/".join(fail_kinds)}跌破建仓日锁定止损线 → 清仓', '第13/20课: 买点结构被破坏即证伪'))
-                return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
-                                        action='SELL', confidence='HIGH', final_kind='STOP', cur_price=cur_price,
-                                        chain=chain, note='结构证伪止损, 次日清仓',
-                                        diagnostics=diagnostics, monthly=mov)
-
-        blocked = ''
-        downgrade = False
-        if weekly_dir == 'up_trend' and is_sell:
-            downgrade = True
-            chain.append(('联立','周线上涨 + 日线卖点 → 第44课: 小级别(日线)顶背驰未必引发大级别(周线)转折, 卖点降级为"减仓/短差"',
-                          '第24课: 日线背驰除非周线同时背驰,否则不制造周线大顶'))
-        elif weekly_dir == 'down_trend' and is_buy:
-            if daily_sig.kind in ('B1','B2'):
-                chain.append(('联立','周线下跌 + 日线一/二买 → 下跌趋势的转折尝试, 必须由30分钟严格印证','第29课: 下跌的转折=上涨或盘整, 由背驰导致'))
-            else:
-                blocked = '周线下跌趋势中出现日线三买 —— 第43课: 三买属上涨结构, 与周线下跌矛盾, 大概率是下跌中继的假三买'
-        elif monthly_dir == 'down_trend' and is_buy and daily_sig.kind == 'B3' and not blocked:
-            blocked = '月线下跌大方向中出现日线三买 —— 第43/69课: 三买属上涨结构, 与月线大方向矛盾, 大概率假三买'
-        elif weekly_dir == 'up_trend' and is_buy:
-            chain.append(('联立','周线上涨 + 日线买点 → 方向一致, 进入30分钟精确定位','第43课: 大小级别同向, 操作最顺'))
-        elif weekly_dir == 'down_trend' and is_sell:
-            chain.append(('联立','周线下跌 + 日线卖点 → 方向一致, 趋势性卖出','第43课: 大小级别同向'))
-        elif weekly_dir == 'consolidation':
-            downgrade = True
-            chain.append(('联立','周线盘整 → 日线信号有效但降级(盘整中买卖点力度弱)','第29课: 盘整中的转折力度弱于趋势'))
-
-        # ── 周线二买 → 日线一买精确定位锚 (第14/17课) ──
-        if is_buy and wv is not None and wv.signal is not None \
-                and getattr(wv.signal, 'kind', '') == 'B2':
-            _dex = (daily_sig.extras or {}) if daily_sig is not None else {}
-            _anchor = _dex.get('b1_price') or _dex.get('cur_low')
-            if _anchor:
-                daily_sig.extras = dict(_dex)
-                daily_sig.extras['weekly_b2_daily_b1_anchor'] = float(_anchor)
-                chain.append(('联立',
-                              f'✓ 周线二买 + 日线买点共振: 周线B2由日线一买构成(第14课), '
-                              f'定位锚=日线一买位¥{float(_anchor):.3f}, 跌破该锚则周线二买证伪',
-                              '第17课: 大级别买点的精确定位要落到次级别的具体买点价位'))
-            else:
-                chain.append(('联立',
-                              '周线二买成立但日线尚无可定位的一买锚 → 等日线给出一买价位再重仓',
-                              '第14课'))
-
-        if blocked:
-            return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
-                                    action='WATCH', confidence='NONE', final_kind=daily_sig.kind, cur_price=cur_price,
-                                    chain=chain, blocked_reason=blocked, note='周线方向闸门拦截, 不操作',
-                                    diagnostics=diagnostics, monthly=mov)
-
-        m60_an = _get_m60()
-        ok60 = False
-        if m60_an is not None:
-            if is_buy:
-                ok60, note60 = self._confirm_finer(m60_an, True, '60分钟', '日线', daily_sig.kind)
-            else:
-                ok60, note60 = self._confirm_finer(m60_an, False, '60分钟', '日线', daily_sig.kind,
-                                                   parent_sig=daily_sig)
-            chain.append(('60m', ('✓ 次级别确认: ' if ok60 else '✗ 次级别未确认(降级): ')+note60,
-                          '第44课: 区间套 —— 日线的转折先由直接次级别60分钟走势确认'))
-            if not ok60:
-                downgrade = True
-                if self.CFG.get('require_60m_buy_confirm') and is_buy and daily_sig.kind in ('B1', 'B2'):
-                    return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
-                                            action='WATCH', confidence='LOW', final_kind=daily_sig.kind, cur_price=cur_price,
-                                            chain=chain, blocked_reason='60分钟直接次级别未印证买点(L44区间套)',
-                                            note=f'日线{daily_sig.kind}买点但60m未现B1/B2 → 等直接次级别印证再动手',
-                                            diagnostics=diagnostics, monthly=mov)
-        else:
-            if df_6 is not None:
-                chain.append(('60m', '60分钟数据不足(<30根) → 跳过该级印证', '第44课: 区间套逐级确认'))
-
-        m30_an = _get_m30()
-        if m30_an is None:
-            chain.append(('30m','无30分钟数据 → 缺少次级别精确印证, 信号降级','第44课: 操作级别的买卖点需次级别走势确认'))
-            confirmed = False; confirm_note = '缺30分钟数据'; downgrade = True
-        else:
-            if is_buy:
-                confirmed, confirm_note = self._confirm_30m_for_buy(m30_an, daily_sig.kind)
-            else:
-                confirmed, confirm_note = self._confirm_30m_for_sell(m30_an, daily_sig.kind,
-                                                                     parent_sig=daily_sig)
-            chain.append(('30m', ('✓ 次级别确认: ' if confirmed else '✗ 次级别未确认: ')+confirm_note, '第44课: 小背驰-大转折定理(必要条件)'))
-
-        # ── 60m嵌套印证补位 (第44课区间套, 卖点版) ──
-        # 30m动能未竭但60m(日线的直接次级别)已给出嵌套顶背驰/转折确认 → 采信60m。
-        # 日线的"次级别"本就是60m; 30m是60m的次级别, 不应让更细级别一票否决直接次级别。
-        if (self.CFG.get('sell_nested_interval') and is_sell and not confirmed
-                and ok60 and daily_sig.kind in ('S1', 'S2')):
-            confirmed = True
-            confirm_note = '30m动能未竭, 但60m(日线直接次级别)已嵌套印证 → 采信60m(第44课: 逐级处理, 直接次级别优先)'
-            chain.append(('联立', '✓ ' + confirm_note, '第44课区间套'))
-
-        # ── L50 MACD级别选择: 选黄白线和柱子清晰的级别看MACD ──
-        if (self.CFG.get('l50_macd_level_select') and is_buy and not confirmed
-                and ok60 and m60_an is not None and m30_an is not None):
-            try:
-                c60 = m60_an.macd_clarity(); c30 = m30_an.macd_clarity()
-                if c30['score'] < 0.4 and c60['score'] >= max(0.4, c30['score'] * 1.5):
-                    confirmed = True
-                    chain.append(('联立',
-                                  f"✓ L50 MACD级别选择: 30m MACD{c30['label']}(清晰度{c30['score']}) 判据不可靠; "
-                                  f"60m MACD{c60['label']}(清晰度{c60['score']})且60m已印证买点 → 采信60m结论",
-                                  '第50课: 看MACD要选黄白线和柱子走势清晰的级别'))
-            except Exception:
-                pass
-
-        m15_an = None; m15_confirmed = None
-        if confirmed and df_15 is not None and len(df_15) >= 30:
-            try: m15_an = _MAKE_ANALYZER('15m', df_15)
-            except Exception: m15_an = None
-        if not confirmed:
-            pass
-        elif df_15 is None:
-            pass
-        elif m15_an is None:
-            chain.append(('15m','15分钟数据不足(<30根) → 跳过该级印证','第44课: 区间套逐级确认'))
-        else:
-            ok15, note15 = self._confirm_finer(m15_an, is_buy, '15分钟', '30分钟', daily_sig.kind,
-                                               parent_sig=(daily_sig if is_sell else None))
-            m15_confirmed = ok15
-            chain.append(('15m', ('✓ 次级别确认: ' if ok15 else '✗ 次级别未确认(降级,不拦截): ')+note15,
-                          '第44课: 逐级处理 —— 30分钟的转折由15分钟走势确认'))
-            if not ok15: downgrade = True
-
-        m5_an = None; m5_confirmed = None
-        if confirmed and df_5 is not None and len(df_5) >= 30:
-            try: m5_an = _MAKE_ANALYZER('5m', df_5)
-            except Exception: m5_an = None
-        if not confirmed:
-            pass
-        elif df_5 is None:
-            chain.append(('5m','无5分钟数据 → 缺该级逐级印证, 信号降级','第44课: 15分钟的转折需5分钟走势逐级确认')); downgrade = True
-        elif m5_an is None:
-            chain.append(('5m','5分钟数据不足(<30根) → 缺该级印证, 信号降级','第44课: 15分钟的转折需5分钟走势逐级确认')); downgrade = True
-        else:
-            ok5, note5 = self._confirm_5m(m5_an, is_buy, daily_sig.kind,
-                                          parent_sig=(daily_sig if is_sell else None))
-            m5_confirmed = ok5
-            chain.append(('5m', ('✓ 次级别确认: ' if ok5 else '✗ 次级别未确认(降级,不拦截): ')+note5, '第44课: 逐级处理 —— 15分钟的转折由5分钟走势确认'))
-            if not ok5: downgrade = True
-
-        m1_an = None; m1_confirmed = None
-        do_1m = confirmed and (m5_confirmed is True)
-        if do_1m and df_1 is not None and len(df_1) >= 30:
-            try: m1_an = _MAKE_ANALYZER('1m', df_1)
-            except Exception: m1_an = None
-        if not do_1m:
-            pass
-        elif df_1 is None:
-            chain.append(('1m','无1分钟数据 → 缺区间套最末级印证, 信号降级','第44课: 区间套 —— 5分钟的转折需1分钟走势逐级确认')); downgrade = True
-        elif m1_an is None:
-            chain.append(('1m','1分钟数据不足(<30根) → 缺最末级印证, 信号降级','第44课: 区间套 —— 5分钟的转折需1分钟走势逐级确认')); downgrade = True
-        else:
-            ok1, note1 = self._confirm_1m(m1_an, is_buy, daily_sig.kind,
-                                          parent_sig=(daily_sig if is_sell else None))
-            m1_confirmed = ok1
-            chain.append(('1m', ('✓ 末级确认: ' if ok1 else '✗ 末级未确认(降级,不拦截): ')+note1, '第44课: 区间套 —— 5分钟的转折由1分钟走势确认'))
-            if not ok1: downgrade = True
-
-        # ── L24规则: 周线上涨 + 日线【盘整背驰】(非趋势背驰)的S1/S2 ──
-        # 第24课: 某级别的背驰导致该级别的转折; 日线背驰若周线未同步背驰,
-        # 只构成日线级别的调整, 不是大顶 → 不全清仓, 转入区间套布防做短差:
-        # 真转折由布防线(嵌套背驰/破30m中枢ZD/峰值回落)兜底, 趋势延续则由
-        # 撤防机制(强势新高消化背驰, 第26课)继续骑中枢上移(第91课①)。
-        if (self.CFG.get('sell_nested_interval') and self.CFG.get('l24_weekly_uptrend_arm')
-                and is_sell and daily_sig.kind in ('S1', 'S2') and weekly_dir == 'up_trend'):
-            _dg = getattr(daily_sig, 'diverge_grade', None)
-            if _dg is not None and not getattr(_dg, 'is_trend_divergence', False):
-                _arm_zd = (m30_an.pivots[-1].zd if (m30_an is not None and m30_an.n_pivots) else None)
-                _ex = daily_sig.extras or {}
-                _arm_high = _ex.get('c_high') or _ex.get('prev_high') or cur_price
-                chain.append(('L24', f'周线上涨 + 日线{daily_sig.kind}仅为盘整背驰(非趋势背驰) '
-                              f'→ 第24课: 不构成周线级别大顶, 不全清 → 转区间套布防短差'
-                              f'(布防线: 30m中枢ZD{f"¥{_arm_zd:.3f}" if _arm_zd else "暂无"}/'
-                              f'峰值回落{SELL_ARM_PEAK_DROP:.0%}; 强势新高则撤防骑趋势)',
-                              '第24课: 日线背驰除非周线同步背驰, 否则只造成日线级别调整'))
-                return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
-                                        action='HOLD', confidence='MEDIUM', final_kind=daily_sig.kind,
-                                        cur_price=cur_price, chain=chain,
-                                        note=f'L24: 周线上涨中的日线盘整背驰{daily_sig.kind}, 布防短差不全清',
-                                        sell_armed=True, arm_zd=_arm_zd,
-                                        arm_high=float(_arm_high) if _arm_high else None,
-                                        diagnostics=diagnostics, monthly=mov)
-
-        action = 'BUY' if is_buy else 'SELL'
-        if self.CFG.get('mode') == 'long' and is_sell and daily_sig.kind in ('S1', 'S2'):
-            big_up_long = ((wv is not None and wv.trend == 'up_trend') or
-                           (mov is not None and monthly_dir == 'up_trend'))
-            ma5m_ok = True
-            if len(df_mo) >= 5:
-                ma5m = float(df_mo['close'].tail(5).mean())
-                ma5m_ok = cur_price >= ma5m
-            if big_up_long and ma5m_ok:
-                chain.append(('mode', f'长线模式: 日线{daily_sig.kind}非周线级别转折且大方向上涨 → 持有(操作级别=周线)', '第72课: 看周线则日线调整不构成卖段; 第61课大级别不因小级别震荡卖'))
-                # 长线模式持有也挂上布防线(第44课): 真转折时不至于全程坐滑梯
-                _arm_zd = (m30_an.pivots[-1].zd if (m30_an is not None and m30_an.n_pivots) else None)
-                _ex = daily_sig.extras or {}
-                _arm_high = _ex.get('c_high') or _ex.get('prev_high') or cur_price
-                return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
-                                        action='HOLD', confidence='MEDIUM', final_kind=daily_sig.kind, cur_price=cur_price,
-                                        chain=chain, note=f'长线模式持有: 日线{daily_sig.kind}属次级别调整, 周线方向未转',
-                                        sell_armed=bool(self.CFG.get('sell_nested_interval')),
-                                        arm_zd=_arm_zd, arm_high=float(_arm_high) if _arm_high else None,
-                                        diagnostics=diagnostics, monthly=mov)
-        if not confirmed:
-            if is_sell:
-                # ── 卖点区间套布防 (第24/44课): 背驰已现但次级别动能未竭 ──
-                # 不立即卖(防卖飞), 也绝不傻等到三卖(防坐滑梯): 持仓转入布防,
-                # 由回测端的布防线(嵌套背驰出现/破30m中枢ZD/峰值回落阈值)收割。
-                # 布防仅用于S1的精确定顶。S2是一卖后的【反抽】卖点(第15课):
-                # 上方空间被一卖高点封死, 反抽本身就是用来卖的, "等次级别动能衰竭"
-                # 与其性质矛盾 → S2未印证时维持"先卖再说"(走下方LOW置信卖出)。
-                if (self.CFG.get('sell_nested_interval') and daily_sig.kind == 'S1'):
-                    arm_zd = (m30_an.pivots[-1].zd if (m30_an is not None and m30_an.n_pivots) else None)
-                    ex = daily_sig.extras or {}
-                    arm_high = ex.get('c_high') or ex.get('prev_high') or cur_price
-                    chain.append(('卖点布防',
-                                  f'日线{daily_sig.kind}背驰已现但次级别动能未竭 → 不立即卖(防卖飞), '
-                                  f'转入区间套布防: ①次级别出现嵌套顶背驰即卖 '
-                                  f'②跌破30m最近中枢下沿ZD{f"¥{arm_zd:.3f}" if arm_zd else "(暂无30m中枢)"}即卖 '
-                                  f'③较布防后峰值回落{SELL_ARM_PEAK_DROP:.0%}即卖',
-                                  '第44课区间套: 背驰段中套背驰段定精确高点; 第24课: 次级别未背驰, 大级别顶未到'))
-                    return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
-                                            action='HOLD', confidence='MEDIUM', final_kind=daily_sig.kind,
-                                            cur_price=cur_price, chain=chain,
-                                            note=f'区间套布防中: 日线{daily_sig.kind}背驰段内, 等次级别嵌套背驰收敛后高位兑现(第44课)',
-                                            sell_armed=True, arm_zd=arm_zd,
-                                            arm_high=float(arm_high) if arm_high else None,
-                                            confidence_reasons=[f'布防原因: {confirm_note}'],
-                                            diagnostics=diagnostics, monthly=mov)
-                big_up_sell = ((wv is not None and wv.trend == 'up_trend') or
-                               (mov is not None and monthly_dir == 'up_trend'))
-                if self.CFG.get('require_sublevel_sell_confirm') and big_up_sell:
-                    chain.append(('sell_gate', f'日线{daily_sig.kind}卖点但次级别未印证, 且大方向上涨 → 持有(L61: 大级别不因小级别震荡卖)', '第61课: 区间套确认; 大级别操作不因小级别震荡清仓'))
-                    return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
-                                            action='HOLD', confidence='LOW', final_kind=daily_sig.kind, cur_price=cur_price,
-                                            chain=chain, note=f'日线{daily_sig.kind}卖点次级别未印证+大方向上涨, 持有等确认: {confirm_note}',
-                                            confidence_reasons=[f'次级别未印证持有: {confirm_note}'],
-                                            diagnostics=diagnostics, monthly=mov)
-                chain.append(('sell_gate',f'日线{daily_sig.kind}卖点已成立, 次级别未印证只降级不拦截','第14/15/21课: 买点买、卖点卖; 区间套用于精确定位, 不是否决卖点'))
-                return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
-                                        action='SELL', confidence='LOW', final_kind=daily_sig.kind, cur_price=cur_price,
-                                        chain=chain, note=f'日线{daily_sig.kind}卖点先执行; 次级别未印证仅降级: {confirm_note}',
-                                        confidence_reasons=[f'次级别未印证: {confirm_note}'],
-                                        diagnostics=diagnostics, monthly=mov)
-            return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
-                                    action='WATCH', confidence='LOW', final_kind=daily_sig.kind, cur_price=cur_price,
-                                    chain=chain, blocked_reason=f'次级别未印证({confirm_note})',
-                                    note='日线有买/非S1卖信号但次级别未确认 -- 等次级别出信号再动手',
-                                    diagnostics=diagnostics, monthly=mov)
 
-        score = 100; conf_reasons = []
-        def _penalty(pts, reason):
-            nonlocal score
-            score -= pts; conf_reasons.append(f'(-{pts}) {reason}')
-        if mov is not None and monthly_dir == 'down_trend' and is_buy:
-            _penalty(25, '第69课: 月线大方向下跌, 日线买点属逆大方向的转折尝试')
-        trend_piv_lt2 = (daily_an is not None and daily_an.n_trend_pivots < 2)
-        if trend_piv_lt2 and daily_sig.kind in ('B1', 'S1'):
-            _penalty(20, f'第27课: 背驰段前仅{daily_an.n_trend_pivots}个中枢(<2), 盘整背驰非趋势背驰')
-        if daily_an is not None and daily_an.trend == 'consolidation':
-            _penalty(15, '第29课: 日线处盘整结构, 盘整中转折力度弱')
-        daily_dg = getattr(daily_sig, 'diverge_grade', None)
-        if daily_dg is not None and daily_dg.grade == 'WEAK':
-            trig = '面积' if daily_dg.area_ok else 'DIF极值'
-            _penalty(15, f'第27课: 背驰仅满足{trig}单一判据(WEAK), 非标准背驰')
-        if (daily_dg is not None and daily_dg.grade in ('STRONG', 'WEAK')
-                and not daily_dg.is_trend_divergence and not trend_piv_lt2
-                and daily_sig.kind in ('B1', 'S1')):
-            _penalty(10, '第27课: 背驰段为盘整背驰(非趋势背驰), 力度偏弱')
-        if downgrade:
-            _penalty(12, '第44课: 区间套次级别未完全印证(精度降级, 非证伪)')
-        if daily_sig.kind in ('B2', 'S2'):
-            has_delayed = any(lvl in ('30m', '15m', '5m', '1m') and '延后确认' in concl
-                              for lvl, concl, _ in chain)
-            if has_delayed:
-                _penalty(8, '二/二卖由次级别延后确认(非次级别一买/一卖精确定位), 精度略降')
-        ex = daily_sig.extras or {}
-        if daily_sig.kind == 'B3':
-            missing = []
-            if ex.get('b1_price') is None:
-                missing.append('一买')
-            if ex.get('b2_price') is None:
-                missing.append('二买')
-            if missing:
-                _penalty(6, '第20/21课: 三买未能定位对应' + '/'.join(missing) + ', 质量略降')
-            if ex.get('late_trend_b3'):
-                _penalty(12, '第20/92课: 第二个以上同向中枢后的三买, 操作意义下降')
-        if daily_sig.kind == 'S3':
-            missing = []
-            if ex.get('s1_price') is None:
-                missing.append('一卖')
-            if ex.get('s2_price') is None:
-                missing.append('二卖')
-            if missing:
-                _penalty(6, '第20/21课: 三卖未能定位对应' + '/'.join(missing) + ', 质量略降')
-        if daily_dg is not None and daily_dg.grade == 'STRONG' and daily_dg.is_trend_divergence:
-            score += 10; conf_reasons.append('(+10) 第27课: 标准趋势背驰(>=2中枢+面积+DIF), 高质量')
-        # ── 卖点区间套加分: 30m嵌套顶背驰精确定位(卖在高位区) ──
-        if is_sell and any(lvl == '30m' and '嵌套顶背驰' in concl for lvl, concl, _ in chain):
-            score += 8; conf_reasons.append('(+8) 第44课: 30m嵌套顶背驰精确定位, 卖点落在高位区')
-        score = max(0, min(110, score))
-        confidence = 'HIGH' if score >= 70 else ('MEDIUM' if score >= 45 else 'LOW')
-        if conf_reasons:
-            chain.append(('置信度', f'{confidence}(评分{score}) ← ' + '; '.join(conf_reasons),
-                          '第21课: 一二三类买卖点是位置分类非质量排序; 置信度按原著力度条件评分'))
-        else:
-            chain.append(('置信度', f'HIGH(评分{score}) ← 力度条件全部满足',
-                          '第27/29/43课: 方向一致+趋势背驰+趋势结构'))
-        note_parts = []
-        if conf_reasons:
-            note_parts.append(f'置信评分明细: ' + '; '.join(conf_reasons))
-        n_lvl = 3 + (self.df_60m is not None) + (self.df_15m is not None) + (self.df_5m is not None) + (self.df_1m is not None)
-        lvl_txt = {3:'三级别',4:'四级别',5:'五级别',6:'六级别',7:'七级别'}.get(n_lvl, f'{n_lvl}级别')
-        m5_txt = ('/5m已印证' if m5_confirmed is True else '/5m未印证(已降级)' if m5_confirmed is False else '')
-        m1_txt = ('/1m已印证' if m1_confirmed is True else '/1m未印证(已降级)' if m1_confirmed is False else '')
-        note_parts.append(f'{lvl_txt}联立通过: 周线{weekly_dir}/日线{daily_sig.kind}/30m已印证{m5_txt}{m1_txt}')
-        note = ' | '.join(note_parts)
-        return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
-                                action=action, confidence=confidence, final_kind=daily_sig.kind, cur_price=cur_price,
-                                chain=chain, note=note, confidence_reasons=conf_reasons, diagnostics=diagnostics, monthly=mov)
 
-    @staticmethod
-    def _no_signal_decision(wv, dv, cur_price):
-        if wv is not None and wv.trend == 'up_trend' and dv.trend == 'up_trend':
-            if dv.zg is not None and cur_price > dv.zg:
-                return ('HOLD','NONE', f'周线+日线均上涨且价({cur_price:.2f})在日线ZG({dv.zg:.2f})上, 继续持有等卖点(第108课: 买点入,持有等卖点)')
-            return ('HOLD','NONE','周线日线均上涨, 趋势中持有')
-        if wv is not None and wv.trend == 'down_trend':
-            return ('WATCH','NONE','周线下跌趋势, 无日线买点 → 空仓观望, 不抄底')
-        return ('WATCH','NONE', f'无明确信号(周线{wv.trend if wv else "?"}/日线{dv.trend}), 观望')
+W_REVERSAL = 1.0
+W_TRAP     = 0.85
+W_RELAY    = 0.6
+W_UNKNOWN  = 0.7
+
+# 第16课 六种基本走势 → 买法分类的中文名(配合英文 method 一起展示)
+METHOD_CN = {
+    'reversal': '反转式(下跌+盘整+上涨 / 趋势底背驰一买, 力度最强, 权重最高)',
+    'trap':     '陷阱式(下跌+上涨, 空头陷阱式二买, 中等力度)',
+    'relay':    '中继式(上涨+盘整+上涨, 三买, 趋势中继)',
+    'unknown':  '未分类',
+}
+
+WEAK_ARM_GAIN = 0.04
+WEAK_GIVEBACK = 0.22
+
+L92_EXIT_ENABLE      = False
+L92_EXIT_FLOATING_MAX = 0.015
+L92_ZD_BREAK_BUF      = 0.0
+
+
+def classify_buy_method(sig_kind, ml) -> str:
+    sig = ml.daily.signal if (ml and ml.daily) else None
+    dg = getattr(sig, 'diverge_grade', None) if sig is not None else None
+    if sig_kind == 'B1':
+        return 'reversal'
+    if sig_kind == 'B3':
+        return 'relay'
+    if sig_kind == 'B2':
+        # L37 背驰分辨: 只有"趋势背驰"(≥2个同向中枢后的背驰)才是标准的趋势转折,
+        # 对应第16课"下跌+盘整+上涨"反转式买法; 盘整背驰力度弱, 仍按陷阱式处理。
+        if (dg is not None and getattr(dg, 'grade', '') == 'STRONG'
+                and getattr(dg, 'is_trend_divergence', False)):
+            return 'reversal'
+        return 'trap'
+    return 'unknown'
+
+
+def l37_divergence_note(ml) -> str:
+    """L37 背驰分辨(区分背驰段构成): 趋势背驰=至少两个同向中枢后的背驰, 转折级别高;
+    盘整背驰=单中枢内的力度衰竭, 只保证回拉中枢, 不保证反转。"""
+    sig = ml.daily.signal if (ml and ml.daily) else None
+    dg = getattr(sig, 'diverge_grade', None) if sig is not None else None
+    if dg is None or getattr(dg, 'grade', 'NONE') == 'NONE':
+        return ''
+    if getattr(dg, 'is_trend_divergence', False):
+        return (f'第37课: 趋势背驰({getattr(dg, "n_trend_pivots", "?")}个同向中枢), '
+                f'转折至少回拉至最后一个中枢, 大概率反转 → 可按反转式买法重仓')
+    return ('第37课: 盘整背驰(背驰段内仅1个中枢), 只保证回拉中枢一次, '
+            '不保证趋势反转 → 轻仓短打, 回拉到中枢即考虑兑现')
+
+
+def buy_method_weight(sig_kind, ml):
+    method = classify_buy_method(sig_kind, ml)
+    wmap = {'reversal': W_REVERSAL, 'trap': W_TRAP, 'relay': W_RELAY, 'unknown': W_UNKNOWN}
+    return method, wmap.get(method, W_UNKNOWN)
+
+
+def recompute_evo(ml) -> str:
+    sig = ml.daily.signal if (ml and ml.daily) else None
+    if sig is not None:
+        evo = (sig.extras or {}).get('post_evolution', '')
+        if evo:
+            return evo
+    dv = ml.daily if ml else None
+    if dv is not None and dv.zd is not None and dv.zg is not None:
+        if ml.cur_price < dv.zd:
+            return 'case1_extend'
+    return ''
+
+
+def weak_evo_giveback(pos, ml, default_giveback):
+    evo = recompute_evo(ml) if ml is not None else (pos.get('post_evo') or '')
+    if evo == 'case1_extend':
+        return WEAK_ARM_GAIN, WEAK_GIVEBACK
+    return None, default_giveback
+
+
+def l92_should_exit(pos, ml, close_p, floating):
+    if not L92_EXIT_ENABLE or ml is None or ml.daily is None:
+        return None
+    if floating > L92_EXIT_FLOATING_MAX:
+        return None
+    zd = ml.daily.zd
+    if zd is None:
+        return None
+    if close_p < zd * (1 - L92_ZD_BREAK_BUF) and close_p > pos.get('stop_px', 0):
+        return ('L92_EXIT',
+                f'第92课中枢震荡监视器: 现价{close_p:.3f}已破日线中枢下沿ZD{zd:.3f}'
+                f'(向下变盘) 且浮盈仅{floating:+.1%} → 提前减仓, 不等磨到结构止损')
+    return None
+
+
+def predict_enhance(ml) -> dict:
+    out = {}
+    if ml is None or ml.daily is None:
+        return out
+    sig_kind = ml.final_kind or ''
+    if sig_kind in ('B1', 'B2', 'B3'):
+        method, weight = buy_method_weight(sig_kind, ml)
+        out['buy_method'] = method
+        out['buy_method_cn'] = METHOD_CN.get(method, method)
+        out['suggest_weight'] = weight
+        out['l16_note'] = f'第16课: 买法分类={method}〔{METHOD_CN.get(method, method)}〕, 建议仓位权重{weight:.2f}'
+    l37 = l37_divergence_note(ml)
+    if l37:
+        out['l37_note'] = l37
+    evo = recompute_evo(ml)
+    if evo:
+        out['post_evolution'] = evo
+        out['evo_hint'] = ('第29课: 最弱形态(反弹/回落未回中枢), 持有宜收紧移动止盈, 尽快兑现'
+                           if evo == 'case1_extend'
+                           else '第29课: 形态较强(回到中枢), 可持有等三买/趋势延续')
+    zd = ml.daily.zd
+    if zd is not None and ml.cur_price < zd:
+        out['l92_warn'] = f'第92课: 现价{ml.cur_price:.3f}已在日线中枢下沿ZD{zd:.3f}下方 → 向下变盘预警'
+    return out

data_us.py

@@ -1,147 +1,70 @@
 """
-data_us.py — US market data layer (yfinance), replacing baostock/pytdx.
-
-Levels & history limits (Yahoo Finance API constraints):
-    daily   : 10 years          (weekly / monthly are resampled from daily
-                                 by chan_multilevel.resample_weekly/_monthly)
-    60m     : last 730 days
-    30m/15m : last 60 days
-    5m      : last 60 days
-    1m      : last 7 days only → too short for Chan decomposition, NOT used.
-              MultiLevelChan handles a missing 1m level gracefully (skips it).
-
-Output schema (identical to the original A-share loaders):
-    date, open, close, high, low, volume, amount
-`amount` (turnover) is approximated as close × volume (Yahoo has no turnover field).
-
-All downloads are cached to parquet under ./_cache_us/<TICKER>/<level>.parquet
-and refreshed when stale (daily: >12h old, intraday: >2h old) or on force=True.
+chan_glue.py — wires the user's notebook-style modules together at runtime.
+
+The original chan_engine.py / chan_multilevel.py were written as notebook cells:
+chan_multilevel references `ChanAnalyzer` / `Signal` via a commented-out import.
+Because both files use `from __future__ import annotations` and resolve names at
+call time, we can simply inject the symbols into the module namespace — the Chan
+analysis logic itself is left 100% untouched.
+
+Also provides a small LRU-cached analyzer factory (the original chan_common.py
+was A-share specific and is not used in the US version).
 """
 from __future__ import annotations
 
-import os
-import time
-import traceback
+import hashlib
+from collections import OrderedDict
 
 import pandas as pd
 
-import paths
-
-CACHE_DIR = os.environ.get("CHAN_CACHE_DIR", paths.CACHE_DIR)
-
-LEVELS = {
-    # level: (yfinance interval, period) — Yahoo's max history per interval
-    "d":   ("1d",  "10y"),
-    "60m": ("60m", "730d"),
-    "30m": ("30m", "60d"),
-    "15m": ("15m", "60d"),
-    "5m":  ("5m",  "60d"),
-    "1m":  ("1m",  "7d"),    # only 7 days available; short but usable for the
-                             # finest nested-interval confirmation when present
-}
-
-_STALE_SECONDS = {"d": 12 * 3600, "60m": 2 * 3600, "30m": 2 * 3600,
-                  "15m": 2 * 3600, "5m": 2 * 3600, "1m": 1800}
-
-
-def _cache_path(ticker: str, level: str) -> str:
-    d = os.path.join(CACHE_DIR, ticker.upper().replace("/", "_"))
-    os.makedirs(d, exist_ok=True)
-    return os.path.join(d, f"{level}.parquet")
-
-
-def _normalize(df: pd.DataFrame) -> pd.DataFrame:
-    """yfinance frame → engine schema (date/open/close/high/low/volume/amount)."""
-    if df is None or len(df) == 0:
-        return pd.DataFrame(columns=["date", "open", "close", "high", "low", "volume", "amount"])
-    d = df.copy()
-    if isinstance(d.columns, pd.MultiIndex):           # yf>=0.2 returns MultiIndex sometimes
-        d.columns = [c[0] if isinstance(c, tuple) else c for c in d.columns]
-    d = d.reset_index()
-    # index column may be 'Date' or 'Datetime'
-    for cand in ("Datetime", "Date", "index"):
-        if cand in d.columns:
-            d = d.rename(columns={cand: "date"})
-            break
-    d.columns = [str(c).lower() for c in d.columns]
-    keep = {"date", "open", "high", "low", "close", "volume"}
-    d = d[[c for c in d.columns if c in keep]]
-    d["date"] = pd.to_datetime(d["date"])
-    # strip timezone so comparisons with naive Timestamps in the engine work
-    try:
-        d["date"] = d["date"].dt.tz_localize(None)
-    except (TypeError, AttributeError):
-        pass
-    d = d.dropna(subset=["open", "high", "low", "close"])
-    d = d.sort_values("date").reset_index(drop=True)
-    d["amount"] = d["close"] * d.get("volume", 0)
-    return d[["date", "open", "close", "high", "low", "volume", "amount"]]
-
-
-def load_level(ticker: str, level: str, force: bool = False) -> pd.DataFrame:
-    """Load one level for a ticker, using parquet cache when fresh."""
-    assert level in LEVELS, f"unknown level {level}"
-    path = _cache_path(ticker, level)
-    if not force and os.path.exists(path):
-        age = time.time() - os.path.getmtime(path)
-        if age < _STALE_SECONDS[level]:
-            try:
-                return pd.read_parquet(path)
-            except Exception:
-                pass
-    try:
-        import yfinance as yf
-        interval, period = LEVELS[level]
-        raw = yf.Ticker(ticker).history(period=period, interval=interval,
-                                        auto_adjust=True, actions=False)
-        df = _normalize(raw)
-        if len(df):
-            df.to_parquet(path, index=False)
-            return df
-    except Exception:
-        traceback.print_exc()
-    # network failed → fall back to stale cache if any
-    if os.path.exists(path):
-        try:
-            return pd.read_parquet(path)
-        except Exception:
-            pass
-    return pd.DataFrame(columns=["date", "open", "close", "high", "low", "volume", "amount"])
-
-
-# Full nested-interval set (区间套): the more sub-levels confirm, the more
-# precise the buy/sell point. We fetch the deepest Yahoo allows. 1m has only
-# 7 days of history — included when present, skipped gracefully otherwise.
-# Downloads are parallel + cached, so the extra levels cost little wall-time.
-FULL_LEVELS = ("d", "60m", "30m", "15m", "5m", "1m")
-FAST_LEVELS = FULL_LEVELS  # default everywhere; alias kept for older callers
-
-
-def load_levels(ticker: str, levels=FAST_LEVELS, force: bool = False) -> dict:
-    return {lvl: load_level(ticker, lvl, force=force) for lvl in levels}
-
-
-def load_all_levels(ticker: str, force: bool = False) -> dict:
-    """Return {'d':…, '60m':…, '30m':…, '15m':…, '5m':…} (1m intentionally absent)."""
-    return {lvl: load_level(ticker, lvl, force=force) for lvl in LEVELS}
-
-
-def prefetch(tickers, levels=FAST_LEVELS, force: bool = False, workers: int = 5,
-             budget_s: int = 45):
-    """Download all (ticker, level) pairs in parallel with a hard time budget.
-    Yahoo rate-limits datacenter IPs; without a budget one throttled request
-    could hang the whole Run-analysis click. Whatever isn't fetched in time is
-    skipped — the engine analyzes from daily/cached data and the next run
-    picks up the rest."""
-    from concurrent.futures import ThreadPoolExecutor, wait
-    jobs = [(t, lvl) for t in tickers for lvl in levels]
-    ex = ThreadPoolExecutor(max_workers=workers)
-    futs = [ex.submit(load_level, t, lvl, force) for t, lvl in jobs]
-    done, not_done = wait(futs, timeout=budget_s)
-    ex.shutdown(wait=False, cancel_futures=True)
-    return len(done), len(not_done)
-
-
-def last_daily_date(ticker: str):
-    df = load_level(ticker, "d")
-    return None if df.empty else pd.Timestamp(df["date"].iloc[-1])
+import chan_engine
+import chan_multilevel
+
+# ── inject cross-module symbols (replaces the commented `from chan_engine import …`) ──
+chan_multilevel.ChanAnalyzer = chan_engine.ChanAnalyzer
+chan_multilevel.Signal = chan_engine.Signal
+chan_engine.PIVOT_MAX_EXTEND_SEGS = chan_engine.PIVOT_MAX_EXTEND_SEGS  # no-op, keeps linters calm
+
+# Re-exports for app code
+ChanAnalyzer = chan_engine.ChanAnalyzer
+Signal = chan_engine.Signal
+MultiLevelChan = chan_multilevel.MultiLevelChan
+MultiLevelSignal = chan_multilevel.MultiLevelSignal
+resample_weekly = chan_multilevel.resample_weekly
+resample_monthly = chan_multilevel.resample_monthly
+set_analyzer_factory = chan_multilevel.set_analyzer_factory
+
+# ── cached analyzer factory ──────────────────────────────────────────────
+_CACHE: "OrderedDict[str, chan_engine.ChanAnalyzer]" = OrderedDict()
+_CACHE_MAX = 64
+
+
+def _df_key(level: str, df: pd.DataFrame) -> str:
+    n = len(df)
+    if n == 0:
+        return f"{level}-empty"
+    last = str(df['date'].iloc[-1])
+    first = str(df['date'].iloc[0])
+    tail_close = float(df['close'].iloc[-1])
+    raw = f"{level}|{n}|{first}|{last}|{tail_close:.6f}"
+    return hashlib.md5(raw.encode()).hexdigest()
+
+
+def cached_analyzer(level: str, df: pd.DataFrame):
+    key = _df_key(level, df)
+    if key in _CACHE:
+        _CACHE.move_to_end(key)
+        return _CACHE[key]
+    an = chan_engine.ChanAnalyzer(df.reset_index(drop=True))
+    _CACHE[key] = an
+    while len(_CACHE) > _CACHE_MAX:
+        _CACHE.popitem(last=False)
+    return an
+
+
+def install():
+    """Install the cached analyzer factory into MultiLevelChan."""
+    set_analyzer_factory(cached_analyzer)
+
+
+install()

elevation.css

@@ -0,0 +1,58 @@
+/* ============================================================
+   BASE — Chan Compass · Spectrum 2
+   Light, opinionated element defaults. Body uses the canvas
+   background and UI type. Helper classes for the few primitives
+   that aren't worth a React component.
+   ============================================================ */
+
+*, *::before, *::after { box-sizing: border-box; }
+
+body {
+  margin: 0;
+  background: var(--canvas);
+  color: var(--text-body);
+  font: var(--type-body);
+  -webkit-font-smoothing: antialiased;
+  text-rendering: optimizeLegibility;
+}
+
+h1, h2, h3, h4 {
+  margin: 0;
+  color: var(--text-heading);
+  letter-spacing: var(--letter-spacing-heading);
+  text-wrap: balance;
+}
+h1 { font: var(--type-h1); }
+h2 { font: var(--type-h2); }
+h3 { font: var(--type-h3); letter-spacing: 0; }
+h4 { font: var(--type-h4); letter-spacing: 0; }
+
+p { margin: 0; text-wrap: pretty; }
+
+a { color: var(--accent-text); text-decoration: none; }
+a:hover { text-decoration: underline; text-underline-offset: 2px; }
+
+code, kbd, samp { font-family: var(--font-code); font-size: 0.92em; }
+
+::selection { background: var(--accent-subtle); }
+
+:focus-visible {
+  outline: var(--focus-ring-width) solid var(--focus-ring);
+  outline-offset: var(--focus-ring-offset);
+  border-radius: var(--radius-sm);
+}
+
+/* ---- Eyebrow / overline ---- */
+.s2-eyebrow {
+  font: var(--font-weight-bold) var(--font-size-50)/1.2 var(--font-sans);
+  letter-spacing: var(--letter-spacing-caps);
+  text-transform: uppercase;
+  color: var(--text-muted);
+}
+
+/* ---- Hairline divider ---- */
+.s2-divider {
+  border: none;
+  border-top: var(--border-width-100) solid var(--border-hairline);
+  margin: var(--space-300) 0;
+}

emailer.py

@@ -1,288 +1,884 @@
-"""
-emailer.py — send a tab's AI result to any address (English UI + content).
+"""缠论多级别联立分析
+
+【本版改动 · 卖点区间套修复 (第24/44课)】
 
-Adapted from the user's send_predict_email.py: same multi-domain SMTP
-auto-detection, plain+HTML multipart, but English subjects/labels and a generic
-`send_result()` the Gradio tabs call.
+旧逻辑的两个病根(对应回测中"卖在低位"与"提前卖飞"):
+  ① 卖在低位: 严格模式要求"30分钟出现三类卖点S3"才印证日线卖点。但S3是
+     次级别已经跌破其中枢、反抽不回的【转折确认点】—— 它出现时价格早已
+     离开顶部一大截。拿S3当卖出闸门, 等于规定"必须先跌下来才准卖", 结构上
+     注定卖不到一卖的高位, 最后落在二卖/三卖的低位。
+  ② 提前卖飞: 宽松模式下"30m最后一笔向下"即印证。第24课明示: 小级别背驰
+     (更别说仅仅一笔向下)未必引发大级别转折。任何一次30m级别的正常回调都
+     可能把日线WEAK级别的卖点"确认"掉 → 还没到顶就出局。
+     而且旧代码对次级别卖点【不做时间嵌套检查】: 30m在日线C段开始之前的
+     旧背驰也会被当作印证 —— "区间套"三个字里的"区间"丢了。
 
-Sender credentials live here (a Gmail App Password). To change the sender, edit
-EMAIL_SENDER / EMAIL_PASSWORD. You can also override them with the environment
-variables CHAN_EMAIL_SENDER / CHAN_EMAIL_PASSWORD on the Space (recommended:
-store the App Password as a Space *secret* rather than in code).
+新逻辑 (CFG['sell_nested_interval']=True):
+  第44课区间套的本义: 大级别进入背驰段后, 在该背驰段【时间区间内】找次级别
+  的背驰段, 再在其中找次次级别的背驰段, 逐级收敛到精确转折点。
+  对日线S1/S2, 次级别印证按优先级:
+    ① 嵌套顶背驰: 30m出现S1, 且其C段顶部落在日线背驰段(最后中枢之后→当下)
+       的时间窗口内、顶部价位贴近日线C段高点 → 精确卖点, 卖在高位区。
+    ② 次级别转折确认: 30m出现S3, 或30m末笔已跌破其最近中枢下沿ZD(第92课
+       向下变盘) → 转折已确认, 偏晚但必须卖。
+    ③ 两者皆无 → 次级别动能未竭, 第24课: 顶未到 → 【不卖】(防卖飞),
+       返回 action=HOLD + sell_armed=True 进入"区间套布防"状态:
+       回测端持仓转入布防, 之后任一条件触发(嵌套背驰出现/破30m中枢ZD/
+       较布防峰值回落超阈值)即离场 —— 既不提前卖飞, 也不一路坐滑梯到三卖。
+  S3(日线三卖)不走嵌套背驰: 三卖本身就是转折确认型卖点, 维持原确认逻辑。
 """
 from __future__ import annotations
+from dataclasses import dataclass, field
+from typing import Optional
+import numpy as np
+import pandas as pd
+
+# from chan_engine import ChanAnalyzer, Signal
+
+
+# ── 卖点区间套参数 (第24/44课) ──
+NESTED_TOP_PRICE_TOL   = 0.03   # 嵌套顶背驰的顶部须贴近父级C段高点(3%以内), 否则属上一波动能
+NESTED_WINDOW_PAD_DAYS = 3      # 时间嵌套窗口的左侧容差(日)
+SELL_ARM_PEAK_DROP     = 0.04   # 布防后较峰值价回落≥4% → 顶部确认离场(回测端使用)
+SELL_ARM_DISARM_BREAK  = 0.03   # 布防后强势创新高超3%且卖点消失 → 背驰被消化, 撤防(第26课)
+
+
+def _default_make_analyzer(level, df):
+    return ChanAnalyzer(df.reset_index(drop=True))
+
+_MAKE_ANALYZER = _default_make_analyzer
+
+def set_analyzer_factory(fn):
+    global _MAKE_ANALYZER
+    _MAKE_ANALYZER = fn or _default_make_analyzer
+
+
+def resample_weekly(df_daily: pd.DataFrame) -> pd.DataFrame:
+    if df_daily.empty:
+        return df_daily.copy()
+    d = df_daily.copy()
+    d['date'] = pd.to_datetime(d['date'])
+    d = d.sort_values('date').reset_index(drop=True)
+    wk_period = d['date'].dt.to_period('W-FRI')
+    agg = {'open': 'first', 'high': 'max', 'low': 'min', 'close': 'last'}
+    if 'volume' in d.columns: agg['volume'] = 'sum'
+    if 'amount' in d.columns: agg['amount'] = 'sum'
+    g = d.groupby(wk_period, sort=True)
+    wk = g.agg(agg)
+    last_real = g['date'].max()
+    wk = wk.dropna(subset=['open', 'high', 'low', 'close']).reset_index(drop=True)
+    wk['date'] = list(last_real.values)
+    return wk
+
+
+def resample_monthly(df_daily: pd.DataFrame) -> pd.DataFrame:
+    if df_daily.empty:
+        return df_daily.copy()
+    d = df_daily.copy()
+    d['date'] = pd.to_datetime(d['date'])
+    d = d.sort_values('date').reset_index(drop=True)
+    mp = d['date'].dt.to_period('M')
+    agg = {'open': 'first', 'high': 'max', 'low': 'min', 'close': 'last'}
+    if 'volume' in d.columns: agg['volume'] = 'sum'
+    if 'amount' in d.columns: agg['amount'] = 'sum'
+    g = d.groupby(mp, sort=True)
+    mo = g.agg(agg)
+    last_real = g['date'].max()
+    mo = mo.dropna(subset=['open', 'high', 'low', 'close']).reset_index(drop=True)
+    mo['date'] = list(last_real.values)
+    return mo
+
+
+@dataclass
+class LevelView:
+    level: str
+    trend: str
+    n_pivots: int
+    n_bis: int
+    last_bi_dir: str
+    signal: Optional[Signal]
+    zg: Optional[float]
+    zd: Optional[float]
+    dif: Optional[float]
+    last_date: Optional[pd.Timestamp]
+    diagnostics: dict = field(default_factory=dict)
+
+
+@dataclass
+class MultiLevelSignal:
+    code: str
+    analysis_date: pd.Timestamp
+    weekly: LevelView
+    daily: LevelView
+    m30: Optional[LevelView]
+    action: str
+    confidence: str
+    final_kind: str
+    cur_price: float
+    chain: list = field(default_factory=list)
+    blocked_reason: str = ''
+    note: str = ''
+    confidence_reasons: list = field(default_factory=list)
+    diagnostics: dict = field(default_factory=dict)
+    monthly: Optional[LevelView] = None
+    # ── 卖点区间套布防 (第44课) ──
+    sell_armed: bool = False              # 日线S1/S2背驰已现、次级别动能未竭 → 持仓布防
+    arm_zd: Optional[float] = None        # 布防线①: 30m最近中枢下沿ZD(跌破即次级别转折确认)
+    arm_high: Optional[float] = None      # 父级背驰段C段高点(用于"新高消化背驰"撤防判定)
+
+    def explain(self) -> str:
+        lines = [f'  [{self.code}] {self.analysis_date.strftime("%Y-%m-%d")}  ¥{self.cur_price:.3f}']
+        lines.append(f'  最终: {self.action}  置信度={self.confidence}'
+                     + (f'  信号={self.final_kind}' if self.final_kind else ''))
+        lines.append('  ── 逐级裁决链 ──')
+        for lvl, concl, src in self.chain:
+            lines.append(f'    [{lvl:<7s}] {concl}')
+            if src:
+                lines.append(f'              └ 依据: {src}')
+        if self.blocked_reason:
+            lines.append(f'  ⚠ 拦截: {self.blocked_reason}')
+        if self.note:
+            lines.append(f'  说明: {self.note}')
+        if self.confidence_reasons:
+            lines.append('  置信度降档明细:')
+            for i, r in enumerate(self.confidence_reasons, 1):
+                lines.append(f'    {i}. {r}')
+        if self.diagnostics:
+            lines.append('  日线买卖点逐项诊断:')
+            for k in ('B1', 'B2', 'B3', 'S1', 'S2', 'S3'):
+                rows = self.diagnostics.get(k) or []
+                if not rows:
+                    continue
+                ok = all(str(x).startswith('✓') for x in rows)
+                lines.append(f'    {k} {"满足" if ok else "不满足"}')
+                for row in rows:
+                    lines.append(f'      {row}')
+        else:
+            lines.append('  日线买卖点逐项诊断: 未生成')
+        return '\n'.join(lines)
+
+
+class MultiLevelChan:
+    CFG = {
+        'use_monthly_gate': True,
+        'monthly_ma_filter': False,
+        'require_sublevel_sell_confirm': False,
+        'mode': 'short',
+        'zhongyin_block_buy': False,
+        'expose_m30_nosignal': False,
+        'require_60m_buy_confirm': False,  # L44区间套: 60m为日线直接次级别, 买点须经其印证
+        # L50 MACD级别选择: 看MACD要选"黄白线和柱子清晰"的级别。30m判据模糊而60m
+        # 清晰且60m已印证时, 采信60m的印证结论(避免被模糊级别的噪声误杀好买点)。
+        'l50_macd_level_select': False,
+        # ── 卖点区间套(第24/44课): 嵌套顶背驰精确定位 + 布防防卖飞 ──
+        #   True  = S1/S2用"时间嵌套的次级别顶背驰"定位高点; 未嵌套确认时不卖而布防
+        #   False = 维持旧逻辑(30m要S3 / 宽松末笔向下即卖)
+        'sell_nested_interval': True,
+        # L24: 周线上涨+日线盘整背驰的S1/S2 → 不全清, 转布防短差(撤防可骑回趋势)
+        'l24_weekly_uptrend_arm': False,  # 实测净亏(好卖点也被转布防), 默认关
+    }
+
+    # ── 速度优化: 次级别K线只取最近N根做缠论分解 ──
+    # 第17/44课: 次级别(60m/30m/15m/5m/1m)的职责是"印证当下转折", 其买卖点
+    # 只取决于最近的笔/线段/中枢结构; 几年前的分钟级历史对当下印证毫无贡献,
+    # 却让每个回测日都对上万根分钟K线重做合并/分型/笔/段, 是最大的耗时点。
+    # 截断只作用于次级别印证, 日/周/月线仍用全history(年线、月线大方向不受影响)。
+    SUB_TAIL = {'15m': 4000, '5m': 4800, '1m': 2000}
+
+    def __init__(self, df_daily, df_weekly=None, df_monthly=None, df_30m=None, df_60m=None,
+                 df_15m=None, df_5m=None, df_1m=None, code='', strict=True):
+        self.code = code
+        self.strict = strict
+        self.df_daily = df_daily.reset_index(drop=True) if not df_daily.empty else df_daily
+        self.df_30m = df_30m.reset_index(drop=True) if df_30m is not None and not df_30m.empty else None
+        self.df_60m = df_60m.reset_index(drop=True) if df_60m is not None and not df_60m.empty else None
+        self.df_15m = df_15m.reset_index(drop=True) if df_15m is not None and not df_15m.empty else None
+        self.df_5m = df_5m.reset_index(drop=True) if df_5m is not None and not df_5m.empty else None
+        self.df_1m = df_1m.reset_index(drop=True) if df_1m is not None and not df_1m.empty else None
+        self.df_weekly = df_weekly.reset_index(drop=True) if df_weekly is not None and not df_weekly.empty else None
+        self.df_monthly = df_monthly.reset_index(drop=True) if df_monthly is not None and not df_monthly.empty else None
+
+    @staticmethod
+    def _make_view(level, df, an=None, diagnose=True):
+        if an is None:
+            if df is None or len(df) < 30:
+                return None
+            try:
+                an = _MAKE_ANALYZER(level, df)
+            except Exception:
+                return None
+            if an is None:
+                return None
+        sig = an.get_signal()
+        zg = an.pivots[-1].zg if an.n_pivots > 0 else None
+        zd = an.pivots[-1].zd if an.n_pivots > 0 else None
+        return LevelView(level=level, trend=an.trend, n_pivots=an.n_pivots, n_bis=an.n_bis,
+                         last_bi_dir=an.bis[-1].direction if an.n_bis else '', signal=sig,
+                         zg=zg, zd=zd, dif=float(an.dif.iloc[-1]) if len(an.dif) else None,
+                         last_date=pd.Timestamp(df['date'].iloc[-1]),
+                         diagnostics=(an.diagnose() if diagnose else {}))
+
+    # ──────────────────────────────────────────────────────────────────
+    #  卖点区间套核心: 时间嵌套的次级别顶背驰 (第44课)
+    # ──────────────────────────────────────────────────────────────────
+    @staticmethod
+    def _parent_sell_window(parent_sig):
+        """父级(日线)背驰段的时间窗口与顶部价。
+        S1: 背驰段C段 = 最后中枢结束 → 当下; 顶 = C段高点 c_high。
+        S2: 窗口 = 一卖出现 → 当下(反抽段); 顶 = 一卖高点 prev_high。"""
+        ex = (parent_sig.extras or {}) if parent_sig is not None else {}
+        if parent_sig is None:
+            return '', '', None
+        if parent_sig.kind == 'S1':
+            w_start = ex.get('pivot_end_date') or ex.get('a_high_date') or ''
+            top = ex.get('c_high')
+        else:  # S2
+            w_start = ex.get('s1_date') or ex.get('prev_high_date') or ''
+            top = ex.get('prev_high')
+        w_end = ex.get('price_date') or ''
+        return w_start, w_end, top
+
+    def _nested_sell_check(self, sub_an, parent_sig, lvl_name, parent_kind):
+        """第44课区间套(卖点版): 在父级背驰段时间窗口内找次级别的嵌套顶背驰。
+        优先级: ①嵌套S1(精确高点, 卖在高位)
+               ②S3 / 末笔破次级别中枢ZD(转折已确认, 偏晚但必卖)
+               ③都没有 → 第24课: 次级别动能未竭, 顶未到 → 不卖(防卖飞), 转布防。
+        返回 (confirmed: bool, note: str)。"""
+        w_start, w_end, parent_top = self._parent_sell_window(parent_sig)
+
+        def in_window(dstr):
+            if not w_start or not dstr:
+                return True   # 信息不足时不因窗口否决(保守放行, 由价位贴近度把关)
+            try:
+                d = pd.Timestamp(dstr)
+                lo = pd.Timestamp(w_start) - pd.Timedelta(days=NESTED_WINDOW_PAD_DAYS)
+                hi = (pd.Timestamp(w_end) if w_end else d) + pd.Timedelta(days=1)
+                return lo <= d <= hi
+            except Exception:
+                return True
+
+        rejected = ''
+        # ① 嵌套顶背驰 S1 —— 区间套的本体: 背驰段中套背驰段
+        s1 = sub_an.detect_s1()
+        if s1 is not None:
+            ex2 = s1.extras or {}
+            td = ex2.get('c_high_date', '')
+            tp = ex2.get('c_high')
+            near_top = (parent_top is None or tp is None
+                        or tp >= parent_top * (1 - NESTED_TOP_PRICE_TOL))
+            if in_window(td) and near_top:
+                ptxt = f'(顶¥{tp:.3f}@{td})' if tp else ''
+                return True, (f'{lvl_name}嵌套顶背驰S1{ptxt}落在日线{parent_kind}背驰段窗口内 '
+                              f'—— 第44课区间套: 背驰段中套背驰段, 精确定位顶部, 卖在高位区')
+            rejected = (f'{lvl_name}虽有S1但【不嵌套】(顶@{td or "?"}不在父级背驰段'
+                        f'[{w_start}~{w_end}]窗口内, 或低于父级顶{NESTED_TOP_PRICE_TOL:.0%}以上)'
+                        f' → 属上一波的动能衰竭, 不作本次印证(防卖飞); ')
+        # ①b 父级为S2时, 次级别S2(一卖后反抽确认)也可嵌套印证
+        if parent_kind == 'S2':
+            s2 = sub_an.detect_s2()
+            if s2 is not None:
+                ex2 = s2.extras or {}
+                td = ex2.get('cur_high_date', '')
+                if in_window(td):
+                    return True, (f'{lvl_name}嵌套二卖S2(反抽顶@{td})落在日线S2窗口内 '
+                                  f'—— 第14课: 大级别二卖由次级别相应卖点定位')
+        # ② 转折已确认型: S3 / 末笔已破次级别中枢下沿
+        s3 = sub_an.detect_s3()
+        if s3 is not None:
+            return True, (f'{lvl_name}出现三类卖点S3 —— 第44课: 最后一个次级别中枢出现三卖, '
+                          f'转折已确认(偏晚, 但必须卖)')
+        try:
+            osc = sub_an.zhongshu_oscillation_monitor()
+            if osc.get('alert') and osc.get('direction') == 'down':
+                return True, (f'{lvl_name}末笔已离开其最近中枢下沿(第92课向下变盘) '
+                              f'—— 次级别转折确认, 高位区兑现')
+        except Exception:
+            pass
+        # ③ 次级别上冲动能已竭的当下确认: 末笔向下 + MACD柱已翻负(黄白线收敛下行)。
+        #    第24/44课: 区间套要的是"次级别走势的当下转折"; 末笔转下且红柱消失,
+        #    说明次级别这一冲已经结束 —— 此时日线背驰卖点立即执行, 不再等更深的破位
+        #    (这正是旧版"等30m三卖"卖在低位的病根)。只有次级别仍在上冲(末笔向上/
+        #    红柱未消)时才转入布防, 防的才是真正的"卖飞"。
+        try:
+            last_bi = sub_an.bis[-1] if sub_an.n_bis else None
+            bar_now = float(sub_an.macd_bar.iloc[-1]) if len(sub_an.macd_bar) else 0.0
+            if last_bi is not None and last_bi.direction == 'down' and bar_now < 0:
+                return True, (f'{lvl_name}末笔向下且MACD柱已翻负 —— 第24课: 次级别上冲动能已竭, '
+                              f'当下转折确认, 日线背驰卖点立即执行(不等{lvl_name}跌出三卖)')
+        except Exception:
+            pass
+        return False, (rejected + f'{lvl_name}动能未竭(末笔仍向上/MACD红柱未消): 无嵌套顶背驰/无S3 '
+                       f'→ 第24课: 次级别未转折, 大级别顶未到 → 暂不卖(防卖飞), 转入区间套布防')
+
+    def _confirm_30m_for_buy(self, m30, parent_kind=''):
+        if m30 is None or m30.n_bis < 5:
+            return False, '30分钟笔数不足(<5), 无法做次级别精确印证'
+        if parent_kind == 'B2':
+            if m30.detect_b1() is not None:
+                return True, '30分钟出现一类买点B1 —— 第14课: 大级别第二类买点由次一级别相应走势的一类买点构成'
+            if m30.detect_b2() is not None:
+                return True, '30分钟出现二类买点B2 —— 次级别一买后的回试确认, 属延后确认, 精度低于B1'
+            return False, '30分钟未出现B1/B2 —— 大级别二买缺少次级别买点确认'
+        for fn, name in ((m30.detect_b1,'B1'),(m30.detect_b3,'B3'),(m30.detect_b2,'B2')):
+            if fn() is not None:
+                return True, f'30分钟出现标准买点{name} —— 第44课: 次级别走势确认转折, 日线买点成立'
+        if self.strict:
+            return False, '30分钟未出现任何标准买点(B1/B2/B3) —— 严格模式: 第44课次级别印证未满足, 日线买点暂不成立'
+        if m30.bis[-1].direction == 'up':
+            return True, '30分钟最后一笔向上, 次级别已启动(宽松确认)'
+        return False, '30分钟最后一笔仍向下且无买点, 次级别未确认转折'
+
+    def _confirm_30m_for_sell(self, m30, parent_kind='', parent_sig=None):
+        if m30 is None or m30.n_bis < 5:
+            return False, '30分钟笔数不足(<5), 无法做次级别精确印证'
+        # ── 新: 卖点区间套(第24/44课) —— S1/S2用嵌套顶背驰定位高点 ──
+        if (self.CFG.get('sell_nested_interval') and parent_sig is not None
+                and parent_kind in ('S1', 'S2')):
+            return self._nested_sell_check(m30, parent_sig, '30分钟', parent_kind)
+        # ── 旧逻辑(S3父级 / 开关关闭时) ──
+        if parent_kind == 'S2':
+            if m30.detect_s1() is not None:
+                return True, '30分钟出现一类卖点S1 —— 大级别第二类卖点由次一级别相应走势的一类卖点精确定位'
+            if m30.detect_s2() is not None:
+                return True, '30分钟出现二类卖点S2 —— 次级别一卖后的反抽确认, 属延后确认, 精度低于S1'
+            return False, '30分钟未出现S1/S2 —— 大级别二卖缺少次级别卖点确认'
+        if m30.detect_s3() is not None:
+            return True, '30分钟出现三类卖点S3 —— 严格满足第44课"小背驰-大转折定理"的必要条件(最后一个次级别中枢出现三卖)'
+        if self.strict:
+            return False, '30分钟未出现三类卖点S3 —— 严格模式: 第44课明确要求"最后一个次级别中枢出现三卖", 必要条件未满足, 日线卖点不构成大级别转��'
+        if m30.detect_s1() is not None:
+            return True, '30分钟出现一类卖点(顶背驰), 次级别转折确认(宽松)'
+        if m30.bis[-1].direction == 'down':
+            return True, '30分钟最后一笔向下, 次级别已转弱(宽松确认)'
+        return False, '30分钟未出现卖点且最后一笔仍向上, 次级别未确认转折'
+
+    def _confirm_finer(self, an, is_buy, lvl_name, parent_name, parent_kind='', parent_sig=None):
+        if an is None or an.n_bis < 5:
+            return False, f'{lvl_name}笔数不足(<5), 无法做次级别精确印证'
+        if is_buy:
+            if parent_kind == 'B2':
+                if an.detect_b1() is not None:
+                    return True, f'{lvl_name}出现B1 —— 第14课: {parent_name}二买由次一级别一买构成'
+                if an.detect_b2() is not None:
+                    return True, f'{lvl_name}出现B2 —— 次级别一买后的回试确认, 属延后确认, 精度低于B1'
+                return False, f'{lvl_name}未出现B1/B2 —— {parent_name}二买缺少次级别买点确认'
+            for fn, name in ((an.detect_b1,'B1'),(an.detect_b3,'B3'),(an.detect_b2,'B2')):
+                if fn() is not None:
+                    return True, f'{lvl_name}出现标准买点{name} —— 第44课逐级处理: {lvl_name}走势确认{parent_name}的转折'
+            if self.strict:
+                return False, f'{lvl_name}未出现标准买点(B1/B2/B3) —— 严格模式: 末级印证未满足, 信号降级'
+            if an.bis[-1].direction == 'up':
+                return True, f'{lvl_name}最后一笔向上, 次级别已启动(宽松确认)'
+            return False, f'{lvl_name}最后一笔仍向下且无买点, 末级未确认, 信号降级'
+        else:
+            # ── 新: 卖点区间套向更细级别逐级传递(同一父级背驰段窗口) ──
+            if (self.CFG.get('sell_nested_interval') and parent_sig is not None
+                    and parent_kind in ('S1', 'S2')):
+                ok, note = self._nested_sell_check(an, parent_sig, lvl_name, parent_kind)
+                if ok:
+                    return True, note + f' —— 第44课逐级处理: {lvl_name}确认{parent_name}的转折'
+                return False, note
+            if parent_kind == 'S2':
+                if an.detect_s1() is not None:
+                    return True, f'{lvl_name}出现S1 —— {parent_name}二卖由次一级别一卖精确定位'
+                if an.detect_s2() is not None:
+                    return True, f'{lvl_name}出现S2 —— 次级别一卖后的反抽确认, 属延后确认, 精度低于S1'
+                return False, f'{lvl_name}未出现S1/S2 —— {parent_name}二卖缺少次级别卖点确认'
+            if an.detect_s3() is not None:
+                return True, f'{lvl_name}出现三类卖点S3 —— 第44课逐级处理: {lvl_name}走势确认{parent_name}的转折'
+            if self.strict:
+                return False, f'{lvl_name}未出现三类卖点S3 —— 严格模式: 末级印证未满足, 信号降级'
+            if an.detect_s1() is not None:
+                return True, f'{lvl_name}出现一类卖点(顶背驰), 次级别转折确认(宽松)'
+            if an.bis[-1].direction == 'down':
+                return True, f'{lvl_name}最后一笔向下, 次级别已转弱(宽松确认)'
+            return False, f'{lvl_name}未出现卖点且最后一笔仍向上, 末级未确认, 信号降级'
+
+    def _confirm_5m(self, m5, is_buy, parent_kind='', parent_sig=None):
+        return self._confirm_finer(m5, is_buy, '5分钟', '30分钟', parent_kind, parent_sig)
+
+    def _confirm_1m(self, m1, is_buy, parent_kind='', parent_sig=None):
+        return self._confirm_finer(m1, is_buy, '1分钟', '5分钟', parent_kind, parent_sig)
+
+    def analyze(self, analysis_date=None, positions=None):
+        if self.df_daily.empty or len(self.df_daily) < 30:
+            return None
+        df_d = self.df_daily
+        if analysis_date is not None:
+            analysis_date = pd.Timestamp(analysis_date)
+            df_d = df_d[df_d['date'] <= analysis_date].reset_index(drop=True)
+        if len(df_d) < 30:
+            return None
+        last_date = pd.Timestamp(df_d['date'].iloc[-1])
+        cur_price = float(df_d['close'].iloc[-1])
+
+        if self.df_weekly is not None:
+            df_w = self.df_weekly[self.df_weekly['date'] <= last_date].reset_index(drop=True)
+        else:
+            df_w = resample_weekly(df_d)
+        if self.df_monthly is not None:
+            df_mo = self.df_monthly[self.df_monthly['date'] <= last_date].reset_index(drop=True)
+        else:
+            df_mo = resample_monthly(df_d)
+        _tail = self.SUB_TAIL or {}
+        def _cut_sub(df, lvl):
+            if df is None:
+                return None
+            sub = df[df['date'] <= last_date + pd.Timedelta(days=1)]
+            n = _tail.get(lvl, 0)
+            if n and len(sub) > n:
+                sub = sub.tail(n)
+            return sub.reset_index(drop=True)
+        df_6  = _cut_sub(self.df_60m, '60m')
+        df_m  = _cut_sub(self.df_30m, '30m')
+        df_15 = _cut_sub(self.df_15m, '15m')
+        df_5  = _cut_sub(self.df_5m, '5m')
+        df_1  = _cut_sub(self.df_1m, '1m')
 
-import os
-import json
-import html
-import logging
-import smtplib
-import urllib.request
-import urllib.error
-import re
-from datetime import datetime
-from email.mime.text import MIMEText
-from email.mime.multipart import MIMEMultipart
-from email.header import Header
-from email.utils import formataddr
-
-logger = logging.getLogger("chan_emailer")
-
-# ── Transport 1 (preferred on HF): Resend HTTPS API on port 443 ──
-# HF Spaces block outbound SMTP ports (465/587) → SMTP fails with
-# "Network is unreachable". The Resend REST API uses plain HTTPS, which Spaces
-# allow. Set a Space secret RESEND_API_KEY to enable it. Free tier ≈ 100/day.
-# Until you verify your own domain, Resend only lets you send FROM
-# "onboarding@resend.dev" — that's the default sender below.
-RESEND_API_KEY = os.environ.get("RESEND_API_KEY", "")
-RESEND_FROM = os.environ.get("RESEND_FROM", "Chan Compass <onboarding@resend.dev>")
-
-# ── Transport 2 (fallback, works off-HF): classic SMTP ──
-EMAIL_SENDER = os.environ.get("CHAN_EMAIL_SENDER", "")
-EMAIL_PASSWORD = os.environ.get("CHAN_EMAIL_PASSWORD", "")
-
-SMTP_CONFIGS = {
-    "gmail.com":   {"server": "smtp.gmail.com",     "port": 465, "ssl": True},
-    "qq.com":      {"server": "smtp.qq.com",        "port": 465, "ssl": True},
-    "163.com":     {"server": "smtp.163.com",       "port": 465, "ssl": True},
-    "126.com":     {"server": "smtp.126.com",       "port": 465, "ssl": True},
-    "outlook.com": {"server": "smtp.office365.com", "port": 587, "ssl": False},
-    "hotmail.com": {"server": "smtp.office365.com", "port": 587, "ssl": False},
-    "foxmail.com": {"server": "smtp.qq.com",        "port": 465, "ssl": True},
-    "sina.com":    {"server": "smtp.sina.com",      "port": 465, "ssl": True},
-    "aliyun.com":  {"server": "smtp.aliyun.com",    "port": 465, "ssl": True},
-}
-
-_EMAIL_RE = re.compile(r"^[^@\s]+@[^@\s]+\.[^@\s]+$")
-
-
-def _sender_address(sender: str) -> str:
-    return formataddr((str(Header("Chan Compass", "utf-8")), sender))
-
-
-def _md_to_plain(text: str) -> str:
-    """Markdown -> readable plain text (for the text/plain MIME part and the
-    Resend `text` field). Strips #/**/| noise so text-only clients look clean."""
-    lines, out = text.split("\n"), []
-    i, n = 0, len(lines)
-    while i < n:
-        line = lines[i]
-        if "|" in line and i + 1 < n and re.match(r"^\s*\|?[\s:\-|]+\|?\s*$", lines[i + 1]):
-            header = [c.strip() for c in line.strip().strip("|").split("|")]
-            i += 2
-            while i < n and "|" in lines[i]:
-                cells = [c.strip() for c in lines[i].strip().strip("|").split("|")]
-                if len(header) == 2 and len(cells) == 2:
-                    out.append(f"  {cells[0]}: {cells[1]}")
-                else:
-                    out.append("  " + "  |  ".join(cells))
-                i += 1
-            out.append("")
-            continue
-        m = re.match(r"^(#{1,4})\s+(.*)$", line)
-        if m:
-            title = m.group(2).strip()
-            out.append("")
-            out.append(title.upper() if len(m.group(1)) <= 2 else title)
-            out.append("-" * min(len(title), 60))
-            i += 1
-            continue
-        if line.strip() in ("---", "***", "___"):
-            out.append("-" * 40)
-            i += 1
-            continue
-        s = re.sub(r"\*\*(.+?)\*\*", r"\1", line)
-        s = re.sub(r"`(.+?)`", r"\1", s)
-        s = re.sub(r"\[(.+?)\]\((https?://[^\s)]+)\)", r"\1 (\2)", s)
-        s = re.sub(r"^_(.+)_$", r"\1", s.strip())
-        out.append(s)
-        i += 1
-    txt = "\n".join(out)
-    return re.sub(r"\n{3,}", "\n\n", txt).strip()
-
-
-def _inline_md(s: str) -> str:
-    s = html.escape(s)
-    s = re.sub(r"\*\*(.+?)\*\*", r"<strong>\1</strong>", s)
-    s = re.sub(r"(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)", r"<em>\1</em>", s)
-    s = re.sub(r"`(.+?)`", r"<code>\1</code>", s)
-    s = re.sub(r"\[(.+?)\]\((https?://[^\s)]+)\)",
-               r'<a href="\2">\1</a>', s)
-    return s
-
-
-def _md_to_html(text: str) -> str:
-    """Minimal but correct Markdown → HTML (headings, tables, lists, bold,
-    code, links). The reports are Markdown, so emailing them as preformatted
-    text showed raw `#`/`|` symbols — this renders them properly."""
-    lines = text.split("\n")
-    out, i, n = [], 0, len(lines)
-    while i < n:
-        line = lines[i]
-        # table block: a header row of pipes followed by a |---| separator
-        if "|" in line and i + 1 < n and re.match(r"^\s*\|?[\s:\-|]+\|?\s*$", lines[i + 1]):
-            header = [c.strip() for c in line.strip().strip("|").split("|")]
-            i += 2
-            rows = []
-            while i < n and "|" in lines[i]:
-                rows.append([c.strip() for c in lines[i].strip().strip("|").split("|")])
-                i += 1
-            th = "".join(f"<th style='text-align:left;padding:6px 10px;"
-                         f"border-bottom:2px solid #ddd'>{_inline_md(c)}</th>" for c in header)
-            trs = ""
-            for r in rows:
-                tds = "".join(f"<td style='padding:6px 10px;border-bottom:1px solid #eee'>"
-                              f"{_inline_md(c)}</td>" for c in r)
-                trs += f"<tr>{tds}</tr>"
-            out.append(f"<table style='border-collapse:collapse;margin:10px 0;"
-                       f"font-size:13px'><thead><tr>{th}</tr></thead><tbody>{trs}</tbody></table>")
-            continue
-        m = re.match(r"^(#{1,4})\s+(.*)$", line)
-        if m:
-            lvl = len(m.group(1))
-            size = {1: 20, 2: 16, 3: 14, 4: 13}[lvl]
-            out.append(f"<h{lvl} style='font-size:{size}px;margin:14px 0 6px;"
-                       f"color:#0265DC'>{_inline_md(m.group(2))}</h{lvl}>")
-            i += 1
-            continue
-        if re.match(r"^\s*[-*]\s+", line):
-            items = []
-            while i < n and re.match(r"^\s*[-*]\s+", lines[i]):
-                item_text = re.sub(r"^\s*[-*]\s+", "", lines[i])
-                items.append(f"<li>{_inline_md(item_text)}</li>")
-                i += 1
-            out.append(f"<ul style='margin:6px 0 6px 18px'>{''.join(items)}</ul>")
-            continue
-        if line.strip() in ("---", "***", "___"):
-            out.append("<hr style='border:none;border-top:1px solid #e3e6ea;margin:12px 0'>")
-            i += 1
-            continue
-        if line.strip() == "":
-            out.append("<div style='height:6px'></div>")
-            i += 1
-            continue
-        out.append(f"<p style='margin:4px 0'>{_inline_md(line)}</p>")
-        i += 1
-    body = "".join(out)
-    return (
-        '<html><body style="margin:0;padding:18px;background:#f6f7f9;">'
-        '<div style="font-family:-apple-system,Segoe UI,Roboto,sans-serif;'
-        'font-size:14px;line-height:1.55;color:#1a1a1a;background:#ffffff;'
-        'padding:22px 26px;border-radius:12px;border:1px solid #e3e6ea;'
-        'max-width:780px;margin:0 auto;">'
-        f'{body}'
-        '<p style="font-size:11px;color:#8a8a8a;margin:16px 0 0;border-top:'
-        '1px solid #eee;padding-top:10px;">Sent by Chan Compass · educational '
-        'tool, not investment advice.</p>'
-        '</div></body></html>'
-    )
-
-
-def _parse_recipients(raw: str) -> list:
-    parts = re.split(r"[,;\s]+", (raw or "").strip())
-    return [p for p in parts if _EMAIL_RE.match(p)]
-
-
-def _close(server):
-    if server is not None:
+        wv = self._make_view('weekly', df_w, diagnose=False)
+        mov = self._make_view('monthly', df_mo, diagnose=False) if self.CFG.get('use_monthly_gate') else None
+        daily_an = None
         try:
-            server.quit()
+            if len(df_d) >= 30:
+                daily_an = _MAKE_ANALYZER('daily', df_d)
         except Exception:
+            daily_an = None
+        dv = self._make_view('daily', df_d, an=daily_an, diagnose=False) if daily_an is not None \
+            else self._make_view('daily', df_d, diagnose=False)
+
+        m60_an = None
+        m60_built = False
+        def _get_m60():
+            nonlocal m60_an, m60_built
+            if not m60_built:
+                m60_built = True
+                if df_6 is not None and len(df_6) >= 30:
+                    try: m60_an = _MAKE_ANALYZER('60m', df_6)
+                    except Exception: m60_an = None
+            return m60_an
+
+        m30_an = None
+        m30_built = False
+        def _get_m30():
+            nonlocal m30_an, m30_built
+            if not m30_built:
+                m30_built = True
+                if df_m is not None and len(df_m) >= 30:
+                    try: m30_an = _MAKE_ANALYZER('30m', df_m)
+                    except Exception: m30_an = None
+            return m30_an
+
+        def _mv():
+            an = _get_m30()
+            if an is None:
+                return None
+            return self._make_view('30m', df_m, an=an, diagnose=False)
+
+        diagnostics = daily_an.diagnose() if daily_an is not None else {}
+
+        chain = []
+        yearline_dir = 'unknown'; yearline_val = None
+        if len(df_d) >= 60:
+            _n = min(250, len(df_d))
+            yearline_val = float(df_d['close'].tail(_n).mean()) if _n >= 20 else None
+            _ma = df_d['close'].rolling(min(250, len(df_d)), min_periods=20).mean()
+            if len(_ma) and not pd.isna(_ma.iloc[-1]):
+                yearline_val = float(_ma.iloc[-1])
+        if yearline_val is not None:
+            above = cur_price >= yearline_val
+            yearline_dir = 'above' if above else 'below'
+            ytxt = (f'现价¥{cur_price:.3f} {"≥" if above else "<"} 年线MA250 ¥{yearline_val:.3f} '
+                    f'→ {"站上年线, 长线可做多" if above else "年线下方, 第106课不做多(只看反弹/卖点)"}')
+            chain.append(('年线', ytxt,
+                          '第7/106课: 年线(MA250)是长线生命线; 站上才考虑做多, 跌破年线长线转空'))
+        else:
+            chain.append(('年线', '日线历史不足, 年线MA250 暂不可用', '第7/106课'))
+
+        monthly_dir = 'unknown'
+        if mov is not None:
+            monthly_dir = mov.trend
+            chain.append(('monthly', f'{monthly_dir}  (月线定大方向: L69 月线看最实质大方向)',
+                          '第69/108课: 月线分型/笔/线段确定中期大方向; 底部=第一类买点到中枢首次走出三买前'))
+            if self.CFG.get('monthly_ma_filter') and len(df_mo) >= 5:
+                ma5_m = float(df_mo['close'].tail(5).mean())
+                if cur_price < ma5_m and monthly_dir != 'down_trend':
+                    monthly_dir = 'down_trend'
+                    chain.append(('monthly', f'价({cur_price:.2f})在5月线({ma5_m:.2f})下 → 大方向按偏空处理',
+                                  '第106课: 5月线是长线的关键, 牛市第一轮调整不跌破5月线'))
+
+        if wv is None:
+            chain.append(('weekly', '周线数据不足(<30根), 方向未知', ''))
+            weekly_dir = 'unknown'
+        else:
+            weekly_dir = wv.trend
+            dir_txt = {'up_trend':'上涨趋势 → 日线只接受【买点】','down_trend':'下跌趋势 → 日线只接受【卖点】/观望',
+                       'consolidation':'盘整 → 日线买卖点都看,但降级'}.get(weekly_dir, weekly_dir)
+            chain.append(('weekly', f'{weekly_dir}  {dir_txt}',
+                          '第43课: 大级别走势类型限定小级别的操作方向; 不允许"上涨+上涨""下跌+下跌"'))
+
+        if dv is None:
+            return None
+        daily_sig = dv.signal
+        if daily_sig is None:
+            chain.append(('daily', f'{dv.trend}, 无买卖点信号', ''))
+        else:
+            chain.append(('daily', f'出现 {daily_sig.kind}: {daily_sig.reason[:400]}', '第21课: 买卖点完备性定理'))
+
+        if daily_sig is None:
+            action, conf, note = self._no_signal_decision(wv, dv, cur_price)
+            m30_ns = _mv() if self.CFG.get('expose_m30_nosignal') else None
+            return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=m30_ns,
+                                    action=action, confidence=conf, final_kind='', cur_price=cur_price, chain=chain, note=note,
+                                    diagnostics=diagnostics, monthly=mov)
+
+        is_buy = daily_sig.kind in ('B1','B2','B3')
+        is_sell = daily_sig.kind in ('S1','S2','S3')
+
+        if self.CFG.get('zhongyin_block_buy') and is_buy and daily_sig.kind != 'B3' and daily_an is not None:
+            zy = daily_an.in_zhongyin()
+            if zy.get('in_zhongyin'):
+                chain.append(('中阴', f'第88-90课: 当前处中阴(方向未定+BOLL收口) → 暂不开新仓: {zy["reason"][:120]}', '第89课: 中阴阶段方向未定, 不宜开新仓'))
+                return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=None,
+                                        action='WATCH', confidence='LOW', final_kind=daily_sig.kind, cur_price=cur_price,
+                                        chain=chain, blocked_reason='中阴方向未定', note='中阴阶段暂不开仓(L88-90)',
+                                        diagnostics=diagnostics, monthly=mov)
+
+        if positions:
+            fail_kinds = []
+            for bk, pos in positions.items():
+                stop = pos.get('stop_px')
+                if stop is not None and cur_price < stop:
+                    fail_kinds.append(bk)
+            if fail_kinds:
+                chain.append(('证伪', f'持仓{"/".join(fail_kinds)}跌破建仓日锁定止损线 → 清仓', '第13/20课: 买点结构被破坏即证伪'))
+                return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
+                                        action='SELL', confidence='HIGH', final_kind='STOP', cur_price=cur_price,
+                                        chain=chain, note='结构证伪止损, 次日清仓',
+                                        diagnostics=diagnostics, monthly=mov)
+
+        blocked = ''
+        downgrade = False
+        if weekly_dir == 'up_trend' and is_sell:
+            downgrade = True
+            chain.append(('联立','周线上涨 + 日线卖点 → 第44课: 小级别(日线)顶背驰未必引发大级别(周线)转折, 卖点降级为"减仓/短差"',
+                          '第24课: 日线背驰除非周线同时背驰,否则不制造周线大顶'))
+        elif weekly_dir == 'down_trend' and is_buy:
+            if daily_sig.kind in ('B1','B2'):
+                chain.append(('联立','周线下跌 + 日线一/二买 → 下跌趋势的转折尝试, 必须由30分钟严格印证','第29课: 下跌的转折=上涨或盘整, 由背驰导致'))
+            else:
+                blocked = '周线下跌��势中出现日线三买 —— 第43课: 三买属上涨结构, 与周线下跌矛盾, 大概率是下跌中继的假三买'
+        elif monthly_dir == 'down_trend' and is_buy and daily_sig.kind == 'B3' and not blocked:
+            blocked = '月线下跌大方向中出现日线三买 —— 第43/69课: 三买属上涨结构, 与月线大方向矛盾, 大概率假三买'
+        elif weekly_dir == 'up_trend' and is_buy:
+            chain.append(('联立','周线上涨 + 日线买点 → 方向一致, 进入30分钟精确定位','第43课: 大小级别同向, 操作最顺'))
+        elif weekly_dir == 'down_trend' and is_sell:
+            chain.append(('联立','周线下跌 + 日线卖点 → 方向一致, 趋势性卖出','第43课: 大小级别同向'))
+        elif weekly_dir == 'consolidation':
+            downgrade = True
+            chain.append(('联立','周线盘整 → 日线信号有效但降级(盘整中买卖点力度弱)','第29课: 盘整中的转折力度弱于趋势'))
+
+        # ── 周线二买 → 日线一买精确定位锚 (第14/17课) ──
+        if is_buy and wv is not None and wv.signal is not None \
+                and getattr(wv.signal, 'kind', '') == 'B2':
+            _dex = (daily_sig.extras or {}) if daily_sig is not None else {}
+            _anchor = _dex.get('b1_price') or _dex.get('cur_low')
+            if _anchor:
+                daily_sig.extras = dict(_dex)
+                daily_sig.extras['weekly_b2_daily_b1_anchor'] = float(_anchor)
+                chain.append(('联立',
+                              f'✓ 周线二买 + 日线买点共振: 周线B2由日线一买构成(第14课), '
+                              f'定位锚=日线一买位¥{float(_anchor):.3f}, 跌破该锚则周线二买证伪',
+                              '第17课: 大级别买点的精确定位要落到次级别的具体买点价位'))
+            else:
+                chain.append(('联立',
+                              '周线二买成立但日线尚无可定位的一买锚 → 等日线给出一买价位再重仓',
+                              '第14课'))
+
+        if blocked:
+            return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
+                                    action='WATCH', confidence='NONE', final_kind=daily_sig.kind, cur_price=cur_price,
+                                    chain=chain, blocked_reason=blocked, note='周线方向闸门拦截, 不操作',
+                                    diagnostics=diagnostics, monthly=mov)
+
+        m60_an = _get_m60()
+        ok60 = False
+        if m60_an is not None:
+            if is_buy:
+                ok60, note60 = self._confirm_finer(m60_an, True, '60分钟', '日线', daily_sig.kind)
+            else:
+                ok60, note60 = self._confirm_finer(m60_an, False, '60分钟', '日线', daily_sig.kind,
+                                                   parent_sig=daily_sig)
+            chain.append(('60m', ('✓ 次级别确认: ' if ok60 else '✗ 次级别未确认(降级): ')+note60,
+                          '第44课: 区间套 —— 日线的转折先由直接次级别60分钟走势确认'))
+            if not ok60:
+                downgrade = True
+                if self.CFG.get('require_60m_buy_confirm') and is_buy and daily_sig.kind in ('B1', 'B2'):
+                    return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
+                                            action='WATCH', confidence='LOW', final_kind=daily_sig.kind, cur_price=cur_price,
+                                            chain=chain, blocked_reason='60分钟直接次级别未印证买点(L44区间套)',
+                                            note=f'日线{daily_sig.kind}买点但60m未现B1/B2 → 等直接次级别印证再动手',
+                                            diagnostics=diagnostics, monthly=mov)
+        else:
+            if df_6 is not None:
+                chain.append(('60m', '60分钟数据不足(<30根) → 跳过该级印证', '第44课: 区间套逐级确认'))
+
+        m30_an = _get_m30()
+        if m30_an is None:
+            chain.append(('30m','无30分钟数据 → 缺少次级别精确印证, 信号降级','第44课: 操作级别的买卖点需次级别走势确认'))
+            confirmed = False; confirm_note = '缺30分钟数据'; downgrade = True
+        else:
+            if is_buy:
+                confirmed, confirm_note = self._confirm_30m_for_buy(m30_an, daily_sig.kind)
+            else:
+                confirmed, confirm_note = self._confirm_30m_for_sell(m30_an, daily_sig.kind,
+                                                                     parent_sig=daily_sig)
+            chain.append(('30m', ('✓ 次级别确认: ' if confirmed else '✗ 次级别未确认: ')+confirm_note, '第44课: 小背驰-大转折定理(必要条件)'))
+
+        # ── 60m嵌套印证补位 (第44课区间套, 卖点版) ──
+        # 30m动能未竭但60m(日线的直接���级别)已给出嵌套顶背驰/转折确认 → 采信60m。
+        # 日线的"次级别"本就是60m; 30m是60m的次级别, 不应让更细级别一票否决直接次级别。
+        if (self.CFG.get('sell_nested_interval') and is_sell and not confirmed
+                and ok60 and daily_sig.kind in ('S1', 'S2')):
+            confirmed = True
+            confirm_note = '30m动能未竭, 但60m(日线直接次级别)已嵌套印证 → 采信60m(第44课: 逐级处理, 直接次级别优先)'
+            chain.append(('联立', '✓ ' + confirm_note, '第44课区间套'))
+
+        # ── L50 MACD级别选择: 选黄白线和柱子清晰的级别看MACD ──
+        if (self.CFG.get('l50_macd_level_select') and is_buy and not confirmed
+                and ok60 and m60_an is not None and m30_an is not None):
             try:
-                server.close()
+                c60 = m60_an.macd_clarity(); c30 = m30_an.macd_clarity()
+                if c30['score'] < 0.4 and c60['score'] >= max(0.4, c30['score'] * 1.5):
+                    confirmed = True
+                    chain.append(('联立',
+                                  f"✓ L50 MACD级别选择: 30m MACD{c30['label']}(清晰度{c30['score']}) 判据不可靠; "
+                                  f"60m MACD{c60['label']}(清晰度{c60['score']})且60m已印证买点 → 采信60m结论",
+                                  '第50课: 看MACD要选黄白线和柱子走势清晰的级别'))
             except Exception:
                 pass
 
+        m15_an = None; m15_confirmed = None
+        if confirmed and df_15 is not None and len(df_15) >= 30:
+            try: m15_an = _MAKE_ANALYZER('15m', df_15)
+            except Exception: m15_an = None
+        if not confirmed:
+            pass
+        elif df_15 is None:
+            pass
+        elif m15_an is None:
+            chain.append(('15m','15分钟数据不足(<30根) → 跳过该级印证','第44课: 区间套逐级确认'))
+        else:
+            ok15, note15 = self._confirm_finer(m15_an, is_buy, '15分钟', '30分钟', daily_sig.kind,
+                                               parent_sig=(daily_sig if is_sell else None))
+            m15_confirmed = ok15
+            chain.append(('15m', ('✓ 次级别确认: ' if ok15 else '✗ 次级别未确认(降级,不拦截): ')+note15,
+                          '第44课: 逐级处理 —— 30分钟的转折由15分钟走势确认'))
+            if not ok15: downgrade = True
 
-def _send_via_resend(recipients: list, subject: str, content: str) -> str:
-    """HTTPS POST to Resend — works on HF (port 443). Returns '' on success."""
-    payload = json.dumps({
-        "from": RESEND_FROM,
-        "to": recipients,
-        "subject": subject,
-        "text": _md_to_plain(content),
-        "html": _md_to_html(content),
-    }).encode("utf-8")
-    req = urllib.request.Request(
-        "https://api.resend.com/emails", data=payload, method="POST",
-        headers={"Authorization": f"Bearer {RESEND_API_KEY}",
-                 "Content-Type": "application/json",
-                 # Resend/Cloudflare reject requests with no User-Agent
-                 # (403, error code 1010) before they reach the API.
-                 "User-Agent": "chan-compass/1.0 (+https://huggingface.co/spaces)"})
-    try:
-        with urllib.request.urlopen(req, timeout=30) as resp:
-            body = resp.read().decode("utf-8", "ignore")
-        if '"id"' in body:
-            return ""
-        return f"Resend API responded without an id: {body[:200]}"
-    except urllib.error.HTTPError as e:
-        detail = e.read().decode("utf-8", "ignore")[:200]
-        return f"Resend HTTP {e.code}: {detail}"
-    except Exception as e:
-        return f"Resend request failed: {e}"
-
-
-def _send_via_smtp(recipients: list, subject: str, content: str) -> str:
-    """Classic SMTP — works locally / off-HF. Returns '' on success."""
-    if not EMAIL_SENDER or not EMAIL_PASSWORD:
-        return "SMTP sender not configured."
-    msg = MIMEMultipart("alternative")
-    msg["Subject"] = Header(subject, "utf-8")
-    msg["From"] = _sender_address(EMAIL_SENDER)
-    msg["To"] = ", ".join(recipients)
-    msg.attach(MIMEText(_md_to_plain(content), "plain", "utf-8"))
-    msg.attach(MIMEText(_md_to_html(content), "html", "utf-8"))
-    domain = EMAIL_SENDER.split("@")[-1].lower()
-    sc = SMTP_CONFIGS.get(domain, {"server": f"smtp.{domain}", "port": 465, "ssl": True})
-    server = None
-    try:
-        if sc["ssl"]:
-            server = smtplib.SMTP_SSL(sc["server"], sc["port"], timeout=20)
+        m5_an = None; m5_confirmed = None
+        if confirmed and df_5 is not None and len(df_5) >= 30:
+            try: m5_an = _MAKE_ANALYZER('5m', df_5)
+            except Exception: m5_an = None
+        if not confirmed:
+            pass
+        elif df_5 is None:
+            chain.append(('5m','无5分钟数据 → 缺该级逐级印证, 信号降级','第44课: 15分钟的转折需5分钟走势逐级确认')); downgrade = True
+        elif m5_an is None:
+            chain.append(('5m','5分钟数据不足(<30根) → 缺该级印证, 信号降级','第44课: 15分钟的转折需5分钟走势逐级确认')); downgrade = True
         else:
-            server = smtplib.SMTP(sc["server"], sc["port"], timeout=20)
-            server.starttls()
-        server.login(EMAIL_SENDER, EMAIL_PASSWORD)
-        server.send_message(msg)
-        return ""
-    except smtplib.SMTPAuthenticationError:
-        return "SMTP authentication failed (check sender / App Password)."
-    except OSError as e:
-        return f"SMTP network error: {e}"
-    except Exception as e:
-        return f"SMTP failed: {e}"
-    finally:
-        _close(server)
-
-
-def send_result(content: str, recipients_raw: str, subject_tag: str) -> str:
-    """Send `content` to the address(es). Prefers the Resend HTTPS API (works on
-    HF Spaces); falls back to SMTP. English status string for the UI."""
-    if not content or not content.strip():
-        return "⚠️ Nothing to send yet — generate a result first."
-    if content.strip().startswith(("⏳", "🤖 _", "Run ", "Enter ", "Select ")):
-        return "⚠️ Wait for the AI result to finish, then send."
-    recipients = _parse_recipients(recipients_raw)
-    if not recipients:
-        return "⚠️ Enter a valid email address (e.g. name@example.com)."
-
-    subject = (f"Chan Compass · {subject_tag} · "
-               f"{datetime.now().strftime('%Y-%m-%d %H:%M')}")
-
-    errors = []
-    if RESEND_API_KEY:
-        err = _send_via_resend(recipients, subject, content)
-        if not err:
-            return f"✅ Sent to {', '.join(recipients)} (via Resend API)."
-        errors.append(err)
-    smtp_err = _send_via_smtp(recipients, subject, content)
-    if not smtp_err:
-        return f"✅ Sent to {', '.join(recipients)} (via SMTP)."
-    errors.append(smtp_err)
-
-    if not RESEND_API_KEY:
-        return ("❌ SMTP is blocked on Hugging Face Spaces (outbound mail ports "
-                "are closed). Fix: create a free key at resend.com and add it as "
-                "a Space secret named **RESEND_API_KEY** (then it sends over "
-                f"HTTPS). Detail: {smtp_err}")
-    return "❌ Send failed. " + " | ".join(errors)
+            ok5, note5 = self._confirm_5m(m5_an, is_buy, daily_sig.kind,
+                                          parent_sig=(daily_sig if is_sell else None))
+            m5_confirmed = ok5
+            chain.append(('5m', ('✓ 次级别确认: ' if ok5 else '✗ 次级别未确认(降级,不拦截): ')+note5, '第44课: 逐级处理 —— 15分钟的转折由5分钟走势确认'))
+            if not ok5: downgrade = True
+
+        m1_an = None; m1_confirmed = None
+        do_1m = confirmed and (m5_confirmed is True)
+        if do_1m and df_1 is not None and len(df_1) >= 30:
+            try: m1_an = _MAKE_ANALYZER('1m', df_1)
+            except Exception: m1_an = None
+        if not do_1m:
+            pass
+        elif df_1 is None:
+            chain.append(('1m','无1分钟数据 → 缺区间套最末级印证, 信号降级','第44课: 区间套 —— 5分钟的转折需1分钟走势逐级确认')); downgrade = True
+        elif m1_an is None:
+            chain.append(('1m','1分钟数据不足(<30根) → 缺最末级印证, 信号降级','第44课: 区间套 —— 5分钟的转折需1分钟走势逐级确认')); downgrade = True
+        else:
+            ok1, note1 = self._confirm_1m(m1_an, is_buy, daily_sig.kind,
+                                          parent_sig=(daily_sig if is_sell else None))
+            m1_confirmed = ok1
+            chain.append(('1m', ('✓ 末级确认: ' if ok1 else '✗ 末级未确认(降级,不拦截): ')+note1, '第44课: 区间套 —— 5分钟的转折由1分钟走势确认'))
+            if not ok1: downgrade = True
+
+        # ── L24规则: 周线上涨 + 日线【盘整背驰】(非趋势背驰)的S1/S2 ──
+        # 第24课: 某级别的背驰导致该级别的转折; 日线背驰若周线未同步背驰,
+        # 只构成日线级别的调整, 不是大顶 → 不全清仓, 转入区间套布防做短差:
+        # 真转折由布防线(嵌套背驰/破30m中枢ZD/峰值回落)兜底, 趋势延续则由
+        # 撤防机制(强势新高消化背驰, 第26课)继续骑中枢上移(第91课①)。
+        if (self.CFG.get('sell_nested_interval') and self.CFG.get('l24_weekly_uptrend_arm')
+                and is_sell and daily_sig.kind in ('S1', 'S2') and weekly_dir == 'up_trend'):
+            _dg = getattr(daily_sig, 'diverge_grade', None)
+            if _dg is not None and not getattr(_dg, 'is_trend_divergence', False):
+                _arm_zd = (m30_an.pivots[-1].zd if (m30_an is not None and m30_an.n_pivots) else None)
+                _ex = daily_sig.extras or {}
+                _arm_high = _ex.get('c_high') or _ex.get('prev_high') or cur_price
+                chain.append(('L24', f'周线上涨 + 日线{daily_sig.kind}仅为盘整背驰(非趋势背驰) '
+                              f'→ 第24课: 不构成周线级别大顶, 不全清 → 转区间套布防短差'
+                              f'(布防线: 30m中枢ZD{f"¥{_arm_zd:.3f}" if _arm_zd else "暂无"}/'
+                              f'峰值回落{SELL_ARM_PEAK_DROP:.0%}; 强势新高则撤防骑趋势)',
+                              '第24课: 日线背驰除非周线同步背驰, 否则只造成日线级别调整'))
+                return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
+                                        action='HOLD', confidence='MEDIUM', final_kind=daily_sig.kind,
+                                        cur_price=cur_price, chain=chain,
+                                        note=f'L24: 周线上涨中的日线盘整背驰{daily_sig.kind}, 布防短差不全清',
+                                        sell_armed=True, arm_zd=_arm_zd,
+                                        arm_high=float(_arm_high) if _arm_high else None,
+                                        diagnostics=diagnostics, monthly=mov)
+
+        action = 'BUY' if is_buy else 'SELL'
+        if self.CFG.get('mode') == 'long' and is_sell and daily_sig.kind in ('S1', 'S2'):
+            big_up_long = ((wv is not None and wv.trend == 'up_trend') or
+                           (mov is not None and monthly_dir == 'up_trend'))
+            ma5m_ok = True
+            if len(df_mo) >= 5:
+                ma5m = float(df_mo['close'].tail(5).mean())
+                ma5m_ok = cur_price >= ma5m
+            if big_up_long and ma5m_ok:
+                chain.append(('mode', f'长线模式: 日线{daily_sig.kind}非周线级别转折且大方向上涨 → 持有(操作级别=周线)', '第72课: 看周线则日线调整不构成卖段; 第61课大级别不因小级别震荡卖'))
+                # 长线模式持有也挂上布防线(第44课): 真转折时不至于全程坐滑梯
+                _arm_zd = (m30_an.pivots[-1].zd if (m30_an is not None and m30_an.n_pivots) else None)
+                _ex = daily_sig.extras or {}
+                _arm_high = _ex.get('c_high') or _ex.get('prev_high') or cur_price
+                return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
+                                        action='HOLD', confidence='MEDIUM', final_kind=daily_sig.kind, cur_price=cur_price,
+                                        chain=chain, note=f'长线模式持有: 日线{daily_sig.kind}属次级别调整, 周线方向未转',
+                                        sell_armed=bool(self.CFG.get('sell_nested_interval')),
+                                        arm_zd=_arm_zd, arm_high=float(_arm_high) if _arm_high else None,
+                                        diagnostics=diagnostics, monthly=mov)
+        if not confirmed:
+            if is_sell:
+                # ── 卖点区间套布防 (第24/44课): 背驰已现但次级别动能未竭 ──
+                # 不立即卖(防卖飞), 也绝不傻等到三卖(防坐滑梯): 持仓转入布防,
+                # 由回测端的布防线(嵌套背驰出现/破30m中枢ZD/峰值回落阈值)收割。
+                # 布防仅用于S1的精确定顶。S2是一卖后的【反抽】卖点(第15课):
+                # 上方空间被一卖高点封死, 反抽本身就是用来卖的, "等次级别动能衰竭"
+                # 与其性质矛盾 → S2未印证时维持"先卖再说"(走下方LOW置信卖出)。
+                if (self.CFG.get('sell_nested_interval') and daily_sig.kind == 'S1'):
+                    arm_zd = (m30_an.pivots[-1].zd if (m30_an is not None and m30_an.n_pivots) else None)
+                    ex = daily_sig.extras or {}
+                    arm_high = ex.get('c_high') or ex.get('prev_high') or cur_price
+                    chain.append(('卖点布防',
+                                  f'日线{daily_sig.kind}背驰已现但次级别动能未竭 → 不立即卖(防卖飞), '
+                                  f'转入区间套布防: ①次级别出现嵌套顶背驰即卖 '
+                                  f'②跌破30m最近中枢下沿ZD{f"¥{arm_zd:.3f}" if arm_zd else "(暂无30m中枢)"}即卖 '
+                                  f'③较布防后峰值回落{SELL_ARM_PEAK_DROP:.0%}即卖',
+                                  '第44课区间套: 背驰段中套背驰段定精确高点; 第24课: 次级别未背驰, 大级别顶未到'))
+                    return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
+                                            action='HOLD', confidence='MEDIUM', final_kind=daily_sig.kind,
+                                            cur_price=cur_price, chain=chain,
+                                            note=f'区间套布防中: 日线{daily_sig.kind}背驰段内, 等次级别嵌套背驰收敛后高位兑现(第44课)',
+                                            sell_armed=True, arm_zd=arm_zd,
+                                            arm_high=float(arm_high) if arm_high else None,
+                                            confidence_reasons=[f'布防原因: {confirm_note}'],
+                                            diagnostics=diagnostics, monthly=mov)
+                big_up_sell = ((wv is not None and wv.trend == 'up_trend') or
+                               (mov is not None and monthly_dir == 'up_trend'))
+                if self.CFG.get('require_sublevel_sell_confirm') and big_up_sell:
+                    chain.append(('sell_gate', f'日线{daily_sig.kind}卖点但次级别未印证, 且大方向上涨 → 持有(L61: 大级别不因小级别震荡卖)', '第61课: 区间套确认; 大级别操作不因小级别震荡清仓'))
+                    return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
+                                            action='HOLD', confidence='LOW', final_kind=daily_sig.kind, cur_price=cur_price,
+                                            chain=chain, note=f'日线{daily_sig.kind}卖点次级别未印证+大方向上涨, 持有等确认: {confirm_note}',
+                                            confidence_reasons=[f'次级别未印证持有: {confirm_note}'],
+                                            diagnostics=diagnostics, monthly=mov)
+                chain.append(('sell_gate',f'日线{daily_sig.kind}卖点已成立, 次级别未印证只降级不拦截','第14/15/21课: 买点买、卖点卖; 区间套用于精确定位, 不是否决卖点'))
+                return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
+                                        action='SELL', confidence='LOW', final_kind=daily_sig.kind, cur_price=cur_price,
+                                        chain=chain, note=f'日线{daily_sig.kind}卖点先执行; 次级别未印证仅降级: {confirm_note}',
+                                        confidence_reasons=[f'次级别未印证: {confirm_note}'],
+                                        diagnostics=diagnostics, monthly=mov)
+            return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
+                                    action='WATCH', confidence='LOW', final_kind=daily_sig.kind, cur_price=cur_price,
+                                    chain=chain, blocked_reason=f'次级别未印证({confirm_note})',
+                                    note='日线有买/非S1卖信号但次级别未确认 -- 等次级别出信号再动手',
+                                    diagnostics=diagnostics, monthly=mov)
+
+        score = 100; conf_reasons = []
+        def _penalty(pts, reason):
+            nonlocal score
+            score -= pts; conf_reasons.append(f'(-{pts}) {reason}')
+        if mov is not None and monthly_dir == 'down_trend' and is_buy:
+            _penalty(25, '第69课: 月线大方向下跌, 日线买点属逆大方向的转折尝试')
+        trend_piv_lt2 = (daily_an is not None and daily_an.n_trend_pivots < 2)
+        if trend_piv_lt2 and daily_sig.kind in ('B1', 'S1'):
+            _penalty(20, f'第27课: 背驰段前仅{daily_an.n_trend_pivots}个中枢(<2), 盘整背驰非趋势背驰')
+        if daily_an is not None and daily_an.trend == 'consolidation':
+            _penalty(15, '第29课: 日线处盘整结构, 盘整中转折力度弱')
+        daily_dg = getattr(daily_sig, 'diverge_grade', None)
+        if daily_dg is not None and daily_dg.grade == 'WEAK':
+            trig = '面积' if daily_dg.area_ok else 'DIF极值'
+            _penalty(15, f'第27课: 背驰仅满足{trig}单一判据(WEAK), 非标准背驰')
+        if (daily_dg is not None and daily_dg.grade in ('STRONG', 'WEAK')
+                and not daily_dg.is_trend_divergence and not trend_piv_lt2
+                and daily_sig.kind in ('B1', 'S1')):
+            _penalty(10, '第27课: 背驰段为盘整背驰(非趋势背驰), 力度偏弱')
+        if downgrade:
+            _penalty(12, '第44课: 区间套次级别未完全印证(精度降级, 非证伪)')
+        if daily_sig.kind in ('B2', 'S2'):
+            has_delayed = any(lvl in ('30m', '15m', '5m', '1m') and '延后确认' in concl
+                              for lvl, concl, _ in chain)
+            if has_delayed:
+                _penalty(8, '二/二卖由次级别延后确认(非次级别一买/一卖精确定位), 精度略降')
+        ex = daily_sig.extras or {}
+        if daily_sig.kind == 'B3':
+            missing = []
+            if ex.get('b1_price') is None:
+                missing.append('一买')
+            if ex.get('b2_price') is None:
+                missing.append('二买')
+            if missing:
+                _penalty(6, '第20/21课: 三买未能定位对应' + '/'.join(missing) + ', 质量略降')
+            if ex.get('late_trend_b3'):
+                _penalty(12, '第20/92课: 第二个以上同向中枢后的三买, 操作意义下降')
+        if daily_sig.kind == 'S3':
+            missing = []
+            if ex.get('s1_price') is None:
+                missing.append('一卖')
+            if ex.get('s2_price') is None:
+                missing.append('二卖')
+            if missing:
+                _penalty(6, '第20/21课: 三卖未能定位对应' + '/'.join(missing) + ', 质量略降')
+        if daily_dg is not None and daily_dg.grade == 'STRONG' and daily_dg.is_trend_divergence:
+            score += 10; conf_reasons.append('(+10) 第27课: 标准趋势背驰(>=2中枢+面积+DIF), 高质量')
+        # ── 卖点区间套加分: 30m嵌套顶背驰精确定位(卖在高位区) ──
+        if is_sell and any(lvl == '30m' and '嵌套顶背驰' in concl for lvl, concl, _ in chain):
+            score += 8; conf_reasons.append('(+8) 第44课: 30m嵌套顶背驰精确定位, 卖点落在高位区')
+        score = max(0, min(110, score))
+        confidence = 'HIGH' if score >= 70 else ('MEDIUM' if score >= 45 else 'LOW')
+        if conf_reasons:
+            chain.append(('置信度', f'{confidence}(评分{score}) ← ' + '; '.join(conf_reasons),
+                          '第21课: 一二三类买卖点是位置分类非质量排序; 置信度按原著力度条件评分'))
+        else:
+            chain.append(('置信度', f'HIGH(评分{score}) ← 力度条件全部满足',
+                          '第27/29/43课: 方向一致+趋势背驰+趋势结构'))
+        note_parts = []
+        if conf_reasons:
+            note_parts.append(f'置信评分明细: ' + '; '.join(conf_reasons))
+        n_lvl = 3 + (self.df_60m is not None) + (self.df_15m is not None) + (self.df_5m is not None) + (self.df_1m is not None)
+        lvl_txt = {3:'三级别',4:'四级别',5:'五级别',6:'六级别',7:'七级别'}.get(n_lvl, f'{n_lvl}级别')
+        m5_txt = ('/5m已印证' if m5_confirmed is True else '/5m未印证(已降级)' if m5_confirmed is False else '')
+        m1_txt = ('/1m已印证' if m1_confirmed is True else '/1m未印证(已降级)' if m1_confirmed is False else '')
+        note_parts.append(f'{lvl_txt}联立通过: 周线{weekly_dir}/日线{daily_sig.kind}/30m已印证{m5_txt}{m1_txt}')
+        note = ' | '.join(note_parts)
+        return MultiLevelSignal(code=self.code, analysis_date=last_date, weekly=wv, daily=dv, m30=_mv(),
+                                action=action, confidence=confidence, final_kind=daily_sig.kind, cur_price=cur_price,
+                                chain=chain, note=note, confidence_reasons=conf_reasons, diagnostics=diagnostics, monthly=mov)
+
+    @staticmethod
+    def _no_signal_decision(wv, dv, cur_price):
+        if wv is not None and wv.trend == 'up_trend' and dv.trend == 'up_trend':
+            if dv.zg is not None and cur_price > dv.zg:
+                return ('HOLD','NONE', f'周线+日线均上涨且价({cur_price:.2f})在日线ZG({dv.zg:.2f})上, 继续持有等卖点(第108课: 买点入,持有等卖点)')
+            return ('HOLD','NONE','周线日线均上涨, 趋势中持有')
+        if wv is not None and wv.trend == 'down_trend':
+            return ('WATCH','NONE','周线下跌趋势, 无日线买点 → 空仓观望, 不抄底')
+        return ('WATCH','NONE', f'无明确信号(周线{wv.trend if wv else "?"}/日线{dv.trend}), 观望')

finetune_data.py

@@ -1,105 +1,147 @@
 """
-finetune_data.py — capture (instruction, input, output) pairs from live app use,
-then export a clean JSONL ready for LoRA SFT (the 🎯 Well-Tuned badge).
-
-Every time the Signals "AI summary" runs, app.py calls `record()` with the
-English raw read (input) and the model's narrative (output). Pairs accumulate
-on the /data bucket and survive restarts; the Model tab has an "Export dataset"
-button that writes a timestamped JSONL and reports the count.
-
-The dataset teaches a small model ONE focused skill — turn a Chan-theory raw
-read into a crisp long-hold trading summary — which is exactly what the app's
-Translator sub-agent does. A 1.7B model fine-tuned on this beats a generic 4B
-at the task, and doubles as the Tiny Titan entry.
+data_us.py — US market data layer (yfinance), replacing baostock/pytdx.
+
+Levels & history limits (Yahoo Finance API constraints):
+    daily   : 10 years          (weekly / monthly are resampled from daily
+                                 by chan_multilevel.resample_weekly/_monthly)
+    60m     : last 730 days
+    30m/15m : last 60 days
+    5m      : last 60 days
+    1m      : last 7 days only → too short for Chan decomposition, NOT used.
+              MultiLevelChan handles a missing 1m level gracefully (skips it).
+
+Output schema (identical to the original A-share loaders):
+    date, open, close, high, low, volume, amount
+`amount` (turnover) is approximated as close × volume (Yahoo has no turnover field).
+
+All downloads are cached to parquet under ./_cache_us/<TICKER>/<level>.parquet
+and refreshed when stale (daily: >12h old, intraday: >2h old) or on force=True.
 """
 from __future__ import annotations
 
-import json
 import os
-import re
-import threading
-import datetime as dt
+import time
+import traceback
 
-import paths
-
-_PAIRS = os.path.join(paths.DATASET_DIR, "pairs.jsonl")
-_lock = threading.Lock()
-
-INSTRUCTION = ("You are an equity analyst. Based only on this factual read of a "
-               "US stock's multi-timeframe Chan-theory verdict, write a short "
-               "plain-English summary for a long-term holder: the situation "
-               "today, whether to act or wait, and the key price levels. "
-               "Max 90 words, no disclaimers.")
-
-
-def _clean(text: str) -> str:
-    # strip stray think tags and any "AI narrative ..." UI prefix
-    text = re.sub(r"<think>.*?</think>", "", text, flags=re.S)
-    text = re.sub(r"^🤖\s*\*\*AI narrative[^\n]*\*\*\s*", "", text)
-    text = text.replace("🤖 **AI narrative (Translator sub-agent · Qwen3-1.7B):**", "")
-    return text.strip()
+import pandas as pd
 
+import paths
 
-def record(raw_read: str, narrative: str):
-    """Append one training pair. Silently ignores junk / unloaded-model output."""
-    narrative = _clean(narrative)
-    if not raw_read or not narrative or len(narrative) < 40:
-        return
-    if narrative.startswith(("⏳", "(", "Run the analysis")):
-        return
-    row = {"instruction": INSTRUCTION, "input": raw_read.strip(), "output": narrative}
+CACHE_DIR = os.environ.get("CHAN_CACHE_DIR", paths.CACHE_DIR)
+
+LEVELS = {
+    # level: (yfinance interval, period) — Yahoo's max history per interval
+    "d":   ("1d",  "10y"),
+    "60m": ("60m", "730d"),
+    "30m": ("30m", "60d"),
+    "15m": ("15m", "60d"),
+    "5m":  ("5m",  "60d"),
+    "1m":  ("1m",  "7d"),    # only 7 days available; short but usable for the
+                             # finest nested-interval confirmation when present
+}
+
+_STALE_SECONDS = {"d": 12 * 3600, "60m": 2 * 3600, "30m": 2 * 3600,
+                  "15m": 2 * 3600, "5m": 2 * 3600, "1m": 1800}
+
+
+def _cache_path(ticker: str, level: str) -> str:
+    d = os.path.join(CACHE_DIR, ticker.upper().replace("/", "_"))
+    os.makedirs(d, exist_ok=True)
+    return os.path.join(d, f"{level}.parquet")
+
+
+def _normalize(df: pd.DataFrame) -> pd.DataFrame:
+    """yfinance frame → engine schema (date/open/close/high/low/volume/amount)."""
+    if df is None or len(df) == 0:
+        return pd.DataFrame(columns=["date", "open", "close", "high", "low", "volume", "amount"])
+    d = df.copy()
+    if isinstance(d.columns, pd.MultiIndex):           # yf>=0.2 returns MultiIndex sometimes
+        d.columns = [c[0] if isinstance(c, tuple) else c for c in d.columns]
+    d = d.reset_index()
+    # index column may be 'Date' or 'Datetime'
+    for cand in ("Datetime", "Date", "index"):
+        if cand in d.columns:
+            d = d.rename(columns={cand: "date"})
+            break
+    d.columns = [str(c).lower() for c in d.columns]
+    keep = {"date", "open", "high", "low", "close", "volume"}
+    d = d[[c for c in d.columns if c in keep]]
+    d["date"] = pd.to_datetime(d["date"])
+    # strip timezone so comparisons with naive Timestamps in the engine work
     try:
-        with _lock, open(_PAIRS, "a", encoding="utf-8") as f:
-            f.write(json.dumps(row, ensure_ascii=False) + "\n")
-    except OSError:
+        d["date"] = d["date"].dt.tz_localize(None)
+    except (TypeError, AttributeError):
         pass
-
-
-def count() -> int:
-    try:
-        with open(_PAIRS, encoding="utf-8") as f:
-            return sum(1 for _ in f)
-    except OSError:
-        return 0
-
-
-def export() -> str:
-    """De-duplicate and write a timestamped JSONL. Returns the file path so the
-    UI can offer it as a direct download."""
-    n = count()
-    if n == 0:
-        return ""
-    seen, rows = set(), []
-    try:
-        with open(_PAIRS, encoding="utf-8") as f:
-            for line in f:
-                line = line.strip()
-                if not line:
-                    continue
-                try:
-                    r = json.loads(line)
-                except ValueError:
-                    continue
-                key = (r.get("input", ""), r.get("output", ""))
-                if key in seen:
-                    continue
-                seen.add(key)
-                rows.append(r)
-    except OSError:
-        return ""
-    stamp = dt.datetime.utcnow().strftime("%Y%m%d-%H%M%S")
-    out = os.path.join(paths.DATASET_DIR, f"chan_sft_{stamp}.jsonl")
+    d = d.dropna(subset=["open", "high", "low", "close"])
+    d = d.sort_values("date").reset_index(drop=True)
+    d["amount"] = d["close"] * d.get("volume", 0)
+    return d[["date", "open", "close", "high", "low", "volume", "amount"]]
+
+
+def load_level(ticker: str, level: str, force: bool = False) -> pd.DataFrame:
+    """Load one level for a ticker, using parquet cache when fresh."""
+    assert level in LEVELS, f"unknown level {level}"
+    path = _cache_path(ticker, level)
+    if not force and os.path.exists(path):
+        age = time.time() - os.path.getmtime(path)
+        if age < _STALE_SECONDS[level]:
+            try:
+                return pd.read_parquet(path)
+            except Exception:
+                pass
     try:
-        with open(out, "w", encoding="utf-8") as f:
-            for r in rows:
-                f.write(json.dumps(r, ensure_ascii=False) + "\n")
-    except OSError:
-        return ""
-    return out
-
-
-def status_line() -> str:
-    n = count()
-    if n == 0:
-        return "_No fine-tuning pairs captured yet — run a few Signals AI summaries._"
-    return f"📚 **{n}** training pair(s) captured on /data (target: 200-500 for a good LoRA)."
+        import yfinance as yf
+        interval, period = LEVELS[level]
+        raw = yf.Ticker(ticker).history(period=period, interval=interval,
+                                        auto_adjust=True, actions=False)
+        df = _normalize(raw)
+        if len(df):
+            df.to_parquet(path, index=False)
+            return df
+    except Exception:
+        traceback.print_exc()
+    # network failed → fall back to stale cache if any
+    if os.path.exists(path):
+        try:
+            return pd.read_parquet(path)
+        except Exception:
+            pass
+    return pd.DataFrame(columns=["date", "open", "close", "high", "low", "volume", "amount"])
+
+
+# Full nested-interval set (区间套): the more sub-levels confirm, the more
+# precise the buy/sell point. We fetch the deepest Yahoo allows. 1m has only
+# 7 days of history — included when present, skipped gracefully otherwise.
+# Downloads are parallel + cached, so the extra levels cost little wall-time.
+FULL_LEVELS = ("d", "60m", "30m", "15m", "5m", "1m")
+FAST_LEVELS = FULL_LEVELS  # default everywhere; alias kept for older callers
+
+
+def load_levels(ticker: str, levels=FAST_LEVELS, force: bool = False) -> dict:
+    return {lvl: load_level(ticker, lvl, force=force) for lvl in levels}
+
+
+def load_all_levels(ticker: str, force: bool = False) -> dict:
+    """Return {'d':…, '60m':…, '30m':…, '15m':…, '5m':…} (1m intentionally absent)."""
+    return {lvl: load_level(ticker, lvl, force=force) for lvl in LEVELS}
+
+
+def prefetch(tickers, levels=FAST_LEVELS, force: bool = False, workers: int = 5,
+             budget_s: int = 45):
+    """Download all (ticker, level) pairs in parallel with a hard time budget.
+    Yahoo rate-limits datacenter IPs; without a budget one throttled request
+    could hang the whole Run-analysis click. Whatever isn't fetched in time is
+    skipped — the engine analyzes from daily/cached data and the next run
+    picks up the rest."""
+    from concurrent.futures import ThreadPoolExecutor, wait
+    jobs = [(t, lvl) for t in tickers for lvl in levels]
+    ex = ThreadPoolExecutor(max_workers=workers)
+    futs = [ex.submit(load_level, t, lvl, force) for t, lvl in jobs]
+    done, not_done = wait(futs, timeout=budget_s)
+    ex.shutdown(wait=False, cancel_futures=True)
+    return len(done), len(not_done)
+
+
+def last_daily_date(ticker: str):
+    df = load_level(ticker, "d")
+    return None if df.empty else pd.Timestamp(df["date"].iloc[-1])

fonts.css

@@ -0,0 +1,148 @@
+/* ============================================================
+   COLOR — Chan Compass · Spectrum 2
+   Two layers:
+     1. PRIMITIVES  — the raw Spectrum 2 scales (--s2-gray-100, --s2-blue-900…)
+     2. SEMANTICS   — purpose-named aliases the UI references (--text-body,
+                      --surface-card, --accent…)
+   Always consume semantics in components; reach for a primitive only
+   when no semantic fits. Light theme is the default; .s2-dark flips the
+   semantic layer (primitives are not re-pointed here for simplicity).
+   ============================================================ */
+
+:root {
+  /* ---- Gray (light) ---- */
+  --s2-gray-25:  #ffffff;
+  --s2-gray-50:  #f8f8f8;
+  --s2-gray-75:  #f3f3f3;
+  --s2-gray-100: #e6e6e6;
+  --s2-gray-200: #d5d5d5;
+  --s2-gray-300: #b1b1b1;
+  --s2-gray-400: #909090;
+  --s2-gray-500: #6d6d6d;
+  --s2-gray-600: #464646;
+  --s2-gray-700: #292929;
+  --s2-gray-800: #1b1b1b;
+  --s2-gray-900: #000000;
+
+  /* ---- Blue (accent family) ---- */
+  --s2-blue-100:  #e0f2ff;
+  --s2-blue-200:  #cae8ff;
+  --s2-blue-300:  #98cbfe;
+  --s2-blue-400:  #6fb7fb;
+  --s2-blue-500:  #4ba0ec;
+  --s2-blue-600:  #2c84e0;
+  --s2-blue-700:  #1473e6;
+  --s2-blue-800:  #0a6fd6;
+  --s2-blue-900:  #0265dc;   /* accent default */
+  --s2-blue-1000: #0054b6;   /* accent hover   */
+  --s2-blue-1100: #00418f;   /* accent down    */
+
+  /* ---- Green (positive) ---- */
+  --s2-green-100:  #ebf9ee;
+  --s2-green-400:  #6cc788;
+  --s2-green-700:  #15924a;
+  --s2-green-900:  #007a39;  /* positive default */
+  --s2-green-1000: #006d31;
+  --s2-green-1100: #00601f;
+
+  /* ---- Red (negative) ---- */
+  --s2-red-100:  #ffefef;
+  --s2-red-400:  #ff9b88;
+  --s2-red-700:  #e34850;
+  --s2-red-900:  #d7373f;    /* negative default */
+  --s2-red-1000: #c0272d;
+  --s2-red-1100: #a01a1f;
+
+  /* ---- Orange (notice) ---- */
+  --s2-orange-100:  #fdf0e1;
+  --s2-orange-400:  #f8af5a;
+  --s2-orange-700:  #cb6f10;
+  --s2-orange-900:  #b25309;  /* notice default */
+  --s2-orange-1000: #99490b;
+
+  /* ---- Indigo (informative accent / charts) ---- */
+  --s2-indigo-700: #5258e4;
+  --s2-indigo-900: #3d43d0;
+
+  /* ---- Purple (decorative / hero gradient stop) ---- */
+  --s2-purple-700: #8c42d6;
+  --s2-purple-900: #7326d3;
+
+  /* ============================================================
+     SEMANTIC ALIASES — what components actually reference
+     ============================================================ */
+
+  /* Surfaces & framing (Spectrum 2 background layering) */
+  --canvas:          var(--s2-gray-50);   /* app background        */
+  --surface-card:    var(--s2-gray-25);   /* cards, panels         */
+  --surface-elevated:var(--s2-gray-25);   /* popovers, menus       */
+  --surface-subtle:  var(--s2-gray-75);   /* table head, wells     */
+  --surface-sunken:  var(--s2-gray-75);   /* inset fields          */
+
+  /* Text */
+  --text-heading:    var(--s2-gray-800);
+  --text-body:       var(--s2-gray-700);
+  --text-secondary:  var(--s2-gray-600);
+  --text-muted:      var(--s2-gray-500);
+  --text-disabled:   var(--s2-gray-400);
+  --text-on-accent:  #ffffff;
+
+  /* Borders & dividers */
+  --border-hairline: var(--s2-gray-100);
+  --border-default:  var(--s2-gray-200);
+  --border-strong:   var(--s2-gray-300);
+  --border-field:    var(--s2-gray-300);
+
+  /* Accent (Spectrum blue) */
+  --accent:          var(--s2-blue-900);
+  --accent-hover:    var(--s2-blue-1000);
+  --accent-down:     var(--s2-blue-1100);
+  --accent-subtle:   var(--s2-blue-100);
+  --accent-text:     var(--s2-blue-1000);
+
+  /* Semantic status */
+  --positive:        var(--s2-green-900);
+  --positive-hover:  var(--s2-green-1000);
+  --positive-subtle: var(--s2-green-100);
+  --negative:        var(--s2-red-900);
+  --negative-hover:  var(--s2-red-1000);
+  --negative-subtle: var(--s2-red-100);
+  --notice:          var(--s2-orange-900);
+  --notice-subtle:   var(--s2-orange-100);
+  --informative:     var(--s2-blue-900);
+  --informative-subtle: var(--s2-blue-100);
+
+  /* Focus ring */
+  --focus-ring:      var(--s2-blue-900);
+
+  /* Market direction (this product's domain colors) */
+  --up:              var(--s2-green-900);   /* gains / BUY  */
+  --down:            var(--s2-red-900);     /* losses / SELL */
+  --flat:            var(--s2-gray-500);    /* HOLD / WAIT  */
+}
+
+/* ---- Dark theme: flip the semantic layer only ---- */
+.s2-dark {
+  --canvas:          #1d1d1d;
+  --surface-card:    #262626;
+  --surface-elevated:#2c2c2c;
+  --surface-subtle:  #222222;
+  --surface-sunken:  #1a1a1a;
+
+  --text-heading:    #f2f2f2;
+  --text-body:       #e0e0e0;
+  --text-secondary:  #b8b8b8;
+  --text-muted:      #8f8f8f;
+  --text-disabled:   #6a6a6a;
+
+  --border-hairline: #383838;
+  --border-default:  #4a4a4a;
+  --border-strong:   #5e5e5e;
+  --border-field:    #5e5e5e;
+
+  --accent:          #2680eb;
+  --accent-hover:    #4ba0ec;
+  --accent-down:     #6fb7fb;
+  --accent-subtle:   #1a3a5c;
+  --accent-text:     #6fb7fb;
+}

llm_local.py

@@ -1,307 +1,288 @@
 """
-llm_local.py — local sub-agent pool (llama.cpp runtime, no cloud APIs).
+emailer.py — send a tab's AI result to any address (English UI + content).
 
-Two independent model instances ("sub-agents"), each with its own lock, so
-features never block each other with "model busy":
+Adapted from the user's send_predict_email.py: same multi-domain SMTP
+auto-detection, plain+HTML multipart, but English subjects/labels and a generic
+`send_result()` the Gradio tabs call.
 
-    fast  · Summary Sub-Agent (Chan-Tuned Qwen3-1.7B)
-            → Explain-in-English, sector-rotation narrative, news briefs.
-            Small = quick CPU prefill, answers start streaming in seconds.
-    deep  · Analyst — Qwen3-4B Q4_K_M by default (swappable in the Model tab)
-            → the multi-step Auto Research agent's report writing.
-
-Both run through llama.cpp (llama-cpp-python) and are far below the 32B cap;
-the fast worker doubles as the "Tiny Titan" (≤4B) story. ~5 GB RAM total on a
-32 GB Space. Earns "Off the Grid" + "Llama Champion".
+Sender credentials live here (a Gmail App Password). To change the sender, edit
+EMAIL_SENDER / EMAIL_PASSWORD. You can also override them with the environment
+variables CHAN_EMAIL_SENDER / CHAN_EMAIL_PASSWORD on the Space (recommended:
+store the App Password as a Space *secret* rather than in code).
 """
 from __future__ import annotations
 
 import os
+import json
+import html
+import logging
+import smtplib
+import urllib.request
+import urllib.error
 import re
-import threading
-
-import paths  # sets HF_HOME + sys.path for /data persistence
-from huggingface_hub import hf_hub_download
-
-# name -> (HF repo, gguf filename)
-MODEL_ZOO = {
-    "Chan-Tuned Qwen3-1.7B · my fine-tune": (
-        "ranranrunforit/chan-compass-qwen3-1.7b-gguf", "qwen3-1.7b.Q8_0.gguf"),
-    "Qwen3-1.7B · Tiny Titan (≤4B award class)": (
-        "Qwen/Qwen3-1.7B-GGUF", "Qwen3-1.7B-Q8_0.gguf"),
-    "Qwen3-4B  · default — fast + smart, still ≤4B": (
-        "Qwen/Qwen3-4B-GGUF", "Qwen3-4B-Q4_K_M.gguf"),
-    "Qwen3-8B  · best balance on 8 vCPU / 32 GB": (
-        "Qwen/Qwen3-8B-GGUF", "Qwen3-8B-Q4_K_M.gguf"),
-    "Qwen3-14B · max quality (still far under 32B cap)": (
-        "Qwen/Qwen3-14B-GGUF", "Qwen3-14B-Q4_K_M.gguf"),
-}
-# Only the Summary sub-agent (Signals · Explain) uses the published
-# fine-tune; every other sub-agent stays on the stock models.
-FAST_MODEL = "Qwen3-1.7B · Tiny Titan (≤4B award class)"
-TRANSLATOR_MODEL = "Chan-Tuned Qwen3-1.7B · my fine-tune"
-DEFAULT_MODEL = "Qwen3-4B  · default — fast + smart, still ≤4B"
-
-_THINK_RE = re.compile(r"<think>.*?</think>", re.S)
-_NCPU = max(2, (os.cpu_count() or 4))
-
-# One dedicated sub-agent per feature — independent locks, so Signals-Explain,
-# Rotation narrative, News briefs and Auto-Research never fight over a model.
-# Three tiny 1.7B instances share ONE GGUF file on disk (~2 GB RAM each) and
-# the 4B Analyst writes reports. Total ≈ 9 GB on a 32 GB Space.
-WORKER_LABEL = {
-    "translator": "Summary sub-agent (Signals · Explain)",
-    "narrator":   "Narrator sub-agent (Sector Rotation)",
-    "reporter":   "Reporter sub-agent (News · Research support)",
-    "analyst":    "Analyst sub-agent (Auto Research)",
-}
-
-
-def _mk(model):
-    return {"model": model, "llm": None, "lock": threading.Lock(),
-            "load_lock": threading.Lock(), "stage": "idle", "detail": "", "ts": None}
-
-
-WORKERS = {
-    "translator": _mk(TRANSLATOR_MODEL),
-    "narrator":   _mk(FAST_MODEL),
-    "reporter":   _mk(FAST_MODEL),
-    "analyst":    _mk(DEFAULT_MODEL),
+from datetime import datetime
+from email.mime.text import MIMEText
+from email.mime.multipart import MIMEMultipart
+from email.header import Header
+from email.utils import formataddr
+
+logger = logging.getLogger("chan_emailer")
+
+# ── Transport 1 (preferred on HF): Resend HTTPS API on port 443 ──
+# HF Spaces block outbound SMTP ports (465/587) → SMTP fails with
+# "Network is unreachable". The Resend REST API uses plain HTTPS, which Spaces
+# allow. Set a Space secret RESEND_API_KEY to enable it. Free tier ≈ 100/day.
+# Until you verify your own domain, Resend only lets you send FROM
+# "onboarding@resend.dev" — that's the default sender below.
+RESEND_API_KEY = os.environ.get("RESEND_API_KEY", "")
+RESEND_FROM = os.environ.get("RESEND_FROM", "Chan Compass <onboarding@resend.dev>")
+
+# ── Transport 2 (fallback, works off-HF): classic SMTP ──
+EMAIL_SENDER = os.environ.get("CHAN_EMAIL_SENDER", "")
+EMAIL_PASSWORD = os.environ.get("CHAN_EMAIL_PASSWORD", "")
+
+SMTP_CONFIGS = {
+    "gmail.com":   {"server": "smtp.gmail.com",     "port": 465, "ssl": True},
+    "qq.com":      {"server": "smtp.qq.com",        "port": 465, "ssl": True},
+    "163.com":     {"server": "smtp.163.com",       "port": 465, "ssl": True},
+    "126.com":     {"server": "smtp.126.com",       "port": 465, "ssl": True},
+    "outlook.com": {"server": "smtp.office365.com", "port": 587, "ssl": False},
+    "hotmail.com": {"server": "smtp.office365.com", "port": 587, "ssl": False},
+    "foxmail.com": {"server": "smtp.qq.com",        "port": 465, "ssl": True},
+    "sina.com":    {"server": "smtp.sina.com",      "port": 465, "ssl": True},
+    "aliyun.com":  {"server": "smtp.aliyun.com",    "port": 465, "ssl": True},
 }
-# legacy aliases
-_ALIAS = {"fast": "translator", "deep": "analyst"}
-
 
-def _wk(worker: str) -> str:
-    return _ALIAS.get(worker, worker)
-
-_install_lock = threading.Lock()
-
-
-def _set_stage(worker: str, stage: str, detail: str = ""):
-    import datetime as _dt
-    w = WORKERS[worker]
-    w.update(stage=stage, detail=detail[:400],
-             ts=_dt.datetime.utcnow().strftime("%H:%M:%S UTC"))
-    try:
-        import automation
-        automation._log(f"[{WORKER_LABEL[worker]}] {stage}: {detail[:140]}")
-    except Exception:
-        pass
-
-
-# ─────────────────────── runtime install (once, persisted) ───────────────────────
-# Installed at RUNTIME, not at Space build time: the HF build container has
-# little RAM and gets OOM-killed compiling the C++ extension; the runtime
-# container has the real hardware. Prebuilt CPU wheel first, capped-parallelism
-# source build as fallback. Persisted to /data/pylibs.
-_WHEEL_INDEX = "https://abetlen.github.io/llama-cpp-python/whl/cpu"
-_LLAMA_REQ = "llama-cpp-python>=0.3.8"   # >=0.3.8 → Qwen3 architecture support
-
-
-def _ensure_llama_cpp(worker: str) -> str:
-    try:
-        import llama_cpp  # noqa: F401
-        return ""
-    except ImportError:
-        pass
-    import subprocess
-    import sys
-    with _install_lock:
-        try:  # another thread may have finished it while we waited
-            import llama_cpp  # noqa: F401
-            return ""
-        except ImportError:
-            pass
-        env = dict(os.environ)
-        env["CMAKE_BUILD_PARALLEL_LEVEL"] = "4"
-        _set_stage(worker, "installing llama.cpp runtime",
-                   "trying official prebuilt CPU wheel (≈1 min)…")
-        if paths.PERSISTENT:
-            base = [sys.executable, "-m", "pip", "install", "--prefer-binary",
-                    "--target", paths.PYLIBS_DIR]
-        else:
-            base = [sys.executable, "-m", "pip", "install", "--user", "--prefer-binary"]
-        r = subprocess.run(base + ["--extra-index-url", _WHEEL_INDEX,
-                                   "--only-binary", "llama-cpp-python", _LLAMA_REQ],
-                           capture_output=True, text=True, env=env, timeout=600)
-        if r.returncode != 0:
-            _set_stage(worker, "installing llama.cpp runtime",
-                       "no prebuilt wheel matched — compiling from source "
-                       "(one-time ~10-15 min; other tabs keep working)…")
-            r = subprocess.run(base + ["--extra-index-url", _WHEEL_INDEX, _LLAMA_REQ],
-                               capture_output=True, text=True, env=env, timeout=2400)
-        if r.returncode != 0:
-            err = (r.stderr or r.stdout or "")[-800:]
-            _set_stage(worker, "install FAILED", err)
-            return "Could not install llama-cpp-python at runtime:\n" + err
-        import importlib
-        import site
-        cands = [paths.PYLIBS_DIR] if paths.PERSISTENT else []
-        usp = site.getusersitepackages()
-        cands += usp if isinstance(usp, list) else [usp]
-        for p in cands:
-            if p and p not in sys.path:
-                sys.path.append(p)
-        importlib.invalidate_caches()
+_EMAIL_RE = re.compile(r"^[^@\s]+@[^@\s]+\.[^@\s]+$")
+
+
+def _sender_address(sender: str) -> str:
+    return formataddr((str(Header("Chan Compass", "utf-8")), sender))
+
+
+def _md_to_plain(text: str) -> str:
+    """Markdown -> readable plain text (for the text/plain MIME part and the
+    Resend `text` field). Strips #/**/| noise so text-only clients look clean."""
+    lines, out = text.split("\n"), []
+    i, n = 0, len(lines)
+    while i < n:
+        line = lines[i]
+        if "|" in line and i + 1 < n and re.match(r"^\s*\|?[\s:\-|]+\|?\s*$", lines[i + 1]):
+            header = [c.strip() for c in line.strip().strip("|").split("|")]
+            i += 2
+            while i < n and "|" in lines[i]:
+                cells = [c.strip() for c in lines[i].strip().strip("|").split("|")]
+                if len(header) == 2 and len(cells) == 2:
+                    out.append(f"  {cells[0]}: {cells[1]}")
+                else:
+                    out.append("  " + "  |  ".join(cells))
+                i += 1
+            out.append("")
+            continue
+        m = re.match(r"^(#{1,4})\s+(.*)$", line)
+        if m:
+            title = m.group(2).strip()
+            out.append("")
+            out.append(title.upper() if len(m.group(1)) <= 2 else title)
+            out.append("-" * min(len(title), 60))
+            i += 1
+            continue
+        if line.strip() in ("---", "***", "___"):
+            out.append("-" * 40)
+            i += 1
+            continue
+        s = re.sub(r"\*\*(.+?)\*\*", r"\1", line)
+        s = re.sub(r"`(.+?)`", r"\1", s)
+        s = re.sub(r"\[(.+?)\]\((https?://[^\s)]+)\)", r"\1 (\2)", s)
+        s = re.sub(r"^_(.+)_$", r"\1", s.strip())
+        out.append(s)
+        i += 1
+    txt = "\n".join(out)
+    return re.sub(r"\n{3,}", "\n\n", txt).strip()
+
+
+def _inline_md(s: str) -> str:
+    s = html.escape(s)
+    s = re.sub(r"\*\*(.+?)\*\*", r"<strong>\1</strong>", s)
+    s = re.sub(r"(?<!\*)\*(?!\*)(.+?)(?<!\*)\*(?!\*)", r"<em>\1</em>", s)
+    s = re.sub(r"`(.+?)`", r"<code>\1</code>", s)
+    s = re.sub(r"\[(.+?)\]\((https?://[^\s)]+)\)",
+               r'<a href="\2">\1</a>', s)
+    return s
+
+
+def _md_to_html(text: str) -> str:
+    """Minimal but correct Markdown → HTML (headings, tables, lists, bold,
+    code, links). The reports are Markdown, so emailing them as preformatted
+    text showed raw `#`/`|` symbols — this renders them properly."""
+    lines = text.split("\n")
+    out, i, n = [], 0, len(lines)
+    while i < n:
+        line = lines[i]
+        # table block: a header row of pipes followed by a |---| separator
+        if "|" in line and i + 1 < n and re.match(r"^\s*\|?[\s:\-|]+\|?\s*$", lines[i + 1]):
+            header = [c.strip() for c in line.strip().strip("|").split("|")]
+            i += 2
+            rows = []
+            while i < n and "|" in lines[i]:
+                rows.append([c.strip() for c in lines[i].strip().strip("|").split("|")])
+                i += 1
+            th = "".join(f"<th style='text-align:left;padding:6px 10px;"
+                         f"border-bottom:2px solid #ddd'>{_inline_md(c)}</th>" for c in header)
+            trs = ""
+            for r in rows:
+                tds = "".join(f"<td style='padding:6px 10px;border-bottom:1px solid #eee'>"
+                              f"{_inline_md(c)}</td>" for c in r)
+                trs += f"<tr>{tds}</tr>"
+            out.append(f"<table style='border-collapse:collapse;margin:10px 0;"
+                       f"font-size:13px'><thead><tr>{th}</tr></thead><tbody>{trs}</tbody></table>")
+            continue
+        m = re.match(r"^(#{1,4})\s+(.*)$", line)
+        if m:
+            lvl = len(m.group(1))
+            size = {1: 20, 2: 16, 3: 14, 4: 13}[lvl]
+            out.append(f"<h{lvl} style='font-size:{size}px;margin:14px 0 6px;"
+                       f"color:#0265DC'>{_inline_md(m.group(2))}</h{lvl}>")
+            i += 1
+            continue
+        if re.match(r"^\s*[-*]\s+", line):
+            items = []
+            while i < n and re.match(r"^\s*[-*]\s+", lines[i]):
+                item_text = re.sub(r"^\s*[-*]\s+", "", lines[i])
+                items.append(f"<li>{_inline_md(item_text)}</li>")
+                i += 1
+            out.append(f"<ul style='margin:6px 0 6px 18px'>{''.join(items)}</ul>")
+            continue
+        if line.strip() in ("---", "***", "___"):
+            out.append("<hr style='border:none;border-top:1px solid #e3e6ea;margin:12px 0'>")
+            i += 1
+            continue
+        if line.strip() == "":
+            out.append("<div style='height:6px'></div>")
+            i += 1
+            continue
+        out.append(f"<p style='margin:4px 0'>{_inline_md(line)}</p>")
+        i += 1
+    body = "".join(out)
+    return (
+        '<html><body style="margin:0;padding:18px;background:#f6f7f9;">'
+        '<div style="font-family:-apple-system,Segoe UI,Roboto,sans-serif;'
+        'font-size:14px;line-height:1.55;color:#1a1a1a;background:#ffffff;'
+        'padding:22px 26px;border-radius:12px;border:1px solid #e3e6ea;'
+        'max-width:780px;margin:0 auto;">'
+        f'{body}'
+        '<p style="font-size:11px;color:#8a8a8a;margin:16px 0 0;border-top:'
+        '1px solid #eee;padding-top:10px;">Sent by Chan Compass · educational '
+        'tool, not investment advice.</p>'
+        '</div></body></html>'
+    )
+
+
+def _parse_recipients(raw: str) -> list:
+    parts = re.split(r"[,;\s]+", (raw or "").strip())
+    return [p for p in parts if _EMAIL_RE.match(p)]
+
+
+def _close(server):
+    if server is not None:
         try:
-            import llama_cpp  # noqa: F401
+            server.quit()
+        except Exception:
+            try:
+                server.close()
+            except Exception:
+                pass
+
+
+def _send_via_resend(recipients: list, subject: str, content: str) -> str:
+    """HTTPS POST to Resend — works on HF (port 443). Returns '' on success."""
+    payload = json.dumps({
+        "from": RESEND_FROM,
+        "to": recipients,
+        "subject": subject,
+        "text": _md_to_plain(content),
+        "html": _md_to_html(content),
+    }).encode("utf-8")
+    req = urllib.request.Request(
+        "https://api.resend.com/emails", data=payload, method="POST",
+        headers={"Authorization": f"Bearer {RESEND_API_KEY}",
+                 "Content-Type": "application/json",
+                 # Resend/Cloudflare reject requests with no User-Agent
+                 # (403, error code 1010) before they reach the API.
+                 "User-Agent": "chan-compass/1.0 (+https://huggingface.co/spaces)"})
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            body = resp.read().decode("utf-8", "ignore")
+        if '"id"' in body:
             return ""
-        except Exception as e:
-            _set_stage(worker, "install FAILED", f"installed but import failed: {e}")
-            return f"Installed but import failed: {e}"
-
-
-# ─────────────────────── loading ───────────────────────
-def load_model(name: str, worker: str = "analyst") -> str:
-    worker = _wk(worker)
-    """Load a GGUF into a worker slot. Non-blocking: if that worker is already
-    installing/loading, returns its live stage instead of hanging the click."""
-    w = WORKERS[worker]
-    if not w["load_lock"].acquire(timeout=2):
-        return (f"⏳ {WORKER_LABEL[worker]} is busy — current stage: "
-                f"**{w['stage']}** ({w['detail'] or '…'}). Press “↻ Refresh status”.")
+        return f"Resend API responded without an id: {body[:200]}"
+    except urllib.error.HTTPError as e:
+        detail = e.read().decode("utf-8", "ignore")[:200]
+        return f"Resend HTTP {e.code}: {detail}"
+    except Exception as e:
+        return f"Resend request failed: {e}"
+
+
+def _send_via_smtp(recipients: list, subject: str, content: str) -> str:
+    """Classic SMTP — works locally / off-HF. Returns '' on success."""
+    if not EMAIL_SENDER or not EMAIL_PASSWORD:
+        return "SMTP sender not configured."
+    msg = MIMEMultipart("alternative")
+    msg["Subject"] = Header(subject, "utf-8")
+    msg["From"] = _sender_address(EMAIL_SENDER)
+    msg["To"] = ", ".join(recipients)
+    msg.attach(MIMEText(_md_to_plain(content), "plain", "utf-8"))
+    msg.attach(MIMEText(_md_to_html(content), "html", "utf-8"))
+    domain = EMAIL_SENDER.split("@")[-1].lower()
+    sc = SMTP_CONFIGS.get(domain, {"server": f"smtp.{domain}", "port": 465, "ssl": True})
+    server = None
     try:
-        if w["llm"] is not None and w["model"] == name:
-            return f"Already loaded on {WORKER_LABEL[worker]}: {name}"
-        err = _ensure_llama_cpp(worker)
-        if err:
-            return err
-        try:
-            from llama_cpp import Llama
-        except Exception as e:
-            _set_stage(worker, "import FAILED", str(e))
-            return f"llama-cpp-python is not available: {e}"
-        repo, fname = MODEL_ZOO[name]
-        try:
-            _set_stage(worker, "downloading GGUF",
-                       f"{repo}/{fname} (cached on /data after first time)")
-            path = hf_hub_download(repo_id=repo, filename=fname)
-        except Exception as e:
-            _set_stage(worker, "download FAILED", str(e))
-            return f"Could not download {repo}/{fname}: {e}"
-        try:
-            _set_stage(worker, "loading model into RAM", name)
-            w["llm"] = None
-            small = worker != "analyst"
-            w["llm"] = Llama(
-                model_path=path,
-                n_ctx=4096 if small else 6144,
-                n_threads=(4 if small else _NCPU),   # leave headroom for parallel agents
-                n_threads_batch=(6 if small else _NCPU),
-                n_batch=512,
-                verbose=False,
-            )
-            w["model"] = name
-            _set_stage(worker, "ready", name)
-            return f"✅ {WORKER_LABEL[worker]} ready: {name}"
-        except Exception as e:
-            w["llm"] = None
-            _set_stage(worker, "load FAILED", str(e))
-            return f"Failed to load model: {e}"
-    finally:
-        w["load_lock"].release()
-
-
-def auto_load_all():
-    """Startup: tiny agents first (one small GGUF download serves all three),
-    then the Analyst. Runs in a background thread."""
-    for key in ("translator", "narrator", "reporter", "analyst"):
-        load_model(WORKERS[key]["model"], worker=key)
-
-
-# ─────────────────────── status ───────────────────────
-def is_loaded(worker: str = None) -> bool:
-    if worker:
-        return WORKERS[_wk(worker)]["llm"] is not None
-    return any(w["llm"] is not None for w in WORKERS.values())
-
-
-def status() -> str:
-    lines = []
-    for key in ("translator", "narrator", "reporter", "analyst"):
-        w = WORKERS[key]
-        label = WORKER_LABEL[key]
-        if w["llm"] is not None:
-            lines.append(f"✅ **{label}** — {w['model']} · llama.cpp, local")
-        elif w["stage"] == "idle":
-            lines.append(f"⚪ **{label}** — not loaded yet (auto-loads at startup)")
+        if sc["ssl"]:
+            server = smtplib.SMTP_SSL(sc["server"], sc["port"], timeout=20)
         else:
-            lines.append(f"⏳ **{label}** — {w['stage']} ({w['ts']}): {w['detail'] or '…'}")
-    lines.append("\n_Each sub-agent has its own lock — Explain / narrative / "
-                 "research run in parallel without “model busy”._")
-    return "\n\n".join(lines)
-
-
-# ─────────────────────── inference ───────────────────────
-DEFAULT_SYSTEM = ("You are a sub-agent of Chan Compass, a US-equity dashboard. "
-                  "Answer in clear, concise English.")
-MAX_PROMPT_CHARS = 3200
-
-
-def _messages(user: str, system: str):
-    return [{"role": "system", "content": system + " /no_think"},
-            {"role": "user", "content": user[:MAX_PROMPT_CHARS]}]
-
-
-def chat(user: str, max_tokens: int = 500, temperature: float = 0.3,
-         system: str = DEFAULT_SYSTEM, worker: str = "translator") -> str:
-    """Blocking chat on one sub-agent (used by pipeline/agent code)."""
-    w = WORKERS[_wk(worker)]; worker = _wk(worker)
-    if w["llm"] is None:
+            server = smtplib.SMTP(sc["server"], sc["port"], timeout=20)
+            server.starttls()
+        server.login(EMAIL_SENDER, EMAIL_PASSWORD)
+        server.send_message(msg)
         return ""
-    if not w["lock"].acquire(timeout=180):
-        return f"({WORKER_LABEL[worker]} busy — try again in a moment)"
-    try:
-        out = w["llm"].create_chat_completion(
-            messages=_messages(user, system),
-            max_tokens=max_tokens, temperature=temperature)
-        txt = out["choices"][0]["message"]["content"] or ""
-        return _THINK_RE.sub("", txt).strip()
+    except smtplib.SMTPAuthenticationError:
+        return "SMTP authentication failed (check sender / App Password)."
+    except OSError as e:
+        return f"SMTP network error: {e}"
     except Exception as e:
-        return f"(model error: {e})"
+        return f"SMTP failed: {e}"
     finally:
-        w["lock"].release()
-
-
-def chat_stream(user: str, max_tokens: int = 500, temperature: float = 0.3,
-                system: str = DEFAULT_SYSTEM, worker: str = "translator"):
-    """Streaming chat on one sub-agent — yields cumulative text immediately."""
-    w = WORKERS[_wk(worker)]; worker = _wk(worker)
-    if w["llm"] is None:
-        yield (f"⏳ {WORKER_LABEL[worker]} isn't ready yet — "
-               f"stage: {w['stage']}. Check the **Model** tab.")
-        return
-    if not w["lock"].acquire(timeout=5):
-        yield f"⏳ {WORKER_LABEL[worker]} is finishing another answer — try again in a few seconds."
-        return
-    try:
-        acc = ""
-        for chunk in w["llm"].create_chat_completion(
-                messages=_messages(user, system),
-                max_tokens=max_tokens, temperature=temperature, stream=True):
-            delta = chunk["choices"][0]["delta"].get("content") or ""
-            if not delta:
-                continue
-            acc += delta
-            yield _THINK_RE.sub("", acc).replace("<think>", "").strip()
-        if not acc.strip():
-            yield "(model returned no text — try again)"
-    except Exception as e:
-        yield f"(model error: {e})"
-    finally:
-        w["lock"].release()
-
-
-def quick_test() -> str:
-    """Sanity check both sub-agents."""
-    import time
-    outs = []
-    for key in ("translator", "narrator", "reporter", "analyst"):
-        if WORKERS[key]["llm"] is None:
-            outs.append(f"{WORKER_LABEL[key]}: not loaded ({WORKERS[key]['stage']})")
-            continue
-        t0 = time.time()
-        out = chat("Reply with exactly: OK", max_tokens=6, temperature=0.0, worker=key)
-        outs.append(f"{WORKER_LABEL[key]}: **{out or '(no output)'}** · {time.time()-t0:.1f}s")
-    return "\n\n".join(outs)
+        _close(server)
+
+
+def send_result(content: str, recipients_raw: str, subject_tag: str) -> str:
+    """Send `content` to the address(es). Prefers the Resend HTTPS API (works on
+    HF Spaces); falls back to SMTP. English status string for the UI."""
+    if not content or not content.strip():
+        return "⚠️ Nothing to send yet — generate a result first."
+    if content.strip().startswith(("⏳", "🤖 _", "Run ", "Enter ", "Select ")):
+        return "⚠️ Wait for the AI result to finish, then send."
+    recipients = _parse_recipients(recipients_raw)
+    if not recipients:
+        return "⚠️ Enter a valid email address (e.g. name@example.com)."
+
+    subject = (f"Chan Compass · {subject_tag} · "
+               f"{datetime.now().strftime('%Y-%m-%d %H:%M')}")
+
+    errors = []
+    if RESEND_API_KEY:
+        err = _send_via_resend(recipients, subject, content)
+        if not err:
+            return f"✅ Sent to {', '.join(recipients)} (via Resend API)."
+        errors.append(err)
+    smtp_err = _send_via_smtp(recipients, subject, content)
+    if not smtp_err:
+        return f"✅ Sent to {', '.join(recipients)} (via SMTP)."
+    errors.append(smtp_err)
+
+    if not RESEND_API_KEY:
+        return ("❌ SMTP is blocked on Hugging Face Spaces (outbound mail ports "
+                "are closed). Fix: create a free key at resend.com and add it as "
+                "a Space secret named **RESEND_API_KEY** (then it sends over "
+                f"HTTPS). Detail: {smtp_err}")
+    return "❌ Send failed. " + " | ".join(errors)

news_watch.py

@@ -1,189 +1,105 @@
 """
-news_watch.py — daily news check for held tickers (US version, yfinance.news).
-
-Rule requested by the user: for each holding, look only at TODAY's news.
-If there is news → push a short AI brief. If there is none → ignore (the
-ticker is listed under "Quiet today" so you know it was checked).
+finetune_data.py — capture (instruction, input, output) pairs from live app use,
+then export a clean JSONL ready for LoRA SFT (the 🎯 Well-Tuned badge).
+
+Every time the Signals "AI summary" runs, app.py calls `record()` with the
+English raw read (input) and the model's narrative (output). Pairs accumulate
+on the /data bucket and survive restarts; the Model tab has an "Export dataset"
+button that writes a timestamped JSONL and reports the count.
+
+The dataset teaches a small model ONE focused skill — turn a Chan-theory raw
+read into a crisp long-hold trading summary — which is exactly what the app's
+Translator sub-agent does. A 1.7B model fine-tuned on this beats a generic 4B
+at the task, and doubles as the Tiny Titan entry.
 """
 from __future__ import annotations
 
-import datetime as dt
+import json
 import os
-import traceback
+import re
+import threading
+import datetime as dt
 
 import paths
 
-HOLDINGS_FILE = os.path.join(paths.OUTPUT_DIR, "holdings.txt")
+_PAIRS = os.path.join(paths.DATASET_DIR, "pairs.jsonl")
+_lock = threading.Lock()
+
+INSTRUCTION = ("You are an equity analyst. Based only on this factual read of a "
+               "US stock's multi-timeframe Chan-theory verdict, write a short "
+               "plain-English summary for a long-term holder: the situation "
+               "today, whether to act or wait, and the key price levels. "
+               "Max 90 words, no disclaimers.")
+
 
+def _clean(text: str) -> str:
+    # strip stray think tags and any "AI narrative ..." UI prefix
+    text = re.sub(r"<think>.*?</think>", "", text, flags=re.S)
+    text = re.sub(r"^🤖\s*\*\*AI narrative[^\n]*\*\*\s*", "", text)
+    text = text.replace("🤖 **AI narrative (Translator sub-agent · Qwen3-1.7B):**", "")
+    return text.strip()
 
-# ── holdings persistence ─────────────────────────────────────────────────
-def load_holdings() -> list:
+
+def record(raw_read: str, narrative: str):
+    """Append one training pair. Silently ignores junk / unloaded-model output."""
+    narrative = _clean(narrative)
+    if not raw_read or not narrative or len(narrative) < 40:
+        return
+    if narrative.startswith(("⏳", "(", "Run the analysis")):
+        return
+    row = {"instruction": INSTRUCTION, "input": raw_read.strip(), "output": narrative}
     try:
-        with open(HOLDINGS_FILE, encoding="utf-8") as f:
-            return [x.strip().upper() for x in f if x.strip()]
-    except FileNotFoundError:
-        return []
-
-
-def save_holdings(tickers: list):
-    seen, out = set(), []
-    for t in tickers:
-        t = t.strip().upper()
-        if t and t not in seen:
-            seen.add(t)
-            out.append(t)
-    with open(HOLDINGS_FILE, "w", encoding="utf-8") as f:
-        f.write("\n".join(out))
-    return out
+        with _lock, open(_PAIRS, "a", encoding="utf-8") as f:
+            f.write(json.dumps(row, ensure_ascii=False) + "\n")
+    except OSError:
+        pass
 
 
-# ── news fetch ───────────────────────────────────────────────────────────
-def _today_utc() -> dt.date:
-    return dt.datetime.now(dt.timezone.utc).date()
+def count() -> int:
+    try:
+        with open(_PAIRS, encoding="utf-8") as f:
+            return sum(1 for _ in f)
+    except OSError:
+        return 0
 
 
-def fetch_today_news(ticker: str) -> list:
-    """Return today's news items: [{'title','publisher','time','link'}…]."""
+def export() -> str:
+    """De-duplicate and write a timestamped JSONL. Returns the file path so the
+    UI can offer it as a direct download."""
+    n = count()
+    if n == 0:
+        return ""
+    seen, rows = set(), []
     try:
-        import yfinance as yf
-        items = yf.Ticker(ticker).news or []
-    except Exception:
-        traceback.print_exc()
-        return []
-    today = _today_utc()
-    out = []
-    for it in items:
-        # yfinance has two schemas: legacy flat dict, or {'content': {...}}
-        c = it.get("content", it)
-        title = c.get("title") or ""
-        ts = it.get("providerPublishTime")
-        when = None
-        if ts:
-            when = dt.datetime.fromtimestamp(ts, dt.timezone.utc)
-        else:
-            pub = c.get("pubDate") or c.get("displayTime")
-            if pub:
+        with open(_PAIRS, encoding="utf-8") as f:
+            for line in f:
+                line = line.strip()
+                if not line:
+                    continue
                 try:
-                    when = dt.datetime.fromisoformat(str(pub).replace("Z", "+00:00"))
+                    r = json.loads(line)
                 except ValueError:
-                    when = None
-        if when is None or when.date() != today:
-            continue
-        pubr = c.get("publisher") or (c.get("provider") or {}).get("displayName") or ""
-        link = c.get("link") or (c.get("canonicalUrl") or {}).get("url") or ""
-        if title:
-            out.append({"title": title, "publisher": pubr,
-                        "time": when.strftime("%H:%M UTC"), "link": link})
-    return out
-
-
-def _llm_brief(ticker: str, items: list) -> str:
-    heads = "\n".join(f"- [{x['time']}] {x['title']} ({x['publisher']})" for x in items)
+                    continue
+                key = (r.get("input", ""), r.get("output", ""))
+                if key in seen:
+                    continue
+                seen.add(key)
+                rows.append(r)
+    except OSError:
+        return ""
+    stamp = dt.datetime.utcnow().strftime("%Y%m%d-%H%M%S")
+    out = os.path.join(paths.DATASET_DIR, f"chan_sft_{stamp}.jsonl")
     try:
-        import llm_local
-        if not llm_local.is_loaded():
-            return ""
-        prompt = (
-            f"You are an equity news analyst. Today's headlines for {ticker} "
-            f"(a stock the user currently HOLDS):\n{heads}\n\n"
-            "In ENGLISH ONLY, write:\n"
-            "1) **Per-headline:** one short line per headline above — what it says "
-            "and why it matters (or 'noise') for the holding;\n"
-            "2) **Net read:** POSITIVE / NEGATIVE / NEUTRAL with one sentence why;\n"
-            "3) **Action:** one concrete suggestion. ≤180 words, no disclaimers."
-        )
-        return llm_local.chat(prompt, max_tokens=420, worker="reporter")
-    except Exception:
+        with open(out, "w", encoding="utf-8") as f:
+            for r in rows:
+                f.write(json.dumps(r, ensure_ascii=False) + "\n")
+    except OSError:
         return ""
+    return out
 
 
-def check_holdings_news_stream(tickers=None):
-    """Generator for the UI: emits cumulative markdown as it goes — each ticker,
-    each headline, and each AI brief appears the moment it's ready, so the user
-    never stares at a frozen screen. AI briefs run on the Reporter sub-agent."""
-    import llm_local
-    tickers = tickers if tickers is not None else load_holdings()
-    if not tickers:
-        yield ("**No holdings configured.** Add tickers above (e.g. `AAPL, NVDA`) "
-               "and save — they'll be checked for news every day.")
-        return
-    stamp = dt.datetime.now(dt.timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
-    out = [f"_Checking {len(tickers)} holding(s) · {stamp}_"]
-    quiet = []
-
-    def render():
-        body = "\n".join(out)
-        if quiet:
-            body += f"\n\n**Quiet today (no news):** {', '.join(quiet)}"
-        return body
-
-    for t in tickers:
-        out.append(f"\n### 📰 {t} …searching today's news")
-        yield render()
-        items = fetch_today_news(t)
-        if not items:
-            out.pop()             # drop the "searching" line
-            quiet.append(t)
-            yield render()
-            continue
-        out[-1] = f"\n### 📰 {t} — {len(items)} item(s) today"
-        yield render()
-        # print each headline the moment we have it
-        for x in items[:6]:
-            link = f" · [link]({x['link']})" if x["link"] else ""
-            out.append(f"- **{x['time']}** {x['title']} — *{x['publisher']}*{link}")
-            yield render()
-        # then stream the AI brief for this ticker (Reporter sub-agent)
-        if llm_local.is_loaded("reporter") or llm_local.is_loaded("translator"):
-            wk = "reporter" if llm_local.is_loaded("reporter") else "translator"
-            heads = "\n".join(f"- [{x['time']}] {x['title']} ({x['publisher']})"
-                               for x in items[:6])
-            prompt = (
-                f"You are an equity news analyst. Today's headlines for {ticker_safe(t)} "
-                f"(a stock the user HOLDS):\n{heads}\n\nIn ENGLISH ONLY:\n"
-                f"1) **Per-headline:** one short line each — what it says and why it "
-                f"matters (or 'noise');\n2) **Net read:** POSITIVE / NEGATIVE / NEUTRAL "
-                f"+ one sentence;\n3) **Action:** one concrete suggestion. ≤180 words.")
-            out.append("\n> 🤖 **Reporter sub-agent brief:** _thinking…_")
-            base = len(out) - 1
-            for acc in llm_local.chat_stream(prompt, max_tokens=420, worker=wk):
-                out[base] = "> 🤖 **Reporter sub-agent brief:**\n>\n> " + \
-                    acc.replace("\n", "\n> ")
-                yield render()
-        else:
-            out.append("\n> _Model still loading — headlines shown; brief will work shortly._")
-            yield render()
-    out.append(f"\n_Done · {stamp}_")
-    yield render()
-
-
-def ticker_safe(t):
-    return str(t).upper()
-
-
-def check_holdings_news(tickers=None) -> str:
-    """Markdown report: AI brief per holding with today-news; quiet list otherwise."""
-    tickers = tickers if tickers is not None else load_holdings()
-    if not tickers:
-        return ("**No holdings configured.** Add tickers above (e.g. `AAPL, NVDA`) "
-                "and save — they'll be checked for news every day.")
-    blocks, quiet = [], []
-    for t in tickers:
-        items = fetch_today_news(t)
-        if not items:
-            quiet.append(t)
-            continue
-        lines = [f"### 📰 {t} — {len(items)} item(s) today"]
-        for x in items[:6]:
-            link = f" · [link]({x['link']})" if x["link"] else ""
-            lines.append(f"- **{x['time']}** {x['title']} — *{x['publisher']}*{link}")
-        brief = _llm_brief(t, items)
-        if brief:
-            lines.append(f"\n> 🤖 **AI brief:** {brief}")
-        else:
-            lines.append("\n> _Load a model in the Model tab for an AI brief._")
-        blocks.append("\n".join(lines))
-    if quiet:
-        blocks.append(f"**Quiet today (no news, ignored):** {', '.join(quiet)}")
-    stamp = dt.datetime.now(dt.timezone.utc).strftime("%Y-%m-%d %H:%M UTC")
-    return f"_Checked {stamp}_\n\n" + ("\n\n---\n\n".join(blocks) if blocks else "No output.")
+def status_line() -> str:
+    n = count()
+    if n == 0:
+        return "_No fine-tuning pairs captured yet — run a few Signals AI summaries._"
+    return f"📚 **{n}** training pair(s) captured on /data (target: 200-500 for a good LoRA)."

paths.py

@@ -1,64 +1,307 @@
 """
-paths.py — persistent storage layout on the Hugging Face storage bucket (/data).
+llm_local.py — local sub-agent pool (llama.cpp runtime, no cloud APIs).
 
-If /data exists and is writable (the Space has a storage bucket attached),
-everything that should survive restarts/sleep lives there:
+Two independent model instances ("sub-agents"), each with its own lock, so
+features never block each other with "model busy":
 
-    /data/cache_us     market-data parquet cache (yfinance downloads)
-    /data/output       signal CSVs, holdings.txt
-    /data/reports      auto-generated research reports (markdown)
-    /data/traces       agent traces (JSON) — shareable on the Hub (📡 badge)
-    /data/hf_cache     GGUF model files (downloaded once, kept forever)
-    /data/pylibs       llama-cpp-python installed once at runtime, persisted
+    fast  · Summary Sub-Agent (Chan-Tuned Qwen3-1.7B)
+            → Explain-in-English, sector-rotation narrative, news briefs.
+            Small = quick CPU prefill, answers start streaming in seconds.
+    deep  · Analyst — Qwen3-4B Q4_K_M by default (swappable in the Model tab)
+            → the multi-step Auto Research agent's report writing.
 
-Without a bucket the app still works — it just falls back to the container
-filesystem (wiped on restart).
+Both run through llama.cpp (llama-cpp-python) and are far below the 32B cap;
+the fast worker doubles as the "Tiny Titan" (≤4B) story. ~5 GB RAM total on a
+32 GB Space. Earns "Off the Grid" + "Llama Champion".
 """
 from __future__ import annotations
 
 import os
-import sys
+import re
+import threading
 
+import paths  # sets HF_HOME + sys.path for /data persistence
+from huggingface_hub import hf_hub_download
 
-def _writable(p: str) -> bool:
+# name -> (HF repo, gguf filename)
+MODEL_ZOO = {
+    "Chan-Tuned Qwen3-1.7B · my fine-tune": (
+        "ranranrunforit/chan-compass-qwen3-1.7b-gguf", "qwen3-1.7b.Q8_0.gguf"),
+    "Qwen3-1.7B · Tiny Titan (≤4B award class)": (
+        "Qwen/Qwen3-1.7B-GGUF", "Qwen3-1.7B-Q8_0.gguf"),
+    "Qwen3-4B  · default — fast + smart, still ≤4B": (
+        "Qwen/Qwen3-4B-GGUF", "Qwen3-4B-Q4_K_M.gguf"),
+    "Qwen3-8B  · best balance on 8 vCPU / 32 GB": (
+        "Qwen/Qwen3-8B-GGUF", "Qwen3-8B-Q4_K_M.gguf"),
+    "Qwen3-14B · max quality (still far under 32B cap)": (
+        "Qwen/Qwen3-14B-GGUF", "Qwen3-14B-Q4_K_M.gguf"),
+}
+# Only the Summary sub-agent (Signals · Explain) uses the published
+# fine-tune; every other sub-agent stays on the stock models.
+FAST_MODEL = "Qwen3-1.7B · Tiny Titan (≤4B award class)"
+TRANSLATOR_MODEL = "Chan-Tuned Qwen3-1.7B · my fine-tune"
+DEFAULT_MODEL = "Qwen3-4B  · default — fast + smart, still ≤4B"
+
+_THINK_RE = re.compile(r"<think>.*?</think>", re.S)
+_NCPU = max(2, (os.cpu_count() or 4))
+
+# One dedicated sub-agent per feature — independent locks, so Signals-Explain,
+# Rotation narrative, News briefs and Auto-Research never fight over a model.
+# Three tiny 1.7B instances share ONE GGUF file on disk (~2 GB RAM each) and
+# the 4B Analyst writes reports. Total ≈ 9 GB on a 32 GB Space.
+WORKER_LABEL = {
+    "translator": "Summary sub-agent (Signals · Explain)",
+    "narrator":   "Narrator sub-agent (Sector Rotation)",
+    "reporter":   "Reporter sub-agent (News · Research support)",
+    "analyst":    "Analyst sub-agent (Auto Research)",
+}
+
+
+def _mk(model):
+    return {"model": model, "llm": None, "lock": threading.Lock(),
+            "load_lock": threading.Lock(), "stage": "idle", "detail": "", "ts": None}
+
+
+WORKERS = {
+    "translator": _mk(TRANSLATOR_MODEL),
+    "narrator":   _mk(FAST_MODEL),
+    "reporter":   _mk(FAST_MODEL),
+    "analyst":    _mk(DEFAULT_MODEL),
+}
+# legacy aliases
+_ALIAS = {"fast": "translator", "deep": "analyst"}
+
+
+def _wk(worker: str) -> str:
+    return _ALIAS.get(worker, worker)
+
+_install_lock = threading.Lock()
+
+
+def _set_stage(worker: str, stage: str, detail: str = ""):
+    import datetime as _dt
+    w = WORKERS[worker]
+    w.update(stage=stage, detail=detail[:400],
+             ts=_dt.datetime.utcnow().strftime("%H:%M:%S UTC"))
     try:
-        return os.path.isdir(p) and os.access(p, os.W_OK)
-    except OSError:
-        return False
+        import automation
+        automation._log(f"[{WORKER_LABEL[worker]}] {stage}: {detail[:140]}")
+    except Exception:
+        pass
 
 
-DATA_ROOT = "/data" if _writable("/data") else "."
-PERSISTENT = DATA_ROOT == "/data"
+# ─────────────────────── runtime install (once, persisted) ───────────────────────
+# Installed at RUNTIME, not at Space build time: the HF build container has
+# little RAM and gets OOM-killed compiling the C++ extension; the runtime
+# container has the real hardware. Prebuilt CPU wheel first, capped-parallelism
+# source build as fallback. Persisted to /data/pylibs.
+_WHEEL_INDEX = "https://abetlen.github.io/llama-cpp-python/whl/cpu"
+_LLAMA_REQ = "llama-cpp-python>=0.3.8"   # >=0.3.8 → Qwen3 architecture support
 
-CACHE_DIR = os.path.join(DATA_ROOT, "cache_us")
-OUTPUT_DIR = os.path.join(DATA_ROOT, "output") if PERSISTENT else "./_app_output"
-REPORTS_DIR = os.path.join(DATA_ROOT, "reports")
-TRACES_DIR = os.path.join(DATA_ROOT, "traces")
-DATASET_DIR = os.path.join(DATA_ROOT, "dataset")   # SFT training pairs (JSONL)
-HF_CACHE_DIR = os.path.join(DATA_ROOT, "hf_cache")
-PYLIBS_DIR = os.path.join(DATA_ROOT, "pylibs")
 
-for _d in (CACHE_DIR, OUTPUT_DIR, REPORTS_DIR, TRACES_DIR, DATASET_DIR, HF_CACHE_DIR, PYLIBS_DIR):
+def _ensure_llama_cpp(worker: str) -> str:
     try:
-        os.makedirs(_d, exist_ok=True)
-    except OSError:
+        import llama_cpp  # noqa: F401
+        return ""
+    except ImportError:
         pass
+    import subprocess
+    import sys
+    with _install_lock:
+        try:  # another thread may have finished it while we waited
+            import llama_cpp  # noqa: F401
+            return ""
+        except ImportError:
+            pass
+        env = dict(os.environ)
+        env["CMAKE_BUILD_PARALLEL_LEVEL"] = "4"
+        _set_stage(worker, "installing llama.cpp runtime",
+                   "trying official prebuilt CPU wheel (≈1 min)…")
+        if paths.PERSISTENT:
+            base = [sys.executable, "-m", "pip", "install", "--prefer-binary",
+                    "--target", paths.PYLIBS_DIR]
+        else:
+            base = [sys.executable, "-m", "pip", "install", "--user", "--prefer-binary"]
+        r = subprocess.run(base + ["--extra-index-url", _WHEEL_INDEX,
+                                   "--only-binary", "llama-cpp-python", _LLAMA_REQ],
+                           capture_output=True, text=True, env=env, timeout=600)
+        if r.returncode != 0:
+            _set_stage(worker, "installing llama.cpp runtime",
+                       "no prebuilt wheel matched — compiling from source "
+                       "(one-time ~10-15 min; other tabs keep working)…")
+            r = subprocess.run(base + ["--extra-index-url", _WHEEL_INDEX, _LLAMA_REQ],
+                               capture_output=True, text=True, env=env, timeout=2400)
+        if r.returncode != 0:
+            err = (r.stderr or r.stdout or "")[-800:]
+            _set_stage(worker, "install FAILED", err)
+            return "Could not install llama-cpp-python at runtime:\n" + err
+        import importlib
+        import site
+        cands = [paths.PYLIBS_DIR] if paths.PERSISTENT else []
+        usp = site.getusersitepackages()
+        cands += usp if isinstance(usp, list) else [usp]
+        for p in cands:
+            if p and p not in sys.path:
+                sys.path.append(p)
+        importlib.invalidate_caches()
+        try:
+            import llama_cpp  # noqa: F401
+            return ""
+        except Exception as e:
+            _set_stage(worker, "install FAILED", f"installed but import failed: {e}")
+            return f"Installed but import failed: {e}"
+
+
+# ─────────────────────── loading ───────────────────────
+def load_model(name: str, worker: str = "analyst") -> str:
+    worker = _wk(worker)
+    """Load a GGUF into a worker slot. Non-blocking: if that worker is already
+    installing/loading, returns its live stage instead of hanging the click."""
+    w = WORKERS[worker]
+    if not w["load_lock"].acquire(timeout=2):
+        return (f"⏳ {WORKER_LABEL[worker]} is busy — current stage: "
+                f"**{w['stage']}** ({w['detail'] or '…'}). Press “↻ Refresh status”.")
+    try:
+        if w["llm"] is not None and w["model"] == name:
+            return f"Already loaded on {WORKER_LABEL[worker]}: {name}"
+        err = _ensure_llama_cpp(worker)
+        if err:
+            return err
+        try:
+            from llama_cpp import Llama
+        except Exception as e:
+            _set_stage(worker, "import FAILED", str(e))
+            return f"llama-cpp-python is not available: {e}"
+        repo, fname = MODEL_ZOO[name]
+        try:
+            _set_stage(worker, "downloading GGUF",
+                       f"{repo}/{fname} (cached on /data after first time)")
+            path = hf_hub_download(repo_id=repo, filename=fname)
+        except Exception as e:
+            _set_stage(worker, "download FAILED", str(e))
+            return f"Could not download {repo}/{fname}: {e}"
+        try:
+            _set_stage(worker, "loading model into RAM", name)
+            w["llm"] = None
+            small = worker != "analyst"
+            w["llm"] = Llama(
+                model_path=path,
+                n_ctx=4096 if small else 6144,
+                n_threads=(4 if small else _NCPU),   # leave headroom for parallel agents
+                n_threads_batch=(6 if small else _NCPU),
+                n_batch=512,
+                verbose=False,
+            )
+            w["model"] = name
+            _set_stage(worker, "ready", name)
+            return f"✅ {WORKER_LABEL[worker]} ready: {name}"
+        except Exception as e:
+            w["llm"] = None
+            _set_stage(worker, "load FAILED", str(e))
+            return f"Failed to load model: {e}"
+    finally:
+        w["load_lock"].release()
 
-# GGUF downloads (hf_hub_download) go to the bucket so models persist
-if PERSISTENT:
-    os.environ.setdefault("HF_HOME", HF_CACHE_DIR)
 
-# llama-cpp-python installed into the bucket must be importable.
-# APPEND (not insert) so bucket-installed copies of common deps (numpy etc.)
-# can never shadow the system site-packages the app was built against.
-if PERSISTENT and PYLIBS_DIR not in sys.path:
-    sys.path.append(PYLIBS_DIR)
+def auto_load_all():
+    """Startup: tiny agents first (one small GGUF download serves all three),
+    then the Analyst. Runs in a background thread."""
+    for key in ("translator", "narrator", "reporter", "analyst"):
+        load_model(WORKERS[key]["model"], worker=key)
+
+
+# ─────────────────────── status ───────────────────────
+def is_loaded(worker: str = None) -> bool:
+    if worker:
+        return WORKERS[_wk(worker)]["llm"] is not None
+    return any(w["llm"] is not None for w in WORKERS.values())
+
+
+def status() -> str:
+    lines = []
+    for key in ("translator", "narrator", "reporter", "analyst"):
+        w = WORKERS[key]
+        label = WORKER_LABEL[key]
+        if w["llm"] is not None:
+            lines.append(f"✅ **{label}** — {w['model']} · llama.cpp, local")
+        elif w["stage"] == "idle":
+            lines.append(f"⚪ **{label}** — not loaded yet (auto-loads at startup)")
+        else:
+            lines.append(f"⏳ **{label}** — {w['stage']} ({w['ts']}): {w['detail'] or '…'}")
+    lines.append("\n_Each sub-agent has its own lock — Explain / narrative / "
+                 "research run in parallel without “model busy”._")
+    return "\n\n".join(lines)
+
+
+# ─────────────────────── inference ───────────────────────
+DEFAULT_SYSTEM = ("You are a sub-agent of Chan Compass, a US-equity dashboard. "
+                  "Answer in clear, concise English.")
+MAX_PROMPT_CHARS = 3200
+
+
+def _messages(user: str, system: str):
+    return [{"role": "system", "content": system + " /no_think"},
+            {"role": "user", "content": user[:MAX_PROMPT_CHARS]}]
+
+
+def chat(user: str, max_tokens: int = 500, temperature: float = 0.3,
+         system: str = DEFAULT_SYSTEM, worker: str = "translator") -> str:
+    """Blocking chat on one sub-agent (used by pipeline/agent code)."""
+    w = WORKERS[_wk(worker)]; worker = _wk(worker)
+    if w["llm"] is None:
+        return ""
+    if not w["lock"].acquire(timeout=180):
+        return f"({WORKER_LABEL[worker]} busy — try again in a moment)"
+    try:
+        out = w["llm"].create_chat_completion(
+            messages=_messages(user, system),
+            max_tokens=max_tokens, temperature=temperature)
+        txt = out["choices"][0]["message"]["content"] or ""
+        return _THINK_RE.sub("", txt).strip()
+    except Exception as e:
+        return f"(model error: {e})"
+    finally:
+        w["lock"].release()
+
+
+def chat_stream(user: str, max_tokens: int = 500, temperature: float = 0.3,
+                system: str = DEFAULT_SYSTEM, worker: str = "translator"):
+    """Streaming chat on one sub-agent — yields cumulative text immediately."""
+    w = WORKERS[_wk(worker)]; worker = _wk(worker)
+    if w["llm"] is None:
+        yield (f"⏳ {WORKER_LABEL[worker]} isn't ready yet — "
+               f"stage: {w['stage']}. Check the **Model** tab.")
+        return
+    if not w["lock"].acquire(timeout=5):
+        yield f"⏳ {WORKER_LABEL[worker]} is finishing another answer — try again in a few seconds."
+        return
+    try:
+        acc = ""
+        for chunk in w["llm"].create_chat_completion(
+                messages=_messages(user, system),
+                max_tokens=max_tokens, temperature=temperature, stream=True):
+            delta = chunk["choices"][0]["delta"].get("content") or ""
+            if not delta:
+                continue
+            acc += delta
+            yield _THINK_RE.sub("", acc).replace("<think>", "").strip()
+        if not acc.strip():
+            yield "(model returned no text — try again)"
+    except Exception as e:
+        yield f"(model error: {e})"
+    finally:
+        w["lock"].release()
 
 
-def storage_status() -> str:
-    if PERSISTENT:
-        return ("✅ Persistent storage bucket mounted at `/data` — data cache, "
-                "model files, reports, traces and the llama.cpp runtime all "
-                "survive restarts.")
-    return ("⚠️ No `/data` bucket detected — running on ephemeral container "
-            "storage (everything re-downloads after a restart).")
+def quick_test() -> str:
+    """Sanity check both sub-agents."""
+    import time
+    outs = []
+    for key in ("translator", "narrator", "reporter", "analyst"):
+        if WORKERS[key]["llm"] is None:
+            outs.append(f"{WORKER_LABEL[key]}: not loaded ({WORKERS[key]['stage']})")
+            continue
+        t0 = time.time()
+        out = chat("Reply with exactly: OK", max_tokens=6, temperature=0.0, worker=key)
+        outs.append(f"{WORKER_LABEL[key]}: **{out or '(no output)'}** · {time.time()-t0:.1f}s")
+    return "\n\n".join(outs)

spacing.css

@@ -0,0 +1,35 @@
+/* ============================================================
+   ELEVATION & MOTION — Chan Compass · Spectrum 2
+   Soft, low-spread drop shadows; never heavy. Spectrum easing curves.
+   ============================================================ */
+
+:root {
+  /* ---- Drop shadows (Spectrum 2 elevation) ---- */
+  --shadow-flat:      none;
+  --shadow-raised:    0 1px 3px rgba(0,0,0,.06), 0 1px 1px rgba(0,0,0,.04);
+  --shadow-elevated:  0 2px 8px rgba(0,0,0,.08), 0 1px 2px rgba(0,0,0,.06);
+  --shadow-emphasized:0 6px 20px rgba(0,0,0,.12), 0 2px 6px rgba(0,0,0,.08);
+  --shadow-dragged:   0 12px 32px rgba(0,0,0,.18), 0 4px 10px rgba(0,0,0,.10);
+
+  /* Accent-tinted glow (used on AI / focused panels) */
+  --shadow-accent:    0 2px 12px rgba(2,101,220,.12);
+
+  /* ---- Focus ring ---- */
+  --focus-ring-width: 2px;
+  --focus-ring-offset: 2px;
+
+  /* ---- Motion ---- */
+  --ease-default: cubic-bezier(0.45, 0, 0.4, 1);  /* @kind other */
+  --ease-in:      cubic-bezier(0.5, 0, 1, 1);      /* @kind other */
+  --ease-out:     cubic-bezier(0, 0, 0.4, 1);      /* @kind other */
+  --ease-in-out:  cubic-bezier(0.45, 0, 0.4, 1);   /* @kind other */
+
+  --duration-fast:    130ms;  /* @kind other */
+  --duration-default: 160ms;  /* @kind other */
+  --duration-slow:    220ms;  /* @kind other */
+
+  --transition-default: all var(--duration-default) var(--ease-default);
+  --transition-colors:  color var(--duration-fast) var(--ease-default),
+                        background-color var(--duration-fast) var(--ease-default),
+                        border-color var(--duration-fast) var(--ease-default);
+}

styles.css

@@ -0,0 +1,174 @@
+# Chan Compass · Spectrum 2 Design System
+
+A design system for **Chan Compass · US** — a multi-timeframe 缠论 (Chan theory)
+stock-signal engine — rendered in **Adobe Spectrum 2**, Adobe's design language.
+It exists to give design agents a single, accurate source of truth for building
+beautiful, on-brand Chan Compass interfaces (the live Gradio app, mocks, slides,
+marketing) without re-deriving Spectrum 2 every time.
+
+> **Spectrum 2** is Adobe's open design system. This project recreates its
+> visual foundations (color, type, spacing, elevation, motion) and a set of
+> React components, then applies them to the Chan Compass product surfaces.
+
+---
+
+## What the product is
+
+Chan Compass is an **educational US-equities signal tool** that runs entirely
+locally. It has six surfaces (Gradio tabs):
+
+| Surface | What it does |
+|---|---|
+| **Signals** | Runs the Chan engine over a ticker pool; returns next-session **BUY / SELL / HOLD / WAIT / WATCH** with confidence, suggested weight, stop, and a full multi-timeframe ruling chain (monthly → weekly → daily → 60m → 30m → 15m → 5m nested-interval confirmation). |
+| **Sector Rotation** | Where capital is flowing across the 11 SPDR sector ETFs; flow proxy = change % × dollar volume, plus relative strength vs SPY, over 1 / 5 / 20 days. |
+| **Watchlist News** | Checks **today's** news per holding; pushes an AI brief only when news exists. |
+| **Auto Research** | A local multi-step agent: PLAN → 5 evidence tools → sectioned report, with a saved JSON trace. |
+| **Automation** | Daily pipeline at 18:10 America/New_York. |
+| **Model** | Loads Qwen3 GGUF weights through llama.cpp — everything runs locally, nothing leaves the machine. |
+
+The AI is a **local sub-agent pool** (Qwen3-1.7B translator/narrator + a deeper
+analyst), served via `llama-cpp-python`. Data comes from Yahoo Finance.
+
+## Sources this system was built from
+
+- **Codebase:** `chan-compass-us-v1.7/` (attached) — a Gradio app (`app.py`)
+  plus the Chan engine (`chan_engine.py`, `chan_multilevel.py`, `chan_enhance.py`),
+  signal/rotation/news/research/automation modules. The app already ships an
+  *approximation* of Spectrum 2 in Gradio CSS; this system replaces it with the
+  real thing. The product deploys as a **Hugging Face Gradio Space**.
+- **Design language — Adobe Spectrum 2 / React Spectrum:**
+  <https://github.com/adobe/react-spectrum> (the `@react-spectrum/s2` package —
+  `style/spectrum-theme.ts`, `style/tokens.ts` — was read for exact spacing,
+  radii, easing, weights and the type scale). Token values were cross-checked
+  against <https://spectrum.adobe.com/page/color-palette/>.
+  Explore that repo to go deeper on component behavior and accessibility.
+
+> **Deploying the live app?** See `gradio/` — a ready-to-paste Spectrum 2 Gradio
+> theme (`theme.py` = `THEME` + `CSS`), a guaranteed-green standalone demo Space,
+> and an HF deploy checklist (`gradio/INTEGRATE.md`).
+
+---
+
+## Content fundamentals
+
+How Chan Compass writes. Match this voice in any UI copy.
+
+- **Voice:** expert, terse, instrument-panel. Copy reads like a trading desk
+  tool, not a consumer app. Short noun phrases over sentences: *"Tomorrow's
+  plan"*, *"Where capital is flowing"*, *"Buy/sell zone"*.
+- **Person:** mostly impersonal/imperative. Buttons are verbs — *"Run analysis"*,
+  *"Check today's news"*, *"Load model"*. When it addresses the user it's second
+  person and possessive — *"My holdings"*, *"your ticker pool"*.
+- **Casing:** **Sentence case** everywhere — labels, buttons, headings
+  (*"Run analysis"*, not "Run Analysis"). Ticker symbols and ETF codes are
+  **UPPERCASE monospace** (NVDA, XLK). Signal verbs render UPPERCASE in pills
+  (BUY/SELL/HOLD).
+- **Bilingual register:** the engine's internal ruling chain is **Chinese**
+  (缠论 terms: 中枢, 背驰, 区间套, 买卖点 B1/B2/B3/S1/S2/S3); user-facing summaries
+  are **English**, produced by the local translator sub-agent. Keep Chinese for
+  authentic engine output; keep English for everything the user reads first.
+- **Numbers carry meaning, not decoration.** Every percent, confidence score,
+  weight and stop price is real signal. No vanity stats. Percentages are signed
+  (+2.43% / −3.08%) and color-coded.
+- **Honesty & disclaimers:** always frames itself as *"educational tool — not
+  investment advice."* States its data limits plainly (*"Yahoo only keeps 7 days
+  of 1-minute bars, so the 1m level is skipped"*). No hype, no guarantees.
+- **AI is labeled.** Anything model-generated is prefixed with the sub-agent and
+  model — *"🤖 Translator sub-agent (Qwen3-1.7B · llama.cpp)"* — and notes
+  latency honestly (*"first words in ~5–15s"*).
+- **Emoji:** the live app uses tab emoji (📈 🔄 📰 🧪 ⏰ 🧠) and the 🧭 brand mark.
+  In the **polished design system we prefer Spectrum line icons** for UI chrome
+  and reserve emoji for the brand mark / casual chips. Don't scatter emoji into
+  data or buttons.
+
+---
+
+## Visual foundations
+
+The Spectrum 2 look, as applied here.
+
+- **Color vibe:** calm, neutral, **light-first**. A near-white canvas
+  (`gray-50 #F8F8F8`) with **white cards** (`gray-25`) and crisp hairline borders
+  (`gray-100 #E6E6E6`). One disciplined accent — **Spectrum blue `#0265DC`** —
+  carries all primary action and selection. Color is otherwise **semantic only**:
+  green = positive/BUY, red = negative/SELL, blue = HOLD/accent, orange = WATCH/notice.
+  No decorative color, no rainbow dashboards.
+- **Type:** **Source Sans 3** for UI and headings (open stand-in for the
+  proprietary Adobe Clean), **Source Serif 4** for editorial/report prose,
+  **Source Code Pro** for tickers, prices and logs. Modular scale, ratio **1.125**,
+  **14px UI base**. Headings are **bold (700)** and slightly tightened
+  (`-0.015em`); body is **regular (400)** at a spacious **1.5** line height.
+- **Spacing:** an **8px base rhythm** (2 · 4 · 8 · 12 · 16 · 24 · 32 · 48 · 64).
+  Generous padding inside cards (24px), comfortable 24–32px gaps between regions.
+- **Backgrounds:** **flat, layered surfaces** — no photographic imagery, no
+  full-bleed art, no repeating textures. Depth comes from Spectrum's
+  *background layering* (canvas → card → subtle well), not from shadows alone.
+  The **only gradient** is a small one on the 🧭 brand mark
+  (blue → indigo → purple), echoing the app's original hero; the rest is solid.
+- **Corner radii:** soft but not pill-everything — **16px cards**, **8px inputs
+  & square buttons**, **4px chips**, and **fully-rounded (pill) action buttons** —
+  the single most recognizable Spectrum 2 signature here.
+- **Elevation:** **soft, low-spread** drop shadows (`raised` = `0 1px 3px
+  rgba(0,0,0,.06)`), never heavy. Cards sit barely off the canvas. The AI panel
+  gets a faint **accent-tinted glow** instead of a darker shadow.
+- **Borders:** 1px hairlines for structure; inputs use a **2px** border that
+  turns accent-blue on focus. Tabs sit on a 2px track and the selected tab draws
+  a 2px accent underline.
+- **Hover / press:** Spectrum's **one-stop-darker** rule — hover bumps a button
+  one color stop darker (`accent → accent-hover`), press goes one more and adds a
+  **subtle `scale(.98)`**. Quiet/ghost controls fill with `gray-75` on hover.
+  Rows highlight to `gray-75` on hover, `blue-100` when selected.
+- **Focus:** a **2px solid accent ring with 2px offset** on every interactive
+  element — visible, never removed.
+- **Motion:** quick and restrained. Durations **130–220ms**; the house easing is
+  Spectrum's `cubic-bezier(0.45, 0, 0.4, 1)` (with `ease-out` for entrances).
+  Fades and one-stop color shifts; **no bounces**, one tasteful pulse for live
+  status and the running pipeline step. Respect `prefers-reduced-motion`.
+- **Transparency / blur:** used sparingly — not a glassmorphism system. Surfaces
+  are opaque; selection tints use solid subtle fills (`blue-100`), not alpha.
+- **Cards:** white surface, 16px radius, 1px hairline border, soft raised shadow,
+  optional header with title + subtitle + a trailing action slot.
+
+---
+
+## Index — what's in this project
+
+**Foundations (root)**
+- `styles.css` — the single entry point consumers link (`@import`s only).
+- `tokens/` — `colors.css` · `typography.css` · `spacing.css` · `elevation.css`
+  · `fonts.css` · `base.css`. Primitives + semantic aliases.
+- `guidelines/` — foundation specimen cards (Colors, Type, Spacing) shown in the
+  Design System tab.
+
+**Components** (`components/<group>/` — React primitives, bundled to `window.<Namespace>`)
+- `actions/` — **Button** (pill, accent/secondary/negative/quiet)
+- `forms/` — **Field**, **Checkbox**, **Switch**
+- `status/` — **Badge**, **StatusLight**, **SignalBadge** (BUY/SELL/HOLD/WAIT/WATCH)
+- `containers/` — **Card**, **InlineAlert** (incl. the signature `ai` panel)
+- `navigation/` — **Tabs** (quiet tabs + accent underline)
+
+**UI kit** (`ui_kits/chan-compass/`)
+- `index.html` — full interactive Spectrum 2 recreation of the 6-tab app
+  (Signals, Rotation, Research, News, Model). Composes the components above.
+
+**Deploy bridge** (`gradio/`)
+- `theme.py` (`THEME` + `CSS`), standalone demo `app.py`, `requirements.txt`,
+  `README.md` (HF Space), `INTEGRATE.md` (port + deploy checklist).
+
+**Meta**
+- `SKILL.md` — makes this folder usable as an Agent Skill.
+
+---
+
+## Iconography
+
+See the **Iconography** section below and the `assets/` README. In short: Chan
+Compass has **no custom icon set** of its own — the live app leans on **emoji**
+for tab affordances and the **🧭 compass** as its brand mark. Spectrum's own
+**workflow-icons** are the canonical reference but aren't freely CDN-hosted, so
+this system substitutes **[Lucide](https://lucide.dev)** — clean 2px line icons
+whose weight and rounded joinery read as Spectrum-adjacent — loaded from CDN in
+the UI kit. **Substitution flagged.** If you license Adobe's Spectrum workflow
+icons, swap Lucide for them and the visual language tightens further.
+
+*Educational tool — not investment advice.*

theme.py

@@ -1,17 +1,13 @@
-# Spectrum 2 theme for Gradio — Chan Compass
+# Spectrum 2 theme for Gradio — Chan Compass  (v2, refined)
 # ---------------------------------------------------------------
 # Single source of truth for the LIVE Gradio app's look. Mirrors the
-# Chan Compass · Spectrum 2 design system (tokens in ../tokens/*.css).
-#
-# Usage in app.py:
+# Chan Compass · Spectrum 2 design system. Drop this next to app.py.
 #
 #     from theme import THEME, CSS
 #     with gr.Blocks(title="Chan Compass · US", theme=THEME, css=CSS) as demo:
 #         ...
-#     demo.launch()
-#
-# On Gradio >= 6 pass them to launch() instead:
-#     demo.launch(theme=THEME, css=CSS)
+#     demo.launch()            # Gradio 5
+#     # Gradio 6+: demo.launch(theme=THEME, css=CSS)
 # ---------------------------------------------------------------
 import gradio as gr
 
@@ -24,6 +20,7 @@ GRAY_25      = "#ffffff"
 GRAY_50      = "#f8f8f8"   # canvas
 GRAY_75      = "#f3f3f3"
 GRAY_100     = "#e6e6e6"   # hairline border
+GRAY_200     = "#d5d5d5"
 GRAY_300     = "#b1b1b1"   # field border
 GRAY_500     = "#6d6d6d"   # muted text
 GRAY_700     = "#292929"   # body text
@@ -50,18 +47,25 @@ THEME = gr.themes.Default(
     block_radius="16px",
     block_shadow="0 1px 3px rgba(0,0,0,.06), 0 1px 1px rgba(0,0,0,.04)",
     block_label_text_color=GRAY_500,
+    block_label_text_weight="600",
     block_title_text_color=GRAY_800,
+    block_title_text_weight="700",
     border_color_primary=GRAY_100,
+    panel_background_fill=GRAY_25,
+    panel_border_color=GRAY_100,
     # text
     body_text_color=GRAY_700,
     body_text_color_subdued=GRAY_500,
+    body_text_size="14px",
     # buttons — Spectrum 2 signature pill
     button_large_radius="9999px",
     button_small_radius="9999px",
+    button_large_padding="10px 22px",
     button_primary_background_fill=ACCENT,
     button_primary_background_fill_hover=ACCENT_HOVER,
     button_primary_text_color="#ffffff",
     button_primary_border_color=ACCENT,
+    button_primary_shadow="none",
     button_secondary_background_fill=GRAY_25,
     button_secondary_background_fill_hover=GRAY_75,
     button_secondary_border_color=GRAY_300,
@@ -70,7 +74,9 @@ THEME = gr.themes.Default(
     input_background_fill=GRAY_25,
     input_border_color=GRAY_300,
     input_border_color_focus=ACCENT,
+    input_border_width="2px",
     input_radius="8px",
+    input_shadow="none",
     # accents / links
     color_accent_soft=ACCENT_SUBTLE,
     link_text_color=ACCENT_HOVER,
@@ -80,68 +86,96 @@ THEME = gr.themes.Default(
 # ---- Fine-grained CSS the theme object can't express ----------------------
 CSS = """
 :root{
-  --s2-accent:#0265dc; --s2-accent-down:#0054b6;
-  --s2-gray-50:#f8f8f8; --s2-gray-75:#f3f3f3; --s2-gray-100:#e6e6e6;
-  --s2-gray-300:#b1b1b1; --s2-gray-500:#6d6d6d; --s2-gray-700:#292929; --s2-gray-800:#1b1b1b;
+  --s2-accent:#0265dc; --s2-accent-hover:#0054b6; --s2-accent-down:#00418f; --s2-accent-subtle:#e0f2ff;
+  --s2-gray-25:#fff; --s2-gray-50:#f8f8f8; --s2-gray-75:#f3f3f3; --s2-gray-100:#e6e6e6;
+  --s2-gray-200:#d5d5d5; --s2-gray-300:#b1b1b1; --s2-gray-500:#6d6d6d; --s2-gray-700:#292929; --s2-gray-800:#1b1b1b;
   --s2-positive:#007a39; --s2-negative:#d7373f; --s2-notice:#b25309;
-  --s2-radius-card:16px;
+  --s2-radius-card:16px; --s2-ease:cubic-bezier(.45,0,.4,1);
 }
 body,.gradio-container{ background:var(--s2-gray-50)!important; color:var(--s2-gray-700);
   font-family:'Source Sans 3','Adobe Clean',system-ui,sans-serif; }
-.gradio-container{ max-width:1280px!important; margin:0 auto!important; }
+.gradio-container{ max-width:1200px!important; margin:0 auto!important; padding-top:8px!important; }
+.gap{ gap:14px; }
 
-/* Signature pill buttons — scoped to real action buttons, not table chrome */
+/* ---------- Buttons : Spectrum 2 pill ---------- */
 button.primary, button.secondary, button.lg, button.sm{
   border-radius:9999px!important; font-weight:600!important; letter-spacing:0;
-  transition:background-color .13s cubic-bezier(.45,0,.4,1), transform .13s cubic-bezier(0,0,.4,1); }
+  transition:background-color .13s var(--s2-ease), transform .12s var(--s2-ease), box-shadow .13s var(--s2-ease); }
+button.primary{ box-shadow:0 1px 2px rgba(2,101,220,.18)!important; }
+button.primary:hover{ box-shadow:0 2px 8px rgba(2,101,220,.22)!important; }
 button.primary:active, button.secondary:active{ transform:scale(.98); }
 button:focus-visible{ outline:2px solid var(--s2-accent)!important; outline-offset:2px; }
 .table-wrap button, table button, .dataframe button, [class*="cell-menu"] button{
-  border-radius:6px!important; font-weight:500!important; }
+  border-radius:6px!important; font-weight:500!important; box-shadow:none!important; }
 
-/* Brand header (replaces gradient hero with a clean Spectrum bar) */
-#s2-hero{ display:flex; align-items:center; gap:16px;
-  background:#fff; border:1px solid var(--s2-gray-100); border-radius:20px;
-  padding:22px 26px; margin-bottom:8px; box-shadow:0 1px 3px rgba(0,0,0,.06); }
-#s2-hero .mark{ width:46px; height:46px; flex:none; border-radius:12px; display:grid; place-items:center;
-  background:linear-gradient(135deg,#0265dc 0%,#5258e4 60%,#7326d3 100%);
-  color:#fff; font-size:24px; box-shadow:0 2px 12px rgba(2,101,220,.18); }
-#s2-hero h1{ margin:0; font-size:24px; font-weight:800; letter-spacing:-.01em; color:var(--s2-gray-800); }
+/* ---------- Hero ---------- */
+#s2-hero{ display:flex; align-items:center; gap:18px;
+  background:linear-gradient(180deg,#fff 0%,#fcfdff 100%);
+  border:1px solid var(--s2-gray-100); border-radius:20px;
+  padding:22px 26px; margin:6px 0 14px; box-shadow:0 1px 3px rgba(0,0,0,.05); }
+#s2-hero .mark{ width:50px; height:50px; flex:none; border-radius:14px; display:grid; place-items:center;
+  background:linear-gradient(135deg,#0265dc 0%,#5258e4 58%,#7326d3 100%);
+  color:#fff; font-size:26px; box-shadow:0 4px 14px rgba(2,101,220,.22); }
+#s2-hero h1{ margin:0; font-size:25px; font-weight:800; letter-spacing:-.015em; color:var(--s2-gray-800); }
 #s2-hero h1 span{ font-weight:300; color:var(--s2-gray-500); }
-#s2-hero p{ margin:3px 0 0; color:var(--s2-gray-500); font-size:14px; }
-#s2-hero .chips{ margin-left:auto; display:flex; flex-wrap:wrap; gap:7px; justify-content:flex-end; max-width:360px; }
+#s2-hero p{ margin:4px 0 0; color:var(--s2-gray-500); font-size:13.5px; line-height:1.45; max-width:620px; }
+#s2-hero .chips{ margin-left:auto; display:flex; flex-wrap:wrap; gap:6px; justify-content:flex-end; max-width:330px; }
 #s2-hero .chips span{ background:var(--s2-gray-75); border:1px solid var(--s2-gray-100); border-radius:9999px;
-  padding:3px 11px; font-size:12px; font-weight:600; color:var(--s2-gray-700); }
+  padding:3px 11px; font-size:11.5px; font-weight:600; color:var(--s2-gray-700); white-space:nowrap; }
 
-/* Quiet tabs with accent underline */
-.tab-nav{ border-bottom:2px solid var(--s2-gray-100)!important; gap:24px; }
+/* ---------- Tabs : quiet + accent underline ---------- */
+.tab-nav{ border-bottom:2px solid var(--s2-gray-100)!important; gap:22px; margin-bottom:6px; }
 .tab-nav button{ border:none!important; background:transparent!important; border-radius:0!important;
-  font-size:16px!important; font-weight:600!important; color:var(--s2-gray-500)!important;
-  padding:12px 2px!important; margin-bottom:-2px; }
-.tab-nav button.selected{ color:var(--s2-accent)!important;
-  box-shadow:inset 0 -2px 0 var(--s2-accent)!important; }
+  font-size:15.5px!important; font-weight:600!important; color:var(--s2-gray-500)!important;
+  padding:11px 2px!important; margin-bottom:-2px; transition:color .13s var(--s2-ease); }
+.tab-nav button:hover{ color:var(--s2-gray-700)!important; }
+.tab-nav button.selected{ color:var(--s2-accent)!important; box-shadow:inset 0 -2px 0 var(--s2-accent)!important; }
+
+/* ---------- Cards / groups ---------- */
+.block{ border-radius:var(--s2-radius-card)!important; }
+.gr-group, .group{ border:1px solid var(--s2-gray-100)!important; border-radius:var(--s2-radius-card)!important;
+  background:#fff; overflow:hidden; }
 
-/* Cards / blocks */
-.block{ border:1px solid var(--s2-gray-100)!important; border-radius:var(--s2-radius-card)!important; }
+/* control bar — the primary input row of each tab, framed as a card */
+#s2-app .s2-bar{ background:#fff!important; border:1px solid var(--s2-gray-100)!important;
+  border-radius:14px!important; padding:14px 16px!important; box-shadow:0 1px 3px rgba(0,0,0,.05);
+  align-items:flex-end!important; }
+#s2-app .s2-bar .block{ border:none!important; box-shadow:none!important; background:transparent!important; }
 
-/* Data tables */
-table{ font-size:13.5px!important; }
+/* eyebrow section labels */
+.s2-eyebrow p{ margin:14px 0 2px!important; font-size:11px!important; font-weight:700!important;
+  letter-spacing:.07em; text-transform:uppercase; color:var(--s2-gray-500)!important; }
+.s2-help p{ color:var(--s2-gray-500)!important; font-size:13px!important; line-height:1.5; margin:2px 0 6px!important; }
+
+/* ---------- Data tables ---------- */
+.dataframe, table{ font-size:13.5px!important; }
 thead th{ background:var(--s2-gray-75)!important; font-weight:700!important; text-transform:uppercase;
-  letter-spacing:.04em; font-size:11.5px!important; color:var(--s2-gray-500)!important; }
+  letter-spacing:.04em; font-size:11px!important; color:var(--s2-gray-500)!important; }
 tbody td{ border-color:var(--s2-gray-100)!important; }
+tbody tr:hover td{ background:var(--s2-gray-75)!important; }
+
+/* ---------- AI output panel — signature accent-framed surface ---------- */
+.llm-out{ border:1px solid var(--s2-gray-100); border-left:5px solid var(--s2-accent); border-radius:12px;
+  background:#fff; padding:16px 20px; min-height:140px; font-size:14.5px; line-height:1.6;
+  overflow:auto; box-shadow:0 2px 12px rgba(2,101,220,.07); }
+.llm-out:empty::after{ content:"🤖  AI output appears here"; color:#9aa0a6; font-style:italic; }
+.llm-out h1,.llm-out h2,.llm-out h3{ font-size:16px; margin:.4em 0 .3em; color:var(--s2-gray-800); }
 
-/* Mono log boxes */
-#detail-log textarea{ font-family:'Source Code Pro',monospace!important; font-size:12.5px!important; }
+/* raw-read (non-AI) markdown reads as a quiet well */
+#detail-log textarea{ font-family:'Source Code Pro',monospace!important; font-size:12.5px!important;
+  background:var(--s2-gray-75)!important; border-radius:10px!important; }
 
-/* LLM output panel — same framed look as the Pipeline Log box but neutral
-   (no accent glow). Starts ~half the log's height, grows with content. */
-.llm-out{ border:1px solid var(--s2-border,#d5d9e0); border-radius:8px;
-  background:var(--s2-surface,#fff); padding:12px 16px; min-height:150px;
-  font-size:14px; line-height:1.5; overflow:auto; }
-.llm-out:empty::after{ content:"AI output appears here"; color:#9aa0a6;
-  font-style:italic; }
+/* ---------- Accordion (email rows, collapsible) ---------- */
+.gr-accordion, .accordion{ border:1px solid var(--s2-gray-100)!important; border-radius:12px!important;
+  background:#fff; overflow:hidden; }
+.gr-accordion > button, .accordion > button{ font-weight:600!important; color:var(--s2-gray-700)!important;
+  font-size:13.5px!important; }
 
-.s2-footnote{ color:var(--s2-gray-500); font-size:12.5px; }
+/* ---------- Misc ---------- */
+.s2-footnote p{ color:var(--s2-gray-500)!important; font-size:12.5px!important; }
+hr{ border:none; border-top:1px solid var(--s2-gray-100); margin:18px 0; }
+label span{ font-weight:600; }
+::selection{ background:var(--s2-accent-subtle); }
 """
 
 __all__ = ["THEME", "CSS"]

typography.css

@@ -0,0 +1,12 @@
+/* ============================================================
+   FONTS — Chan Compass · Spectrum 2
+   Adobe Clean (Spectrum's UI typeface) is proprietary, so this
+   system substitutes Adobe's own open-source families:
+     · Source Sans 3   → UI / headings   (stands in for Adobe Clean)
+     · Source Serif 4  → editorial serif (stands in for Adobe Clean Serif)
+     · Source Code Pro → mono / code     (Spectrum's real code font)
+   Loaded from Google Fonts. If you have licensed Adobe Clean,
+   swap the @font-face stack and the families resolve automatically.
+   ============================================================ */
+
+@import url('https://fonts.googleapis.com/css2?family=Source+Sans+3:ital,wght@0,400;0,500;0,600;0,700;0,800;1,400&family=Source+Serif+4:ital,wght@0,400;0,600;0,700;1,400&family=Source+Code+Pro:wght@400;500;600&display=swap');