deepbook-cli

DeepBook CLI Skill 是一份面向 Sui 生态去中心化交易所 DeepBook 的完整命令行操作指南，涵盖从环境配置到复杂交易策略的全流程支持。

核心用法：该 Skill 指导用户通过 deepbook-cli npm 包与 DeepBook 协议交互，功能模块包括：市场数据查询（orderbook、trades、OHLCV）、账户与配置管理（~/.deepbook/config.json）、现货交易（spot buy/sell/limit）、一键兑换（swap）、保证金交易（margin deposit/market/limit/position/close）以及余额管理器（balance manager）操作。所有命令支持 --dry-run 预演，且提供主网/测试网双环境切换。

显著优点：
1. 功能覆盖全面：从只读市场数据到复杂的保证金杠杆交易，单工具覆盖 DeFi 交易全生命周期；
2. 安全设计内置：强制 --dry-run 建议、私钥保护机制（支持 --stdin 输入）、自动 gas 与抵押品分离、交易前余额验证；
3. 智能默认值：自动解析 balance manager、动态匹配 margin manager 类型、全仓平仓自动归一化数量；
4. 流式数据支持：SSE 实时交易流订阅，适合量化与监控场景。

潜在缺点与局限性：
1. 外部依赖风险：Skill 本身为纯文档，实际执行依赖 deepbook-cli npm 包，用户需自行验证该包来源；
2. 学习曲线陡峭：涉及区块链原生概念（object ID、lot size、reduce-only、margin manager 泛型匹配），新手易因类型不匹配导致交易失败；
3. 无图形界面：纯 CLI 交互，大额交易缺乏二次确认弹窗，误操作风险较高；
4. 网络与性能依赖：链上操作受 Sui 网络拥堵影响，CLI 无内置重试或滑点保护机制。

适合的目标群体：

• 熟悉 Sui 生态的 DeFi 交易者与做市商；
• 需要自动化策略或量化交易的开发者；
• 希望直接操作订单簿而非仅使用 AMM 的高级用户；
• 具备私钥安全管理经验的区块链原生用户。

使用风险：

• 资金风险：margin 操作涉及杠杆，错误平仓参数可能导致意外债务；
• 配置风险：--network 与 --rpc-url 错配可能导致交易发送至非预期网络；
• 依赖风险：npm 包更新可能引入破坏性变更，建议锁定版本；
• 隐私风险：命令行历史可能残留敏感参数，需配合 HISTCONTROL 等机制清理。