新增: 功能路线图 + 9份需求契约

- feature-roadmap.md: 现有能力盘点 + P1/P2/P3方向 + 竞品参考 - AI深度视差: 远程推理方案(服务端Depth-Anything + 客户端WebGL) - 自动升级模块文档: 设计规格/任务规划/决策记录 - 9份需求契约: 视频/颜色提取/时间段/番茄钟/播放列表/电池/网页/便签/监控
2026-05-28 19:06:39 +08:00
parent f5a473c4b8
commit cd7247d880
19 changed files with 1044 additions and 33 deletions
--- a/README.md
+++ b/README.md
@@ -1,17 +1,18 @@
 # u-desktop

-Windows 桌面壁纸增强工具 — 将 WebView2 嵌入桌面壁纸层，在壁纸上叠加时间、天气、星座运势、AI 资讯等信息卡片。
+Windows 桌面壁纸增强工具 — 将 WebView2 嵌入桌面壁纸层，在壁纸上叠加时间、天气、星座运势、AI 资讯、电子相册等信息卡片。

 ## 功能

 | 模块 | 说明 |
 |------|------|
-| 壁纸 | 6 种主题动画（极光/星空/渐变/粒子/极光流体/文字）、本地图片、Bing 每日壁纸、纯色/渐变 |
+| 壁纸 | 6 种主题动画（极光/星空/渐变/粒子/极光流体/文字）、本地图片、Bing 每日壁纸（导航+收藏）、纯色/渐变 |
 | 时间 | 大字时钟，支持秒显示开关，整点光晕动画，节日倒计时 |
 | 天气 | 和风天气 API，当前天气 + 24h/7d 预报，IP 自动定位 + 手动选城 |
 | 星座运势 | 天聚数行 API，5 维指数进度条 + 幸运标签 + 今日概述 |
 | AI 资讯 | 天聚数行 API，图文布局 5 条展示 |
 | 知识卡片 | AI 生成，自定义关键字 + 提示词 |
+| 电子相册 | 本地目录轮播，可调间隔，支持电子相册模式（照片铺满壁纸） |
 | 桌面设置 | 独立 WebView2 窗口，所有配置可视化操作 |

 ## 项目结构
@@ -19,28 +20,33 @@ Windows 桌面壁纸增强工具 — 将 WebView2 嵌入桌面壁纸层，在壁
 ```
 u-desktop/
 ├── main.go              # 入口: 单实例互斥锁 + 配置目录 + 托盘启动
-├── win32.go             # Win32 API 声明 (user32/kernel32/ole32)
-├── systray.go           # 系统托盘 + WebView2 壁纸嵌入 + 消息循环
+├── win32.go             # Win32 API 声明 (user32/comdlg32/shell32)
+├── systray.go           # 系统托盘 + WebView2 壁纸嵌入 + 消息循环 + WorkerW 监控
 ├── wallpaper.go         # 壁纸 HTML 构建 + 主题注入 + 重载
 ├── config.go            # 配置结构体 + JSON 持久化
 ├── settings.go          # 设置窗口 (独立 WebView2)
 ├── weather.go           # 天气 API + IP 定位 + 城市列表
 ├── horoscope.go         # 星座运势 API + 文件缓存
 ├── ainews.go            # AI 资讯 API + 文件缓存
-├── knowledge.go         # 知识卡片 AI 生成
+├── knowledge.go         # 知识卡片 AI 生成 + SQLite 缓存
 ├── bing.go              # Bing 壁纸下载 + 历史导航 + 收藏
-├── dialog.go            # Win32 对话框 (文件选择/颜色选择)
+├── photo.go             # 电子相册: 目录扫描 + 定时轮播 + 预缓存
+├── dialog.go            # Win32 对话框 (文件选择/颜色选择/目录选择)
+├── web-ui/              # Vue 3 前端源码
+│   └── src/
+│       ├── overlay/     # 桌面覆盖层组件 (TimeCard/WeatherCard/ZodiacCard/...)
+│       ├── settings/    # 设置窗口组件 (ToggleSection/WallpaperSection/...)
+│       └── shared/      # 类型定义 + 工具函数
 ├── web/
-│   ├── overlay.html     # 桌面覆盖层 (时间/天气/星座/资讯/知识)
-│   ├── settings.html    # 设置窗口 UI
+│   ├── overlay.html     # 构建产物: 桌面覆盖层 (单文件内联)
+│   ├── settings.html    # 构建产物: 设置窗口 UI
 │   └── themes/          # 壁纸主题 HTML
-│       ├── aurora.html
-│       ├── starfield.html
-│       ├── gradient.html
-│       ├── particles.html
-│       ├── fractal.html
-│       └── text.html
-├── config/              # 运行时配置 (settings.json + 缓存)
+│       ├── aurora.html      # WebGL 极光动画
+│       ├── starfield.html   # Canvas 2D 星空
+│       ├── gradient.html    # CSS 渐变动画
+│       ├── particles.html   # Canvas 2D 粒子
+│       ├── fractal.html     # WebGL 分形流体
+│       └── text.html        # CSS 文字动画
 └── docs/
    └── wallpaper-embedding.md  # 壁纸嵌入技术笔记
 ```
@@ -50,29 +56,34 @@ u-desktop/
 ```
 ┌──────────────┐     ┌─────────────────┐
 │  systray.go  │────▶│  WebView2 主窗口  │ SetParent → WorkerW (壁纸层)
-│  (托盘+消息循环) │     │  overlay.html    │
+│  (托盘+消息循环) │     │  overlay.html    │ WS_EX_TRANSPARENT (鼠标穿透)
 └──────┬───────┘     └─────────────────┘
-       │ evalJS / SetHtml
+       │ evalJS / SetHtml / PostMessage
       │
       ▼
 ┌──────────────┐     ┌─────────────────┐
-│ settings.go  │────▶│  WebView2 设置窗口  │ 独立窗口, 760x1350
+│ settings.go  │────▶│  WebView2 设置窗口  │ 独立窗口, 自适应高度
 │              │     │  settings.html    │
 └──────────────┘     └─────────────────┘
 ```

 **核心通信机制**:
 - `evalJS(cmd)` — 通过 channel + PostMessage 向壁纸 WebView 注入 JS
- `htmlQueue` — 通过 SetHtml 替换整个壁纸 HTML（触发完整重载）
- WebView2 `Bind` — 设置窗口通过 Go 绑定函数读写配置
+- `htmlQueue` — 通过 SetHtml 替换整个壁纸 HTML（主题切换时触发）
+- WebView2 `Bind` — 设置窗口通过 Go 绑定函数（30+）读写配置
+- `TrayClickCh` — 托盘图标左键点击通道，触发设置窗口打开

 **数据刷新策略**:
 - 启动时推送文件缓存（即时显示），后台拉取新数据后替换
 - 星座: 24h / AI 资讯: 2h / 知识卡片: 30min / 天气: 10min / Bing: 4h

+**WorkerW 监控**:
+- 每 10 秒检测 WebView2 父窗口是否变化（`GetParent`）
+- Windows 桌面重建 WorkerW 时自动重新嵌入，无感知恢复
+
 ## 配置

-配置文件: `config/settings.json`（与 exe 同级目录）
+配置文件: `~/.u-desktop/settings.json`

 | 字段 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
@@ -88,34 +99,63 @@ u-desktop/
 | hideZodiac | bool | false | 隐藏星座 |
 | hideAINews | bool | false | 隐藏 AI 资讯 |
 | hideKnowledge | bool | false | 隐藏知识卡片 |
-| bingAutoRefresh | bool | false | Bing 每小时自动切换 |
+| hidePhoto | bool | false | 隐藏相册 |
+| photoFrameMode | bool | false | 电子相册模式（照片铺满壁纸） |
+| photoDir | string | "" | 相册图片目录 |
+| photoInterval | int | 15 | 相册切换间隔（秒） |
+| bingAutoRefresh | bool | false | Bing 定时自动切换 |
 | knowledgeKeyword | string | "" | 知识卡片关键字 |
 | knowledgePrompt | string | "" | 知识卡片提示词 |
+| wallpaperText | string | "" | 文字主题自定义内容 |
+| savedColors | array | [] | 收藏的颜色方案 |
+| autoStart | bool | false | 开机自启 |
+| color1 | string | "#1a1a2e" | 纯色/渐变颜色 1 |
+| color2 | string | "" | 渐变颜色 2 |
+| colorGradient | bool | false | 启用渐变 |

 ## 构建

-```bash
-go build -o u-desktop.exe .
+```powershell
+# 完整构建（含前端 + UPX 压缩）
+pwsh -File build.ps1
+
+# 构建并打包 zip（含 WebView2 bootstrapper）
+pwsh -File build.ps1 -Pack
 ```

 需要 Windows 10+ 和 WebView2 Runtime（Win11 已内置）。

+## 交互
+
+| 操作 | 行为 |
+|------|------|
+| 左键托盘图标 | 打开桌面设置 |
+| 右键托盘图标 | 弹出菜单（桌面设置/重启/退出） |
+| 设置窗口 | 所有配置实时生效，无需重启 |
+
 ## 依赖

-```
-github.com/jchv/go-webview2     # WebView2 绑定
-github.com/getlantern/systray    # 系统托盘
-golang.org/x/sys/windows         # Win32 API
-github.com/anthropics/anthropic-sdk-go  # Claude API (知识卡片)
-```
+**Go:**
+- `github.com/jchv/go-webview2` — WebView2 绑定
+- `github.com/getlantern/systray` — 系统托盘（已修改：左键点击支持）
+- `golang.org/x/sys/windows` — Win32 API
+- `modernc.org/sqlite` — 纯 Go SQLite（知识卡片缓存）

-## 开机自启
-
-注册表 `HKCU\Software\Microsoft\Windows\CurrentVersion\Run\UDesktopWallpaper`
+**前端:**
+- Vue 3.5 + TypeScript 5.8 + Vite 6 + Tailwind CSS 3
+- `vite-plugin-singlefile` — 构建产物单文件内联

 ## 技术要点

 - WebView2 嵌入桌面壁纸层通过 `SetParent` 到 WorkerW 实现（详见 [docs/wallpaper-embedding.md](docs/wallpaper-embedding.md)）
+- `WS_EX_TRANSPARENT | WS_EX_LAYERED` 扩展样式实现鼠标键盘事件穿透，桌面图标正常操作
 - 自定义 Win32 消息循环替代 `wv.Run()`（SetParent 后 Run() 消息路由异常）
+- WorkerW 重建监控：定时 `GetParent` 检测，Windows 桌面刷新后自动重新嵌入
 - 全屏应用检测：定时检查前台窗口是否全屏，自动暂停/恢复壁纸渲染
+- 配置存储于 `~/.u-desktop/`，不依赖 exe 同级目录，构建清理不影响用户配置
 - 配置变更即时生效：设置窗口通过 evalJS 直接操作壁纸层 DOM，无需重启
+- 构建参数 `-H windowsgui` 隐藏控制台窗口，双击 exe 无黑窗口
+
+## 开机自启
+
+注册表 `HKCU\Software\Microsoft\Windows\CurrentVersion\Run\u-desktop`
--- a/docs/04-功能迭代/U-DESKTOP-1.自动升级/README.md
+++ b/docs/04-功能迭代/U-DESKTOP-1.自动升级/README.md
@@ -0,0 +1,24 @@
+# 自动升级模块
+
+**模块状态**：待开发
+**最后更新**：2026-05-28
+
+---
+
+## 快速导航
+
+| 类型 | 文档 | 说明 |
+|------|------|------|
+| 规划 | [任务规划.md](./任务规划.md) | 实施步骤和检查清单 |
+| 设计 | [设计文档/自动升级功能设计.md](./设计文档/自动升级功能设计.md) | 完整功能设计 |
+| 决策 | [决策记录/](./决策记录/) | 架构和设计决策 |
+| 问题 | [问题追踪/](./问题追踪/) | 待解决问题 |
+| 检查 | [核对报告/](./核对报告/) | 实现检查报告 |
+| 测试 | [测试用例/](./测试用例/) | 测试用例 |
+
+## 核心设计
+
+- **弹窗策略**：非强制 → 右下角气泡（稍后 + 立即升级），强制 → 居中弹窗（仅立即升级）
+- **架构**：主程序检查版本 → 弹窗提示 → 启动 updater.exe → 下载替换重启
+- **updater.exe**：通用升级器，参数化驱动，可复用于其他产品（u-tabs 等）
+- **商业化预留**：API 预留 tier/license 字段，升级器不含商业逻辑
--- a/docs/04-功能迭代/U-DESKTOP-1.自动升级/任务规划.md
+++ b/docs/04-功能迭代/U-DESKTOP-1.自动升级/任务规划.md
@@ -0,0 +1,53 @@
+# 自动升级 — 任务规划
+
+> 创建时间：2026-05-28
+
+## 阶段一：版本基础设施
+
+- [ ] `main.go` 增加版本变量，`-ldflags` 编译注入
+- [ ] `config.go` 增加 `update_url`、`auto_check_update`、`skip_version` 字段
+- [ ] `updater.go` 实现版本检查函数 `checkUpdate()`
+
+## 阶段二：升级弹窗
+
+- [ ] `web/update.html` 升级弹窗页面（右下角气泡 + 居中弹窗两种模式）
+- [ ] Go 端创建无边框 WebView2 弹窗窗口
+- [ ] 弹窗内容渲染：版本号、更新说明、按钮
+- [ ] 根据 `force` 字段切换弹窗位置和按钮
+
+## 阶段三：升级器程序
+
+- [ ] `updater/main.go` 独立程序骨架
+- [ ] HTTP 下载安装包 + 进度日志
+- [ ] SHA256 校验
+- [ ] 备份旧版本
+- [ ] 替换 + 启动新版本
+- [ ] 启动失败自动回滚
+- [ ] 日志写入 `updater.log`
+
+## 阶段四：主程序集成
+
+- [ ] 主程序释放 updater.exe 到临时目录
+- [ ] 构造命令行参数启动 updater
+- [ ] 主程序退出
+- [ ] 托盘菜单增加"检查更新"
+
+## 阶段五：发布流程
+
+- [ ] 构建脚本同时构建 u-desktop.exe + updater.exe
+- [ ] publish 技能自动生成 version.json（版本号 + SHA256 + 下载 URL）
+- [ ] 上传 version.json 和安装包到 c.1216.top
+
+## 阶段六：验证
+
+- [ ] 手动模拟版本更新，测试弹窗流程
+- [ ] 测试 updater 下载 + 替换 + 重启
+- [ ] 测试回滚机制
+- [ ] 测试强制升级流程
+
+## 技术要点
+
+- 版本号通过 `-ldflags "-X main.version=x.x.x"` 注入
+- updater.exe 通用设计，参数化驱动，不含业务逻辑
+- 弹窗用 WebView2 无边框窗口，风格与设置窗口一致
+- version.json 放 c.1216.top，静态文件
--- a/docs/04-功能迭代/U-DESKTOP-1.自动升级/决策记录/README.md
+++ b/docs/04-功能迭代/U-DESKTOP-1.自动升级/决策记录/README.md
@@ -0,0 +1,17 @@
+# 决策记录
+
+记录自动升级模块的架构和设计决策。
+
+## 格式
+
+```
+ADR-{编号} - {标题}
+  状态：提议 | 已接受 | 已废弃
+  上下文：...
+  决策：...
+  理由：...
+```
+
+## 已记录
+
+（暂无）
--- a/docs/04-功能迭代/U-DESKTOP-1.自动升级/核对报告/README.md
+++ b/docs/04-功能迭代/U-DESKTOP-1.自动升级/核对报告/README.md
@@ -0,0 +1,3 @@
+# 核对报告
+
+实现过程中的检查报告。
--- a/docs/04-功能迭代/U-DESKTOP-1.自动升级/测试用例/README.md
+++ b/docs/04-功能迭代/U-DESKTOP-1.自动升级/测试用例/README.md
@@ -0,0 +1,3 @@
+# 测试用例
+
+自动升级功能的测试用例。
--- a/docs/04-功能迭代/U-DESKTOP-1.自动升级/设计文档/自动升级功能设计.md
+++ b/docs/04-功能迭代/U-DESKTOP-1.自动升级/设计文档/自动升级功能设计.md
@@ -0,0 +1,278 @@
+# 自动升级系统 — 实现规格
+
+> 来源：需求探索会话 2026-05-28
+> 状态：待开发
+
+---
+
+## 1. 架构总览
+
+```
+┌──────────────┐
+│  远程版本 JSON │  ← 静态文件，放 CDN / OSS
+│  version.json │
+└──────┬───────┘
+       │ HTTP GET
+       ▼
+┌──────────────────┐
+│  u-desktop.exe    │  ← 主程序
+│  · 启动时检查版本  │
+│  · 弹窗提示升级    │
+│  · 释放 updater   │
+└──────┬───────────┘
+       │ 启动进程
+       ▼
+┌──────────────────┐
+│  updater.exe      │  ← 通用升级器，参数化驱动
+│  · 下载安装包      │
+│  · SHA256 校验    │
+│  · 备份旧版本      │
+│  · 替换 + 启动    │
+│  · 失败自动回滚    │
+└──────────────────┘
+```
+
+---
+
+## 2. 主程序改动
+
+### 2.1 版本号注入
+
+`main.go` 增加版本变量，编译时注入：
+
+```go
+var version = "dev" // -ldflags "-X main.version=0.6.0"
+```
+
+`build` 脚本 / publish 技能同步更新 ldflags。
+
+### 2.2 版本检查模块
+
+新增 `updater.go`：
+
+```
+func checkUpdate() (*UpdateInfo, error)
+```
+
+- 启动时异步调用（不阻塞主流程）
+- 请求远程 `version.json`
+- 对比当前 version，返回更新信息或 nil
+
+远程 version.json 格式：
+
+```json
+{
+  "version": "0.7.0",
+  "force": false,
+  "release_notes": "· 新增视频壁纸\n· 修复全屏检测偶发失效",
+  "package": {
+    "url": "https://c.1216.top/u-desktop/u-desktop-0.7.0.zip",
+    "size": 8388608,
+    "sha256": "abc123def456..."
+  }
+}
+```
+
+version.json URL 存入 config 或硬编码默认值。
+
+### 2.3 升级弹窗
+
+用 WebView2 新建一个无边框小窗口，HTML 渲染弹窗内容。
+
+#### 弹窗策略
+
+| force 字段 | 位置 | 按钮 |
+|-----------|------|------|
+| `false` | 右下角，托盘图标上方 | [稍后] [立即升级] |
+| `true` | 屏幕居中 | [立即升级]（仅一个按钮） |
+
+#### 弹窗 HTML 结构
+
+右下角气泡（非强制）：
+
+```
+┌─────────────────────────────┐
+│  发现新版本 v0.7.0           │
+│                             │
+│  · 新增视频壁纸              │
+│  · 修复全屏检测偶发失效       │
+│                             │
+│         [稍后]  [立即升级]   │
+└─────────────────────────────┘
+```
+
+居中弹窗（强制）：
+
+```
+┌─────────────────────────────────────┐
+│                                     │
+│         发现新版本 v0.7.0            │
+│                                     │
+│  · 新增视频壁纸                     │
+│  · 修复全屏检测偶发失效             │
+│                                     │
+│  大小: 8MB  |  预计用时: ~10秒      │
+│                                     │
+│              [立即升级]              │
+└─────────────────────────────────────┘
+```
+
+#### 弹窗窗口参数
+
+| 参数 | 右下角 | 居中 |
+|------|--------|------|
+| 宽度 | 340px | 420px |
+| 高度 | auto（内容自适应） | auto |
+| 位置 | 屏幕右下角 - 边距 20px | 屏幕居中 |
+| 样式 | 无边框，圆角，毛玻璃 | 无边框，圆角，毛玻璃 |
+| 置顶 | TOPMOST | TOPMOST |
+
+### 2.4 用户点击"立即升级"
+
+1. 从自身嵌入资源释放 `updater.exe` 到临时目录（或主程序同级目录）
+2. 构造命令行参数启动 updater.exe
+3. 主程序退出
+
+```go
+exec.Command(tmpUpdaterPath,
+    "--package-url", info.Package.URL,
+    "--sha256", info.Package.SHA256,
+    "--target", selfExePath,
+    "--version", info.Version,
+    "--force", strconv.FormatBool(info.Force),
+).Start()
+// 主程序退出
+```
+
+### 2.5 托盘菜单
+
+新增菜单项："检查更新"，手动触发版本检查。
+
+---
+
+## 3. updater.exe
+
+### 3.1 职责
+
+通用升级器，不含业务逻辑，纯参数驱动。可复用于其他产品（u-tabs 等）。
+
+### 3.2 命令行参数
+
+```bash
+updater.exe \
+  --package-url <下载地址> \
+  --sha256 <SHA256校验值> \
+  --target <目标exe路径> \
+  --version <目标版本号> \
+  --force \
+  --backup-dir <备份目录，默认 target 同级 backup/>
+```
+
+### 3.3 流程
+
+```
+1. 显示进度窗口（WebView2 或控制台）
+2. HTTP GET 下载 package-url → 临时文件
+   - 显示下载进度（已下载/总大小）
+   - 支持断点续传（可选，初期不做）
+3. 计算下载文件 SHA256，与参数比对
+   - 不匹配 → 报错退出
+4. 备份当前 target → backup-dir/old-{timestamp}.exe
+5. 如果是 zip 包：解压后替换
+   如果是 exe：直接覆盖
+6. 启动新版本 target
+7. updater 退出
+
+异常处理：
+- 下载失败 → 重试 3 次，间隔 5s
+- 校验失败 → 报错，不替换
+- 启动新版本后监听 5s，新进程退出则回滚
+- 回滚：将 backup 中的旧 exe 还原
+```
+
+### 3.4 进度显示
+
+初期：无 UI，日志写 `updater.log`（`-H windowsgui` 隐藏控制台）。
+后续：可加 WebView2 进度窗口。
+
+### 3.5 日志
+
+写入 `updater.log`（与 target 同目录），包含时间戳、步骤、错误信息。
+
+---
+
+## 4. 构建 & 发布流程
+
+### 4.1 主程序构建
+
+```bash
+go build -ldflags "-H windowsgui -X main.version=0.7.0" -o u-desktop.exe
+```
+
+### 4.2 updater 构建
+
+独立 main 包，单独目录（如 `updater/`）：
+
+```bash
+cd updater && go build -ldflags "-H windowsgui" -o updater.exe
+```
+
+### 4.3 发布
+
+1. 构建 `u-desktop.exe` + `updater.exe`
+2. UPX 压缩（可选）
+3. 计算 SHA256
+4. 上传到 `c.1216.top`
+5. 更新远程 `version.json`
+6. 更新 publish 技能（自动生成 version.json + 上传）
+
+---
+
+## 5. 配置
+
+`config.go` 新增字段：
+
+```go
+type Config struct {
+    // ... 现有字段
+    UpdateURL      string `json:"update_url"`       // 版本检查 URL，默认 https://c.1216.top/u-desktop/version.json
+    AutoCheckUpdate bool  `json:"auto_check_update"` // 启动时自动检查，默认 true
+    SkipVersion    string `json:"skip_version"`      // 用户跳过的版本号
+}
+```
+
+---
+
+## 6. 目录结构
+
+```
+u-desktop/
+├── main.go          # 增加版本变量
+├── updater.go       # 新增：版本检查 + 弹窗逻辑
+├── config.go        # 增加 update 相关字段
+├── systray.go       # 托盘菜单增加"检查更新"
+├── web/
+│   ├── update.html  # 新增：升级弹窗 HTML
+│   └── ...
+├── updater/         # 新增：升级器独立目录
+│   └── main.go
+├── docs/
+│   ├── feature-roadmap.md
+│   └── auto-update-spec.md  # 本文档
+└── ...
+```
+
+---
+
+## 7. 实施顺序
+
+| 步骤 | 内容 | 依赖 |
+|------|------|------|
+| 1 | `main.go` 加版本变量，构建脚本加 ldflags | 无 |
+| 2 | `updater.go` 版本检查函数 + config 字段 | 步骤 1 |
+| 3 | 远程 `version.json` 手动创建 + 上传 | 步骤 2 |
+| 4 | 升级弹窗 `update.html` + Go 端窗口创建 | 步骤 2 |
+| 5 | 主程序释放 + 启动 updater.exe | 步骤 4 |
+| 6 | `updater/` 目录，下载 + 校验 + 替换 + 回滚 | 步骤 5 |
+| 7 | 托盘菜单"检查更新" | 步骤 2 |
+| 8 | publish 技能集成 version.json 生成 | 步骤 3 |
--- a/docs/04-功能迭代/U-DESKTOP-1.自动升级/问题追踪/README.md
+++ b/docs/04-功能迭代/U-DESKTOP-1.自动升级/问题追踪/README.md
@@ -0,0 +1,10 @@
+# 问题追踪
+
+## 目录
+
+- `待讨论/` — 需要讨论后决定的问题
+- `待实现/` — 已确定但未实现的功能点
+
+## 当前问题
+
+（暂无）
--- a/docs/04-功能迭代/U-DESKTOP-2.便签待办卡片/需求契约.md
+++ b/docs/04-功能迭代/U-DESKTOP-2.便签待办卡片/需求契约.md
@@ -0,0 +1,38 @@
+# 便签/待办卡片 — 需求契约
+
+> 创建时间：2026-05-28
+> 状态：需求待确认
+
+## 目标
+
+桌面显示轻量 TODO 清单，数据持久化。
+
+## 用户场景
+
+1. 用户在设置页添加待办事项
+2. 桌面卡片显示待办列表（勾选框 + 文字）
+3. 点击勾选完成，已完成的显示删除线
+4. 数据本地持久化
+
+## 验收标准
+
+- [ ] 添加/删除待办事项
+- [ ] 勾选完成/取消完成
+- [ ] 最多显示 N 条（如 10 条），超出滚动
+- [ ] 数据持久化到本地 JSON
+
+## 本次范围
+
+- 基础 TODO 列表
+
+## 非目标
+
+- 分组/标签/优先级
+- 截止日期提醒
+- 同步到云端
+
+## 约束
+
+- 前端组件 + config JSON 持久化
+- 复用卡片架构
+- 设置页提供添加/删除/编辑入口
--- a/docs/04-功能迭代/U-DESKTOP-2.壁纸播放列表/需求契约.md
+++ b/docs/04-功能迭代/U-DESKTOP-2.壁纸播放列表/需求契约.md
@@ -0,0 +1,38 @@
+# 壁纸播放列表 — 需求契约
+
+> 创建时间：2026-05-28
+> 状态：需求待确认
+
+## 目标
+
+用户将 Bing 收藏 + 本地图片 + 视频组成播放列表，定时轮播。
+
+## 用户场景
+
+1. 用户在设置页勾选多个壁纸加入播放列表
+2. 设置轮播间隔（5 分钟 / 10 分钟 / 30 分钟 / 1 小时）
+3. 壁纸按顺序或随机切换，淡入淡出过渡
+
+## 验收标准
+
+- [ ] 播放列表支持图片 + 视频 + Bing 壁纸
+- [ ] 可配置轮播间隔
+- [ ] 顺序 / 随机模式
+- [ ] 切换时淡入淡出过渡
+- [ ] 播放列表持久化
+
+## 本次范围
+
+- 基础播放列表 + 定时轮播
+
+## 非目标
+
+- 按时间段分配不同列表
+- 按星期几分配不同列表
+- 在线同步播放列表
+
+## 约束
+
+- 复用现有壁纸切换逻辑
+- config 新增 playlist 数组 + interval + shuffle 字段
+- Go 端定时器驱动切换
--- a/docs/04-功能迭代/U-DESKTOP-2.壁纸颜色提取/需求契约.md
+++ b/docs/04-功能迭代/U-DESKTOP-2.壁纸颜色提取/需求契约.md
@@ -0,0 +1,45 @@
+# 壁纸颜色提取 + 卡片自适应 — 需求契约
+
+> 创建时间：2026-05-28
+> 状态：需求已确认
+
+## 目标
+
+从当前壁纸自动提取主色调，动态调整信息卡片的文字颜色和背景，确保在任何壁纸上都可读。
+
+## 用户场景
+
+1. 用户切换壁纸后，卡片文字颜色自动适配（深色壁纸白字、浅色壁纸黑字）
+2. 卡片背景增加半透明遮罩，提升文字可读性
+3. 用户无需手动调色，全程自动
+
+## 验收标准
+
+- [ ] 壁纸切换后 1s 内完成颜色提取
+- [ ] 文字颜色自动切换：深底白字 / 浅底黑字
+- [ ] 卡片背景增加自适应半透明遮罩
+- [ ] 支持所有壁纸类型（主题/图片/Bing/视频/颜色）
+- [ ] 提取结果缓存，同一壁纸不重复计算
+
+## 本次范围
+
+- 壁纸主色调提取
+- 卡片文字颜色自适应
+- 卡片背景遮罩
+
+## 非目标
+
+- 完整调色板提取（只取主色调）
+- 用户手动覆盖颜色
+
+## 约束
+
+- 前端 Canvas 采样，不依赖 Go 端图像处理
+- 采样频率：壁纸切换时触发一次
+- 不影响壁纸渲染性能
+
+## 技术方案
+
+- 壁纸切换后，Canvas 绘制壁纸帧 → 采样若干像素点 → 取平均值 → 判断明暗
+- 前端状态管理增加 `isDarkWallpaper` 变量
+- 卡片组件根据 `isDarkWallpaper` 切换 CSS class
--- a/docs/04-功能迭代/U-DESKTOP-2.时间段壁纸/需求契约.md
+++ b/docs/04-功能迭代/U-DESKTOP-2.时间段壁纸/需求契约.md
@@ -0,0 +1,47 @@
+# 时间段动态壁纸 — 需求契约
+
+> 创建时间：2026-05-28
+> 状态：需求已确认
+
+## 目标
+
+根据用户地理位置的日出日落时间，自动切换壁纸主题（白天明亮主题，夜晚深色主题）。
+
+## 用户场景
+
+1. 白天自动使用 gradient/aurora 等明亮主题
+2. 日落后自动切换为 starfield/fractal 等深色主题
+3. 用户可自定义白天/夜晚对应的主题
+4. 切换过程平滑过渡，无突兀跳变
+
+## 验收标准
+
+- [ ] 根据天气 API 已有的经纬度数据计算日出日落时间
+- [ ] 日出后切换到"白天主题"，日落后切换到"夜晚主题"
+- [ ] 默认配对：白天 gradient / 夜晚 starfield
+- [ ] 用户可在设置页自定义白天/夜晚主题
+- [ ] 主题切换有淡入淡出过渡效果
+- [ ] 无网络时使用固定时间（6:00 日出 / 18:00 日落）
+
+## 本次范围
+
+- 基于日出日落的两种主题自动切换
+
+## 非目标
+
+- 多时段（上午/下午/傍晚/深夜）细分
+- 基于天气的主题切换（晴天/阴天）
+- 渐变过渡动画（日出/日落期间缓慢变化壁纸色调）
+
+## 约束
+
+- 复用天气 API 已有的城市经纬度，不新增 API 调用
+- 日出日落算法用前端 JS 计算（SunCalc 库或简单公式）
+- config 新增 `dayTheme`、`nightTheme`、`autoTheme bool` 字段
+
+## 风险
+
+| 风险 | 缓解 |
+|------|------|
+| 天气城市未设置 | 降级为固定时间（6:00/18:00） |
+| 用户关闭天气卡片 | 经纬度使用上次缓存值 |
--- a/docs/04-功能迭代/U-DESKTOP-2.电池感知/需求契约.md
+++ b/docs/04-功能迭代/U-DESKTOP-2.电池感知/需求契约.md
@@ -0,0 +1,37 @@
+# 电池感知 — 需求契约
+
+> 创建时间：2026-05-28
+> 状态：需求待确认
+
+## 目标
+
+笔记本拔电时自动暂停动画壁纸，省电。插电后恢复。
+
+## 用户场景
+
+1. 用户拔掉电源线 → 动画壁纸暂停，显示静态帧
+2. 重新插电 → 壁纸恢复动画
+3. 设置页可开关此功能
+
+## 验收标准
+
+- [ ] 检测电源状态变化（`GetSystemPowerStatus`）
+- [ ] 拔电暂停动画壁纸
+- [ ] 插电恢复动画
+- [ ] 桌面右下角托盘气泡提示"已切换为省电模式"
+- [ ] 静态壁纸（图片/纯色）不受影响
+
+## 本次范围
+
+- 拔电暂停 / 插电恢复
+
+## 非目标
+
+- 用户自定义省电策略（如暂停哪些卡片）
+- 电量低于 X% 自动暂停
+
+## 约束
+
+- Go 端 `GetSystemPowerStatus` 轮询（每 10 秒）
+- evalJS 调用前端 pause/resume
+- config 新增 `batteryAware bool`
--- a/docs/04-功能迭代/U-DESKTOP-2.番茄钟与倒计时/需求契约.md
+++ b/docs/04-功能迭代/U-DESKTOP-2.番茄钟与倒计时/需求契约.md
@@ -0,0 +1,51 @@
+# 番茄钟 + 自定义倒计时卡片 — 需求契约
+
+> 创建时间：2026-05-28
+> 状态：需求已确认
+
+## 目标
+
+新增两种效率类卡片：番茄钟（25/5 循环倒计时）和自定义倒计时（用户设定目标日期）。
+
+## 用户场景
+
+### 番茄钟
+
+1. 桌面显示番茄钟进度环，25 分钟工作倒计时
+2. 倒计时结束，进度环变色提示休息（5 分钟）
+3. 显示今日完成番茄数
+4. 设置页可开关番茄钟卡片
+
+### 自定义倒计时
+
+1. 用户在设置页添加倒计时事件（名称 + 日期）
+2. 桌面显示"距离 XX 还有 N 天"
+3. 支持多个倒计时事件
+4. 过期事件显示"已过去 N 天"或自动归档
+
+## 验收标准
+
+- [ ] 番茄钟：25 分钟工作 / 5 分钟休息自动循环
+- [ ] 番茄钟：进度环可视化
+- [ ] 番番钟：今日完成数显示
+- [ ] 倒计时：支持添加/删除事件
+- [ ] 倒计时：显示剩余天数
+- [ ] 数据持久化，重启后恢复
+
+## 本次范围
+
+- 番茄钟卡片（基础 25/5 循环）
+- 自定义倒计时卡片（多事件）
+
+## 非目标
+
+- 番茄钟声音提醒（仅视觉）
+- 番茄钟统计报表（日/周/月）
+- 倒计时精确到小时/分钟（只显示天数）
+
+## 约束
+
+- 复用现有卡片架构（Vue 组件 + Go 数据推送）
+- 番茄钟状态前端本地管理（localStorage），不需要 Go 端计时
+- 倒计时事件存储在 config JSON 中
+- 布局：单栏模式追加在底部，多栏模式适配现有 grid
--- a/docs/04-功能迭代/U-DESKTOP-2.系统监控卡片/需求契约.md
+++ b/docs/04-功能迭代/U-DESKTOP-2.系统监控卡片/需求契约.md
@@ -0,0 +1,38 @@
+# 系统监控卡片 — 需求契约
+
+> 创建时间：2026-05-28
+> 状态：需求待确认
+
+## 目标
+
+桌面显示 CPU、内存、网速等系统指标的实时数据。
+
+## 用户场景
+
+1. 桌面卡片显示 CPU 使用率、内存占用、上传/下载网速
+2. 数据每秒刷新
+3. 紧凑数字 + 进度条风格，不占太多空间
+
+## 验收标准
+
+- [ ] CPU 使用率（百分比 + 进度条）
+- [ ] 内存使用率（已用/总量 + 百分比）
+- [ ] 网速（上传/下载，自动切换单位 KB/s MB/s）
+- [ ] 1 秒刷新间隔
+- [ ] Go 端 gopsutil 采集
+
+## 本次范围
+
+- CPU / 内存 / 网速 三个指标
+
+## 非目标
+
+- 磁盘 I/O
+- GPU 温度/使用率
+- 历史曲线图
+
+## 约束
+
+- Go 端 `github.com/shirou/gopsutil/v3` 采集
+- evalJS 推送到前端，1s 间隔
+- 卡片样式紧凑，不抢视觉焦点
--- a/docs/04-功能迭代/U-DESKTOP-2.网页壁纸/需求契约.md
+++ b/docs/04-功能迭代/U-DESKTOP-2.网页壁纸/需求契约.md
@@ -0,0 +1,45 @@
+# 网页壁纸 — 需求契约
+
+> 创建时间：2026-05-28
+> 状态：需求待确认
+
+## 目标
+
+用户输入 URL，WebView2 直接渲染任意网页作为桌面壁纸。
+
+## 用户场景
+
+1. 用户在设置页输入网址（如 Shadertoy、CodePen、任意网页）
+2. 桌面壁纸变为该网页的实时渲染
+3. 支持交互式网页（鼠标穿透可选开关）
+
+## 验收标准
+
+- [ ] 支持输入任意 HTTPS URL
+- [ ] 网页实时渲染为壁纸
+- [ ] URL 持久化，重启恢复
+- [ ] 网页加载失败时显示错误提示
+
+## 本次范围
+
+- 单个 URL 渲染为壁纸
+
+## 非目标
+
+- 网页收藏列表
+- 网页交互（穿透模式下无法点击）
+- 本地 HTML 文件
+
+## 约束
+
+- 复用 WebView2 实例，替换壁纸 HTML 为 `<iframe src="url">`
+- iframe 需考虑跨域限制
+- 安全：禁止加载本地文件路径（file:///）
+
+## 风险
+
+| 风险 | 缓解 |
+|------|------|
+| 部分网站禁止 iframe 嵌入 | 提示用户该网站不支持 |
+| 网页 JS 报错影响壁纸 | sandbox 属性隔离 |
+| 网页持续消耗资源 | 全屏暂停复用 |
--- a/docs/04-功能迭代/U-DESKTOP-2.视频壁纸/需求契约.md
+++ b/docs/04-功能迭代/U-DESKTOP-2.视频壁纸/需求契约.md
@@ -0,0 +1,59 @@
+# 视频壁纸 — 需求契约
+
+> 创建时间：2026-05-28
+> 状态：需求已确认
+
+## 目标
+
+支持将视频文件（mp4/WebM/GIF）设为桌面壁纸，WebView2 `<video>` 标签播放。
+
+## 用户场景
+
+1. 用户在设置页选择"视频壁纸"，弹出文件选择对话框（过滤 mp4/WebM/GIF）
+2. 选中视频后，桌面壁纸立即切换为视频循环播放
+3. 视频静音播放，不干扰用户工作
+4. 全屏应用（游戏/视频播放器）时自动暂停，退出全屏后恢复
+
+## 验收标准
+
+- [ ] 支持 mp4、WebM、GIF 格式
+- [ ] 视频循环播放，无黑帧闪烁
+- [ ] 默认静音，设置页可选开启声音
+- [ ] 全屏应用时暂停视频，退出恢复
+- [ ] 视频文件路径持久化，重启后恢复
+- [ ] 视频填充方式：cover（默认），不拉伸变形
+- [ ] 设置页可预览当前视频壁纸
+
+## 本次范围
+
+- 本地视频文件作为壁纸
+- 视频播放控制（静音/循环/暂停恢复）
+
+## 非目标
+
+- 在线视频 URL 播放（属于"网页壁纸"方向）
+- 视频编辑/裁剪
+- 多显示器不同视频
+
+## 约束
+
+- WebView2 `<video>` 原生能力，不引入额外播放器库
+- 视频文件不嵌入 exe，用户自行管理文件路径
+- 大视频文件（>500MB）需考虑内存占用，不做完整 dataURI 转换，用文件 URL
+- 复用现有壁纸类型切换架构（`saveWallpaperType`）
+
+## 风险
+
+| 风险 | 缓解 |
+|------|------|
+| 大视频内存占用 | 不转 dataURI，用 `file:///` 协议加载 |
+| WebView2 视频解码兼容性 | 测试 H.264/VP9 编码，不支持的格式提示用户 |
+| 视频切换时闪烁 | 预加载下一帧，CSS transition 淡入 |
+
+## 技术方案
+
+- `wallpaper.go` 新增壁纸类型 `video`
+- 视频 HTML 模板：全屏 `<video>` 标签，autoplay/loop/muted/cover
+- `config.go` 新增 `VideoPath string` 字段
+- `settings.go` 新增 `pickVideoFile` 函数（复用文件对话框，过滤视频格式）
+- 前端设置页 WallpaperSection 新增"视频壁纸"选项
--- a/docs/feature-roadmap.md
+++ b/docs/feature-roadmap.md
@@ -0,0 +1,141 @@
+# u-desktop 功能调研 & 路线图
+
+> 调研日期：2026-05-28
+
+---
+
+## 现有能力
+
+| 分类 | 功能 |
+|------|------|
+| 壁纸 | 6 种动态主题（aurora/starfield/gradient/particles/fractal/text）、本地图片、Bing 每日壁纸（80 张历史+收藏+自动轮播）、纯色/渐变 |
+| 卡片 | 时钟（秒+节日倒计时+整点动画）、天气（24h+7d）、星座运势（5 维+幸运标签）、AI 知识（GLM-4.5 生成+SQLite 缓存）、AI 新闻、电子相册 |
+| 布局 | 单栏/多栏切换、相框全屏模式 |
+| 系统 | 托盘图标、开机启动、单实例、DPI 适配、全屏暂停、WorkerW 重建恢复 |
+| 技术 | Go + WebView2 + Vue3 + Tailwind + Vite，单文件嵌入 |
+
+---
+
+## 可扩展方向
+
+### P1 — 低成本高收益（1-3 天）
+
+| # | 方向 | 说明 | 参考产品 |
+|---|------|------|----------|
+| 1 | **视频壁纸** | mp4/WebM/GIF 作为壁纸，WebView2 `<video>` 原生播放 | Lively / Wallpaper Engine 核心功能 |
+| 2 | **时间段动态壁纸** | 根据日出日落或时间段自动切换壁纸主题（白天明亮，夜晚深色） | WinDynamicDesktop |
+| 3 | **壁纸播放列表** | Bing 收藏 + 本地图片组成列表，定时轮播 | Wallpaper Engine playlist |
+| 4 | **电池感知** | 笔记本拔电时暂停动画壁纸，省电 | Lively / Wallpaper Engine |
+| 5 | **番茄钟卡片** | 倒计时 + 休息提醒 | Rainmeter 常见皮肤 |
+| 6 | **自定义倒计时卡片** | 用户设定日期（考试/生日/纪念日） | 已有节日倒计时基础可复用 |
+
+### P2 — 中等投入（3-7 天）
+
+| # | 方向 | 说明 | 参考产品 |
+|---|------|------|----------|
+| 7 | **网页壁纸** | 用户输入 URL，WebView2 直接渲染任意网页 | Lively webpage 壁纸 |
+| 8 | **壁纸颜色提取** | 从当前壁纸提取主色调，自动适配卡片文字颜色（深底白字/浅底黑字） | 提升可读性 |
+| 9 | **音频可视化壁纸** | 捕获系统音频，驱动粒子/波形动画 | Lively API |
+| 10 | **多显示器支持** | 不同显示器设置不同壁纸 | 所有主流工具标配 |
+| 11 | **RGB 灯效同步** | 取壁纸主色调，Corsair iCUE / Razer Chroma SDK 同步外设灯效 | Wallpaper Engine |
+| 12 | **便签/待办卡片** | 轻量 TODO 显示在桌面，数据持久化 | Rainmeter 高需求皮肤 |
+| 13 | **系统监控卡片** | CPU/GPU/RAM/网速实时曲线 | Rainmeter 经典皮肤 |
+
+### P3 — 高投入高价值（1-3 周）
+
+| # | 方向 | 说明 | 参考产品 |
+|---|------|------|----------|
+| 14 | **AI 壁纸生成** | 接入 SD / DALL-E / GLM-4V，文字描述直接生成壁纸 | DeskScapes Clairvoyance |
+| 15 | **壁纸社区/分享** | 用户上传壁纸，在线浏览订阅，内容生态 | Wallpaper Engine Workshop（百万级） |
+| 16 | **壁纸编辑器** | 可视化编辑粒子、动画、图层，创建动态壁纸 | Wallpaper Engine Editor |
+| 17 | **跨设备同步** | PC 壁纸推送到手机 | Wallpaper Engine Android |
+| 18 | **插件/脚本系统** | JS/TS 编写自定义壁纸和卡片 | Lively API / SceneScript |
+
+---
+
+## 竞品参考
+
+| 产品 | 定位 | 核心差异化 | 价格 |
+|------|------|-----------|------|
+| Wallpaper Engine | 壁纸引擎标杆 | 百万社区壁纸 + 编辑器 + RGB 同步 | $3.99 (Steam) |
+| Lively Wallpaper | 开源免费 | ML 深度视差 + CLI + 开发者 API | 免费 |
+| DeskScapes 11 | 商业软件 | 120+ 特效滤镜 + DreamMaker 编辑器 | $9.99 |
+| WinDynamicDesktop | macOS 移植 | 日出日落动态壁纸 + PowerShell 脚本 | 免费 |
+| Rainmeter | 桌面挂件 | 硬件监控 + 音频可视化 + 皮肤生态 | 免费 |
+
+---
+
+## 自动升级体系
+
+> 已分流独立开发，详细文档：[04-功能迭代/U-DESKTOP-1.自动升级/](./04-功能迭代/U-DESKTOP-1.自动升级/README.md)
+
+## AI 深度视差壁纸
+
+> 状态：需求已确认，待详细设计
+
+### 架构（远程推理方案）
+
+```
+用户选图片 → 计算 SHA256 → 检查本地缓存
+  → 无缓存：POST /api/depth（图片压缩上传 ~200KB）
+  → 服务端 Depth-Anything 推理（GPU ~0.5s）
+  → 返回深度图（灰度 PNG ~50KB）
+  → 客户端缓存到 ~/.u-desktop/depth/{sha256}.png
+  → WebGL shader 渲染视差（鼠标位置 + 深度图 = 像素偏移，60fps）
+```
+
+### 优势（相比本地 WASM 推理）
+
+- 客户端不增加体积（模型 30-50MB 放服务端）
+- 服务端 GPU 推理 ~0.5s，用户 CPU 本地 ~3-5s
+- 可用更大更精确的模型
+- 深度图按图片 SHA256 缓存，同一张图只推理一次
+
+### 服务端
+
+- 接口：`POST /api/v1/depth`，multipart 图片 → 返回深度图 base64
+- 技术栈：Python FastAPI + Depth-Anything-small，Docker 部署
+- 部署位置：复用 cpa.1216.top 基础设施
+
+### 客户端改动
+
+| 模块 | 改动 |
+|------|------|
+| `depth.go`（新增） | 上传图片 → 接收深度图 → 本地缓存 |
+| 壁纸渲染 | 新增 WebGL shader 主题，接收原图 + 深度图 |
+| 鼠标位置 | Go 全局钩子 `SetWindowsHookEx` → evalJS 注入 |
+| 设置页 | "3D 视差" 开关 |
+
+### 应用场景
+
+- 风景壁纸（山川湖海，前景浮动背景不动）
+- 人物/宠物写真（主体突出，背景位移）
+- 动漫/插画（分层明显，天然适合视差）
+
+### 商业化空间
+
+| 层级 | 免费 | Pro |
+|------|------|-----|
+| 每日推理次数 | 5 次/天 | 无限 |
+| 模型 | Depth-Anything-small | Depth-Anything-large |
+| 深度图分辨率 | 512px | 原图分辨率 |
+
+---
+
+## 建议实施顺序
+
+| # | 方向 | 需求契约 | 状态 |
+|---|------|---------|------|
+| 1 | **视频壁纸** | [需求契约](./04-功能迭代/U-DESKTOP-2.视频壁纸/需求契约.md) | 已确认，待实现 |
+| 2 | **壁纸颜色提取** | [需求契约](./04-功能迭代/U-DESKTOP-2.壁纸颜色提取/需求契约.md) | 已确认，待实现 |
+| 3 | **时间段壁纸** | [需求契约](./04-功能迭代/U-DESKTOP-2.时间段壁纸/需求契约.md) | 已确认，待实现 |
+| 4 | **番茄钟 + 倒计时** | [需求契约](./04-功能迭代/U-DESKTOP-2.番茄钟与倒计时/需求契约.md) | 已确认，待实现 |
+| 5 | **壁纸播放列表** | [需求契约](./04-功能迭代/U-DESKTOP-2.壁纸播放列表/需求契约.md) | 待确认 |
+| 6 | **电池感知** | [需求契约](./04-功能迭代/U-DESKTOP-2.电池感知/需求契约.md) | 待确认 |
+| 7 | **网页壁纸** | [需求契约](./04-功能迭代/U-DESKTOP-2.网页壁纸/需求契约.md) | 待确认 |
+| 8 | **便签/待办** | [需求契约](./04-功能迭代/U-DESKTOP-2.便签待办卡片/需求契约.md) | 待确认 |
+| 9 | **系统监控** | [需求契约](./04-功能迭代/U-DESKTOP-2.系统监控卡片/需求契约.md) | 待确认 |
+| 10 | **AI 深度视差** | 已在 roadmap 内 | 待设计 |
+| 11 | **AI 壁纸生成** | — | 待讨论 |
+| 12 | **音频可视化** | 已分流实现 | 开发中 |
+| 13 | **自动升级** | [独立模块](./04-功能迭代/U-DESKTOP-1.自动升级/README.md) | 开发中 |
--- a/docs/wallpaper-embedding.md
+++ b/docs/wallpaper-embedding.md
@@ -219,3 +219,47 @@ go build -o u-desktop.exe .
 3. Modal 在壁纸层渲染，用户看不到也点不到

 **修复**: 星座设置改为托盘子菜单直接选择（`AddSubMenuItem`），不依赖 WebView 交互。城市选择通过点击天气文字触发，因壁纸层可接收鼠标事件（WorkerW 的子窗口不在图标层之上但仍可点击）。
+
+---
+
+## 2026-05-28 追加
+
+### Windows 桌面周期性重置壁纸
+
+**症状**: 程序运行一段时间后，壁纸和卡片消失，被系统默认壁纸覆盖。
+
+**根因**: Windows 桌面窗口管理器（DWM）会周期性重建 WorkerW，导致 WebView2 的 SetParent 关系断裂。
+
+**修复**: 在 `fullscreenMonitor` 中每 10 秒检测 `GetParent(wvHwnd)`，父窗口变化时自动重新嵌入新 WorkerW。
+
+```go
+parent, _, _ := procGetParent.Call(wvHwnd)
+if parent != lastParent {
+    ww := findWorkerW()
+    if ww != 0 && ww != parent {
+        embedWorkerW(ww, screenW, screenH)
+    }
+}
+```
+
+### 鼠标键盘事件穿透
+
+**问题**: WebView2 覆盖在桌面上方，拦截所有鼠标/键盘事件，桌面图标无法操作。
+
+**修复**: 设置 `WS_EX_TRANSPARENT | WS_EX_LAYERED` 扩展样式，事件穿透到下层桌面。
+
+```go
+procSetWindowLongPtrW.Call(wvHwnd, gwlExStyle, wsExTransparent|wsExLayered)
+```
+
+### 托盘左键点击
+
+**问题**: 原版 systray 库左键/右键都弹菜单，无法区分。
+
+**修复**: 修改 vendor 中的 `systray_windows.go`，左键 `WM_LBUTTONUP` 发送信号到 `TrayClickCh` 通道而非弹菜单。主程序监听此通道打开设置窗口。
+
+### 配置路径迁移
+
+**变更**: 配置从 `{exeDir}/config/settings.json` 迁移到 `~/.u-desktop/settings.json`。
+
+**原因**: 构建清理 `dist/` 目录会删除用户配置。用户目录不受影响，且多版本共用同一配置。