feat: add ops-map text summaries for leverage and move periods

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-02 09:43:56 +08:00
parent 74021dae08
commit f798c11cf9
5 changed files with 327 additions and 9 deletions
@@ -0,0 +1,157 @@
+/** 作战地图图下文字结论（由 buckets 生成）。 */
+
+export type LevBucket = {
+  label: string;
+  n: number;
+  mean: number | null;
+  pct_ge_min: number | null;
+};
+
+export type MoveBucket = {
+  label: string;
+  n: number;
+  mean_abs: number | null;
+  mean_signed: number | null;
+};
+
+const MIN_N = 3;
+const TOP_K = 5;
+
+function fmtPct(p: number): string {
+  return `${Math.round(p * 100)}%`;
+}
+
+function fmtNum(n: number, d = 1): string {
+  return n.toFixed(d);
+}
+
+function withData<T extends { n: number }>(buckets: T[]): T[] {
+  return buckets.filter((b) => b.n > 0);
+}
+
+function enoughSamples<T extends { n: number }>(buckets: T[]): T[] {
+  return buckets.filter((b) => b.n >= MIN_N);
+}
+
+/** 上图杠杆结论 */
+export function leverageSummary(
+  range: "day" | "week" | "month",
+  buckets: LevBucket[],
+  minLeverage: number
+): string {
+  const active = withData(buckets);
+  if (!active.length) {
+    return "所选范围内暂无杠杆样本，采集后将显示各时段分布。";
+  }
+
+  const bestMean = [...active].sort((a, b) => (b.mean ?? -1) - (a.mean ?? -1))[0];
+  const minL = minLeverage;
+
+  if (range === "day") {
+    const labels = active.map((b) => b.label).join("、");
+    const parts: string[] = [];
+    parts.push(`今日杠杆分布：有样本时段 ${labels}。`);
+    if (bestMean?.mean != null) {
+      const ge = bestMean.mean >= minL ? "已超过" : "未达到";
+      parts.push(
+        `${bestMean.label} 均值约 ${fmtNum(bestMean.mean)}，${ge}达标线 ${minL}。`
+      );
+    }
+    if (active.length <= 2) {
+      parts.push(`采集初期，今日仅 ${active.length} 个时段有样本，结论仅供参考。`);
+    }
+    return parts.join(" ");
+  }
+
+  const windowName = range === "week" ? "本周" : "本月";
+  const ranked = enoughSamples(active)
+    .filter((b) => b.pct_ge_min != null)
+    .sort((a, b) => {
+      const dp = (b.pct_ge_min ?? 0) - (a.pct_ge_min ?? 0);
+      if (dp !== 0) return dp;
+      const dn = b.n - a.n;
+      if (dn !== 0) return dn;
+      return (b.mean ?? 0) - (a.mean ?? 0);
+    })
+    .slice(0, TOP_K);
+
+  const parts: string[] = [];
+  if (!ranked.length) {
+    parts.push(
+      `${windowName}各时段样本仍偏少（单时段不足 ${MIN_N} 条），暂不给出高概率名单；持续采集后会更稳定。`
+    );
+  } else {
+    const list = ranked
+      .map((b) => `${b.label}（${fmtPct(b.pct_ge_min ?? 0)}）`)
+      .join("、");
+    parts.push(`${windowName}≥${minL} 出现概率较高的时段：${list}。`);
+  }
+  if (bestMean?.mean != null && bestMean.n >= MIN_N) {
+    parts.push(`杠杆均值最高时段：${bestMean.label}（约 ${fmtNum(bestMean.mean)}）。`);
+  } else if (bestMean?.mean != null) {
+    parts.push(
+      `当前均值最高：${bestMean.label}（约 ${fmtNum(bestMean.mean)}，样本 ${bestMean.n}，偏少）。`
+    );
+  }
+  return parts.join(" ");
+}
+
+/** 下图波动结论 */
+export function moveSummary(
+  range: "day" | "week" | "month",
+  buckets: MoveBucket[],
+  opts: {
+    pendingExpiry?: boolean;
+    pendingCount?: number;
+    mode: "abs" | "signed";
+    apiMessage?: string | null;
+  }
+): string {
+  if (opts.pendingExpiry) {
+    const extra = opts.apiMessage ? ` ${opts.apiMessage}` : "";
+    return `未到期，暂无法统计时段→到期波动；结算后将按日/周/月给出高波动钟点。${extra}`.trim();
+  }
+
+  const active = withData(buckets).filter((b) =>
+    opts.mode === "abs" ? b.mean_abs != null : b.mean_signed != null
+  );
+  if (!active.length) {
+    return "所选范围内暂无已结算波动样本。";
+  }
+
+  const windowName =
+    range === "day" ? "今日" : range === "week" ? "本周" : "本月";
+
+  // 日视图样本少时放宽；周/月仍要求单时段样本足够
+  const pool = range === "day" ? active : enoughSamples(active);
+  const ranked = [...pool]
+    .sort((a, b) => {
+      if (opts.mode === "abs") {
+        return Math.abs(b.mean_abs ?? 0) - Math.abs(a.mean_abs ?? 0);
+      }
+      return Math.abs(b.mean_signed ?? 0) - Math.abs(a.mean_signed ?? 0);
+    })
+    .slice(0, TOP_K);
+
+  if (!ranked.length) {
+    return range === "day"
+      ? `${windowName}暂无可用波动样本。`
+      : `${windowName}波动样本偏少（单时段不足 ${MIN_N} 条），暂不排名。`;
+  }
+
+  if (opts.mode === "abs") {
+    const list = ranked
+      .map((b) => `${b.label}（${fmtNum(b.mean_abs ?? 0, 2)}）`)
+      .join("、");
+    return `${windowName}波动较高时段：${list}。`;
+  }
+
+  const list = ranked
+    .map((b) => {
+      const v = b.mean_signed ?? 0;
+      const dir = v >= 0 ? "偏多" : "偏空";
+      return `${b.label}（${fmtNum(v, 2)}，${dir}）`;
+    })
+    .join("、");
+  return `${windowName}带符号波动较大时段：${list}。`;
+}
@@ -10,6 +10,7 @@ import AppNav from "../components/AppNav";
 import LeverageChart from "../components/LeverageChart";
 import LoginGate from "../components/LoginGate";
 import MovePointsChart from "../components/MovePointsChart";
+import { leverageSummary, moveSummary } from "../lib/opsSummary";

 type RangeKey = "day" | "week" | "month";
 type SideKey = "both" | "C" | "P";
@@ -157,6 +158,9 @@ export default function OpsMapPage() {
            minLeverage={lev.min_leverage}
            title={`上图 · 时段杠杆均值（${rangeLabel}）`}
          />
+          <p className="chart-summary">
+            {leverageSummary(range, lev.buckets, lev.min_leverage)}
+          </p>

          <div className="toolbar" style={{ marginTop: "1.25rem" }}>
            <div className="seg">
@@ -189,11 +193,14 @@ export default function OpsMapPage() {
              moveMode === "abs" ? "abs" : "signed"
            }）`}
          />
-          {mov?.message && (
-            <p style={{ color: "var(--muted)", fontSize: "0.85rem", marginTop: "0.75rem" }}>
-              {mov.message}
-            </p>
-          )}
+          <p className="chart-summary">
+            {moveSummary(range, mov?.buckets ?? [], {
+              pendingExpiry: mov?.pending_expiry,
+              pendingCount: mov?.pending_count,
+              mode: moveMode,
+              apiMessage: mov?.message,
+            })}
+          </p>
        </>
      )}
    </div>
@@ -179,6 +179,16 @@ select.field-input { cursor: pointer; }
  font-size: 0.85rem;
 }
 .chart-svg { width: 100%; height: auto; display: block; }
+.chart-summary {
+  margin: 0.65rem 0 0;
+  padding: 0.75rem 0.9rem;
+  background: #0c1117;
+  border: 1px solid #243041;
+  border-radius: 8px;
+  color: var(--muted);
+  font-size: 0.88rem;
+  line-height: 1.55;
+}
 .chart-legend {
  display: flex;
  flex-wrap: wrap;