（5391期）ziniao-assistant – 紫鸟浏览器自动化控制中心

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