From d3082d5c64b1fcd9da22c792db6c41f29cd95be2 Mon Sep 17 00:00:00 2001 From: xfy Date: Mon, 22 Jun 2026 14:18:36 +0800 Subject: [PATCH] refactor(comment): share relative-time bucketing between server and client MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 提取相对时间分档逻辑,服务端与前端共享同一份实现 - comment_storage.rs 新增 relative_label_from_millis / format_relative_time_iso: 按 delta 毫秒分档(刚刚/N 分钟前/N 小时前/N 天前/超过 30 天显示日期), 返回 (相对文本, 绝对日期 YYYY-MM-DD);解析失败兜底为空串/刚刚,不 panic - helpers.rs 的 format_relative_time 重构为调用共享函数,消除服务端预渲染 与前端实时计算两份分档逻辑的口径漂移风险 - 补充 8 个单元测试覆盖各分档边界与异常输入 测试: cargo test relative (18 passed) --- src/api/comments/helpers.rs | 19 ++---- src/hooks/comment_storage.rs | 126 +++++++++++++++++++++++++++++++++++ 2 files changed, 132 insertions(+), 13 deletions(-) diff --git a/src/api/comments/helpers.rs b/src/api/comments/helpers.rs index a484a6a..d8933bd 100644 --- a/src/api/comments/helpers.rs +++ b/src/api/comments/helpers.rs @@ -78,22 +78,15 @@ pub fn row_to_admin_comment(row: &tokio_postgres::Row) -> AdminComment { } /// 将 UTC 时间格式化为相对时间（刚刚 / N 分钟前 / N 小时前 / N 天前 / 日期）。 +/// +/// 分档规则与前端 `crate::hooks::comment_storage::relative_label_from_millis` 完全一致， +/// 通过共享分档函数保证服务端预渲染与前端实时计算的口径统一。 #[cfg(feature = "server")] pub fn format_relative_time(dt: chrono::DateTime) -> String { let now = chrono::Utc::now(); - let diff = now.signed_duration_since(dt); - - if diff.num_seconds() < 60 { - "刚刚".to_string() - } else if diff.num_minutes() < 60 { - format!("{} 分钟前", diff.num_minutes()) - } else if diff.num_hours() < 24 { - format!("{} 小时前", diff.num_hours()) - } else if diff.num_days() < 30 { - format!("{} 天前", diff.num_days()) - } else { - dt.format("%Y-%m-%d").to_string() - } + let delta_millis = now.signed_duration_since(dt).num_milliseconds(); + let iso = dt.to_rfc3339(); + crate::hooks::comment_storage::relative_label_from_millis(delta_millis, &iso).0 } /// 校验评论作者昵称：非空且不超过 50 字符。 diff --git a/src/hooks/comment_storage.rs b/src/hooks/comment_storage.rs index aaa2eb0..226a87c 100644 --- a/src/hooks/comment_storage.rs +++ b/src/hooks/comment_storage.rs @@ -235,6 +235,59 @@ fn load_all_pending() -> PendingMap { serde_json::from_str(&json).unwrap_or_default() } +/// 相对时间分档：根据"距现在的毫秒数"返回 (相对文本, 绝对日期 YYYY-MM-DD)。 +/// +/// 分档规则与服务端 `format_relative_time` 完全一致，前端在展示待审核评论时复用， +/// 保证两类评论的时间展示口径统一。返回绝对日期用于 `title` 悬浮提示。 +/// +/// - `delta_millis`：目标时间与"现在"的差值（毫秒）。正值表示过去，负值表示未来（兜底按刚刚处理）。 +/// - `created_iso`：评论的 RFC3339 创建时间，用于兜底生成绝对日期。 +pub fn relative_label_from_millis(delta_millis: i64, created_iso: &str) -> (String, String) { + let seconds = delta_millis / 1000; + + let label = if seconds < 60 { + "刚刚".to_string() + } else { + let minutes = seconds / 60; + if minutes < 60 { + format!("{} 分钟前", minutes) + } else { + let hours = minutes / 60; + if hours < 24 { + format!("{} 小时前", hours) + } else { + let days = hours / 24; + if days < 30 { + format!("{} 天前", days) + } else { + // 超过 30 天直接显示日期，下方 absolute 复用 + String::new() + } + } + } + }; + + // 绝对日期：优先解析 ISO；解析失败时退化为空串，避免组件报错。 + let absolute = DateTime::parse_from_rfc3339(created_iso) + .map(|dt| dt.format("%Y-%m-%d").to_string()) + .unwrap_or_default(); + + let label = if label.is_empty() { absolute.clone() } else { label }; + (label, absolute) +} + +/// 前端友好的相对时间格式化：返回相对文本，用于展示待审核评论的创建时间。 +/// +/// 这是 `relative_label_from_millis` 的薄封装，仅返回相对文本。 +pub fn format_relative_time_iso(created_iso: &str) -> String { + // 解析失败时退化为 "刚刚"，避免组件崩溃。 + let Ok(dt) = DateTime::parse_from_rfc3339(created_iso) else { + return "刚刚".to_string(); + }; + let delta_millis = now_millis() - dt.timestamp_millis(); + relative_label_from_millis(delta_millis, created_iso).0 +} + /// HTML 转义辅助函数。 pub(crate) fn escape_html(input: &str) -> String { input @@ -250,3 +303,76 @@ pub fn render_pending_content(md: &str) -> String { let escaped = escape_html(md); escaped.replace('\n', "
") } + +#[cfg(test)] +mod tests { + use super::*; + + const ISO: &str = "2026-06-22T05:43:57.565+00:00"; + + #[test] + fn relative_label_just_now_under_60s() { + let (label, _) = relative_label_from_millis(0, ISO); + assert_eq!(label, "刚刚"); + let (label, _) = relative_label_from_millis(59_999, ISO); + assert_eq!(label, "刚刚"); + } + + #[test] + fn relative_label_minutes() { + let (label, _) = relative_label_from_millis(60_000, ISO); + assert_eq!(label, "1 分钟前"); + let (label, _) = relative_label_from_millis(5 * 60_000, ISO); + assert_eq!(label, "5 分钟前"); + let (label, _) = relative_label_from_millis(59 * 60_000, ISO); + assert_eq!(label, "59 分钟前"); + } + + #[test] + fn relative_label_hours() { + let (label, _) = relative_label_from_millis(60 * 60_000, ISO); + assert_eq!(label, "1 小时前"); + let (label, _) = relative_label_from_millis(3 * 3600_000, ISO); + assert_eq!(label, "3 小时前"); + let (label, _) = relative_label_from_millis(23 * 3600_000, ISO); + assert_eq!(label, "23 小时前"); + } + + #[test] + fn relative_label_days() { + let (label, _) = relative_label_from_millis(24 * 3600_000, ISO); + assert_eq!(label, "1 天前"); + let (label, _) = relative_label_from_millis(7 * 24 * 3600_000, ISO); + assert_eq!(label, "7 天前"); + let (label, _) = relative_label_from_millis(29 * 24 * 3600_000, ISO); + assert_eq!(label, "29 天前"); + } + + #[test] + fn relative_label_falls_back_to_date_over_30_days() { + let (label, absolute) = relative_label_from_millis(60 * 24 * 3600_000, ISO); + assert_eq!(label, "2026-06-22"); + assert_eq!(absolute, "2026-06-22"); + } + + #[test] + fn relative_label_future_falls_back_to_just_now() { + // 未来时间差为负，秒数 < 60，归为"刚刚"。 + let (label, _) = relative_label_from_millis(-5_000, ISO); + assert_eq!(label, "刚刚"); + } + + #[test] + fn relative_label_invalid_iso_still_returns_absolute_empty() { + // 无法解析时 absolute 为空，但分档逻辑仍按 delta 决定。 + let (label, absolute) = relative_label_from_millis(0, "not-a-date"); + assert_eq!(label, "刚刚"); + assert_eq!(absolute, ""); + } + + #[test] + fn format_relative_time_iso_invalid_iso_falls_back() { + // 解析失败退化为"刚刚"，不 panic。 + assert_eq!(format_relative_time_iso("not-a-date"), "刚刚"); + } +}