diff --git a/crates/app-iced/src/pages/content/parts/filters.rs b/crates/app-iced/src/pages/content/parts/filters.rs
index 6e1a9f7..93f1264 100644
--- a/crates/app-iced/src/pages/content/parts/filters.rs
+++ b/crates/app-iced/src/pages/content/parts/filters.rs
@@ -23,7 +23,11 @@ use super::{intent, sort_label};
 use crate::pages::frame;
 use crate::pages::Message as PageMessage;
 
-/// 来源 + 排序 + 版本 + 加载器四组 chip（一行放不下就换行，`row` 变 `column`）。
+/// 来源 + 排序 + 版本 + 加载器四组 chip（**每组一行**，组与组之间纵向排）。
+///
+/// 组内是一行 `row`（[`wrapped_row`]）：**不做自动换行**——屏幕太窄时 chip 会被裁掉，
+/// 而不是折到第二行（`row` 没有 wrap 能力）。这是既定行为，别把这条注释读成「会自动换行」；
+/// 宽度由列表列下限 424（[`super::layout::compact_min`]）兜住，正常窗口下不会撞到。
 pub(crate) fn filters<'a>(
     ui: &'a Ui,
     catalog: Catalog,