feat: polish exec cli ergonomics and output

This commit is contained in:
2026-04-15 20:28:24 +08:00
parent f69facde0c
commit e6274d3a00
4 changed files with 207 additions and 65 deletions

View File

@@ -78,6 +78,8 @@ coinhunter --help
coinhunter --version
```
Short aliases are available for the most common commands. The original long-form command names remain supported for backward compatibility.
## Quickstart
Initialize user state:
@@ -90,13 +92,13 @@ Inspect runtime wiring:
```bash
coinhunter paths
coinhunter doctor
coinhunter diag
```
Validate exchange credentials:
```bash
coinhunter check-api
coinhunter api-check
```
Run precheck / gate plumbing:
@@ -105,30 +107,48 @@ Run precheck / gate plumbing:
coinhunter precheck
coinhunter precheck --mark-run-requested "external-gate queued cron run"
coinhunter precheck --ack "analysis finished"
coinhunter gate
```
Inspect balances or execute trading actions:
```bash
coinhunter smart-executor balances
coinhunter smart-executor status
coinhunter smart-executor hold
coinhunter smart-executor buy ENJUSDT 50
coinhunter smart-executor sell-all ENJUSDT
coinhunter exec bal
coinhunter exec overview
coinhunter exec hold
coinhunter exec buy ENJUSDT 50
coinhunter exec flat ENJUSDT
coinhunter exec rotate PEPEUSDT ETHUSDT
```
Preferred `exec` verbs are `bal`, `overview`, `hold`, `buy`, `flat`, and `rotate`.
Legacy forms remain supported for backward compatibility: `balances`, `balance`, `acct`, `status`, `sell-all`, `sell_all`, and `rebalance`.
Generate review data:
```bash
coinhunter review-context 12
coinhunter review-engine 12
coinhunter review 12
coinhunter recap 12
```
Probe external market data:
```bash
coinhunter probe bybit-ticker BTCUSDT
coinhunter probe bybit-klines BTCUSDT 60 20
```
Long-form equivalents still work:
```bash
coinhunter doctor
coinhunter check-api
coinhunter smart-executor bal
coinhunter review-context 12
coinhunter review-engine 12
coinhunter market-probe bybit-ticker BTCUSDT
coinhunter market-probe bybit-klines BTCUSDT 60 20
coinhunter external-gate
coinhunter rotate-external-gate-log
```
## Runtime model
@@ -159,34 +179,37 @@ Credential loading:
### Diagnostics
```bash
coinhunter doctor
coinhunter diag
coinhunter paths
coinhunter check-api
coinhunter api-check
```
### Trading and execution
```bash
coinhunter smart-executor balances
coinhunter smart-executor status
coinhunter smart-executor hold
coinhunter smart-executor rebalance FROMUSDT TOUSDT
coinhunter exec bal
coinhunter exec overview
coinhunter exec hold
coinhunter exec buy ENJUSDT 50
coinhunter exec flat ENJUSDT
coinhunter exec rotate FROMUSDT TOUSDT
```
### Precheck and orchestration
```bash
coinhunter precheck
coinhunter external-gate
coinhunter rotate-external-gate-log
coinhunter gate
coinhunter rotate-gate-log
coinhunter rotate-log
```
### Review and market research
```bash
coinhunter review-context 12
coinhunter review-engine 12
coinhunter market-probe bybit-ticker BTCUSDT
coinhunter review 12
coinhunter recap 12
coinhunter probe bybit-ticker BTCUSDT
```
## Development notes