[AI Development Lab] 【deepin插件开发活动】deepin-widget-toolbar:让deepin有侧栏
Tofloor
poster avatar
燕戏竹林
deepin
an hour ago
Author

尊敬的 deepin 社区评委、各位开发者:

您好!我是开发者燕戏竹林。在此,我非常荣幸地向社区提交我的参赛作品:deepin-widget-toolbar。本项目是一款基于 dde-shelldde-tray 插件体系构建的 Vista 风格桌面小组件侧边栏及任务栏托盘,旨在通过高度可定制的网格布局和现代化的交互体验,进一步扩展 deepin 桌面的生产力与个性化能力。

以下为本次参赛的详细申报材料。


一、 参赛方向

本项目深度融合了任务栏与桌面 Shell 的交互,故同时申报以下两大核心方向:

  • 方向二:任务栏托盘插件(基于 dde-tray-development Skill)
  • 方向四:扩展 DDE Shell 的桌面能力(基于 dde-shell-development Skill)

二、 项目简介

deepin-widget-toolbar 是一款常驻于屏幕右侧的侧边栏小组件工具栏(宽度与通知中心保持一致,380px),并配有专属的任务栏托盘按钮。它采用了 4 列网格布局,支持无限垂直滚动,并内置了丰富的系统级小组件。同时,项目提供了一套完善的 Open API,允许开发者通过 .dwpkg 格式打包并无感侧载第三方插件。

三、 核心特性与演示展示

在本项目中,我深度整合了 DTK、DDE Shell 以及 DDE Dock 的系统特性,实现了多项交互创新。以下为项目核心功能的演示材料预留位置(发帖时将替换为实际动图链接):

1. 任务栏与桌面 Shell 深度联动

  • 任务栏托盘触发器 (Dock Trigger Button):开发了专属的 dde-dock 托盘插件,作为控制面板显示/隐藏的唯一触发入口。托盘图标状态与面板状态深度绑定,确保系统级交互的一致性。

  • 控制中心开关:面板内置窗口级偏好与小组件实例配置,均经 DConfig 持久化,并在控制中心中提供相应的开关配置。

    控制中心开关.gif

2. 高度自由的布局与交互

  • 组件添加与侧载支持:提供独立的添加面板,支持从 .dwpkg (tar.xz) 原子安装第三方小组件,并包含严格的路径穿越与 symlink 逃逸安全校验。

    组件添加.gif
    支持侧载.gif

  • 卡片位置拖放、避让、一键整理:长按拖拽任意小组件时,其他卡片会进行实时双向联动避让,松手即持久化;同时提供“一键整理”功能,将卡片按左上优先原则压实排列。
    卡片位置拖放、避让、一键整理.gif

  • 卡片大小变更:内置组件支持 1×1 / 2×2 / 4×2 / 4×4 多档尺寸,右键菜单即时切换,并附带平滑过渡动画。
    卡片大小变更.gif

3. 极致的系统级外观融合

  • 透明度与圆角跟随系统:面板与卡片透明度随 dde-appearance 动态联动;圆角半径严格遵循 DTK 系统级标准,确保视觉的一致性。
    透明度跟随系统.gif
    圆角跟随系统调节.gif

  • 卡片透明模式:面板设置内提供全局半透明叠层底开关,赋予桌面更通透的视觉体验。

    卡片透明模式.gif

4. 丰富的内置组件

除了基础的布局管理,本项目内置了多款高质量小组件:时钟(数字/指针)、日历、资源监视仪表、便签、世界时间、MPRIS 播放控制器、歌词面板等
值得一提的是,最新引入的频谱面板 (Spectrum Panel) 支持多后端音频捕获(PulseAudio/PipeWire/ALSA 动态回退),能够实时将系统音频渲染为动态主题色圆角光柱,并支持静默呼吸动画。

四、 开发过程说明与 deepin Skills 的应用

本项目于 2026 年 8 月 10 日(活动启动后)正式立项并开启实质性开发。在短短一周内,仓库已累计完成近 70 次 Commit(详见:主分支提交记录),涵盖了多后端音频捕获、平滑拖动预览、底层 Shell 与 Dock 插件对接等核心底层逻辑的构建。

在开发过程中,我深度依赖了 deepin Skills 提供的强大辅助能力,极大地提升了 DTK 组件调用、dde-shell 插件规范对接、dde-dock 托盘插件开发以及底层 C++ API (如 PipeWire/PulseAudio dlopen 调用) 的编写效率。

以下为开发过程中使用 AI 编程工具调用 deepin Skills 的部分记录截图:

截图_选择区域_20260814140232.png

截图_选择区域_20260814114800.png

截图_选择区域_20260814103247.png

截图_选择区域_20260813233526.png

截图_选择区域_20260813233507.png

截图_选择区域_20260813233311.png

截图_选择区域_20260813130512.png

截图_选择区域_20260812225730.png

五、 仓库链接与文档

六、 结语

deepin 社区一直以来对开源生态的扶持令人敬佩。此次「10亿 Token 奖池」活动更是为独立开发者提供了绝佳的舞台。希望 deepin-widget-toolbar 能够为 deepin 桌面的信息展示、系统托盘交互提供一种全新的范式。

感谢评委们的审阅,期待您的宝贵意见!

开发者:燕戏竹林
日期:2026 年 8 月 17 日

Reply Favorite View the author
All Replies
avatar
Ligocut光剪视频剪辑软件
deepin
Backbone of ecological co-construction group
an hour ago
#1

不错,到时候放一个抖音小窗,b站小窗在那里摸鱼,有人来就收起来侧面板

Reply View the author
avatar
骑🐖追帅哥bot
Moderator
37 minutes ago
#2

太酷了吧

Reply View the author