deepin 小组件工具栏 0.2.0.0 —— 侧栏多了个应用启动器，便签也能当待办用了

大家好，这里是 浣软团队（https://huansoft.kxwl.ltd）。

先简单介绍一下这东西是干嘛的：deepin-widget-toolbar（小组件工具栏） 是给 deepin / UOS v25 做的一个侧栏小组件面板，基于 dde-shell 插件体系，界面参考早年 Vista 的侧边栏——屏幕右侧一条 380px 宽的面板，卡片式地摆一堆小组件，可以随便拖、随便缩放，托盘上有个图标负责一键呼出/收起。

内置的小组件有 9 个：时钟、日历、资源监视仪表、便签、世界时间、频谱、端闱乐部歌词、播放控制器，以及这次新加的应用快捷启动器。

过了半个多月，0.2.0.0 正式发布（从 0.1.1.0 算起一共 42 个提交），GitHub Release 已经挂好包了。

这次更新了些啥

🚀 应用快捷启动器（新小组件）

就是一格一个软件的启动面板：五个规格随便挑（1×1 / 2×2 / 4×1 长条 / 4×2 / 4×4），最长能放 16 个。点"+"就能从三级应用列表里挑程序，图标和应用名都是跟 dde-shell 同源的，装了什么它就能看到什么（flatpak、玲珑、商店装的 deb 包都认）。

新加的卡片首次出现时会自动预置四个常用程序（浏览器、终端、文本编辑器、邮件），懒得配也能直接用。

✅ 便签终于能当待办清单用了

便签里可以开"待办模式"（默认就开着）：每行前面一个圆点，点一下变实心表示做完了，完成的行文字变浅、加删除线。内容能无限往下滚，右边有个细滚条提示滚到哪了。

顺带把存数据的方式从纯文本换成了 XML，老便签第一次打开会自动迁移，原来的 .txt 还给你留着当备份，不会丢东西。另外修了个小毛病：之前在大卡片上"便签字号"三档看起来一模一样，现在是真有区别了。

🏷️ 卡片下面能显示名字了

同一个小组件开了好几个实例的时候，以前只能靠打开来分辨谁是谁。现在每张卡片下面会居中显示它的名字（太长自动省略），面板设置里一个总开关，默认开启。

需要注意的是卡片宽度完全没变——名字占的空间是由"格子变高一点"让出来的，所以列对齐、卡片大小跟以前一致，不会因为开了名字就挤成一团。

🕐 世界时间支持 4×1 长条

新增长了条规格，一行四个表盘。数字模式也重做了一遍：单元数会跟着卡片大小走（不再是死板的一列），1×1 的小卡会把标题藏起来，格子里"大时间 + 小地名"上下排，不会被裁掉。顺便修了标题在某些语言下不翻译的问题。

🚪 面板学会"让路"了

右侧栏最尴尬的就是跟别的面板打架。现在：

• 通知弹窗、通知中心、控制中心、电源对话框、剪贴板面板、托盘快捷面板——只要是真的跟侧栏重叠上了，面板会自己躲开，对方关掉/移开就立刻回来（展开在侧栏外面的小卡不会误触发）。
• 多任务视图（kwin 概览）打开时面板也自动隐藏，退出就回来，X11 和 Wayland 都管用。

这一块我们这次下了不少功夫。之前有个很讨厌的毛病：面板偶尔会"永久消失"——窗口不再映射，但托盘按钮怎么点都没反应，看起来就像暗色模式下侧栏不见了。原因是避让状态挂在一个早就没了的窗口上没释放。现在改成按窗口本身的存活状态判定，每 2 秒对账一次，托盘按钮总能把它叫回来。

🐞 出问题能自己抓日志了

面板设置里多了个"调试模式"（默认关闭）。打开之后，面板会把带时间戳的日志写到：

~/.cache/logs/deepin-widget-toolbar/

单个文件满 2500 行自动换新文件，目录里最多留 20 个。关掉开关就一条都不写，连日志目录都不会建。以后遇到"面板不显示""置顶失效"这类问题，开一下开关复现，把日志贴到帖子里或 issue 里，我们好定位。

修掉的问题

除了上面那些，这次还修了一批大家容易碰到的：

• 面板会永久消失、托盘按钮叫不回来（上面说的那个）
• 被拖卡片原地不动、落点只能靠预览边框颜色猜；上浮预览还会从屏幕另一头"飞"过来
• 点击便签打不进字（X11 下 kwin 不给面板键盘焦点，看起来就是光标闪一下、按键跑到别的窗口去了）
• 调整任务栏之后，面板边距不跟着变，得隐藏再显示才生效
• 卡片明明一屏放得下，面板却还能滚
• 切换卡片尺寸时，卡片背景和内容"啪"地一下就变了，动画像没生效
• 卡片透明模式下，一堆点了没反应的颜色设置项（现在会藏起来，只留还生效的）
• 应用商店新装的应用不出现在选择列表里
• 卸载重装之后设置"没回到默认"（其实是你上次的改动被继承下来了，现在卸载会先问要不要清掉）

发布前我们又从头到尾自查了一遍提交记录，一共修掉 23 个问题，包括几个只在特定情况下才冒出来的隐患，也都写进 changelog 了。

怎么装

要求：deepin / UOS v25，dde-shell >= 2.0.52、dde-tray-loader >= 2.0.38（DTK6 / Qt6 运行库）。

方式一：直接下 deb（推荐）

去 GitHub Release 下附件，然后：

sudo dpkg -i deepin-widget-toolbar_0.2.0.0_amd64.deb

systemctl --user restart dde-shell@DDE    # 如果没有自动重启就手动重启一下，无需root

装完 postinst 会自动重启 dde-shell，屏幕闪一下是正常的，起来之后右侧栏就能看到了。卸载：

sudo dpkg -r deepin-widget-toolbar      # 会先问你要不要清掉面板设置

包的 SHA256（想核一下的话）：29a73714a43860a508c1299a9a63c9a51eb7d2ca16a9bbb9b30bf97996f4aa06

方式二：从源码装

git clone https://github.com/HuanSoft-Open-Source-Community/deepin-widget-toolbar.git
cd deepin-widget-toolbar
./install.sh        # 自动构建 + 请求 sudo 部署 + 重启 dde-shell

# 在使用一键安装脚本前可能要先装依赖，详见readme.md

第一次用的话：装完在托盘上找到那个图标点一下，右侧栏就出来了；底部"添加"按钮可以往里面加小组件，长按卡片能拖动摆放，右键卡片能换尺寸或进设置。

几个小提示

• 面板避让（外置面板那种）目前只在 X11 下生效——Wayland 拿不到别的窗口的事件流。多任务视图的避让两个平台都正常。如果你用的是 Wayland，通知中心盖住侧栏这种场景还躲不开。
• 便签不支持触屏拖动滚动（宿主的拖拽层会先接住按压），滚轮和触控板没问题，这是桌面端的取舍。
• 界面翻译有 23 种语言目录，但目前只有简体中文是全量翻译（80 条全译），繁体中文翻了 12 条，其它语言基本还是英文原文——欢迎来帮忙翻译，.ts 文件都在 panel/translations/ 下，改完提 PR 就行。
• 项目是 GPL-3.0-or-later，随便改随便发，注明出处就行。

下载与反馈

• Release（下 deb）：https://github.com/HuanSoft-Open-Source-Community/deepin-widget-toolbar/releases/tag/v0.2.0.0
• 仓库：https://github.com/HuanSoft-Open-Source-Community/deepin-widget-toolbar
• 小组件开发接口：docs/widget-api.md（当前 v1.7，欢迎写第三方小组件，也有 .dwpkg 导入）

用着有问题、有想要的小组件、或者觉得哪里丑，都欢迎回帖说，我们看得见。（有 bug 的话带上调试日志就更好啦 🙏）

---

浣软团队
官网：https://huansoft.kxwl.ltd