diff --git a/src/api/posts/search.rs b/src/api/posts/search.rs
index 7a7b3f0..50ac5aa 100644
--- a/src/api/posts/search.rs
+++ b/src/api/posts/search.rs
@@ -20,7 +20,7 @@ use crate::db::pool::get_conn;
 /// 搜索已发布文章。
 ///
 /// 空查询直接返回空结果；非空查询使用 `word_similarity` 计算相关度，
-/// 并限制返回 50 条记录。当前未缓存，每次均查询数据库。
+/// 并限制返回 50 条记录。结果写入短 TTL 内存缓存以减轻 DB 压力。
 #[server(SearchPosts, "/api")]
 pub async fn search_posts(query: String) -> Result<PostListResponse, ServerFnError> {
     #[cfg(feature = "server")]
diff --git a/src/cache.rs b/src/cache.rs
index 098898d..4c190dd 100644
--- a/src/cache.rs
+++ b/src/cache.rs
@@ -1,7 +1,7 @@
 //! 基于 moka 的内存缓存层。
 //!
-//! 仅在启用 `server` feature 时编译，为文章列表、标签、单篇文章、统计信息
-//! 以及评论相关数据提供按键缓存与失效能力。
+//! 仅在启用 `server` feature 时编译，为文章列表、标签、单篇文章、统计信息、
+//! 评论、会话用户以及搜索结果提供按键缓存与失效能力。
 //! 缓存使用 `std::sync::LazyLock` 全局实例，按不同业务数据设置独立的 TTL。
 
 #[cfg(feature = "server")]
@@ -420,6 +420,9 @@ pub async fn set_search_results(query: &str, posts: Vec<PostListItem>, total: i6
 }
 
 /// 清空所有搜索结果缓存。
+///
+/// 使用同步签名是因为 `moka::Cache::invalidate_all` 为同步操作；
+/// 该函数通常由写路径直接调用，无需额外等待。
 #[cfg(feature = "server")]
 pub fn invalidate_search_results() {
     SEARCH_CACHE.invalidate_all();