通过 ZClaw 桥接控制紫鸟浏览器，实现店铺管理、页面自动化与数据提取，需本地桥接与 API 密钥。
说明：
## 核心功能
Ziniao Assistant 是一款面向电商运营与自动化测试场景的浏览器控制技能，通过本地 ZClaw 桥接（默认 `http://127.0.0.1:9481`）调用紫鸟浏览器（Ziniao Browser）的远程 API。其核心能力涵盖：
– **店铺生命周期管理**：`list_stores`/`resolve_store` 查询、`open_store`/`close_store` 启闭，支持 `launchUrl` 参数实现开店即导航
– **页面操作**：`visit_page` 导航、`get_page_content` 读取内容、`query_elements`/`click_element`/`input_text`/`scroll_page` 交互、`take_screenshot` 截图
– **等待与同步**：`wait_for_element`、`wait_for_navigation` 确保操作时机
– **自动化编排**：`run_automation` 多步骤流程、`execute_script` 注入 JavaScript
– **数据与调试**：`extract_data`（含运行店铺列表）、`download_file`、`get_logs`、`debug_compare_lists`
## 显著优点
1. **权威工具发现**：会话开始时强制 `GET /zclaw/tools` 获取实时工具白名单，杜绝幻觉命名，提升调用成功率
2. **严格的认证链**：支持会话即时配置 API 密钥（写入 `~/.zclaw/config.json`）、环境变量 `ZCLAW_API_KEY` 及配置文件三级读取，确保每次 `invoke` 均携带凭证
3. **防阻塞设计**：桥接不可达或工具调用失败时立即终止回合，避免无效重试与资源浪费
4. **单端点架构**：所有操作统一通过 `POST /zclaw/tools/invoke` 完成，降低集成复杂度
5. **跨平台兼容**：配置路径覆盖 macOS/Linux（`~/.zclaw/config.json`）与 Windows（`%USERPROFILE%\.zclaw\config.json`）
## 潜在局限
– **本地依赖**：必须预先安装并运行紫鸟浏览器及 ZClaw 桥接，无云端备用方案
– **API 密钥获取门槛**：密钥需通过 Ziniao 生态中心或服务器申请，无法应用内自助生成
– **无脚本兜底**：明确禁止创建 `.sh`/`.js`/`.py` 等脚本文件 workaround，工具能力不足时需直接报告限制
– **窗口前台控制缺失**：桥接操作不自动将浏览器窗口置顶，需用户自行切换
## 适合人群
– 跨境电商多店铺运营者，需批量管理店铺环境
– 自动化测试工程师，基于紫鸟浏览器进行 Web UI 自动化
– RPA 开发者，构建无需人工值守的页面数据提取流程
## 常规风险
– **桥接单点故障**：本地服务宕机或端口冲突将导致全部功能失效
– **密钥泄露**：配置文件明文存储 API 密钥，共享环境需注意权限控制
– **操作不可逆**：`close_store` 立即终止浏览器实例，未保存数据可能丢失
– **网络隔离**：店铺访问受紫鸟代理网络限制，需确保代理配置正确
会员专属
