按 sso/docs/upstream-core-changes.md 评估后的采纳清单:
A1(强采纳):User 增加 `extra` flatten 透传通道,让插件字段不再污染内核模型
A1 配套:新增 `users::update_extra<T,F>`,与 set_allowed_models 同源
A2(修真 bug):state::split_value `position` → `rposition`(payload 含 0x1f
时被 position 截断;sso 已踩、rposition 取最后一个边界)
A3:state::iter_prefix_ex 返回 (key, payload, exp);iter_prefix 保留兼容包装
不采纳:A4(iPass 已具备大部分,plugin-sso 自实现)、A5(选选项 2 零代码)、
A6-1(破坏测试边界用例,iPass 内核最小约束,由插件加策略)、
A6-2(admin login 端点直接用 COOKIE_NAME)
262 项回归全绿(gateway 102 + llm 160)。
详见 docs/plugin/SSO_UPSTREAM_DECISIONS.md。
85 lines
3.1 KiB
Rust
85 lines
3.1 KiB
Rust
//! 持久化数据模型。
|
||
//!
|
||
//! 字段名与旧版 `data/users.json` / `data/domains.json` **逐字对应**,
|
||
//! 以便新版直接接管旧数据文件、且管理台前端无需改动。
|
||
|
||
use serde::{Deserialize, Serialize};
|
||
use serde_json::Value;
|
||
use std::collections::BTreeMap;
|
||
|
||
/// 账号表(`users.json`):以账号名为 key 的对象。
|
||
pub type UserTable = BTreeMap<String, User>;
|
||
|
||
/// 单个账号。
|
||
///
|
||
/// `temp_grant_until` 是「临时授权权限」的到期时间戳;> now 表示当前拥有
|
||
/// 该权限,申请临时域名时可跳过审核直接放行。
|
||
#[derive(Debug, Clone, Serialize, Deserialize)]
|
||
pub struct User {
|
||
pub username: String,
|
||
/// 中文姓名等展示名。**只用于展示**,不参与鉴权、不参与热路径查询。
|
||
///
|
||
/// `username` 规则是 ASCII(`valid_username`),中文名塞不进账号名,
|
||
/// 所以「吴桂荣」这类实名单独放这里;留空时前端回落到 `username`。
|
||
#[serde(default)]
|
||
pub display_name: String,
|
||
/// `admin` | `user`
|
||
pub role: String,
|
||
pub salt: String,
|
||
/// 迭代加盐 SHA-256
|
||
pub pwd_hash: String,
|
||
/// `sk_<48 位 hex>`。
|
||
///
|
||
/// LLM 代理与域名接口**共用这一把 Key**——这正是「用同一套 Key 验证」
|
||
/// 的落点,所以重置 Key 会同时影响两个入口。
|
||
pub api_key: String,
|
||
/// LLM 代理可用的上游 slot 白名单。空 = 不限。
|
||
///
|
||
/// 老数据没有该字段,`serde(default)` 反序列化得空表,语义正好是「不限」。
|
||
#[serde(default)]
|
||
pub allowed_models: Vec<String>,
|
||
/// LLM 每分钟请求上限。老数据缺省 → 全局默认(`LLM_RPM_DEFAULT`);0 = 不限
|
||
#[serde(default = "default_llm_rpm")]
|
||
pub llm_rpm: i64,
|
||
/// LLM 每日请求上限。老数据缺省 → 全局默认(`LLM_DAILY_DEFAULT`);0 = 不限
|
||
#[serde(default = "default_llm_daily")]
|
||
pub llm_daily: i64,
|
||
#[serde(default)]
|
||
pub temp_grant_until: i64,
|
||
#[serde(default)]
|
||
pub created_at: i64,
|
||
|
||
/// 插件字段透传:内核持有、**不解释**。
|
||
///
|
||
/// 反序列化时,文件中**未被上面字段认领的 key 自动进 `extra`**;序列化时
|
||
/// 展开回顶层(`#[serde(flatten)]`)。`serde` 优先匹配已认领字段,所以
|
||
/// 存量 `users.json`(含任何插件写入的字段)可原样接管,**不会因内核不
|
||
/// 认识而丢数据**——这是 iPass 向上游 sso 合流的扩展点(A1)。
|
||
///
|
||
/// 未来插件要存 TOTP 密钥、邮箱、用户组、锁定状态……都直接往 `extra`
|
||
/// 写,不再走内核加字段。修改走 [`crate::users::update_extra`] 的
|
||
/// 「读-改-写」原语。
|
||
#[serde(default, flatten)]
|
||
pub extra: BTreeMap<String, Value>,
|
||
}
|
||
|
||
impl User {
|
||
/// 是否拥有「临时授权权限」
|
||
pub fn has_temp_permission(&self, now: i64) -> bool {
|
||
self.temp_grant_until > now
|
||
}
|
||
|
||
pub fn is_admin(&self) -> bool {
|
||
self.role == "admin"
|
||
}
|
||
}
|
||
|
||
|
||
fn default_llm_rpm() -> i64 {
|
||
crate::config::LLM_RPM_DEFAULT
|
||
}
|
||
|
||
fn default_llm_daily() -> i64 {
|
||
crate::config::LLM_DAILY_DEFAULT
|
||
}
|