Module unlock 

futucli unlock-trade — 解锁 / 锁回交易

对 gateway 执行一次 UnlockTrade。成功后 gateway 进程级缓存会持有 cipher， 后续所有客户端（futucli / futu-mcp / Python）的下单都能自动拿到 cipher， 直到 gateway 重启。

密码来源优先级：

1. --from-stdin：从 stdin 读一整行（脚本友好）
2. 环境变量 FUTU_TRADE_PWD
3. 交互式 tty prompt（无回显）

明文密码不会出现在命令行参数里，避免 shell history / /proc/*/cmdline 泄露。 MD5 在本地计算后再发送。

Structs

UnlockTradeCliOutput 🔒

Enums

SecurityFirmArg

CLI 端的 SecurityFirm 枚举：clap ValueEnum 同时接受官方名称（FutuHK / FutuUS） 和短别名（hk / us）。值映射到 proto Trd_Common.SecurityFirm int32。

Functions

clear_login_pwd

futucli clear-login-pwd --account <id> —— 从 OS keychain 删除某账号的登录密码。

clear_trade_pwd

futucli clear-trade-pwd --account <id> —— 从 OS keychain 删除某账号的交易密码。

read_keychain_password 🔒

read_password 🔒

render_unlock_trade_output 🔒

run

set_login_pwd

futucli set-login-pwd --account <id> —— 把登录密码写入 OS keychain（v1.4.18+）。

set_trade_pwd

futucli set-trade-pwd --account <id> —— 把交易密码写入 OS keychain。

trim_stdin_password_line 🔒