核心功能

• 进程树 — WMI 查询父子关系，树状展示所有进程及子进程，默认折叠，点击展开
• 实时流量 — 全局网络带宽 + TCP/UDP 连接数按比例分配，显示每个进程的上下行速度与累计流量
• 防火墙控制 — 5 级联网权限：🚫临时禁止 / ♾永久禁止 / ⬆仅上传 / ⬇仅下载 / ✅允许全部
• 4 种排序 — 上传速度 ↓ / 下载速度 ↓ / 上传总量 ↓ / 下载总量 ↓
• 进程图标 — System.Drawing 提取 exe 原生图标
• Hosts 编辑器 — 一键打开系统 hosts 文件
• Material Design 3 — 完整的 M3 色彩 Token 系统、组件样式、深色/浅色切换动画
• 单文件 exe — dotnet publish -p:PublishSingleFile=true 打包为独立可执行文件

下载运行

从 publish/ 目录获取 WindowsNetworkManager.exe（约 44MB），右键 以管理员身份运行。

编译

1
# Linux（交叉编译为 Windows exe）
2
./build.sh
3

4
# Windows
5
BuildAndPublish.bat
6

7
# 手动
8
dotnet publish src/WindowsNetworkManager.csproj \
9
    -c Release -r win-x64 --self-contained true \
10
    -p:PublishSingleFile=true -o publish

2.1 框架切换

2.2 修改

• Program.cs: 新增 Avalonia 应用启动入口
• App.axaml/.axaml.cs: FluentTheme 代替自定义主题，RequestedThemeVariant 切换暗色/亮色
• MainWindow.axaml/.axaml.cs: 重写 XAML（Avalonia 语法），自定义窗口边框、列表控件
• Converters/Converters.cs: 改用 Avalonia.Data.Converters.IValueConverter 接口
• ViewModels/MainViewModel.cs: Dispatcher.UIThread.InvokeAsync 替代 WPF Dispatcher
• 移除 Themes 目录 — FluentTheme 内置暗色/亮色

2.3 编译错误修复

根因分析

GetPerTcpConnectionEStats 需要通过 SetPerTcpConnectionEStats 先启用 TCP 扩展统计（ESTATS）数据收集，否则返回总是 0。

第一版修复（ESTATS 启用方案）

• Native/IpHelper.cs:
  • 新增 TCP_ESTATS_DATA_RW_v0 结构体（EnableCollection 字段）
  • 新增 SetPerTcpConnectionEStats P/Invoke
  • 新增 EnableTcpEstats() 方法：为指定连接启用数据统计
• Services/NetworkMonitorService.cs:
  • 新增 _enabledEndpoints HashSet 跟踪已启用的连接
  • CollectCurrentStats() 中首次遇到新连接时调用 EnableTcpEstats()

第二版修复（放弃 ESTATS，换用 NetworkInterface）

原因: ESTATS 在不同 Windows 版本/配置下兼容性差，即使启用也可能失败。

新方案:

• 使用 System.Net.NetworkInformation.NetworkInterface.GetIPv4Statistics() 获取全局网络流量
• 比较前后两次 poll 的差值得到每秒全局带宽
• 通过 GetExtendedTcpTable 获取各进程的活跃 TCP 连接数
• 按连接数比例将全局带宽分配到各进程

1
double ratio = (double)procConnections / totalConnections;
2
long upBps = (long)(globalUploadBps * ratio);
3
long dnBps = (long)(globalDownloadBps * ratio);

优点: 可靠、跨版本兼容、无需启用 ESTATS。

4.1 永久禁用联网

• Models/Models.cs: 新增 NetworkPermission.PermanentBlocked 枚举值
• Services/FirewallService.cs:
  • 新增 PermanentPrefix = "WNetMgr_Permanent_"
  • SetProcessPermission(): PermanentBlocked 使用永久前缀创建防火墙规则
  • CleanupAllRules(): 只清理临时规则（WNetMgr_*），跳过永久规则（WNetMgr_Permanent_*）
  • 新增 CleanupPermanentRules(): 清理所有永久规则
• ViewModels/MainViewModel.cs: 新增 PermanentBlockCommand（♾ 按钮）
• ViewModels/ProcessNodeViewModel.cs: PermanentBlocked → “永久禁止” 文本
• Converters/Converters.cs: PermanentBlocked → 紫色 #6750A4
• MainWindow.axaml: 新增 ♾ 永久禁止按钮

4.2 Hosts 文件编辑器

• Services/HostsFileService.cs (新文件):
  • ReadHosts() / WriteHosts(): 读写系统 hosts 文件
  • OpenInExternalEditor(): 用记事本打开 hosts 文件
  • BlockDomain() / UnblockDomain(): 添加/移除 127.0.0.1 domain #WNetMgr 条目
• ViewModels/MainViewModel.cs: 新增 OpenHostsEditorCommand
• MainWindow.axaml: 工具栏新增 📝Hosts 按钮

5.1 ListBox 选择阴影乱跳

根因: ApplySortAndFilter() 中 Processes.Clear() + Add() 重建集合，导致 ListBox 选择状态 lost → 随机重映射。

修复: 将 ListBox 替换为 ItemsControl（无选择行为），禁用所有 selection 样式。

5.2 按钮尺寸不一致

根因: 工具栏按钮和权限按钮使用不同的 Width/Height/Padding。

修复: 定义 Button.ActionBtn 样式（28x28 + CornerRadius=8），所有联网控制按钮使用统一样式类。

6.1 设计参考

基于 m3.material.io 规范实现。

6.2 Color Token 系统

定义 13 个 M3 颜色 token，在 App.SetTheme() 中按亮色/暗色分别设置：

6.3 组件样式

6.4 Surface 层次

1
窗口 → M3_Surface (CornerRadius=16)
2
├── Top App Bar → M3_SurfaceLow
3
├── Toolbar → M3_SurfaceLow
4
├── Column Headers → M3_SurfaceLow
5
├── Process List → M3_Surface
6
└── Bottom Bar → M3_SurfaceLow

6.5 布局规范

• 行高: 48px（单行列表）
• 内边距: 16px（Toolbar/Headers）、12px（Button padding）
• 间距: 8px（组件间距）、12px（大间距）
• 圆角: 8px（Chip）、16px（窗口）、20px（按钮）、28px（搜索框）

7.1 无法调整窗口大小 / 最大化 / 最小化

根因:

1. ExtendClientAreaChromeHints="NoChrome" 完全禁用了系统级 resize 边框
2. 标题栏上存在一个透明的 Panel 覆盖层捕获 PointerPressed，阻挡了下层 Button 的点击事件

修复:

• NoChrome → SystemChrome，启用系统绘制的 resize handles
• 去掉独立 Panel 层，将 PointerPressed="OnTitleBarPressed" 直接放到 Top App Bar 的 Border 上
• 标题 TextBlock 添加 IsHitTestVisible="False"，避免拦截拖拽手势

7.2 按钮文本偏上

根因: M3 按钮样式（M3Filled/M3Tonal/M3Chip/M3Segmented）缺少 VerticalContentAlignment。

修复: 所有 M3 按钮 Style 统一添加 VerticalContentAlignment="Center"。

7.3 联网控制按钮右侧被截断

根因: Chip 按钮带文字标签（”🚫 禁止”/”♾ 永久”等）总宽度远超列宽 250px。

修复:

• Chip 按钮改回纯图标（🚫/♾/⬆/⬇/✅），由 ToolTip 说明功能
• 窗口宽度: 1100px → 1200px
• 联网控制列宽: 250px → 380px

7.4 进程列表数据乱跳

根因:

1. OnNetworkStatsUpdated 每秒调用 ApplySortAndFilter() → Processes.Clear() + Add() 重建整个列表
2. 排序值变化时，同一进程可能在不同轮次处于不同位置，导致视觉抖动

修复:

1
// 旧：全量重建
2
Processes.Clear();
3
foreach (var item in sortedList)
4
    Processes.Add(item);
5

6
// 新：增量更新
7
for (int i = Processes.Count - 1; i >= 0; i--)
8
    if (!targetList.Contains(Processes[i]))
9
        Processes.RemoveAt(i);
10

11
for (int i = 0; i < targetList.Count; i++)
12
{
13
    int curIdx = Processes.IndexOf(targetList[i]);
14
    if (curIdx < 0)
15
        Processes.Insert(i, targetList[i]);
16
    else if (curIdx != i)
17
        Processes.Move(curIdx, i);
18
}

8.1 网络数据再次全部为 0

根因: 只枚举 IPv4 TCP 连接，现代 Windows 大部分流量走 IPv6。当 pidConns 为空时，无任何进程能分配到全局带宽。

修复 (Services/NetworkMonitorService.cs, Native/IpHelper.cs):

8.2 速度/总量列文字参差不齐

根因: 列内文本 HorizontalAlignment="Center"，不同数字宽度不一致（“0 B/s” vs “123.4 KB/s”）导致列间不对齐。

修复: 上传速度、下载速度、上传总量、下载总量四列改为 HorizontalAlignment="Right" + Margin="0,0,12,0"，表头同步右对齐。

8.3 进程图标 → 提取 exe 原生图标

实现 (Services/IconService.cs):

• 新增 System.Drawing.Common 依赖
• Icon.ExtractAssociatedIcon(path) → Bitmap → MemoryStream(PNG) → AvaloniaBitmap
• ConcurrentDictionary 缓存已提取图标，Null 时降级为权限色圆圈
• ProcessNodeViewModel.Icon 绑定到 XAML <Image Source="{Binding Icon}"/>

8.4 深色/浅色切换动画

实现 (MainWindow.axaml + .axaml.cs):

• 窗口顶层添加 ThemeOverlay Border（IsHitTestVisible="False", ZIndex=999）
• 切换时 Opacity 0→0.2 (120ms) → 0.0 (180ms)，CancellationTokenSource 防止重复动画
• 覆盖层 Background="{DynamicResource M3_OnSurface}" 产生短暂暗/亮闪烁感

8.5 子进程默认折叠 + 展开按钮修复

8.6 搜索框布局修复

根因: DockPanel 在 Avalonia 中子元素布局异常，TextBox 被压缩到左上角。

修复: 改为 Grid 三列（🔍 | TextBox | ✕），Border 显式设 Height="40" 对齐工具栏行高。

8.7 hover 闪烁

修复: M3Filled/M3Tonal 按钮 ContentPresenter 添加 DoubleTransition(Opacity, 0.12s) 平滑过渡。

最后更新: 2026-07-31 (Phase 8)