管理紫鸟多店铺的生命周期，包括打开、连接、切换和关闭店铺。当需要管理多个店铺、恢复已打开的店铺会话、或进行批量店铺操作时使用此技能。
list_stores → 获取店铺列表
│
├── open_store → 打开新店铺（启动浏览器实例 + CDP 连接）
│
├── connect_store → 连接已运行的店铺（恢复 CDP，不重启）
│
├── 执行页面操作...
│
├── close_store → 关闭单个店铺
│
└── stop_client → 退出客户端（关闭所有店铺）
| 场景 | 使用 | 原因 |
|---|---|---|
| 不确定店铺是否已打开 | connect_store | 已运行则恢复连接，未运行则自动 fallback 到 open |
| 需要强制重启店铺 | open_store | 会关闭已运行的实例并重新打开 |
| MCP 进程重启后恢复 | connect_store | 从 ~/.ziniao/sessions.json 恢复 CDP 信息 |
| 首次打开店铺 | 两者均可 | connect_store 更安全，会自动 fallback |
推荐默认使用 connect_store，除非明确需要重启。
1. list_stores → 查看所有店铺（含 is_open 标识）
2. list_open_stores → 仅查看已打开的店铺（经过 CDP 连通性验证）
当前架构下，最后一次 connect_store 或 open_store 的店铺成为活动店铺。切换活动店铺：
connect_store("target_store_id") → 目标店铺成为活动店铺
对多个店铺执行相同操作时：
list_stores 获取目标店铺列表connect_store 并执行操作注意：不要同时打开超过 5 个店铺，避免系统资源耗尽。
已打开店铺的信息持久化在 ~/.ziniao/sessions.json：
{
"store_123": {
"store_id": "store_123",
"store_name": "我的亚马逊店铺",
"cdp_port": 9222,
"browser_oauth": "oauth_xxx",
"opened_at": 1717200000.0
}
}
connect_store 的恢复流程：
/json/version 验证端口连通性Browser.create() 恢复 CDP 连接open_store 重新打开上述所有操作也可通过 ziniao CLI 完成，适合脚本和终端环境：
| MCP 工具 | CLI 命令 |
|---|---|
list_stores | ziniao list-stores |
open_store(id) | ziniao open-store <id> |
close_store(id) | ziniao close-store <id> |
connect_store(id) | ziniao open-store <id> (自动恢复) |
start_client | ziniao store start-client |
stop_client | ziniao store stop-client |
browser_session(list) | ziniao session list |
browser_session(switch) | ziniao session switch <id> |
# 对所有已打开店铺截图
ziniao list-stores --opened-only --json | jq -r '.stores[].store_id' | while read id; do
ziniao --store "$id" screenshot "${id}.png"
done
| 问题 | 解决方案 |
|---|---|
list_stores 返回空 | 检查紫鸟账号登录信息（company/username/password）是否正确 |
connect_store 失败 | 店铺浏览器可能已关闭，会自动 fallback 到 open_store |
| 打开店铺超时 | 检查紫鸟客户端是否正常运行，网络是否通畅 |
| CDP 端口冲突 | 关闭占用端口的进程，或重启紫鸟客户端 |