ziniao-account

v2026.09.24

紫鸟账号(店铺)管理:店铺账号的查询、创建、修改、删除、授权和标签管理。当用户需要查看店铺账号列表、创建/修改/删除账号、管理账号授权或标签时使用。

GitHub
安装命令
npx skhub add ziniao-open/ziniao-account
Markdown
SKILL.md

账号(店铺)管理

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

命令说明详细文档
account list查询账号列表references/ziniao-account-list.md
account create创建账号references/ziniao-account-create.md
account update编辑账号基础信息只发修改字段:--id xxx --name "新名"
account delete删除账号(高风险)--id xxx,逗号分隔可批量,需 --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 — 授权管理

命令说明
account auth-add授权员工访问店铺(--store-id 和 --staff-id 均支持逗号分隔批量)
account auth-remove撤销员工访问权限(--store-id 和 --staff-id 均支持逗号分隔批量)
account auth-clean清空店铺所有员工授权(高风险)
account auth-list查询某员工被授权的店铺列表
account auth-users查询某店铺已授权的员工列表
# 批量授权(把 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 — 标签管理

命令说明
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/liststoreId, 可选 withSystem
account tag-create --name/superbrowser/rest/v1/store-tag/addtagName
account tag-rename --id --name/superbrowser/rest/v1/store-tag/renametid, name
account tag-delete --id/superbrowser/rest/v1/store-tag/deletetagIds
account tag-bind --tag-id --store-id/superbrowser/rest/v1/store-tag/bindtagIds, storeIds
account tag-unbind --tag-id --store-id/superbrowser/rest/v1/store-tag/unbindtagIds, storeIds
account tag-replace --store-id --tag-ids/superbrowser/rest/v1/store-tag/replacetagIds, storeIds
account tag-clear --store-id/superbrowser/rest/v1/store-tag/clearstoreIds
account tag-remove --tag-id --store-id/superbrowser/rest/v1/store-tag/removetagIds, 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

通用 api 覆盖(仅剩的接口)

# 缓存清理(仅此接口无快捷命令)
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}'
发现
标签

此技能尚未发布标签。

版本
最新版本元数据

版本

v2026.09.24

发布时间

Sep 24, 2026

分类

未分类

许可证

MIT

源路径

skills/ziniao-account

默认分支

main

最新提交

0769423

Tree SHA

56b2935