futucli/cli/

commands.rs

//! clap subcommand enum definitions.
//!
//! Kept separate from `cli.rs` so the root CLI module only owns global flags
//! and re-exports the command type used by dispatch / REPL.

use clap::Subcommand;

mod key;
mod qot;
mod sys;
mod tier_m;
mod trade_read;
mod trade_write;

pub use key::{BindKeyArgs, GenKeyArgs, ListKeysArgs, MachineIdArgs, RevokeKeyArgs};
pub use qot::{
    BrokerArgs, CapitalFlowArgs, CompanyExecutiveBackgroundArgs, CompanyExecutivesArgs,
    CompanyOperationalEfficiencyArgs, CompanyProfileArgs, CorporateActionsBuybacksArgs,
    CorporateActionsDividendsArgs, CorporateActionsStockSplitsArgs, DailyShortVolumeArgs,
    DerivativeUnusualArgs, FinancialUnusualArgs, FinancialsEarningsPriceHistoryArgs,
    FinancialsEarningsPriceMoveArgs, FinancialsRevenueBreakdownArgs, FinancialsStatementsArgs,
    InsiderHolderListArgs, InsiderTradeListArgs, KlineArgs, OptionExerciseProbabilityArgs,
    OptionScreenArgs, OptionVolatilityArgs, OrderbookArgs, PlateListArgs, PlateStocksArgs,
    ProtoJsonArgs, QuoteArgs, ResearchAnalystConsensusArgs, ResearchMorningstarReportArgs,
    ResearchRatingSummaryArgs, RtArgs, ShareholdersHolderDetailArgs,
    ShareholdersHoldingChangesArgs, ShareholdersInstitutionalArgs, ShareholdersOverviewArgs,
    ShortInterestArgs, SnapshotArgs, StaticArgs, StockScreenArgs, SubArgs, TechnicalUnusualArgs,
    TickerArgs, TopTenBuySellBrokersArgs, ValuationDetailArgs, ValuationPlateStockListArgs,
    WarrantScreenArgs,
};
pub use sys::{
    DaemonReloadArgs, DaemonShutdownArgs, DaemonStatusArgs, HistoryKlQuotaArgs,
    QuerySubscriptionArgs, QuoteRightsArgs, TickerStatisticArgs, TickerStatisticDetailArgs,
    UnsubscribeArgs,
};
pub use tier_m::{
    AccountFlagArgs, BizGroupArgs, BondAnswerStateArgs, BondPositionListArgs, BondSingleAssetArgs,
    BondTotalAssetArgs, BondTradeReminderArgs, CashDetailArgs, CashLogArgs, MarginInfoArgs,
};
pub use trade_read::{
    AccCashFlowArgs, ComboMaxTrdQtysArgs, DealArgs, FundsArgs, HistoryDealsArgs, HistoryOrdersArgs,
    MarginRatioArgs, MaxQtysArgs, OrderArgs, OrderFeeArgs, PositionArgs,
};
pub use trade_write::{
    CancelOrderArgs, ComboOrderArgs, ModifyOrderArgs, PlaceOrderArgs, ReconfirmOrderArgs,
};

#[derive(Subcommand)]
pub enum Command {
    /// 探活：连接网关并测一次 RTT
    Ping,

    /// 获取基础实时报价（CLI 自动订阅 SubType::Basic）
    Quote(QuoteArgs),

    /// 获取股票快照（单次，无需订阅）
    Snapshot(SnapshotArgs),

    /// 订阅行情推送并持续打印（Ctrl-C 停止）
    ///
    /// v1.4.83 §10 新增 aliases: `subscribe` / `subscription`
    #[command(visible_aliases = ["subscribe", "subscription"])]
    Sub(SubArgs),

    /// 获取历史 K 线
    ///
    /// v1.4.83 §10: `--symbol` / `--code` / `--stock` flag alias 替代 positional
    Kline(KlineArgs),

    /// 获取摆盘
    ///
    /// v1.4.83 §10: `--symbol` / `--code` / `--stock` flag alias 替代 positional
    Orderbook(OrderbookArgs),

    /// 获取逐笔成交
    ///
    /// v1.4.83 §10: `--symbol` / `--code` / `--stock` flag alias
    Ticker(TickerArgs),

    /// 获取分时数据
    ///
    /// v1.4.83 §10: `--symbol` / `--code` / `--stock` flag alias
    Rt(RtArgs),

    /// 获取静态信息（名称、每手数量、类型、上市时间等）
    Static(StaticArgs),

    /// 获取经纪队列
    ///
    /// v1.4.83 §10: `--symbol` / `--code` / `--stock` flag alias
    Broker(BrokerArgs),

    /// 列出板块集合
    PlateList(PlateListArgs),

    /// 列出板块内股票
    PlateStocks(PlateStocksArgs),

    /// 列出交易账户（默认显示 App 可见账户集合）
    #[command(visible_alias = "accounts")]
    Account {
        /// 过滤交易市场：HK | US | CN | ... | all。不传时在 App 可见集合内不过滤。
        #[arg(long)]
        market: Option<String>,

        /// 过滤券商：FutuHK | FutuInc/FutuUS | hk | us | 1..7 | all。不传时在 App 可见集合内不过滤。
        #[arg(long, visible_alias = "firm")]
        security_firm: Option<String>,

        /// 排障模式：显示 daemon raw discovery 全集，包括 App 不单独展示的内部账户行。
        #[arg(long)]
        all: bool,
    },

    /// 查询账户资金
    Funds(FundsArgs),

    /// 查询持仓
    Position(PositionArgs),

    /// 查询当日订单
    Order(OrderArgs),

    /// 查询当日成交
    Deal(DealArgs),

    /// 解锁 / 锁定交易（gateway 进程级，重启失效）
    ///
    /// 密码来源优先级：--from-stdin > FUTU_TRADE_PWD 环境变量 > 交互式 prompt（无回显）。
    /// 解锁成功后所有连同一网关的客户端（futucli / futu-mcp / Python）都可下单。
    UnlockTrade {
        /// 锁回交易（清除 gateway 侧 cipher 缓存）
        #[arg(long)]
        lock: bool,

        /// 从 stdin 读一行作为密码（脚本管道友好，覆盖环境变量 / tty prompt）
        #[arg(long)]
        from_stdin: bool,

        /// OTP / 令牌动态密码明文（v1.4.31+，2FA 用户必填）
        ///
        /// 若账号开启了"令牌动态密码"二次验证：首次 unlock 会收到 daemon 提示
        /// `需要令牌动态密码`，再次调用带此参数即可。无 2FA 账号留空。
        #[arg(long)]
        otp: Option<String>,

        /// 只解锁该券商下的账户。不传则解锁所有 broker（默认，向后兼容）。
        /// 对齐 C++ OpenD 的 per-broker unlock 语义。
        ///
        /// 接受 3 种形式（v1.4.34 验证数字和别名确实能跑；clap 默认报错
        /// 消息只列官方名，用 `--help` 看详细用法）：官方名、1-7 数字、短别名。
        #[arg(
            long,
            value_enum,
            value_name = "FIRM",
            long_help = "\
只解锁该券商下的账户。不传则解锁所有 broker（默认，向后兼容）。

接受 3 种形式（等价）：
  1. 官方名：FutuHK FutuUS FutuSG FutuAU FutuCA FutuMY FutuJP
  2. 数字：   1       2      3      4      5      6      7
            (HK)   (US)    (SG)   (AU)   (CA)   (MY)   (JP)
  3. 短别名：hk / us / sg / au / ca / my / jp
            （moomoo 账号 = us；其他别名 futu-hk / futu-us / mm 等）

示例：
  --security-firm 1
  --security-firm hk
  --security-firm FutuHK
  --security-firm moomoo    # 等价 --security-firm us"
        )]
        security_firm: Option<crate::cmd::unlock::SecurityFirmArg>,

        /// v1.4.34+ 只解锁指定 acc_id 列表（逗号分隔）。和 `--security-firm`
        /// 同时传时取**交集**。解决同 broker 内影子账户拖垮主账户的场景——
        /// 显式传主账户 acc_id，影子账户不进请求。
        #[arg(long, value_delimiter = ',', value_name = "ACC_ID[,ACC_ID]...")]
        acc_ids: Vec<u64>,
    },

    /// 把交易密码存到 OS keychain（v1.4+）
    ///
    /// 存完后 futu-mcp 的 `futu_unlock_trade` 工具可以在 LLM 需要下单时自动
    /// 解锁，而不暴露明文密码给 LLM。默认以交互式 tty prompt 读入（无回显），
    /// 自动化脚本可用 `--from-stdin` 从 stdin 读一行。
    ///
    /// 后端：macOS Keychain / Linux DBus Secret Service / Windows Credential Manager。
    /// 每个登录账号一条独立条目（username = `trade-password.<account>`），
    /// 避免多账号互相覆盖。
    SetTradePwd {
        /// 登录账号（牛牛号 / 手机号 / 邮箱）—— 和 futu-opend --login-account 完全一致
        #[arg(long)]
        account: String,

        /// 从 stdin 读一行密码（脚本/CI 友好，不做二次确认）
        #[arg(long)]
        from_stdin: bool,
    },

    /// 清除 keychain 里某登录账号的交易密码
    ClearTradePwd {
        #[arg(long)]
        account: String,
    },

    /// 把登录密码写入 OS keychain（v1.4.18+）
    ///
    /// 存完后 `futu-opend` 启动时如果没传 `--login-pwd` / `FUTU_PWD`，会自动
    /// 从 keychain 读该账号的密码。每个账号一条独立条目（username =
    /// `login-password.<account>`），避免多账号互相覆盖。
    ///
    /// 默认以交互式 tty prompt 读入（无回显，不进 shell history），自动化脚本
    /// 可用 `--from-stdin` 从 stdin 读一行。
    SetLoginPwd {
        /// 账号（牛牛号 / 手机号 / 邮箱）—— 和 futu-opend --login-account 完全一致
        #[arg(long)]
        account: String,

        /// 从 stdin 读一行密码（脚本/CI 友好，不做二次确认）
        #[arg(long)]
        from_stdin: bool,
    },

    /// 清除 keychain 里某账号的登录密码
    ClearLoginPwd {
        #[arg(long)]
        account: String,
    },

    /// 进入交互式 REPL（共享一条长连接，历史记录，推送实时显示）
    Repl,

    /// 生成新的 futu-mcp API Key 并追加到 keys.json
    ///
    /// 明文 key 只会打印到 stdout 一次；文件中只存 SHA-256 hash。
    /// 用法示例：
    ///   futucli gen-key --id readonly --scopes qot:read,acc:read
    ///   futucli gen-key --id sim-bot --scopes qot:read,trade:simulate --expires 30d
    ///   futucli gen-key --id prod --scopes trade:real --allowed-markets HK \
    ///       --allowed-symbols HK.00700,HK.09988 --max-order-value 50000 \
    ///       --max-daily-value 200000 --hours-window 09:30-16:00 --expires 90d
    GenKey(GenKeyArgs),

    /// 就地编辑已有 key 的机器绑定（不重新生成明文）
    ///
    /// 用法示例：
    ///   futucli bind-key --id sim-bot --this-machine           # 追加本机
    ///   futucli bind-key --id sim-bot --machines aabb...,ccdd... # 追加指定指纹
    ///   futucli bind-key --id sim-bot --replace --this-machine # 覆盖白名单
    ///   futucli bind-key --id sim-bot --clear                  # 完全解绑
    ///   futucli bind-key --id sim-bot --freeze                 # 临时冻结（allowed_machines = []）
    /// 改完记得 SIGHUP 网关：kill -HUP $(pgrep futu-opend)
    BindKey(BindKeyArgs),

    /// 打印本机 machine-id 或指定 key_id 的绑定指纹
    ///
    /// 无 `--for-key` 时打印原始 machine-id（仅用于确认是不是同一台机器）。
    /// 加 `--for-key <id>` 时打印指纹（可复制给签发者，写进该 key 的 allowed_machines）。
    MachineId(MachineIdArgs),

    /// 列出 keys.json 中所有 API Key（不含明文，明文只在 gen-key 时打印一次）
    ///
    /// 默认输出短表格 (含 ID/STATUS/SCOPES/MARKETS/SYMBOLS/ACCOUNTS/LIMITS/DAILY/WINDOW/BOUND/EXPIRES/NOTE).
    /// 加 `--json` 输出机读 JSON (字段全, 含 hash / created_at / allowed_machines 等).
    ListKeys(ListKeysArgs),

    /// 吊销一条 API Key（按 id 从 keys.json 删除；需要运行中的网关 SIGHUP 才生效）
    RevokeKey(RevokeKeyArgs),

    // ===== v1.4.25: 交易扩展命令 =====
    /// 下单（Python SDK `OpenTradeContext.place_order`）
    ///
    /// **real env 必须带 `--confirm`**，防复制粘贴 / 回车误触。
    /// 建议先在 simulate env 测通再走 real。
    ///
    /// **Market session**（v1.4.111 修正 v1.4.35 表述）：协议层是否支持非交易时段下单
    /// 取决于 backend 行为, daemon 透传不主动拦. 常见交易时段:
    ///   - HK 主板: 周一至五 09:30-16:00 HKT（开盘前 09:00-09:30 可用 `--order-type AUCTION`）
    ///   - HK 暗盘: 16:00-19:00 HKT (部分 blue chip / ETF, backend 接受)
    ///   - US 主板: 周一至五 09:30-16:00 ET（HKT 冬令 22:30-05:00，夏令 21:30-04:00）
    ///   - US 盘前/盘后: 4:00-9:30 ET / 16:00-20:00 ET (backend 接受)
    ///   - CN: 周一至五 09:30-11:30 + 13:00-15:00 CST
    ///   - SG: 周一至五 09:00-17:00 SGT
    ///   - JP: 周一至五 09:00-11:30 + 12:30-15:00 JST
    ///   - AU: 周一至五 10:00-16:00 AEST/AEDT
    ///   - CA: 周一至五 09:30-16:00 EST/EDT
    ///
    /// **真实行为** (v1.4.110 真机 verify, essentials/2026-05-26-1800-v1.4.110-hk00700):
    /// HK 主板已收盘 (market status=6) 时 backend 仍可能接受订单 (暗盘 / GTC 预提交
    /// queue), daemon 透传 + 完整 push trail. daemon **仅在 backend 显式拒时**追加
    /// `[hint]` 说明 (e.g. backend 110005). 不要试图换 `--order-type` 绕过 backend
    /// 拒绝 — 如果 backend 接受订单, daemon 返 `ret_type=0` + 真实 `order_id`,
    /// 可通过 `/api/orders` 查最终 `order_status` (5=Submitted, 15=Cancelled_All).
    PlaceOrder(PlaceOrderArgs),

    /// 改单 / 撤单 / 启停订单（Python SDK `OpenTradeContext.modify_order`）
    ///
    /// **响应语义**（v1.4.111 P2-5 doc 沉淀,对齐 C++ APIServer_Trd_ModifyOrder by-design）：
    /// `ret_type=0` 仅表示 backend 接受了 modify 操作（operation ACK）。**不**保证下游
    /// `futucli order` / `/api/orders` 查询立即看到新 price/qty/status。Race window 通常
    /// < 2s（backend push 异步同步 daemon orders cache）。
    ///
    /// **正确 client pattern**（ack-based）:
    ///   - modify-order 返 ret_type=0 → assume backend 接受
    ///   - sleep 1-2s 或订阅 push event 后 retry `futucli order` 看新状态
    ///   - v1.4.109 stub TTL guard fallback 兜底（2s+ 无 push 主动 refresh orders）
    ///
    /// **不修原因**: C++ OpenD 同条件也只返 operation ACK,Rust 同 C++ 行为 = by-design
    /// 对齐（pitfall #51 "对齐 C++ = 减法, 不超越"）。
    ModifyOrder(ModifyOrderArgs),

    /// 撤单（modify-order 的常用快捷方式，op=CANCEL）
    CancelOrder(CancelOrderArgs),

    /// 二次确认订单（Python SDK `OpenTradeContext.reconfirm_order`）
    ReconfirmOrder(ReconfirmOrderArgs),

    /// 查询历史订单（Python SDK `OpenTradeContext.history_order_list_query`）
    HistoryOrders(HistoryOrdersArgs),

    /// 查询历史成交（Python SDK `OpenTradeContext.history_deal_list_query`）
    HistoryDeals(HistoryDealsArgs),

    /// 查最大可买/可卖（Python SDK `OpenTradeContext.acctradinginfo_query`）
    MaxQtys(MaxQtysArgs),

    /// 查询组合订单最大可交易数量（Futu API v10.7 `get_combo_max_trd_qtys`，proto-json）
    ComboMaxTrdQtys(ComboMaxTrdQtysArgs),

    /// 组合期权下单（Futu API v10.7 `place_combo_order`，proto-json）
    ComboOrder(ComboOrderArgs),

    /// 查询融资融券比率（对齐 py-futu-api `get_margin_ratio`；v1.4.31）
    MarginRatio(MarginRatioArgs),

    /// 查询订单费用明细（对齐 py-futu-api `order_fee_query`；v1.4.31）
    OrderFee(OrderFeeArgs),
    /// 资金流向时间序列
    CapitalFlow(CapitalFlowArgs),
    /// 资金分布快照（超大/大/中/小单流入流出）
    CapitalDistribution { symbol: String },
    /// 公司详情标签（Futu API v10.6 `get_company_profile`）
    CompanyProfile(CompanyProfileArgs),
    /// 公司高管信息（Futu API v10.6 `get_company_executives`）
    CompanyExecutives(CompanyExecutivesArgs),
    /// 公司高管背景（Futu API v10.6 `get_company_executive_background`）
    CompanyExecutiveBackground(CompanyExecutiveBackgroundArgs),
    /// 公司经营效率（Futu API v10.6 `get_company_operational_efficiency`）
    CompanyOperationalEfficiency(CompanyOperationalEfficiencyArgs),
    /// 财报日前后价格表现（Futu API v10.6 `get_financials_earnings_price_move`）
    FinancialsEarningsPriceMove(FinancialsEarningsPriceMoveArgs),
    /// 财报日前后股价历史（Futu API v10.6 `get_financials_earnings_price_history`）
    FinancialsEarningsPriceHistory(FinancialsEarningsPriceHistoryArgs),
    /// 财务报表（Futu API v10.6 `get_financials_statements`）
    FinancialsStatements(FinancialsStatementsArgs),
    /// 主营构成（Futu API v10.6 `get_financials_revenue_breakdown`）
    FinancialsRevenueBreakdown(FinancialsRevenueBreakdownArgs),
    /// 分析师评级概述（Futu API v10.6 `get_research_analyst_consensus`）
    ResearchAnalystConsensus(ResearchAnalystConsensusArgs),
    /// 评级汇总/详情（Futu API v10.6 `get_research_rating_summary`）
    ResearchRatingSummary(ResearchRatingSummaryArgs),
    /// 晨星研究报告（Futu API v10.6 `get_research_morningstar_report`）
    ResearchMorningstarReport(ResearchMorningstarReportArgs),
    /// 个股/指数估值详情（Futu API v10.6 `get_valuation_detail`）
    ValuationDetail(ValuationDetailArgs),
    /// 板块/指数成分股估值列表（Futu API v10.6 `get_valuation_plate_stock_list`）
    ValuationPlateStockList(ValuationPlateStockListArgs),
    /// 股票筛选（Futu API v10.6 `stock_screen`）
    StockScreen(StockScreenArgs),
    /// 期权筛选（Futu API v10.6 `option_screen`）
    OptionScreen(OptionScreenArgs),
    /// 窝轮筛选（Futu API v10.6 `warrant_screen`）
    WarrantScreen(WarrantScreenArgs),
    /// 技术指标异动（Futu API v10.6 `get_technical_unusual`）
    TechnicalUnusual(TechnicalUnusualArgs),
    /// 财务异动（Futu API v10.6 `get_financial_unusual`）
    FinancialUnusual(FinancialUnusualArgs),
    /// 衍生品异动（Futu API v10.6 `get_derivative_unusual`）
    DerivativeUnusual(DerivativeUnusualArgs),
    /// 回购记录（Futu API v10.6 `get_corporate_actions_buybacks`）
    CorporateActionsBuybacks(CorporateActionsBuybacksArgs),
    /// 分红派息（Futu API v10.6 `get_corporate_actions_dividends`）
    CorporateActionsDividends(CorporateActionsDividendsArgs),
    /// 拆合股（Futu API v10.6 `get_corporate_actions_stock_splits`）
    CorporateActionsStockSplits(CorporateActionsStockSplitsArgs),
    /// 每日卖空成交（Futu API v10.6 `get_daily_short_volume`）
    DailyShortVolume(DailyShortVolumeArgs),
    /// 空头持仓（Futu API v10.6 `get_short_interest`）
    ShortInterest(ShortInterestArgs),
    /// 十大买卖经纪（Futu API v10.6 `get_top_ten_buy_sell_brokers`）
    TopTenBuySellBrokers(TopTenBuySellBrokersArgs),
    /// 持股统计（Futu API v10.6 `get_shareholders_overview`）
    ShareholdersOverview(ShareholdersOverviewArgs),
    /// 股东持股变动（Futu API v10.6 `get_shareholders_holding_changes`）
    ShareholdersHoldingChanges(ShareholdersHoldingChangesArgs),
    /// 股东持股明细（Futu API v10.6 `get_shareholders_holder_detail`）
    ShareholdersHolderDetail(ShareholdersHolderDetailArgs),
    /// 机构持股统计（Futu API v10.6 `get_shareholders_institutional`）
    ShareholdersInstitutional(ShareholdersInstitutionalArgs),
    /// 内部人持股列表（Futu API v10.6 `get_insider_holder_list`）
    InsiderHolderList(InsiderHolderListArgs),
    /// 内部人交易列表（Futu API v10.6 `get_insider_trade_list`）
    InsiderTradeList(InsiderTradeListArgs),
    /// 期权波动率分析（Futu API v10.6 `get_option_volatility`）
    OptionVolatility(OptionVolatilityArgs),
    /// 期权行权概率（Futu API v10.6 `get_option_exercise_probability`）
    OptionExerciseProbability(OptionExerciseProbabilityArgs),
    /// 组合/单腿期权行情（Futu API v10.7 `get_option_quote`，proto-json）
    OptionQuote(ProtoJsonArgs),
    /// 组合期权策略列表（Futu API v10.7 `get_option_strategy`，proto-json）
    OptionStrategy(ProtoJsonArgs),
    /// 组合期权策略分析（Futu API v10.7 `get_option_strategy_analysis`，proto-json）
    OptionStrategyAnalysis(ProtoJsonArgs),
    /// 组合期权有效价差（Futu API v10.7 `get_option_strategy_spread`，proto-json）
    OptionStrategySpread(ProtoJsonArgs),
    /// 市场状态查询（开盘/休市/午休）
    MarketState {
        /// 证券列表，逗号分隔，如 HK.00700,US.AAPL
        symbols: String,
    },

    /// 股票所属板块
    OwnerPlate {
        /// 证券列表，逗号分隔
        symbols: String,
    },

    /// 期权链（按到期日列出 call/put 合约）
    OptionChain {
        /// 正股 MARKET.CODE，如 HK.00700 / US.AAPL（位置参数或 --owner / --code 二选一）
        #[arg(index = 1, value_name = "OWNER")]
        owner: Option<String>,
        /// v1.4.52 BUG-9: REST/MCP 风格命名参数 alias
        #[arg(long = "owner", visible_alias = "code", conflicts_with = "owner")]
        owner_arg: Option<String>,
        /// 到期日范围开始 YYYY-MM-DD
        #[arg(long)]
        begin: String,
        /// 到期日范围结束 YYYY-MM-DD
        #[arg(long)]
        end: String,
        /// 期权类型：all|call|put（默认 all）
        #[arg(long, default_value = "all")]
        option_type: String,
        /// Greek filter: delta 下限
        #[arg(long)]
        delta_min: Option<f64>,
        /// Greek filter: delta 上限
        #[arg(long)]
        delta_max: Option<f64>,
        /// Greek filter: implied volatility 下限（小数，如 0.3 = 30%）
        #[arg(long)]
        iv_min: Option<f64>,
        /// Greek filter: implied volatility 上限（小数，如 0.3 = 30%）
        #[arg(long)]
        iv_max: Option<f64>,
        /// Greek filter: open interest 下限
        #[arg(long)]
        oi_min: Option<f64>,
        /// Greek filter: open interest 上限
        #[arg(long)]
        oi_max: Option<f64>,
        /// Greek filter: gamma 下限
        #[arg(long)]
        gamma_min: Option<f64>,
        /// Greek filter: gamma 上限
        #[arg(long)]
        gamma_max: Option<f64>,
        /// Greek filter: vega 下限
        #[arg(long)]
        vega_min: Option<f64>,
        /// Greek filter: vega 上限
        #[arg(long)]
        vega_max: Option<f64>,
        /// Greek filter: theta 下限
        #[arg(long)]
        theta_min: Option<f64>,
        /// Greek filter: theta 上限
        #[arg(long)]
        theta_max: Option<f64>,
    },

    // ===== v1.4.30 市场元数据 / 复权 / 自选 / 撤单 =====
    /// 交易日列表（对齐 py-futu-api `request_trading_days`）
    TradingDays {
        /// 市场：HK / US / CN / NT / ST / JP / SG
        #[arg(long)]
        market: String,
        /// 起始日期 YYYY-MM-DD
        #[arg(long)]
        begin: String,
        /// 结束日期 YYYY-MM-DD
        #[arg(long)]
        end: String,
    },

    /// 复权因子（对齐 py-futu-api `get_rehab`；长期 K 线对齐 / 回测必用）
    Rehab {
        /// 证券 MARKET.CODE，如 HK.00700 / US.AAPL
        symbol: String,
    },

    /// 停牌日查询（对齐 py-futu-api `get_suspend`）
    Suspend {
        /// 证券列表，逗号分隔（位置参数或 --code / --symbols 二选一）
        #[arg(index = 1, value_name = "SYMBOLS")]
        symbols: Option<String>,
        /// v1.4.52 BUG-9: REST/MCP 风格命名参数 alias
        #[arg(long = "code", visible_alias = "symbols", conflicts_with = "symbols")]
        symbols_arg: Option<String>,
        /// 起始日期 YYYY-MM-DD
        #[arg(long)]
        begin: String,
        /// 结束日期 YYYY-MM-DD
        #[arg(long)]
        end: String,
    },

    /// 自选股分组下的股票（对齐 py-futu-api `get_user_security`）
    UserSecurity {
        /// 分组名（位置参数或 --group 二选一，用 `user-security-groups` 先看可用分组）
        #[arg(index = 1, value_name = "GROUP")]
        group: Option<String>,
        /// v1.4.52 BUG-9: REST/MCP 风格命名参数 alias
        #[arg(long = "group", conflicts_with = "group")]
        group_arg: Option<String>,
    },

    /// 自选股分组列表（对齐 py-futu-api `get_user_security_group`）
    UserSecurityGroups {
        /// 分组类型：1=自定义 / 2=系统 / 3=全部（默认 3）
        #[arg(long, default_value_t = 3)]
        group_type: i32,
    },

    /// 涡轮列表（对齐 py-futu-api `get_warrant`；按成交量降序）
    Warrant {
        /// 可选正股 MARKET.CODE（不传则全市场）
        #[arg(long)]
        owner: Option<String>,
        /// 分页起始 index (默认 0). v1.4.106 codex 0635 ζ36 F1: 暴露分页参数,
        /// 拿下一页用 `--begin 20 --num 20` (响应含 last_page / all_count)
        #[arg(long, default_value_t = 0)]
        begin: i32,
        /// 最大行数（0-200，默认 20；0 表示空页请求）
        #[arg(long, default_value_t = 20)]
        num: i32,
    },

    /// 新股 IPO 列表（对齐 py-futu-api `get_ipo_list`）
    IpoList {
        /// 市场：HK=1 / HK_FUTURE=2 / US=11 / CN/SH=21 / SZ=22 / SG=31 / JP=41 / MY=61
        #[arg(long)]
        market: String,
    },

    /// 期货合约资料（对齐 py-futu-api `get_future_info`）
    FutureInfo {
        /// 期货代码列表，逗号分隔（如 HK.HSImain / US.MNQmain）
        symbols: String,
    },

    /// 条件选股最小版（对齐 py-futu-api `get_stock_filter`；高级过滤走 REST）
    StockFilter {
        /// 市场：HK=1 / HK_FUTURE=2 / US=11 / CN/SH=21 / SZ=22
        #[arg(long)]
        market: String,
        /// 分页起始（默认 0）
        #[arg(long, default_value_t = 0)]
        begin: i32,
        /// 返回行数（0-200，默认 50；0 表示空页请求）
        #[arg(long, default_value_t = 50)]
        num: i32,
    },

    /// 全部撤单（对齐 py-futu-api `cancel_all_order`）
    ///
    /// ⚠️ 风险：立即撤该账户**指定市场**（不传 --market 则全账户）所有
    /// pending 订单，不可恢复。real env 必须 `--confirm`。
    CancelAllOrder {
        /// 账户 id；也可改用 --card-num 传 App 显示卡号
        #[arg(index = 1, value_name = "ACC_ID")]
        acc_id: Option<u64>,
        /// App 显示卡号：4 位末尾或 16 位完整卡号
        #[arg(long = "card-num")]
        card_num: Option<String>,
        /// 环境：simulate（默认）/ real
        #[arg(long, default_value = "simulate")]
        env: String,
        /// 市场：HK / US / HKCC / CN（可选，不传则全账户）
        #[arg(long)]
        market: Option<String>,
        /// JP 子账户类型（TrdHeader.jpAccType / TrdSubAccType）
        #[arg(long = "jp-acc-type")]
        jp_acc_type: Option<i32>,
        /// real 环境必须带此 flag 确认（防误触）
        #[arg(long)]
        confirm: bool,
    },

    /// 网关全局状态（市场开闭 / 服务器版本 / 登录状态）
    GlobalState,

    /// 用户信息（昵称 / 各市场行情权限 / 订阅配额 / 历史 K 线配额）
    UserInfo,

    /// 行情权限概览（C++ OpenD GUI 风格分组；可选刷新最高行情权限）
    QuoteRights(QuoteRightsArgs),

    /// 延迟统计（行情推送 / 请求 / 下单三类延迟分布概要）
    DelayStatistics,

    /// v1.4.98 T2-8: NN+MM token 启用/绑定状态查询. unlock-trade -20011 时
    /// 第一线诊断 (NN=Futu Token app, MM=moomoo Token app, 同协议异 app brand).
    /// 输出 4 字段: nn/mm × enable/bind (1=已启用/绑定, 0=未启用/未绑定).
    TokenState,

    /// v1.4.98 T2-2: 无风险利率 (HK/US/JP, 期权定价基准). backend cmd 20231.
    /// 输出 3 市场利率 (百分比 + raw uint64) + update_time.
    RiskFreeRate,

    /// v1.4.98 T2-1: 摆盘步长 (价位表) — backend cmd 6503.
    /// PlaceOrder/ModifyOrder 校验价格合法性必备.
    SpreadTable,

    /// v1.4.98 T2-3: 逐笔统计 (avg_price / 主买/主卖/中性量等) — cmd 6365.
    /// 前置: symbol 必须先 subscribe / get_static_info 触发 stock_id 缓存.
    ///
    /// v1.4.102 A3 alias: 加 positional `[SYMBOL]` 短写, 跟其他行情类
    /// command (quote / snapshot / kline) 一致. `futucli ticker-statistic
    /// HK.00700` 等同 `--symbol HK.00700`.
    TickerStatistic(TickerStatisticArgs),

    /// v1.4.106 codex 0500 ζ23-redo: 逐笔统计 Detail (价位级分布) — cmd 6366.
    /// 配套 `ticker-statistic` (Info, cmd 6365): 先调 Info 拿 `ticker_time`,
    /// 再调 Detail 同 `ticker_time` 拿这个时点的 DetailItem 列表 (price /
    /// buy_volume / sell_volume / volume / ratio / neutral_volume).
    /// 前置: symbol 必须先 subscribe / get_static_info 触发 stock_id 缓存.
    TickerStatisticDetail(TickerStatisticDetailArgs),

    // ===== v1.4.30 P2（100% 覆盖） =====
    /// 查询当前订阅状态（已用 / 剩余额度 + 订阅清单）
    QuerySubscription(QuerySubscriptionArgs),

    /// 查询当前 daemon 已用订阅额度与历史 K 线额度
    UsedQuota,

    /// 反订阅行情数据（也可 --all 清空本连接所有订阅）
    Unsubscribe(UnsubscribeArgs),

    /// 历史 K 线下载配额
    HistoryKlQuota(HistoryKlQuotaArgs),

    /// 持股变动（高管 / 机构 / 基金）
    HoldingChange {
        /// 证券 MARKET.CODE
        symbol: String,
        /// 持有者类别：1=机构 / 2=基金 / 3=高管
        #[arg(long, default_value_t = 3)]
        category: i32,
        /// 开始时间 YYYY-MM-DD HH:MM:SS（可选）
        #[arg(long)]
        begin: Option<String>,
        /// 结束时间（可选）
        #[arg(long)]
        end: Option<String>,
    },

    /// 修改自选股分组（add / del / move_out）
    ModifyUserSecurity {
        /// 分组名
        group: String,
        /// 操作：1=AddInto / 2=Delete / 3=MoveOut
        #[arg(long)]
        op: i32,
        /// 证券列表，逗号分隔
        symbols: String,
    },

    /// 股票代码变更 / 临时代码信息（目前仅港股）
    CodeChange {
        /// 证券列表，逗号分隔
        symbols: String,
    },

    /// 设置到价提醒
    SetPriceReminder {
        /// 证券 MARKET.CODE
        symbol: String,
        /// 操作：1=Add / 2=Del / 3=Enable / 4=Disable / 5=Modify / 6=DelAll
        #[arg(long)]
        op: i32,
        /// 提醒 key（modify/del/enable/disable 时必填）
        #[arg(long)]
        key: Option<i64>,
        /// 提醒类型 (1=PriceUp 2=PriceDown 3=ChangeRateUp 4=ChangeRateDown
        /// 5=5MinChangeRateUp 6=5MinChangeRateDown 7=VolumeUp 8=TurnoverUp
        /// 9=TurnoverRateUp 10=BidPriceUp 11=AskPriceDown 12=BidVolUp 13=AskVolUp
        /// 14=3MinChangeRateUp 15=3MinChangeRateDown — 见 Qot_Common.PriceReminderType)
        #[arg(long)]
        r#type: Option<i32>,
        /// 频率（1=Always 2=OncePerDay 3=Once）
        #[arg(long)]
        freq: Option<i32>,
        /// 阈值（add/modify 必填）
        #[arg(long)]
        value: Option<f64>,
        /// 备注 (最多 40 半角字节 / 20 中文字符, 对齐 C++ NoteMaxLen)
        #[arg(long)]
        note: Option<String>,
        /// v1.4.106 codex 1116 F4 [P2]: reminder session list, 逗号分隔.
        /// (1=Open 2=USPre 3=USAfter 4=USOverNight)
        /// 美股 + 留空 → daemon 默认补 [Open, USPre, USAfter] (对齐 C++).
        #[arg(long, value_delimiter = ',')]
        session: Vec<i32>,
    },

    /// 查询到价提醒（按 symbol 或 market）
    PriceReminder {
        /// 证券（和 --market 二选一）
        #[arg(long)]
        symbol: Option<String>,
        /// C++ 到价提醒市场桶：HK=1 HK_FUTURE=6 US=11 SH/CN=21 SZ=22（和 --symbol 二选一）
        #[arg(long)]
        market: Option<String>,
    },

    /// 期权到期日列表
    OptionExpirationDate {
        /// 标的股 MARKET.CODE（位置参数或 --owner 二选一）
        #[arg(index = 1, value_name = "OWNER")]
        owner: Option<String>,
        /// v1.4.52 BUG-9: REST/MCP 风格命名参数 alias
        #[arg(long = "owner", conflicts_with = "owner")]
        owner_arg: Option<String>,
        /// 指数期权类型（仅恒指/国指）
        #[arg(long)]
        index_type: Option<i32>,
    },

    /// 订阅账户推送（订单 / 成交）
    SubAccPush {
        /// 账户 id 列表，逗号分隔
        acc_ids: String,
    },

    /// 账户资金流水（对齐 `get_acc_cash_flow`）
    AccCashFlow(AccCashFlowArgs),

    /// v1.4.32+ daemon 健康状态快照（GET /api/admin/status）。
    /// 同事提议的"快速看 daemon 在线不、broker 通不通、解锁没"工具。
    /// scope 模式下 key 必须持 `admin` scope，否则被 bearer_auth 拒。
    #[command(name = "daemon-status")]
    DaemonStatus(DaemonStatusArgs),

    /// v1.4.32+ 优雅退出 daemon（POST /api/admin/shutdown）。
    /// daemon 响应 200 表示已接收 shutdown 请求；实际退出走 opend 统一
    /// graceful shutdown 路径。是否重启由进程 supervisor（systemd / Docker）
    /// 决定。
    #[command(name = "daemon-shutdown")]
    DaemonShutdown(DaemonShutdownArgs),

    /// v1.4.32+ 重置 trade cipher 缓存（POST /api/admin/reload）。
    /// 用于"解锁状态错乱 / 换了交易密码"场景——清空 cipher 缓存后客户端
    /// 必须重新 unlock-trade。不重启 daemon 进程，不影响 Platform / broker
    /// TCP 连接。
    #[command(name = "daemon-reload")]
    DaemonReload(DaemonReloadArgs),

    // ========================================================================
    // v1.4.94 / v1.4.95 Tier M (mobile-driven extensions): 11 subcommand 镜像
    // REST + MCP. 全 only-read (acc:read scope). 见 cmd/tier_m.rs.
    // ========================================================================
    /// 资金明细查询 (mobile-driven, 比 acc-cash-flow 字段更全) — v1.4.94 M1
    ///
    /// v1.4.102 A3 alias: positional `[ACC_ID]` 短写
    /// (`futucli cash-log 12345 --begin-time ...` 等同 `--acc-id 12345`).
    #[command(name = "cash-log")]
    CashLog(CashLogArgs),

    /// 单条资金流水详情 — v1.4.94 M1 + v1.4.102 A3 positional alias
    #[command(name = "cash-detail")]
    CashDetail(CashDetailArgs),

    /// 业务分类元数据 — v1.4.94 M1 + v1.4.102 A3 positional alias
    #[command(name = "biz-group")]
    BizGroup(BizGroupArgs),

    /// per-account margin info (HK / US / CN_AH) — v1.4.95 U2-D
    ///
    /// 与 `margin-ratio` (per-security ratio) 互补: 本命令给账户全景
    /// (购买力 / 杠杆 / 风险等级 / 流动性 / HK-specific 港股保证金).
    #[command(name = "margin-info")]
    MarginInfo(MarginInfoArgs),

    /// 账户合规标志查询 — v1.4.95 U2-A
    ///
    /// 高级交易准入 (期权 / 衍生品 / OTC / CFD 等) 强制要求.
    /// 常用 flag_id: 5=US 期权确认, 22=衍生品风批 (合并新), 10=基金 KYC,
    /// 16=PDT 风披, 23=美股 OTC. 详见 proto 头部完整 36+ 项列表.
    #[command(name = "account-flag")]
    AccountFlag(AccountFlagArgs),

    /// 账户债券总持仓 (P&L 汇总) — v1.4.95 U2-B
    #[command(name = "bond-total-asset")]
    BondTotalAsset(BondTotalAssetArgs),

    /// 单只债券持仓 (含派息/到期/通知) — v1.4.95 U2-B
    #[command(name = "bond-single-asset")]
    BondSingleAsset(BondSingleAssetArgs),

    /// 账户债券持仓列表 — v1.4.95 U2-B
    #[command(name = "bond-position-list")]
    BondPositionList(BondPositionListArgs),

    /// 是否需要答题 (suitability questionnaire) — v1.4.95 U2-B
    #[command(name = "bond-answer-state")]
    BondAnswerState(BondAnswerStateArgs),

    /// 交易提醒 (是否可买/复杂/高风险/可卖/资格预审) — v1.4.95 U2-B
    #[command(name = "bond-trade-reminder")]
    BondTradeReminder(BondTradeReminderArgs),
}