ziniao-cli

紫鸟开放平台命令行工具，为开发者和 AI Agent 提供统一的接口调用入口。

支持服务端 OpenAPI 和本地浏览器 Bridge（ZClaw）两套接口体系，使用统一的 apiKey 认证。

安装

npm install -g @ziniao-open/cli

安装时会自动下载当前平台对应的预编译二进制（支持 macOS / Linux / Windows × amd64 / arm64），并做 SHA-256 校验。

快速开始

# 1. 初始化配置（首次使用必做，会引导你写入 apiKey）
ziniao-cli config init

# 2. 通用 API 调用（覆盖紫鸟开放平台全部接口）
ziniao-cli api /superbrowser/rest/v1/erp/department/list

# 3. 快捷命令（高频操作的封装）
ziniao-cli staff list --format table
ziniao-cli store list
ziniao-cli department list

# 4. 环境自检
ziniao-cli doctor

# 5. 查看所有命令
ziniao-cli --help

命令概览

| 类别 | 命令 | 说明 | |------|------|------| | 基础 | config | apiKey 等配置初始化与查看 | | 基础 | doctor | 环境自检（认证、网络、ZClaw 桥可用性） | | 基础 | completion | 生成 shell 自动补全 | | 通用 | api <path> | 调用任意紫鸟 OpenAPI 路径 | | 桥接 | zclaw | 本地浏览器 Bridge（页面操作、店铺管理等） | | 快捷 | staff / store / account / department / role / device / page / automation | 高频业务操作的封装 |

完整列表见 ziniao-cli --help。

AI Agent Skills

仓库提供 13 个开箱即用的 AI Agent Skill，包括员工、店铺、角色、部门、设备、访问策略管理，以及批量授权、店铺巡检等编排工作流。

安装 Skill：

npx skills add ziniao-open/skills -y -g

详见 ziniao-skills。