[AI Development Lab] 【deepin插件开发活动】应龙图YLTool—任务栏天气系统监控插件
Tofloor
poster avatar
张叁
deepin
2026-08-21 20:15
Author

一、作品简介

应龙图 = 应龙(yinglong)+ 河图(tool,工具一语双关)组合而成,即yinglongtool,缩写YLTool。

「应龙」取自上古神话中生有双翼的神龙——应龙(Yīnglóng)。《广雅·释鱼》:「有翼曰应龙」,见载于《山海经》《楚辞》等典籍。取其有翼、通晓风雨、护佑一方之意。

「河图」取自「河出图,洛出书,圣人则之」(《易·系辞上》)。相传黄河出龙马,身负黑白点阵之图,伏羲观之而画八卦,遂开华夏文明之先河。河图与洛书并称,为易学、历法、天文之源,载天地之理、万物之数。

应龙与河图,同出黄河之水:

  1. 应龙助黄帝战蚩尤:涿鹿之战,应龙奉黄帝之命蓄水行雨以攻蚩尤;蚩尤请来风伯、雨师纵大风雨相抗,黄帝又遣天女魃止雨,终杀蚩尤。
  2. 应龙助大禹治水:据《楚辞·天问》王逸注,大禹治水时,应龙以尾画地,划出江河沟渠,导洪水入海——黄河亦在其列。
  3. 河图出黄河:龙马负图而出,伏羲得之,以通天地之理。

应龙治水、河图出河,二者同根同源;本插件如应龙负河图:以河图之象呈系统之息,以应龙之姿护桌面之安。

预览图

00.png

22.png

11.png

1.png

2.png

3.png

4.png

二、源码仓库

三、开发方向与所用 Skill

  • 开发方向:方向四 · 扩展 DDE Shell 的桌面能力(Dock 任务栏插件),并附带一个独立的系统托盘程序
  • 使用的 deepin Skill:dde-shell-development
  • 技术栈:DDE Shell Applet(QML 前端 + C++ 后端)、Qt6、D-Bus(org.deepin.dde.Keybinding1)、Qt6** **QSystemTrayIcon 托盘

四、功能介绍

能力 说明
实时硬件监控 CPU / GPU / 内存 / 固态硬盘占用率,数据每秒刷新
网络速率 上行 / 下行实时速率(KB/s 等),可显隐
磁盘读写 实时读 / 写速率,自动切换单位(B/KB/MB/GB/s)
硬件信息 详情弹窗展示 CPU / GPU / 内存 / 磁盘型号与容量、网卡、电池
本地天气 当前温度 / 天气状况、逐小时预报、未来 5 日预报、城市候选搜索;天气细目(体感 / 湿度 / 风 / 降水 / 日出日落)与公历 + 农历日期
左侧子导航 镜檐「导航钮」展开灯笼子导航,四大模块(一方天象 / 元气监控 / 符箓阵图 / 灵丹法器)一点定位
六大模块 一方天象 / 元气监控 / 符箓阵图 / 灵丹法器 / 五灵妙法 / 关于名号
显示位置 左区 / 任务栏左 / 任务栏右 / 托盘左 / 托盘右 五档,即时生效
面板皮肤 紧凑数字 / 图表风格(玻璃管液柱)两种外观
自定义快捷键 截图 F1 / 贴图 F3 / 复制路径 Ctrl+Shift+C / 彻底删除 Shift+Delete / 关闭屏幕 F8
右键菜单扩展 文件管理器右键「复制路径」「彻底删除」(默认启用,可开关)
河图·修仙等级 镜檐河图古风图标 + 修仙等级,点击窥修行历程(更新日志)
应龙吉祥物 任务栏应龙纯装饰动画;宝镜内青龙左键 +1 / 双击 +2 / 右键 +3,可一键清空
按键积灵液 「灵丹法器」开关(默认关):每按字母 / 数字键 1 次实时 +1(内存计数),60 秒落盘一次,退出前强制落盘

五、安装方式

1.下载安装包 https://gitee.com/imsan/yinglong-tool/releases/

2.下载源码自己编译打包

git clone git@gitee.com:imsan/yinglong-tool.git
cd yinglong-tool/dde-shell-stats-plugin
bash build.sh          # 编译 + 打包 → cn.zhang.yinglongtool_<版本>_all.deb
sudo bash install.sh   # 安装并部署(含托盘开机自启)

安装后启动器出现「应龙图」图标,Dock 上出现监控控件;托盘右键「卸载应龙图」一键卸载。

六、使用说明

此「应龙图」乃一件有灵性的护身秘宝,常伴君侧,观天地之变、察系统之息。以下为驭宝之法,望道友细细研读,方可令此宝如臂使指。

任务栏交触

手势 区域 秘法之效
左键轻叩 监控区 展开 / 收起「乾坤宝镜」(详情弹窗)
右键轻叩 监控区 召请「系统监天司」(系统监视器)
左键两击 监控区 同样召请「系统监天司」
右键轻叩 天气区 隐去 / 现出监控法阵
左键轻叩 天气区 展开 / 收起「乾坤宝镜」

任务栏上的应龙为纯装饰、不设互动;其互动已移入宝镜内「一方天象」右侧的青龙(左键功德 +1、双击 +2、右键 +3,悬浮偶吐妙语)。

宝镜之内,轻点空白处即可闭合;或按 Esc、点触镜外虚空,同样退散。

更多操作说明见查看仓库,版本迭代变更较快。

七、开发过程说明(deepin Skills 辅助开发)

本项目从 8 月 14 日(v1.0.0)至今

全程借助** **dde-shell-development 技能辅助开发:

  1. 框架与 API 参考:查阅 dde-shell Applet、PanelPopup、Dock 坐标定位与右键交互规范(参照** **launcheritem.qml),确保弹窗定位准确、符合 v25 框架约定。
  2. 定位与交互实现:在** main.qml 挂载 DTK 风格详情弹窗,复用 **applet.* 实时属性,随 Dock 横竖方向自适应。
  3. 迭代维护:历经 8 个版本——从初版「托盘监控入口 + 网速/磁盘读写 + 天气」,逐步加入自定义快捷键、面板皮肤、六大模块导航、应龙吉祥物。

八.skill调用截图

截图_dsh-desktop-launcher_20260821201449.png

截图_dsh-desktop-launcher_20260821200956.png

🙏 感谢 deepin 社区与 deepin Skills 团队,欢迎大家 clone 体验、提 issue 交流!


Reply Favorite View the author
All Replies
avatar
心有灵犀1934
deepin
2026-08-21 21:34
#1

强👍

Reply View the author
avatar
骑🐖追帅哥bot
Moderator
2026-08-21 21:40
#2

哇

Reply View the author
avatar
q77190858
deepin
2026-08-22 09:41
#3

越来越丰富了,棒

Reply View the author
avatar
张叁
deepin
2026-08-22 19:38
#4
骑🐖追帅哥bot:

哇

今天继续优化了个版本

Reply View the author
avatar
SmallDimples
deepin
2026-08-22 20:58
#5

这个太实用了,要是有loon64的版本就好了

Reply View the author
avatar
张叁
deepin
2026-08-22 21:04
#6
SmallDimples:

这个太实用了,要是有loon64的版本就好了

我没有设备测试,明天编译个版本发上来

Reply View the author
avatar
imysl89
deepin
2026-08-22 23:25
#7

👍

Reply View the author
avatar
张叁
deepin
2026-08-24 18:51
#8

WB的混元改前端改的想吐,恨不得自己动手 发布了个预览版,明天继续

练气十二层[v0.12.0 2026-08-24] · 张叁/应龙图YingLongTool - Gitee.com

Reply View the author
avatar
Linux初学者
deepin
2026-08-26 09:25
#9

这个插件是我需要的功能,界面也很好,不过遇到几个问题,请楼主考虑:

1、安装:gitee上0.9版本才有.deb安装包,更高的版本只有源码,我开始下载了0.12版本的源码,编译时报了一堆错,通过AI也没解决掉,只好装了0.9版本,希望最新的版本也能打包好

2、任务栏位置:安装好后默认是在靠近右边的托盘区,界面上可以选择停靠位置,但选择后电脑一旦重启就会自动复位到靠近右边托盘区,希望能在选择后如果不改变,就一直生效,不因重启而恢复默认设置

3、插件显示字体颜色不能改变,主题不同时,显示内容看不清,希望可自定义字体颜色,如下图
image.png

4、自带截图功能的快捷键是F1,和snipaste冲突,希望可以改后固定住,不再自动恢复默认

Reply View the author
avatar
张叁
deepin
2026-08-27 18:21
#10
Linux初学者:

这个插件是我需要的功能,界面也很好,不过遇到几个问题,请楼主考虑:

1、安装:gitee上0.9版本才有.deb安装包,更高的版本只有源码,我开始下载了0.12版本的源码,编译时报了一堆错,通过AI也没解决掉,只好装了0.9版本,希望最新的版本也能打包好

2、任务栏位置:安装好后默认是在靠近右边的托盘区,界面上可以选择停靠位置,但选择后电脑一旦重启就会自动复位到靠近右边托盘区,希望能在选择后如果不改变,就一直生效,不因重启而恢复默认设置

3、插件显示字体颜色不能改变,主题不同时,显示内容看不清,希望可自定义字体颜色,如下图
image.png

4、自带截图功能的快捷键是F1,和snipaste冲突,希望可以改后固定住,不再自动恢复默认

最近几个版本变更较多,没有打包,正式版正在 打包 筑基初期[v1.0.0 2026-08-27] 你说的问题我晚上再看下,感谢反馈

Reply View the author
avatar
骑🐖追帅哥bot
Moderator
2026-08-28 11:01
#11
Linux初学者:

这个插件是我需要的功能,界面也很好,不过遇到几个问题,请楼主考虑:

1、安装:gitee上0.9版本才有.deb安装包,更高的版本只有源码,我开始下载了0.12版本的源码,编译时报了一堆错,通过AI也没解决掉,只好装了0.9版本,希望最新的版本也能打包好

2、任务栏位置:安装好后默认是在靠近右边的托盘区,界面上可以选择停靠位置,但选择后电脑一旦重启就会自动复位到靠近右边托盘区,希望能在选择后如果不改变,就一直生效,不因重启而恢复默认设置

3、插件显示字体颜色不能改变,主题不同时,显示内容看不清,希望可自定义字体颜色,如下图
image.png

4、自带截图功能的快捷键是F1,和snipaste冲突,希望可以改后固定住,不再自动恢复默认

成功参与!

Reply View the author
avatar
张叁
deepin
2026-08-29 09:45
#12

有设备朋友帮忙测试下其他两个架构包能否正常运行,感谢

筑基中期[v1.1 2026-08-29] · 张叁/应龙图YLTool - Gitee.com

筑基中期[v1.1.19 2026-08-29]

代码模块化重构:C++ 后端 statsapplet.cpp(4862 行)按领域拆为核心 + 7 个模块(监控采样 / 端口占用 / 天象 / 硬件 / 快捷键 / 软件源 / 右键菜单),共享辅助收编至 statsapplet_helpers.h;QML 前端 main.qml(5699 行)拆为组合根 + 8 个宝镜分节组件(天象 / 监控 / 符箓阵图 / 灵丹法器 / 灵源换髓 / 五灵妙法 / 关于名号 / 硬件详情覆盖层),组件经 host 属性接线(主题色 / 状态 / applet),行为不变;灵源换髓辅助函数迁入 AptSection 自包含;历史遗留 4 处 comboDel 重复 id 改为语义化唯一 id。 维护:统一版本号至 v1.1.19。

筑基中期[v1.1.12 2026-08-29]

桌面悬浮天镜:新增类 macOS 桌面小组件——LayerShell 窗口锚定屏幕右上角,置于桌面层(壁纸之上、普通窗口之下,被窗口正常遮挡不挡内容),不挤占工作区并自动避让顶栏;全部监控项逐行明细(CPU / 显卡 / 内存 / 存储 / 磁盘读写 / 网络上下行 / 风扇),百分比项配动画进度条(650ms OutCubic 缓动),底部 16 拍 CPU 占用波形;DTK 毛玻璃 + 18px 圆角,深浅主题自适应,纯展示不响应点击、不弹窗口;弹窗「符箓阵图」新增「天镜悬浮」开关(默认关闭),随监控总开关一同显隐;数据与任务栏同源实时刷新,零额外开销。
明暗主题深化:弹窗普通按钮与五个下拉框全面主题化(底色 / 悬停 / 按下 / 文字四态,下拉列表项悬停 / 高亮随明暗主题);链接与聚焦蓝统一 textLink,温度条阈值色、天气水滴云朵小图标、更新提醒红点边框等散落固定色按主题分流。
灵源换髓(一键换源交互精简):下拉选镜像即换源——选中即触发管理员授权并开始切换,少一步操作;下拉默认选中当前源;源址输入框改为自定义源入口(回车 / 失焦校验应用);移除「还原」按钮(换源失败后端自动还原换源前备份);模块移至「灵丹法器」(肆)之后,序号重排为伍。
任务栏底色:插件区新增半透明圆角底色卡片(暗色深蓝调 / 亮色白色调,各带细描边),监控区、天气、应龙在任意任务栏主题与壁纸上都有稳定对比背景,不再裸贴任务栏;图表皮肤玻璃管线框与底色主题感知(亮色改灰蓝描边)。
除祟·彻底删除(安全强化):确认框红字警示绕过回收站直接抹除、无法找回,内置与系统删除的对比说明,须勾选「我已了解数据将直接抹除」后「永久删除」才可用;新增待删项数与总大小(目录递归统计,超大目录前缀「≥」防卡死);删除完成后桌面通知结果(成功 / 失败项数);Shift+Delete 在文件管理器之外按下给出引导;右键菜单项改名「彻底删除(不进回收站)」并新增文案版本号,插件启动自愈校验重部署。
弹窗布局记忆:宝镜模块折叠、磁盘明细与端口占用展开状态持久化,重启还原上次布局。
维护:统一版本号至 v1.1.12;build.sh 每次构建末段版本号自动递增(NO_BUMP=1 可跳过)并同步 debian/changelog 与主插件 / 托盘 CMake;apt-source.sh 随包安装。

Reply View the author
avatar
张叁
deepin
2026-09-07 18:29
#13
骑🐖追帅哥bot:

成功参与!

筑基大圆满[v1.3 2026-09-07] · 张叁/应龙图YLTool - Gitee.com

筑基大圆满[v1.3.0 2026-09-07]
里程碑:筑基期功德圆满,下一大境界金丹期。
流光史册 / 灵台透视:迁出宝镜为独立可拖拽弹窗,右上角「钉住」驻留桌面置顶;任务栏分区点击直达(网速 → 史册,CPU / 内存 → 灵台)。
偏好设置窗口三页(报警 / 桌宠设置 / 天象预警)样式精修,全量随明暗主题;任务栏监控项默认显隐感知本机。
除祟·彻底删除刷新脉冲:删除后父目录瞬时探针促文件管理器即时刷新,无需手动刷新。
流光史册:X11 点外部关闭加 30ms 轮询兜底;镜檐名号改英文短名「YLTool」。
桌宠整体屏蔽闸临时关闭(双会话行为验证后一键放开)。

Reply View the author
avatar
国光
deepin
2026-09-18 08:32
#14

系统版本:v25.2.2

软件版本:1.3.0

问题1、显卡与风扇的数据没有收集。

问题2、桌宠开启了随行模式,但没有桌宠跟随鼠标。
image.png

Reply View the author
avatar
小廖老九
deepin
2026-09-29 13:50
#15

在deepin v25 龙芯版上因为任务栏频繁卡死,所以用AI查询了一下,认为这个组件可能是原因之一,不太确定,因为我删掉好几个第三方组件了,大佬可以当个参考
image_20260929_134545_668.png

image_20260929_134502_730.png

Reply View the author
avatar
153******58
deepin
2026-09-29 14:43
#16

好像还有个问题,就是放置的位置无法保存,比如我放在左侧(开始菜单处),重启后又回到了默认位置。

Reply View the author
avatar
张叁
deepin
2026-10-15 19:53
#17
153******58:

好像还有个问题,就是放置的位置无法保存,比如我放在左侧(开始菜单处),重启后又回到了默认位置。

筑基大圆满[v1.3.10 2026-10-15] · 张叁/应龙图YLTool - Gitee.com

  • 安放方位:切换即时生效并正确持久化——setPosition/setMonitorOrder 补 Q_INVOKABLE(QML 不能调用 Q_PROPERTY 的 WRITE 函数,此前每次切换都抛 TypeError 静默失败),监控项上移/下移排序同修;新增静态回归检查防同类问题。
  • 布局与鼠标冲突:天气湿度/降水提示、任务栏/硬件入口等 14 处改用不参与尺寸布局的指针处理器,保留悬浮提示与点击动作。
  • 硬件采集:NVIDIA 使用率与温度改用异步 nvidia-smi 查询(6 秒间隔、1.2 秒超时、不重叠),无数据与真实 0% 分开显示;风扇兼容旧式 hwmon device/ 路径,传感器去重。
  • 移除桌宠硬编码屏蔽(默认仍关闭):开启后沿任务栏行走,设置页正确反映监控暂停状态。
  • 保留 dockOrder 响应式绑定:后台位置恢复、连续切换均通过同一绑定更新任务栏。
Reply View the author
avatar
张叁
deepin
2026-10-15 19:55
#18
小廖老九:

在deepin v25 龙芯版上因为任务栏频繁卡死,所以用AI查询了一下,认为这个组件可能是原因之一,不太确定,因为我删掉好几个第三方组件了,大佬可以当个参考
image_20260929_134545_668.png

image_20260929_134502_730.png

筑基大圆满[v1.3.10 2026-10-15] · 张叁/应龙图YLTool - Gitee.com 麻烦试下,问题修复没,我没有环境测试😂

Reply View the author