用途：Alpaca CLI 是 Alpaca Trading API 的命令行工具，用于安装、配置并调用交易与行情接口，适合脚本、CI 和智能体等自动化场景。
安装与验证：先运行 alpaca version 检查是否已安装；未安装则执行 go install github.com/alpacahq/cli/cmd/alpaca@latest。验证可用 alpaca clock --quiet，认证后可用 alpaca account get --quiet，退出码 0 表示成功，2 表示认证错误。
认证：默认模拟交易。alpaca profile login 使用 OAuth 且仅限模拟；实盘需 API 密钥，如 alpaca profile login --api-key --live。凭据存于 ~/.config/alpaca/profiles/，权限 0600。自动化推荐环境变量 ALPACA_API_KEY 与 ALPACA_SECRET_KEY，默认模拟，实盘需设 ALPACA_LIVE_TRADE=true；环境变量凭据优先于磁盘 profile。
主要能力：支持多 profile 切换（alpaca profile switch）、订单提交与查询、行情数据（如 alpaca data latest-trade、alpaca data bars）、分页（--limit、--page-token）、jq 过滤（--jq）、干跑（--dry-run）、幂等下单（--client-order-id）、调试（--verbose、--trace、--debug）以及自更新（alpaca update --check）。
使用方式：JSON 为默认输出，自动化中应始终加 --quiet 或设 ALPACA_QUIET=1；错误以 JSON 输出到 stderr。命令发现可用 alpaca --help-all、<command> --help、<command> --schema。
限制与注意：不要用 --secret 命令行参数以免泄露；不要忽略退出码 2；自动化下单必须带 --client-order-id 防止重复；实盘操作需用户明确意图，不确定时先用 --dry-run；创建 locate 可能产生费用，需用户明确同意。OAuth 目前仅限模拟，环境变量无法设置 OAuth 令牌。