Use application artwork in the running window tray

docs/development/visual-direction.md

@@ -1,8 +1,8 @@
 # Ferese Graphite 视觉方案
 
-- 文档版本：1.5
+- 文档版本：1.6
 - 整理日期：2026-10-28
-- 视觉基线：`1e34ec4`、`9908dde`、`3264659`、`6671960`；本版补充全部设置分类与窗口缩放的性能检查。
+- 视觉基线：`1e34ec4`、`9908dde`、`3264659`、`6671960`、`81b9970`；本版修正活动窗口的应用图标来源。
 - 适用范围：Ferese 设置、Shell 共享控件、锁屏与原生 Rime 候选界面的主题协同。
 
 ## 1. 视觉目标
@@ -223,6 +223,7 @@ Appearance 作为全部设置的入口，内容按实际功能分组：
 
 - 活动窗口区位于面板右侧、系统托盘区左边，与工作区显示空间独立。排列所有已打开窗口，每个窗口一个应用图标，关闭窗口即移除；不保留已关闭应用的固定图标。
 - 点击图标切换到对应窗口，支持同一应用的多个窗口和跨工作区切换。以启动顺序保持稳定位置，突出当前焦点窗口。
+- 使用应用桌面入口声明的图标，保留 SVG / PNG 的原始配色；兼容 StartupWMClass 匹配、绝对图标路径及应用 ID 图标查找。没有可用图标时使用通用窗口图形。图标查询在后台执行，按运行中的应用缓存。
 - 图标 18 px，按钮宽 30 px，间隔 2 px；悬停显示窗口标题，标题为空时使用应用标识。窗口过多时在分配宽度内横向滚动，默认最大宽 360 px。
 - 面板编辑器可添加、隐藏、移动“活动窗口”项目；旧预设在合并时间入口时补齐该项目，新配置中主动移除后不会自动恢复。
 
@@ -305,7 +306,7 @@ status {
 | 设置测试 | 128 项通过，10 项可选检查默认跳过 |
 | 滚动渲染专项 | 额外运行 1 项通过，覆盖 WGPU / tiny-skia 与两种主题配置 |
 | 配置测试 | 51 项单元测试及 11 项集成测试通过 |
-| 共享主题 / 面板 / Shell | 34 / 69 / 253 项通过 |
+| 共享主题 / 面板 / Shell | 34 / 69 / 256 项通过 |
 | 布局检查 | 覆盖 480–1800 px 窗口宽度 |
 | 原生预览 | 已检查深浅外观及 631 px 窄窗口 |
 | 导航居中 | 全部 16 项；包含独立滚动条通道检查 |
@@ -314,6 +315,7 @@ status {
 | 导航抽屉 | 已移除关闭按钮，外侧点击和 Esc 关闭均检查通过 |
 | 时间控制面板 | 原生预览显示真实音频输出、音量与静音控件、电源模式；关机确认后取消，会话保持运行 |
 | 活动窗口区 | 位于右侧托盘左边；三个窗口点击、相邻图标切换、跨工作区激活、关闭移除与重新打开均通过 |
+| 应用图标 | 本机解析 SOUP、Strata、QQ、Teams 的 SVG / PNG；原生预览中 SOUP 显示现有品牌图标。仅重载 Shell，SOUP 和设置的进程、窗口及焦点保留 |
 | 祝日函数 | 原生编辑并应用函数可改变日历；无限循环被拒绝且保存配置不变，恢复内置函数后配置校验通过 |
 | 通知标记 | 独立预览中创建并移除测试通知，检查白色与透明状态，点击区域宽度保持不变 |
 | 原生主题预览 | 检查配对颜色、透明外角和选中标记图层顺序；保留比例与键盘导航 |
@@ -356,6 +358,8 @@ status {
 
 本轮记录位于 `.artifacts/settings-audit-20261028/`，包含逐帧数据、前后图像、原生分类与窗口尺寸检查；这些资料只保留在本机。
 
+应用图标修订记录位于 `.artifacts/application-icons-20261028/`。SOUP 桌面入口未声明图标，本机将已有 SOUP 品牌 SVG 注册在其应用 ID 下；图标资产的来源与校验值随记录保存。Ferese 使用通用应用图标解析规则。
+
 ### 实现位置
 
 | 内容 | 文件 |
@@ -377,6 +381,7 @@ status {
 | 祝日函数执行与校验 | `crates/ferese-config/src/calendar_rules.rs` |
 | 时间弹层与控制中心 | `shell/ferese-shell/src/status_ui/` |
 | 活动窗口与焦点切换 | `shell/ferese-shell/src/window_tray.rs` |
+| 应用图标来源与通用兜底 | `shell/ferese-shell/src/application_icons.rs` |
 | 总览卡片与双列布局 | `shell/ferese-settings/src/all_options.rs` |
 | 分区表面与图标 | `shell/ferese-settings/src/visuals.rs` |
 | 布局及对齐回归检查 | `shell/ferese-settings/src/scroll_tests.rs` |