用 okx CLI 管理 OKX…

当用户想查询或操作 OKX 平台的各类赚币产品（活期、定期、链上赚币、双币赢、自动赚币、闪赚）时，通过 okx CLI 完成查询、申购、赎回、设置利率等操作。

适用场景

解决思路

1. 安装 okx CLI：`npm install -g @okx_ai/okx-trade-cli`
2. 配置凭证：`okx config init`（选择站点后按浏览器 OAuth 流程操作），绝不要在聊天中接受用户粘贴的凭证
3. 验证安装：`okx earn savings balance`
4. 在任何需要认证的命令前，先并行运行 `okx config show --json` 和 `okx auth status --json` 两个命令；`config show --json` 是判断 API Key 是否存在的唯一权威来源（`auth status --json` 中的 apiKey 字段始终为 false）
5. 按顺序判断认证模式（先匹配者优先）：若 `config show --json` 中任一 profile 的 `api_key` 非空 → API Key 模式，继续；若无 API Key 且 `auth status --json` 返回 `"status":"logged_in"` → OAuth 模式，继续；若无 API Key 且状态为 `"pending"` → 等待登录完成；若无 API Key 且状态为 `"not_logged_in"` → 停止，加载 okx-cex-auth 技能执行登录并等待完成
6. OKX Earn 不支持模拟模式，始终静默使用实盘模式：API Key 用户加 `--profile <live-profile>`（不带 demo=true 的 profile）；OAuth 用户无需加参数
7. 遇到认证错误（401 / "Session expired" / "Run `okx auth login` first"）时立即停止，加载 okx-cex-auth 技能重新认证后重试
8. 识别用户意图并路由：行情价格走 okx-cex-market；现货/合约/期权订单走 okx-cex-trade；账户余额/持仓/转账走 okx-cex-portfolio；网格/DCA 机器人走 okx-cex-bot；Simple Earn、Flash Earn、On-chain Earn、Dual Investment、AutoEarn 走本技能
9. Simple Earn 活期查询：`earn savings balance [ccy]` 查余额（同时获取定期订单以了解全貌）；`earn savings lending-history` 查个人出借记录；`earn savings rate-history` 查利率和定期报价
10. Simple Earn 活期写操作：`earn savings purchase --ccy --amt [--rate]` 申购；`earn savings redeem --ccy --amt` 赎回；`earn savings set-rate --ccy --rate` 设置最低出借利率
11. Simple Earn 定期操作：`earn savings fixed-orders [--ccy] [--state]` 查询订单（状态：pending/earning/expired/settled/cancelled）；`earn savings fixed-purchase --ccy --amt --term [--confirm]` 申购（不带 --confirm 仅预览）；`earn savings fixed-redeem <reqId>` 赎回（仅 pending 状态可提前赎回）
12. 双币赢（DCD）操作：`earn dcd pairs` 查可用币对；`earn dcd products` 查活跃产品；`earn dcd quote-and-buy --productId --sz --notionalCcy` 原子申购（报价+执行一步完成）；`earn dcd order --ordId` 查单笔订单状态；`earn dcd orders` 查订单列表/历史；`earn dcd redeem-execute --ordId` 两步提前赎回（先预览再执行）
13. 链上赚币操作：`earn onchain offers` 查可用质押/DeFi 产品；`earn onchain purchase --productId --ccy --amt` 申购；`earn onchain redeem --ordId --protocolType` 赎回；`earn onchain cancel --ordId --protocolType` 取消待处理订单；`earn onchain orders` 查活跃订单；`earn onchain history` 查历史订单
14. 自动赚币操作：`earn auto-earn status [CCY]` 查支持自动赚币的币种及状态；`earn auto-earn on <CCY>` 开启；`earn auto-earn off <CCY>` 关闭；注意开启后 24 小时内无法关闭（API 硬限制），开启前务必提醒用户
15. 闪赚操作：`earn flash-earn projects [--status <0|100|0,100>]` 按状态浏览项目，`0`=即将开始，`100`=进行中，默认两者都显示
16. 当用户要求查看「赚币持仓」时（无论是否提到 DCD），并行查询所有有持仓的子模块：`okx earn savings balance --json`、`okx earn savings fixed-orders --json`、`okx earn onchain orders --json`、`okx earn dcd orders --json`；只展示有实际持仓的部分；DCD 状态码需按 dcd-commands.md 中的表格翻译
17. 所有写操作（WRITE）必须先展示摘要并等待用户明确确认；「just do it」「直接搞」不算有效确认，用户必须先看到摘要
18. 执行后验证：DCD quote-and-buy 成功后运行 `earn dcd orders --json` 只展示匹配订单；链上申购（响应含 ordId）后运行 `earn onchain orders --json` 只展示匹配订单；活期申购（响应无 ordId）后运行 `earn savings balance --ccy <ccy> --json`；定期申购后运行 `earn savings fixed-orders --ccy <ccy> --state pending --json` 展示新订单
19. 活期申购验证：并行运行 `earn savings balance --ccy <ccy>` 和 `earn savings rate-history --ccy <ccy> --limit 1 --json`
20. 活期赎回验证：运行 `earn savings balance --ccy <ccy>` 确认余额更新，告知用户资金已返回资金账户
21. 定期申购验证：运行 `earn savings fixed-orders --ccy <ccy> --state pending --json` 确认订单创建，展示 APR、期限和预计到期日
22. 定期赎回验证：运行 `earn savings fixed-orders --json` 确认订单状态变为 `cancelled`，告知用户全额本金已返回资金账户，提前取消不产生利息
23. 链上赎回验证：查询 `earn onchain orders` 确认状态，展示 `estSettlementTime` 作为预计到账时间
24. 链上取消验证：提交后查询 `earn onchain orders`——订单从列表消失则告知取消完成、资金已返回资金账户；状态为 `state: 3`（取消中）则告知取消进行中、资金稍后返回资金账户
25. 所有列表/查询命令始终加 `--json`，结果渲染为 Markdown 表格，绝不粘贴原始终端输出
26. 网络错误时提示用户检查 VPN：`curl -I https://www.okx.com`
27. 始终用用户的语言回复
28. 多步骤工作流（闲置资金分析、申购+验证、赎回+转账、链上申购、DCD 浏览/申购/提前赎回）需阅读 `{baseDir}/references/workflows.md`；各子模块详细语法和确认模板见对应 references 文件

适用边界 · 注意事项

• 未安装 okx CLI 或未完成凭证配置（`okx config init`）时无法使用
• OKX Earn 不支持模拟/演示模式，无法在 demo 环境下测试
• 自动赚币开启后 24 小时内无法关闭（API 硬限制）