CRITICAL — Before starting, MUST first use the Read tool to read ../ziniao-shared/SKILL.md
CRITICAL — Before executing Shortcuts, be sure to first read the corresponding references/ documentation.
Ziniao's "account" refers to a browser store account (store), not an employee user. This module covers a total of 22 APIs, all of which already have shortcut commands.
Note the distinction:
accountcommands pass throughserver-side API to manage store accounts (create, delete, authorize, tag). If you need to control the local browser window (open/close/navigate/screenshot), please usestore+pagecommands (via the local ZClaw Bridge).
Choosing how to get the store list:
- Member accounts do not have server-side
account listpermission, and should usestore list(local ZClaw Bridge) to get the store list.- If the Boss account's purpose is to open the store browser, it should also preferentially use
store listto get locally available stores, rather thanaccount list。account listSuitable for scenarios that require managing store metadata (tags, authorization, batch operations).- Member type can be determined via the
ziniao-cli config showfield in theisBossresult.
Shortcuts — Account CRUD
| Command | Description | Detailed documentation |
|---|---|---|
account list |
Query account list | references/ziniao-account-list.md |
account create |
Create account | references/ziniao-account-create.md |
account update |
Edit basic account information | Send only modified fields:--id xxx --name "新名" |
account delete |
Delete account (high risk) | --id xxx, comma-separated for batch, requires --yes |
# 查询
ziniao-cli account list --name "某店" --format table
ziniao-cli account list --page-all
# 创建
ziniao-cli account create --name "我的店铺" --site-id 1 --remark "测试"
# 修改
ziniao-cli account update --id 123 --name "新名称" --site-id 1
# 删除(批量)
ziniao-cli account delete --id "101,102,103" --yes
Shortcuts — Authorization management
| Command | Description |
|---|---|
account auth-add |
Authorize employee access to store (--store-id and --staff-id both support comma-separated batch) |
account auth-remove |
Revoke employee access permission (--store-id and --staff-id both support comma-separated batch) |
account auth-clean |
Clear all employee authorizations for a store (high risk) |
account auth-list |
Query the list of stores authorized for an employee |
account auth-users |
Query the list of employees authorized for a store |
# 批量授权(把 3 个店铺同时授权给 3 个员工)
ziniao-cli account auth-add --store-id "111,222,333" --staff-id "201,202,203"
# 撤销单人
ziniao-cli account auth-remove --store-id 111 --staff-id 201
# 查看某员工被授权的所有店铺
ziniao-cli account auth-list --user-id 201 --page-all --format table
# 清空授权(高风险)
ziniao-cli account auth-clean --store-id 111 --yes
Shortcuts — Tag management
| Command | Description |
|---|---|
account tag-list |
Query all tags under the enterprise |
account tag-of-store --store-id |
Query the list of tags bound to a store |
account tag-create --name |
Create tag |
account tag-rename --id --name |
Rename tag |
account tag-delete --id |
Delete tag (high risk) |
account tag-bind --tag-id --store-id |
Bind tag to store (--store-id supports batch) |
account tag-unbind --tag-id --store-id |
Unbind (--store-id supports batch) |
account tag-replace --store-id --tag-ids |
Fully replace the store's tag set |
account tag-clear --store-id |
Clear all tags for a store (high risk) |
account tag-remove --tag-id --store-id |
Remove this tag from the specified store (high risk,--store-id supports batch) |
Underlying APIs and request body fields must be sent strictly according to the API documentation; do not send undocumented alias fields.
| Command | API | Request body fields (excluding common companyId) |
|---|---|---|
account tag-list |
/superbrowser/rest/v1/erp/tag/list |
None |
account tag-of-store --store-id |
/superbrowser/rest/v1/store-tag/list |
storeId, optional withSystem |
account tag-create --name |
/superbrowser/rest/v1/store-tag/add |
tagName |
account tag-rename --id --name |
/superbrowser/rest/v1/store-tag/rename |
tid, name |
account tag-delete --id |
/superbrowser/rest/v1/store-tag/delete |
tagIds |
account tag-bind --tag-id --store-id |
/superbrowser/rest/v1/store-tag/bind |
tagIds, storeIds |
account tag-unbind --tag-id --store-id |
/superbrowser/rest/v1/store-tag/unbind |
tagIds, storeIds |
account tag-replace --store-id --tag-ids |
/superbrowser/rest/v1/store-tag/replace |
tagIds, storeIds |
account tag-clear --store-id |
/superbrowser/rest/v1/store-tag/clear |
storeIds |
account tag-remove --tag-id --store-id |
/superbrowser/rest/v1/store-tag/remove |
tagIds, storeIds |
# 查看所有标签
ziniao-cli account tag-list --format table
# 查看某店铺已有标签
ziniao-cli account tag-of-store --store-id 101
# 创建标签后批量绑定到多个店铺
ziniao-cli account tag-create --name "重点店铺"
ziniao-cli account tag-bind --tag-id 99 --store-id "101,102,103"
# 全量替换(将店铺 101 的标签换成 99 和 100)
ziniao-cli account tag-replace --store-id 101 --tag-ids "99,100"
# 从多个店铺移除某个标签
ziniao-cli account tag-remove --tag-id 99 --store-id "101,102" --yes
General API Coverage (the only remaining interface)
# 缓存清理(仅此接口无快捷命令)
ziniao-cli api /superbrowser/rest/v1/erp/store/deletecookie --data '{"removeStoreId":"xxx","removeType":1}'
# removeType: 1=清除所有缓存, 2=仅保留 cookie, 3=仅保留二步验证状态
# 账号授权用户列表 / 用户有权限的账号列表
ziniao-cli api /superbrowser/rest/v1/erp/store/user/list --data '{"storeIdList":["xxx"],"page":1,"limit":10}'
ziniao-cli api /superbrowser/rest/v1/erp/user/stores --data '{"userId":"xxx","page":1,"limit":10}'