用途:查询与管理 JeecgBoot 系统主数据(角色、用户、部门、字典、岗位、审批角色、租户等),面向流程设计、表单设计、代码生成等需要引用主数据的场景。
前置条件:需提供 JeecgBoot 后端地址与 X-Access-Token(从浏览器 F12 的 Network 请求头复制)。
核心原则:先查后建。任何 skill 使用主数据时应先查询已有数据,确认不存在后再创建。角色、字典支持一站式 find_or_create_*;用户、部门、职务只查不建。
使用方式:脚本位于 scripts/system_creator.py(通用命令行)与 scripts/system_utils.py(工具库)。命令行示例:python "$SCRIPT" --api-base $API --token $TOKEN --action query-roles --keyword 经理;也支持 --config master_data.json 批量查找/创建,并可用 --output result.json 保存结果。工具库可 import 后调用 init_api、query_roles、find_role、find_or_create_role、query_users、find_user、query_depts、find_dept、query_dict、search_dict、find_dict、find_or_create_dict、query_sql_table_dict、add_users_to_role、find_or_create_approval_role 等函数,其他 skill 脚本也可引用。
典型场景:为流程审批人配置角色编码(candidateGroups)、为表单下拉字段配置字典、查询用户与部门用于审批配置。
限制:需有效登录令牌;分类字典创建禁止传 code(后端按层级生成,若返回不含 code 需主动查询);部分接口尚未封装,可自行调用。具体收费、价格及平台范围资料暂未提供。