设备管理

ziniao-device

紫鸟设备管理：代理设备（IP）的查询、添加、修改、绑定/解绑、购买续费和自动续费。当用户需要查看代理设备列表、添加/修改自有代理、绑定设备到店铺或管理设备费用时使用。

ziniao-open/skills·4.9Kinstalls6stars

SKILL.md

Full skill instructions

设备管理

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../ziniao-shared/SKILL.md

管理紫鸟浏览器使用的代理设备（IP）。常用 9 个接口已有快捷命令覆盖；价格查询、历史绑定记录使用通用 api 命令。

代理类型映射

CLI 值	API 值	说明
http	0	HTTP 代理
https	1	HTTPS 代理
socks5	2	SOCKS5 代理
ssh	3	SSH 隧道
ssl	4	SSL 代理

Shortcuts — 查询与自有设备

命令	说明	详细文档
`device list`	查询设备列表	`references/ziniao-device-list.md`
`device add-custom`	添加自有设备	`references/ziniao-device-add-custom.md`
`device update-custom`	修改自有设备	部分更新：`--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"

底层接口：设备列表 /superbrowser/rest/v1/erp/ip/page；添加自有设备 /superbrowser/rest/v1/erp/ip/self/add/new；修改自有设备 /superbrowser/rest/v1/erp/ip/self/edit/new。

Shortcuts — 绑定管理

命令	说明
`device bind --id --store-id`	将设备绑定到店铺（`--store-id` 支持批量）
`device unbind --store-id`	按店铺 ID 解绑设备（`--store-id` 支持批量）

# 将设备 10 绑定到三个店铺
ziniao-cli device bind --id 10 --store-id "101,102,103"

# 批量解绑
ziniao-cli device unbind --store-id "101,102,103"

⚠ 批量解绑为逐个执行，部分失败不影响已成功项，也不会回滚。

底层接口：绑定 /superbrowser/rest/v1/erp/ip/bind；解绑 /superbrowser/rest/v1/erp/ip/unbind。

Shortcuts — 费用相关（涉及真实扣费）

⚠ 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`	批量开启/关闭自动续费

# 先查套餐，再购买
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

底层接口：套餐 /superbrowser/rest/v1/erp/package/new；购买 /superbrowser/rest/v1/erp/purchase；续费 /superbrowser/rest/v1/erp/renew；自动续费 /superbrowser/rest/v1/erp/ip/renewal。

通用 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"}'

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/ziniao-open/skills --skill ziniao-device

View on GitHub

ziniao-device

ziniao-page
紫鸟页面操作（ZClaw 本地浏览器 Bridge）：导航、点击、输入、截图、执行 JS、提取数据等浏览器自动化操作。当用户需要在紫鸟浏览器中操作页面元素、截图或执行自动化脚本时使用。
5.3K installs
ziniao-shared
紫鸟 CLI 共享基础：应用配置初始化、统一 apiKey 认证、错误处理、输出格式、安全规则。当用户需要第一次配置(`ziniao-cli config init`)、遇到认证/权限问题、或首次使用 ziniao-cli 时触发。
5.3K installs
ziniao-store
紫鸟店铺管理（ZClaw 本地浏览器 Bridge）：列出、打开、关闭紫鸟浏览器中的店铺。当用户需要查看店铺列表、打开/关闭店铺浏览器窗口时使用。
5.3K installs
ziniao-staff
紫鸟员工管理：员工的查询、创建、修改、启用/禁用/删除和调岗。当用户需要查询员工信息、创建新员工、修改员工信息、启用/禁用/删除员工或调整员工部门时使用。
5K installs