其他
需要通过 ziniao-cli 管理紫鸟店铺账号的查询…
当用户要管理紫鸟浏览器店铺账号(store)的元数据、员工授权或标签,而非控制本地浏览器窗口时使用。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 40/100 ×0.15
适用场景
需要通过 ziniao-cli 管理紫鸟特定
解决思路
- 开始前先用 Read 工具读取 `../ziniao-shared/SKILL.md`。
- 执行任何 Shortcuts 前,先读取对应的 `references/` 说明文档。
- 将“账号”理解为浏览器店铺账号(store),不是员工用户。
- 区分命令用途:`account` 命令通过服务端 API 管理店铺账号(创建、删除、授权、标签);控制本地浏览器窗口(打开/关闭/导航/截图)用 `store` + `page` 命令(走本地 ZClaw Bridge)。
- 获取店铺列表时按身份选择:成员账号没有服务端 `account list` 权限,应使用 `store list`(本地 ZClaw Bridge)获取店铺列表;Boss 账号如果目的是打开店铺浏览器,也应优先使用 `store list` 获取本地可用店铺,而非 `account list`;`account list` 适用于需要管理店铺元数据(标签、授权、批量操作)的场景。
- 成员类型可通过 `ziniao-cli config show` 结果中的 `isBoss` 字段判断。
- 查询账号列表:运行 `ziniao-cli account list --name "某店" --format table`,或运行 `ziniao-cli account list --page-all`;详见 `references/ziniao-account-list.md`。
- 创建账号:运行 `ziniao-cli account create --name "我的店铺" --site-id 1 --remark "测试"`;详见 `references/ziniao-account-create.md`。
- 编辑账号基础信息:运行 `ziniao-cli account update`,且只发修改字段,例如 `ziniao-cli account update --id 123 --name "新名称" --site-id 1`。
- 删除账号(高风险):运行 `ziniao-cli account delete --id xxx`,`--id` 支持逗号分隔批量,需加 `--yes`,例如 `ziniao-cli account delete --id "101,102,103" --yes`。
- 授权员工访问店铺:运行 `ziniao-cli account auth-add --store-id ... --staff-id ...`,`--store-id` 和 `--staff-id` 均支持逗号分隔批量,例如 `ziniao-cli account auth-add --store-id "111,222,333" --staff-id "201,202,203"`。
- 撤销员工访问权限:运行 `ziniao-cli account auth-remove --store-id ... --staff-id ...`,`--store-id` 和 `--staff-id` 均支持逗号分隔批量,例如 `ziniao-cli account auth-remove --store-id 111 --staff-id 201`。
- 清空店铺所有员工授权(高风险):运行 `ziniao-cli account auth-clean --store-id 111 --yes`。
- 查询某员工被授权的店铺列表:运行 `ziniao-cli account auth-list --user-id 201 --page-all --format table`。
- 查询某店铺已授权的员工列表:运行 `ziniao-cli account auth-users`。
- 查询企业下所有标签:运行 `ziniao-cli account tag-list --format table`;对应 API `/superbrowser/rest/v1/erp/tag/list`,无请求体字段。
- 查询某店铺绑定的标签列表:运行 `ziniao-cli account tag-of-store --store-id 101`;对应 API `/superbrowser/rest/v1/store-tag/list`,请求体字段 `storeId` 和可选 `withSystem`。
- 创建标签:运行 `ziniao-cli account tag-create --name "重点店铺"`;对应 API `/superbrowser/rest/v1/store-tag/add`,请求体字段 `tagName`。
- 重命名标签:运行 `ziniao-cli account tag-rename --id ... --name ...`;对应 API `/superbrowser/rest/v1/store-tag/rename`,请求体字段 `tid`, `name`。
- 删除标签(高风险):运行 `ziniao-cli account tag-delete --id ...`;对应 API `/superbrowser/rest/v1/store-tag/delete`,请求体字段 `tagIds`。
- 绑定标签到店铺:运行 `ziniao-cli account tag-bind --tag-id 99 --store-id "101,102,103"`,`--store-id` 支持批量;对应 API `/superbrowser/rest/v1/store-tag/bind`,请求体字段 `tagIds`, `storeIds`。
- 解绑标签:运行 `ziniao-cli account tag-unbind --tag-id ... --store-id ...`,`--store-id` 支持批量;对应 API `/superbrowser/rest/v1/store-tag/unbind`,请求体字段 `tagIds`, `storeIds`。
- 全量替换店铺的标签集合:运行 `ziniao-cli account tag-replace --store-id 101 --tag-ids "99,100"`;对应 API `/superbrowser/rest/v1/store-tag/replace`,请求体字段 `tagIds`, `storeIds`。
- 清空店铺所有标签(高风险):运行 `ziniao-cli account tag-clear --store-id ...`;对应 API `/superbrowser/rest/v1/store-tag/clear`,请求体字段 `storeIds`。
- 从指定店铺移除该标签(高风险):运行 `ziniao-cli account tag-remove --tag-id 99 --store-id "101,102" --yes`,`--store-id` 支持批量;对应 API `/superbrowser/rest/v1/store-tag/remove`,请求体字段 `tagIds`, `storeIds`。
- 底层接口与请求体字段必须严格按接口文档发送,不要补发未记录的别名字段。
- 缓存清理(仅此接口无快捷命令):运行 `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}'`。
适用边界 · 注意事项
- 如果只是控制本地浏览器窗口(打开/关闭/导航/截图),不要用 `account`,应使用 `store` + `page` 命令(走本地 ZClaw Bridge)。
- 成员账号没有服务端 `account list` 权限时,不要用 `account list` 获取店铺列表,应使用 `store list`(本地 ZClaw Bridge)。
- Boss 账号如果目的只是打开店铺浏览器,不要优先用 `account list`,应优先使用 `store list` 获取本地可用店铺。