Files

T

2026-08-08 19:57:12 +08:00

32 KiB

Raw Blame History

左键弹窗重新设计实现计划

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: 重新设计 NetworkPopup 左键弹窗布局，采用通透分区方案，适配用户字体颜色和网卡图标，预留字号缩放扩展点。

Architecture: 去掉自绘卡片背景，用分隔线+留白划分四个区域（接口信息/实时速度/累计流量/接口切换），速度数字放大为视觉锚点。将 SettingsWindow 的 interfaceIcon/interfaceDescription 提取到 NetCommon 共享，NetworkPopup 接入用户 textColor 和 fontScale。

Tech Stack: QML 2.15 + QtQuick.Controls 2.15 + DTK 1.0 + dde-shell PanelPopup

Global Constraints

项目无测试/lint/CI 目标，验证为手动：cmake --build build + sudo cmake --install build + systemctl --user restart dde-shell@DDE
QML 文件保留 SPDX 头（SPDX-FileCopyrightText: 2026 Jokul + SPDX-License-Identifier: LGPL-3.0-or-later）
注释语言统一使用中文，字段/函数上方必须添加中文注释
NetCommon.qml 的现有颜色定义和格式化函数不变，仅新增函数
C++ 后端本次不改（fontScale 预留扩展点，后续再加）
Commit message 使用中文，格式遵循 conventional commits

File Structure

文件	职责	本次改动
`package/components/NetCommon.qml`	公共颜色与格式化函数	新增 `interfaceIcon`、`interfaceDescription`、`formatSpeedValue`、`formatSpeedUnit` 四个函数
`package/components/SettingsWindow.qml`	设置窗口	删除本地 `interfaceIcon`/`interfaceDescription`，改为调用 `common.xxx`
`package/components/NetworkPopup.qml`	弹窗内容组件	完全重写布局
`package/networkview.qml`	主入口	仅改 `PanelPopup` 的 width/height

Task 1: 提取共享函数到 NetCommon.qml + 更新 SettingsWindow.qml

Files:

Modify: package/components/NetCommon.qml（在 formatTotal 函数后、闭合 } 前新增四个函数）
Modify: package/components/SettingsWindow.qml（删除本地 interfaceIcon/interfaceDescription，新增 import 和 common 实例，替换调用处）

Interfaces:

Produces: common.interfaceIcon(name) 返回 Unicode 符号字符串；common.interfaceDescription(name) 返回翻译后的类型描述字符串；common.formatSpeedValue(bytesPerSec) 返回速度数值部分（如 "4.11"）；common.formatSpeedUnit(bytesPerSec) 返回速度单位部分（如 "KB/s"）
Step 1: 在 NetCommon.qml 新增四个函数

在 NetCommon.qml 的 formatTotal 函数闭合 } 之后、文件最终闭合 } 之前，插入以下代码：


    // 根据接口名返回类型图标（Unicode 符号），用于网络接口列表和弹窗接口信息区
    // 设计原因：项目未引入图标库，用 Text 渲染 Unicode 符号（与 ↓↑ 一致）；
    // 所选符号均为 DejaVu/Noto 等常见字体覆盖的单色字形，避免彩色 emoji 破坏浅色主题观感
    function interfaceIcon(name) {
        if (name === "lo") return "↻"               // 本地回环：循环箭头
        if (name === "Meta") return "▢"             // 虚拟接口：空心方块
        if (/^enp|^eth/.test(name)) return "⇄"      // 有线网络：双向链路
        if (/^wlp|^wlan/.test(name)) return "∿"     // 无线网络：信号波形
        if (/^docker|^veth/.test(name)) return "▣"  // 容器网络：盒中盒
        if (/^br/.test(name)) return "⋈"            // 桥接：连接
        if (/^tun|^tap/.test(name)) return "⚿"      // VPN：钥匙
        if (/^virbr/.test(name)) return "⋈"         // 虚拟桥接：同桥接
        return "◉"                                  // 其他：通用网络节点
    }

    // 根据接口名返回类型描述，用于设置窗口网络接口列表和弹窗 tooltip
    // 设计原因：用户面对多个网口时难以仅凭 enp3s0/wlp3s0 等命名判断用途，
    // 加一行类型说明（有线/无线/VPN 等）降低认知负担
    function interfaceDescription(name) {
        if (name === "lo") return qsTr("Loopback")
        if (name === "Meta") return qsTr("Virtual Interface")
        if (/^enp|^eth/.test(name)) return qsTr("Wired Network")
        if (/^wlp|^wlan/.test(name)) return qsTr("Wireless Network")
        if (/^docker|^veth/.test(name)) return qsTr("Container Network")
        if (/^br/.test(name)) return qsTr("Bridge")
        if (/^tun|^tap/.test(name)) return qsTr("VPN")
        if (/^virbr/.test(name)) return qsTr("Virtual Bridge")
        return qsTr("Other")
    }

    // 拆分速度字符串为数值部分：formatSpeed 返回 "4.11 KB/s"，本函数返回 "4.11"
    // 设计原因：弹窗速度区需将数值（大号粗体）与单位（小号）拆分显示以增强层次感
    function formatSpeedValue(bytesPerSec) {
        var str = formatSpeed(bytesPerSec)
        var idx = str.indexOf(' ')
        return idx < 0 ? str : str.substring(0, idx)
    }

    // 拆分速度字符串为单位部分：formatSpeed 返回 "4.11 KB/s"，本函数返回 "KB/s"
    function formatSpeedUnit(bytesPerSec) {
        var str = formatSpeed(bytesPerSec)
        var idx = str.indexOf(' ')
        return idx < 0 ? "" : str.substring(idx + 1)
    }

Step 2: 在 SettingsWindow.qml 添加 import 和 NetCommon 实例

在 SettingsWindow.qml 的 import 块末尾（import QtQuick.Window 2.15 之后）添加：

import "."

在 Window { id: root 之后、property var applet: null 之前添加：

    // 公共函数：interfaceIcon/interfaceDescription 已从本文件迁移至 NetCommon.qml，
    // 与 NetworkPopup 共享同一份实现，消除跨组件重复定义
    NetCommon { id: common }

Step 3: 删除 SettingsWindow.qml 的本地 interfaceIcon 和 interfaceDescription 函数

删除 SettingsWindow.qml 中 interfaceDescription 函数（当前第 72-82 行）和 interfaceIcon 函数（当前第 88-98 行）的完整定义，包括函数上方的注释。

Step 4: 替换 SettingsWindow.qml 中的函数调用处

将 SettingsWindow.qml 中所有 interfaceIcon(modelData) 替换为 common.interfaceIcon(modelData)，将 interfaceDescription(modelData) 替换为 common.interfaceDescription(modelData)。

涉及两处（均在接口列表 Repeater 的 delegate 内）：

图标 Text 的 text: interfaceIcon(modelData) -> text: common.interfaceIcon(modelData)
描述 Text 的 text: interfaceDescription(modelData) -> text: common.interfaceDescription(modelData)
Step 5: 构建

Run: cmake --build build Expected: 编译成功，无错误

Step 6: 安装并重启 dde-shell

Run: sudo cmake --install build && systemctl --user restart dde-shell@DDE Expected: 安装成功，dde-shell 重启

Step 7: 手动验证设置窗口

验证清单：

右键任务栏网络监控图标 -> 点击"设置"
设置窗口打开，网络接口列表每行左侧仍显示类型图标（∿/⇄/▢ 等）
每行右侧仍显示类型描述（"无线网络"/"有线网络"/"虚拟接口" 等）
图标和描述与改动前完全一致

Step 8: 提交

git add package/components/NetCommon.qml package/components/SettingsWindow.qml
git commit -m "refactor: 提取 interfaceIcon/interfaceDescription 到 NetCommon 共享

将 SettingsWindow 的接口图标和描述函数迁移到 NetCommon.qml，
消除与 NetworkPopup 的重复定义；新增 formatSpeedValue/formatSpeedUnit
为弹窗速度数值与单位拆分显示做准备"

Task 2: 重写 NetworkPopup.qml + 更新 networkview.qml 弹窗尺寸

Files:

Modify: package/networkview.qml:267-268（PanelPopup 的 width/height）
Rewrite: package/components/NetworkPopup.qml（完整重写布局）

Interfaces:

Consumes: common.interfaceIcon(name)（Task 1 产出）、common.formatSpeedValue(bytesPerSec)、common.formatSpeedUnit(bytesPerSec)
Produces: popup.primaryText（支持用户 textColor 覆盖）、popup.fontScale（预留字号缩放）
Step 1: 更新 networkview.qml 的 PanelPopup 尺寸

将 networkview.qml 第 267-268 行：

        width: 360
        height: 320

改为：

        width: 330
        height: 250

Step 2: 完整重写 NetworkPopup.qml

将 package/components/NetworkPopup.qml 全文替换为以下内容：

// SPDX-FileCopyrightText: 2026 Jokul
//
// SPDX-License-Identifier: LGPL-3.0-or-later

// 网络速度监控弹窗内容组件
// 通透分区布局：去掉自绘卡片背景，用分隔线+留白划分四个区域
// （接口信息 / 实时速度 / 累计流量 / 接口切换），速度数字放大为视觉锚点
// 由 networkview.qml 的 PanelPopup 实例化，传入 applet 属性
// 毛玻璃背景、圆角、阴影由 PanelPopup 自动提供，本组件不自绘背景
// 颜色与格式化函数统一取自同目录 NetCommon.qml（common.xxx），数据由 applet 提供
// 可配置适配：primaryText 跟随用户 textColor、fontScale 预留字号缩放扩展点
// 设计原因：PanelPopup 是 dock 上下文类型，不能作为独立组件根元素，
// 因此本组件用 Control 作为根，由 networkview.qml 的 PanelPopup 包裹

import QtQuick 2.15
import QtQuick.Controls 2.15
import QtQuick.Layouts 1.15
import org.deepin.ds.dock 1.0
import org.deepin.dtk 1.0
import "."

Control {
    id: popup

    // 公共颜色与格式化函数：集中定义于同目录 NetCommon.qml
    NetCommon { id: common }

    // C++ 后端对象，提供速度/接口/IP 等所有数据
    property var applet: null

    readonly property bool ready: applet ? applet.ready : false
    readonly property real downloadSpeed: applet ? applet.downloadSpeed : 0
    readonly property real uploadSpeed: applet ? applet.uploadSpeed : 0
    readonly property real totalDownload: applet ? applet.totalDownload : 0
    readonly property real totalUpload: applet ? applet.totalUpload : 0
    readonly property string activeInterface: applet ? (applet.activeInterface || "") : ""
    // 活动接口的 IPv4 地址，由 C++ 后端 detectIpAddress 持续更新
    readonly property string ipAddress: applet ? (applet.ipAddress || "") : ""
    // 活动接口的 IPv6 全球地址，由 C++ 后端 detectIpAddress 持续更新
    readonly property string ipv6Address: applet ? (applet.ipv6Address || "") : ""
    readonly property var networkInterfaces: applet ? (applet.networkInterfaces || []) : []

    // 用户自定义字体色：非空时覆盖 primaryText，空串回退 DTK 调色板派生
    // 仅作用于主要文字（接口名、速度数值、累计数值、chip 未选中文字）
    // secondaryText/tertiaryText/强调色不跟随，保持系统主题层次不崩
    readonly property string userTextColor: applet ? (applet.textColor || "") : ""
    readonly property color primaryText: userTextColor.length > 0
        ? Qt.rgba(userTextColor.r, userTextColor.g, userTextColor.b, 0.95)
        : common.primaryText

    // 次要/三级文字与卡片边框仍从 common 取 DTK 派生值，不跟随用户色
    readonly property color secondaryText: common.secondaryText
    readonly property color tertiaryText: common.tertiaryText
    readonly property color cardBorder: common.cardBorder

    // 强调色：下载蓝、上传绿，是面板的主视觉区分
    readonly property color accentBlue: common.accentBlue
    readonly property color accentGreen: common.accentGreen

    // 上传值颜色：固定绿色，不做高速警示
    readonly property color uploadValueColor: common.uploadValueColor

    // 字号缩放因子：默认 1.0，后续 C++ 后端新增 applet.fontScale 后自动绑定
    // 所有字号 = 基准字号 × fontScale，实现全局字号调节
    // 当前 applet.fontScale 尚不存在，恒为 1.0，视觉无变化
    readonly property real fontScale: (applet && applet.fontScale !== undefined)
        ? applet.fontScale : 1.0

    // 排序后的接口列表：物理网卡在前，虚拟网卡在后，各自按名称排序
    // 设计原因：保持稳定排序，活动接口不再移到最前，避免切换网卡时 chip 顺序跳动；
    // 活动 chip 若被截断，由 chipFlickable 自动滚动露出完整样式；
    // 物理网卡判断逻辑共用 common.isPhysicalIf（与 C++ isPhysicalInterface 一致）
    readonly property var sortedInterfaces: {
        if (!popup.ready || popup.networkInterfaces.length === 0) return []
        var physical = []
        var virtual = []
        for (var i = 0; i < popup.networkInterfaces.length; i++) {
            var name = popup.networkInterfaces[i]
            if (common.isPhysicalIf(name)) physical.push(name)
            else virtual.push(name)
        }
        physical.sort()
        virtual.sort()
        return physical.concat(virtual)
    }

    // 供外部调用：popup 打开时滚动到活动 chip
    function scrollToActiveChip(animated) {
        chipFlickable.scrollToActiveChip(animated)
    }

    padding: 12

    contentItem: ColumnLayout {
        spacing: 10

        // ==================== 占位态：未检测到接口 ====================
        // 占位时只显示警告图标+文字，不显示其他分区和分隔线
        ColumnLayout {
            Layout.alignment: Qt.AlignHCenter
            Layout.preferredHeight: 80
            spacing: 6
            visible: !popup.ready

            Text {
                text: "⚠"
                font.pixelSize: Math.round(40 * popup.fontScale)
                color: popup.tertiaryText
                Layout.alignment: Qt.AlignHCenter
            }

            Text {
                text: qsTr("No network interface detected")
                font.pixelSize: Math.round(14 * popup.fontScale)
                color: popup.secondaryText
                Layout.alignment: Qt.AlignHCenter
            }
        }

        // ==================== 分区1：接口信息 ====================
        // 类型图标 + 接口名 + IPv4 一行，IPv6 截断显示一行
        ColumnLayout {
            Layout.fillWidth: true
            spacing: 4
            visible: popup.ready

            // 行1：类型图标 + 接口名 + · + IPv4
            Text {
                Layout.alignment: Qt.AlignHCenter
                Layout.fillWidth: true
                horizontalAlignment: Text.AlignHCenter
                font.pixelSize: Math.round(13 * popup.fontScale)
                color: popup.secondaryText
                text: {
                    var icon = common.interfaceIcon(popup.activeInterface)
                    var parts = icon + " " + popup.activeInterface
                    if (popup.ipAddress) parts += "  ·  " + popup.ipAddress
                    return parts
                }
            }

            // 行2：IPv6 地址（超长截断 + hover tooltip 显示完整地址）
            Text {
                Layout.alignment: Qt.AlignHCenter
                Layout.fillWidth: true
                Layout.maximumWidth: 300
                horizontalAlignment: Text.AlignHCenter
                font.pixelSize: Math.round(12 * popup.fontScale)
                color: popup.tertiaryText
                visible: popup.ipv6Address !== ""
                text: popup.ipv6Address ? qsTr("IPv6: ") + popup.ipv6Address : ""
                elide: Text.ElideRight

                ToolTip.text: popup.ipv6Address
                ToolTip.visible: ipv6Mouse.containsMouse && popup.ipv6Address !== ""
                ToolTip.delay: 300

                MouseArea {
                    id: ipv6Mouse
                    anchors.fill: parent
                    hoverEnabled: true
                    cursorShape: Qt.IBeamCursor
                }
            }
        }

        // 分隔线1
        Rectangle {
            Layout.fillWidth: true
            Layout.preferredHeight: 1
            color: popup.cardBorder
            visible: popup.ready
        }

        // ==================== 分区2：实时速度（视觉锚点） ====================
        // 双栏等宽，下载左半区、上传右半区，中间靠留白区分无竖线
        Item {
            Layout.fillWidth: true
            Layout.preferredHeight: 60
            visible: popup.ready

            // 下载半区（左半）
            Item {
                id: downloadHalf
                anchors.left: parent.left
                anchors.top: parent.top
                anchors.bottom: parent.bottom
                width: parent.width / 2

                ColumnLayout {
                    anchors.centerIn: parent
                    spacing: 2

                    // 下载标签
                    Text {
                        text: qsTr("Download")
                        font.pixelSize: Math.round(12 * popup.fontScale)
                        color: popup.secondaryText
                        Layout.alignment: Qt.AlignHCenter
                    }

                    // 箭头 + 数值（大号粗体）+ 单位（小号）
                    RowLayout {
                        spacing: 2
                        Layout.alignment: Qt.AlignHCenter

                        Text {
                            text: "↓"
                            font.pixelSize: Math.round(24 * popup.fontScale)
                            font.weight: Font.Bold
                            color: common.downloadValueColor(popup.downloadSpeed)
                        }

                        Text {
                            text: common.formatSpeedValue(popup.downloadSpeed)
                            font.pixelSize: Math.round(24 * popup.fontScale)
                            font.weight: Font.Bold
                            color: common.downloadValueColor(popup.downloadSpeed)
                        }

                        Text {
                            text: common.formatSpeedUnit(popup.downloadSpeed)
                            font.pixelSize: Math.round(13 * popup.fontScale)
                            color: common.downloadValueColor(popup.downloadSpeed)
                            Layout.alignment: Qt.AlignBaseline
                        }
                    }
                }
            }

            // 上传半区（右半）
            Item {
                id: uploadHalf
                anchors.right: parent.right
                anchors.top: parent.top
                anchors.bottom: parent.bottom
                width: parent.width / 2

                ColumnLayout {
                    anchors.centerIn: parent
                    spacing: 2

                    // 上传标签
                    Text {
                        text: qsTr("Upload")
                        font.pixelSize: Math.round(12 * popup.fontScale)
                        color: popup.secondaryText
                        Layout.alignment: Qt.AlignHCenter
                    }

                    // 箭头 + 数值（大号粗体）+ 单位（小号）
                    RowLayout {
                        spacing: 2
                        Layout.alignment: Qt.AlignHCenter

                        Text {
                            text: "↑"
                            font.pixelSize: Math.round(24 * popup.fontScale)
                            font.weight: Font.Bold
                            color: popup.uploadValueColor
                        }

                        Text {
                            text: common.formatSpeedValue(popup.uploadSpeed)
                            font.pixelSize: Math.round(24 * popup.fontScale)
                            font.weight: Font.Bold
                            color: popup.uploadValueColor
                        }

                        Text {
                            text: common.formatSpeedUnit(popup.uploadSpeed)
                            font.pixelSize: Math.round(13 * popup.fontScale)
                            color: popup.uploadValueColor
                            Layout.alignment: Qt.AlignBaseline
                        }
                    }
                }
            }
        }

        // 分隔线2
        Rectangle {
            Layout.fillWidth: true
            Layout.preferredHeight: 1
            color: popup.cardBorder
            visible: popup.ready
        }

        // ==================== 分区3：累计流量 ====================
        // 单行紧凑：总计标签 + 下载箭头/数值 + 上传箭头/数值
        RowLayout {
            Layout.fillWidth: true
            spacing: 8
            visible: popup.ready

            Item { Layout.fillWidth: true }

            Text {
                text: qsTr("Total")
                font.pixelSize: Math.round(12 * popup.fontScale)
                color: popup.tertiaryText
            }

            Text {
                text: "↓"
                font.pixelSize: Math.round(12 * popup.fontScale)
                font.weight: Font.Bold
                color: popup.accentBlue
            }

            Text {
                text: common.formatTotal(popup.totalDownload)
                font.pixelSize: Math.round(13 * popup.fontScale)
                color: popup.primaryText
            }

            Text {
                text: "↑"
                font.pixelSize: Math.round(12 * popup.fontScale)
                font.weight: Font.Bold
                color: popup.accentGreen
            }

            Text {
                text: common.formatTotal(popup.totalUpload)
                font.pixelSize: Math.round(13 * popup.fontScale)
                color: popup.primaryText
            }

            Item { Layout.fillWidth: true }
        }

        // 分隔线3
        Rectangle {
            Layout.fillWidth: true
            Layout.preferredHeight: 1
            color: popup.cardBorder
            visible: popup.ready
        }

        // ==================== 分区4：接口切换 chip 列表 ====================
        // 水平滚动，物理网卡在前、虚拟网卡在后，顺序稳定不随切换变化
        // chip 少时分散撑满一行；chip 多超出宽度时固定宽度 + 水平滚动
        // 活动 chip 不在可视区域或被截断时，自动滚动露出完整样式（见 scrollToActiveChip）
        Flickable {
            id: chipFlickable
            Layout.fillWidth: true
            // 高度需容纳 chip（28px）+ 水平滚动条（~6px）+ 上下间距
            Layout.preferredHeight: 40
            visible: popup.ready && popup.networkInterfaces.length > 1
            contentWidth: Math.max(chipRow.width, width)
            contentHeight: chipRow.height
            flickableDirection: Flickable.HorizontalFlick
            clip: true

            // 平滑滚动动画：直接赋值 contentX 会被 Flickable 的拖拽/回弹行为覆盖，
            // 用 NumberAnimation 驱动 contentX 实现自动滚动，平滑且不冲突
            NumberAnimation {
                id: chipScrollAnim
                target: chipFlickable
                property: "contentX"
                duration: 200
                easing.type: Easing.OutCubic
            }

            // 用户开始拖拽/滑动时停止自动滚动，避免动画与用户操作争抢
            onMovementStarted: chipScrollAnim.stop()

            // 自动滚动使活动接口的 chip 完整可见：
            // 列表顺序稳定后活动 chip 可能位于可视区域外或被截断，
            // 切换接口或 popup 打开时调用，将其滚动露出完整样式。
            // animated=false 用于 popup 刚打开时立即定位，跳过滚动过程
            function scrollToActiveChip(animated) {
                if (!visible || width <= 0) return
                var idx = popup.sortedInterfaces.indexOf(popup.activeInterface)
                if (idx < 0) return
                var chip = chipRepeater.itemAt(idx)
                if (!chip) return
                var targetX = contentX
                if (chip.x < contentX) {
                    // chip 在可视区左侧之外：回滚使 chip 左边缘与可视区左缘对齐
                    targetX = chip.x
                } else if (chip.x + chip.width > contentX + width) {
                    // chip 在可视区右侧之外或被截断：滚动使 chip 右边缘与可视区右缘对齐
                    targetX = chip.x + chip.width - width
                }
                // 钳制到合法滚动范围 [0, contentWidth - width]，避免触发边界回弹
                targetX = Math.max(0, Math.min(targetX, Math.max(0, contentWidth - width)))
                if (Math.abs(targetX - contentX) < 1) return
                chipScrollAnim.stop()
                if (animated) {
                    chipScrollAnim.to = targetX
                    chipScrollAnim.start()
                } else {
                    contentX = targetX
                }
            }

            // 活动接口变化时（用户点击 chip 或后端自动切换）自动滚动露出活动 chip
            Connections {
                target: popup
                function onActiveInterfaceChanged() {
                    chipFlickable.scrollToActiveChip(true)
                }
            }

            // 等宽分配宽度：假设所有 chip 等宽撑满时的单个宽度
            readonly property real equalChipWidth: popup.sortedInterfaces.length > 0
                ? (width - 6 * (popup.sortedInterfaces.length - 1)) / popup.sortedInterfaces.length
                : 0

            Row {
                id: chipRow
                spacing: 6

                Repeater {
                    id: chipRepeater
                    model: popup.sortedInterfaces

                    Rectangle {
                        // 宽度取等宽和自然宽度的较大值：
                        // chip 少时 equalChipWidth > 自然宽度 -> 分散撑满一行
                        // chip 多时 自然宽度 > equalChipWidth -> 固定宽度 + 水平滚动
                        width: Math.max(chipFlickable.equalChipWidth, chipText.implicitWidth + 24)
                        height: 28
                        radius: 8
                        // 选中态：蓝色填充+蓝边框；未选中态：透明背景+cardBorder 边框
                        // hover 态：边框变蓝、文字变蓝，提供清晰交互反馈
                        color: modelData === popup.activeInterface
                               ? popup.accentBlue
                               : "transparent"
                        border.width: 1
                        border.color: modelData === popup.activeInterface
                                       ? popup.accentBlue
                                       : (chipMouse.containsMouse ? popup.accentBlue : popup.cardBorder)

                        Text {
                            id: chipText
                            anchors.centerIn: parent
                            text: modelData
                            font.pixelSize: Math.round(12 * popup.fontScale)
                            font.weight: modelData === popup.activeInterface ? Font.Bold : Font.Normal
                            color: modelData === popup.activeInterface
                                   ? "white"
                                   : (chipMouse.containsMouse ? popup.accentBlue : popup.primaryText)
                        }

                        MouseArea {
                            id: chipMouse
                            anchors.fill: parent
                            cursorShape: Qt.PointingHandCursor
                            hoverEnabled: true
                            onClicked: {
                                if (popup.applet) popup.applet.setActiveInterface(modelData)
                            }
                        }
                    }
                }
            }

            // 自定义滚动条样式：默认 ScrollBar 在面板配色下可能不可见，
            // 用 contentItem 显式绘制，颜色派生自 basePalette 适配深浅主题
            ScrollBar.horizontal: ScrollBar {
                id: chipScrollBar
                policy: ScrollBar.AsNeeded
                interactive: true

                contentItem: Rectangle {
                    implicitHeight: 4
                    radius: 2
                    // 按压时加深、悬停时中等、默认稍淡，保证滚动条在深浅主题下均可见
                    color: chipScrollBar.pressed ? popup.secondaryText
                          : (chipScrollBar.hovered ? popup.secondaryText : popup.tertiaryText)
                }
            }
        }

        // 填充剩余空间，将内容推至顶部
        Item { Layout.fillHeight: true }
    }
}

Step 3: 构建

Run: cmake --build build Expected: 编译成功，无错误

Step 4: 安装并重启 dde-shell

Run: sudo cmake --install build && systemctl --user restart dde-shell@DDE Expected: 安装成功，dde-shell 重启

Step 5: 手动验证弹窗布局

验证清单：

左键点击任务栏网络监控图标，弹窗打开
无卡片背景：毛玻璃通透，无 6% 透明度色块，四个区域用分隔线划分
接口信息区：显示类型图标（如 ∿）+ 接口名 + · + IPv4 地址，居中
IPv6 截断：IPv6 地址超长时末尾显示 …，hover 显示完整地址 tooltip
速度区：下载/上传标签在上（小字），箭头+数值 24px 粗体在下，单位 KB/s 小号
下载阈值变色：下载速度 >1MB/s 时数值变橙，>10MB/s 变红，否则蓝色
累计流量区：单行显示"总计 ↓ 4.85 GB ↑ 134 MB"，紧凑居中
chip 未选中态：透明背景 + 边框，清晰可辨
chip hover：边框变蓝，文字变蓝
chip 选中态：蓝色填充 + 白字
chip 滚动：接口多时可水平滚动，活动 chip 自动滚入可视区
无冗余标题：弹窗顶部无"网络速度监控"标题

Step 6: 手动验证深浅主题

验证清单：

切换系统到深色模式：弹窗毛玻璃深色底，文字浅色，对比度良好
切换系统到浅色模式：弹窗毛玻璃浅色底，文字深色，对比度良好
各分区文字层次清晰：速度数值 > 标签/接口名 > IPv6/总计标签

Step 7: 手动验证字体颜色适配

验证清单：

右键任务栏图标 -> 设置 -> 字体颜色 -> 选择红色
左键打开弹窗：接口名、速度数值（未超阈值时）、累计数值、chip 未选中文字变红
标签（下载/上传/总计）、IPv6、蓝绿箭头仍保持系统主题色，不跟随
设置 -> 字体颜色 -> 选择"跟随系统"：弹窗恢复 DTK 调色板派生色

Step 8: 手动验证网卡切换

验证清单：

弹窗底部点击不同 chip，接口信息区更新为对应网卡的图标、名称、IP
速度数值切换到对应网卡的数据
chip 选中态正确跟随切换

Step 9: 手动验证占位态

验证清单：

（如条件允许）断开所有网络接口或模拟无接口状态
左键打开弹窗：显示 ⚠ 图标 + "未检测到网络接口"文字，无其他分区

Step 10: 提交

git add package/networkview.qml package/components/NetworkPopup.qml
git commit -m "feat: 重新设计左键弹窗布局

采用通透分区方案，去掉自绘卡片背景改用分隔线+留白划分四区：
接口信息（含类型图标）/ 实时速度（24px 锚点）/ 累计流量 / 接口切换
速度数值与单位拆分显示，chip 未选中态改透明+边框
适配用户 textColor（仅主要文字跟随）、预留 fontScale 字号缩放扩展点"

验证总结

本计划无自动化测试，验证完全依赖手动构建+安装+视觉检查：

Task 1 验证设置窗口接口图标/描述不受影响（函数迁移无行为变化）
Task 2 验证弹窗新布局、深浅主题、字体颜色跟随、网卡切换、占位态

若构建或运行时报错，优先检查：

QML import 路径是否正确（import "." 在 SettingsWindow.qml 中）
NetCommon.qml 新增函数的 qsTr() 在 QtObject 内是否正常（应正常，qsTr 是全局函数）
RowLayout 内 Layout.alignment: Qt.AlignBaseline 是否被正确解析

32 KiB Raw Blame History Unescape Escape

左键弹窗重新设计 实现计划

Global Constraints

File Structure

Task 1: 提取共享函数到 NetCommon.qml + 更新 SettingsWindow.qml

Task 2: 重写 NetworkPopup.qml + 更新 networkview.qml 弹窗尺寸

验证总结

32 KiB

Raw Blame History

左键弹窗重新设计实现计划