docs: clarify developer tool filtering and module contracts

src/shell/developer_tools/network.rs

@@ -17,7 +17,7 @@ pub(super) fn build(
     let bottom = viewport.height - 22.0;
 
     p.fill(Rect::new(x, 32.0, w, 30.0), BAR);
-    // 水位后存在记录才允许 Clear，Action::ClearNetwork 更新工具水位并清除选择，不删除 Console 共用日志。
+    // 水位后存在记录才允许 Clear，不受当前筛选是否有匹配影响；动作更新水位并清除选择，不删除共享日志。
     p.enabled_button(
         Rect::new(x + 3.0, 32.0, 62.0, 29.0),
         "Clear",
@@ -116,7 +116,8 @@ pub(super) fn build(
     );
     // 只登记横向分隔条，父绘制入口最后覆盖绘制并注册 Split::Network 命中目标。
     p.split(Rect::new(x + 1.0, divider, w - 2.0, 1.0), Split::Network);
-    // 详情从完整保留记录中查找，因此筛选隐藏某行后可继续查看已选详情；记录淘汰后才回提示。
+    // 详情从完整保留记录中查找，不复用筛选结果或 network_after；筛选隐藏行后仍可查看。
+    // 正常 ClearNetwork 会另行清 selected_request，记录被容量淘汰后此处也找不到，才回到提示。
     let selected = records
         .iter()
         .find(|r| Some(r.id) == state.selected_request);