ziniao-store

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

店铺管理（ZClaw）

Store Management (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）。

CRITICAL — MUST read
../ziniao-shared/SKILL.md
before starting CRITICAL — Be sure to read the corresponding references/ documentation before executing Shortcuts. CRITICAL — When calling ZClaw local interfaces, you must use the ziniao-cli commands in this skill, do not call them using the ziniao-assistant skill on your own.

Prerequisite: Ziniao Browser client must be running. Use

ziniao-cli doctor

to check.

Priority use
store list
when getting store list (local ZClaw Bridge), because regular members do not have server
account list
permissions. Member type can be judged by the
isBoss
field in the result of
ziniao-cli config show
.

ZClaw Authentication Failure Troubleshooting: If API Key authentication fails after initializing the application, remind users to go to https://open.ziniao.com to check whether the current terminal identification code (viewed in Ziniao Browser settings) has been bound to the user application's "Terminal Management".

Store commands control Ziniao Browser through the local ZClaw Bridge (

127.0.0.1:9481

), using the same unified apiKey as the server API.

Note the difference: The
store
command controls local browser windows (open/close/list connected stores). For backend management operations on stores (create, delete, authorize, tag), please use the
account
command (via server 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 资源	无参数

Command	Description	Detailed Documentation
`store list`	List all stores	`references/ziniao-store-list.md`
`store open`	Open store browser	`references/ziniao-store-open.md`
`store resolve`	Resolve store by name/ID	`--name "xxx"` or `--id xxx` `--expected-name "yyy"`
`store close`	Close store	`--id xxx`
`store prepare-agent`	Prepare Agent resources	No parameters

通用 zclaw 覆盖

General zclaw Override

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

bash

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

All store operations can also be called via the general zclaw invoke command:

bash

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

错误处理

Error Handling

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

Error	Solution
Cannot connect to Bridge	Start Ziniao Browser client
API Key authentication failed (still reports error after initialization)	Go to https://open.ziniao.com user application "Terminal Management" to bind the current terminal identification code
Store does not exist	Check available stores with `ziniao-cli store list`