这是什么

期权交易者的每日晨报生成器：一份期权链快照 CSV 进去，一份结构化市场简报出来。

解决什么问题

• 期权链几百行数据，人工扫一遍抓不住情绪与结构信号
• PCR、最大痛点、IV 微笑等指标散落在不同工具里
• 盘前要快速形成观点，没有时间做表

核心能力

1. PCR 情绪判读：Put-Call Ratio 计算与分段判读
2. 最大痛点（Max Pain）：行权价分布与到期博弈分析
3. 隐含波动率结构：IV 微笑与偏度曲线、异常凸点识别
4. 持仓集中度：未平仓量分布、大户仓位倾向
5. 希腊字母速算：单合约 Delta/Gamma/Vega/Theta/Rho

快速开始（示例指令）

• "这是今天的50ETF期权链快照，给我出一份市场简报：@chain.csv"
• "算一下行权价2.8的认购合约的希腊字母"
• "今天PCR多少？市场情绪偏什么？"

常见问题

Q: 输入格式？
期权链快照 CSV，需含 type/strike/bid/ask/volume/open_interest 列；缺列会明确提示哪一列，不会报错退出。

Q: 支持哪些品种？
工具本身品种无关，A股ETF期权、股指期权、个股期权的数据均可（按交易所字段命名）。

Q: IV 微笑需要 bid/ask 都有吗？
微笑与偏度基于中间价，缺一腿时自动降级用单边价并提示。

Q: 结论是投资建议吗？
输出为客观数据判读与信号提示，不构成投资建议。

更新日志

• v1.1.0：补齐详情页与 FAQ；缺列/缺腿数据的降级处理增强
• v1.0.1：Initial release

析衡量化 · 期权简报（xiheng-option-brief）

对期权市场结构做"情绪 × 持仓 × 波动率"三维速读，输入一份期权链快照 CSV，输出可直接转发的 Markdown 每日简报。纯 Python 标准库，无任何第三方依赖；内置固定样例数据，离线即可跑通全流程。

适用场景

快速开始（离线自测）

# 全流程 demo：使用内置样例数据，无需任何外部数据
python scripts/option_brief.py brief --demo --spot 2.900

# 分项分析（真实数据时替换 --input 为你的期权链 CSV）
python scripts/option_brief.py pcr      --input chain.csv --expiry 2026-10-28
python scripts/option_brief.py maxpain  --input chain.csv
python scripts/option_brief.py iv       --input chain.csv --spot 2.900
python scripts/option_brief.py greek    --type P --spot 2.900 --strike 2.850 --vol 0.20 --days 30

输入数据格式

CSV 文件（UTF-8，含表头），必需列：type,strike,bid,ask,volume,open_interest，可选列：expiry,last。

expiry,type,strike,bid,ask,last,volume,open_interest
2026-10-28,C,2.900,0.0455,0.0535,0.0495,6123,18402
2026-10-28,P,2.900,0.0479,0.0559,0.0519,6890,20431

• type：C=认购，P=认沽（大小写不限）
• strike：行权价；bid/ask：权利金买卖报价；volume/open_interest：成交与持仓
• expiry：到期日（YYYY-MM-DD）。缺失或已过期时，用 --ttm <天数> 手动指定剩余期限

输出说明

• pcr：成交/持仓 PCR + 四档情绪判读（≥1.2 避险浓厚 / 0.9–1.2 偏谨慎 / 0.7–0.9 中性 / <0.7 投机偏强），并附反向指标使用提示
• maxpain：最大痛点行权价 + 前 5 低赔付行权价表
• iv：ATM IV、OTM 认沽−认购偏度判读（左偏/右偏/对称）、逐行权价微笑表
• greek：BS 欧式理论价 + Delta/Gamma/Vega(每 vol 点)/Theta(每日)/Rho(每 1% 利率)
• brief：整合以上内容的一页式 Markdown 简报（市场概览/PCR/最大痛点/波动率/持仓集中度/一句话结论），默认输出 option_brief_YYYY-MM-DD.md

方法与口径说明

• IV 由买卖报价中值经 Black-Scholes 二分法反推，仅适用欧式期权口径；美式期权、分红标的会有系统性偏差
• 报价越过无套利边界（低于内在价值贴现、高于标的价格）的合约自动跳过
• PCR、最大痛点均为辅助性结构指标，不构成价格预测，输出均已内嵌风险提示

错误处理

所有错误以 exit code 2 退出并输出中文提示：文件不存在、CSV 缺列、type 非法、有效行数为 0、--spot/--ttm 缺失、到期月不存在、输出路径冲突等。

相关技能

> 本技能属于 析衡量化 系列，统一入口见 xiheng-quant-toolkit：
> series.py list 看系列全景，series.py route <场景> 定位技能，series.py chain <场景> 看整条调用链。

> 系列地图维护在 xiheng-quant-toolkit/assets/series.json；本技能在该地图中的条目（slug/stage/role/feeds/triggers）应保持同步。