API 探索

前置条件： 先阅读
../ziniao-shared/SKILL.md
。

当用户的需求无法被现有快捷命令覆盖时，使用本技能查找对应的 API 路径并通过

ziniao-cli api

裸调。

探索流程

Step 1: 确认现有命令不足

bash

ziniao-cli department --help
ziniao-cli staff --help
ziniao-cli account --help
ziniao-cli device --help
ziniao-cli role --help

如果已有对应快捷命令，直接使用。

Step 2: 从路径清单定位 API

禁止猜测 API 路径，必须从以下清单中查找。

部门（5 个）✅ 全部已有快捷命令

操作	路径	快捷命令
列表	`/superbrowser/rest/v1/erp/department/list`	`department list`
新增	`/superbrowser/rest/v1/erp/department/add`	`department create`
修改	`/superbrowser/rest/v1/erp/department/update`	`department update`
删除	`/superbrowser/rest/v1/erp/department/delete`	`department delete`
排序	`/superbrowser/rest/v1/erp/department/order`	`department reorder`

员工（5 个）✅ 全部已有快捷命令

操作	路径	快捷命令
列表	`/superbrowser/rest/v1/erp/staff/list`	`staff list`
新增	`/superbrowser/rest/v2/erp/staff/add`	`staff create`
修改	`/superbrowser/rest/v2/erp/staff/modify`	`staff update`
状态	`/superbrowser/rest/v1/erp/staff/status`	`staff enable/disable/remove`
调岗	`/superbrowser/rest/v1/erp/staff/department`	`staff transfer`

账号（23 个）— 仍有 4 个需用

api

分类	路径前缀	快捷命令
CRUD	`/superbrowser/rest/v1/erp/store/list\|create\|update/base\|delete`	`account list/create/update/delete`
缓存	`/superbrowser/rest/v1/erp/store/deletecookie`	`api`
授权	`/superbrowser/rest/v1/erp/store/auth/add\|delete\|clean` 、 `/superbrowser/rest/v1/erp/user/stores` 、 `/superbrowser/rest/v1/erp/store/user/list`	`account auth-*`
授权查询	`/superbrowser/rest/v1/erp/store/auth/query`	`api`
用户账号	`/superbrowser/rest/v1/erp/store/list/by/user`	`api`
附加信息	`/superbrowser/rest/v1/erp/store/addtion`	`api`
标签	`/superbrowser/rest/v1/erp/tag/list` 、 `/superbrowser/rest/v1/store-tag/add\|delete\|rename\|bind\|unbind\|replace\|clear\|remove\|list`	`account tag-*`

设备（11 个）— 仍有 2 个需用

api

分类	路径前缀	快捷命令
查询	`/superbrowser/rest/v1/erp/ip/page` 、 `/superbrowser/rest/v1/erp/proxy/purchased_package_info` 、 `/superbrowser/rest/v1/erp/ip/historybind`	`device list` （price/history 用 `api` ）
套餐	`/superbrowser/rest/v1/erp/package/new`	`device plan-list`
购买	`/superbrowser/rest/v1/erp/purchase\|renew`	`device purchase/renew`
自有	`/superbrowser/rest/v1/erp/ip/self/add/new\|edit/new`	`device add-custom/update-custom`
绑定	`/superbrowser/rest/v1/erp/ip/bind\|unbind\|renewal`	`device bind/unbind/auto-renew`

角色（7 个）✅ 全部已有快捷命令

操作	路径	快捷命令
列表	`/superbrowser/rest/v1/erp/per/role/list`	`role list`
详情	`/superbrowser/rest/v1/erp/per/role/detail`	`role detail`
新增	`/superbrowser/rest/v1/erp/per/role/add`	`role create`
修改	`/superbrowser/rest/v1/erp/per/role/edit`	`role update`
分配	`/superbrowser/rest/v1/erp/staff/change/role`	`role assign`
用户角色	`/superbrowser/rest/v1/erp/staff/role/list`	`role staff-roles`
权限列表	`/superbrowser/rest/v1/erp/per/permission/list`	`role permissions`

访问策略（22 个）— 全部需用

api

分类	路径
规则	`/superbrowser/rest/v1/erp/security/access_rule/list`
规则	`/superbrowser/rest/v1/erp/security/access_rule/detail`
规则	`/superbrowser/rest/v1/erp/security/access_rule/add`
规则	`/superbrowser/rest/v1/erp/security/access_rule/edit`
规则	`/superbrowser/rest/v1/erp/security/access_rule/delete`
规则	`/superbrowser/rest/v1/erp/security/access_rule/active`
规则成员	`/superbrowser/rest/v1/erp/security/access_rule/change_user`
规则账号	`/superbrowser/rest/v1/erp/security/access_rule/change_account`
规则账号	`/superbrowser/rest/v1/erp/security/access_rule/account/bindable_list`
网页	`/superbrowser/rest/v1/erp/security/access_rule_url/list`
网页	`/superbrowser/rest/v1/erp/security/access_rule_url/detail`
网页	`/superbrowser/rest/v1/erp/security/access_rule_url/add`
网页	`/superbrowser/rest/v1/erp/security/access_rule_url/edit`
网页	`/superbrowser/rest/v1/erp/security/access_rule_url/delete`
网页	`/superbrowser/rest/v1/erp/security/access_rule_url/change_group`
网页分组	`/superbrowser/rest/v1/erp/security/access_rule_url_group/list`
网页分组	`/superbrowser/rest/v1/erp/security/access_rule_url_group/add`
网页分组	`/superbrowser/rest/v1/erp/security/access_rule_url_group/edit`
网页分组	`/superbrowser/rest/v1/erp/security/access_rule_url_group/delete`
账号策略	`/superbrowser/rest/v1/erp/security/access_rule/list/one_account`
账号策略	`/superbrowser/rest/v1/erp/security/access_rule/account_ref/add_to_account`
账号策略	`/superbrowser/rest/v1/erp/security/access_rule/account_ref/remove_from_account`

Step 3: 使用 dry-run 探索

bash

# 先预览请求
ziniao-cli api /superbrowser/rest/v1/erp/per/role/list --dry-run

# 确认后执行
ziniao-cli api /superbrowser/rest/v1/erp/per/role/list

安全规则

禁止猜测 API 路径或参数，必须从清单中查找
写入/删除类操作前确认用户意图
建议先用
```
--dry-run
```
预览

参考

ziniao-shared — 认证和全局参数
ziniao-account — 账号/授权/标签快捷命令
ziniao-device — 设备管理快捷命令
ziniao-role — 角色管理快捷命令
ziniao-skill-maker — 如需将常用 API 固化为新 Skill

ziniao-openapi-explorer

NPX Install

Tags

SKILL.md Content

API 探索

探索流程

Step 1: 确认现有命令不足

Step 2: 从路径清单定位 API

部门（5 个）✅ 全部已有快捷命令

员工（5 个）✅ 全部已有快捷命令

账号（23 个）— 仍有 4 个需用
`api`

设备（11 个）— 仍有 2 个需用
`api`

角色（7 个）✅ 全部已有快捷命令

访问策略（22 个）— 全部需用
`api`

Step 3: 使用 dry-run 探索

安全规则

参考