Files
qlib/.env.example
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

33 lines
1.4 KiB
Bash
Raw Permalink 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.
# ============================================================
# 复制本文件为项目根目录 .env 并填入真实值。
# .env 已被 .gitignore 忽略 —— 严禁把真实密钥提交进 Git。
# 各变量用途:被根目录 config.yaml 中对应 *_env 字段引用,
# 或由后端 app.core.config 直接读取。
# ============================================================
# ---- Tushare Pro token(首选数据源,Phase 1 数据管线使用)----
TUSHARE_TOKEN=
# ---- 数据库连接 ----
# 默认库由 config.yaml database.mysql 决定(本机 MariaDB 127.0.0.1/qlib)。
# 连接优先级:本文件 DATABASE_URL > config.yaml database.mysql > SQLite 兜底。
DATABASE_URL=
# SQLite 示例(显式指定):
# DATABASE_URL=sqlite:///./data/quant.db
# MySQL 示例(手动覆盖 config.yaml 的 mysql 段时):
# DATABASE_URL=mysql+pymysql://user:password@127.0.0.1:3306/qlib
# MySQL 密码(config.yaml database.mysql.password_env 引用;host/port/db/user 在 config.yaml)
MYSQL_PASSWORD=
# ---- AI Agent / LLM(Phase 5)----
# 只需填写 API Key;URL 与模型名已在 config.yaml 的 agent.llm 中配置
# (默认 dashscope 兼容端点 + qwen-plus)。如需覆盖 config.yaml 的值,
# 再取消注释下面两行。
LLM_API_KEY=
# LLM_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
# LLM_MODEL=qwen-plus
# ---- API 应用密钥(必须修改为随机值)----
APP_SECRET_KEY=please-change-me