# 0.22.0 — 期权/波动率板块（Optiver 灵感）

## [2026-08-17 11:06:42] 背景
用户指示：真正搭建期权/波动率板块，灵感来源于 Optiver（GitHub 远端调研）：
Ready Trader Go 做市仿真（Avellaneda-Stoikov 社区实现）、optibook 模拟交易所、
期权定价挑战赛 → 教学内核「定价 → greeks → 波动率 → 对冲 → 仿真验证」。

## 新增
- quant_option（dsh-risk/options.ts）：BS 定价 ⇄ IV 互算（二分法）+ 五希腊
  （Δ/Γ/ν per 1% vol/Θ per year/ρ per 1% rate）；erf 近似正态 CDF
- quant_volatility（dsh-risk/volatility.ts）：对数收益总体标准差年化（默认 252）
  + 对齐 logReturns；RV vs IV = 波动率风险溢价研究入口
- 7 手算用例（ATM call 教科书值 / put-call parity / IV 回环 / 深实虚值 delta /
  RV / 前置条件），46 工具 · 174 单元 · 4 Loader 全绿
- 教训：theta 手算常数精度（-6.4137 vs 实际 -6.4142，erf 近似差异）

## [2026-08-17 11:06:42] 网络故障记录
- 发布时国际出口网络中断：加密三所/yahoo/github/npm 全部超时，仅国内主机
  （腾讯）可达。离线门全绿（build + 174 单测 + 4 Loader + tools.json 46）。
- 本地已提交 + tag v0.22.0；后台任务 bash-10 每 45s 重试 push，恢复后
  自动触发 CI/release 发布 npm。
- 期权板块 Issue/Discussion 草稿已备好（.scratch/options-board-*.md），
  网络恢复后立即发布（灵感来源 Optiver 已写明）。

## 关联：贡献雷达 idea（本日另行记录）
- 开源贡献雷达仅记录不搭建：内部 PRT 的活，需强人工审核，不能自动化
  （见 pengyi-os/PJS/PDSH logs 2026-08-17_ideas.md）

## [2026-08-17 11:23:38] 网络恢复 · 全部落地
- 用户切换 VPN 后国际出口恢复（github/binance/npm 200，yahoo 429 限流但可达）
- push 成功 → CI + release 双 success → npm dsh-quant@0.22.0（第 29 次自动发布）
- **live verify 全绿**：期权板块实测 ATM call 10.4506 / IV 回环 20.0000% /
  BTC 已实现波动率 26.44%（119 对数收益）+ 全部历史检查（行情/管线/债券/线性模型）
- 发布：Issue #16（期权/波动率板块，灵感来源 Optiver + 路线图）
  + Discussion #15（从 Optiver 做市世界观学起）
- 后台推送重试任务 bash-11 自然完成（Everything up-to-date）

## 上线前测试纪律（本次实践）
- 网络故障期间坚持离线全测：build + 174 单元 + 4 Loader + tools.json +
  npm pack + 离线工具管线实测（新工具过真实 registry 手算验证）全绿
- 网络恢复后补 live verify 全绿才正式宣布上线——「本地测不过绝不上线」执行到位

## [2026-08-17 11:26:42] BTC 通用实验框架定位（issue + discussion 同步上线）
- Issue #17：BTC = 通用实验框架。四理由：免费数据源（不采购不转发付费数据）/
  7×24 连续交易（对齐最干净）/历史长波动特征丰富/全球单一现货口径可复现。
  各模块 BTC 用法表（verify/管线 demo/UI sample/ML demo/波动率实测）。
  数据方合作通道：免费接口提 issue/PR 接入；付费走渠道指引合作。
  https://github.com/pengpengyi92/dsh-quant/issues/17
- Discussion #18：同主题社区讨论（通用标的选择 + 数据方合作征集）
  https://github.com/pengpengyi92/dsh-quant/discussions/18
