Files
qlib/frontend/web/components/charts/theme.ts
T
Simon 23972e7063 feat: 股息率案例口径 + 策略库与图表统一 + 回测存档完整化
汇总三轮未提交的开发(每轮均在本机 MariaDB + 真实浏览器上验证):

1) 股息率案例(全市场股息率最高 n 只,默认 20,每 m 月择股)
   - 新增日频估值表 daily_basic + 迁移;股息率因子(dv_ratio / dividend_yield / TTM)
   - 名称历史表 stock_name_history:剔除 ST 按**择股日当时名称**判定,消除
     「曾高股息后 ST」的股息陷阱(实测 3.70pp 偏差)
   - 区间择股/调仓双周期(m 择股 / y 调仓)、指数成分与白名单、停牌近似剔除
   - 复权因子口径核对(4,164,742 行、缺失 0.0%)、收盘价成交与涨跌停拦单
   - 案例实测:2020-01-01~2026-09-04 总收益 +24.86%(年化 3.52%、回撤 -28.58%)

2) 策略库与前端统一
   - strategy 表 + CRUD/PUT 原地更新 + `describe_strategy` 按 spec 真实推导
     「一句话说明 + 计算公式 + 执行步骤 + 注意事项」(与引擎实执行规则同源)
   - 任何出现股票代码处都成对显示名称且可点击进个股页
   - 全站图表基座统一 TradingView Lightweight Charts(ECharts 依赖、
     锁文件、组件与文档标注一并清除),买卖点标记只落在真实交易日上

3) 回测存档完整化(可往复查看)
   - 同步端点(POST /api/backtests、/api/factor-tests)此前完全不落库 → 现在同样归档,
     归档 id 经响应头 X-Experiment-Id 返回(不破坏 response_model)
   - data_version 首次真实写入(数据快照指纹:最新交易日 + 各表规模)
   - 个股收益曲线默认**全量保存**(此前硬截断 60 只);超出体积预算才裁剪,
     并写 archive_meta(机器可读)+ unimplemented(人可读)如实标注
   - 列表 kind/q 过滤 + X-Total-Count(此前 limit=50 静默截断)、DELETE 归档
   - 只读归档页 /experiments/{id}(Server Component,SSR 直出**选股条件**与
     **交易执行依据**);结果视图按 kind 分发(backtest/factor_test/selection),
     非回测归档不套用回测口径
   - 新增 CLI:prune_experiments(保留策略,默认 dry-run)、
     restore_experiment_from_job(从 Job 副本按原 id 重建被删的历史归档,默认 dry-run)

门禁:pytest 388 passed、ruff All checks passed、tsc 0 错误、图表单测 7 passed、
next build 成功、契约脚本 verify_strategy_workspace 59/59(含按 kind 逐类验证归档页)。
2026-09-20 07:31:04 +08:00

81 lines
2.4 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 图表统一主题(TradingView Lightweight Charts)。
*
* 单一来源:所有图表组件只从这里取色,避免各页面各自硬编码导致深浅不一的观感。
* 与 globals.css 的 CSS 变量保持同一套语义色(pos=涨/盈利口径按 A 股习惯为红涨绿跌,
* 但收益曲线的“正/负”沿用页面既有的绿正红负,故分 `up/down` 与 `pos/neg` 两组)。
*/
export const CHART = {
/** 透明底:跟随卡片背景,避免图表出现色块拼接 */
background: "transparent",
text: "#a8b3c9",
textStrong: "#e9eef7",
faint: "#8b98b2",
grid: "rgba(150,165,195,0.10)",
border: "rgba(150,165,195,0.22)",
crosshair: "rgba(150,165,195,0.45)",
tooltipBg: "rgba(20,29,48,0.96)",
tooltipBorder: "rgba(150,165,195,0.28)",
/** 收益语义(绿=正、红=负,与页面 Pill/Metric 一致) */
pos: "#3ddc97",
neg: "#ff7a7a",
accent: "#3fb6ff",
violet: "#b98bff",
amber: "#d4a72c",
/** A 股涨跌语义(红涨绿跌) */
up: "#e5484d",
down: "#2fb36b",
/** 多序列叠加配色(实验对比用,最多 8 条) */
series: [
"#3fb6ff",
"#3ddc97",
"#d4a72c",
"#b98bff",
"#ff7a7a",
"#4dd0e1",
"#f06292",
"#9ccc65",
],
} as const;
/** 买卖点标记语义色:与图例文字一致,买入=绿、卖出=红/紫 */
export const MARKER_COLORS = {
BUY: "#3ddc97",
SELL: "#ff5a5a",
SIG_BUY: "#b98bff",
SIG_SELL: "#8b7bd8",
} as const;
export function seriesColor(index: number): string {
return CHART.series[index % CHART.series.length];
}
/** 去掉 "YYYY-MM-DD" 的年份,用于横轴/表格紧凑显示 */
export function shortDate(d: string): string {
return d.length >= 10 ? d.slice(5) : d;
}
/** 千分位 + 指定小数位(净值/金额) */
export function fmtNum(v: number, digits = 0): string {
return v.toLocaleString("zh-CN", {
minimumFractionDigits: digits,
maximumFractionDigits: digits,
});
}
/** 百分比(入参已是百分数,如 24.86 → "+24.86%") */
export function fmtPct(v: number, digits = 2): string {
return `${v > 0 ? "+" : ""}${v.toFixed(digits)}%`;
}
/** 紧凑金额:12.5 万 / 1.23 亿 */
export function fmtMoney(v: number): string {
const abs = Math.abs(v);
if (abs >= 1e8) return `${(v / 1e8).toFixed(2)} 亿`;
if (abs >= 1e4) return `${(v / 1e4).toFixed(2)} 万`;
return fmtNum(v, 0);
}