其他
管理紫鸟员工账号时,用 ziniao-cli 执行查询…
在已安装并认证 ziniao-cli 的前提下,用于查询、创建、修改、启用/禁用/删除紫鸟员工或调整员工部门。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 35/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 55/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 40/100 ×0.15
适用场景
管理紫鸟员工账号时,用 ziniao-c特定
解决思路
- 开始任何操作前,先用 Read 工具读取 ../ziniao-shared/SKILL.md,获取认证、错误处理和安全规则。
- 执行任何快捷命令(Shortcuts)前,先用 Read 工具读取其对应 references/ 说明文档,禁止直接盲目调用命令。
- 查询员工:使用 ziniao-cli staff list,可带 --name、--status、--format table、--role、--page-all、--department-id 等筛选;枚举值已映射为人类可读。
- 查询员工示例:ziniao-cli staff list --name "张三" --status active --format table;ziniao-cli staff list --role boss --page-all;ziniao-cli staff list --department-id 15868464646076。
- 查询注意:默认返回包含已删除员工,取 ID 做后续操作时建议加 --status active。
- 创建员工:使用 ziniao-cli staff create,--department-id 必填;原始 API 需要 20+ 字段的嵌套 JSON,CLI 简化为核心 flag + 智能默认值。
- 创建员工示例:ziniao-cli staff create --username "zhangsan" --name "张三" --password "Pass123!" --role-id 16691047257645 --department-id 15868464646076。
- 创建员工智能默认值:authDevide=1(全设备授权)、authClient=全部允许、isLimitLogin=0。
- 创建员工登录日期默认发送有效日期:loginLimitStartDate=今天、loginLimitEndDate=2099-12-31;也可通过 --login-start-date / --login-end-date 指定。
- 启用员工:使用 ziniao-cli staff enable --id 16524289555087。
- 禁用员工:使用 ziniao-cli staff disable --id "id1,id2,id3",支持批量。
- 删除员工:使用 ziniao-cli staff remove --id 16524289555087,属于 high-risk-write。
- 原始 API 用一个接口通过 status 字段区分启用/禁用/删除,CLI 拆为 enable、disable、remove 三个语义化命令。
- 枚举映射:--status 的 active / disabled / deleted 对应 API delflag: 0/1/2。
- 枚举映射:--role 的 boss / manager / employee / admin 对应 API level: 0/1/2/3。
- 枚举映射:--device-auth 的 auto / first / approve / phone 对应 API authDevide: 1/2/3/4。
- 枚举映射:--allow-clients 的 windows,mac,web,android,ios,linux,miniapp 或 all 对应 API authClient 嵌套对象。
- 修改员工:使用 staff update,只发修改字段,如 --id xxx --name "新名";底层路径 /superbrowser/rest/v2/erp/staff/modify。
- 调岗:使用 staff transfer --staff-id xxx --department-id yyy。
- 查阅快捷命令(Shortcuts)详细文档:staff list 对应 references/ziniao-staff-list.md,staff create 对应 references/ziniao-staff-create.md,staff enable 和 staff disable 对应 references/ziniao-staff-enable-disable.md。
- 通用 api 覆盖查询:ziniao-cli api /superbrowser/rest/v1/erp/staff/list --data '{"page":1,"limit":10}'。
- 通用 api 覆盖新增:ziniao-cli api /superbrowser/rest/v2/erp/staff/add --data '{...}'。
- 通用 api 覆盖修改:ziniao-cli api /superbrowser/rest/v2/erp/staff/modify --data '{...}'。
- 通用 api 覆盖启用/禁用/删除:ziniao-cli api /superbrowser/rest/v1/erp/staff/status --data '{"staffIds":["xxx"],"status":"1"}'。
- 通用 api 覆盖调岗:ziniao-cli api /superbrowser/rest/v1/erp/staff/department --data '{"staffIds":["xxx"],"departmentIds":["yyy"]}'。
适用边界 · 注意事项
- 未安装、无法调用或未认证 ziniao-cli 的环境不适用。
- 没有紫鸟员工管理 API 权限/账号时,不能执行这些操作。
- 非紫鸟员工管理场景不适用。