# 应龙图YLTool **Repository Path**: imsan/yinglong-tool ## Basic Information - **Project Name**: 应龙图YLTool - **Description**: 应龙图YingLongTool 是一款运行于 deepin/UOS「任务栏（Dock）」上的系统状态监控插件。它以紧凑、可定制的方式在任务栏常驻展示实时硬件负载、网络速率、磁盘读写与本地天气，并附带一只会说话的应龙（中国龙）吉祥物，既能一眼掌握系统状态，也支持一键截图 / 贴图，将常用操作融入任务栏。 - **Primary Language**: C++ - **License**: GPL-3.0 - **Default Branch**: master - **Homepage**: https://imsan.cn/yltool - **GVP Project**: No ## Statistics - **Stars**: 2 - **Forks**: 0 - **Created**: 2026-08-14 - **Last Updated**: 2026-09-14 ## Categories & Tags **Categories**: Uncategorized **Tags**: deepin, UOS, 任务栏监控, 插件, 动态天气 ## README # 应龙图『YLTool』

## 关于名号应龙图 = 应龙（yinglong）+ 河图（tool，工具一语双关）组合而成，即yinglongtool，缩写YLTool。 > 「**应龙**」取自上古神话中**生有双翼的神龙**——应龙（Yīnglóng）。《广雅·释鱼》：「有翼曰应龙」，见载于《山海经》《楚辞》等典籍。取其**有翼、通晓风雨、护佑一方**之意。 > > 「**河图**」取自「河出图，洛出书，圣人则之」（《易·系辞上》）。相传黄河出龙马，身负黑白点阵之图，伏羲观之而画八卦，遂开华夏文明之先河。河图与洛书并称，为易学、历法、天文之源，载**天地之理、万物之数**。应龙与河图，同出黄河之水： 1. **应龙助黄帝战蚩尤**：涿鹿之战，应龙奉黄帝之命蓄水行雨以攻蚩尤；蚩尤请来风伯、雨师纵大风雨相抗，黄帝又遣天女魃止雨，终杀蚩尤。 2. **应龙助大禹治水**：据《楚辞·天问》王逸注，大禹治水时，应龙以尾画地，划出江河沟渠，导洪水入海——黄河亦在其列。 3. **河图出黄河**：龙马负图而出，伏羲得之，以通天地之理。应龙治水、河图出河，二者同根同源；本插件如应龙负河图：**以河图之象呈系统之息，以应龙之姿护桌面之安**。 ## 软件介绍应龙图是一款运行于 deepin/UOS「任务栏（Dock）」上的系统状态监控插件。它以紧凑、可定制的方式在任务栏常驻展示**实时硬件负载、网络速率、磁盘读写与本地天气**，并附带一只会说话的应龙（中国龙）吉祥物，既能一眼掌握系统状态，也支持一键截图 / 贴图 / 复制路径 / 彻底删除 / 关闭屏幕 / 锁屏，可一键更换 APT 软件源，还能在屏幕右上角常驻一块毛玻璃「桌面悬浮天镜」，并在文件管理器右键菜单中常驻相助，将常用操作融入任务栏。插件以内置弹窗（乾坤宝镜）承载更丰富的「监控详情 + 高级设置」，所有配置（显示位置、面板皮肤、城市、快捷键、软件源）即时生效并持久保存，无需重启桌面环境。 - 技术栈：DDE Shell 插件（QML 前端 + C++ 后端），通过 D-Bus 接口 `org.deepin.dde.Keybinding1` 管理系统自定义快捷键；特权操作（换源 / 端口释放 / 右键菜单部署 / 充电阈值）统一经 polkit `pkexec` 授权。 - 构建：`bash build.sh`（产物 `yinglongtool_<版本>_<架构>.deb`，架构为本机 `dpkg --print-architecture`） - 交叉构建：`bash build-arm64.sh`（产物 `yinglongtool_<版本>_arm64.deb`）、`bash build-loong64.sh`（产物 `yinglongtool_<版本>_loong64.deb`），均基于 QEMU 用户态模拟 + deepin 目标架构 rootfs 的 chroot 原生构建 - 安装：`sudo bash install.sh` ### 截图预览 [![预览](https://gitee.com/imsan/yinglong-tool/raw/master/imgs/ui/00.png)](https://gitee.com/imsan/yinglong-tool/releases) [![皮肤预览一](https://gitee.com/imsan/yinglong-tool/raw/master/imgs/ui/11.png)](https://gitee.com/imsan/yinglong-tool/releases) [![皮肤预览二](https://gitee.com/imsan/yinglong-tool/raw/master/imgs/ui/22.png)](https://gitee.com/imsan/yinglong-tool/releases) [![界面截图一](https://gitee.com/imsan/yinglong-tool/raw/master/imgs/ui/1.png)](https://gitee.com/imsan/yinglong-tool/releases) [![界面截图二](https://gitee.com/imsan/yinglong-tool/raw/master/imgs/ui/2.png)](https://gitee.com/imsan/yinglong-tool/releases) [![界面截图三](https://gitee.com/imsan/yinglong-tool/raw/master/imgs/ui/3.png)](https://gitee.com/imsan/yinglong-tool/releases) [![界面截图四](https://gitee.com/imsan/yinglong-tool/raw/master/imgs/ui/4.png)](https://gitee.com/imsan/yinglong-tool/releases) ### 功能简介 | 能力 | 说明 | | --- | --- | | 实时硬件监控 | CPU / GPU / 内存 / 固态硬盘占用率，数据每 1.5 秒刷新 | | 网络速率 | 上行 / 下行实时速率（KB/s 等），可显隐 | | 磁盘读写 | 实时读 / 写速率，自动切换单位（B/KB/MB/GB/s） | | 硬件信息 | 详情弹窗展示 CPU / GPU / 内存 / 磁盘型号与容量、网卡、电池；支持导出 Markdown / 图片 | | 端口占用 | 提权全量扫描 TCP / TCP6 监听端口与占用进程，逐项「释放」 | | 电池充电阈值 | 充电上限 50%~100% 六档（含不限制；需管理员授权，设备不支持时界面提示） | | 本地天气 | 当前温度 / 天气状况、逐小时预报、未来 5 日预报、城市候选搜索与历史城市下拉；天气细目（体感 / 湿度 / 风 / 降水 / 日出日落）与公历 + 农历日期 | | 桌面悬浮天镜 | 屏幕右上角常驻毛玻璃监控组件（桌面层，不挡窗口、不挤占工作区），默认关，弹窗「天镜悬浮」开关 | | 一键换源 | 「灵源换髓」下拉选镜像即授权换源（默认选中当前源），自定义源址回车应用；换源前自动备份、失败自动还原，仅改写 deepin 主仓库 | | 左侧子导航 | 镜檐「导航钮」展开灯笼子导航，七大模块一点定位 | | 七大模块 | 一方天象 / 元气监控 / 符箓阵图 / 灵丹法器 / 灵源换髓 / 五灵妙法 / 关于名号 | | 显示位置 | 左区 / 任务栏左 / 任务栏右 / 托盘左 / 托盘右五档，即时生效 | | 面板皮肤 | 紧凑数字 / 图表风格（玻璃管液柱）两种外观 | | 自定义快捷键 | 截图 `F1` / 贴图 `F3` / 复制路径 `Ctrl+Shift+C` / 彻底删除 `Shift+Delete` / 关闭屏幕 `F8` / 锁屏 `F7` | | 右键菜单扩展 | 文件管理器右键「复制路径」「彻底删除（不进回收站）」（默认启用，可开关） | | 河图·修仙等级 | 镜檐河图古风图标 + 修仙等级，点击窥修行历程（更新日志） | | 应龙吉祥物 | 任务栏应龙纯装饰动画；宝镜内青龙左键 +1 / 双击 +2 / 右键 +3，可一键清空 | | 按键积灵液 | 「灵丹法器」开关（默认关）：每按字母 / 数字键 1 次实时 +1（内存计数），60 秒落盘一次，退出前强制落盘 | | 弹窗布局记忆 | 模块折叠与磁盘 / 端口明细展开状态持久化，重开宝镜保持原样 | | 应龙出行（桌宠） | 任务栏上沿行走 LayerShell 小窗：九态状态机（行走 / 转向 / 驻足 / 挂起 / 拖拽）、空闲歇脚小剧场、摸头 / 拖拽彩蛋；系统事件触发表情反应（过热吐火 / 降温报喜 / 天象预警惊醒等）；形象可选手绘应龙或 OpenPets 精灵（内置「咕咕教授」，支持 openpets.dev 换装）。当前版本暂未开启（待双会话验证），设置页保留 | | 流光史册 / 灵台透视 | 监控历史与实时明细独立弹窗：无框可拖拽，右上角「钉住」驻留桌面置顶；任务栏分区点击直达（网速 → 流光史册，CPU / 内存 → 灵台透视） | | 偏好设置窗口 | 报警 / 桌宠设置 / 天象预警三页独立窗口（左导航 + 分卡片样式），宝镜「前往设置」直达，全量随明暗主题 | ## 五灵妙法（使用说明）此「应龙图」乃一件有灵性的护身秘宝，常伴君侧，观天地之变、察系统之息。以下为驭宝之法，望道友细细研读，方可令此宝如臂使指。 ### 任务栏交触 | 手势 | 区域 | 秘法之效 | | --- | --- | --- | | 左键轻叩 | 监控区 | 展开「乾坤宝镜」并直达「流光史册」（历史曲线） | | 右键轻叩 | 监控区 | 展开「乾坤宝镜」并直达「灵犀示警」（告警设置） | | 左键两击 | 监控区 | 召请「系统监天司」（系统监视器） | | 右键轻叩 | 天气区 | 隐去 / 现出监控法阵 | | 左键轻叩 | 天气区 | 展开 / 收起「乾坤宝镜」 | > 任务栏上的应龙为纯装饰、不设互动；其互动已移入宝镜内「一方天象」右侧的青龙（左键功德 +1、双击 +2、右键 +3，悬浮偶吐妙语）。 > > 宝镜之内，轻点空白处即可闭合；或按 `Esc`、点触镜外虚空，同样退散。 ### 乾坤宝镜（详情弹窗）宝镜镜檐左上「导航钮」轻触可展开 / 收起左侧灯笼子导航，七大模块一点即定位到对应模块；镜檐右上「河图·修仙等级」轻触可窥修行历程（版本记录）。镜内分为七重： 1. **一方天象（壹）**：现时之城、温度、天气之状、高低温，并有两张可换之卡——「今朝·逐时辰」与「未来五日」，轻点卡下圆点即可翻转观览；天气细目（体感 / 湿度 / 风向风级 / 降水概率 / 日出日落）与公历 + 农历日期随天气一并展示，跨零点自动翻篇。 - 移城换址：于下拉匣中择过往之城（首项恒为当前生效城市，可清空历史），或在输入框中写下城名后按 `Enter`（支持候选城市搜索，按行政级别标注）。 - 右侧青龙：左键功德 +1、双击 +2、右键 +3，悬浮偶吐妙语；青龙右上「清空」角标可一键清零。 2. **元气监控（贰）**：CPU / GPU / 内存 / 固态之海占用尽收眼底，化为一根根灵力进度之条，并附硬件之名讳与容量；磁盘读 / 写、网络上行 / 下行之速，亦清晰可辨。每项之前皆有勾选之匣，可开关该指标在**任务栏上**的显隐；上下箭头可挪移监控项位次；「分区」可张展勾选分区、尽选 / 尽弃。标题右侧「系统监天司」可一念唤出 `deepin-system-monitor`。网卡项下附**「端口占用」折叠子块**：张展即经管理员授权全量扫描 `TCP / TCP6` 监听端口与占用进程（常见服务显中文名，未知进程标「系统占用」），点「释放」终止占用进程。 3. **符箓阵图（叁）**： - **安放方位**：左侧区（启动器旁）/ 任务栏左 / 任务栏右 / 右侧区·托盘左侧 / 右侧区·托盘右侧。移形换位，即改即应，无需重启。 - **宝镜之肤**：紧凑数字 / 图表风格。图表风格以玻璃管液柱呈现占用（CPU 项附历史波形），切换即应。 - **天镜悬浮**：桌面悬浮天镜开关（默认关），详见下文「桌面悬浮天镜」。 - **充电阈值**：笔记本充电上限 50%~100% 六档（含不限制；需管理员授权，一次授权后短期免密；无电池或设备不支持时界面提示）。 - **重启任务栏**：「立即重启」一键重启 dde-shell 任务栏服务，任务栏卡死 / 图标不刷新时应急；插件随任务栏短暂消失后自动恢复。 4. **灵丹法器（肆）**：法诀铭刻、右键菜单与灵液积攒，三件套可折叠： - **法诀铭刻（快捷键）**：摄形（截图，默认 `F1`）、钉图（贴图，默认 `F3`）、关闭屏幕（默认 `F8`）、锁屏（默认 `F7`）。每项右侧**捕获匣**轻触进入待机、按下新键即可铭刻，或点「复归初态」重置；法诀经系统「自定义快捷键」册铭刻，即设即应、重启不失。（复制路径 / 彻底删除的法诀见下文，主要由「文件管理器右键菜单」调用） - **右键菜单扩展**：「复制路径」「彻底删除」两枚开关（默认开启）——勾选 / 取消即经管理员授权（一次授权后短期免密）部署 / 移除 dde-file-manager 右键菜单项。 - **按键积灵液**：开关（默认关），勾选后每按字母 / 数字键一次 +1 点灵液，可以在应龙 / 青龙处清空（详见「按键积灵液」）。 5. **灵源换髓（伍）**：APT 软件源查看与一键更换，详见下文「一键换源」。 6. **五灵妙法（陆）**：即本文——「任务栏交触」「宝镜内要」「法诀一览」与宝镜内模块一一对应，望道友常阅。详见下文。 7. **关于名号（柒）**：应龙图命名由来与应龙典故、版本历程与检查更新。 ### 法诀快捷键（自定义快捷键）宝镜底座「快捷键设置」可铭刻系统级法诀，经 D-Bus 接口 `org.deepin.dde.Keybinding1` 刻入系统「自定义快捷键」金册，记下即刻生效，重启亦不失。 - **摄形（截图）**：默认为 `F1`。一念摄下当前天地之影。 - **钉图（贴图 / 钉图）**：默认为 `F3`。将最近所摄之影化为贴图悬窗，悬窗会精准落于**所摄之处**，而非鼠灵所驻之地。 - **巡径（复制路径）**：默认为 `Ctrl+Shift+C`。一键把文件 / 目录路径写入剪贴板（X11 xclip / Wayland wl-copy，支持多选换行分隔）。 - **除祟（彻底删除）**：默认为 `Shift+Delete`。一键调起确认后永久删除（绕过回收站）；亦可配合文件管理器右键菜单使用。 - **息屏（关闭屏幕）**：默认为 `F8`。一键关闭屏幕（多路回退策略覆盖 deepin v25/v23/v20 与 X11 / Wayland，锁屏兜底；按任意键唤醒）。 - **锁屏**：默认为 `F7`。一键锁定会话（优先 deepin `lockFront` D-Bus 接口，回退 `loginctl lock-session`）。 - **铭刻之法**：轻触捕获之匣进入待机，按下心中之键或组合（如 `F1`、`Ctrl+Alt+A`）；点「复归初态」可重置。 - **冲突之劫**：若所设之键已被系统全局法诀所占（如 `F1` 本为召出「帮助」），插件收不到此键、铭刻亦会失利，界面将现警示（例如「按键 F1 已被「帮助」占用，请先在系统快捷键设置中停用」）。须先于系统「快捷键」册中废去旧有之印，再回宝镜内重刻。 > 钉图之诀：贴图时会解析摄形法器之书（`~/.cache/deepin/deepin-screen-recorder/deepin-screen-recorder.log`）中所记最近摄形区域（十息之内有效，按 `m_pixelRatio` 换算物理坐标）。若距上次摄形已过十息，则退而落于鼠灵当下之位。 ### 文件管理器右键菜单安装后即向 dde-file-manager 部署两枚右键菜单符（默认启用，可在「灵丹法器」中开关，经 pkexec 授权部署 / 移除）： - **复制路径**：把选中文件 / 目录的路径写入剪贴板（多选以换行分隔），X11 走 `xclip`、Wayland 走 `wl-copy`。 - **彻底删除（不进回收站）**：绕过回收站直接抹除，与系统自带删除（移入回收站、可还原）明确区分。删除前弹出**随包安装的 Qt6 原生确认框** `force-delete-gui`：红字警示"绕过回收站直接抹除"、内置与系统删除的对比说明、展示待删项数与总大小，并须勾选"我已了解数据将直接抹除"后「永久删除」按钮方可用（默认焦点在「取消」）；删除完成后桌面通知结果（成功 N 项 / 失败 M 项及原因），绝不静默误删。 > 卸载时（`uninstall.sh` / deb `prerm`）会自动移除这两枚右键菜单符。菜单文案带 `X-Yinglong-Revision` 版本号，插件升级后自动重部署新文案（一次授权）。 ### 一键换源（APT 软件源）「灵源换髓（伍）」模块用于查看与更换 APT 软件源（`/etc/apt/sources.list` 的 deepin 主仓库）： - **查看**：顶部输入框实时显示当前生效的主源地址（首个 `deb` / `deb-src` 行）。 - **一键换源**：下拉匣预置华为云 / 清华大学 / 阿里云 / 中国科技大学 / 网易 / deepin 官方六个镜像，**默认选中当前源**；选中任一镜像即触发管理员授权（pkexec，一次授权后短期免密）并开始切换，无需再点按钮。 - **自定义源址**：直接修改输入框中的地址，回车（或失焦）即校验应用，须以 `http://` / `https://` 开头。 - **安全机制**：换源前自动备份原文件，**失败自动还原**（无需手动操作）；仅改写 deepin 主仓库行，不动其他源；换源日志实时展示。 ### 桌面悬浮天镜「符箓阵图（叁）」中勾选「天镜悬浮」（默认关）后，屏幕**右上角**常驻一块毛玻璃监控组件（类 macOS 桌面小组件）： - **桌面层悬浮**：锚定屏幕右上角，置于壁纸之上、普通窗口之下（被窗口正常遮挡，不挡内容）；不向合成器申请排他区，不挤占工作区、自动避让顶栏。 - **全量监控明细**：CPU（占用 + 温度）、显卡、内存、存储、磁盘读写、网络、风扇逐行展示（无数据项自动隐藏），百分比项配动画进度条，底部 16 拍 CPU 占用波形。 - **纯展示**：不响应鼠标点击、不弹任何窗口；托盘「停止监控」关闭时随任务栏一同隐藏。 ### 应龙出行（桌宠）任务栏上沿行走的 LayerShell 小窗：九态状态机（行走 / 转向 / 驻足 / 挂起 / 拖拽），对角步态、双翼扑扇，空闲挂起歇脚并随机小剧场；系统事件映射为表情反应——过热惊慌吐火、降温报喜、天象预警惊醒挂起、换源专注、登场挥手，摸头月牙眼、戳鳞惊呼。形象两套可切：**手绘应龙**（Q 版写实幼龙程序化绘制：鹿角、狮鬃、鲶须、叠瓦鲤鳞、虎掌鹰爪、金色背鳍尾鳍与「龙戏珠」火珠）与 **OpenPets 精灵**（内置 MIT 授权「咕咕教授」，亦可到 openpets.dev 下载任意宠物 zip 解压换装，无效自动回落）。设置在偏好窗口「桌宠设置」页。 > 当前版本桌宠整体屏蔽未启用（双会话行为验证后一键放开），设置项保留。 ### 按键积灵液（按键积功德）在「灵丹法器（肆）」中勾选「按键积灵液」（默认关）后，每按一次字母 / 数字键（`A-Z` / `0-9`）即积 1 点灵液： - **实时计数**：按键由后台 `keymerit` 程序观察（X11 XRecord 扩展），每按 1 次内存计数 +1，并即刻写入实时文件 `~/.config/cn.zhang/yinglongtool.keymerit`；插件每 1.5 秒读取「持久值 + 实时增量」，任务栏 / 宝镜内的功德数即时刷新，并弹出「灵液 +N」浮层。 - **落盘时机**：每 60 秒将累计灵液并入 `~/.config/cn.zhang/yinglongtool.conf` 的 `[Dragon] meritCount`，随后归零实时文件；退出前强制落盘，不留遗漏。 - **一键清空**：青龙右上「清空」角标可清零功德；`keymerit` 约 5 秒内检测到计数回退即重置自身增量，不会「复生」。 - **平台限制**：XRecord 仅能观察 X11 / XWayland 会话的按键；纯 Wayland 会话下 `keymerit` 自动退出，功能不生效。 ### 托盘图标（系统托盘区）安装后会常驻一个**独立系统托盘图标**（应龙图标），与 Dock 插件相互独立——即使 Dock 插件未加载，托盘图标仍存在。 - **右键菜单**提供：打开监控与设置、停止服务、卸载应龙图、关于、退出托盘。 - **单击 / 双击**托盘图标：若 dde-shell 面板未运行则拉起，使 Dock 插件详情弹窗可用。 - 托盘程序为独立可执行：`/usr/bin/yinglongtray`（Qt6 `QSystemTrayIcon`，通过 StatusNotifierItem 协议显示），图标随包提供 16~256 多档尺寸（`package/tray/`）。 - 已配置开机自启（`/etc/xdg/autostart/cn.zhang.yinglongtool-autostart.desktop`）。 ### 启动器入口安装后在**启动器**出现「应龙图」图标（`.desktop` 位于 `/usr/share/applications/`），点击即运行 `yinglongtray` 托盘程序；托盘右键「卸载应龙图」可一键卸载。 ### 停止 / 启用监控托盘右键「停止监控」即可让**任务栏监控控件消失**（插件文件保留，仅禁用加载）：脚本将插件 `.so` 与元数据目录改名加 `.disabled` 后缀并重启 dde-shell，dde-shell 扫描不到插件即不再加载。之后托盘菜单变为「启用监控」，点击即恢复。需要管理员授权（pkexec）。 ## 目录结构 ``` dde-shell-stats-plugin/ ├── CMakeLists.txt # 构建定义（Dock 插件 + force-delete-gui + keymerit + yinglongtray） ├── build.sh # 编译 + 打包 deb（debian/ 为单一打包来源） ├── build-arm64.sh # arm64 交叉构建（QEMU + chroot 原生构建） ├── build-loong64.sh # loong64 交叉构建 ├── install.sh # 安装 / 部署脚本（含托盘自启） ├── stop.sh # 停止 dde-shell 面板 ├── uninstall.sh # 卸载（含托盘/桌面/右键菜单清理） ├── debian/ # deb 打包定义（changelog / control / rules / postinst / prerm / postrm） ├── keymerit/ # 按键积灵液后台程序（X11 XRecord 观察 A-Z/0-9） │ └── keymerit.c ├── force-delete-gui.cpp # 「彻底删除」确认对话框（Qt6，随包安装） ├── menu-extensions.sh # 文件管理器右键菜单部署 / 移除脚本（pkexec） ├── copy-path.sh # 右键「复制路径」辅助脚本（xclip / wl-copy） ├── force-delete.sh # 右键「彻底删除」辅助脚本（确认 + 删除 + 结果通知） ├── apt-source.sh # APT 换源脚本：查看 / 切换 / 还原备份（pkexec） ├── port-helper.sh # 端口提权扫描与释放进程脚本（pkexec） ├── set-charge-threshold.sh # 电池充电阈值脚本（pkexec） ├── tray/ # 独立系统托盘程序 │ ├── yinglongtray.cpp # Qt6 QSystemTrayIcon 实现 │ ├── CMakeLists.txt # 托盘程序构建 │ ├── yinglongtray.service # systemd 用户服务 │ ├── cn.zhang.yinglongtool.policy # polkit 授权规则 │ ├── cn.zhang.yinglongtool.desktop # 启动器条目 │ └── cn.zhang.yinglongtool-autostart.desktop # 开机自启条目 ├── package/ # QML 前端资源 │ ├── main.qml # 组合根：任务栏条 + 弹窗骨架 + 灯笼子导航 │ ├── SkySection.qml # 壹 · 一方天象（天气） │ ├── MonitorSection.qml # 贰 · 元气监控（硬件 / 端口占用） │ ├── SecretSection.qml # 叁 · 符箓阵图（位置 / 皮肤 / 天镜 / 充电阈值 / 重启任务栏） │ ├── ShortcutSection.qml # 肆 · 灵丹法器（快捷键 / 右键菜单 / 积灵液） │ ├── AptSection.qml # 伍 · 灵源换髓（APT 一键换源） │ ├── GuideSection.qml # 陆 · 五灵妙法（使用说明） │ ├── AboutSection.qml # 柒 · 关于名号（命名 / 版本 / 检查更新） │ ├── DesktopWidget.qml # 桌面悬浮天镜（LayerShell 毛玻璃组件） │ ├── HardwareInfoLayer.qml # 硬件信息详情覆盖层（含导出 MD / 图片） │ ├── WeatherIcon.qml # 天气动画图标 │ ├── DragonIcon.qml # 应龙图标 │ ├── metadata.json # 插件元数据 │ ├── hetu.webp # 河图图标（镜檐右上） │ ├── yinglong-48x64.webp # 任务栏应龙动画 │ ├── yinglong-192x256.webp # 宝镜内应龙动画 │ └── tray/ # 托盘多尺寸图标（16~256） ├── src/ # C++ 后端（核心 + 7 领域模块） │ ├── statsapplet.h/.cpp # 核心：属性 / 信号 / 周期调度 / 持久化 │ ├── statsapplet_apt.cpp # 软件源（读取 / 换源 / 还原） │ ├── statsapplet_hardware.cpp # 硬件信息与导出 │ ├── statsapplet_menus.cpp # 右键菜单部署与自愈 │ ├── statsapplet_monitor.cpp # 监控采样（CPU / GPU / 内存 / 磁盘 / 网络） │ ├── statsapplet_ports.cpp # 端口占用扫描与释放 │ ├── statsapplet_shortcuts.cpp # 自定义快捷键（D-Bus Keybinding1） │ ├── statsapplet_weather.cpp # 天气 / 城市搜索 / 农历 │ └── statsapplet_helpers.h # 领域模块共用辅助 └── translations/ # 多语言翻译（20+ 语言） ``` ## 修行历程 ### 筑基大圆满[v1.3.0 2026-09-07] - 里程碑：筑基期功德圆满，下一大境界**金丹期**。 - 应龙 OpenPets：**反应体系**（系统事件即表情——过热吐火 / 降温报喜 / 天象预警惊醒 / 摸头月牙眼 / 升阶彩纸等）+ **形象切换**（手绘应龙 / 内置 MIT「咕咕教授」精灵，支持 openpets.dev 换装）。 - 流光史册 / 灵台透视：迁出宝镜为**独立可拖拽弹窗**，右上角「钉住」驻留桌面置顶；任务栏分区点击直达（网速 → 史册，CPU / 内存 → 灵台）。 - 偏好设置窗口三页（报警 / 桌宠设置 / 天象预警）样式精修，全量随明暗主题；任务栏监控项默认显隐感知本机。 - 除祟·彻底删除刷新脉冲：删除后父目录瞬时探针促文件管理器**即时刷新**，无需手动刷新。 - 流光史册：X11 点外部关闭加 30ms 轮询兜底；镜檐名号改英文短名「YLTool」。 - 桌宠整体屏蔽闸临时关闭（双会话行为验证后一键放开）。 ### 筑基后期[v1.2.0 2026-08-29] - 应龙桌宠上帧：任务栏行走小窗（九态状态机 / 空闲挂起 / 拖拽彩蛋）+ Q 版写实幼龙形象；报警与桌宠设置迁入独立偏好设置窗，修复报警入口误开硬件页。 ### 筑基中期[v1.1.25 2026-08-29] - 维护版本：1.1.20 起仅构建推进，无功能变更。 ### 筑基中期[v1.1.19 2026-08-29] - 代码模块化重构：C++ 后端拆为**核心 + 7 领域模块**，QML 拆为**组合根 + 8 个宝镜分节组件**，行为不变。 - 检查更新修复：当前版本改读插件元数据，托盘「关于」版本改编译期注入；任务栏底色左缘延伸 3px。 ### 筑基中期[v1.1.12 2026-08-29] - 桌面悬浮天镜：屏幕右上角毛玻璃监控组件，置于桌面层不挡窗口，「符箓阵图」可开关。 - 明暗主题深化：按钮 / 下拉框 / 链接 / 温度条全面主题化；任务栏新增半透明圆角底色卡片。 - 灵源换髓：下拉选镜像即授权换源、默认选中当前源、源址框改自定义源入口。 - 除祟·彻底删除：红字警示 + 勾选确认 + 待删项数与总大小 + 完成桌面通知。 - 弹窗布局记忆：模块折叠与磁盘 / 端口明细展开状态持久化。 ### 筑基初期[v1.0.0 2026-08-27] - 首个正式版。端口占用（提权全量扫描 / 一键释放）、立即重启任务栏、积灵液校准防反弹、应龙动画 v7、青龙随机吉祥词与竖排模块名。 ### 练气十三层[v0.13.0 2026-08-26] - 河图外观与灯笼子导航、天气细目与公历农历双日期、五枚法诀快捷键、右键菜单（复制路径 / 彻底删除）、keymerit 积灵液升级。 ### 练气十二层[v0.12.0 2026-08-24] - 复制路径快捷键与右键菜单、按键积灵液（keymerit 后台计数）、功德「清空」角标。 ### 练气十一层[v0.11.0 2026-08-23] - 和风天气国内源、公网 IP 自动定位、监控双行网格布局（swap / 内外网 IP / 风扇 / 磁盘读写分行）、硬件信息详情覆盖层。 ### 练气十层[v0.10.0 2026-08-23] - 弹窗与监控区严格对齐、六大模块可点击折叠、新版本提示跳转 releases。 ### 练气九层[v0.9.0 2026-08-22] - 电池充电阈值设置、CPU 频率显示、arm64 / loong64 交叉构建。 ### 练气八层[v0.8.0 2026-08-22] - 多硬盘 / 虚拟网卡 / 多 GPU（含 NVIDIA）兼容；采样与启动性能优化。 ### 练气七层[v0.7.0 2026-08-21] - 宝镜导航钮与六大模块重组、元婴「闭关炼丹」更新浮层、青龙互动移入宝镜、城市候选搜索。 ### 练气六层[v0.6.0 2026-08-21] - 天气与监控板块对调、驭宝要诀操作说明、青龙功德 +1/+2/+3。 ### 练气五层[v0.5.0 2026-08-20] - 监控数值右对齐、网速与磁盘读写分行、图标收敛为 64 / 128 / 256 三档。 ### 练气四层[v0.4.0 2026-08-19] - 截图 F1 经 D-Bus 强制注册；托盘改 systemd 用户服务自启，修复登录不自启与双图标问题。 ### 练气三层[v0.3.0 2026-08-18] - 显示位置切换即时生效；支持 F1 等单键快捷键，新增冲突检测提示。 ### 练气二层[v0.2.0 2026-08-18] - 快捷键设置界面重构、应龙 / 天气主题图标与动图资源。 ### 练气一层[v0.1.0 2026-08-17] - 自定义快捷键（截图 / 贴图）、监控项显隐配置、图表皮肤与亮色主题适配。 ### 初入山门[v0.0.0 2026-08-14] - 初始版本：Dock 监控入口与自定义位置、网络 / 磁盘速率、CPU / 内存 / 磁盘信息、天气展示。