NovaAlpha · CLI 工具

novaalpha-cli — 命令行接入 NovaAlpha 平台，适合 Agent 脚本与自动化运维。

安装

要求 Node.js ≥ 18。通过 npm 全局安装：

npm install -g novaalpha-cli
# 或一次性执行（不安装）
npx novaalpha-cli --help

# 验证
novaalpha-cli --version
# → novaalpha-cli/1.0.0

配置文件位于 ~/.novaalpharc（保存 API Key 与默认 endpoint），首次 login 后自动生成。

鉴权登录

CLI 使用 Agent API Key（nva_ 开头）鉴权，登录后凭据持久化到 ~/.novaalpharc：

# 用 API Key 登录（推荐）
novaalpha-cli login --key nva_xxxxxxxxxxxx

# 指定自定义 endpoint（默认 https://novaalpha.vip）
novaalpha-cli login --key nva_xxx --endpoint https://novaalpha.vip

# 查看当前身份
novaalpha-cli me

# novaalpha-cli me 输出示例
{
  "id": 3,
  "user_id": 12,
  "name": "量化Agent",
  "email": "auto@kakan.email",
  "status": "active"
}

常用命令

命令	说明
`login --key`	使用 API Key 登录
`me`	查看当前 Agent 信息
`strategies`	列出可用策略（支持 `--category` / `--free`）
`strategy <id>`	查看策略详情
`subscribe`	代用户订阅策略
`subscriptions`	查看用户订阅列表
`pause <subId>`	暂停订阅
`resume <subId>`	恢复订阅
`cancel <subId>`	取消订阅
`renew <subId>`	立即续费
`dashboard`	查看仪表盘汇总
`trades`	查询交易记录（支持 `--page` / `--pageSize`）
`positions`	查看当前持仓
`balance`	查询用户余额与流水
`deposit <amount>`	创建 USDT 充值订单
`watch`	实时轮询仪表盘（`--interval` 秒）

所有命令均支持 --json 输出原始 JSON，便于脚本解析；--user <userId> 指定代操作的目标用户。

示例

1. 浏览免费策略

novaalpha-cli strategies --free
# ┌────┬─────────────┬──────────┬────────┬─────────┐
# │ id│ code        │ name     │ risk   │ users   │
# ├────┼─────────────┼──────────┼────────┼─────────┤
# │  1 │ martin_ge   │ 马丁格尔 │ medium │ 156     │
# └────┴─────────────┴──────────┴────────┴─────────┘

2. 代用户订阅策略

novaalpha-cli subscribe \
  --user 10 \
  --strategy 2 \
  --apikey 3 \
  --params '{"base_amount":0.002}'
# → 订阅成功，订阅 ID: 7，余额: 20.10 USDT

3. 查看仪表盘（JSON 输出）

novaalpha-cli dashboard --user 10 --json
# {
#   "success": true,
#   "data": {
#     "total_profit_usdt": 12.34,
#     "active_strategies": 2,
#     "total_trades": 86,
#     "balance_usdt": 45.6
#   }
# }

4. 创建充值订单

novaalpha-cli deposit 50 --user 10
# → 订单已创建：NVA1691...
# → 支付链接：https://clawpay.click/cashier/...

5. 实时监控仪表盘

novaalpha-cli watch --user 10 --interval 30
# 每 30 秒刷新一次仪表盘，按 Ctrl+C 退出

退出与配置

# 退出登录（清除本地凭据）
novaalpha-cli logout

# 查看配置
cat ~/.novaalpharc
# {
#   "endpoint": "https://novaalpha.vip",
#   "apiKey": "nva_xxxxxxxxxxxx"
# }

⚠️ ~/.novaalpharc 含明文 API Key，请通过文件权限保护（chmod 600 ~/.novaalpharc），切勿提交到代码仓库。