{
  "markdown": "# ziniao-skills\n\n紫鸟浏览器 AI Agent Skill 包，覆盖 ERP 管理（员工/角色/设备/标签/部门）和店铺自动化操作，适配 ziniao-cli 与 ZClaw 本地接口。\n\n## Skill 安装\n\n以后 Skill 内置在 `ziniao-cli` 里安装，不再单独走 `npx skills add`：\n\n```bash\nziniao-cli skills install\n```\n\n先安装 CLI 后再执行上面的命令。备选（不推荐）：`npx skills add ziniao-open/skills -y -g`\n\n## ziniao-cli 安装\n\n```bash\nnpm install -g @ziniao-open/cli\n```\n\n安装后验证：\n\n```bash\nziniao-cli --version\n```\n\n## 快速开始\n\n### 1. 初始化配置\n\n```bash\nziniao-cli config init\n```\n\n按提示选择\"新建应用\"或\"手动输入 API Key\"，完成后凭证自动存入系统 Keychain。\n\n### 2. AI Agent 初始化流程\n\nAI Agent 应使用非交互模式：\n\n```bash\nziniao-cli config init --new\n```\n\n该命令会阻塞直到审核通过、被拒绝或超时（1 小时），Agent 的处理流程：\n\n1. 后台执行 `config init --new`\n2. 从 stderr 输出中提取 URL（包含 `memberAuth?cliRequestId=` 的行）\n3. 将链接展示给用户，提示在浏览器中打开完成应用创建\n4. 等待命令完成（审核通过/拒绝/超时）\n\n输出示例：\n\n```\n请在浏览器中打开以下链接完成应用创建:\n\n  https://open.ziniao.com/memberAuth?cliRequestId=a1b2c3d4-...&from=cli\n\n⏳ 等待应用创建及审核... (按 Ctrl+C 取消)\n✓ 审核已通过\n✓ 企业 ID: 15393*****3459\n✓ 配置已保存 (profile: zhangsan)\n```\n\n初始化完成后，`isBoss` 字段决定账号权限范围：\n\n| 账号类型 | 服务端 API | ZClaw Bridge（本地浏览器） |\n|---------|-----------|--------------------------|\n| Boss | 全部可用 | 全部可用 |\n| 成员 | 不可用 | 全部可用 |\n\n可通过 `ziniao-cli config show` 查看当前账号类型。\n\n### 3. 多账号管理\n\n支持多个账号配置（profile），通过 `config use` 切换：\n\n```bash\n# 列出所有 profile\nziniao-cli config list\n\n# 切换到指定 profile\nziniao-cli config use <name>\n\n# 重命名 profile\nziniao-cli config rename <old> <new>\n\n# 删除 profile（需确认，--yes 跳过）\nziniao-cli config remove --profile <name>\n```\n\n### 4. 验证连通性\n\n```bash\nziniao-cli doctor\n```\n\n### 5. 开始使用\n\n```bash\n# 查看员工列表\nziniao-cli staff list --format table\n\n# 查看部门树\nziniao-cli department list --tree\n\n# 查看角色列表\nziniao-cli role list --format table\n```\n\n## 命令概览\n\n### 配置管理\n\n| 命令 | 说明 |\n|------|------|\n| `config init` | 初始化配置 |\n| `config show` | 显示当前配置 |\n| `config list` | 列出所有 profile |\n| `config use <name>` | 切换当前 profile |\n| `config rename <old> <new>` | 重命名 profile |\n| `config remove` | 删除 profile（需确认） |\n\n### 部门管理\n\n| 命令 | 说明 |\n|------|------|\n| `department list` | 查询部门列表 |\n| `department create` | 新增部门 |\n| `department update` | 修改部门 |\n| `department delete` | 删除部门 |\n| `department reorder` | 部门排序 |\n\n### 员工管理\n\n| 命令 | 说明 |\n|------|------|\n| `staff list` | 查询员工列表 |\n| `staff create` | 新增员工 |\n| `staff update` | 修改员工信息 |\n| `staff enable` | 启用员工 |\n| `staff disable` | 禁用员工 |\n| `staff remove` | 删除员工 |\n| `staff transfer` | 员工调岗 |\n\n### 角色管理\n\n| 命令 | 说明 |\n|------|------|\n| `role list` | 查询角色列表 |\n| `role detail` | 查看角色详情 |\n| `role create` | 创建角色 |\n| `role update` | 修改角色 |\n| `role assign` | 分配角色给员工 |\n| `role staff-roles` | 查看员工已分配角色 |\n| `role permissions` | 查看可用权限列表 |\n\n### 账号（店铺）管理\n\n| 命令 | 说明 |\n|------|------|\n| `account list` | 查询账号列表 |\n| `account create` | 创建账号 |\n| `account update` | 修改账号信息 |\n| `account delete` | 删除账号 |\n| `account auth-add` | 授权员工访问店铺 |\n| `account auth-remove` | 撤销员工授权 |\n| `account auth-clean` | 清空店铺所有授权 |\n| `account auth-list` | 查询员工被授权的店铺 |\n| `account auth-users` | 查询店铺已授权的员工 |\n| `account tag-list` | 查询企业标签列表 |\n| `account tag-create` | 创建标签 |\n| `account tag-rename` | 重命名标签 |\n| `account tag-delete` | 删除标签 |\n| `account tag-bind` | 绑定标签到店铺 |\n| `account tag-unbind` | 解绑标签 |\n| `account tag-replace` | 全量替换店铺标签 |\n| `account tag-clear` | 清空店铺标签 |\n| `account tag-remove` | 从店铺移除标签 |\n| `account tag-of-store` | 查询店铺绑定的标签 |\n\n### 设备管理\n\n| 命令 | 说明 |\n|------|------|\n| `device list` | 查询设备列表 |\n| `device add-custom` | 添加自有设备 |\n| `device update-custom` | 修改自有设备 |\n| `device plan-list` | 查询可购买套餐 |\n| `device bind` | 绑定设备到店铺 |\n| `device unbind` | 解绑设备 |\n| `device auto-renew` | 设置自动续费 |\n| `device purchase` | 购买设备套餐 |\n| `device renew` | 续费设备 |\n\n### 浏览器控制（ZClaw）\n\n| 命令 | 说明 |\n|------|------|\n| `store list` | 列出已打开的店铺浏览器 |\n| `store open` | 打开店铺浏览器 |\n| `store close` | 关闭店铺浏览器 |\n| `page visit` | 导航到指定 URL |\n| `page screenshot` | 页面截图 |\n| `page automation` | 页面自动化操作 |\n\n### 通用 API 调用\n\n对于未提供快捷命令的接口（共 73 个接口中 shortcut 覆盖 45 个），可使用通用 `api` 命令：\n\n```bash\nziniao-cli api <path> [--data '{}'] [--format table] [--jq '.field']\nziniao-cli api /superbrowser/rest/v1/erp/store/deletecookie --data '{\"storeId\":\"xxx\"}'\n```\n\n## Skill 模块\n\n| Skill | 说明 |\n|-------|------|\n| `ziniao-shared` | 共享基础：配置初始化、认证、输出格式、权限点 |\n| `ziniao-staff` | 员工管理 |\n| `ziniao-role` | 角色与权限管理 |\n| `ziniao-department` | 部门管理 |\n| `ziniao-account` | 账号（店铺）管理与标签 |\n| `ziniao-device` | 设备管理 |\n| `ziniao-store` | 浏览器店铺控制（ZClaw） |\n| `ziniao-page` | 浏览器页面操作（ZClaw） |\n| `ziniao-access-policy` | 访问策略管理 |\n| `ziniao-openapi-explorer` | API 路径清单与探索指引 |\n| `ziniao-workflow-batch-account` | 批量账号授权工作流 |\n| `ziniao-skill-maker` | 自定义 Skill 创建指引 |\n\n## 适用环境\n\n这些 Skill 文档适用于任何支持工具调用的 AI Agent 环境：\n\n- Claude Code\n- Cursor\n- OpenClaw\n- 其他支持 Skill 协议的 Agent\n\n## License\n\nCC BY 4.0\n",
  "bytes": 4614,
  "sha": "117cf8ce8f25600ea95f24535da7bc4093e5560bc41068f2470dd2494819cea1",
  "repo_slug": "ziniao-open/skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_ziniao_open_skills_ziniao_access_policy_059068f5/readme"
}