平台功能（自研）可视化配置
客户端管理
客户端（sys_client）决定「谁能以什么方式登录、签发的 Token 有效期多久」。后台、PC 用户端、H5、App 各自使用不同客户端。
字段
| 字段 | 说明 |
|---|---|
| 客户端 key | 登录请求中的 clientId，创建后不可修改 |
| 客户端密钥 | clientSecret，加密存储，可单独查看 |
| 授权类型 | 可多选：密码、短信、社交、号码认证等 |
| 设备类型 | pc / android / ios / miniApp 等 |
| Token 活跃超时 | 无操作多久后失效（秒） |
| Token 固定超时 | 无论是否活跃，最长多久失效（秒） |
| 状态 | 启用 / 停用 |
授权类型
以字典 sys_grant_type 为准，常见值：
| 值 | 说明 |
|---|---|
password | 账号密码 |
sms | 短信验证码 |
social | 第三方社交登录 |
phoneverify | 号码认证（手机号 + 短信验证码） |
refresh_token | 刷新 Token |
客户端的 grantTypeList 必须包含实际使用的登录方式，否则登录接口会拒绝。
设备类型
设备类型写入登录用户的 Token 元数据，影响：
- 在线用户列表的设备展示；
- 同一账号多端登录策略；
- Token 续期与踢人。
Token 超时
| 配置 | 作用 | 示例 |
|---|---|---|
activeTimeout | 活跃超时：一段时间无请求即失效 | 后台 1800 秒 |
timeout | 固定超时：从登录开始计算，到期必须重新登录 | 后台 43200 秒 |
两者都为空时使用全局 Sa-Token 配置。建议：
- 后台管理：活跃 30 分钟，固定 12 小时；
- C 端：活跃 7 天，固定 30 天；
- App：按业务安全等级调整。
内置客户端
平台初始化会创建后台与 C 端客户端。不要删除内置客户端，否则对应前端无法登录。需要区分环境时，新增客户端而不是改内置项。
与多端前端的关系
| 前端 | 建议客户端 |
|---|---|
| plus-ui 后台 | 后台客户端（设备 pc） |
| plus-c PC 用户端 | C 端 PC 客户端 |
| H5 | C 端 H5 客户端（设备 h5 或 pc） |
| App / 小程序 | 对应设备类型客户端 |
详见多端前端。
安全
clientSecret不应出现在前端源码、公开仓库或日志中。- 生产环境不要复用演示客户端密钥。
- 客户端停用后，已签发的 Token 不会立即失效；需要踢人时使用「在线用户 → 强制退出」。
排错
| 现象 | 原因 | 处理 |
|---|---|---|
| 登录报「无效的客户端」 | clientId 不存在或已停用 | 检查客户端 key 与状态 |
| 登录报「未授权的授权类型」 | grantTypeList 不含当前登录方式 | 补充授权类型 |
| 登录后很快掉线 | 活跃超时太短 | 调整 activeTimeout |
| 多端互相踢下线 | 设备类型相同 + 单端登录策略 | 为不同端配置不同设备类型 |