核心功能
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立即终止浏览器实例，未保存数据可能丢失 - 网络隔离：店铺访问受紫鸟代理网络限制，需确保代理配置正确