feat: 新增 TCP 连接清单窗口

This commit is contained in:
2026-08-09 08:09:03 +08:00
parent 77e2276e99
commit 089a11207a
4 changed files with 566 additions and 1 deletions
+303
View File
@@ -0,0 +1,303 @@
// SPDX-FileCopyrightText: 2026 Jokul
//
// SPDX-License-Identifier: LGPL-3.0-or-later
// TCP 连接清单窗口:屏幕居中的独立顶层窗口,展示当前所有 ESTABLISHED 状态的
// TCP 连接详情(本地地址:端口、远程地址:端口、状态、进程名),数据来自 C++ 后端
// 解析 /proc/net/tcp 与 tcp6(含进程名反查)。
// 设计要点:
// - 视觉风格复用 TrafficStatsWindow.qml(圆角卡片 12px、1px 边框、44px 标题栏、
// 28x28 圆形关闭按钮 hover 淡红底);深/浅主题由 isDarkMode 切换
// (networkview.qml 依据 DockPalette 检测任务栏深浅后传入),默认浅色保证独立预览可用
// - 数据通过属性注入:applet 即 networkview.qml 的 root.applet(C++ 后端对象),
// applet.tcpConnectionList 为 QVariantList of QVariantMap,每项含
// {localAddress, localPort, remoteAddress, remotePort, state, processName},
// 为 null 时组件可独立预览(显示空状态)
// - 定时刷新:窗口可见时每 5 秒重建清单(与 C++ 后端降频周期一致),关闭时停止
// 触发方式:右键菜单"TCP 连接清单" -> show()/raise()/requestActivate()
// 公共能力复用:主题色取自 WindowTheme,标题栏(含关闭按钮)取自 TitleBar
import QtQuick 2.15
import QtQuick.Layouts 1.15
import QtQuick.Window 2.15
import "."
Window {
id: root
// 公共主题色:集中定义于 WindowTheme.qml,随 isDarkMode 切换深浅
WindowTheme {
id: theme
isDarkMode: root.isDarkMode
}
// 对外依赖:关闭按钮 hover 态文字高亮色,由父组件传入
// 默认值与 networkview.qml 中 root.accentRed 一致,确保独立可用
property color accentColor: Qt.rgba(220 / 255, 38 / 255, 38 / 255, 1)
// 对外依赖:C++ 后端对象(NetworkMonitorApplet),由 networkview.qml 传入
// 提供 tcpConnectionList(QVariantList of QVariantMap);为 null 时可独立预览(显示空状态)
property var applet: null
// 深色模式标记:由 networkview.qml 根据 DockPalette 检测后传入;
// 默认 false(浅色)保证组件独立预览时与原版视觉一致
property bool isDarkMode: false
// 表格模型:由 refreshModel() 生成的连接记录数组,每项
// {localAddress, localPort, remoteAddress, remotePort, state, processName}
property var connModel: []
// 当前连接总数,底部汇总与顶部状态条共用
property int connCount: 0
// 表格列宽:与表头/行/底部汇总共用同一组固定宽度,保证各列垂直对齐
readonly property int colLocal: 180
readonly property int colRemote: 180
readonly property int colState: 90
readonly property int colSpacing: 6
// 从 applet.tcpConnectionList 重建表格模型
// 设计原因:连接清单数量随时变化,每次读取重建数组供 ListView 展示;
// applet 为 null 时置空模型,保证独立预览可用
function refreshModel() {
var list = root.applet ? (root.applet.tcpConnectionList || []) : []
root.connModel = list
root.connCount = list.length
}
width: 680
height: 420
visible: false
flags: Qt.FramelessWindowHint | Qt.Window
modality: Qt.NonModal
color: "transparent"
onVisibleChanged: {
if (visible) {
// 居中到当前屏幕(任务栏所在屏幕),加 virtualX/virtualY 偏移
// 避免多显示器下窗口出现在非预期屏幕
x = Screen.virtualX + (Screen.width - width) / 2
y = Screen.virtualY + (Screen.height - height) / 2
// 窗口显示时立即刷新一次,确保数据最新
refreshModel()
}
}
// 定时刷新:窗口可见时每 5 秒重建清单(与 C++ 后端降频周期一致),
// 不依赖 C++ 信号;关闭时停止,兼顾实时性与性能
Timer {
interval: 5000
repeat: true
running: root.visible
onTriggered: refreshModel()
}
// 窗口主体:圆角卡片(背景与边框随 isDarkMode 切换深浅),1px 边框模拟 DTK 窗口描边
Rectangle {
anchors.fill: parent
color: theme.winBg
radius: 12
border.width: 1
border.color: theme.lineColor
ColumnLayout {
anchors.fill: parent
spacing: 0
// 公共标题栏:标题文字 + 关闭按钮,整栏可拖动
TitleBar {
Layout.fillWidth: true
titleText: qsTr("TCP Connections")
textColor: theme.textPrimary
secondaryTextColor: theme.textSecondary
closeHoverColor: root.accentColor
}
// 顶部状态条:当前连接数 + 刷新间隔说明
RowLayout {
Layout.fillWidth: true
Layout.preferredHeight: 34
Layout.leftMargin: 16
Layout.rightMargin: 16
spacing: 8
Text {
// 动态刷新连接总数,与底部汇总一致
text: qsTr("Active connections: ") + root.connCount
font.pixelSize: 12
font.weight: Font.Medium
color: theme.textPrimary
}
Item { Layout.fillWidth: true }
Text {
text: qsTr("Refreshes every 5 seconds")
font.pixelSize: 11
color: theme.textTertiary
}
}
// 表头行:本地地址:端口 | 远程地址:端口 | 状态 | 进程名
RowLayout {
Layout.fillWidth: true
Layout.leftMargin: 16
Layout.rightMargin: 16
Layout.topMargin: 2
spacing: root.colSpacing
Text {
Layout.preferredWidth: root.colLocal
text: qsTr("Local Address:Port")
font.pixelSize: 11
font.weight: Font.Bold
color: theme.textSecondary
}
Text {
Layout.preferredWidth: root.colRemote
text: qsTr("Remote Address:Port")
font.pixelSize: 11
font.weight: Font.Bold
color: theme.textSecondary
}
Text {
Layout.preferredWidth: root.colState
text: qsTr("State")
font.pixelSize: 11
font.weight: Font.Bold
color: theme.textSecondary
}
Text {
Layout.fillWidth: true
text: qsTr("Process")
font.pixelSize: 11
font.weight: Font.Bold
color: theme.textSecondary
}
}
// 表头与内容间的分隔线
Rectangle {
Layout.fillWidth: true
Layout.preferredHeight: 1
Layout.leftMargin: 16
Layout.rightMargin: 16
Layout.topMargin: 4
color: theme.lineColor
}
// 表格区:ListView 展示每条连接记录,行 hover 高亮
ListView {
Layout.fillWidth: true
Layout.fillHeight: true
Layout.leftMargin: 16
Layout.rightMargin: 16
Layout.topMargin: 2
Layout.bottomMargin: 2
clip: true
model: root.connModel
onCountChanged: emptyHint.visible = root.connModel.length === 0
// 空状态提示(当 connModel 为空时显示)
Item {
id: emptyHint
anchors.fill: parent
visible: root.connModel.length === 0
Text {
anchors.centerIn: parent
text: qsTr("No active TCP connections")
font.pixelSize: 13
color: theme.textTertiary
}
}
delegate: Rectangle {
required property int index
required property var modelData
width: ListView.view.width
height: 28
radius: 4
// 行 hover 高亮:浅色用淡黑、深色用淡白,保证两种卡片背景上均可见
color: rowMouse.containsMouse ? theme.hoverBg : "transparent"
RowLayout {
anchors.fill: parent
anchors.leftMargin: 8
anchors.rightMargin: 8
spacing: root.colSpacing
Text {
Layout.preferredWidth: root.colLocal
text: modelData.localAddress + ":" + modelData.localPort
font.pixelSize: 12
color: theme.textPrimary
elide: Text.ElideRight
}
Text {
Layout.preferredWidth: root.colRemote
text: modelData.remoteAddress + ":" + modelData.remotePort
font.pixelSize: 12
color: theme.textPrimary
elide: Text.ElideRight
}
Text {
Layout.preferredWidth: root.colState
text: modelData.state
font.pixelSize: 12
color: theme.textSecondary
elide: Text.ElideRight
}
Text {
Layout.fillWidth: true
// 进程名可能为空(反查失败),显示占位符避免空白行
text: modelData.processName.length > 0 ? modelData.processName : "-"
font.pixelSize: 12
color: modelData.processName.length > 0 ? theme.textPrimary : theme.textTertiary
elide: Text.ElideRight
}
}
MouseArea {
id: rowMouse
anchors.fill: parent
hoverEnabled: true
}
}
}
// 表头与底部汇总间的分隔线
Rectangle {
Layout.fillWidth: true
Layout.preferredHeight: 1
Layout.leftMargin: 16
Layout.rightMargin: 16
color: theme.lineColor
}
// 底部汇总行:连接总数
RowLayout {
Layout.fillWidth: true
Layout.preferredHeight: 34
Layout.leftMargin: 24
Layout.rightMargin: 16
spacing: root.colSpacing
Text {
Layout.fillWidth: true
text: qsTr("Total: ") + root.connCount + qsTr(" connections")
font.pixelSize: 12
font.weight: Font.Bold
color: theme.textPrimary
}
}
}
}
// 数据刷新:C++ 每 5 秒更新并发射 tcpConnectionListChanged,据此重建清单;
// 本窗口自身的 Timer 兜底,避免依赖信号时序
Connections {
target: root.applet
function onTcpConnectionListChanged() {
refreshModel()
}
}
}
+20
View File
@@ -384,6 +384,16 @@ AppletItem {
}
}
// TCP 连接清单:屏幕居中独立窗口,展示当前所有 ESTABLISHED 状态的 TCP 连接
Platform.MenuItem {
text: qsTr("TCP Connections")
onTriggered: {
tcpConnectionsWindow.show()
tcpConnectionsWindow.raise()
tcpConnectionsWindow.requestActivate()
}
}
Platform.MenuSeparator {}
Platform.MenuItem {
@@ -426,6 +436,16 @@ AppletItem {
isDarkMode: root.isDarkMode
}
// TCP 连接清单窗口:屏幕居中独立窗口,展示当前所有 ESTABLISHED 状态的 TCP 连接
// 依赖通过属性传入:accentColor = root.accentRed,applet = root.applet,
// isDarkMode 取自上方 DockPalette 检测结果
TcpConnectionsWindow {
id: tcpConnectionsWindow
accentColor: root.accentRed
applet: root.applet
isDarkMode: root.isDarkMode
}
// 设置窗口:独立顶层窗口,在桌面中间弹出
// 设计原因:Dialog 使用父窗口(dock layer-surface)的 overlay,仅覆盖任务栏区域,
// 无法在桌面中间显示。改用 Window 创建独立顶层窗口,可在桌面任意位置弹出。