From 0f000828041c974902fd6f9ccfb6b25d27c99867 Mon Sep 17 00:00:00 2001 From: argszero Date: Thu, 12 Nov 2026 14:28:46 +0800 Subject: [PATCH] feat(api-keys): pause and resume a key instead of only revoking it MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A key used to be `active` or `revoked`, and revoking is terminal and drops the row from the list, so there was no way to stop a key temporarily and bring it back. Add `paused` (rant 2026-11-12T14:13:23, item 1). - dao: `LIVE_KEY_STATUSES` is the single source for the two switchable values; list / rename / revoke guards derive their SQL from it instead of each spelling the set. `revoked` stays terminal: no path writes it back. - PATCH /api/api-keys/:id accepts `status: active|paused` next to `name`. Invalid values are 400, and the message names every accepted one. - GET /api/api-keys marks the caller's own key with `current`. - Pausing the key the request is authenticated with is refused (400). That key is also the session credential, so pausing it would sign the caller out, and the next login would mint a fresh key over the pause — the pause would undo itself. Refusing is the only exit that is neither a lockout nor a no-op; the UI disables that one button and says why. - UI: badge + action come from one three-state map (the shape the sharing page already uses, C2153), and each row gets a pause/resume button. The previously unreachable non-active pill branch is now reachable. - docs/architecture.md and ui/README.md are updated with the new endpoint behaviour and the session-key restriction. --- docs/architecture.md | 2 +- src/dao.rs | 77 +++++++++++++-- src/i18n_pack.rs | 14 +-- src/routes/api_keys.rs | 159 ++++++++++++++++++++++++++---- src/routes/mod.rs | 217 ++++++++++++++++++++++++++++++++++++++++- ui/README.md | 2 +- ui/index.html | 4 +- ui/js/app.js | 53 +++++++++- ui/js/i18n.js | 22 +++++ 9 files changed, 509 insertions(+), 41 deletions(-) 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"],