用户套餐
当前用户套餐、用量和升级。
查询用户升级包列表
分页查询已购买的用户升级包，按记录 ID 降序返回。可按用户 ID、升级包 ID 或用户套餐 ID 筛选。默认第 1 页、每页 10 条；`limit=0` 时不分页。响应中的 `count` 为筛选后的总数。业务参数错误仍返回 HTTP 200，请依据 `code` 判断结果。
新增用户升级包
为指定用户的指定套餐新增一个升级包记录。uid、package_up、user_package 与 amount 均为必填；user_package 必须属于该 uid，且同一用户、升级包和用户套餐的组合不能重复。业务校验失败仍使用 HTTP 200，请依据响应中的 code 和 msg 判断结果。
删除用户升级包
删除一个或多个用户升级包记录。路径参数可使用英文逗号分隔多个记录 ID；每条记录必须存在，否则返回业务错误 `user_package_up2-1`。业务错误仍使用 HTTP 200，请依据响应中的 `code` 和 `msg` 判断结果。
获取用户升级包详情
根据用户升级包记录 ID 获取完整记录。记录不存在时返回业务错误 user_package_up2-2；业务错误仍使用 HTTP 200，请依据响应中的 code 和 msg 判断结果。
更新用户升级包数量
更新指定用户升级包记录的 amount。路径中的 package_up_id 决定更新目标，请求体无需传 id。amount 为必填数字；新值必须与原值不同，否则返回 user_package_up2-20。请求体中的 uid、package_up、user_package 如传入仅会执行关联对象校验，不会修改记录关联关系。业务错误仍使用 HTTP 200，请依据响应中的 code 和 msg 判断结果。
批量更新用户套餐
更新一个或多个已有用户套餐。请求体可为单个对象或对象数组；每项必须包含用户套餐 id。所有其他字段均为可选，未传时保持原值。传 package 会触发套餐变更流程；传 duration 会执行续费/购买时长计算；调整套餐资源配额、价格、启用状态等敏感字段需要管理员权限。业务错误仍使用 HTTP 200，请依据响应中的 code 和 msg 判断结果。