⚙️ System 系统配置与状态

系统级配置查询、用户体验/试用模式管理,以及用户资源使用量统计。

接口列表

GET/api/system/public-config
✅ 无需认证 · 公开接口

说明:获取系统的公开配置信息,包括登录页公告、版本信息等。

响应

{
  "config": {
    "announcement": "欢迎使用...",    // 登录页公告(可选)
    "version": "1.0.0",              // 系统版本号
    "min_app_version": "1.0.0"       // 最低支持的 App 版本(可选)
  }
}

用户体验管理

开启或关闭当前用户的试用模式。试用模式下用户可无限制使用公共 AI 功能。

GET/api/system/user-status
✅ 需要认证(Bearer Token)

说明:查询当前用户在系统层级的特殊状态标记。

响应

{
  "is_public_ai_enabled": true   // 是否启用公共 AI
}
POST/api/system/enable-trial
✅ 需要认证(Bearer Token)

说明:开启当前用户的试用/体验模式,通常放宽公共 AI 使用限制。

请求体:无

响应{"success": true, "message": "试用已开启"}

POST/api/system/disable-trial
✅ 需要认证(Bearer Token)

说明:关闭当前用户的试用/体验模式,恢复正常用户权限。

请求体:无

响应{"success": true, "message": "试用已关闭"}


资源使用量查询

GET/api/system/usage
✅ 需要认证(Bearer Token)

说明:获取当前用户在系统层级的资源使用情况,包括每日 Token 消耗配额等。

响应

{
  "daily_tokens_used": 12345,          // 今日已用 Token
  "daily_tokens_limit": 50000,         // 每日 Token 上限
  "subscription_plan": "free"          // 当前订阅计划
}