核心用法
Ziniao Assistant 是紫鸟浏览器（Ziniao Browser）的官方自动化控制技能，通过本地 ZClaw HTTP 桥接（默认端口 9481）实现浏览器远程操控。核心工作流为：配置 API 密钥 → 列出/解析店铺 → 打开店铺 → 页面操作（访问、点击、输入、截图）→ 自动化任务执行。
关键能力矩阵：
- 店铺管理：
list_stores一次性获取店铺列表，resolve_store精确解析，open_store启动浏览器实例 - 页面操控：
visit_page导航、get_page_content读取内容、query_elements查询 DOM、click_element/input_text交互 - 自动化：
run_automation执行多步骤流程，execute_script注入页面 JS，extract_data提取元数据 - 输出工具：
take_screenshot截图、download_file导出文件
API 配置优先级：对话中用户提供的密钥（立即写入 ~/.zclaw/config.json）→ 环境变量 ZCLAW_API_KEY → 配置文件读取。支持 macOS/Linux 与 Windows 跨平台。
显著优点
1. 原生集成：直接调用紫鸟浏览器内核，非外置 Chromium，规避平台风控检测
2. 店铺隔离：每个店铺独立浏览器实例，IP 与 Cookie 环境完全隔离
3. 零脚本依赖：所有操作通过标准化 HTTP API 完成，禁止创建 .sh/.js/.py 等脚本文件
4. 失败即停：桥接失联或工具调用失败时强制终止，无重试、无推测执行，避免误操作
5. 实时密钥轮换：对话中配置新 API 密钥立即生效，无需重启服务
潜在局限与风险
- 单点依赖：必须保持 ZClaw 桥接运行（默认
127.0.0.1:9481），本地服务崩溃则完全不可用 - 无内置重试：网络瞬断即任务终止，需用户手动重新发起
- 店铺信息有限：
list_stores仅返回基础字段（storeId/storeName/platformName/ip），不暴露完整店铺配置 - 平台风控：高频自动化仍可能触发电商平台人机验证，需配合合理延迟策略
- API 密钥管理：密钥需从紫鸟生态中心申请，无自助生成入口，轮换流程较繁琐
适合人群
- 跨境电商运营者（Amazon、Shopee、TikTok Shop 等多店铺管理）
- 需要批量数据采集、订单处理、广告优化的自动化团队
- 已部署紫鸟浏览器企业版、具备 API 密钥的技术或业务用户
常规风险
- 密钥泄露：
~/.zclaw/config.json明文存储，共享环境需权限管控 - 误操作覆盖：自动写入配置时会合并而非清空，但错误密钥仍会导致认证失败
- 浏览器资源耗尽：并发打开多店铺可能触发内存/句柄上限
- 合规边界：自动化操作需遵守各电商平台 ToS，过度抓取可能导致账号限制