在 deepin 25 桌面上常驻一块毛玻璃悬浮便签：随机展示优美有哲理的句子，一键收藏、自定义灵感分类，并且会跟着系统壁纸的色调自动调整文字配色。

• 源码仓库：https://atomgit.com/feidaojun/deepin-daily-quote （GPL-3.0-or-later）
• 独立仓库，可单独构建与安装

一、功能介绍

二、效果截图

1. 桌面主界面（毛玻璃悬浮便签）

2. 收藏夹：浏览 / 跳转 / 删除

3. 设置面板：灵感分类（含自定义分类）与便签位置、自动换句时间

4. 壁纸色调联动：同一张便签在四种壁纸下自动推导的配色

5. AI 编程工具调用 deepin Skills 的对话记录

三、安装方式

# 编译依赖（deepin / UOS 25）
sudo apt install -y build-essential cmake \
    qt6-base-dev qt6-declarative-dev qt6-tools-dev \
    libdtk6core-dev libdtk6gui-dev libdde-shell-dev

# 构建安装
git clone https://atomgit.com/feidaojun/deepin-daily-quote
cd deepin-daily-quote
cmake -B build -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Release
cmake --build build -j$(nproc)
sudo cmake --install build

# 重启 dde-shell 生效
systemctl --user restart dde-shell@DDE

不想动系统时可以只在调试模式加载：

DDE_SHELL_PACKAGE_PATH=$PWD/build/packages \
DDE_SHELL_PLUGIN_PATH=$PWD/build/plugins \
dde-shell -p org.deepin.ds.dailyquote

也支持 dpkg-buildpackage -us -uc -b 打成 deb。

四、使用说明

便签默认出现在屏幕右下角。

• 换一句：底部「⟳ 换一句」；开启自动换句后默认每 30 分钟自动换
• 收藏：底部「♡ 收藏」，收藏后变红色 ♥
• 复制：底部「⎘ 复制」，复制「正文 —— 作者」
• 收藏夹：右上角 ★，点条目跳转，✕ 删除，右上「清空」
• 设置：右上角 ⚙
  • 灵感分类：点标签即切换；输入框回车新建自定义分类；自定义标签带 ✕ 可删
  • 便签位置 / 宽度 / 边距 / 自动换句间隔
  • 跟随壁纸色调、毛玻璃效果开关、重新取色、恢复默认

扩展自己的句子库：在 ~/.config/deepin/daily-quote/quotes.json 放置
{ "categories": [...], "quotes": [{ "id","c","t","a" }] }，启动时自动合并进内置库。

五、开发过程说明

整个项目在 AI 编程工具（WorkBuddy）中完成，把 deepin 官方 Skills 当「活文档」用，
而不是凭印象写 API。

用到的 Skill 模块

Skills 真正帮上忙的几个点

1. 选型不跑偏：Skills 的快速路由表指出「贴靠屏幕边缘的 Wayland 图层窗口」走
   LayerShell；Applet 只能嵌在父容器里 —— 于是确定做独立 Panel。
2. 避坑「编译通过 ≠ 能被加载」：Skills 的 gotchas 明确警告缺
   D_APPLET_CLASS(X) + #include "x.moc" 时 .so 能链接成功但无法实例化。
   本项目补齐后用 dde-shell --list 和日志里的
   Registered the applet factory "DailyQuotePanelAppletFactory" 双重确认。
3. 毛玻璃与主题感知不重复造轮子：直接复用官方 OSD 插件的成熟配方
   D.DWindow.enableBlurWindow + D.StyledBehindWindowBlur{ blendColor } +
   palette: D.DTK.palette。
4. 配置用 DConfig 而非自建配置文件/usr/share/dsg/configs//。
5. 按 Skills 的「默认工作流」逐条自检：--list → -p → 查
   ~/.cache/dde-shell/ 日志确认 QML 无报错。

$ dde-shell --list
org.deepin.ds.dailyquote          ← 插件被发现

$ dbus-run-session -- dde-shell -p org.deepin.ds.dailyquote
Registered the applet factory "DailyQuotePanelAppletFactory"
[daily-quote] loaded 1200 quotes from ":/org/deepin/ds/dailyquote/quotes.json"
[daily-quote] plugin ready: 1200 quotes, 0 favorites
Created rootObject for the applet: "org.deepin.ds.dailyquote"
grep -c "Unable to assign" → 0     ← QML 零绑定错误