feat: 新增流量波动图窗口,展示活动接口最近 5 分钟网速趋势

- C++ 后端增加 SpeedSample 采样结构与每接口环形缓冲(MAX_HISTORY_SAMPLES=300,
  即 5 分钟/1Hz),通过 speedHistoryDownload/speedHistoryUpload 暴露为
  QVariantList of QPointF 供 QML 绘制;接口切换/消失时同步清理历史避免泄漏
- 新增 package/components/TrafficChartWindow.qml:纯 QML Canvas 绘制下载/上传
  双折线,无外部依赖;支持 hover 辅助线、置顶图钉、空状态兜底
- networkview.qml 右键菜单增加"流量波动图"入口,弹出屏幕居中独立窗口
This commit is contained in:
2026-07-19 21:38:54 +08:00
parent c1a535a005
commit d0b8272ec6
4 changed files with 682 additions and 2 deletions
+573
View File
@@ -0,0 +1,573 @@
// SPDX-FileCopyrightText: 2024 MyCompany
//
// SPDX-License-Identifier: LGPL-3.0-or-later
// 流量波动图窗口:屏幕居中的独立顶层窗口,展示当前活动接口最近 5 分钟的
// 网速趋势(下载/上传双折线图),随 C++ 后端 speedHistoryChanged 信号每秒动态刷新
// 设计要点:
// - 视觉风格复用 AboutWindow.qml(白色圆角卡片 12px、1px #E8E8E8 边框、
// 44px 标题栏、28x28 圆形关闭按钮 hover 淡红底)
// - 图表使用纯 QML Canvas 绘制,无 QtCharts 等外部依赖(与项目零依赖风格一致)
// - 数据通过属性注入:applet 即 networkview.qml 的 root.appletC++ 后端对象),
// 为 null 时组件可独立预览(Canvas 显示"暂无历史数据"空状态)
// 触发方式:右键菜单"流量波动图" -> show()/raise()/requestActivate()
import QtQuick 2.15
import QtQuick.Layouts 1.15
import QtQuick.Window 2.15
Window {
id: root
// 对外依赖:关闭按钮 hover 态文字高亮色,由父组件传入
// 默认值与 networkview.qml 中 root.accentRed 一致,确保独立可用
property color accentColor: Qt.rgba(220 / 255, 38 / 255, 38 / 255, 1)
// 对外依赖:C++ 后端对象(NetworkMonitorApplet),由 networkview.qml 传入
// 提供 speedHistoryDownload / speedHistoryUploadQVariantList of QPointF
// x=时间戳秒, y=速度 bytes/sec)、downloadSpeed / uploadSpeed、activeInterface
// 为 null 时组件可独立预览(显示空状态),所有数据访问处均需做空值兜底
property var applet: null
// Hover 状态:当前悬停采样点在历史缓冲中的索引,-1 表示无悬停
// 由图表区 MouseArea 根据 mouseX 反查最近采样点更新;Canvas 据此绘制
// 竖直辅助线与圆点标记,底部提示条据此显示该时刻数值
property int hoverIndex: -1
// Hover 提示文本:非空时底部提示条显示该内容,为空显示默认引导语
// 格式:"14:23:05 ↓856.00 KB/s ↑120.00 KB/s"
property string hoverHint: ""
// 窗口置顶状态:true 时 flags 附加 Qt.WindowStaysOnTopHint,窗口保持在
// 所有非置顶窗口之上(便于边下载大文件边观察曲线);由标题栏图钉按钮切换
property bool pinned: false
// 置顶状态变化时重绘图钉图标(未置顶=灰色轮廓,置顶=蓝色填充)
onPinnedChanged: pinIcon.requestPaint()
// 下载折线颜色(绿)与上传折线颜色(橙),与规范 §4.4 一致
readonly property color downloadLineColor: "#34C759"
readonly property color uploadLineColor: "#FF9500"
// 图表区内边距:左侧容纳 Y 轴刻度标签(如 "10 MB"),底部容纳 X 轴时间标签
// 定义为根属性,供 Canvas 绘制与 MouseArea 坐标换算共用,保证两处一致
readonly property int chartMarginLeft: 56
readonly property int chartMarginRight: 12
readonly property int chartMarginTop: 12
readonly property int chartMarginBottom: 26
width: 680
height: 420
visible: false
// flags 绑定 pinned:置顶时附加 WindowStaysOnTopHint;未置顶时该位为 0
// 与原静态 flags 行为完全一致
flags: Qt.FramelessWindowHint | Qt.Window | (pinned ? Qt.WindowStaysOnTopHint : 0)
modality: Qt.NonModal
color: "transparent"
onVisibleChanged: {
if (visible) {
x = (Screen.width - width) / 2
y = (Screen.height - height) / 2
}
}
// 格式化速度显示(带单位,最小 KB,保留 2 位小数)
// 与 networkview.qml 的 formatSpeed 同实现;组件内自带一份保证独立可用
function formatSpeed(bytesPerSec) {
if (bytesPerSec < 1024 * 1024) {
return (bytesPerSec / 1024).toFixed(2) + " KB/s"
} else if (bytesPerSec < 1024 * 1024 * 1024) {
return (bytesPerSec / (1024 * 1024)).toFixed(2) + " MB/s"
} else {
return (bytesPerSec / (1024 * 1024 * 1024)).toFixed(2) + " GB/s"
}
}
// Y 轴上限取整:将 v 向上取整到 1/2/5 × 10^n 序列
// 设计原因:使刻度值为易读的整数(如 12345 -> 2000080000 -> 100000),
// 避免 vMax * 1.2 的余量产生零碎刻度(如 14814)
function niceCeil(v) {
if (v <= 0) return 1024
var exp = Math.floor(Math.log(v) / Math.LN10)
var base = Math.pow(10, exp)
var f = v / base
var nf
if (f <= 1) nf = 1
else if (f <= 2) nf = 2
else if (f <= 5) nf = 5
else nf = 10
return nf * base
}
// Y 轴刻度单位选择:根据上限自动选择 B/KB/MB/GB,返回 {div, suffix}
// 设计原因:让刻度数值保持在 0~1000 的易读区间(如 200 KB 而非 204800 B
function axisUnit(yMax) {
if (yMax >= 1024 * 1024 * 1024) return { div: 1024 * 1024 * 1024, suffix: "GB" }
if (yMax >= 1024 * 1024) return { div: 1024 * 1024, suffix: "MB" }
if (yMax >= 1024) return { div: 1024, suffix: "KB" }
return { div: 1, suffix: "B" }
}
// 格式化单个 Y 轴刻度值:大值取整、小值保留 1 位小数,避免 "10.00" 这类冗余
function formatAxisValue(v, unit) {
var val = v / unit.div
var s
if (val >= 100) s = val.toFixed(0)
else if (val >= 10) s = val.toFixed(1)
else s = val.toFixed(val === 0 ? 0 : 1)
return s + " " + unit.suffix
}
// 窗口主体:白色圆角卡片,1px 浅灰边框模拟 DTK 窗口描边(与 AboutWindow 一致)
Rectangle {
anchors.fill: parent
color: "#FFFFFF"
radius: 12
border.width: 1
border.color: "#E8E8E8"
ColumnLayout {
anchors.fill: parent
spacing: 0
// 自定义标题栏:左侧"流量波动图"标题 + 右侧置顶/关闭按钮,整栏可拖动窗口
Rectangle {
Layout.fillWidth: true
Layout.preferredHeight: 44
color: "transparent"
// 拖动层:声明在关闭/置顶按钮之前(位于其下方),避免遮挡按钮点击与 hover
// 注意:drag.target 只对 Item 生效,对 Window 无效(原实现拖动不工作);
// 改用 startSystemMove() 系统级窗口拖动,这是 frameless Window 的正确做法,
// pressed 即触发,由窗口管理器接管移动,不干扰按钮的 hover/click
MouseArea {
anchors.fill: parent
cursorShape: Qt.OpenHandCursor
onPressed: root.startSystemMove()
}
Text {
anchors.left: parent.left
anchors.leftMargin: 16
anchors.verticalCenter: parent.verticalCenter
text: qsTr("流量波动图")
font.pixelSize: 15
font.weight: Font.Bold
color: "#333333"
}
// 置顶按钮:28x28 圆形(与关闭按钮一致),位于关闭按钮左侧
// 三态视觉:未置顶=灰色图钉轮廓;置顶=deepin 蓝填充 + 淡蓝底;
// hover=淡灰底(置顶时淡蓝底优先)
Rectangle {
anchors.right: chartCloseButton.left
anchors.rightMargin: 4
anchors.verticalCenter: parent.verticalCenter
width: 28
height: 28
radius: 14
color: root.pinned ? Qt.rgba(0, 129 / 255, 1, 0.12)
: (pinMouse.containsMouse ? Qt.rgba(0, 0, 0, 0.06) : "transparent")
// 置顶图标:Canvas 绘制"上箭头触顶"(⤒ 风格)——向上箭头指向顶部横杠,
// 是"置顶/移到顶部"最通用的视觉语言,与关闭按钮"×"形态区分明显
// 未置顶:灰色细线描边;置顶:蓝色加粗 + 箭头头部实心填充,激活态更醒目
Canvas {
id: pinIcon
anchors.centerIn: parent
width: 16
height: 16
onPaint: {
var ctx = getContext("2d")
ctx.clearRect(0, 0, width, height)
var c = root.pinned ? "#0081FF" : "#999999"
ctx.strokeStyle = c
ctx.fillStyle = c
ctx.lineCap = "round"
ctx.lineJoin = "round"
ctx.lineWidth = root.pinned ? 2 : 1.5
// 顶部横杠:y=3x 3..13
ctx.beginPath()
ctx.moveTo(3, 3)
ctx.lineTo(13, 3)
ctx.stroke()
// 箭头主干:自底部 (8,13) 向上至 (8,7)
// 与横杠间留 ~1.5px 间隙,保持"触顶"的意象清晰
ctx.beginPath()
ctx.moveTo(8, 13)
ctx.lineTo(8, 7)
ctx.stroke()
if (root.pinned) {
// 置顶:箭头头部实心三角填充,与描边态形成明确视觉差异
ctx.beginPath()
ctx.moveTo(8, 5.2)
ctx.lineTo(4.6, 9)
ctx.lineTo(11.4, 9)
ctx.closePath()
ctx.fill()
} else {
// 未置顶:左右两片箭头羽,自顶端 (8,5.5) 向两肩展开
ctx.beginPath()
ctx.moveTo(8, 5.5)
ctx.lineTo(5, 8.5)
ctx.moveTo(8, 5.5)
ctx.lineTo(11, 8.5)
ctx.stroke()
}
}
}
MouseArea {
id: pinMouse
anchors.fill: parent
hoverEnabled: true
cursorShape: Qt.PointingHandCursor
onClicked: root.pinned = !root.pinned
}
}
// 关闭按钮:28x28 圆形,hover 时淡红底 + 红色 ×(颜色由 accentColor 决定)
Rectangle {
id: chartCloseButton
anchors.right: parent.right
anchors.rightMargin: 12
anchors.verticalCenter: parent.verticalCenter
width: 28
height: 28
radius: 14
color: chartCloseMouse.containsMouse ? Qt.rgba(220 / 255, 38 / 255, 38 / 255, 0.15) : "transparent"
Text {
anchors.centerIn: parent
text: "×"
font.pixelSize: 20
font.weight: Font.Bold
color: chartCloseMouse.containsMouse ? root.accentColor : "#666666"
}
MouseArea {
id: chartCloseMouse
anchors.fill: parent
hoverEnabled: true
cursorShape: Qt.PointingHandCursor
onClicked: root.hide()
}
}
}
// 顶部状态条:实时下行/上行速度(箭头颜色与折线一致,兼作图例)
// + 右侧活动接口名与时间窗口标签
RowLayout {
Layout.fillWidth: true
Layout.preferredHeight: 30
Layout.leftMargin: 16
Layout.rightMargin: 16
spacing: 6
Text {
text: "↓"
font.pixelSize: 14
font.weight: Font.Bold
color: root.downloadLineColor
}
Text {
// applet 为空时兜底为 0,保证独立预览不报错
text: root.formatSpeed(root.applet ? root.applet.downloadSpeed : 0)
font.pixelSize: 12
color: "#333333"
}
Item { Layout.preferredWidth: 10 }
Text {
text: "↑"
font.pixelSize: 14
font.weight: Font.Bold
color: root.uploadLineColor
}
Text {
text: root.formatSpeed(root.applet ? root.applet.uploadSpeed : 0)
font.pixelSize: 12
color: "#333333"
}
Item { Layout.fillWidth: true }
Text {
text: (root.applet && root.applet.activeInterface
? root.applet.activeInterface : "—") + " · 5min"
font.pixelSize: 12
color: "#999999"
}
}
// 图表区:Canvas 绘制双折线 + 网格 + 坐标轴 + Hover 辅助线
// visible 绑定窗口可见性:弹窗关闭时不绘制(C++ 后端仍继续采集)
Canvas {
id: canvas
Layout.fillWidth: true
Layout.fillHeight: true
Layout.leftMargin: 8
Layout.rightMargin: 8
visible: root.visible
onWidthChanged: requestPaint()
onHeightChanged: requestPaint()
onPaint: {
var ctx = getContext("2d")
ctx.clearRect(0, 0, width, height)
// 绘图区几何(与 chartHover 坐标换算共用同一组边距)
var pl = root.chartMarginLeft
var pr = root.chartMarginRight
var pt = root.chartMarginTop
var pb = root.chartMarginBottom
var pw = width - pl - pr
var ph = height - pt - pb
if (pw <= 0 || ph <= 0) return
// 取历史数据;applet 为空时视为空缓冲(走空状态分支)
var dl = root.applet ? root.applet.speedHistoryDownload : []
var ul = root.applet ? root.applet.speedHistoryUpload : []
var n = dl.length
// ---- Y 轴上限计算(规范 §4.4----
// 1. vMax = 所有采样点 max(download, upload)
// 2. vMax == 0 时上限取 10241 KB/s)避免除零
// 3. 否则取 vMax * 1.2 向上取整到 1/2/5 × 10^n 序列
var vMax = 0
var i
for (i = 0; i < n; i++) {
if (dl[i].y > vMax) vMax = dl[i].y
if (i < ul.length && ul[i].y > vMax) vMax = ul[i].y
}
var yMax = vMax <= 0 ? 1024 : root.niceCeil(vMax * 1.2)
var unit = root.axisUnit(yMax)
// ---- 水平网格线与 Y 轴刻度([0, yMax] 均分 4 段)----
ctx.font = "10px sans-serif"
ctx.textBaseline = "middle"
var g, gy
for (g = 0; g <= 4; g++) {
gy = pt + ph - (ph * g / 4)
// +0.5 让 1px 线条落在像素边界上,避免抗锯齿发虚
// 基线(g=0)略深一档,其余 4 条网格线用规范色 #E5E5E5
ctx.strokeStyle = g === 0 ? "#DDDDDD" : "#E5E5E5"
ctx.lineWidth = 1
ctx.beginPath()
ctx.moveTo(pl, gy + 0.5)
ctx.lineTo(pl + pw, gy + 0.5)
ctx.stroke()
// 刻度标签右对齐于绘图区左侧
ctx.fillStyle = "#999999"
ctx.textAlign = "right"
ctx.fillText(root.formatAxisValue(yMax * g / 4, unit), pl - 8, gy)
}
// ---- X 轴刻度:每分钟一个标签,均布于绘图区 ----
// 5 分钟窗口用 -5m/-4m/-3m/-2m/-1m/now 共 6 个标签,比 4 个三分点
// 的 -3m20s/-1m40s 更易读;循环按数组长度参数化,两端左/右对齐
var xLabels = ["-5m", "-4m", "-3m", "-2m", "-1m", "now"]
ctx.fillStyle = "#999999"
ctx.textBaseline = "alphabetic"
for (i = 0; i < xLabels.length; i++) {
var lx = pl + pw * i / (xLabels.length - 1)
// 两端标签分别左/右对齐,避免文字越出卡片边缘被裁剪
ctx.textAlign = i === 0 ? "left" : (i === xLabels.length - 1 ? "right" : "center")
ctx.fillText(xLabels[i], lx, height - 8)
}
// ---- 空状态:画完空网格后中央提示,不画折线(规范 §5)----
if (n === 0) {
ctx.fillStyle = "#999999"
ctx.font = "13px sans-serif"
ctx.textAlign = "center"
ctx.textBaseline = "middle"
ctx.fillText(qsTr("暂无历史数据"), pl + pw / 2, pt + ph / 2)
return
}
// ---- 折线绘制 ----
// X 轴固定为 5 分钟窗口 [tMax-300, tMax]:右缘始终对齐"now"
// 数据不足 5 分钟时曲线从右侧向左生长,左侧留空网格。
// 设计原因:若按实际数据范围 [dl[0].x, tMax] 映射,刚启动时仅有
// 几秒数据会被拉伸到整个绘图宽度,X 轴标签 -5m/-4m/... 与实际范围
// 严重不符,用户看到的是"几秒趋势图"而非"5 分钟趋势图"。
// 300 = 5 分钟 × 60 秒,与 C++ MAX_HISTORY_SAMPLES 一致
var tMax = dl[n - 1].x
var tMin = tMax - 300
var tRange = 300
// 单点边界:只有 1 个采样点时无法连线,画一个圆点。
// 固定窗口下单点对齐 now(右缘),而非居中
if (n === 1) {
var sx = pl + pw
var sy = pt + ph - (dl[0].y / yMax) * ph
ctx.fillStyle = "#34C759"
ctx.beginPath()
ctx.arc(sx, sy, 3, 0, 2 * Math.PI)
ctx.fill()
return
}
// 绘制一条序列折线:先填充线下淡色区域增强可读性,再描边 2px 主线
// lineCap/lineJoin 用 round 使折线端点与转角圆润
// 注意每次 stroke/fill 前必须 beginPath(),避免与上一段路径串连
function drawSeries(data, colorCss, fillCss) {
var m = data.length
if (m === 0) return
var j, px, py
// 线下淡色填充(alpha 0.08):贴到基线形成闭合区域
ctx.beginPath()
for (j = 0; j < m; j++) {
px = pl + ((data[j].x - tMin) / tRange) * pw
py = pt + ph - (data[j].y / yMax) * ph
if (j === 0) ctx.moveTo(px, py)
else ctx.lineTo(px, py)
}
ctx.lineTo(pl + ((data[m - 1].x - tMin) / tRange) * pw, pt + ph)
ctx.lineTo(pl + ((data[0].x - tMin) / tRange) * pw, pt + ph)
ctx.closePath()
ctx.fillStyle = fillCss
ctx.fill()
// 主线:2px 描边
ctx.beginPath()
for (j = 0; j < m; j++) {
px = pl + ((data[j].x - tMin) / tRange) * pw
py = pt + ph - (data[j].y / yMax) * ph
if (j === 0) ctx.moveTo(px, py)
else ctx.lineTo(px, py)
}
ctx.strokeStyle = colorCss
ctx.lineWidth = 2
ctx.lineCap = "round"
ctx.lineJoin = "round"
ctx.stroke()
}
// 先画上传(橙)再画下载(绿):下载通常是主视线,后画置于上层
drawSeries(ul, "#FF9500", "rgba(255, 149, 0, 0.08)")
drawSeries(dl, "#34C759", "rgba(52, 199, 89, 0.08)")
// ---- Hover:竖直辅助线 + 两条折线上的圆点标记 ----
// hoverIndex 由 chartHover 根据 mouseX 反查更新;此处按索引换算坐标
var hi = root.hoverIndex
if (hi >= 0 && hi < n) {
var hx = pl + ((dl[hi].x - tMin) / tRange) * pw
// 竖直辅助线:虚线,避免与实线折线混淆
ctx.strokeStyle = "#BBBBBB"
ctx.lineWidth = 1
ctx.setLineDash([4, 3])
ctx.beginPath()
ctx.moveTo(hx, pt)
ctx.lineTo(hx, pt + ph)
ctx.stroke()
ctx.setLineDash([])
// 圆点标记:白芯 + 2px 彩色描边,在折线上形成清晰锚点
function drawDot(yVal, colorCss) {
var hy = pt + ph - (yVal / yMax) * ph
ctx.beginPath()
ctx.arc(hx, hy, 4, 0, 2 * Math.PI)
ctx.fillStyle = "#FFFFFF"
ctx.fill()
ctx.strokeStyle = colorCss
ctx.lineWidth = 2
ctx.stroke()
}
drawDot(dl[hi].y, "#34C759")
if (hi < ul.length) drawDot(ul[hi].y, "#FF9500")
}
}
// Hover 交互层:横向移动时按 mouseX 反查最近采样点
// 设计原因:采样点按时间均匀分布(1Hz),先由 X 坐标线性反推时间戳,
// 再线性扫描找最近点;300 点上限下扫描开销可忽略,无需二分
MouseArea {
id: chartHover
anchors.fill: parent
hoverEnabled: true
onPositionChanged: {
if (!root.applet) return
var dl = root.applet.speedHistoryDownload
var n = dl.length
if (n === 0) return
var pl = root.chartMarginLeft
var pw = width - pl - root.chartMarginRight
if (pw <= 0) return
// X 轴用与绘制一致的固定 5 分钟窗口 [tMax-300, tMax] 反推时间戳,
// 保证 Hover 辅助线与折线上的采样点严格对齐
var tMax = dl[n - 1].x
var tMin = tMax - 300
var tRange = 300
// 将 mouseX 限制在绘图区内,再线性反推时间戳
var clampedX = Math.max(pl, Math.min(mouse.x, pl + pw))
var target = tMin + (clampedX - pl) / pw * tRange
var best = 0
var bestDist = Math.abs(dl[0].x - target)
for (var i = 1; i < n; i++) {
var d = Math.abs(dl[i].x - target)
if (d < bestDist) {
bestDist = d
best = i
}
}
root.hoverIndex = best
// 更新底部提示条:时间 + 下行/上行速度
var ul = root.applet.speedHistoryUpload
var idx = root.hoverIndex
var upVal = idx < ul.length ? ul[idx].y : 0
root.hoverHint = Qt.formatDateTime(new Date(dl[idx].x * 1000), "HH:mm:ss")
+ " ↓" + root.formatSpeed(dl[idx].y)
+ " ↑" + root.formatSpeed(upVal)
canvas.requestPaint()
}
onExited: {
root.hoverIndex = -1
root.hoverHint = ""
canvas.requestPaint()
}
}
}
// 底部提示条:默认显示操作引导;Hover 时显示该时刻的时间与上下行速度
Rectangle {
Layout.fillWidth: true
Layout.preferredHeight: 30
color: "transparent"
Text {
anchors.centerIn: parent
text: root.hoverHint.length > 0
? root.hoverHint : qsTr("鼠标移到曲线上查看详情")
font.pixelSize: 11
color: root.hoverHint.length > 0 ? "#333333" : "#999999"
}
}
}
}
// 动态刷新:C++ 每秒追加采样点时发射 speedHistoryChanged,触发 Canvas 重绘
// 注意:此处不重置 Hover 状态,否则用户悬停时提示会随每秒刷新闪断;
// 缓冲满后旧点滑出导致的索引漂移由 onPaint 中 hi < n 的边界判断兜底
Connections {
target: root.applet
function onSpeedHistoryChanged() {
canvas.requestPaint()
}
// 接口切换时历史整体更换,原 Hover 索引失去意义,需清除避免残留标记
function onActiveInterfaceChanged() {
root.hoverIndex = -1
root.hoverHint = ""
canvas.requestPaint()
}
}
}
+18
View File
@@ -662,6 +662,16 @@ AppletItem {
}
}
// 流量波动图:屏幕居中独立窗口,展示活动接口最近 30 分钟网速趋势
Platform.MenuItem {
text: qsTr("流量波动图")
onTriggered: {
trafficChartWindow.show()
trafficChartWindow.raise()
trafficChartWindow.requestActivate()
}
}
Platform.MenuSeparator {}
Platform.MenuItem {
@@ -682,6 +692,14 @@ AppletItem {
version: root.applet ? root.applet.version : "1.0"
}
// 流量波动图窗口:屏幕居中独立窗口,展示活动接口最近 30 分钟网速趋势
// 依赖通过属性传入:accentColor = root.accentRedapplet = root.applet
TrafficChartWindow {
id: trafficChartWindow
accentColor: root.accentRed
applet: root.applet
}
// 设置窗口:独立顶层窗口,在桌面中间弹出
// 设计原因:Dialog 使用父窗口(dock layer-surface)的 overlay,仅覆盖任务栏区域,
// 无法在桌面中间显示。改用 Window 创建独立顶层窗口,可在桌面任意位置弹出。
+63 -2
View File
@@ -127,6 +127,37 @@ QString NetworkMonitorApplet::version() const
return pluginMetaData().value("Version").toString();
}
// 返回当前活动接口的下行速度历史,转换为 QVariantList of QPointF 供 QML 使用
// 设计原因:QPointF 仅携带 x/y 两个值,上传与下载分别对应两个列表
QVariantList NetworkMonitorApplet::speedHistoryDownload() const
{
QVariantList list;
if (m_activeInterface.isEmpty() || !m_speedHistory.contains(m_activeInterface)) {
return list;
}
const QVector<SpeedSample> &samples = m_speedHistory[m_activeInterface];
list.reserve(samples.size());
for (const SpeedSample &s : samples) {
list.append(QPointF(s.timestamp, s.downloadSpeed));
}
return list;
}
// 返回当前活动接口的上行速度历史,结构同 speedHistoryDownload
QVariantList NetworkMonitorApplet::speedHistoryUpload() const
{
QVariantList list;
if (m_activeInterface.isEmpty() || !m_speedHistory.contains(m_activeInterface)) {
return list;
}
const QVector<SpeedSample> &samples = m_speedHistory[m_activeInterface];
list.reserve(samples.size());
for (const SpeedSample &s : samples) {
list.append(QPointF(s.timestamp, s.uploadSpeed));
}
return list;
}
void NetworkMonitorApplet::refresh()
{
readNetworkStats();
@@ -138,6 +169,8 @@ void NetworkMonitorApplet::setActiveInterface(const QString &interface)
m_activeInterface = interface;
m_firstUpdate = true;
emit activeInterfaceChanged();
// 接口切换后通知 QML 趋势图切换显示新接口的历史数据
emit speedHistoryChanged();
// 接口切换后立即检测新接口的 IP 地址
detectIpAddress();
}
@@ -190,7 +223,16 @@ void NetworkMonitorApplet::readNetworkStats()
if (newInterfaces.keys() != m_interfaces.keys()) {
m_interfaceList = newInterfaces.keys();
m_interfaces = newInterfaces;
// 清理已消失接口的历史缓冲,避免内存泄漏
// 设计原因:USB 网卡、VPN 隧道等接口可能随时消失,其历史数据不再需要
const QStringList oldIfaces = m_speedHistory.keys();
for (const QString &name : oldIfaces) {
if (!newInterfaces.contains(name)) {
m_speedHistory.remove(name);
}
}
// 自动选择活动接口
if (m_activeInterface.isEmpty() && !m_interfaceList.isEmpty()) {
// 优先选择物理网卡(wlp/wlan/enp/eth)中有流量的接口,
@@ -255,7 +297,26 @@ void NetworkMonitorApplet::calculateSpeed()
m_lastRxBytes = currentRxBytes;
m_lastTxBytes = currentTxBytes;
// 追加采样点到当前活动接口的环形缓冲
// 设计原因:applet 启动即持续采集,用户随时打开趋势图都能看到完整 5 分钟数据
if (!m_activeInterface.isEmpty()) {
SpeedSample sample;
sample.timestamp = QDateTime::currentSecsSinceEpoch();
sample.downloadSpeed = static_cast<double>(m_downloadSpeed);
sample.uploadSpeed = static_cast<double>(m_uploadSpeed);
m_speedHistory[m_activeInterface].append(sample);
// 滑动窗口裁剪:超过 300 点时丢弃最旧的
// removeFirst 是 O(n),但 300 点每秒一次开销可忽略,无需复杂环形索引
QVector<SpeedSample> &samples = m_speedHistory[m_activeInterface];
while (samples.size() > MAX_HISTORY_SAMPLES) {
samples.removeFirst();
}
emit speedHistoryChanged();
}
emit speedChanged();
emit totalChanged();
}
+28
View File
@@ -11,6 +11,9 @@
#include <QTimer>
#include <QVariantList>
#include <QMap>
#include <QHash>
#include <QPointF>
#include <QDateTime>
DS_BEGIN_NAMESPACE
@@ -26,6 +29,15 @@ struct NetworkInterface {
qint64 txDropped; // 发送丢弃数
};
// 单个速度采样点:用于趋势图的环形缓冲
// timestamp: 自 epoch 的秒级时间戳,作为 X 轴定位
// downloadSpeed / uploadSpeed: 当时的瞬时速度(字节/秒),作为两条折线的 Y 值
struct SpeedSample {
qint64 timestamp;
double downloadSpeed;
double uploadSpeed;
};
class NetworkMonitorApplet : public DApplet
{
Q_OBJECT
@@ -44,6 +56,11 @@ class NetworkMonitorApplet : public DApplet
Q_PROPERTY(QString ipv6Address READ ipv6Address NOTIFY ipv6AddressChanged)
// 插件版本号,从 dde-shell 元数据读取,版本唯一源为 CMakeLists.txt project(VERSION)
Q_PROPERTY(QString version READ version CONSTANT)
// 当前活动接口的下行速度历史采样点(QPointF 列表:x=时间戳秒, y=速度 bytes/sec
// 用于趋势图绘制下载折线,每次 calculateSpeed 追加一个点并发射 speedHistoryChanged
Q_PROPERTY(QVariantList speedHistoryDownload READ speedHistoryDownload NOTIFY speedHistoryChanged)
// 当前活动接口的上行速度历史采样点,结构同 speedHistoryDownload
Q_PROPERTY(QVariantList speedHistoryUpload READ speedHistoryUpload NOTIFY speedHistoryChanged)
public:
explicit NetworkMonitorApplet(QObject *parent = nullptr);
@@ -62,6 +79,10 @@ public:
QString activeInterface() const;
QString ipAddress() const;
QString ipv6Address() const;
// 返回当前活动接口的下行速度历史(QPointF 列表),供 QML 趋势图绘制
QVariantList speedHistoryDownload() const;
// 返回当前活动接口的上行速度历史(QPointF 列表),供 QML 趋势图绘制
QVariantList speedHistoryUpload() const;
// 返回插件版本号,从 dde-shell 插件元数据(metadata.json)读取
QString version() const;
@@ -77,6 +98,7 @@ signals:
void activeInterfaceChanged();
void ipAddressChanged();
void ipv6AddressChanged();
void speedHistoryChanged();
private:
void readNetworkStats();
@@ -109,6 +131,12 @@ private:
bool m_ready;
bool m_firstUpdate;
// 速度历史环形缓冲:每个接口独立维护一份,key 为接口名
// 设计原因:接口切换时趋势图不出现跳变,切回时仍能看到该接口历史
QHash<QString, QVector<SpeedSample>> m_speedHistory;
// 每个接口最多保留的采样点数:5 分钟 × 60 秒 = 300
static constexpr int MAX_HISTORY_SAMPLES = 300;
};
DS_END_NAMESPACE