diff --git a/docs/architecture.md b/docs/architecture.md index b2c764e..2d8aeb2 100644 --- a/docs/architecture.md +++ b/docs/architecture.md @@ -82,7 +82,7 @@ - `GET /healthz` — 健康检查(返回版本号) - `POST /api/auth/register` / `login` / `verify` / `resend-code` / `forgot-password` / `reset-password` / `change-password` - `GET /api/me` — 当前用户 -- `POST/GET /api/api-keys` + `PATCH/DELETE /api/api-keys/:id` — 分发 key 生成 / 列表 / 改名 / 撤销 +- `POST/GET /api/api-keys` + `PATCH/DELETE /api/api-keys/:id` — 分发 key 生成 / 列表 / 改名与启停(PATCH 的 `status: active|paused`)/ 撤销(软删,不可逆) - `GET /api/models` — 模型列表(含可用 key 与价格) - `POST /v1/chat/completions` / `/v1/responses` / `/anthropic/v1/messages` — 网关(非流式 + SSE) - `GET /api/wallet` / `/api/transactions` / `/api/dashboard` — 钱包 / 交易(summary + 明细)/ 仪表盘 diff --git a/src/dao.rs b/src/dao.rs index da5567b..d727e57 100644 --- a/src/dao.rs +++ b/src/dao.rs @@ -43,7 +43,33 @@ pub fn find_user_by_email(conn: &Connection, email: &str) -> Option<(i64, String .ok() } +/// API Key 的两个「仍在用户手里」的状态(rant 2026-11-12T14:13:23)。 +/// +/// 取值只有这三个,全仓的写入点也只有三个:两处 INSERT 写 [`KEY_STATUS_ACTIVE`]、 +/// [`revoke_api_key`] 写 `revoked`、[`set_api_key_status`] 在 active ↔ paused 之间切。 +/// `revoked` 刻意**不在** [`LIVE_KEY_STATUSES`] 里:软删是终态,没有任何路径把它写回来。 +pub const KEY_STATUS_ACTIVE: &str = "active"; +pub const KEY_STATUS_PAUSED: &str = "paused"; +pub const LIVE_KEY_STATUSES: [&str; 2] = [KEY_STATUS_ACTIVE, KEY_STATUS_PAUSED]; + +/// `status IN ('active','paused')` —— 由 [`LIVE_KEY_STATUSES`] 渲染,不手抄第二份。 +/// +/// 三条守卫(列表 / 改名 / 启停 / 软删)全部取自这里:状态集若有第四种值要进来, +/// 改一处就够;分散写死的后果是某个入口悄悄落后于其余入口(`revoked` 的可见性就是例子)。 +fn live_status_sql() -> String { + let list = LIVE_KEY_STATUSES + .iter() + .map(|s| format!("'{s}'")) + .collect::>() + .join(","); + format!("status IN ({list})") +} + /// 取该用户的「有效」API Key;没有则生成一个(登录即返回可用的 key) +/// +/// ⚠️ 只认 [`KEY_STATUS_ACTIVE`]:暂停的 key 不接管「登录即返回可用 key」这条路。 +/// 这也正是暂停必须**拒绝作用于当前会话那把 key** 的原因(见 `routes::api_keys::patch`)—— +/// 若真的把用户最后一把 active key 暂停掉,这里会另发一把新 key,那次暂停就只是换了个 key。 pub fn get_or_create_api_key(conn: &Connection, user_id: i64) -> Result { let existing: Option = conn .query_row( @@ -73,13 +99,15 @@ pub fn create_api_key(conn: &Connection, user_id: i64, name: &str) -> Result Result> { - let mut stmt = conn.prepare( + let mut stmt = conn.prepare(&format!( "SELECT id, key_value, name, status, created_at, last_used FROM api_keys \ - WHERE user_id = ?1 AND status = 'active' ORDER BY id DESC", - )?; + WHERE user_id = ?1 AND {} ORDER BY id DESC", + live_status_sql() + ))?; let rows = stmt.query_map([user_id], |r| { let raw: String = r.get(1)?; let created_at: String = r.get(4)?; @@ -101,19 +129,54 @@ pub fn list_api_keys(conn: &Connection, user_id: i64) -> Result Result { let n = conn.execute( - "UPDATE api_keys SET name = ?1 WHERE id = ?2 AND user_id = ?3 AND status = 'active'", + &format!( + "UPDATE api_keys SET name = ?1 WHERE id = ?2 AND user_id = ?3 AND {}", + live_status_sql() + ), rusqlite::params![name, key_id, user_id], )?; Ok(n == 1) } +/// 启停 API Key(rant 2026-11-12T14:13:23):active ↔ paused,仅属主、仅未撤销的行。 +/// +/// 取值本身由调用方按 [`LIVE_KEY_STATUSES`] 校验(路由层),这里再断言一次: +/// 这个函数是 `status` 的第二个写入点,写进第三种值就等于绕过整条可见性口径。 +pub fn set_api_key_status( + conn: &Connection, + user_id: i64, + key_id: i64, + status: &str, +) -> Result { + debug_assert!( + LIVE_KEY_STATUSES.contains(&status), + "set_api_key_status 只接受 {LIVE_KEY_STATUSES:?},收到 {status:?}" + ); + let n = conn.execute( + &format!( + "UPDATE api_keys SET status = ?1 WHERE id = ?2 AND user_id = ?3 AND {}", + live_status_sql() + ), + rusqlite::params![status, key_id, user_id], + )?; + Ok(n == 1) +} + /// 软删 API Key(P2-B:status → 'revoked');仅属主可删;返回是否删除成功 +/// +/// 守卫从 `status = 'active'` 放宽到 `live_status_sql()`(rant 2026-11-12T14:13:23): +/// 暂停中的行也在列表里,列表里就带着「删除」按钮 —— 删不掉才是缺陷。 +/// `revoked` 仍然是终态:本函数是唯一写它的地方,而它自己不再接受已撤销的行。 pub fn revoke_api_key(conn: &Connection, user_id: i64, key_id: i64) -> Result { let n = conn.execute( - "UPDATE api_keys SET status = 'revoked' WHERE id = ?1 AND user_id = ?2 AND status = 'active'", + &format!( + "UPDATE api_keys SET status = 'revoked' WHERE id = ?1 AND user_id = ?2 AND {}", + live_status_sql() + ), rusqlite::params![key_id, user_id], )?; Ok(n == 1) diff --git a/src/i18n_pack.rs b/src/i18n_pack.rs index 03c1cee..814d5c6 100644 --- a/src/i18n_pack.rs +++ b/src/i18n_pack.rs @@ -74,8 +74,8 @@ const ERR_MAP_END: &str = "\n ];"; /// 这两个数把「提取器静默失真」与「后端/词表真的变了」区分开:语料被判空时, /// 「每条中文都在词表里」会**恒真**——这正是 C2106 坑 245(提取器返回空字典 ⇒ /// 「0 处漂移」的假绿)。 -const ERR_MAP_ENTRY_COUNT: usize = 52; -const BACKEND_ERROR_CJK_COUNT: usize = 48; +const ERR_MAP_ENTRY_COUNT: usize = 54; +const BACKEND_ERROR_CJK_COUNT: usize = 51; /// 语言包区段的起止标记。 /// @@ -108,12 +108,12 @@ const EN_END: &str = "\n };"; /// /// ⚠️ `T_LITERAL_COUNT` 是 `T("…")` **调用点**总数,不是键数,也不是去重后的键数 —— /// 三个集合各不相同(坑 99);说「这个数不该变」之前先确认它在数哪个集合。 -const ZH_KEY_COUNT: usize = 802; -const EN_KEY_COUNT: usize = 802; +const ZH_KEY_COUNT: usize = 811; +const EN_KEY_COUNT: usize = 811; const STATIC_ATTR_COUNT: usize = 336; const STATIC_ATTR_DISTINCT: usize = 310; -const T_LITERAL_COUNT: usize = 552; -const T_LITERAL_DISTINCT: usize = 435; +const T_LITERAL_COUNT: usize = 556; +const T_LITERAL_DISTINCT: usize = 438; /// 切出语言包区段(起点标记 → 终点标记,含起点)。 fn pack_region<'a>(src: &'a str, start_mark: &str, end_mark: &str) -> &'a str { @@ -2691,7 +2691,7 @@ mod tests { /// 两者都数**站点**(不是去重后的文案):`READABLE` 是提取器读得到的值, /// `STRUCTURED` 是按设计不进语料的结构化信封。新增一条错误文案就是在改这两个数 —— /// 这正是它们的作用:它们证明扫描器没有变瞎,而不是证明语料静止。 - const READABLE_ERROR_WRITE_SITES: usize = 95; + const READABLE_ERROR_WRITE_SITES: usize = 97; const STRUCTURED_ERROR_WRITE_SITES: usize = 2; /// **每一处**错误文案站点的值都必须是提取器读得到的写法。 diff --git a/src/routes/api_keys.rs b/src/routes/api_keys.rs index 8691fad..4dcff08 100644 --- a/src/routes/api_keys.rs +++ b/src/routes/api_keys.rs @@ -3,12 +3,16 @@ //! - P0-A(rant 2026-08-17T22:21:52):POST 生成(atk_live_ + 24 hex);GET 列表(脱敏) //! - P2-B(rant 2026-08-18T12:02:40):DELETE /api/api-keys/:id 软删(status → 'revoked'),仅属主 //! - P2-C(rant 2026-08-22T17:21:39):POST 接收 {name} 持久化;PATCH /api/api-keys/:id 改名,仅属主 +//! - 启停(rant 2026-11-12T14:13:23):PATCH 同一入口也接受 `{status: active|paused}` —— +//! 「临时停一下、过后开回来」不必再走不可逆的软删。取值集合取自 `dao::LIVE_KEY_STATUSES`。 use axum::extract::{Path, State}; +use axum::http::StatusCode; use axum::Json; use serde::Deserialize; use crate::auth; +use crate::dao::{self, KEY_STATUS_PAUSED, LIVE_KEY_STATUSES}; use crate::routes::{internal, ApiErr, AppState, AuthUser}; /// POST /api/api-keys 请求体;name 缺省为空串(前端留空 → 「未命名」) @@ -18,10 +22,23 @@ pub struct CreateKeyReq { pub name: String, } -/// PATCH /api/api-keys/:id 请求体 +/// PATCH /api/api-keys/:id 请求体:改名与启停**同一入口**(P2-C + rant 2026-11-12T14:13:23)。 +/// +/// 两个字段都可省略,但至少要有一个 —— 两个都不给是客户端写错了,不是「什么都不用改」。 #[derive(Deserialize)] -pub struct RenameKeyReq { - pub name: String, +pub struct PatchKeyReq { + #[serde(default)] + pub name: Option, + #[serde(default)] + pub status: Option, +} + +/// 不存在 / 非属主 / 已撤销 → 同一个 404(不区分「不是你的」与「不存在」,也就不泄露 id 是否存在) +fn key_not_found() -> ApiErr { + ( + StatusCode::NOT_FOUND, + Json(serde_json::json!({ "error": "API Key 不存在或已撤销" })), + ) } /// POST /api/api-keys @@ -31,54 +48,154 @@ pub async fn create( Json(req): Json, ) -> Result, ApiErr> { let conn = st.db.lock().map_err(|_| internal("db lock poisoned"))?; - let key = crate::dao::create_api_key(&conn, auth.user_id, &req.name).map_err(internal)?; + let key = dao::create_api_key(&conn, auth.user_id, &req.name).map_err(internal)?; Ok(Json(serde_json::json!({ "api_key": key, "masked": auth::mask_api_key(&key), }))) } -/// PATCH /api/api-keys/:id(改名持久化;非属主 / 不存在 / 已撤销 → 404) -pub async fn rename( +/// PATCH /api/api-keys/:id —— 改名(P2-C)与启停(rant 2026-11-12T14:13:23)。 +/// +/// 非属主 / 不存在 / 已撤销 → 404。 +/// +/// ⚠️ **不能暂停「当前登录用的那把 key」**(下面那条守卫)。这不是保守,是这个架构逼出来的: +/// API Key 同时是**会话凭据** —— `AuthUser` 提取器就靠它认证,而 `dao::find_api_key_user_and_id` +/// 只认 `active`(rant 明确要求鉴权不动)。于是暂停自己那把 = 这次会话立刻失效;重新登录时 +/// `get_or_create_api_key` 找不到 active 行,会**另发一把新 key** ⇒ 那次暂停什么也没停住, +/// 而这正是 rant 点名要堵的洞。反过来若让它不发新 key,用户就再也进不来、那一行也就再也恢复不了。 +/// 两条出口都是坏的,所以取第三条:拒绝,并把原因说清楚(前端据 `current` 标记先置灰按钮)。 +pub async fn patch( State(st): State, auth: AuthUser, Path(id): Path, - Json(req): Json, + Json(req): Json, ) -> Result, ApiErr> { - let conn = st.db.lock().map_err(|_| internal("db lock poisoned"))?; - let ok = crate::dao::rename_api_key(&conn, auth.user_id, id, &req.name).map_err(internal)?; - if !ok { + if req.name.is_none() && req.status.is_none() { return Err(( - axum::http::StatusCode::NOT_FOUND, - Json(serde_json::json!({ "error": "API Key 不存在或已撤销" })), + StatusCode::BAD_REQUEST, + Json(serde_json::json!({ "error": "参数错误" })), )); } - Ok(Json(serde_json::json!({ "id": id, "name": req.name }))) + if let Some(status) = req.status.as_deref() { + if !LIVE_KEY_STATUSES.contains(&status) { + return Err(( + StatusCode::BAD_REQUEST, + // 值必须写成**字面量**:`i18n_pack::every_error_key_site_has_a_readable_write_form` + // 只认「可读的写入形态」,调用表达式会让这条文案整条逃过词表门禁(en 界面上 + // 就成了中文)。两个可取值的对账放在 `the_status_400_names_every_accepted_value`。 + Json(serde_json::json!({ "error": "status 必须为 active 或 paused" })), + )); + } + // 那把 key 既是「要停的东西」又是「正在用它说话的身份」—— 见上面的长注释。 + if status == KEY_STATUS_PAUSED && id == auth.api_key_id { + return Err(( + StatusCode::BAD_REQUEST, + Json(serde_json::json!({ + "error": "当前登录用的就是这个 key,不能暂停它自己" + })), + )); + } + } + let conn = st.db.lock().map_err(|_| internal("db lock poisoned"))?; + // 顺序:先改名(只动 name),再启停。任一守卫不通过都回 404;**已改的部分不回滚** —— + // 两个字段各是一次 UPDATE,响应里带的是真实的 name/status,不谎报「全都成了」。 + if let Some(name) = req.name.as_ref() { + if !dao::rename_api_key(&conn, auth.user_id, id, name).map_err(internal)? { + return Err(key_not_found()); + } + } + let mut status = None; + if let Some(next) = req.status.as_deref() { + if !dao::set_api_key_status(&conn, auth.user_id, id, next).map_err(internal)? { + return Err(key_not_found()); + } + status = Some(next); + } + let name = match req.name { + Some(name) => Some(name), + None => conn + .query_row( + "SELECT name FROM api_keys WHERE id = ?1 AND user_id = ?2", + rusqlite::params![id, auth.user_id], + |r| r.get::<_, String>(0), + ) + .ok(), + }; + Ok(Json(serde_json::json!({ + "id": id, + "name": name, + "status": status, + }))) } /// GET /api/api-keys(脱敏列表) +/// +/// 每行多一个 `current`(rant 2026-11-12T14:13:23):「这行就是当前会话用的 key」由**服务端** +/// 标记,前端不靠猜 —— 设置页据此把那一行的暂停按钮置灰,而不是等用户点了才吃一个 400。 pub async fn list( State(st): State, auth: AuthUser, ) -> Result>, ApiErr> { - let conn = st.db.lock().map_err(|_| internal("db lock poisoned"))?; - let keys = crate::dao::list_api_keys(&conn, auth.user_id).map_err(internal)?; + let mut keys = { + let conn = st.db.lock().map_err(|_| internal("db lock poisoned"))?; + dao::list_api_keys(&conn, auth.user_id).map_err(internal)? + }; + for k in keys.iter_mut() { + if let Some(obj) = k.as_object_mut() { + let id = obj.get("id").and_then(|v| v.as_i64()); + obj.insert( + "current".to_string(), + serde_json::Value::Bool(id == Some(auth.api_key_id)), + ); + } + } Ok(Json(keys)) } -/// DELETE /api/api-keys/:id(软删;非属主 / 不存在 → 404) +/// DELETE /api/api-keys/:id(软删;非属主 / 不存在 / 已撤销 → 404) pub async fn remove( State(st): State, auth: AuthUser, Path(id): Path, ) -> Result, ApiErr> { let conn = st.db.lock().map_err(|_| internal("db lock poisoned"))?; - let ok = crate::dao::revoke_api_key(&conn, auth.user_id, id).map_err(internal)?; + let ok = dao::revoke_api_key(&conn, auth.user_id, id).map_err(internal)?; if !ok { - return Err(( - axum::http::StatusCode::NOT_FOUND, - Json(serde_json::json!({ "error": "API Key 不存在或已撤销" })), - )); + return Err(key_not_found()); } Ok(Json(serde_json::json!({ "id": id, "status": "revoked" }))) } + +#[cfg(test)] +mod tests { + use super::*; + + /// 非法 `status` 的文案必须点名**每一个**被接受的取值。 + /// + /// 文案本身是字面量(词表门禁只认字面量),所以这里也**从源码里取那句话**,而不是在测试 + /// 里再抄一份:将来加第三种可切换状态却忘了改文案时,这条先红。 + #[test] + fn the_status_400_names_every_accepted_value() { + const SRC: &str = include_str!("api_keys.rs"); + let line = SRC + .lines() + .find(|l| l.contains("\"error\": \"status 必须为")) + .expect("非法 status 的 400 文案没找到 —— 它必须写成字面量"); + let rest = &line[line.find("\"error\": \"").unwrap() + "\"error\": \"".len()..]; + let msg = &rest[..rest.find('"').unwrap()]; + for s in LIVE_KEY_STATUSES { + assert!(msg.contains(s), "400 文案没有点名可接受的取值 {s:?}:{msg}"); + } + assert!(!msg.contains("revoked"), "撤销不是可接受的目标状态:{msg}"); + } + + /// 状态集本身:`revoked` 不在可切换集合里(软删是终态)。 + #[test] + fn live_statuses_are_active_and_paused_only() { + assert_eq!( + LIVE_KEY_STATUSES, + [dao::KEY_STATUS_ACTIVE, dao::KEY_STATUS_PAUSED] + ); + } +} diff --git a/src/routes/mod.rs b/src/routes/mod.rs index 01fe696..61833b4 100644 --- a/src/routes/mod.rs +++ b/src/routes/mod.rs @@ -678,7 +678,7 @@ pub fn router() -> Router { .route("/api/api-keys", post(api_keys::create).get(api_keys::list)) .route( "/api/api-keys/:id", - axum::routing::delete(api_keys::remove).patch(api_keys::rename), + axum::routing::delete(api_keys::remove).patch(api_keys::patch), ) // 网关三条:请求体可能很大(长上下文 / 多模态),放宽到 GATEWAY_BODY_LIMIT。 .route( @@ -1073,6 +1073,221 @@ mod tests { assert_eq!(s, StatusCode::NOT_FOUND, "已撤销 key 改名应 404"); } + /// rant 2026-11-12T14:13:23 验收①②:暂停 = 立即停服,但那一行**仍留在列表里**、可一键恢复。 + /// + /// 没有这条修复时(`status` 只有 active/revoked、PATCH 只认 name):`{"status":"paused"}` + /// 会被 serde 忽略 ⇒ 200 且 key 照旧通过鉴权 ⇒ 下面「暂停后 401」那一条先红。 + #[tokio::test] + async fn api_key_pause_stops_the_key_and_resume_brings_it_back() { + let st = test_state("keypause"); + let demo_bearer = login_bearer(&st, "demo@aitokenpool.local", "demo1234").await; + // 第二把 key:登录凭据那把不能暂停自己(下一用例),所以拿它来暂停 + let (s, body) = post( + st.clone(), + "/api/api-keys", + r#"{"name":"工具 key"}"#, + Some(&demo_bearer), + ) + .await; + assert_eq!(s, StatusCode::OK, "生成 key 应 200: {body}"); + let tool_key = serde_json::from_str::(&body).unwrap()["api_key"] + .as_str() + .unwrap() + .to_string(); + let (_, body) = get(st.clone(), "/api/api-keys", Some(&demo_bearer)).await; + let arr: Vec = serde_json::from_str(&body).unwrap(); + let row = arr + .iter() + .find(|k| k["full_key"] == tool_key.as_str()) + .expect("列表里应有刚生成的 key"); + let tool_id = row["id"].as_i64().unwrap(); + assert_eq!(row["status"], "active"); + assert_eq!(row["current"], false, "只有会话那把 key 才标 current"); + // 前置:这把 key 本来能认证 + let (s, _) = get(st.clone(), "/api/api-keys", Some(&tool_key)).await; + assert_eq!(s, StatusCode::OK); + // 暂停 + let (s, body) = patch( + st.clone(), + &format!("/api/api-keys/{tool_id}"), + r#"{"status":"paused"}"#, + Some(&demo_bearer), + ) + .await; + assert_eq!(s, StatusCode::OK, "暂停应 200: {body}"); + assert_eq!( + serde_json::from_str::(&body).unwrap()["status"], + "paused" + ); + // ① 暂停后该 key 的请求立即被拒(鉴权仍只认 active) + let (s, _) = get(st.clone(), "/api/api-keys", Some(&tool_key)).await; + assert_eq!( + s, + StatusCode::UNAUTHORIZED, + "暂停的 key 不该再通过 Bearer 鉴权" + ); + // ② 该行不因暂停而从列表消失(否则没有恢复入口) + let (_, body) = get(st.clone(), "/api/api-keys", Some(&demo_bearer)).await; + let arr: Vec = serde_json::from_str(&body).unwrap(); + let row = arr + .iter() + .find(|k| k["id"] == tool_id) + .expect("暂停后该行仍应在列表里"); + assert_eq!(row["status"], "paused"); + // 暂停中的 key 仍可改名(它还在用户手里) + let (s, _) = patch( + st.clone(), + &format!("/api/api-keys/{tool_id}"), + r#"{"name":"改过名"}"#, + Some(&demo_bearer), + ) + .await; + assert_eq!(s, StatusCode::OK, "暂停中的 key 应可改名"); + // 恢复 → 同一把 key 立即可用 + let (s, _) = patch( + st.clone(), + &format!("/api/api-keys/{tool_id}"), + r#"{"status":"active"}"#, + Some(&demo_bearer), + ) + .await; + assert_eq!(s, StatusCode::OK); + let (s, _) = get(st.clone(), "/api/api-keys", Some(&tool_key)).await; + assert_eq!(s, StatusCode::OK, "恢复后同一把 key 应立即重新可用"); + // 列表里就带着「删除」按钮 ⇒ 暂停中的行也必须删得掉 + let (s, _) = patch( + st.clone(), + &format!("/api/api-keys/{tool_id}"), + r#"{"status":"paused"}"#, + Some(&demo_bearer), + ) + .await; + assert_eq!(s, StatusCode::OK); + let (s, _) = del( + st.clone(), + &format!("/api/api-keys/{tool_id}"), + Some(&demo_bearer), + ) + .await; + assert_eq!(s, StatusCode::OK, "暂停中的 key 应可撤销"); + } + + /// rant 2026-11-12T14:13:23 里那个洞:**暂停自己那把 key 等于没暂停**。 + /// + /// 没有守卫时:PATCH 暂停成功 → 这次会话立刻失效 → 重新登录时 `get_or_create_api_key` + /// 找不到 active 行 ⇒ 另发一把新 key,那次暂停什么也没停住。所以守卫在入口处拒绝, + /// 并且这里顺手钉住「登录不会因此冒出第二把 key」。 + #[tokio::test] + async fn api_key_cannot_pause_the_key_it_is_signed_in_with() { + let st = test_state("keyselfpause"); + let demo_bearer = login_bearer(&st, "demo@aitokenpool.local", "demo1234").await; + let (_, body) = get(st.clone(), "/api/api-keys", Some(&demo_bearer)).await; + let arr: Vec = serde_json::from_str(&body).unwrap(); + let row = arr + .iter() + .find(|k| k["current"] == true) + .expect("列表必须标出当前会话用的那把 key"); + let id = row["id"].as_i64().unwrap(); + let (s, body) = patch( + st.clone(), + &format!("/api/api-keys/{id}"), + r#"{"status":"paused"}"#, + Some(&demo_bearer), + ) + .await; + assert_eq!(s, StatusCode::BAD_REQUEST, "暂停自己应被拒绝: {body}"); + // 被拒之后这把 key 依然可用、状态仍是 active + let (s, body) = get(st.clone(), "/api/api-keys", Some(&demo_bearer)).await; + assert_eq!(s, StatusCode::OK); + let arr: Vec = serde_json::from_str(&body).unwrap(); + assert_eq!( + arr.iter().find(|k| k["id"] == id).unwrap()["status"], + "active" + ); + // 洞本身:重新登录拿到的是**同一把** key,不会因为暂停尝试而多出一把 + let (s, body) = post( + st.clone(), + "/api/auth/login", + r#"{"email":"demo@aitokenpool.local","password":"demo1234"}"#, + None, + ) + .await; + assert_eq!(s, StatusCode::OK, "{body}"); + assert_eq!( + serde_json::from_str::(&body).unwrap()["api_key"] + .as_str() + .unwrap(), + demo_bearer, + "登录不应因为一次暂停尝试就另发一把 key" + ); + } + + /// 可接受的目标状态只有 `active` / `paused`;`revoked` 是终态,写不回来。 + #[tokio::test] + async fn api_key_status_rejects_values_outside_the_live_pair() { + let st = test_state("keystatusbad"); + let demo_bearer = login_bearer(&st, "demo@aitokenpool.local", "demo1234").await; + let (_, body) = post( + st.clone(), + "/api/api-keys", + r#"{"name":"x"}"#, + Some(&demo_bearer), + ) + .await; + let key = serde_json::from_str::(&body).unwrap()["api_key"] + .as_str() + .unwrap() + .to_string(); + let (_, body) = get(st.clone(), "/api/api-keys", Some(&demo_bearer)).await; + let arr: Vec = serde_json::from_str(&body).unwrap(); + let id = arr.iter().find(|k| k["full_key"] == key.as_str()).unwrap()["id"] + .as_i64() + .unwrap(); + for bad in ["revoked", "off", "on", "ACTIVE", ""] { + let (s, body) = patch( + st.clone(), + &format!("/api/api-keys/{id}"), + &format!(r#"{{"status":"{bad}"}}"#), + Some(&demo_bearer), + ) + .await; + assert_eq!(s, StatusCode::BAD_REQUEST, "status={bad:?} 应 400: {body}"); + // 文案必须点名两个可接受取值(由 `dao::LIVE_KEY_STATUSES` 渲染) + let msg = serde_json::from_str::(&body).unwrap()["error"] + .as_str() + .unwrap() + .to_string(); + for ok in crate::dao::LIVE_KEY_STATUSES { + assert!(msg.contains(ok), "400 文案漏了 {ok:?}: {msg}"); + } + } + // 两个字段都不给 → 400(不是「什么都不用改」) + let (s, _) = patch( + st.clone(), + &format!("/api/api-keys/{id}"), + "{}", + Some(&demo_bearer), + ) + .await; + assert_eq!(s, StatusCode::BAD_REQUEST); + // 撤销是终态:撤销后任何 status 都写不回来 + let (s, _) = del( + st.clone(), + &format!("/api/api-keys/{id}"), + Some(&demo_bearer), + ) + .await; + assert_eq!(s, StatusCode::OK); + let (s, _) = patch( + st.clone(), + &format!("/api/api-keys/{id}"), + r#"{"status":"active"}"#, + Some(&demo_bearer), + ) + .await; + assert_eq!(s, StatusCode::NOT_FOUND, "已撤销的 key 不能被恢复"); + } + /// 登录并返回 Bearer async fn login_bearer(st: &AppState, email: &str, password: &str) -> String { let (s, body) = post( diff --git a/ui/README.md b/ui/README.md index 20d329f..b3fa13e 100644 --- a/ui/README.md +++ b/ui/README.md @@ -54,7 +54,7 @@ python3 -m http.server 8000 --directory ui 3. 共享管理 Sharing — 默认只显示统计 + 我的共享列表(key 脱敏展示,可**编辑**(复用同一张行内表单 `#share-form-card`,打开即预填该行当前值)/ 暂停 / 恢复 / 重新上架 / 彻底删除;列表展示「厂商 · Plan / 模型 · 可用时间段」,如「智谱 · GLM Coding Plan / glm-5.2 · 周一~周五 09:00-18:00」,未设置显示「全天」);点击"+ 添加 / 上架新 key"展开上架表单(**三级联动:厂商 → Plan → 模型**——内置已知 Plan 清单(阿里云百炼 / 智谱 / 火山方舟 / Kimi / MiniMax / DeepSeek / OpenAI / Anthropic / Google Gemini / xAI,每家含「API(按量)」= 按量计价的 key),选 Plan 后显示 Plan 类型(按量 / 订阅);**可用时间段为结构化字段**:星期多选 chips + 起止时间(留空 = 全天不限),备注仅纯文本;须填 API Key,平台加密托管;分享者只填声明额度,单价由平台按模型定价自动计算并展示参考价),提交成功或取消后自动收起 4. 钱包 Wallet — 点数余额、**本月点数变化(近 1 月按类型汇总收支 + 净变化,与仪表盘一致)**、**充值入口(US-4:模拟流程——输入点数 → 余额增加 → topup 交易记录;文案注明"演示,真实支付后续接入";提现仍 disabled)**、**申请加额(US-20:企业成员余额低时申请更多点数 → 提交后等待管理员审批,默认需审批)**;收支明细已去重,统一到【交易记录】(页内提供跳转提示) 5. 交易记录 Transactions — 消费/收益/充值/提现/赠送/过期(gift / expiry)唯一明细入口,Tab 筛选 + MRT 风格表格(列排序/列筛选/分页,与 Tab 叠加生效) -6. 设置 Settings — 账户、**API Key 管理(独占整行全宽,表格字段不挤压;完整增删改查:生成带名字、改名、删除需确认「删除后该 key 立即失效」、按名字搜索(防抖+高亮+清空,v1.18 D)、一键复制完整 key——列表脱敏展示 atk_live_****xxxx,复制为完整值;file:// 下 clipboard API 受限时降级为选中+Ctrl/Cmd+C)**、通知、偏好 +6. 设置 Settings — 账户、**API Key 管理(独占整行全宽,表格字段不挤压;完整增删改查:生成带名字、改名、**暂停/恢复**(暂停即停止服务、该行仍留在列表里可随时恢复;**当前登录用的那把 key 不能暂停**——它同时是会话凭据,按钮置灰并给出理由)、删除需确认「删除后该 key 立即失效」、按名字搜索(防抖+高亮+清空,v1.18 D)、一键复制完整 key——列表脱敏展示 atk_live_****xxxx,复制为完整值;file:// 下 clipboard API 受限时降级为选中+Ctrl/Cmd+C)**、通知、偏好 7. 管理视图 Admin(管理员角色专属)— 成员管理(改部门:下拉可选部门或"未分配";任意金额充值,正整数校验;新注册成员默认未分配部门;**加额申请审批(US-20:待审批列表 → 批准=成员余额+申请点数 / 驳回;申请默认需审批)**)、用量报表(按模型/成员)、组织管理(部门列表 + 部门增删改查 + 每月点数分配,含部门汇总统计,未分配成员不计入任何部门;**部门搜索(防抖+高亮+清空,v1.18 D)**;**添加/编辑部门用行内展开表单(`#dept-form-card`,名称+月分配,替代 window.prompt)**,删除有确认;**无「组织设置」表单**——组织名称 / 默认成员配额 / 开关均移除,"关闭外部注册"为部署配置项不在 UI 中)、模型管理(模型列表——厂商 / 模型 / 价格 / 上下文 / 读图——的增删改查即时生效,但只在本进程内有效(`config.toml` 的 `[[models]]` 是权威来源,改价与新增会在下次启动被 config 覆盖 / 删除);添加 / 编辑用行内展开表单 `#model-form-card`;删除某模型后,仍指向它的 key 无法计价)。**无独立 Key 池管理**——管理员与普通用户一样通过共享管理页「上架 key」配置上游 key(共享列表即 key 池视图,可暂停/删除) 8. 运营视图 Operator(运营者角色专属)— 平台运营(运营者 = 宿主本人,职责最小化:① 运行概览——运行状态 / 用户数 / 共享 key 数 / 交易量 / 点数流入流出;② 用户充值——按用户名 / 邮箱**搜索(防抖+高亮+清空,v1.18 D)**定位,输入点数金额(可为小数)确认后余额增加永久有效点数并产生一条交易记录) diff --git a/ui/index.html b/ui/index.html index 33f1e8b..5076d31 100644 --- a/ui/index.html +++ b/ui/index.html @@ -867,7 +867,7 @@

使用模型

- - + + diff --git a/ui/js/app.js b/ui/js/app.js index 0a10dd3..7e91242 100644 --- a/ui/js/app.js +++ b/ui/js/app.js @@ -2573,6 +2573,8 @@ created: fmtPrecise(k.created_at).slice(0, 10), last: k.last_used || null, // rant 2026-08-24T12:41:25:真实最近使用时间(NULL=从未使用) status: k.status || "active", + // 后端 `GET /api/api-keys` 的 `current`:这行就是当前会话用的 key(暂停它 = 踢自己下线) + current: !!k.current, })); } else { list = []; @@ -2583,8 +2585,9 @@ "" + esc(Live.apiKeys ? k.key : "") + "" + "" + esc(k.created) + "" + "" + (k.last ? timeCell(k.last) : esc(T("settings.ak.last.never"))) + "" + - "" + (k.status === "active" ? '' + T("settings.ak.status.active") + "" : '' + esc(k.status || "—") + "") + "" + + "" + badge(k.status, AK_STATUS) + "" + " " + + keyToggleButton(k) + " " + "" ).join("") : emptyRow(6, T("settings.ak.empty"), T("settings.ak.empty.sub"), @@ -2748,6 +2751,52 @@ }); } + /* --- API Key 启停(rant 2026-11-12T14:13:23) --- */ + + // 两个状态的徽标与「下一个动作」逐状态列全(C2153 的同一课,见 SHARE_TOGGLE 的注释): + // 动作标签按**当前状态**取,而结局文案是**下一状态**的函数 —— 写成两值判别式 + //(`status === "active" ? "paused" : "active"`)的那一天,就会有一个状态被报成另一个状态的 + // 结局。后端只返回这两个值(`dao::LIVE_KEY_STATUSES`),`revoked` 不出现在列表里 ⇒ 没有 + // 第三条路径;未知状态由 `akToggle()` 返回 null,**不给按钮**而不是猜一个动作。 + const AK_STATUS = { + active: { text: () => T("settings.ak.status.active"), cls: "ok" }, + paused: { text: () => T("settings.ak.status.paused"), cls: "warn" }, + }; + const AK_TOGGLE = { + active: { label: "settings.ak.pause", next: "paused", outcome: "settings.ak.paused" }, + paused: { label: "settings.ak.resume", next: "active", outcome: "settings.ak.resumed" }, + }; + const akToggle = (status) => AK_TOGGLE[status] || null; + + // 行内启停按钮。当前会话那把 key(后端 `current` 标记)渲染成 disabled + 理由气泡:暂停它 + // 等于把自己踢下线,而重新登录会另发一把新 key ⇒ 那次暂停什么也没停住。服务端同样拒绝 + //(`routes::api_keys::patch`),前端先拦住只是不让人点出一个必然失败的请求。 + function keyToggleButton(k) { + const entry = akToggle(k.status); + if (!entry) return ""; + const style = "padding:4px 10px;font-size:12px"; + return k.current + ? " " + : " "; + } + + // 启停:动作 / 下一状态 / 结局取自**同一条目**,不做两值判别。 + function toggleKey(i) { + if (!Live.apiKeys) return; + const k = Live.apiKeys[i]; + if (!k) return; + const entry = akToggle(k.status || "active"); + if (!entry) return; + api.patch("/api/api-keys/" + k.id, { status: entry.next }).then(async () => { + await liveLoad("apiKeys", "/api/api-keys"); + renderSettings(); + toast(T(entry.outcome, { name: k.name || T("common.unnamed") }), "success"); + }).catch((err) => { + renderSettings(); // 失败重渲染:按钮与徽标回到服务端的真实状态 + toast((err && err.message) ? I18n.mapErr(err.message) : T("settings.ak.status.fail"), "error"); + }); + } + // API Key 改名:行内编辑(替代原生输入弹窗) function renameKey(i) { const k = Live.apiKeys ? Live.apiKeys[i] : null; @@ -4703,6 +4752,8 @@ if (cp) { copyKey(Number(cp.dataset.keyCopy)); return; } const rn = e.target.closest("[data-key-rename]"); if (rn) { renameKey(Number(rn.dataset.keyRename)); return; } + const tg = e.target.closest("[data-key-toggle]"); + if (tg) { toggleKey(Number(tg.dataset.keyToggle)); return; } const dl = e.target.closest("[data-key-del]"); if (dl) { confirmInline(dl, () => deleteKey(Number(dl.dataset.keyDel)), T("settings.ak.del.confirm")); return; } if (e.target.closest("[data-new-key]")) openNewKeyInline(); diff --git a/ui/js/i18n.js b/ui/js/i18n.js index f6c8dd9..113e067 100644 --- a/ui/js/i18n.js +++ b/ui/js/i18n.js @@ -452,6 +452,13 @@ "settings.ak.ok": "确认", "settings.ak.cancel": "取消", "settings.ak.status.active": "启用", + "settings.ak.status.paused": "已暂停", + "settings.ak.pause": "暂停", + "settings.ak.resume": "恢复", + "settings.ak.paused": "已暂停「{name}」—— 用它发起的调用会立即被拒", + "settings.ak.resumed": "已恢复「{name}」", + "settings.ak.status.fail": "启停失败", + "settings.ak.current.hint": "当前登录用的就是这个 key:暂停它会立刻把你踢下线,重新登录还会另发一把新 key", "settings.ak.last.never": "从未", "settings.ak.empty": "还没有 API Key", "settings.ak.empty.sub": "生成一个 key,用于本地工具 / 代码接入平台", @@ -804,6 +811,8 @@ "err.opsRequired": "需要运营者权限", "err.authRequired": "需要登录", "err.keyNotFound": "API Key 不存在或已失效", + "err.keyStatusInvalid": "key 状态只能是启用或暂停", + "err.keyIsSession": "当前登录用的 key 不能暂停", "err.rateLimit": "请求过于频繁", "err.invalidParam": "参数错误", "err.notFound": "资源不存在", @@ -1285,6 +1294,13 @@ "settings.ak.ok": "OK", "settings.ak.cancel": "Cancel", "settings.ak.status.active": "Active", + "settings.ak.status.paused": "Paused", + "settings.ak.pause": "Pause", + "settings.ak.resume": "Resume", + "settings.ak.paused": "Paused “{name}” — calls with this key are rejected immediately", + "settings.ak.resumed": "Resumed “{name}”", + "settings.ak.status.fail": "Could not change the key status", + "settings.ak.current.hint": "This is the key you are signed in with: pausing it would sign you out, and signing in again issues a new key", "settings.ak.last.never": "Never", "settings.ak.empty": "No API keys yet", "settings.ak.empty.sub": "Generate a key to access the platform from local tools / code", @@ -1626,6 +1642,8 @@ "err.opsRequired": "Operator permission required", "err.authRequired": "Authentication required", "err.keyNotFound": "API Key does not exist or has been revoked", + "err.keyStatusInvalid": "A key can only be active or paused", + "err.keyIsSession": "The key you are signed in with cannot be paused", "err.rateLimit": "Too many requests", "err.invalidParam": "Invalid parameters", "err.notFound": "Resource not found", @@ -1732,6 +1750,10 @@ ["部门下还有", "err.deptNotEmpty"], ["amount 必须为正整数", "err.amountPositiveInt"], ["status 必须为 paused / on / off", "err.shareStatusInvalid"], + // rant 2026-11-12T14:13:23:api key 启停的两条 400 文案(前者由 `LIVE_KEY_STATUSES` + // 渲染,mapErr 是**子串**匹配 ⇒ 取稳定前缀即可命中)。 + ["status 必须为", "err.keyStatusInvalid"], + ["当前登录用的就是这个 key", "err.keyIsSession"], ["currency 仅支持 USD | CNY", "err.currencyUnsupported"], ["vision 仅支持 0 | 1", "err.visionUnsupported"], ["amount 必须大于 0", "err.amountPositive"],