Duola Lobster Agent

概述

以代理工具链形式执行 duola 的标准操作工作流。
推荐分阶段上线：同步 → 回测 → 诊断 → 有限实盘启动 → 状态/日志审查。

计费配置（SkillPay）

在运行环境中一次性配置：

bash
export SKILLPAYAPIURL=https://skillpay.me
export SKILLPAYAPIKEY=sk_*
export SKILLPAYSKILLID=77f983da-1eda-4793-b632-f7502d6beb4b
export SKILLPAYPRICEUSDT=0.01

使用支持 --billing-user-id 参数的计费网关命令。
支持的命令：sync、backtest、follow start、autopilot onboard、autopilot start。

通过 CLI 检查计费端点：

bash
duola billing balance --user-id <用户ID> --output json
duola billing charge --user-id <用户ID> --amount 0.01 --output json
duola billing payment-link --user-id <用户ID> --amount 1 --output json

执行工作流

1）验证运行环境和 CLI

运行：

bash
node -v
npm view duola version
duola --version

如果缺少 duola，安装：

bash
npm install -g duola

如果全局安装受限，运行项目本地 CLI：

bash
npm install
npm run build
node dist/index.js --version

2）注册并检查领导者

bash
duola leader add <领导者地址> --name <别名>
duola leader list --output json
duola leader inspect <别名> --output json

使用确定性别名，每个领导者地址保持一个别名。

3）同步和基线回测

bash
duola sync <别名> --limit 500 --output json
duola backtest <别名> --lookback 30d --fixed-usd 25 --output json

如果结果较弱，在实盘模式前进行调整：

• - 提高 --min-liquidity
• 增加 --min-time-to-expiry
• 降低 --fixed-usd

4）运行诊断检查

bash
duola doctor <别名> --output json

在实盘模式前要求通过 API 连接和密钥检查。

5）接入自动交易（推荐实盘路径）

使用标准输入传递私钥，不打印密钥：

bash
printf %s <私钥> | duola autopilot onboard <领导者地址> \\
--name <别名> --private-key-stdin --profile balanced --sync-limit 200

使用明确的确认短语启动：

bash
duola autopilot start <别名> --confirm-live 我理解实盘交易 --detach

6）操作和观察

bash
duola autopilot status <别名> --output json
duola follow logs <别名> --tail 100 --output json
duola autopilot stop <别名> --output json

用于有限周期验证：

bash
duola follow start <别名> --confirm-live 我理解实盘交易 --max-cycles 5 --output json

报告约定

返回简洁的机器可用摘要：

• - leader：别名、地址
• sync：获取/插入/跳过数量
• backtest：胜率、总盈亏、最大回撤、执行信号数
• doctor：失败的检查及修复措施
• autopilot：状态、分离状态、心跳、近期错误

当实盘启动被阻止时，报告确切失败的前置条件及下一条命令。