SuperAPI AI 工具集

ziniao-device

部署与运维

查看项目

更新于 10-16 09:45

技能介绍

用途:管理紫鸟浏览器使用的代理设备(IP)。开始前须先用 Read 工具读取 ../ziniao-shared/SKILL.md。常用 9 个接口已有快捷命令覆盖;价格查询与历史绑定记录使用通用 api 命令。

代理类型映射:CLI 值 http/https/socks5/ssh/ssl 对应 API 值 0/1/2/3/4。

查询与自有设备:device list 查询设备列表(ziniao-cli device list --format table、--page-all);device add-custom 添加自有设备,如 ziniao-cli device add-custom --name "我的代理" --proxy-type socks5 --addr "1.2.3.4" --port 1080 --proxy-user admin --proxy-pass secret;device update-custom 支持部分更新,如 ziniao-cli device update-custom --id 123 --addr "5.6.7.8"。

绑定管理:device bind --id --store-id 将设备绑定到店铺,--store-id 支持批量;device unbind --store-id 按店铺 ID 解绑并支持批量。批量解绑为逐个执行,部分失败不影响已成功项,也不会回滚。

费用相关(涉及真实扣费):purchase 与 renew 为 high-risk-write,执行前需确认或传 --yes。device plan-list 查询可购买套餐(先看这里);device purchase --plan-id --period-id --count 购买套餐,涉及费用且不可撤销;device renew --id --period-id 续费,--id 支持批量;device auto-renew --id --enable 批量开启/关闭自动续费,bool 类型须用等号连接,如 --enable=true 或 --enable=false。

通用 api 覆盖: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"}' 查询历史绑定记录。对应底层接口包括设备列表 /superbrowser/rest/v1/erp/ip/page、添加 /superbrowser/rest/v1/erp/ip/self/add/new、修改 /superbrowser/rest/v1/erp/ip/self/edit/new、绑定 /superbrowser/rest/v1/erp/ip/bind、解绑 /superbrowser/rest/v1/erp/ip/unbind、套餐 /superbrowser/rest/v1/erp/package/new、购买 /superbrowser/rest/v1/erp/purchase、续费 /superbrowser/rest/v1/erp/renew、自动续费 /superbrowser/rest/v1/erp/ip/renewal。

适用场景:需查看代理设备列表、添加或修改自有代理、将设备绑定到店铺、管理设备费用及自动续费时。限制:购买与续费涉及真实扣费且不可撤销;批量解绑无回滚;须先读取共享文档。