LanMountainDesktop/.trae/specs/independent-settings-window/spec.md

独立设置窗口 Spec

Why

• 当前设置窗口仍然带有桌面壳的 owner / anchor 语义，点击“回到 Windows”或触发桌面动画时，容易被一起隐藏或重新定位。
• 产品新增了“在任务栏显示图标”和“启用滑入滑出动画”设置，需要明确边界：它们只影响桌面主窗口，不影响设置窗口。
• 桌面底栏、托盘菜单、IPC、组件库等入口应当始终打开同一个独立设置窗口，而不是切换成附属浮窗或开关行为。

What Changes

• 将设置窗口改为独立顶层窗口，始终使用自己的任务栏按钮和图标。
• SettingsWindowService.Open 改为幂等的 open-or-focus；重复打开只聚焦已有窗口，并在提供目标页时切换到对应页面。
• 移除 Owner、锚点定位和 Toggle 语义；首次打开按参考屏幕居中，关闭为真实关闭。
• 桌面壳的“回到 Windows”、最小化到托盘/任务栏、滑入滑出动画，只影响 MainWindow，不会影响设置窗口。
• 统一桌面、托盘、IPC、组件库等设置入口，全部走 OpenIndependentSettingsModule。
• 设置页文案明确“在任务栏显示图标”只控制桌面主窗口；设置窗口始终保留独立任务栏图标。

Impact

• Affected code:
  • LanMountainDesktop/Services/Settings/SettingsWindowService.cs
  • LanMountainDesktop/App.axaml.cs
  • LanMountainDesktop/Views/MainWindow.axaml.cs
  • LanMountainDesktop/Views/MainWindow.ComponentSystem.cs
  • LanMountainDesktop/Views/FusedDesktopComponentLibraryControl.axaml.cs
  • LanMountainDesktop/Views/SettingsPages/GeneralSettingsPage.axaml
• Affected behavior:
  • 设置窗口生命周期
  • 设置入口一致性
  • 任务栏图标与桌面壳显示边界

---

ADDED Requirements

Requirement: 设置窗口为独立顶层窗口

系统 SHALL 将设置窗口作为独立顶层窗口显示，而不是作为桌面主窗口的附属子窗。

Scenario: 设置窗口拥有独立任务栏图标

• WHEN 用户打开设置窗口
• THEN 设置窗口使用独立顶层窗口方式显示
• AND THEN 设置窗口在任务栏中保留自己的独立按钮和图标
• AND THEN “在任务栏显示图标”开关不会影响设置窗口的任务栏按钮

Requirement: 设置入口统一为 open-or-focus

系统 SHALL 让所有设置入口打开或聚焦同一个设置窗口实例。

Scenario: 已打开时重复触发设置入口

• WHEN 设置窗口已经打开，用户再次从桌面、托盘或 IPC 触发打开设置
• THEN 系统只聚焦现有设置窗口
• AND THEN 如果请求包含目标页，则导航到目标页
• AND THEN 不会把已打开的设置窗口当作开关关闭

Requirement: 设置窗口不参与桌面壳可见性切换

系统 SHALL 让桌面壳的隐藏、最小化和进出场动画只作用于主窗口。

Scenario: 回到 Windows 时设置窗口保持可见

• WHEN 主窗口执行“回到 Windows”并隐藏到托盘或最小化到任务栏
• THEN 设置窗口保持当前可见状态
• AND THEN 设置窗口不会跟随主窗口一起隐藏、最小化或重定位

Scenario: 桌面滑入滑出动画不作用于设置窗口

• WHEN 启用了滑入滑出动画并触发主窗口退场或入场
• THEN 只有主窗口参与动画
• AND THEN 设置窗口不会消失，也不会跟随主窗口做进出场动画

Requirement: 关闭设置窗口时真实销毁实例

系统 SHALL 在用户关闭设置窗口时真实关闭该窗口实例。

Scenario: 关闭后再次打开

• WHEN 用户点击设置窗口右上角关闭按钮
• THEN 当前设置窗口实例被关闭并销毁
• AND THEN 下次再次打开设置时创建新的设置窗口实例
• AND THEN 新窗口按参考屏幕居中显示