前面 8 讲把研究跑通了;
今晚把它们收成能打开、能一起管的 HTML 报告。
模板里就是这九个标题。少一章,别人就没法复核。
上游交研究结果,charts 负责画图;网页走哪条路径,取决于要预览还是要交付完整报告。
方便马上看结果,尚不是完整研究报告。
问题、样本、方法、指标与限制写全;另调 write_research_catalog 才会生成目录页。
| 约束 | 做法 | 漏了会怎样 |
|---|---|---|
| 字段 | 缺 question 或 metrics_source 就报错 | 写不出 HTML |
| 版式 | 九个中文 <h2> 写在同一份模板里 | 测试会检查标题齐不齐 |
| 图 | 只收 PNG,嵌进页面 | 不会出现有的图要外链才能看 |
| 路径 | 函数自己拼 reports/<namespace>/<slug>/index.html | 目录页才能稳定扫到 |
| 编目 | 同时有 index.html 和 params.json 才算一份 study | 旧的 CSV 堆不会混进总览 |
params.json,不上数据库。默认 private,不要提交。公开示例是薄 HTML 卡片,不是九章档案。上游 skill 不负责拼报告页面。
同一套字段校验、模板和写出路径。
打开报告的 index.html。
另调 write_research_catalog,生成 catalog.html。
write_research_bundle。report skill 不算因子、不跑回测。这课不新开研究,不调参,也不报具体收益。规则第 5 课已经讲过。
空仓、且 MA10 / ATR14 算得出来时,close < MA10 就满仓;
止损只上移;close 跌破止损就空仓。
| 字段 | 课堂上怎么填 |
|---|---|
| 路径 | namespace=lesson_09,slug=if_ma10_atr → reports/lesson_09/if_ma10_atr/index.html |
| 品种 / 频率 | ["CFFEX.IF99"] · 1d |
| 成交约定 | 和第 5 课课堂上说的一致,写进报告正文 |
| visibility | private(默认不要提交) |
| metrics_source | BacktestResult.metrics,或写清 parquet / csv 路径 |
metrics_source 或 params.json 里找到同一来源。index.html 单独拷到桌面再打开。图还在,才算嵌进去了。做完 8 讲,本地会有一堆实验文件夹。没有总览,就只能凭记忆去翻。
write_research_catalog()
→ 扫描 reports/(跳过 README、catalog 自己)
→ 同时有 params.json 和 index.html → 收成一条
→ 只有 CSV/PNG → 还没写成报告,不进目录
→ 写出 reports/catalog.html 和 reports/catalog.json
index.html 的链接。catalog.json 只是把扫描结果存成文件,方便 Agent 读。下次生成会整份覆盖。报告几十到几百份时,扫目录足够快。index.html 的 CSV 堆,不会混进总览。有人补写成报告之后才会出现。strategy_examples 没有 params.json 和 index.html,不会自动编进来。请用 report skill,把本地股指期货均线回归加 ATR 止损策略(或其它曾经开发出的策略,包括但不限于现金流指数时序策略、ETF截面多因子策略、ETF截面机器学习策略)的研究结果整理成一份报告,并核对收益、回撤和买入持有对照。请保存报告、更新本地报告目录,然后告诉我报告在哪里。