mirror of
https://github.com/Wei-Shaw/sub2api.git
synced 2026-10-14 12:02:27 +08:00
docs: update Sub2API admin skill
This commit is contained in:
twodogegg
@@ -11,8 +11,10 @@ export SUB2API_ADMIN_API_KEY='<admin api key>'
|
||||
|
||||
## CLI
|
||||
|
||||
以下命令都假设当前目录是这个 skill 目录。
|
||||
|
||||
```bash
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js <command>
|
||||
node scripts/sub2api-admin.js <command>
|
||||
```
|
||||
|
||||
## Accounts
|
||||
@@ -20,41 +22,41 @@ node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js <command>
|
||||
### 只读
|
||||
|
||||
```bash
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts list --page-size 20
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts list --search outlook --platform openai --type oauth --status active
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts get 40
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts usage 40
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts stats 40 --days 30
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts today-stats 40
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts batch-today-stats --ids 40,39
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts models 40
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts temp-unschedulable 40
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts antigravity-default-model-mapping
|
||||
node scripts/sub2api-admin.js accounts list --page-size 20
|
||||
node scripts/sub2api-admin.js accounts list --search outlook --platform openai --type oauth --status active
|
||||
node scripts/sub2api-admin.js accounts get 40
|
||||
node scripts/sub2api-admin.js accounts usage 40
|
||||
node scripts/sub2api-admin.js accounts stats 40 --days 30
|
||||
node scripts/sub2api-admin.js accounts today-stats 40
|
||||
node scripts/sub2api-admin.js accounts batch-today-stats --ids 40,39
|
||||
node scripts/sub2api-admin.js accounts models 40
|
||||
node scripts/sub2api-admin.js accounts temp-unschedulable 40
|
||||
node scripts/sub2api-admin.js accounts antigravity-default-model-mapping
|
||||
```
|
||||
|
||||
`accounts export` 会包含账号凭据和 token，建议写入文件，不要直接刷屏：
|
||||
|
||||
```bash
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts export --ids 40,39 --file accounts-export.json
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts export --platform openai --type oauth --include-proxies false --file accounts-export.json
|
||||
node scripts/sub2api-admin.js accounts export --ids 40,39 --file accounts-export.json
|
||||
node scripts/sub2api-admin.js accounts export --platform openai --type oauth --include-proxies false --file accounts-export.json
|
||||
```
|
||||
|
||||
### 单账号写入
|
||||
|
||||
```bash
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts create --file account.json
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts update 40 --json '{"concurrency":20}'
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts set-status 40 active
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts set-schedulable 40 true
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts clear-error 40
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts clear-rate-limit 40
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts recover-state 40
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts reset-quota 40
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts refresh 40
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts test 40
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts sync-models 40
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts apply-oauth 40 --file credentials.json
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts reset-temp-unschedulable 40
|
||||
node scripts/sub2api-admin.js accounts create --file account.json
|
||||
node scripts/sub2api-admin.js accounts update 40 --json '{"concurrency":20}'
|
||||
node scripts/sub2api-admin.js accounts set-status 40 active
|
||||
node scripts/sub2api-admin.js accounts set-schedulable 40 true
|
||||
node scripts/sub2api-admin.js accounts clear-error 40
|
||||
node scripts/sub2api-admin.js accounts clear-rate-limit 40
|
||||
node scripts/sub2api-admin.js accounts recover-state 40
|
||||
node scripts/sub2api-admin.js accounts reset-quota 40
|
||||
node scripts/sub2api-admin.js accounts refresh 40
|
||||
node scripts/sub2api-admin.js accounts test 40
|
||||
node scripts/sub2api-admin.js accounts sync-models 40
|
||||
node scripts/sub2api-admin.js accounts apply-oauth 40 --file credentials.json
|
||||
node scripts/sub2api-admin.js accounts reset-temp-unschedulable 40
|
||||
```
|
||||
|
||||
### 删除与清理
|
||||
@@ -62,18 +64,18 @@ node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts reset-temp-
|
||||
删除前先列出目标账号名和 ID。
|
||||
|
||||
```bash
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts delete 25
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts keep-only --name 'target@example.com'
|
||||
node scripts/sub2api-admin.js accounts delete 25
|
||||
node scripts/sub2api-admin.js accounts keep-only --name 'target@example.com'
|
||||
```
|
||||
|
||||
### 批量写入
|
||||
|
||||
```bash
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts batch-create --file accounts.json
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts batch-update-credentials --file payload.json
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts bulk-update --ids 40,39 --json '{"concurrency":10,"priority":2}'
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts batch-refresh --ids 40,39
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts batch-clear-error --ids 40,39
|
||||
node scripts/sub2api-admin.js accounts batch-create --file accounts.json
|
||||
node scripts/sub2api-admin.js accounts batch-update-credentials --file payload.json
|
||||
node scripts/sub2api-admin.js accounts bulk-update --ids 40,39 --json '{"concurrency":10,"priority":2}'
|
||||
node scripts/sub2api-admin.js accounts batch-refresh --ids 40,39
|
||||
node scripts/sub2api-admin.js accounts batch-clear-error --ids 40,39
|
||||
```
|
||||
|
||||
`bulk-update` 可覆盖页面“批量更新”的字段，payload 由后台表单字段决定，例如 `base_url`、`model_mapping`、`group_ids`、`proxy_id`、`concurrency`、`priority`、`rate_multiplier`、`status`、`compact_mode` 等。更新前先用 `accounts get <id>` 确认字段名。
|
||||
@@ -83,21 +85,21 @@ node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts batch-clear
|
||||
通用后台导入：
|
||||
|
||||
```bash
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts import-data --file accounts-export.json
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts import-codex-session --file payload.json
|
||||
node scripts/sub2api-admin.js accounts import-data --file accounts-export.json
|
||||
node scripts/sub2api-admin.js accounts import-codex-session --file payload.json
|
||||
```
|
||||
|
||||
CRS 同步：
|
||||
|
||||
```bash
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts crs-preview --file payload.json
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts crs-sync --file payload.json
|
||||
node scripts/sub2api-admin.js accounts crs-preview --file payload.json
|
||||
node scripts/sub2api-admin.js accounts crs-sync --file payload.json
|
||||
```
|
||||
|
||||
旧版 JSON 导入仍可用，会把模板账号的配置复制给导入账号：
|
||||
|
||||
```bash
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts import-json \
|
||||
node scripts/sub2api-admin.js accounts import-json \
|
||||
--file /path/accounts.json \
|
||||
--template-name 'template@example.com' \
|
||||
--dry-run
|
||||
@@ -113,8 +115,59 @@ node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js accounts import-json
|
||||
## Groups And Proxies
|
||||
|
||||
```bash
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js groups all
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js proxies all
|
||||
node scripts/sub2api-admin.js groups all
|
||||
node scripts/sub2api-admin.js proxies all
|
||||
```
|
||||
|
||||
## Redeem Codes
|
||||
|
||||
兑换码类型包括 `balance`、`concurrency`、`subscription`、`invitation`。状态常用 `unused`、`used`、`expired`。
|
||||
|
||||
### 只读
|
||||
|
||||
```bash
|
||||
node scripts/sub2api-admin.js redeem-codes list --page-size 20
|
||||
node scripts/sub2api-admin.js redeem-codes list --type balance --status unused --search user@example.com
|
||||
node scripts/sub2api-admin.js redeem-codes get 123
|
||||
node scripts/sub2api-admin.js redeem-codes stats
|
||||
node scripts/sub2api-admin.js redeem-codes export --file redeem-codes.csv
|
||||
```
|
||||
|
||||
### 生成兑换码
|
||||
|
||||
```bash
|
||||
node scripts/sub2api-admin.js redeem-codes generate \
|
||||
--json '{"count":1,"type":"balance","value":10}' \
|
||||
--idempotency-key "redeem-generate-$(date +%s)"
|
||||
```
|
||||
|
||||
订阅兑换码需要 `group_id` 和非零 `validity_days`：
|
||||
|
||||
```bash
|
||||
node scripts/sub2api-admin.js redeem-codes generate \
|
||||
--json '{"count":1,"type":"subscription","value":0,"group_id":2,"validity_days":30}' \
|
||||
--idempotency-key "redeem-subscription-$(date +%s)"
|
||||
```
|
||||
|
||||
### 创建并兑换
|
||||
|
||||
用于支付回调或人工充值，一步完成创建兑换码并兑换到用户。生产流程必须传稳定的 `--idempotency-key`。
|
||||
|
||||
```bash
|
||||
node scripts/sub2api-admin.js redeem-codes create-and-redeem \
|
||||
--json '{"code":"order_123","type":"balance","value":10,"user_id":123,"notes":"manual recharge"}' \
|
||||
--idempotency-key order-123
|
||||
```
|
||||
|
||||
### 修改与清理
|
||||
|
||||
写入前先 `list` 或 `get` 核对目标 ID。
|
||||
|
||||
```bash
|
||||
node scripts/sub2api-admin.js redeem-codes batch-update --ids 123,124 --json '{"notes":"campaign A"}'
|
||||
node scripts/sub2api-admin.js redeem-codes expire 123
|
||||
node scripts/sub2api-admin.js redeem-codes delete 123
|
||||
node scripts/sub2api-admin.js redeem-codes batch-delete --ids 123,124
|
||||
```
|
||||
|
||||
## Error Rules And TLS Profiles
|
||||
@@ -122,18 +175,18 @@ node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js proxies all
|
||||
对应账号页顶部“错误透传规则”和“TLS 指纹模板”。
|
||||
|
||||
```bash
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js error-rules list
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js error-rules get 1
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js error-rules create --file rule.json
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js error-rules update 1 --json '{"enabled":true}'
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js error-rules toggle 1 false
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js error-rules delete 1
|
||||
node scripts/sub2api-admin.js error-rules list
|
||||
node scripts/sub2api-admin.js error-rules get 1
|
||||
node scripts/sub2api-admin.js error-rules create --file rule.json
|
||||
node scripts/sub2api-admin.js error-rules update 1 --json '{"enabled":true}'
|
||||
node scripts/sub2api-admin.js error-rules toggle 1 false
|
||||
node scripts/sub2api-admin.js error-rules delete 1
|
||||
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js tls-profiles list
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js tls-profiles get 1
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js tls-profiles create --file profile.json
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js tls-profiles update 1 --file profile.json
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js tls-profiles delete 1
|
||||
node scripts/sub2api-admin.js tls-profiles list
|
||||
node scripts/sub2api-admin.js tls-profiles get 1
|
||||
node scripts/sub2api-admin.js tls-profiles create --file profile.json
|
||||
node scripts/sub2api-admin.js tls-profiles update 1 --file profile.json
|
||||
node scripts/sub2api-admin.js tls-profiles delete 1
|
||||
```
|
||||
|
||||
## Raw Admin API
|
||||
@@ -141,8 +194,8 @@ node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js tls-profiles delete
|
||||
未封装或新版本后台接口可用 `api` 直通。路径可写 `/admin/...` 或 `/api/v1/admin/...`。
|
||||
|
||||
```bash
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js api GET /admin/groups/all
|
||||
node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js api POST /admin/accounts/bulk-update \
|
||||
node scripts/sub2api-admin.js api GET /admin/groups/all
|
||||
node scripts/sub2api-admin.js api POST /admin/accounts/bulk-update \
|
||||
--json '{"account_ids":[40],"concurrency":10}'
|
||||
```
|
||||
|
||||
@@ -183,6 +236,16 @@ node ~/.codex/skills/sub2api-admin/scripts/sub2api-admin.js api POST /admin/acco
|
||||
- `GET /api/v1/admin/accounts/antigravity/default-model-mapping`
|
||||
- `GET /api/v1/admin/groups/all`
|
||||
- `GET /api/v1/admin/proxies/all`
|
||||
- `GET /api/v1/admin/redeem-codes`
|
||||
- `GET /api/v1/admin/redeem-codes/export`
|
||||
- `GET /api/v1/admin/redeem-codes/stats`
|
||||
- `GET /api/v1/admin/redeem-codes/:id`
|
||||
- `POST /api/v1/admin/redeem-codes/generate`
|
||||
- `POST /api/v1/admin/redeem-codes/create-and-redeem`
|
||||
- `POST /api/v1/admin/redeem-codes/batch-update`
|
||||
- `POST /api/v1/admin/redeem-codes/batch-delete`
|
||||
- `POST /api/v1/admin/redeem-codes/:id/expire`
|
||||
- `DELETE /api/v1/admin/redeem-codes/:id`
|
||||
- `GET /api/v1/admin/error-passthrough-rules`
|
||||
- `GET /api/v1/admin/error-passthrough-rules/:id`
|
||||
- `POST /api/v1/admin/error-passthrough-rules`
|
||||
|
||||
Reference in New Issue
Block a user