CRITICAL — Before starting, you MUST first use the Read tool to read ../ziniao-shared/SKILL.md
Manage the proxy devices (IPs) used by the ZiNiao browser. Shortcut commands already cover the 9 commonly used APIs; use the general api commands for price queries and historical binding records.
Proxy Type Mapping
| CLI Value | API Value | Description |
|---|---|---|
| http | 0 | HTTP proxy |
| https | 1 | HTTPS proxy |
| socks5 | 2 | SOCKS5 proxy |
| ssh | 3 | SSH tunnel |
| ssl | 4 | SSL proxy |
Shortcuts — Queries and Own Devices
| Command | Description | Detailed Documentation |
|---|---|---|
device list |
Query device list | references/ziniao-device-list.md |
device add-custom |
Add own device | references/ziniao-device-add-custom.md |
device update-custom |
Modify own device | Partial update:--id xxx --addr "1.2.3.4" |
ziniao-cli device list --format table
ziniao-cli device list --page-all
ziniao-cli device add-custom --name "我的代理" --proxy-type socks5 \
--addr "1.2.3.4" --port 1080 --proxy-user admin --proxy-pass secret
ziniao-cli device update-custom --id 123 --addr "5.6.7.8"
Underlying APIs: device list /superbrowser/rest/v1/erp/ip/page; add own device /superbrowser/rest/v1/erp/ip/self/add/new; modify own device /superbrowser/rest/v1/erp/ip/self/edit/new。
Shortcuts — Binding Management
| Command | Description |
|---|---|
device bind --id --store-id |
Bind a device to a store (--store-id supports batch) |
device unbind --store-id |
Unbind devices by store ID (--store-id supports batch) |
# 将设备 10 绑定到三个店铺
ziniao-cli device bind --id 10 --store-id "101,102,103"
# 批量解绑
ziniao-cli device unbind --store-id "101,102,103"
⚠ Batch unbinding is executed one by one; partial failures do not affect already successful items and will not be rolled back.
Underlying APIs: bind /superbrowser/rest/v1/erp/ip/bind; unbind /superbrowser/rest/v1/erp/ip/unbind。
Shortcuts — Fee-related (involves real charges)
⚠
purchaseandrenewarehigh-risk-write, confirmation will be required before execution or--yes。
| Command | Description |
|---|---|
device plan-list |
Query the list of purchasable plans (check here first) |
device purchase --plan-id --period-id --count |
Purchase a plan (involves fees, irrevocable) |
device renew --id --period-id |
Renew device (--id supports batch, involves fees) |
device auto-renew --id --enable |
Batch enable/disable auto-renewal |
# 先查套餐，再购买
ziniao-cli device plan-list --format table
ziniao-cli device purchase --plan-id "plan_xxx" --period-id 1 --count 3
# 续费单台
ziniao-cli device renew --id 10 --period-id 1
# 批量开启自动续费
ziniao-cli device auto-renew --id "10,11,12" --enable true
# 关闭自动续费（bool 类型必须用等号连接）
ziniao-cli device auto-renew --id "10,11,12" --enable=false
# 关闭自动续费
ziniao-cli device auto-renew --id 10 --enable=false
Underlying APIs: plans /superbrowser/rest/v1/erp/package/new; purchase /superbrowser/rest/v1/erp/purchase; renewal /superbrowser/rest/v1/erp/renew; auto-renewal /superbrowser/rest/v1/erp/ip/renewal。
General api coverage
# 查询已购设备价格
ziniao-cli api /superbrowser/rest/v1/erp/proxy/purchased_package_info --data '{"proxyId":"123"}'
# 查询设备历史绑定记录
ziniao-cli api /superbrowser/rest/v1/erp/ip/historybind --data '{"proxyId":"123"}'