---
id: gh-ziniao-store
name: "ziniao-store"
url: https://skills.yangsir.net/skill/gh-ziniao-store
author: ziniao-open
domain: automation
tags: ["browser-automation", "store-management", "zclaw", "ziniao-cli"]
install_count: 5300
rating: 4.40 (120 reviews)
github: https://github.com/ziniao-open/skills/tree/main/skills/ziniao-store
---

# ziniao-store

> 此技能通过ZClaw Bridge自动化管理紫鸟浏览器中的店铺窗口，支持列出、打开、关闭店铺。适合需要频繁操作多个店铺浏览器的场景，可大幅提升效率并减少手动错误。

**Stats**: 5,300 installs · 4.4/5 (120 reviews)

## Before / After 对比

### 店铺浏览器操作效率

**Before**:

在没有此技能之前，用户需要手动在紫鸟浏览器中逐个查找、打开或关闭店铺窗口，操作繁琐且容易出错，每次操作平均耗时2分钟以上。

**After**:

使用此技能后，用户只需一条命令即可完成店铺列表查看、窗口打开或关闭，每次操作仅需10秒，大幅提升工作效率。

| Metric | Before | After | Change |
|---|---|---|---|
| 每次操作耗时 | 120秒 | 10秒 | -92% |

## Readme

# 店铺管理（ZClaw）

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../ziniao-shared/SKILL.md`](../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`](references/ziniao-store-list.md) |
| `store open` | 打开店铺浏览器 | [`references/ziniao-store-open.md`](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 命令调用：

```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
```

## 错误处理

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


---
*Source: https://skills.yangsir.net/skill/gh-ziniao-store*
*Markdown mirror: https://skills.yangsir.net/api/skill/gh-ziniao-store/markdown*