diff --git a/crates/app-iced/src/pages/appearance/mod.rs b/crates/app-iced/src/pages/appearance/mod.rs
index 0492f47..1d06014 100644
--- a/crates/app-iced/src/pages/appearance/mod.rs
+++ b/crates/app-iced/src/pages/appearance/mod.rs
@@ -41,7 +41,9 @@
 //! 每一处改动都打一行 [`state::State::log_line`]：`[appearance] window_alpha=… panel_alpha=…
 //! byte=… corner=…`；圆角另有一条独立管线，行形如
 //! `[corner] <ctx> corner=policy=system source=dwm os=10.0.26100 excluded_reason=none
-//! radius=system pref=2 readback=? read_hr=0x80070057 frame=popup layered=on`
+//! radius=system pref=2 readback=? read_hr=0x80070057 frame=overlapped layered=on
+//! suppressed_by=window_alpha`（真进程实跑的两条见 `DevDocs/artifacts/m116/README.md`；
+//! `frame=` 恒为 `overlapped`/`other`，**不会是 `popup`**）
 //! （见 `app::update::appearance` 与 `platform::win32::corner::format_line`）。数值是**下发前**的
 //! 字节/属性值（不是观感），因为在 RDP + 虚拟显示适配器上「看上去多透明 / 圆不圆」不可信。
 //! 截图矩阵用 `ULL_APPEARANCE_*` 环境变量灌值（见 [`state`] 的常量）。
diff --git a/crates/app-iced/src/platform/win32/transparency/dwm.rs b/crates/app-iced/src/platform/win32/transparency/dwm.rs
index 7b85d3d..3990bae 100644
--- a/crates/app-iced/src/platform/win32/transparency/dwm.rs
+++ b/crates/app-iced/src/platform/win32/transparency/dwm.rs
@@ -268,7 +268,8 @@ pub const fn layered_label(ex_style: isize) -> &'static str {
     }
 }
 
-/// 一个窗口的样式摘要（`frame=popup layered=on`）；读不到时如实写 `frame=? layered=?`。
+/// 一个窗口的样式摘要（`frame=overlapped layered=off`，产品真进程实测值）；读不到时如实写
+/// `frame=? layered=?`。「`frame=popup`」只会出现在**带 owner 的弹出窗**上，产品不会。
 #[must_use]
 pub fn style_summary(hwnd: isize) -> String {
     let frame = window_style(hwnd).map_or("?", frame_label);