futucli/
cli.rs

1//! CLI 根参数定义 + 分发入口
2//!
3//! 这里把 `Command` 和 `dispatch` 作为子模块复用，既给 `main.rs` 的主入口用，
4//! 也给 REPL（`cmd::repl`）复用：REPL 把用户输入的一行解析为 `Cli`，
5//! 再调用 `dispatch` 走同一套 handler。
6
7use clap::Parser;
8
9use crate::output::OutputFormat;
10
11/// FutuOpenD-rs 命令行客户端
12#[derive(Parser)]
13#[command(
14    name = "futucli",
15    version,
16    about = "FutuOpenD-rs command-line client",
17    disable_help_subcommand = true,
18    long_about = "连接到 futu-opend 网关，查询行情 / 订阅推送 / 交易。"
19)]
20pub struct Cli {
21    /// 网关地址（可用 FUTU_GATEWAY 环境变量覆盖）
22    #[arg(
23        short,
24        long,
25        global = true,
26        env = "FUTU_GATEWAY",
27        default_value = "127.0.0.1:11111"
28    )]
29    pub gateway: String,
30
31    /// 输出格式
32    #[arg(short, long, global = true, value_enum, default_value_t = OutputFormat::Table)]
33    pub output: OutputFormat,
34
35    /// 启用调试日志
36    #[arg(short, long, global = true)]
37    pub verbose: bool,
38
39    /// 审计日志输出：JSONL 文件路径或目录（v1.2）
40    ///
41    /// 把 futucli 触发的 auth / 交易事件（target = `futu_audit`）单独写到这个
42    /// 文件 / 目录，方便 `jq` / DuckDB 后处理。和 futu-opend / futu-mcp 行为
43    /// 一致：
44    /// - 带扩展名的路径 → 单文件 append
45    /// - 不带扩展名 / 以 `/` 结尾 → 每日滚动 `futu-audit.log`
46    ///
47    /// 注意：审计事件由 futucli 调用的 RPC 客户端逻辑产生（如 `futucli unlock-trade`
48    /// 走 trade:real scope，会被服务端记下来）；本 flag 让 *客户端进程自己也*
49    /// 把这些事件落盘到本地，跟服务端审计互为校对。
50    #[arg(long, global = true)]
51    pub audit_log: Option<std::path::PathBuf>,
52
53    #[command(subcommand)]
54    pub command: Command,
55}
56
57mod commands;
58pub use commands::Command;
59
60#[cfg(test)]
61mod tests;
62
63mod dispatch;
64pub use dispatch::dispatch;
futucli/cli.rs

futucli/
cli.rs
