Back to Details

ziniao-account

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

账号（店铺）管理

账号（店铺）管理

CRITICAL — 开始前 MUST 先用 Read 工具读取 
../ziniao-shared/SKILL.md
 CRITICAL — Shortcuts 执行前，务必先读取对应的 references/ 说明文档。
紫鸟的"账号"指浏览器店铺账号（store），不是员工用户。本模块共覆盖 22 个接口，全部已有快捷命令。
注意区分： 
account
命令通过服务端 API 管理店铺账号（创建、删除、授权、标签）。如需控制本地浏览器窗口（打开/关闭/导航/截图），请使用 
store
+ 
page
命令（走本地 ZClaw Bridge）。
获取店铺列表的选择：
  • 成员账号没有服务端 
    account list
    权限，应使用 
    store list
    （本地 ZClaw Bridge）获取店铺列表。
  • Boss 账号如果目的是打开店铺浏览器，也应优先使用 
    store list
    获取本地可用店铺，而非 
    account list
    。
  • account list
    适用于需要管理店铺元数据（标签、授权、批量操作）的场景。
  • 成员类型可通过 
    ziniao-cli config show
    结果中的 
    isBoss
    字段判断。
CRITICAL — 开始前 MUST 先用 Read 工具读取 
../ziniao-shared/SKILL.md
 CRITICAL — Shortcuts 执行前，务必先读取对应的 references/ 说明文档。
紫鸟的"账号"指浏览器店铺账号（store），不是员工用户。本模块共覆盖 22 个接口，全部已有快捷命令。
注意区分： 
account
命令通过服务端 API 管理店铺账号（创建、删除、授权、标签）。如需控制本地浏览器窗口（打开/关闭/导航/截图），请使用 
store
+ 
page
命令（走本地 ZClaw Bridge）。
获取店铺列表的选择：
  • 成员账号没有服务端 
    account list
    权限，应使用 
    store list
    （本地 ZClaw Bridge）获取店铺列表。
  • Boss 账号如果目的是打开店铺浏览器，也应优先使用 
    store list
    获取本地可用店铺，而非 
    account list
    。
  • account list
    适用于需要管理店铺元数据（标签、授权、批量操作）的场景。
  • 成员类型可通过 
    ziniao-cli config show
    结果中的 
    isBoss
    字段判断。

Shortcuts — 账号 CRUD

Shortcuts — 账号 CRUD

命令说明详细文档
account list
查询账号列表
references/ziniao-account-list.md
account create
创建账号
references/ziniao-account-create.md
account update
编辑账号基础信息只发修改字段：
--id xxx --name "新名"
account delete
删除账号（高风险）
--id xxx
，逗号分隔可批量，需 
--yes
bash
undefined
命令说明详细文档
account list
查询账号列表
references/ziniao-account-list.md
account create
创建账号
references/ziniao-account-create.md
account update
编辑账号基础信息只发修改字段：
--id xxx --name "新名"
account delete
删除账号（高风险）
--id xxx
，逗号分隔可批量，需 
--yes
bash
undefined

查询

查询

ziniao-cli account list --name "某店" --format table ziniao-cli account list --page-all
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 create --name "我的店铺" --site-id 1 --remark "测试"

修改

修改

ziniao-cli account update --id 123 --name "新名称" --site-id 1
ziniao-cli account update --id 123 --name "新名称" --site-id 1

删除（批量）

删除（批量）

ziniao-cli account delete --id "101,102,103" --yes
undefined
ziniao-cli account delete --id "101,102,103" --yes
undefined

Shortcuts — 授权管理

Shortcuts — 授权管理

命令说明
account auth-add
授权员工访问店铺（
--store-id
和 
--staff-id
均支持逗号分隔批量）
account auth-remove
撤销员工访问权限（
--store-id
和 
--staff-id
均支持逗号分隔批量）
account auth-clean
清空店铺所有员工授权（高风险）
account auth-list
查询某员工被授权的店铺列表
account auth-users
查询某店铺已授权的员工列表
bash
undefined
命令说明
account auth-add
授权员工访问店铺（
--store-id
和 
--staff-id
均支持逗号分隔批量）
account auth-remove
撤销员工访问权限（
--store-id
和 
--staff-id
均支持逗号分隔批量）
account auth-clean
清空店铺所有员工授权（高风险）
account auth-list
查询某员工被授权的店铺列表
account auth-users
查询某店铺已授权的员工列表
bash
undefined

批量授权（把 3 个店铺同时授权给 3 个员工）

批量授权（把 3 个店铺同时授权给 3 个员工）

ziniao-cli account auth-add --store-id "111,222,333" --staff-id "201,202,203"
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-remove --store-id 111 --staff-id 201

查看某员工被授权的所有店铺

查看某员工被授权的所有店铺

ziniao-cli account auth-list --user-id 201 --page-all --format table
ziniao-cli account auth-list --user-id 201 --page-all --format table

清空授权（高风险）

清空授权（高风险）

ziniao-cli account auth-clean --store-id 111 --yes
undefined
ziniao-cli account auth-clean --store-id 111 --yes
undefined

Shortcuts — 标签管理

Shortcuts — 标签管理

命令说明
account tag-list
查询企业下所有标签
account tag-of-store --store-id
查询某店铺绑定的标签列表
account tag-create --name
创建标签
account tag-rename --id --name
重命名标签
account tag-delete --id
删除标签（高风险）
account tag-bind --tag-id --store-id
绑定标签到店铺（
--store-id
支持批量）
account tag-unbind --tag-id --store-id
解绑（
--store-id
支持批量）
account tag-replace --store-id --tag-ids
全量替换店铺的标签集合
account tag-clear --store-id
清空店铺所有标签（高风险）
account tag-remove --tag-id --store-id
从指定店铺移除该标签（高风险，
--store-id
支持批量）
底层接口与请求体字段必须严格按接口文档发送，不要补发未记录的别名字段。
命令API请求体字段（不含公共 
companyId
）
account tag-list
/superbrowser/rest/v1/erp/tag/list
无
account tag-of-store --store-id
/superbrowser/rest/v1/store-tag/list
storeId
, 可选 
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
bash
undefined
命令说明
account tag-list
查询企业下所有标签
account tag-of-store --store-id
查询某店铺绑定的标签列表
account tag-create --name
创建标签
account tag-rename --id --name
重命名标签
account tag-delete --id
删除标签（高风险）
account tag-bind --tag-id --store-id
绑定标签到店铺（
--store-id
支持批量）
account tag-unbind --tag-id --store-id
解绑（
--store-id
支持批量）
account tag-replace --store-id --tag-ids
全量替换店铺的标签集合
account tag-clear --store-id
清空店铺所有标签（高风险）
account tag-remove --tag-id --store-id
从指定店铺移除该标签（高风险，
--store-id
支持批量）
底层接口与请求体字段必须严格按接口文档发送，不要补发未记录的别名字段。
命令API请求体字段（不含公共 
companyId
）
account tag-list
/superbrowser/rest/v1/erp/tag/list
无
account tag-of-store --store-id
/superbrowser/rest/v1/store-tag/list
storeId
, 可选 
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
bash
undefined

查看所有标签

查看所有标签

ziniao-cli account tag-list --format table
ziniao-cli account tag-list --format table

查看某店铺已有标签

查看某店铺已有标签

ziniao-cli account tag-of-store --store-id 101
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"
ziniao-cli account tag-create --name "重点店铺" ziniao-cli account tag-bind --tag-id 99 --store-id "101,102,103"

全量替换（将店铺 101 的标签换成 99 和 100）

全量替换（将店铺 101 的标签换成 99 和 100）

ziniao-cli account tag-replace --store-id 101 --tag-ids "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
undefined
ziniao-cli account tag-remove --tag-id 99 --store-id "101,102" --yes
undefined

通用 api 覆盖（仅剩的接口）

通用 api 覆盖（仅剩的接口）

bash
undefined
bash
undefined

缓存清理（仅此接口无快捷命令）

缓存清理（仅此接口无快捷命令）

ziniao-cli api /superbrowser/rest/v1/erp/store/deletecookie --data '{"removeStoreId":"xxx","removeType":1}'
ziniao-cli api /superbrowser/rest/v1/erp/store/deletecookie --data '{"removeStoreId":"xxx","removeType":1}'

removeType: 1=清除所有缓存, 2=仅保留 cookie, 3=仅保留二步验证状态

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}'
undefined
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}'
undefined