李校来了管理后台助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_2ef0f23f/lxll12 这个技能。
技能介绍
机构教务经常需要在管理后台里跨多个页面导出训练记录、排课表和学员账户信息。一旦涉及充值、退费或排课变更,纯靠人工点击容易漏项,也难以在操作前掌握完整对象清单和选项。李校来了管理助手 面向管理员和教务,把只读查询、系统导出、写操作确认与事后复查打包成可执行的 Skill。
核心能力
- 凭据会话与授权校验:管理员在当前会话中提供机构账号和密码;服务端按付费授权名单和到期日 fail-closed 校验,未授权时不进入登录,也不做任何查询或导出。登录后 accessToken 会缓存在
~/.lxll_sessions/,后续子命令复用,避免重复登录。 - 只读查询与官方导出:训练服务记录走
POST /s/export→GET /s/export-status→/s/download的系统链路,不用 API 原始数据拼 CSV。学员、订单、交易、陪练候选等列表可拉取;导出为中文表头由csv_cn.py转换,包含字段中文映射、epoch 毫秒转北京时间、枚举转中文、布尔转“是/否”,并丢弃权限标记和内部 ID。未映射字段由 stderr 提示后需补入FIELD_CN / VALUE_CN。 - 写操作三闸门:约课、取消约课、充值、退费、新增用户默认不执行。执行前先调用只读接口拿到完整对象与可选项,再把对象、时间、数量、类型、金额、付款方式、事由等全量列出给管理员确认;明确回复“确认/执行”后才提交写请求,提交后立即复查最新数据。
- 写操作密码授权:后端返回
code=10021时先执行POST /s/grant,用登录密码换取授权。脚本会把 grant 和写请求绑定在同一 accessToken 会话,处理过期重试。教练课时(QUOTA_ACCOMPANY/ 陪练权益)的充值与退减不进交易流水表,复查应以GET /s/student?id={id}的 account 余额变化为准。
工程边界与注意
默认是只读,写接口不允许测试,只能在真实业务明确指示后执行。管理员命令用 python3 scripts/lxll_api.py --account <账号> --password <密码>,也可使用 --config 指向含凭据的 JSON。可选辅助脚本包括 recharge_options.py、teacher_options.py、split_by_student_month.py。项目按中心实例隔离,不写死账号;授权失败统一提示 未授权,不能使用。如需开通,请添加联系微信:li13570269251。
使用场景
- 教务要导出训练服务记录作为月度审计附件,需要走系统官方导出链并拿到完整 CSV。
- 管理员准备给指定学员充值,需要先读取充值规则全量选项,再列出金额和方式等待确认。
- 排课前需要核对学生、教材、教练和时段是否冲突,确认无误后才提交约课。
- 退课后需要退减余额,必须确认可退类型和余额上限,并复查更新后的账户数据。
适合人员
- 机构管理员,需要用自己账号登录后台并处理充值、退费、新增用户等业务。
- 教务或排课负责人,需要导出训练记录、查询学员和教师选项,并完成排课确认。
- 财务核对人员,需要查看余额变化和交易数据,确认充值与退费是否正确落账。
- 运营支持人员,需要按中心隔离运行脚本接口,向管理员合规索要凭据并执行确认后的写操作。