用途：在 FYERS 官方开发者 API v3（api-t1.fyers.in）上构建交易策略、自动化机器人与回测脚本，面向印度市场 NSE/BSE/MCX。支持生成 fyers-apiv3 SDK 的 Python 代码或原始 REST 代码，并正确配置 OAuth。
主要能力：获取行情、深度与历史数据；期权链、希腊值、IV、PCR、到期日选择、ATM/ITM/OTM、最大痛点；下单、改单、撤单、GTT/智能订单与持仓；标的主文件查询与名称到代码解析；WebSocket 实时流；基于历史 K 线的回测；技术指标（RSI、MACD、布林带、ATR 等）；回测业绩可视化；端点路径、载荷与枚举码参考；限流与错误处理。
使用方式：默认采用对话式执行，在项目目录中真实运行脚本并逐步推进；用户仅要代码时可只生成不运行。首次运行需创建虚拟环境并安装依赖：python3 -m venv .venv && source .venv/bin/activate，pip install --upgrade pip，pip install -r requirements.txt。认证先运行 python scripts/fyers_login.py --check 检查令牌，用 .env 存放密钥，再运行 python scripts/fyers_login.py 完成 OAuth；令牌缓存于 ~/.fyers/token.json。策略类交付物应为独立文件夹，包含逻辑、配置、运行器、README 与 Mermaid 流程图，并自动回测、生成 QuantStats 报告。可复用脚本：fyers_login.py、fyers_client.py、fyers_symbols.py、helper.py、option_chain.py、example_strategy.py、indicators.py、quantstats_report.py、trade_logger.py。
限制与安全规则：密钥只通过环境变量读取，禁止硬编码；下单代码默认 DRY_RUN；下单前必须用主文件校验标的，否则实盘报错 -300；实盘需用户明确确认与显式开启标志的双重门槛；限流为 10 次/秒、200 次/分、100000 次/天，订单操作 ≤10 次/秒，HTTP 429 需遵守 Retry-After；实时行情用 WebSocket 而非轮询；令牌每日过期，401 或 -8/-15/-16/-17 需重新登录。枚举码需查参考资料，不可猜测。