用途:管理紫鸟 ERP 中的角色(权限组),角色决定员工能看到哪些功能、能操作哪些店铺。使用前需先用 Read 工具读取 ../ziniao-shared/SKILL.md。
主要能力(Shortcuts):role list 查询所有角色;role detail --id 查看角色详情(含权限列表);role create --name --identity-id --permission-ids 创建角色;role update --id --name --identity-id --permission-ids 修改角色;role assign --role-id --staff-id 将角色分配给员工;role staff-roles --staff-id 查看某员工已分配的角色;role permissions --identity-id 查看指定身份的可用权限项。
常用用法:查询角色可执行 ziniao-cli role list --format table;查看详情用 ziniao-cli role detail --id 123;创建前先查权限项 ziniao-cli role permissions --identity-id 2,再执行 ziniao-cli role create --name "店铺运营" --identity-id 2 --permission-ids "100,101" --desc "负责日常店铺操作"。分配角色支持单个与批量:ziniao-cli role assign --role-id 123 --staff-id 456 或 --staff-id "456,789,101"。也可通过通用 api 子命令覆盖,例如 ziniao-cli api /superbrowser/rest/v1/erp/per/role/list。
限制:修改角色需全量提交,建议先用 role detail 查看当前值,不传的字段可能被清空;创建员工需传入 --role-id。资料的其余收费、平台与效果信息暂未提供。