[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. 河图出黄河:龙马负图而出,伏羲得之,以通天地之理。

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

预览图

22.png

11.png

1.png

2.png

3.png

4.png

二、源码仓库

三、开发方向与所用 Skill

  • 开发方向:方向四 · 扩展 DDE Shell 的桌面能力(Dock 任务栏插件),并附带一个独立的系统托盘程序
  • 使用的 deepin Skilldde-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
4 hours ago
#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