ziniao-skills

紫鸟浏览器 AI Agent Skill 包，覆盖 ERP 管理（员工/角色/设备/标签/部门）和店铺自动化操作，适配 ziniao-cli 与 ZClaw 本地接口。

Skill 安装

以后 Skill 内置在 ziniao-cli 里安装，不再单独走 npx skills add：

ziniao-cli skills install

先安装 CLI 后再执行上面的命令。备选（不推荐）：npx skills add ziniao-open/skills -y -g

ziniao-cli 安装

npm install -g @ziniao-open/cli

安装后验证：

ziniao-cli --version

快速开始

1. 初始化配置

ziniao-cli config init

按提示选择"新建应用"或"手动输入 API Key"，完成后凭证自动存入系统 Keychain。

2. AI Agent 初始化流程

AI Agent 应使用非交互模式：

ziniao-cli config init --new

该命令会阻塞直到审核通过、被拒绝或超时（1 小时），Agent 的处理流程：

1. 后台执行 config init --new
2. 从 stderr 输出中提取 URL（包含 memberAuth?cliRequestId= 的行）
3. 将链接展示给用户，提示在浏览器中打开完成应用创建
4. 等待命令完成（审核通过/拒绝/超时）

输出示例：

请在浏览器中打开以下链接完成应用创建:

  https://open.ziniao.com/memberAuth?cliRequestId=a1b2c3d4-...&from=cli

⏳ 等待应用创建及审核... (按 Ctrl+C 取消)
✓ 审核已通过
✓ 企业 ID: 15393*****3459
✓ 配置已保存 (profile: zhangsan)

初始化完成后，isBoss 字段决定账号权限范围：

可通过 ziniao-cli config show 查看当前账号类型。

3. 多账号管理

支持多个账号配置（profile），通过 config use 切换：

# 列出所有 profile
ziniao-cli config list

# 切换到指定 profile
ziniao-cli config use <name>

# 重命名 profile
ziniao-cli config rename <old> <new>

# 删除 profile（需确认，--yes 跳过）
ziniao-cli config remove --profile <name>

4. 验证连通性

ziniao-cli doctor

5. 开始使用

# 查看员工列表
ziniao-cli staff list --format table

# 查看部门树
ziniao-cli department list --tree

# 查看角色列表
ziniao-cli role list --format table

命令概览

配置管理

部门管理

员工管理

角色管理

账号（店铺）管理

设备管理

浏览器控制（ZClaw）

通用 API 调用

对于未提供快捷命令的接口（共 73 个接口中 shortcut 覆盖 45 个），可使用通用 api 命令：

ziniao-cli api <path> [--data '{}'] [--format table] [--jq '.field']
ziniao-cli api /superbrowser/rest/v1/erp/store/deletecookie --data '{"storeId":"xxx"}'

Skill 模块

适用环境

这些 Skill 文档适用于任何支持工具调用的 AI Agent 环境：

• Claude Code
• Cursor
• OpenClaw
• 其他支持 Skill 协议的 Agent

License

CC BY 4.0