跳到主要内容

配置字段

两个函数的第四个参数是一个 qs_html_report_options STRUCT —— 扩展在加载期建好的命名类型。它的字段 全部可空，没写的键取默认值：

字段类型默认说明
titleVARCHAR'Strategy Tearsheet'报告标题
strategy_titleVARCHAR该 symbol策略显示名；没写就退回 symbol 本身
benchmark_titleVARCHAR[]基准 symbol基准显示名（纯展示）：列表，按下标与 benchmark 一一对应。这一项没给（列表短了、是 NULL 或空串、整个键没写）就退回那一份报告所用的基准 symbol；多余的表项忽略
benchmarkVARCHAR[]NULL哪些 symbol 当基准（列表，顺序即报告顺序）；它们只作输入、不出报告。一个基准也要写成 ['SPX']
rfDOUBLE0.0无风险利率，年化（0.04 = 4%），与 quantstats 的 rf 口径一致
periods_per_yearUINTEGER252年化周期数，必须大于 0
match_datesBOOLEANtrue是否把策略与基准的起始日对齐
langVARCHARNULL把报告翻译成这个语言（见翻译）；该语言必须在翻译表里有条目。NULL = 完全不翻译，'en' = 文字不变、只补英文说明。叫 lang 是因为 language 是 SQL 关键字
output_dirVARCHARNULL把每份报告落盘到该本地目录，文件名由函数生成（见落盘与浏览器）；wasm 构建不落盘
open_in_browserBOOLEANfalse用系统默认浏览器打开报告；没写 output_dir 时会先落一个临时文件（见落盘与浏览器）

除两个显示名之外，默认值都直接取自 quantstats-rs 的 HtmlReportOptions::default()，本扩展不另立一套。

两个显示名是例外​

也是这套 API 能一次出几十份报告的前提：默认的 'Strategy' 对每一份都一样，图例里认不出谁是谁， 浏览器临时文件名也会撞成同一串前缀 —— 所以缺省时退回数据里那个名字（symbol / 基准 symbol）， 报告里的图例、临时文件名与结果里的 strategy_title / benchmark_title 因此始终一致。title 同样是 你的，它也不参与翻译：翻译只碰报告自己的那些固定文本。

配置是按行求值的一列​

每个 symbol 只取用第一行出现的那份，所以用 symbol 列把配置拼出来，就是「每个标的各有一套标题与 显示名」，基准显示名也按下标各自对齐：

WITH prices AS (
    SELECT * FROM read_csv('https://shijianjs.github.io/duckfn-quantstats/demo/prices.csv')
)
SELECT (r).symbol, (r).strategy_title, (r).benchmark, (r).benchmark_title,
       length((r).html) AS html_bytes
FROM (
    SELECT unnest(qs_html_reports_by_prices(
               symbol, date, price,
               {'benchmark': ['SPX'],
                'benchmark_title': ['S&P 500'],
                'title': symbol,               -- 逐行求值：这份报告自己的标题
                'strategy_title': symbol,      -- 逐行求值：图例上的名字
                'rf': 0.04,
                'periods_per_year': 252}::qs_html_report_options)) AS r
    FROM prices
)
ORDER BY (r).symbol;

strategy_title 与 benchmark_title 都会回显在结果行里，所以图例上写的是什么不必去 HTML 里抠 —— 而且它们正是生成的文件名所用的那两份名字。

同一个 symbol 的配置要逐行一致；benchmark 这一项还要求整次调用里所有标的给出同一个列表（元素与 顺序都一致，不一致直接报错），否则「谁把谁当基准」就没有单一答案。错误路径里 每一种都有一个可运行的例子。

哪些项会被校验​

benchmark 决定「谁把谁当基准」与「谁出报告」，所以它是严格的：元素不能是 NULL、不能是空串、 不能在同一个列表里重复。benchmark_title 只用于展示，所以宽松（缺项退回，多余项忽略）。 periods_per_year = 0 与 output_dir = '' 也作为配置错误报出 —— 都发生在渲染与文件系统调用之前。 完整清单见错误路径。

rf 是年化口径​

0.04 表示 4%，报告内部再换算成周期利率；crate 里有两处换算略有差别 —— Sharpe（含滚动 Sharpe / Sortino） 用 (1 + rf)^(1/periods_per_year) - 1，而指标表里的 PSR / Sortino 用 rf / periods_per_year。 rf = 0（默认）时两者都退化为 0。