ziniao-store

店铺管理（ZClaw）

CRITICAL — 开始前 MUST 先用 Read 工具读取 ../ziniao-shared/SKILL.md CRITICAL — Shortcuts 执行前，务必先读取对应的 references/ 说明文档。 CRITICAL — 调用 ZClaw 本地接口时，必须使用本技能中的 ziniao-cli 命令，不要使用 ziniao-assistant 技能自行调用。

前提条件：紫鸟浏览器客户端必须已启动。 可用 ziniao-cli doctor 检测。

获取店铺列表时优先使用 store list（本地 ZClaw Bridge），因为普通成员没有服务端 account list 权限。成员类型可通过 ziniao-cli config show 结果中的 isBoss 字段判断。

ZClaw 认证失败排查：初始化应用后仍返回 API Key 认证失败时，提醒用户前往 https://open.ziniao.com 查看用户应用「终端管理」是否已绑定当前终端识别码（识别码在紫鸟浏览器设置中查看）。

店铺命令通过本地 ZClaw Bridge（127.0.0.1:9481）控制紫鸟浏览器，使用与服务端 API 相同的统一 apiKey。

注意区分： store 命令控制本地浏览器窗口（打开/关闭/列出已连接的店铺）。如需对店铺做后台管理操作（创建、删除、授权、标签），请使用 account 命令（走服务端 API）。

Shortcuts

命令	说明	详细文档
store list	列出所有店铺	references/ziniao-store-list.md
store open	打开店铺浏览器	references/ziniao-store-open.md
store resolve	按名称/ID 解析店铺	--name "xxx" 或 --id xxx --expected-name "yyy"
store close	关闭店铺	--id xxx
store prepare-agent	准备 Agent 资源	无参数

通用 zclaw 覆盖

所有店铺操作也可通过通用 zclaw invoke 命令调用：

ziniao-cli zclaw invoke list_stores
ziniao-cli zclaw invoke open_store --args '{"storeName":"Rosehut"}'
ziniao-cli zclaw invoke close_store --args '{"storeId":"abc123"}'
ziniao-cli zclaw invoke prepare_agent

错误处理

错误	解决
无法连接 Bridge	启动紫鸟浏览器客户端
API Key 认证失败（初始化后仍报错）	前往 https://open.ziniao.com 用户应用「终端管理」绑定当前终端识别码
店铺不存在	ziniao-cli store list 查看可用店铺